omni-sdk

yarn add @hot-labs/omni-sdk

import { HotBridge, Network } from "@hot-labs/omni-sdk";

const bridge = new HotBridge({
  logger: console, // optional
  evmRpc: { 56: ["https://bsc-rpc.example"] }, // only for the EVM chains you use
  tonRpc: "<tonapi key>", // only for TON
  // only for the fallbacks below: a deposit the relay cannot credit, a clear it cannot send
  executeNearTransaction: async ({ receiverId, actions }) => {
    const hash = await relayer.signAndSendTransaction({ receiverId, actions });
    return { sender: relayer.accountId, hash };
  },
});

const intentAccount = "alice.near";
const hash = await bridge.ton.deposit({
  token: "native",
  amount: 100_000_000n,
  sender: "<payer address>",
  intentAccount,
  sendTransaction: async (tx) => "<tx hash>", // the payer sends it
});

// usually 30 s to 2 min; pass an AbortSignal to stop waiting
const pending = await bridge.waitPendingDeposit(Network.Ton, hash, intentAccount);
const result = await bridge.finishDeposit(pending); // { hash, sender } of the NEAR tx, or null if already credited

const result = await bridge.withdrawToken({
  chain: Network.Bnb,
  token: "native",
  amount: 10n ** 16n,
  receiver: "0x…",
  intentAccount: "alice.near",
  signIntents: async (intents) => signed, // signed by the intents account
  gasless: false,
});

const withdraw = await bridge.getPendingWithdrawal(result!.nonce);
await bridge.evm.withdraw({ ...withdraw, sender: "<executor>", sendTransaction: async (tx) => "<tx hash>" });

const pendings = await bridge.getPendingWithdrawalsWithStatus(56, "0x…");

// paid on the chain but not cleared on omni: the relay clears them (POST /relay/clear)
const completed = pendings.filter((t) => t.completed);
if (completed.length) await bridge.clearPendingWithdrawals(completed);

// not paid yet: send each payout, oldest first
for (const pending of pendings.filter((t) => !t.completed)) {
  await bridge.evm.withdraw({ ...pending, sender: "<executor>", sendTransaction });
}