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

# Robinhood Chain FAQ

> The questions Robinhood Chain engineers actually ask about integrating SODAX.

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

No. SODAX's Robinhood Chain spoke contracts are already deployed; your integration is TypeScript against `@sodax/sdk` (or the React packages on top of it). You write no on-chain code and hold no admin key for any part of the flow.

#### How does a swap from Robinhood Chain actually settle?

Your user signs one EVM transaction on Robinhood Chain 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. If an intent is never filled, it can be cancelled and the funds recovered.

#### Which assets are supported on Robinhood Chain?

Two answers, and the difference matters. On Robinhood Chain itself, <span data-sodax-config="count" data-metric="chain-swap-tokens" data-chain="robinhood">29</span> assets are live for swaps: ETH, bnUSD, SODA, USDG, and Robinhood Stock Tokens among them. <span data-sodax-config="count" data-metric="chain-money-market-tokens" data-chain="robinhood">4</span> work in the money market; Stock Tokens are not among them.

But your users are not limited to the Robinhood Chain list. Every swap is cross-network, so from Robinhood Chain they can reach all <span data-sodax-config="count" data-metric="swap-tokens">166</span> assets across every SODAX-supported network. See the live tables in [Networks & Assets](/robinhood-chain/networks-and-assets).

#### Why does the SDK reject a Stock Token, or a money market call on Robinhood Chain?

Because `@sodax/sdk` 2.1.0 does not list them. Its Robinhood Chain swap list holds ETH, bnUSD, SODA, and USDG, its money market list is empty, and it validates every token against those lists. Stock Token swaps and Robinhood Chain money market support are on `main` for the next release.

#### Can users lend or borrow against Stock Tokens?

Not through SODAX. Stock Tokens are swap-only in the SODAX config: none is in the money market list.

#### Are there restrictions on offering Stock Tokens?

Robinhood's [Stock Tokens documentation](https://docs.robinhood.com/chain/stock-tokens) states that Stock Tokens may not be offered, sold, or delivered in the United States or to U.S. persons, and that offers and sales are restricted in other jurisdictions it lists. Review those terms for your product before you surface Stock Tokens.

#### Where do I get a Robinhood Chain definition for viem or wagmi?

From `@sodax/wallet-sdk-core`, which exports `robinhoodChain` (chain ID 4663). The viem version SODAX's packages depend on has no Robinhood Chain entry. `@sodax/wallet-sdk-react` already includes the chain in its wagmi config. See [Wallets](/robinhood-chain/wallets#your-own-viem-or-wagmi-setup).

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

For ERC-20 tokens, Stock Tokens included, yes. `isAllowanceValid` checks the allowance and `approve` sets it, the same as on any EVM network. Native ETH needs no approval.

#### Which RPC endpoint should I use?

A provider endpoint, in production. The SODAX config uses Robinhood Chain's public RPC, `https://rpc.mainnet.chain.robinhood.com`, which Robinhood marks as rate-limited and not recommended for production. Robinhood lists providers on [Connecting to Robinhood Chain](https://docs.robinhood.com/chain/connecting/). Pass your endpoint through `rpcUrl` on `EvmWalletProvider`, or per chain in the `@sodax/wallet-sdk-react` config.

#### Is there a testnet?

No. SODAX is mainnet-only on every network, Robinhood Chain included.

#### 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 users also pay Robinhood Chain's network fees in ETH. See [Monetize SDK](/developers/how-to/monetize_sdk).

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

Audits for the SODAX protocol are collected on the [Audits](/developers/audits) page.

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

Largely, yes. Add the [SODAX Builders MCP](/builders-mcp) to Claude, Cursor, VS Code, Windsurf, or any MCP-capable client (`https://builders.sodax.com/mcp`) and it gets 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?

Reach the SODAX team through any platform listed at [linktr.ee/go.sodax](https://linktr.ee/go.sodax).


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