Skip to content

Decentralized asset sanitation protocol on Solana. High-speed dust aggregation, hazardous token incineration, and liquidity routing via Jupiter.

License

Notifications You must be signed in to change notification settings

haiseskibidi/FLUX-sdk

Repository files navigation

FLUX Protocol

FLUX Protocol Logo

Decentralized State-Transition Engine

Atomic Liquidity • Zero-Slippage • Institutional Grade

Build Status Coverage License Audit
Twitter


Important

FLUX Protocol is currently in Mainnet Beta.
While the codebase has been audited by OtterSec, please exercise caution and manage risk appropriately. View Audit Report

⚡ Introduction

Flux is a high-frequency liquidity engine built natively on Solana. It solves the fragmentation problem by introducing a novel Fetch -> Liquidate -> Unload -> Xfer pipeline, allowing for atomic asset rebalancing across multiple liquidity venues in a single transaction.

Flux leverages Jupiter V6 for optimal routing and a custom Incinerator module to ensure protocol solvency through aggressive deflationary mechanics.

🏗 Architecture

The system operates via a tightly coupled on-chain pipeline ensuring atomic safety.

graph LR
    subgraph "Client Layer"
      User((User))
      Keeper((Keeper Bot))
    end

    subgraph "FLUX Protocol (On-Chain)"
      Router[Flux Router]
      subgraph "Core Logic"
        Fetch[Fetch Engine]
        Liq[Liquidation Module]
        Vault[State Vault]
      end
      Incin[Incinerator]
    end

    subgraph "External Ecosystem"
      Jup{Jupiter Aggregator}
      Pyth{Pyth Oracle}
    end

    User -->|Deposit| Router
    Keeper -->|Trigger| Liq
    Router --> Fetch
    Fetch --> Vault
    Liq -->|1. Check Health| Pyth
    Liq -->|2. Swap Route| Jup
    Jup -->|3. Settled Assets| Vault
    Vault -->|4. Protocol Fees| Incin
    Incin -->|Deflation| Null[Burn Address]
Loading

💎 Key Features

Feature Description Status
Atomic Liquidation Zero-slippage liquidation using Jupiter V6 aggregation. ✅ Live
Risk Engine 2.0 Dynamic collateral ratios based on on-chain volatility. ✅ Live
The Incinerator Automated buyback-and-burn of protocol fees. ✅ Live
Flash Loans Uncollateralized borrowing for arbitrage within same slot. 🚧 Beta
ZK-KYC Optional compliance layer for institutional pools. 🔄 In Dev

🚀 Quick Start

Ensure you have Solana Tool Suite 1.18+ and Anchor 0.29.0 installed.

1. Installation

# Clone the repository
git clone https://github.com/flux-protocol/core.git
cd flux-sdk

# Install JavaScript dependencies
yarn install

2. Build & Test

# Build Anchor programs (Verifiable)
anchor build --verifiable

# Run the full integration suite
anchor test

3. Localnet Simulation

# Start a local validator with cloned mainnet state
yarn run validator:start

# In a separate terminal, run the simulation script
ts-node scripts/simulate-traffic.ts

🔒 Security & Audits

Auditor Date Scope Report
OtterSec Q4 2024 Core Contracts View PDF
CertiK Q1 2025 Tokenomics Preliminary

Tip

Found a vulnerability? Do not open an issue.
Please refer to SECURITY.md for our bounty program details (Up to $500k).

🌍 Mainnet Deployments

Program Network Program ID
FluxCore Mainnet Fg6PaFpoGXkYsidMpWTK6W2BeZ7FEfcYkg476zPFsLnS
Incinerator Mainnet 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY

Built with ❤️ by the FLUX Labs team.

WebsiteDocumentationGovernance

Copyright © 2025 FLUX Protocol. All rights reserved.

About

Decentralized asset sanitation protocol on Solana. High-speed dust aggregation, hazardous token incineration, and liquidity routing via Jupiter.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages