> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sodax.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> SODAX is mainnet-only (no testnet chains or RPC endpoints exist) with a hub-and-spoke architecture; Sonic is the hub. SODAX is non-custodial protocol/software: it routes and settles; independent solvers on the marketplace fill — never say 'our solver', 'the SODAX solver', that SODAX trades, takes custody, or fills orders. For frontend/React integrations, prefer @sodax/dapp-kit hooks over calling @sodax/sdk directly. SDK operations — the methods that build, submit or await a transaction, and the API/quote calls — return Result<T, E> ({ ok: true, value } or { ok: false, error }): check result.ok, never wrap them in try/catch or branch on error.message; discriminate on the narrow error.code union instead. Synchronous config getters (getPartnerFee, getSupportedSwapTokens, getVault, ...) return their value directly, not a Result.

# Solana FAQ

> The questions Solana engineers actually ask about integrating SODAX.

#### Do I need to write or deploy a program?

No. SODAX's Solana programs, its on-chain smart contracts, are already deployed and audited; your integration is TypeScript against `@sodax/sdk` (or the React packages on top of it). You write no on-chain code and take on no program upgrade authority for any part of the flow.

#### How does a swap from Solana actually settle?

Your user signs one Solana transaction that creates an intent. The SODAX relayer carries proof of that transaction to the hub network (Sonic), a solver fills the intent on the destination network, and the output lands at the recipient address there. Swaps into Solana settle as SPL balances at the user's address. If an intent is never filled, it can be cancelled and the funds recovered.

#### Which assets are supported on Solana?

Two answers, and the difference matters. On Solana itself, 21 assets are live: SOL, USDC, USDT, bnUSD, SODA, WBTC, ecosystem tokens like BONK, JUP, RAY, PYTH, and JTO, the liquid staking tokens JitoSOL and mSOL, and tokenized equities (xStocks). Six of these also work in the money market.

But your users are not limited to the Solana-side list. Every swap is cross-network, so from Solana they can reach all 140 assets across every SODAX-supported network: SOL into ETH on Ethereum, USDC on Base, BTC on Bitcoin, and so on. Both lists grow as the backend config adds them; read them from `sodax.config` at runtime, or see the live tables in [Networks & Assets](https://docs.sodax.com/solana/networks-and-assets.md).

#### Do my users need a new wallet?

No. Phantom, Backpack, Solflare, and other wallet-standard wallets work through `@sodax/wallet-sdk-react` (which wraps `@solana/wallet-adapter`) or directly via `SolanaWalletProvider`. See [Solana Wallets](https://docs.sodax.com/solana/wallets.md).

#### Is there an approve step before swapping or supplying?

No. Token allowances are an EVM and Stellar concept. On Solana the SDK's `isAllowanceValid` check passes without an on-chain transaction, so the quote-to-action path is a single signature.

#### Can I tune commitment levels and send options?

Yes. `SolanaWalletProvider` accepts `SolanaWalletDefaults`: `connectionCommitment`, `connectionConfig`, `sendOptions`, and `confirmCommitment`. Bring your own RPC endpoint (Helius, Triton, or your own node) via the `endpoint` field.

#### What does it cost?

Using SODAX is free: no license, no integration fee, no SDK cost. Trades carry a fixed 0.1% base fee taken by the protocol; on top of that you set your own platform fee and keep it. Your integration is a revenue line, not a cost center. See [Monetize SDK](https://docs.sodax.com/developers/how-to/monetize_sdk.md).

#### How do I know if something went wrong?

SDK operations return `Result<T>` rather than throwing. Core swap and money market methods return typed error codes (for example `'RELAY_TIMEOUT'`, `'EXECUTION_FAILED'`) you can branch on, with structured context attached.

#### Where are the audits?

SODAX's Solana programs have their own published report: [SODAX (Solana) Smart Contract Audit (Final Report v2)](https://github.com/gosodax/sodax-sdks/blob/main/Audits/Sodax%20%28Solana%29%20Smart%20Contract%20Audit%20Report%20-%20Final%20Report%20v2%20%281%29.pdf). Audits for the rest of the protocol are collected on the [Audits](https://docs.sodax.com/developers/audits.md) page.

#### Can my AI coding assistant do the integration?

Largely, yes. Add the [SODAX Builders MCP](https://docs.sodax.com/builders-mcp.md) to Claude, Cursor, VS Code, Windsurf, or any MCP-capable client (`https://builders.sodax.com/mcp`) and it gets 40 tools with live access to the SODAX System: chains, tokens, swap quotes, money market rates, intent history, and auto-synced SDK docs. Use it to scope the integration against your own codebase first, then to write and verify the code. Setup per client is at [builders.sodax.com](https://builders.sodax.com/).

#### I want a plan specific to my protocol. Who do I talk to?

Generate a tailored integration guide at [sodax.com/solana](https://sodax.com/solana): paste your protocol's URL and it maps SODAX onto your stack. From there you can reach the BD team directly.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.