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

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

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

You keep shipping on HyperEVM. 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, against HyperEVM. 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).

## Two things that differ from other EVM networks

To the SDK, HyperEVM is an EVM network like any other: chain ID 999, HYPE as the native gas token, the same wallet provider and approvals. What sets it apart is its place inside Hyperliquid:

* **HyperCore balances are not HyperEVM balances.** Hyperliquid has two parts, HyperCore (spot, perps, and the order books) and HyperEVM. SODAX acts on HyperEVM only. Funds a user holds in HyperCore spot or perps are invisible to the SDK and cannot fund an intent until the user transfers them to HyperEVM (the "Transfer to/from EVM" action in Hyperliquid's app).
* **Swaps can deliver USDC straight into HyperCore.** The SDK ships a delivery hook for HyperEVM: set `hook: { kind: HookKind.HYPERCORE_DEPOSIT }` on a swap whose output is USDC on HyperEVM, and the output is deposited into the recipient's HyperCore perps account instead of their HyperEVM wallet. See [Delivering into HyperCore](https://docs.sodax.com/hyperevm/swaps.md#delivering-into-hypercore).

## What you can build

Two SODAX modules are relevant to HyperEVM builders:

> [card] [Swaps](https://docs.sodax.com/hyperevm/swaps.md)
>
> Intent-based cross-network swaps. Users swap between HYPE or HyperEVM tokens and assets on any supported network with one signed transaction, and can land USDC directly in HyperCore. Solvers fill; SODAX routes and settles.

> [card] [Money Market](https://docs.sodax.com/hyperevm/money-market.md)
>
> Cross-network lending and borrowing. Supply from HyperEVM, borrow to HyperEVM 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/hyperevm/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/hyperevm/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/hyperevm/quickstart.md): install the SDK, connect a HyperEVM wallet, make your first cross-network swap.
* [Swaps on HyperEVM](https://docs.sodax.com/hyperevm/swaps.md): approvals, quoting, fees, and delivering USDC into HyperCore.
* [Money Market on HyperEVM](https://docs.sodax.com/hyperevm/money-market.md): supply, borrow, repay, and withdraw with cross-network collateral.
* [Wallets](https://docs.sodax.com/hyperevm/wallets.md): EVM wallets on HyperEVM, and every other network's wallets through one interface.
* [Networks & Assets](https://docs.sodax.com/hyperevm/networks-and-assets.md): what is live on HyperEVM today and what your users can reach.
* [HyperEVM FAQ](https://docs.sodax.com/hyperevm/faq.md): the questions HyperEVM engineers actually ask.

## HyperEVM references

* [**HyperEVM for developers**](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/hyperevm): chain ID, JSON-RPC endpoint, and HYPE as the gas token.
* [**HyperCore and HyperEVM transfers**](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/hyperevm/hypercore-less-than-greater-than-hyperevm-transfers): how assets move between HyperCore and HyperEVM.
* [**How to use the HyperEVM**](https://hyperliquid.gitbook.io/hyperliquid-docs/onboarding/how-to-use-the-hyperevm): adding the network to a wallet and moving assets from HyperCore.
* [**HyperEVMScan**](https://hyperevmscan.io/): the HyperEVM explorer, for checking transactions and token balances.

***

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


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