2xSOL is a leveraged vault protocol on Solana that provides 2x exposure to SOL through a deposit/mint/redeem model. Users deposit SOL, receive 2xSOL shares representing their leveraged position, and can redeem at any time based on the current NAV.

The protocol integrates Percolator (a formally verified accounting and risk engine created by Anatoly Yakovenko) for solvency constraints and Pyth Network for real-time oracle pricing. Swaps are routed through Jupiter.

Higher leverage tiers (3x, 5x, 10x) are planned for future release.

• Non-custodial — Users maintain control; vault authority is a PDA
• Oracle-validated pricing — Pyth SOL/USD feed with staleness and confidence checks
• Solvency-first risk engine — Percolator CPI enforces withdrawal safety gates and margin constraints
• On-chain execution — All state transitions happen on Solana, fully verifiable
• Transparent NAV — Share price derived from vault assets and oracle inputs

flowchart LR
  U[User Wallet] -->|Deposit SOL| FE[Frontend]
  FE -->|Swap via| JUP[Jupiter]
  FE -->|Deposit/Withdraw| V[2xSOL Vault Program]
  V -->|Price checks| PYTH[Pyth Oracle]
  V -->|Solvency CPI| PERC[Percolator]
  V -->|Mint/Burn| SPL[2xSOL Shares]

1. Deposit — User deposits SOL into the vault
2. Mint — Vault mints 2xSOL shares proportional to deposit value at current NAV
3. Leverage — Vault maintains 2x SOL exposure through Percolator-managed positions
4. Rebalance — Periodic rebalancing keeps leverage near the 2x target
5. Redeem — User burns 2xSOL shares to withdraw SOL at current NAV

Percolator is a formally verified accounting and risk engine for perpetual futures and leveraged strategies on Solana, created by Anatoly Yakovenko (co-founder of Solana). Its core invariant: no account can withdraw more value than exists on the balance sheet.

2xSOL uses Percolator for:

• Solvency-first withdrawal safety gates
• Margin checks and socialization/ADL constraints
• Collateral tracking and PnL accounting
• On-chain verifiable risk parameters

Pricing uses Pyth Network v2 API with:

• Real-time SOL/USD price feed
• Staleness checks (max 300 slots)
• Confidence interval validation (max 5% band)
• Automatic price rejection if oracle data is stale or unreliable

2xsol/
├── contracts/                  # Solana smart contracts (Rust + Anchor)
│   ├── programs/
│   │   └── two_xsol_vault/
│   │       └── src/
│   │           ├── lib.rs          # Program entrypoints (initialize, deposit, withdraw, rebalance)
│   │           ├── state.rs        # VaultState, OracleConfig, FeeConfig, RiskConfig
│   │           └── percolator.rs   # Percolator CPI integration
│   ├── deployments/            # Deployment records (addresses, tx hashes)
│   └── Anchor.toml
├── frontend/                   # Next.js 14 application
│   ├── src/
│   │   ├── app/                # Pages (trade, dashboard, risk, percolator)
│   │   ├── components/         # UI components (trade widget, charts, layout)
│   │   └── lib/
│   │       └── services/       # Pyth, Solana, Jupiter integrations
│   └── .env.local.example
└── docs/                       # Documentation

• Node.js 20+
• Rust + Cargo
• Solana CLI
• Anchor CLI

cd frontend
npm ci
cp .env.local.example .env.local  # Configure RPC and program addresses
npm run dev

cd contracts
anchor build
anchor test

cd contracts
solana program deploy target/deploy/two_xsol_vault.so \
  --program-id target/deploy/two_xsol_vault-keypair.json
node init_vault_devnet.js

Leveraged products amplify both gains and losses.

• At 2x leverage, a 50% drop in SOL could wipe out your entire position
• Losses compound over time even if SOL recovers
• Smart contract bugs could result in partial or total loss
• Oracle failures could trigger incorrect rebalances
• Network congestion may prevent timely rebalancing
• No FDIC insurance or regulatory protections

Read the full risk disclosures before participating.

• See SECURITY.md for vulnerability reporting
• Threat model: contracts/security/THREAT_MODEL.md
• The protocol is currently deployed on devnet only
• Audit status: in progress

Never commit secrets. Secret scanning runs in CI.

• Website: https://2xsol.trade
• Program Explorer: View on Solana Explorer
• Risk Disclosures: https://2xsol.trade/risk
• Percolator Info: https://2xsol.trade/percolator

MIT — see LICENSE.