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

# SODAX for Ethereum

> Reach the users and liquidity of every SODAX network from your Ethereum product. No contracts to deploy: integrate over the HTTP API from any language, or the TypeScript SDK.

> [!NOTE]
>
> **No new contracts.** SODAX's Ethereum spoke contracts are already live; integrate over the HTTP API from any language, or in TypeScript with the SDK. Your users sign ordinary Ethereum transactions, and SODAX coordinates cross-network execution, routing, and recovery behind the scenes.

You keep shipping on Ethereum. SODAX absorbs the cross-network execution layer, so your product can offer trading and lending against every asset in the SODAX System, 166 across all supported networks, without leaving your stack. Swaps and leverage yield run over the HTTP API from any language; money market supply and borrow run in TypeScript at the SDK or React layer. There is nothing to deploy, audit, or maintain on-chain.

Using SODAX is free. Trades carry a fixed 0.1% base fee taken by the protocol, and you set your own platform fee on top. That part is fully yours, both the rate and the revenue. See [Monetize SDK](https://docs.sodax.com/developers/how-to/monetize_sdk.md).

## What to know on Ethereum

Ethereum is a standard EVM network to SODAX: the same `EvmWalletProvider`, the same ERC-20 approvals, and the same intent flow as every other EVM network. ETH is the native token and needs no approval. One token behaves differently:

* **USDT can take two approval transactions.** Ethereum USDT rejects an allowance change from one non-zero value to another. When a wallet already holds a stale USDT allowance, the SDK's `approve` sends `approve(0)` first, waits for it to be mined, then sends the real approval, so the user signs twice. See [Approvals](https://docs.sodax.com/ethereum/swaps.md#approvals).

## What you can build

Two SODAX modules are relevant to Ethereum builders:

> [card] [Swaps](https://docs.sodax.com/ethereum/swaps.md)
>
> Intent-based cross-network swaps. Users swap between ETH or ERC-20 tokens and assets on any supported network with one signed transaction on Ethereum. Solvers fill; SODAX routes and settles.

> [card] [Money Market](https://docs.sodax.com/ethereum/money-market.md)
>
> Cross-network lending and borrowing. Supply from Ethereum, borrow to Ethereum or any other supported network, and manage positions without running lending infrastructure.

## Choose your integration path

| Path | Best for | Start here |
| - | - | - |
| [HTTP API](https://docs.sodax.com/developers/http-api.md) | Swaps and leverage yield from any language, with no SDK to install. Get a key at [portal.sodax.com](https://portal.sodax.com) | [Swap bot flow](https://docs.sodax.com/developers/http-api/swaps.md#bot-flow-create-submit-tx-poll) |
| [`@sodax/sdk`](https://docs.sodax.com/developers/packages/foundation/sdk) | Full control from any TypeScript backend or frontend | [Quickstart](https://docs.sodax.com/ethereum/quickstart.md) |
| [`@sodax/dapp-kit`](https://docs.sodax.com/developers/packages/experience/dapp-kit) + [`@sodax/wallet-sdk-react`](https://docs.sodax.com/developers/packages/connection/wallet-sdk-react) | React apps that want hooks and wallet connectivity out of the box | [Wallets](https://docs.sodax.com/ethereum/wallets.md) |
| [Builders MCP](https://docs.sodax.com/builders-mcp.md) | Building with AI agents against the full SODAX stack | See below |

## Scope and build with AI

Point your AI coding assistant at the [SODAX Builders MCP](https://docs.sodax.com/builders-mcp.md) and it gains live access to the whole SODAX System: supported chains and tokens, real swap quotes, money market rates, intent history, and these docs. It works in Claude, Cursor, VS Code, Windsurf, and any other MCP-capable client.

```json theme={null}
{
  "mcpServers": {
    "sodax-builders": {
      "url": "https://builders.sodax.com/mcp"
    }
  }
}
```

Use it to scope before you commit: your assistant can read your own codebase, pull real quotes and token lists, and map exactly where SODAX fits in your product. Full tool list and per-client setup at [builders.sodax.com](https://builders.sodax.com/).

## In this section

* [Quickstart](https://docs.sodax.com/ethereum/quickstart.md): install the SDK, connect an Ethereum account, make your first cross-network swap.
* [Swaps on Ethereum](https://docs.sodax.com/ethereum/swaps.md): approvals (including USDT), quoting, fees, and gas estimates.
* [Money Market on Ethereum](https://docs.sodax.com/ethereum/money-market.md): supply, borrow, repay, and withdraw with cross-network collateral.
* [Wallets](https://docs.sodax.com/ethereum/wallets.md): EVM wallets on Ethereum, and every other network's wallets through one interface.
* [Networks & Assets](https://docs.sodax.com/ethereum/networks-and-assets.md): what is live on Ethereum today and what your users can reach.
* [Ethereum FAQ](https://docs.sodax.com/ethereum/faq.md): the questions Ethereum engineers actually ask.

## Ethereum references

* [**Ethereum developer docs**](https://ethereum.org/developers/docs/): accounts, transactions, and the EVM.
* [**Gas and fees**](https://ethereum.org/developers/docs/gas/): how Ethereum prices the transactions your users sign.
* [**Etherscan**](https://etherscan.io/): the Ethereum mainnet explorer, for checking transactions and allowances.

***

Building something? Start with the [Quickstart](https://docs.sodax.com/ethereum/quickstart.md).


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