Client reference

const pesa = createTransfersClient({ baseUrl, getToken });

class TransfersApiError extends Error {
  status: number;   // HTTP status
  body: unknown;    // parsed JSON body, or the raw text
}

pesa.getRoutes(): Promise<RouteInfo[]>

interface RouteInfo {
  route: Route;                  // "cctp-deposit" | "usdt0-deposit" | "cctp-withdraw" | "usdt0-withdraw" | "stellar-send"
  network: "testnet" | "mainnet";
  source_chain: string;          // CAIP-2
  source_asset: string;          // CAIP-19 or stellar:CODE:ISSUER
  dest_chain: string;
  dest_asset: string;
  min: string;                   // base units
  max: string;
  funding_modes: ("deposit_address" | "direct")[];
  available: boolean;            // false while a relayer is low on fees
  typical_seconds: number;
}

pesa.quote(req: QuoteRequest): Promise<QuoteResponse>

interface QuoteRequest {
  route: Route;
  amount_in: string;             // source base units, as a decimal string
  source_chain: string;          // CAIP-2
  source_address: string;        // the user's EVM address, or their Stellar G address
  dest_address: string;          // deposits: must equal the owner
  dest_chain?: string;           // withdrawals: the destination CAIP-2
  funding_mode?: "deposit_address" | "direct";
}

interface QuoteResponse {        // SEP-38 fields
  id: string;
  expires_at: string;
  sell_asset: string;
  buy_asset: string;
  sell_amount: string;
  buy_amount: string;
  price: string;
  fee: { total: string; asset: string; details: { name: string; amount: string }[] };
}

pesa.createTransfer(quoteId: string, idempotencyKey: string): Promise<TransferView>

pesa.getActions(id: string): Promise<Action | null>

type Action =
  | { kind: "send_to_address"; chain: string; asset: string; address: `0x${string}`; amount: string }
  | { kind: "evm_calls"; chainId: number; calls: { to: `0x${string}`; data: `0x${string}`; value: string }[] }
  | { kind: "stellar_tx"; xdr: string; network_passphrase: string }
  | { kind: "stellar_trustline"; asset: string };

pesa.submit(id: string, s: Submission): Promise<TransferView>

type Submission =
  | { kind: "evm_tx"; hash: `0x${string}` }
  | { kind: "stellar_tx"; signed_xdr: string };

pesa.getTransfer(id: string): Promise<TransferView>

interface TransferView {
  id: string;
  route: Route;
  direction: "deposit" | "withdraw" | "send";
  status: Sep24Status;           // whose turn it is
  stage: Stage;                  // the internal state
  amount_in: string;
  amount_out: string;
  amount_fee: string;
  source_chain: string;
  source_address: string;
  dest_chain: string;
  dest_address: string;
  external_transaction_id: string | null;  // the EVM transaction
  stellar_transaction_id: string | null;
  started_at: string;
  updated_at: string;
  completed_at: string | null;
  expires_at: string;
  explorer: { source?: string; destination?: string };
}

pesa.listTransfers(q?: { before?: string }): Promise<TransferView[]>

pesa.cancel(id: string): Promise<TransferView>