Your first swap

npm install @sodax/sdk @sodax/wallet-sdk-core

import { Sodax, ChainKeys, spokeChainConfig, type CreateIntentParams, type Hex } from '@sodax/sdk';
import { EvmWalletProvider } from '@sodax/wallet-sdk-core';

const sodax = new Sodax(); // mainnet defaults
const init = await sodax.initialize();
if (!init.ok) {
  console.warn('Using packaged config', init.error);
}

const privateKey = process.env.EVM_PRIVATE_KEY;
if (!privateKey?.startsWith('0x')) {
  throw new Error('Set EVM_PRIVATE_KEY to a 0x-prefixed private key');
}

const wallet = new EvmWalletProvider({
  privateKey: privateKey as Hex, // the guard above is what makes this cast safe
  chainId: ChainKeys.ARBITRUM_MAINNET,
  // rpcUrl is optional — omitted, the chain's default RPC is used.
});

const srcChainKey = ChainKeys.ARBITRUM_MAINNET;
const dstChainKey = ChainKeys.BSC_MAINNET;

// Read token addresses from config rather than hardcoding them.
const inputToken = spokeChainConfig[srcChainKey].nativeToken; // ETH on Arbitrum
const outputToken = spokeChainConfig[dstChainKey].nativeToken; // BNB on BNB Chain

const inputAmount = 100_000_000_000_000n; // 0.0001 ETH

const quote = await sodax.swaps.getQuote({
  token_src: inputToken,
  token_dst: outputToken,
  token_src_blockchain_id: srcChainKey,
  token_dst_blockchain_id: dstChainKey,
  amount: inputAmount,
  quote_type: 'exact_input',
});
if (!quote.ok) {
  throw new Error(`Quote failed: ${quote.error.detail.code}`);
}

// Absolute hub deadline (seconds). Prefer getSwapDeadline; 0n = no deadline.
const deadline = await sodax.swaps.getSwapDeadline(300n); // valid for the next 5 minutes
if (!deadline.ok) {
  console.error(deadline.error);
  throw new Error('Deadline failed');
}

const walletAddress = await wallet.getWalletAddress();

const params: CreateIntentParams<typeof srcChainKey> = {
  inputToken,
  outputToken,
  inputAmount,
  minOutputAmount: (quote.value.quoted_amount * 95n) / 100n, // 5% slippage tolerance
  deadline: deadline.value,
  allowPartialFill: false,
  srcChainKey,
  dstChainKey,
  srcAddress: walletAddress,
  dstAddress: walletAddress,
  data: '0x',
};

const result = await sodax.swaps.swap({ params, walletProvider: wallet });
if (!result.ok) {
  console.error(result.error.code, result.error.context);
  throw new Error('Swap failed');
}

const { intentDeliveryInfo } = result.value;
console.log('Hub transaction:', intentDeliveryInfo.dstTxHash);

import { SolverIntentStatusCode } from '@sodax/sdk';

let notFoundCount = 0;
let solved = false;

for (let attempt = 0; attempt < 60; attempt++) {
  // getStatus takes a Hex; intentDeliveryInfo.dstTxHash is typed string.
  const status = await sodax.swaps.getStatus({ intent_tx_hash: intentDeliveryInfo.dstTxHash as Hex });

  if (status.ok) {
    if (status.value.status === SolverIntentStatusCode.SOLVED) {
      console.log('Solved. Fill transaction:', status.value.fill_tx_hash);
      solved = true;
      break;
    }
    if (status.value.status === SolverIntentStatusCode.FAILED) {
      throw new Error('Intent failed');
    }
    // NOT_FOUND is not terminal: the solver can answer it for the first few polls after
    // creation, so retry before giving up. Reset once any other status arrives.
    if (status.value.status === SolverIntentStatusCode.NOT_FOUND) {
      if (++notFoundCount >= 3) throw new Error('Intent not found after 3 consecutive polls');
    } else {
      notFoundCount = 0;
    }
  }

  await new Promise(resolve => setTimeout(resolve, 5000));
}

// Running out of polls is not settlement: the intent is still pending, not done.
if (!solved) {
  throw new Error('Intent still unsettled after 60 polls');
}