# SODAX Docs

> SODAX is non-custodial cross-network execution infrastructure (Sonic hub). Docs cover the open-source SDK and partner HTTP APIs for swaps, lending/borrowing, staking, bridging, and migration — SODAX routes and settles; solvers on the marketplace fill.

> ## 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.

- [Liquidity and execution, across every network](https://docs.sodax.com/index.md): Choose a product, follow an integration guide, or look up the API and SDK reference.
- [Get Started](https://docs.sodax.com/introduction.md): Pick a solution — Swap, Money Market, Bridge, or Yield — then follow the SDK or HTTP API path. Or jump to a network guide.
- [Your first swap](https://docs.sodax.com/quickstart.md): Install the SDK, quote an intent, and submit a mainnet swap — then poll until it settles.
- [AI Integration Guide](https://docs.sodax.com/ai-integration-guide.md): Ship v2-correct SODAX code from your AI coding agent using the @sodax/skills bundle.
- [Builders MCP](https://docs.sodax.com/builders-mcp.md): Give your AI coding agent live access to the SODAX System — chains, tokens, real quotes, money market rates, intent history, and these docs — over one MCP endpoint.
- [Why Build With SODAX](https://docs.sodax.com/home/why-sodax.md): What you can build, proof points, and ecosystem reach across networks, liquidity venues, and money market assets.
- [How Execution Works](https://docs.sodax.com/home/how-execution-works.md): Intent-based execution, unified liquidity access, and smart wallet abstraction — how SODAX routes and settles while solvers fill.
- [API & SDK stack](https://docs.sodax.com/home/sdk-stack.md): Partner HTTP APIs and the open-source SDK — Foundation, Connection, and Experience layers.
- [Swap](https://docs.sodax.com/swap/index.md): Cross-network swaps filled by solvers — pick the HTTP API or the open-source SDK.
- [Money Market](https://docs.sodax.com/money-market/index.md): Supply and borrow across networks through one money market on the Sonic hub — SDK today, HTTP API coming.
- [Bridge](https://docs.sodax.com/bridge/index.md): Move assets network to network through hub-and-spoke vaults — SDK today, HTTP API coming.
- [Yield](https://docs.sodax.com/yield/index.md): Leveraged yield vaults as ordinary intent-based swaps — open-source SDK or HTTP API, both live on mainnet.
- [Swap widget](https://docs.sodax.com/widget/index.md): Embed cross-network swaps in your product with one iframe. Configure it visually, copy the snippet, paste it into your page.
- [HTTP API](https://docs.sodax.com/developers/http-api/index.md): Public SODAX HTTP surfaces for partners — base URLs, route prefixes, conventions, and which API to use.
- [Swaps API](https://docs.sodax.com/developers/http-api/swaps.md): HTTP reference for the SODAX Swaps API — quote, build intents, submit-tx, status polling, fees, and partner monetization.
- [Leverage yield API](https://docs.sodax.com/developers/http-api/leverage.md): HTTP reference for SODAX leveraged yield vaults — list vaults, quote deposit/withdraw, build intents, and submit-tx.
- [Oracle API](https://docs.sodax.com/developers/http-api/oracle.md): USD OHLC price candles for charts, plus live solver oracle prices for SODAX-tracked assets.
- [Protocol stats API](https://docs.sodax.com/developers/http-api/stats.md): Headline SODAX metrics over HTTP — networks, partners, supported assets, filled-intent volume, and SODA supply.
- [SDKs](https://docs.sodax.com/developers/packages/index.md): Software development kits available to the integrators.
- [Installing @sodax/sdk with Next.js](https://docs.sodax.com/developers/packages/sdk/docs/installation/nextjs.md)
- [1. The Foundation](https://docs.sodax.com/developers/packages/foundation/index.md): This is the core logic layer that powers the entire ecosystem. It provides the raw functional modules required to build with SODAX programmatically.
- [@sodax/sdk](https://docs.sodax.com/developers/packages/foundation/sdk/index.md)
- [Functional Modules](https://docs.sodax.com/developers/packages/foundation/sdk/functional-modules/index.md)
- [Swaps](https://docs.sodax.com/developers/packages/foundation/sdk/functional-modules/swaps.md)
- [Money Market](https://docs.sodax.com/developers/packages/foundation/sdk/functional-modules/money_market.md)
- [Leverage Yield](https://docs.sodax.com/developers/packages/foundation/sdk/functional-modules/leverage_yield.md)
- [Leverage-Yield Effective APR](https://docs.sodax.com/developers/packages/foundation/sdk/functional-modules/leverage_yield_apr.md)
- [Bridge](https://docs.sodax.com/developers/packages/foundation/sdk/functional-modules/bridge.md)
- [Staking](https://docs.sodax.com/developers/packages/foundation/sdk/functional-modules/staking.md)
- [Migration](https://docs.sodax.com/developers/packages/foundation/sdk/functional-modules/migration.md)
- [Tooling Modules](https://docs.sodax.com/developers/packages/foundation/sdk/tooling-modules/index.md)
- [Backend API](https://docs.sodax.com/developers/packages/foundation/sdk/tooling-modules/backend_api.md)
- [Intent Relay API](https://docs.sodax.com/developers/packages/foundation/sdk/tooling-modules/intent_relay_api.md)
- [@sodax/swaps-api](https://docs.sodax.com/developers/packages/foundation/swaps-api.md)
- [@sodax/bridge-api](https://docs.sodax.com/developers/packages/foundation/bridge-api.md)
- [2. The Connection Layer](https://docs.sodax.com/developers/packages/connection/index.md): Sitting above the core SDK, this package manages the complexity of connecting user wallets across heterogeneous chains (EVM, SVM, non-EVM).
- [@sodax/wallet-sdk-core](https://docs.sodax.com/developers/packages/connection/wallet-sdk-core.md)
- [@sodax/wallet-sdk-react](https://docs.sodax.com/developers/packages/connection/wallet-sdk-react.md)
- [3. The Experience Layer](https://docs.sodax.com/developers/packages/experience/index.md): The fastest way to build with SODAX. This is an opinionated collection of UI components, hooks, and utilities that leverages the layers below it.
- [@sodax/dapp-kit](https://docs.sodax.com/developers/packages/experience/dapp-kit.md)
- [@sodax/skills](https://docs.sodax.com/developers/packages/experience/skills.md)
- [How To](https://docs.sodax.com/developers/how-to/index.md): Practical, task-based guides for integrating SODAX — HTTP API routes, SDK configuration, swaps, wallets, and more.
- [Make a swap (SDK)](https://docs.sodax.com/developers/how-to/how_to_make_a_swap.md)
- [Integrate Leverage Yield (LST vaults)](https://docs.sodax.com/developers/how-to/integrate_leverage_yield.md): Add SODAX leverage-yield LST vaults to your app: what the loop earns and risks, the default @sodax/sdk and dapp-kit flow, the HTTP API alternative, and the gotchas that stop an intent from filling.
- [Migrate a manual swap to submit-tx](https://docs.sodax.com/developers/how-to/migrate_swap_to_submit_tx.md)
- [SODAX API keys](https://docs.sodax.com/developers/how-to/api-keys.md): Why your integration needs a SODAX API key, how to create one in the partner portal, and how to deploy, rotate and revoke it.
- [API key good practices](https://docs.sodax.com/developers/how-to/api-key-good-practices.md): Keep a SODAX API key on a server you control: where the SDK may hold it, the build-time env prefixes that publish it, and a worked backend-for-frontend proxy for browser dApps.
- [Partner payout wallet](https://docs.sodax.com/developers/how-to/payout-wallet.md): Add the same PartnerFee address your SDK integration uses to track fees and volume and claim your fees in the partner portal.
- [Configure SDK](https://docs.sodax.com/developers/how-to/configure_sdk.md)
- [Logging](https://docs.sodax.com/developers/how-to/logging.md)
- [Monetize SDK](https://docs.sodax.com/developers/how-to/monetize_sdk.md)
- [Wallet Providers](https://docs.sodax.com/developers/how-to/wallet_providers.md)
- [Estimate Gas](https://docs.sodax.com/developers/how-to/estimate_gas.md)
- [Stellar Trustline Requirements](https://docs.sodax.com/developers/how-to/stellar_trustline.md)
- [Is SODAX on Testnet?](https://docs.sodax.com/developers/how-to/testnet.md): SODAX is mainnet-only. Here's why there is no testnet, and how to test and explore SODAX safely on mainnet instead.
- [SODAX for Solana](https://docs.sodax.com/solana/index.md): Reach the users and liquidity of every SODAX network from your Solana product. No new programs, your entire integration is TypeScript.
- [Quickstart on Solana](https://docs.sodax.com/solana/quickstart.md): Install the SDK, wire up a Solana wallet provider, and execute your first cross-network swap from Solana.
- [Swaps on Solana](https://docs.sodax.com/solana/swaps.md): Intent-based cross-network swaps from a Solana perspective: one signed transaction, solver-filled, settled across networks.
- [Money Market on Solana](https://docs.sodax.com/solana/money-market.md): Cross-network lending and borrowing from Solana: supply, borrow, repay, and withdraw against collateral sourced on any SODAX network.
- [Solana Wallets](https://docs.sodax.com/solana/wallets.md): Phantom, Backpack, Solflare, and every other network's wallets through one interface, with @sodax/wallet-sdk-react or a direct provider.
- [Solana: Networks & Assets](https://docs.sodax.com/solana/networks-and-assets.md): What is live on Solana today, and the networks and assets your users can reach from it.
- [Solana FAQ](https://docs.sodax.com/solana/faq.md): The questions Solana engineers actually ask about integrating SODAX.
- [Bitcoin Integration](https://docs.sodax.com/developers/how-to/bitcoin-integration.md)
- [Stellar Sponsoring](https://docs.sodax.com/developers/how-to/stellar-sponsoring-getting-started.md): Activate a brand-new Stellar account that holds no XLM, with SODAX paying the base reserve.
- [Stellar Sponsoring: Quick Reference](https://docs.sodax.com/developers/how-to/quick-sponsoring-stellar-guide.md): The sponsored Stellar activation flow as a dense reference card.
- [Technical Overview](https://docs.sodax.com/developers/technical-overview/index.md): Architecture deep-dives for the SODAX hub — Asset Manager, Vault Token, Hub Wallet Abstraction, Intents, and GMP.
- [Asset Manager](https://docs.sodax.com/developers/technical-overview/asset-manager.md): Hub-and-spoke asset management system for cross-network asset transfers, with optional execution of additional logic on transfer.
- [Vault Token](https://docs.sodax.com/developers/technical-overview/vault-token.md): A single token that wraps multiple chain-native variants of the same underlying asset (e.g. USDC from different chains) into one unified position.
- [Hub Wallet Abstraction](https://docs.sodax.com/developers/technical-overview/hub-wallet-abstraction.md): Deterministic wallet proxies on the Hub chain give every connected-chain user a corresponding hub wallet, enabling cross-chain operations without exposing the underlying complexity.
- [Intents](https://docs.sodax.com/developers/technical-overview/intents.md): Cross-chain execution infrastructure where users express a desired outcome on the hub chain and solvers fulfill it from any supported spoke chain.
- [Generalized Messaging Protocol](https://docs.sodax.com/developers/technical-overview/generalized-messaging-protocol.md): Simple, secure cross-chain messaging system that lets dApps send and receive messages across networks reliably.
- [Deployments](https://docs.sodax.com/developers/deployments/index.md): Mainnet contracts, relayer and solver endpoints, compatible swap assets, and SODAX Scan.
- [Mainnet](https://docs.sodax.com/developers/deployments/mainnet.md): Mainnet smart contract deployments.
- [Relayer API Endpoints](https://docs.sodax.com/developers/deployments/relayer-api-endpoints.md)
- [Solver API endpoints](https://docs.sodax.com/developers/deployments/solver-api-endpoints.md)
- [SODAX Scan](https://docs.sodax.com/developers/deployments/sodaxscan.md): Cross-network message tracker for SODAX deliveries — source and destination transaction status.
- [Swaps: Compatible Assets](https://docs.sodax.com/developers/deployments/swaps-compatible-assets.md): Assets (tokens) supported for swaps by solvers on mainnet.
- [Audit Reports](https://docs.sodax.com/developers/audits/index.md): Published smart-contract and infrastructure audit PDFs for SODAX spokes, the Relay, and collaborative reviews.
- [Community](https://docs.sodax.com/resources/index.md): Videos, blog posts, product updates, FAQ, and audits from the SODAX team and community.
- [Product updates](https://docs.sodax.com/resources/product-updates.md): What shipped on SODAX, and where the docs for it live.
- [Videos](https://docs.sodax.com/resources/videos.md): SODAX walkthroughs and explainers for builders and partners.
- [Blog](https://docs.sodax.com/resources/blog.md): Articles and announcements about SODAX.
- [Hub and spoke: how SODAX works](https://docs.sodax.com/resources/blog/hub-and-spoke.md): Sonic runs the core logic. Every other network is a spoke that holds assets locally and reaches the hub through relayed messages. Here is how that model gives every connected network the full SODAX feature set.
- [One SDK, more than swaps](https://docs.sodax.com/resources/blog/six-categories-one-sdk.md): Swaps, a money market, leveraged liquid-staking vaults, tokenized stocks and limit orders from one SDK. Keep your users on their own network and give them markets that do not exist there.
- [Let your AI agent build your SODAX integration](https://docs.sodax.com/resources/blog/builders-mcp-agent.md): Paste one URL into your coding agent and it works from live SODAX data: networks, tokens, quotes, money market reserves, intent lookups and docs search. Add the SODAX skills and it writes v2-correct SDK code too. Here is the setup, client by client.
- [Cross-network swaps from any language: the SODAX Swaps API](https://docs.sodax.com/resources/blog/swaps-api-any-language.md): Quote, build an unsigned transaction, sign it in your own infrastructure, submit and poll. The SODAX Swaps API runs cross-network swaps over plain HTTP, with no SDK and no wallet library.
- [A cross-network swap in one embed: the SODAX swap widget](https://docs.sodax.com/resources/blog/swap-widget.md): The SODAX swap widget puts cross-network swaps inside your product with a single iframe. No package to install, no backend to run. Here is how to configure it, embed it and listen to it.
- [The SDK feature you didn't know you had: limit orders](https://docs.sodax.com/resources/blog/limit-orders.md): SODAX has supported cross-network limit orders for about eight months. Here is how createLimitOrder works, how orders fill and how you cancel them.
- [Price charts without a data vendor: the SODAX Oracle candles API](https://docs.sodax.com/resources/blog/oracle-candles-api.md): Free, unauthenticated USD OHLC candles for every asset SODAX supports. One GET request gives your app candlestick charts, with no API key and no data contract.
- [Onboarding brand-new Stellar wallets with sponsored activation](https://docs.sodax.com/resources/blog/stellar-account-sponsorship.md): How the SODAX Sponsoring API activates empty Stellar accounts so new users can receive funds on their first interaction, and how to add it to your app.
- [From any network into a real-world-asset vault: the Flint deposit hook](https://docs.sodax.com/resources/blog/flint-rwa-vault-deposits.md): SODAX built a delivery hook for Flint so a depositor can fund a Flint RWA vault position from any asset on any supported network in a single intent. Here is what Flint needed, what the hook does and how the same pattern is open to other builders.
- [VibeCode Saga: Crypto → Wall Street for macOS: a native menu-bar client for the SODAX oracle](https://docs.sodax.com/resources/blog/vibecode-saga-crypto-to-wallstreet-mac.md): 421 lines of SwiftUI, no SDK, one public endpoint. Live xStock prices and a coin to stock converter in the macOS menu bar, powered by the same oracle that prices SODAX swaps.
- [VibeCode Saga: Just Sweep It: consolidating scattered balances with a 0.15% partner fee](https://docs.sodax.com/resources/blog/vibecode-saga-dust-sweeper.md): A cross-network consolidator built on the SODAX SDK. Eight networks scanned, fragments swept into one token with intents, a partner fee set in one line of config, and self-serve recovery through the hub.
- [VibeCode Saga: HARENA: a cross-network swap staged as a gladiator duel](https://docs.sodax.com/resources/blog/vibecode-saga-harena.md): A token swap on the SODAX SDK where the finishing blow of the duel is the solver fill. Twenty champions across five networks, each one a real swappable token, with the animation held open until the intent settles on mainnet.
- [VibeCode Saga: SODAX Terminal: a whole DeFi section on one SDK](https://docs.sodax.com/resources/blog/vibecode-saga-sodax-terminal.md): Swaps, xStocks, cross-network limit orders, lending, staking and a portfolio in one terminal, built on the SODAX SDK with no backend of my own. One hook pattern everywhere, and an orderbook view that draws every route through the Sonic hub.
- [VibeCode Saga: SodaxPay: cross-chain payment links, vibecoded](https://docs.sodax.com/resources/blog/vibecode-saga-sodaxpay.md): A weekend build on the SODAX SDK. One link accepts payment from any wallet on 12 networks, the recipient gets exactly what they asked for, and a departures board tracks every intent from signature to settlement.
- [VibeCode Saga: Swaps without Borders: a charity swap built in public](https://docs.sodax.com/resources/blog/vibecode-saga-swaps-without-borders.md): A two-week mainnet build on SODAX SDK V2 where 100% of the partner fee goes to a community-voted charity. One config object routes the fee, the Builders MCP got me to a mainnet swap in an afternoon, and the solver's own status API makes points unfarmable.
- [VibeCode Saga: Yield Pachinko: a no-loss parlor on the SODAX money market](https://docs.sodax.com/resources/blog/vibecode-saga-yield-pachinko.md): A neon pachinko board on top of real cross-network USDC deposits into the SODAX money market. Four dapp-kit hooks carry the money, a canvas physics board carries the fun, and principal comes back out whenever you want.
- [Workshop: build Leverage Yield with AI](https://docs.sodax.com/resources/workshops/leverage-yield.md): Fork the SODAX Leverage Yield starter, build a vault deposit app with AI in about an hour, and open a PR to show your solution.
- [FAQ](https://docs.sodax.com/developers/faq.md)
- [Get in touch](https://docs.sodax.com/contact.md): Reach the SODAX team about an integration, an SDK bug, or a partnership.


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