> ## 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 ({ 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. # Installing @sodax/sdk with Next.js This guide will walk you through setting up `@sodax/sdk` in a Next.js project, from project creation to using the SDK features. ## Prerequisites * Node.js 18+ installed * npm, yarn, or pnpm package manager * Basic knowledge of Next.js and TypeScript ## Step 1: Create Your Project First, create a new Next.js project with TypeScript: ```bash theme={null} # Using create-next-app (recommended) npx create-next-app@latest my-sodax-app --typescript --tailwind --eslint # Or using yarn yarn create next-app my-sodax-app --typescript --tailwind --eslint # Or using pnpm pnpm create next-app my-sodax-app --typescript --tailwind --eslint ``` Navigate to your project directory: ```bash theme={null} cd my-sodax-app ``` ## Step 2: Install @sodax/sdk Install the SODAX SDK and its peer dependencies: ```bash theme={null} # Using npm npm install @sodax/sdk @sodax/types viem # Using yarn yarn add @sodax/sdk @sodax/types viem # Using pnpm pnpm add @sodax/sdk @sodax/types viem ``` ## Step 3: Create Sodax Instance Create a Sodax instance provider. Create `providers/SodaxProvider.tsx`: ```typescript theme={null} // providers/SodaxProvider.tsx 'use client'; import { createContext, useContext, type ReactNode } from 'react'; import { Sodax } from '@sodax/sdk'; // Create Sodax instance const sodaxInstance = new Sodax(); // Create context const SodaxContext = createContext(null); // Provider component export function SodaxProvider({ children }: { children: ReactNode }) { return ( {children} ); } // Hook to use Sodax instance export function useSodax() { const context = useContext(SodaxContext); if (!context) { throw new Error('useSodax must be used within a SodaxProvider'); } return context; } ``` Update your `app/layout.tsx` to include the SodaxProvider: ```typescript theme={null} // app/layout.tsx import { SodaxProvider } from '@/providers/SodaxProvider'; export default function RootLayout({ children, }: { children: React.ReactNode; }) { return ( {children} ); } ``` ## Step 4: Start Your Build Process Start the development server: ```bash theme={null} # Using npm npm run dev # Using yarn yarn dev # Using pnpm pnpm dev ``` Your Next.js application should now be running on `http://localhost:3000`. ## Step 5: Start Using @sodax/sdk Now you can use the SODAX SDK in your components. Here's an example of how to use it: ```typescript theme={null} // app/page.tsx 'use client'; import { useSodax } from "./providers/SodaxProvider"; import { SolverIntentQuoteRequest } from "@sodax/sdk"; import { useEffect } from "react"; const payload = { amount: 10000000000000000000n, quote_type: "exact_input", token_dst: "0x0000000000000000000000000000000000000000", token_dst_blockchain_id: "0x89.polygon", token_src: "cx0000000000000000000000000000000000000000", token_src_blockchain_id: "0x1.icon", } satisfies SolverIntentQuoteRequest export default function Page() { const sodax = useSodax(); useEffect(() => { const getQuote = async () => { const quote = await sodax.swaps.getQuote(payload); console.log(quote); } getQuote(); }, []); return (

Sodax SDK Demo

); } ``` ## TypeScript Configuration Make sure your `tsconfig.json` includes the necessary paths for the `@` alias: ```json theme={null} { "compilerOptions": { "baseUrl": ".", "paths": { "@/*": ["./*"] } } } ``` ## Next Steps Now that you have `@sodax/sdk` set up in your Next.js project, you can: 1. **Explore Solver Features**: Check out the [Swaps documentation](https://github.com/icon-project/sodax-sdks/blob/main/packages/sdk/docs/SWAPS.md) for cross-chain swaps 2. **Explore Money Market Features**: Check out the [Money Market documentation](https://github.com/icon-project/sodax-sdks/blob/main/packages/sdk/docs/MONEY_MARKET.md) for lending and borrowing 3. **Set up Wallet Integration**: Implement wallet providers for the chains you want to support 4. **Add Error Handling**: Implement proper error handling for SDK operations 5. **Add Loading States**: Add loading indicators for async operations ## Troubleshooting ### Common Issues 1. **TypeScript Errors**: Make sure you have the latest version of TypeScript and that your `tsconfig.json` is properly configured. 2. **Import Errors**: Ensure all imports are using the correct paths and that the packages are properly installed. ### Getting Help If you encounter any issues: * Check the [main SDK documentation](https://github.com/icon-project/sodax-sdks/blob/main/packages/sdk/README.md) * Review the [Swaps documentation](https://github.com/icon-project/sodax-sdks/blob/main/packages/sdk/docs/SWAPS.md) for swap-related features * Review the [Money Market documentation](https://github.com/icon-project/sodax-sdks/blob/main/packages/sdk/docs/MONEY_MARKET.md) for lending/borrowing features * Open an issue on the [GitHub repository](https://github.com/icon-project/sodax-sdks/issues) * Join the [Discord community](https://discord.gg/xM2Nh4S6vN) for support