Sanctum for developers: LST swap API, Gateway transaction delivery, and on-chain programs

# Base URL
https://sanctum-api.ironforge.network

# ── Quote endpoints (no signer required) ───────────────────────────
GET /swap/quote
  ?input=<LST mint or stake account vote pubkey>
  &output=<LST mint or vote account>
  &amount=<lamports>
  &mode=ExactIn|ExactOut
  &swapSrc=Inf,SanctumRouter,Jup   # optional: filter sources
  # Returns: best quote across all enabled sources

# ── Transaction endpoints (signer required) ─────────────────────────
GET /swap/depositSol/order     # SOL → LST
GET /swap/withdrawSol/order    # LST → SOL
GET /swap/depositStake/order   # stake account → LST
GET /swap/withdrawStake/order  # LST → stake account

# Shared query params:
#   input, output, amount, mode (ExactIn|ExactOut)
#   slippageBps: tolerance in basis points (default 30 = 0.3%)
#   signer: your wallet pubkey (required for tx endpoint)
#   swapSrc: comma-separated filter (Inf | SanctumRouter | Jup)
#   lstAcc: specific LST token account (defaults to signer's ATA)
#   stakeAcc: specific stake account pubkey (for stake-based ops)

// Stake 1 SOL into jupSOL — get back a transaction to sign
const JUPSOL_MINT = "jupSoLaHXQiZZTSfEWMTRRgpnyFm8f6sZdosWBjx93v";
const signer = wallet.publicKey.toBase58();

const url = new URL("https://sanctum-api.ironforge.network/swap/depositSol/order");
url.searchParams.set("input",      "So11111111111111111111111111111111111111112"); // SOL
url.searchParams.set("output",     JUPSOL_MINT);
url.searchParams.set("amount",     String(1e9));   // 1 SOL in lamports
url.searchParams.set("mode",       "ExactIn");
url.searchParams.set("slippageBps","50");           // 0.5%
url.searchParams.set("signer",     signer);

const { tx, outAmount } = await fetch(url).then(r => r.json());
// tx: base64-encoded versioned transaction ready to sign
// outAmount: how many jupSOL lamports you'll receive

const txBytes = Buffer.from(tx, "base64");
const vtx = VersionedTransaction.deserialize(txBytes);
vtx.sign([wallet]);
const sig = await connection.sendRawTransaction(vtx.serialize());

// Swap any LST to any other LST (e.g. jupSOL → mSOL)
const MSOL_MINT = "mSoLzYCxHdYgdzU16g5QSh3i5K3z3KZK7ytfqcJm7So";

const url = new URL("https://sanctum-api.ironforge.network/swap/quote");
url.searchParams.set("input",     JUPSOL_MINT);
url.searchParams.set("output",    MSOL_MINT);
url.searchParams.set("amount",    String(5e9));      // 5 jupSOL
url.searchParams.set("mode",      "ExactIn");
url.searchParams.set("swapSrc",   "Inf,SanctumRouter"); // skip Jupiter

const quote = await fetch(url).then(r => r.json());
// { route: "Inf", outAmount: "4991234567", priceImpactPct: "0.02" }

// Then call /swap/depositSol/order with the same params + signer to get the tx

# Fetch the LST registry and find a specific LST
curl -s https://raw.githubusercontent.com/igneous-labs/sanctum-lst-list/master/sanctum-lst-list.toml \
  | grep -A5 'symbol = "jupSOL"'

# Output:
# [[sanctum_lst_list]]
# symbol = "jupSOL"
# mint = "jupSoLaHXQiZZTSfEWMTRRgpnyFm8f6sZdosWBjx93v"
# vote_account = "..."
# pool = { type = "SplStakePool", ... }

const GATEWAY_URL = `https://gateway.sanctum.so/rpc?cluster=mainnet-beta&apiKey=${API_KEY}`;

async function sendViaGateway(connection: Connection, tx: Transaction, wallet: Keypair) {
  // 1. Serialize unsigned transaction
  tx.recentBlockhash = (await connection.getLatestBlockhash()).blockhash;
  tx.feePayer = wallet.publicKey;
  const unsignedBase64 = tx.serialize({ requireAllSignatures: false }).toString("base64");

  // 2. Build through Gateway (adds priority fees, Jito tip accounts)
  const buildRes = await fetch(GATEWAY_URL, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      jsonrpc: "2.0",
      id: 1,
      method: "buildGatewayTransaction",
      params: [unsignedBase64, { encoding: "base64" }],
    }),
  }).then(r => r.json());

  const optimizedTx = Transaction.from(Buffer.from(buildRes.result, "base64"));

  // 3. Sign locally
  optimizedTx.sign(wallet);
  const signedBase64 = optimizedTx.serialize().toString("base64");

  // 4. Send through Gateway delivery network
  const sendRes = await fetch(GATEWAY_URL, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      jsonrpc: "2.0",
      id: 2,
      method: "sendTransaction",
      params: [signedBase64, { encoding: "base64" }],
    }),
  }).then(r => r.json());

  return sendRes.result; // transaction signature
}

# Key repos under github.com/igneous-labs
sanctum-router-sdk     # Rust + TypeScript Router Program SDK
sanctum-lst-list       # Canonical LST registry (TOML)
sanctum-solana-utils   # Shared Solana utilities
sol-val-calc           # SOL value calculator SDK and programs
inf-1.5                # Infinity pool v1.5 (active)
S                      # S Controller Program (archived, see inf-1.5)