Back to home

Documentation

Everything you need to know about Sol Oasis — how the protocol works, the math behind it, and how governance is handled.

How Sol Oasis Works

Sol Oasis is a StableSwap DEX built natively on Solana. It uses a specialized bonding curve (the StableSwap invariant) designed specifically for swapping assets that should trade at near 1:1 — like USDC and USDT.

Unlike constant-product AMMs (like Uniswap's x*y=k), Sol Oasis concentrates liquidity around the 1:1 price point. This means dramatically lower slippage for stablecoin swaps — making it the most capital-efficient way to swap stables on Solana.

The protocol is built from scratch in Rust using the Anchor framework. It is not a fork of Curve or any other protocol — it was purpose-built for Solana's architecture.

StableSwap Algorithm

The StableSwap invariant is a hybrid between a constant-sum (x + y = k) and constant-product (x * y = k) curve. In simple terms:

A * n^n * sum(x_i) + D = A * D * n^n + D^(n+1) / (n^n * prod(x_i))

Here's what that means in plain English:

  • A (amplification coefficient)— Controls how "flat" the curve is around the 1:1 price. Higher A = less slippage for balanced swaps.
  • D — The total value of the pool when perfectly balanced.
  • n — Number of assets in the pool (2 for USDC/USDT).

When the pool is balanced (equal amounts of USDC and USDT), you get near-zero slippage. As the pool becomes imbalanced, slippage increases to protect liquidity providers — but it's still far less than a standard AMM.

Result: on a $10,000 USDC → USDT swap, you receive approximately $9,996 — compared to only ~$9,500–$9,800 on a constant-product AMM.

Fee Structure

Sol Oasis uses a simple, transparent fee model:

0.04%
Per swap
50 / 50
LP share / Protocol
  • 50% of fees go directly to Liquidity Providers, proportional to their share of the pool.
  • 50% of fees go to the protocol treasury, controlled by the on-chain multisig.
  • There is no utility token. You earn real USDC/USDT fees — not inflationary reward tokens.
  • No deposit or withdrawal fees. You only pay the swap fee when trading.

Multisig Governance

Sol Oasis has on-chain multisig governancebaked directly into the AMM smart contract. This is not a separate DAO — it's a native feature of the protocol.

How it works:

  • A set of authorized signers is defined in the on-chain pool state.
  • Sensitive operations (changing fees, updating the amplification factor, pausing the pool) require M-of-N signatures.
  • Proposals are submitted on-chain. Each signer approves or rejects. Once the threshold is met, the action executes.
  • No external governance tokens, no snapshot voting, no off-chain signatures. Everything happens on Solana.

This approach minimizes governance attack surface while keeping the protocol upgradeable by a trusted set of operators.

Smart Contract

The Sol Oasis program is deployed on Solana devnet:

Program ID
CmRbxJhndAwTTCaAN2oeYiA1vLP9ZSDSj2VFGfihb2Lo
View on Solscan

Key technical details:

  • Written in Rust with the Anchor framework
  • Supports USDC/USDT pool with StableSwap invariant
  • Instructions: initialize, swap, add_liquidity, remove_liquidity, propose, approve
  • All pool state stored on-chain in a single PDA
  • LP tokens minted as SPL tokens

Security & Audit Status

Sol Oasis is designed with a minimal attack surface:

  • No oracles — pricing is determined by the StableSwap curve, not external feeds
  • No utility token — eliminates governance token manipulation vectors
  • On-chain multisig — no single point of failure for admin operations
  • All math uses checked arithmetic to prevent overflow/underflow
Audit Status

The protocol has not yet undergone a formal security audit. An audit is planned pending a Solana Foundation grant. The protocol is currently deployed on devnet only and should not be used with real funds until after an audit is complete.

If you are a security researcher and would like to review the code, please reach out. Responsible disclosure is appreciated.