Skip to main content

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, 29 assets are live for swaps: ETH, bnUSD, SODA, USDG, and Robinhood Stock Tokens among them. 4 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 166 assets across every SODAX-supported network. See the live tables in Networks & 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 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.

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

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

Can my AI coding assistant do the integration?

Largely, yes. Add the SODAX 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.

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.