Quickstart

npm install @satsterminal-sdk/swaps
# or via suite
npm install satsterminal-sdk

import { SatsTerminal } from "@satsterminal-sdk/swaps";
// or: import { SatsTerminal } from "satsterminal-sdk";

const swaps = new SatsTerminal({
  apiKey: process.env.API_KEY!,
});

const quote = await swaps.swapQuote({
  amount: "0.001",
  fromToken: "BTC",
  toToken: "USDC",
  address: "bc1p...",
  protocol: "runes",
  params: {},               // keep empty unless protocol requires extras
});

console.log(quote.bestMarketplace, quote.swapId, quote.metrics);

const psbt = await swaps.swapPSBT({
  marketplace: quote.bestMarketplace,
  swapId: quote.swapId,
  address: "bc1p...",
  publicKey: "<your-pubkey>",
  paymentAddress: "<change-or-receive-address>",
  paymentPublicKey: "<change-pubkey>",
  protocol: "runes",
  feeRate: 5,
  slippage: 9,
  themeID: null,            // optional UI theme id
});

// psbt.psbts is an array; each entry has { base64, hex, inputs }

const signedPsbts = psbt.psbts.map(({ hex }) => signWithWallet(hex));

const result = await swaps.swapSubmit({
  marketplace: quote.bestMarketplace,
  swapId: psbt.swapId,
  address: "bc1p...",
  publicKey: "<your-pubkey>",
  paymentAddress: "<change-or-receive-address>",
  paymentPublicKey: "<change-pubkey>",
  protocol: "runes",
  signedPsbts,
});

console.log("txid", result.txid, "marketplace", result.marketplace);

import { createClient } from "satsterminal-sdk";
import { ChainType } from "@satsterminal-sdk/borrow";

const { swaps, borrow } = createClient({
  apiKey: process.env.API_KEY!,
  borrow: { chain: ChainType.BASE, wallet: /* wallet provider */ },
});

await swaps.fetchQuote();
await swaps.getPSBT();
await swaps.confirmPSBT();