@sodax/sdk

The SODAX SDK provides a comprehensive interface for interacting with the SODAX protocol, enabling cross-chain swaps, money market, cross-chain bridging, migration and staking SODA token.

Get started

Installation

# Using npm
npm install @sodax/sdk

# Using yarn
yarn add @sodax/sdk

# Using pnpm
pnpm add @sodax/sdk

Local Installation

Package can be locally installed by following this steps:

1. Clone this repository to your local machine.

2. cd into repository folder location.

3. Execute pnpm install command in your CLI to install dependencies.

4. Execute pnpm run build to build the packages.

5. In your app repository package.json file, define dependency named "@sodax/sdk" under "dependencies". Instead of version define absolute path to your SDK repository "file:<sdk-repository-path>" (e.g. "file:/Users/dev/.../operation-liquidity-layer/packages/sdk"). Full example: "@sodax/sdk": "file:/Users/dev/operation-liquidity-layer/sdk-new/packages/sdk".

Local Development

How to setup local development

1. Clone repository.

2. Make sure you have Node.js v18+ and corresponding npm installed on your system.

3. Execute pnpm install command (from root of the project) in your CLI to install dependencies.

4. Make code changes.

   1. Do not forget to export TS files in same folder index.ts.

   2. Always import files using .js postfix.

Functional Modules inside the SDK

Swaps (Solver) - Cross-chain intent-based swaps

• EVM (Arbitrum, Avalanche, Base, BSC, Optimism, Polygon, Sonic, HyperEVM, Lightlink) ✅

• Sui ✅

• Stellar ✅

• ICON ✅

• Solana ✅

• Injective ✅

Lend / Borrow (Money Market)- Cross-chain lending and borrowing

• EVM (Arbitrum, Avalanche, Base, BSC, Optimism, Polygon, Sonic, HyperEVM, Lightlink) ✅

• Sui ✅

• Stellar ✅

• ICON ✅

• Solana ✅

• Injective ✅

Bridge- Cross-chain token bridging

• EVM (Arbitrum, Avalanche, Base, BSC, Optimism, Polygon, Sonic, HyperEVM, Lightlink) ✅

• Sui ✅

• Stellar ✅

• ICON ✅

• Solana ✅

• Injective ✅

Migration- Token migration (ICX, bnUSD, BALN)

Staking- SODA token staking

• EVM (Arbitrum, Avalanche, Base, BSC, Optimism, Polygon, Sonic, HyperEVM, Lightlink) ✅

• Sui ✅

• Stellar ✅

• ICON ✅

• Solana ✅

• Injective ✅

Tooling Modules inside the SDK

Backend API- Solver API endpoint documentation

Intent Relay API- Relayer API endpoint documentation

---

Contributing

We welcome contributions! Please see our Contributing Guide for details.

---

Development Commands

# Install dependencies
pnpm install

# Build the package
pnpm build

# Run in development mode
pnpm dev

# Run type checking
pnpm checkTs

# Format code
pnpm pretty

# Lint code
pnpm lint

---

License

• MIT

---

Support

• GitHub Issues

• Discord Community