Quickstart

npm install <SDK_PACKAGE>

import { createApsisClient } from "<SDK_PACKAGE>";

const client = createApsisClient({
  baseUrl: process.env.APSIS_API_URL!,
  apiKey: process.env.APSIS_API_KEY,
});

const { apsis } = client;

const { tokens } = await apsis.listTokens({});
const usdc = (chain: string) =>
  tokens.find((t) => t.chain === chain && t.symbol === "USDC")!;

const src = usdc("arbitrum");
const dst = usdc("solana");

import { quoteOf } from "<SDK_PACKAGE>";

const response = await apsis.getQuote({
  srcChain: "arbitrum",
  dstChain: "solana",
  srcToken: src.address,
  dstToken: dst.address,
  amountIn: "25000000",
  recipient: recipientSolanaAddress,
  refundAddress: userAddress,
  gasDrop: "",
});

const quote = quoteOf(response);
if (!quote) throw new Error("no quote");

quote.quoteHash;      // bind the deposit to this
quote.amountOut;      // net of every fee
quote.minAmountOut;   // guaranteed floor
quote.routerAddress;  // deposit target

import { createChainAdapter } from "<SDK_PACKAGE>";

const { chains } = await apsis.getChains({});
const arbitrum = chains.find((c) => c.chain === "arbitrum")!;

const adapter = createChainAdapter(client, arbitrum, 42161n);
const steps = await adapter.steps(wallet, quote.quoteHash, quote.orderParams);

for (const step of steps) {
  const hash = await step.run();   // "approve" then "deposit"
}

import { isTerminalState, orderOutcome } from "<SDK_PACKAGE>";

while (true) {
  const detail = await apsis.getOrder({ quoteHash: quote.quoteHash });
  const state = detail.order?.state;

  if (state && isTerminalState(state)) {
    console.log(orderOutcome(state));   // "fulfilled" | "refunded" | "failed"
    break;
  }
  await new Promise((r) => setTimeout(r, 2000));
}