@piprail/sdk 2.16.2 → 3.1.0

package/dist/{algorand-Q3TUQLPK.cjs → algorand-4FTTEV7X.cjs}

@@ -1,8 +1,9 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkV2IJ5HUWcjs = require('./chunk-V2IJ5HUW.cjs');
+var _chunkMZAJQYM3cjs = require('./chunk-MZAJQYM3.cjs');
 
 
+var _chunkMZXVXC3Ccjs = require('./chunk-MZXVXC3C.cjs');
 
 
 
@@ -13,7 +14,10 @@ var _chunkV2IJ5HUWcjs = require('./chunk-V2IJ5HUW.cjs');
 
 
 
-var _chunkQONQSZHJcjs = require('./chunk-QONQSZHJ.cjs');
+
+
+
+var _chunk6XTNI2OQcjs = require('./chunk-6XTNI2OQ.cjs');
 
 // src/drivers/algorand/index.ts
 var _algosdk = require('algosdk'); var _algosdk2 = _interopRequireDefault(_algosdk);
@@ -61,13 +65,13 @@ async function payAlgorand(params) {
   } catch (err) {
     const mapped = mapAlgorandError(err, accept.payTo);
     if (mapped) throw mapped;
-    throw _nullishCoalesce(_chunkQONQSZHJcjs.toInsufficientFundsError.call(void 0, err), () => ( err));
+    throw _nullishCoalesce(_chunk6XTNI2OQcjs.toInsufficientFundsError.call(void 0, err), () => ( err));
   }
 }
 function mapAlgorandError(err, payTo) {
   const m = err instanceof Error ? err.message : String(err);
   if (/must optin/i.test(m) || /missing from/i.test(m) && m.includes(payTo)) {
-    return new (0, _chunkQONQSZHJcjs.RecipientNotReadyError)(
+    return new (0, _chunk6XTNI2OQcjs.RecipientNotReadyError)(
       `Algorand recipient ${payTo} hasn't opted into this asset \u2014 it must opt in (a 0-amount asset transfer to itself) before it can receive. (Algorand: ${firstLine(m)})`,
       { cause: err }
     );
@@ -75,7 +79,7 @@ function mapAlgorandError(err, payTo) {
   if (/overspend|below min|min(imum)? balance|tried to spend|balance \d+ below|asset \d+ missing from|insufficient|underflow/i.test(
     m
   )) {
-    return new (0, _chunkQONQSZHJcjs.InsufficientFundsError)(
+    return new (0, _chunk6XTNI2OQcjs.InsufficientFundsError)(
       `Algorand payment failed: the sender can't cover it \u2014 token balance, ALGO for fees, the 0.1-ALGO minimum balance, or a missing asset opt-in on the sender. (Algorand: ${firstLine(m)})`,
       { cause: err }
     );
@@ -86,6 +90,144 @@ function firstLine(message) {
   return message.split("\n")[0].slice(0, 160);
 }
 
+// src/drivers/algorand/swap.ts
+var VESTIGE_API = "https://api.vestigelabs.org";
+var ALGO_ASA = 0;
+function sourceFor(poolFee) {
+  const fee = typeof poolFee === "number" ? `${(poolFee * 100).toFixed(2)}%` : "the pool's own fee";
+  return {
+    kind: "provider",
+    name: "Vestige",
+    note: `Third-party Algorand DEX aggregator (api.vestigelabs.org), used keyless. It returns an UNSIGNED atomic transaction group in which every signer is you: nobody co-signs and nothing is delegated. Pool fee on this route: ${fee}. PipRail adds nothing.`
+  };
+}
+function asaId(t) {
+  if (t.asset === "native") return ALGO_ASA;
+  const n = Number(t.asset);
+  return Number.isSafeInteger(n) && n > 0 ? n : null;
+}
+function side(t, amount) {
+  const decimals = t.asset === "native" ? ALGO_DECIMALS : t.decimals;
+  return {
+    asset: t.asset,
+    symbol: _nullishCoalesce(t.symbol, () => ( (t.asset === "native" ? "ALGO" : t.asset))),
+    decimals,
+    amount: amount.toString(),
+    amountFormatted: _chunk6XTNI2OQcjs.formatUnits.call(void 0, amount, decimals)
+  };
+}
+async function req(url, init) {
+  const ctrl = new AbortController();
+  const timer = setTimeout(() => ctrl.abort(), 15e3);
+  try {
+    const res = await fetch(url, { ..._nullishCoalesce(init, () => ( {})), signal: ctrl.signal });
+    if (!res.ok) return null;
+    return await res.json();
+  } catch (e2) {
+    return null;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+async function quoteAlgorandSwap(p) {
+  if (p.wantAmount <= 0n) return null;
+  const fromAsa = asaId(p.from);
+  const toAsa = asaId(p.to);
+  if (fromAsa === null || toAsa === null || fromAsa === toAsa) return null;
+  const quoteFor = (amountIn) => req(
+    `${VESTIGE_API}/swap/v4?from_asa=${fromAsa}&to_asa=${toAsa}&amount=${amountIn.toString()}&mode=sef&denominating_asset_id=0`
+  );
+  const fromDecimals = p.from.asset === "native" ? ALGO_DECIMALS : p.from.decimals;
+  let probeIn = 10n ** BigInt(Math.max(fromDecimals - 2, 1));
+  let probeOut = 0;
+  for (let step = 0; step < 4; step += 1) {
+    const probe = await quoteFor(probeIn);
+    const out = _optionalChain([probe, 'optionalAccess', _ => _.amount_out]);
+    if (out && out > 0) {
+      probeOut = out;
+      break;
+    }
+    probeIn *= 10n;
+  }
+  if (!probeOut) return null;
+  let needIn = (probeIn * p.wantAmount + BigInt(probeOut) - 1n) / BigInt(probeOut);
+  needIn = _chunkMZXVXC3Ccjs.applySlippage.call(void 0, needIn, p.slippageBps);
+  const real = await quoteFor(needIn);
+  const realOut = _optionalChain([real, 'optionalAccess', _2 => _2.amount_out]);
+  if (!realOut) return null;
+  if (BigInt(Math.floor(realOut)) < p.wantAmount) return null;
+  const poolFee = _optionalChain([real, 'access', _3 => _3.single, 'optionalAccess', _4 => _4.transactions, 'optionalAccess', _5 => _5[0], 'optionalAccess', _6 => _6.swaps, 'optionalAccess', _7 => _7[0], 'optionalAccess', _8 => _8.fee]);
+  return {
+    source: sourceFor(poolFee),
+    network: p.network,
+    from: side(p.from, needIn),
+    to: side(p.to, BigInt(Math.floor(realOut))),
+    maxSpend: needIn.toString(),
+    maxSpendFormatted: _chunk6XTNI2OQcjs.formatUnits.call(void 0, needIn, fromDecimals),
+    slippageBps: p.slippageBps,
+    // The build endpoint wants the ENTIRE quote response back, unmodified.
+    route: { quote: real }
+  };
+}
+async function swapAlgorand(p) {
+  const route = p.quote.route;
+  if (!_optionalChain([route, 'optionalAccess', _9 => _9.quote])) {
+    throw new Error("Algorand: swap quote is missing its Vestige routing data \u2014 re-quote before swapping.");
+  }
+  const slippage = p.quote.slippageBps / 1e4;
+  const unsigned = await req(
+    `${VESTIGE_API}/swap/v4/transactions?sender=${p.signer.addr}&slippage=${slippage}`,
+    {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify(route.quote)
+    }
+  );
+  if (!_optionalChain([unsigned, 'optionalAccess', _10 => _10.length])) {
+    throw new (0, _chunk6XTNI2OQcjs.RecipientNotReadyError)(
+      "Vestige could not build this swap. The usual cause is that your account is not opted in to the asset you are swapping INTO: opt in first, then re-quote. Nothing was spent."
+    );
+  }
+  for (const t of unsigned) {
+    if (t.signers && t.signers.some((s) => s !== p.signer.addr)) {
+      throw new Error(
+        "Algorand swap refused: the built group asks a third party to co-sign, which this rail must never do. Nothing was signed."
+      );
+    }
+  }
+  try {
+    const signed = unsigned.map((t) => {
+      const decoded = p.algosdk.decodeUnsignedTransaction(Buffer.from(t.txn, "base64"));
+      return decoded.signTxn(p.signer.sk);
+    });
+    const res = await p.algod.sendRawTransaction(signed).do();
+    const txid = _nullishCoalesce(res.txid, () => ( res.txId));
+    if (!txid) throw new Error("Algorand: sendRawTransaction returned no transaction id.");
+    return {
+      transaction: txid,
+      network: p.quote.network,
+      source: p.quote.source,
+      from: p.quote.from,
+      to: p.quote.to
+    };
+  } catch (err) {
+    const msg = String(_nullishCoalesce(_optionalChain([err, 'optionalAccess', _11 => _11.message]), () => ( err)));
+    if (/asset .* missing|not opted in|receiver error/i.test(msg)) {
+      throw new (0, _chunk6XTNI2OQcjs.RecipientNotReadyError)(
+        `Algorand swap refused: your account must opt in to the asset you are swapping INTO first. (${msg.slice(0, 140)})`,
+        { cause: err }
+      );
+    }
+    if (/overspend|insufficient|below min/i.test(msg)) {
+      throw new (0, _chunk6XTNI2OQcjs.InsufficientFundsError)(
+        `Algorand swap failed: the account can't cover it (balance, the 0.1 ALGO minimum, or group fees). (${msg.slice(0, 140)})`,
+        { cause: err }
+      );
+    }
+    throw err;
+  }
+}
+
 // src/drivers/algorand/exact.ts
 
 var ZERO_ADDRESS = _algosdk2.default.Address.zeroAddress().toString();
@@ -101,34 +243,34 @@ function isSet(addr) {
 }
 function randomNote() {
   const g = globalThis.crypto;
-  if (!_optionalChain([g, 'optionalAccess', _ => _.getRandomValues])) {
-    throw new (0, _chunkQONQSZHJcjs.UnsupportedSchemeError)("Algorand exact: no Web Crypto CSPRNG available to generate a unique note.");
+  if (!_optionalChain([g, 'optionalAccess', _12 => _12.getRandomValues])) {
+    throw new (0, _chunk6XTNI2OQcjs.UnsupportedSchemeError)("Algorand exact: no Web Crypto CSPRNG available to generate a unique note.");
   }
   return g.getRandomValues(new Uint8Array(32));
 }
 async function payExactAlgorand(input) {
   const { suggestedParams, sk, sender, accept } = input;
   if (accept.asset === "native") {
-    throw new (0, _chunkQONQSZHJcjs.UnsupportedSchemeError)(
+    throw new (0, _chunk6XTNI2OQcjs.UnsupportedSchemeError)(
       "Algorand exact is ASA-only (an asset transfer); native ALGO is not exact-payable. Pay via onchain-proof."
     );
   }
-  const feePayer = _optionalChain([accept, 'access', _2 => _2.extra, 'optionalAccess', _3 => _3.feePayer]);
+  const feePayer = _optionalChain([accept, 'access', _13 => _13.extra, 'optionalAccess', _14 => _14.feePayer]);
   if (!feePayer) {
-    throw new (0, _chunkQONQSZHJcjs.UnsupportedSchemeError)("Algorand exact rail must advertise extra.feePayer (the fee sponsor address).");
+    throw new (0, _chunk6XTNI2OQcjs.UnsupportedSchemeError)("Algorand exact rail must advertise extra.feePayer (the fee sponsor address).");
   }
   const assetId = parseAlgorandAssetId(accept.asset);
   if (assetId === null) {
-    throw new (0, _chunkQONQSZHJcjs.UnsupportedSchemeError)(`Algorand exact rail asset "${accept.asset}" must be a numeric ASA id.`);
+    throw new (0, _chunk6XTNI2OQcjs.UnsupportedSchemeError)(`Algorand exact rail asset "${accept.asset}" must be a numeric ASA id.`);
   }
   if (!_algosdk2.default.isValidAddress(feePayer)) {
-    throw new (0, _chunkQONQSZHJcjs.UnsupportedSchemeError)(`Algorand exact: extra.feePayer "${feePayer}" is not a valid Algorand address.`);
+    throw new (0, _chunk6XTNI2OQcjs.UnsupportedSchemeError)(`Algorand exact: extra.feePayer "${feePayer}" is not a valid Algorand address.`);
   }
   if (!_algosdk2.default.isValidAddress(accept.payTo)) {
-    throw new (0, _chunkQONQSZHJcjs.UnsupportedSchemeError)(`Algorand exact: payTo "${accept.payTo}" is not a valid Algorand address.`);
+    throw new (0, _chunk6XTNI2OQcjs.UnsupportedSchemeError)(`Algorand exact: payTo "${accept.payTo}" is not a valid Algorand address.`);
   }
   if (feePayer === sender) {
-    throw new (0, _chunkQONQSZHJcjs.UnsupportedSchemeError)(
+    throw new (0, _chunk6XTNI2OQcjs.UnsupportedSchemeError)(
       "Algorand exact: the fee payer must differ from the payer \u2014 the buyer must pay ZERO ALGO (the sponsor pays the pooled fee)."
     );
   }
@@ -168,20 +310,20 @@ function decodeElement(bytes) {
   try {
     const st = _algosdk2.default.decodeSignedTransaction(bytes);
     return { txn: st.txn, signed: st.sig != null || st.msig != null || st.lsig != null, raw: bytes };
-  } catch (e2) {
+  } catch (e3) {
     return { txn: _algosdk2.default.decodeUnsignedTransaction(bytes), signed: false, raw: bytes };
   }
 }
 async function verifyAndSettleExactAlgorand(input) {
   const { client, feePayerSk, feePayerAddr, payload, accept } = input;
-  const railFeePayer = _optionalChain([accept, 'access', _4 => _4.extra, 'optionalAccess', _5 => _5.feePayer]);
-  if (!railFeePayer) throw new (0, _chunkQONQSZHJcjs.SettlementError)("Algorand exact: rail is missing extra.feePayer.");
+  const railFeePayer = _optionalChain([accept, 'access', _15 => _15.extra, 'optionalAccess', _16 => _16.feePayer]);
+  if (!railFeePayer) throw new (0, _chunk6XTNI2OQcjs.SettlementError)("Algorand exact: rail is missing extra.feePayer.");
   if (railFeePayer !== feePayerAddr) {
-    throw new (0, _chunkQONQSZHJcjs.SettlementError)("Algorand exact: the gate relayer address does not match the rail extra.feePayer \u2014 misconfigured rail.");
+    throw new (0, _chunk6XTNI2OQcjs.SettlementError)("Algorand exact: the gate relayer address does not match the rail extra.feePayer \u2014 misconfigured rail.");
   }
   const assetId = parseAlgorandAssetId(accept.asset);
-  if (assetId === null) throw new (0, _chunkQONQSZHJcjs.SettlementError)(`Algorand exact: rail asset "${accept.asset}" is not a numeric ASA id.`);
-  if (!_algosdk2.default.isValidAddress(accept.payTo)) throw new (0, _chunkQONQSZHJcjs.SettlementError)(`Algorand exact: rail payTo "${accept.payTo}" is invalid.`);
+  if (assetId === null) throw new (0, _chunk6XTNI2OQcjs.SettlementError)(`Algorand exact: rail asset "${accept.asset}" is not a numeric ASA id.`);
+  if (!_algosdk2.default.isValidAddress(accept.payTo)) throw new (0, _chunk6XTNI2OQcjs.SettlementError)(`Algorand exact: rail payTo "${accept.payTo}" is invalid.`);
   const { paymentIndex, paymentGroup } = payload;
   if (paymentGroup.length !== GROUP_SIZE) {
     return fail("signature_invalid", `Algorand exact expects a ${GROUP_SIZE}-transaction group (payment + fee), got ${paymentGroup.length}.`);
@@ -209,7 +351,7 @@ async function verifyAndSettleExactAlgorand(input) {
     return fail("transfer_not_found", `Transfer asset id ${at.assetIndex} \u2260 rail asset ${assetId}.`);
   }
   if (!addrEq(at.receiver, accept.payTo)) {
-    return fail("wrong_recipient", `Transfer pays ${_optionalChain([at, 'access', _6 => _6.receiver, 'optionalAccess', _7 => _7.toString, 'call', _8 => _8()])}, not payTo ${accept.payTo}.`);
+    return fail("wrong_recipient", `Transfer pays ${_optionalChain([at, 'access', _17 => _17.receiver, 'optionalAccess', _18 => _18.toString, 'call', _19 => _19()])}, not payTo ${accept.payTo}.`);
   }
   if (BigInt(at.amount) < BigInt(accept.amount)) {
     return fail("amount_too_low", `Transfer pays ${at.amount} of the ASA, required ${accept.amount}.`);
@@ -224,7 +366,7 @@ async function verifyAndSettleExactAlgorand(input) {
     return fail("signature_invalid", "The fee transaction must be a payment (pay) transaction.");
   }
   if (!addrEq(fee.sender, railFeePayer)) {
-    return fail("signature_invalid", `The fee transaction sender ${_optionalChain([fee, 'access', _9 => _9.sender, 'optionalAccess', _10 => _10.toString, 'call', _11 => _11()])} is not the rail fee payer ${railFeePayer}.`);
+    return fail("signature_invalid", `The fee transaction sender ${_optionalChain([fee, 'access', _20 => _20.sender, 'optionalAccess', _21 => _21.toString, 'call', _22 => _22()])} is not the rail fee payer ${railFeePayer}.`);
   }
   if (BigInt(fee.payment.amount) !== 0n) {
     return fail("signature_invalid", "The fee transaction must move 0 ALGO (it only pools the group fee).");
@@ -247,7 +389,7 @@ async function verifyAndSettleExactAlgorand(input) {
   try {
     feeSigned = fee.signTxn(feePayerSk);
   } catch (err) {
-    throw new (0, _chunkQONQSZHJcjs.SettlementError)(`Algorand exact settle: the gate could not sign the fee transaction (${shorten(err instanceof Error ? err.message : String(err))}).`, { cause: err });
+    throw new (0, _chunk6XTNI2OQcjs.SettlementError)(`Algorand exact settle: the gate could not sign the fee transaction (${shorten(err instanceof Error ? err.message : String(err))}).`, { cause: err });
   }
   const signedGroup = elements.map((el, i) => i === paymentIndex ? payElement.raw : feeSigned);
   try {
@@ -259,7 +401,7 @@ async function verifyAndSettleExactAlgorand(input) {
       if (/overspend|below min|underflow|insufficient|asset|frozen|opt|missing/i.test(m)) return fail("tx_reverted", `Group would fail on-chain: ${shorten(m)}.`);
       return fail("tx_reverted", `Group would fail on-chain: ${shorten(m)}.`);
     }
-  } catch (e3) {
+  } catch (e4) {
   }
   const buyerTxid = pay.txID();
   try {
@@ -269,7 +411,7 @@ async function verifyAndSettleExactAlgorand(input) {
     if (/signature|sig|auth|malformed/i.test(m)) return fail("signature_invalid", `Settle rejected \u2014 bad signature: ${shorten(m)}.`);
     if (/already in ledger|already committed|duplicate/i.test(m)) return fail("tx_already_used", `This payment was already settled: ${shorten(m)}.`);
     if (/\bround\b|expired|lifetime|stale|validity/i.test(m)) return fail("payment_expired", `Settle rejected \u2014 validity window expired: ${shorten(m)}.`);
-    throw new (0, _chunkQONQSZHJcjs.SettlementError)(
+    throw new (0, _chunk6XTNI2OQcjs.SettlementError)(
       `Algorand exact settle: the group failed to submit (${shorten(m)}). The buyer's signed transaction is still valid \u2014 fund/fix the fee payer (${railFeePayer}) and the buyer can re-present it.`,
       { cause: err }
     );
@@ -278,10 +420,10 @@ async function verifyAndSettleExactAlgorand(input) {
   try {
     round = await client.waitForConfirmation(buyerTxid);
   } catch (err) {
-    throw new (0, _chunkQONQSZHJcjs.SettlementError)(`Algorand exact settle: submitted ${buyerTxid} but confirmation read failed (${shorten(err instanceof Error ? err.message : String(err))}). It likely landed \u2014 re-verify before re-presenting; do NOT re-pay.`, { cause: err });
+    throw new (0, _chunk6XTNI2OQcjs.SettlementError)(`Algorand exact settle: submitted ${buyerTxid} but confirmation read failed (${shorten(err instanceof Error ? err.message : String(err))}). It likely landed \u2014 re-verify before re-presenting; do NOT re-pay.`, { cause: err });
   }
   if (round === null) {
-    throw new (0, _chunkQONQSZHJcjs.SettlementError)(`Algorand exact settle: submitted ${buyerTxid} but it did not confirm in time. It likely landed \u2014 re-verify before re-presenting; do NOT re-pay.`);
+    throw new (0, _chunk6XTNI2OQcjs.SettlementError)(`Algorand exact settle: submitted ${buyerTxid} but it did not confirm in time. It likely landed \u2014 re-verify before re-presenting; do NOT re-pay.`);
   }
   return {
     ok: true,
@@ -308,7 +450,7 @@ async function verifyAlgorand(params) {
   let txs;
   try {
     txs = await reader.transactionsForAccount(accept.payTo, 200);
-  } catch (e4) {
+  } catch (e5) {
     return rpcFailed(nonce);
   }
   const tx = txs.find((t) => typeof t.note === "string" && t.note === nonce);
@@ -337,7 +479,7 @@ async function verifyAlgorand(params) {
   let paid = 0n;
   try {
     paid = tx.amount ? BigInt(tx.amount) : 0n;
-  } catch (e5) {
+  } catch (e6) {
     paid = 0n;
   }
   if (paid < required) {
@@ -377,13 +519,13 @@ function rpcFailed(nonce) {
 
 function assertAlgorandWallet(wallet, network) {
   if (typeof wallet !== "object" || wallet === null) {
-    throw new (0, _chunkQONQSZHJcjs.WrongFamilyError)(
+    throw new (0, _chunk6XTNI2OQcjs.WrongFamilyError)(
       `chain ${network} is Algorand; wallet must be { key } (25-word mnemonic) or { account }.`
     );
   }
-  _chunkQONQSZHJcjs.assertNoLegacyWalletKey.call(void 0, wallet, "Algorand");
+  _chunk6XTNI2OQcjs.assertNoLegacyWalletKey.call(void 0, wallet, "Algorand");
   if (!("key" in wallet) && !("account" in wallet)) {
-    throw new (0, _chunkQONQSZHJcjs.WrongFamilyError)(
+    throw new (0, _chunk6XTNI2OQcjs.WrongFamilyError)(
       `chain ${network} is Algorand; wallet must be { key } (25-word mnemonic) or { account }.`
     );
   }
@@ -398,16 +540,18 @@ function resolveAlgorandWallet(config) {
       const { addr, sk } = _algosdk2.default.mnemonicToSecretKey(config.key);
       return { addr: addr.toString(), sk };
     } catch (cause) {
-      throw new (0, _chunkQONQSZHJcjs.WrongFamilyError)(
+      throw new (0, _chunk6XTNI2OQcjs.WrongFamilyError)(
         "Algorand wallet { key } is not a valid 25-word Algorand mnemonic.",
         { cause }
       );
     }
   }
-  throw new (0, _chunkQONQSZHJcjs.WrongFamilyError)("Algorand wallet needs { key } (25-word mnemonic) or { account }.");
+  throw new (0, _chunk6XTNI2OQcjs.WrongFamilyError)("Algorand wallet needs { key } (25-word mnemonic) or { account }.");
 }
 
 // src/drivers/algorand/index.ts
+var ALGO_MIN_BALANCE = 100000n;
+var ALGO_MIN_BALANCE_PER_ASSET = 100000n;
 var algorandDriver = {
   family: "algorand",
   resolve(opts) {
@@ -450,12 +594,12 @@ function makeAlgorandNetwork(preset, algodUrl) {
   const settleClient = {
     async simulate(signedGroup) {
       const resp = await algod.simulateRawTransactions(signedGroup).do();
-      const fm = _optionalChain([resp, 'optionalAccess', _12 => _12.txnGroups, 'optionalAccess', _13 => _13[0], 'optionalAccess', _14 => _14.failureMessage]);
+      const fm = _optionalChain([resp, 'optionalAccess', _23 => _23.txnGroups, 'optionalAccess', _24 => _24[0], 'optionalAccess', _25 => _25.failureMessage]);
       return { failureMessage: fm && fm.length > 0 ? fm : null };
     },
     async submit(signedGroup) {
       const res = await algod.sendRawTransaction(signedGroup).do();
-      return _nullishCoalesce(_optionalChain([res, 'optionalAccess', _15 => _15.txid]), () => ( ""));
+      return _nullishCoalesce(_optionalChain([res, 'optionalAccess', _26 => _26.txid]), () => ( ""));
     },
     async waitForConfirmation(txid) {
       const info = await _algosdk2.default.waitForConfirmation(algod, txid, 10);
@@ -472,7 +616,7 @@ function makeAlgorandNetwork(preset, algodUrl) {
     // spec id to the driver still matches. Mirrors TON's legacy-id tolerance; the
     // normalizeNetwork alias remains the canonical seam. We still EMIT the padded form —
     // changing that would break every deployed PipRail 2.x buyer, so it waits for a major.
-    supports: (n) => n === network || n === _chunkV2IJ5HUWcjs.ALGORAND_SPEC_CAIP2,
+    supports: (n) => n === network || n === _chunkMZAJQYM3cjs.ALGORAND_SPEC_CAIP2,
     resolveToken(token) {
       if (token === "native") {
         return { asset: "native", decimals: ALGO_DECIMALS, symbol: ALGO_SYMBOL };
@@ -481,16 +625,16 @@ function makeAlgorandNetwork(preset, algodUrl) {
         const info = preset.tokens[token.toUpperCase()];
         if (!info) {
           const known = Object.keys(preset.tokens).join(", ") || "(none built in)";
-          throw new (0, _chunkQONQSZHJcjs.UnknownTokenError)(
+          throw new (0, _chunk6XTNI2OQcjs.UnknownTokenError)(
             `token "${token}" isn't built in for Algorand (known: ${known}). Pass { assetId, decimals } for a custom ASA, or use 'native'.`
           );
         }
         return { asset: algorandAssetId(info.assetId), decimals: info.decimals, symbol: info.symbol };
       }
-      _chunkQONQSZHJcjs.rejectForeignToken.call(void 0, token, "algorand", network);
+      _chunk6XTNI2OQcjs.rejectForeignToken.call(void 0, token, "algorand", network);
       const t = token;
       if (typeof t.assetId !== "number" || typeof t.decimals !== "number") {
-        throw new (0, _chunkQONQSZHJcjs.WrongFamilyError)(
+        throw new (0, _chunk6XTNI2OQcjs.WrongFamilyError)(
           `chain ${network} is Algorand; a custom token must be { assetId, decimals }.`
         );
       }
@@ -511,12 +655,12 @@ function makeAlgorandNetwork(preset, algodUrl) {
     },
     assertValidPayTo(payTo) {
       if (payTo.startsWith("0x")) {
-        throw new (0, _chunkQONQSZHJcjs.WrongFamilyError)(
+        throw new (0, _chunk6XTNI2OQcjs.WrongFamilyError)(
           `chain ${network} is Algorand, but payTo "${payTo}" looks like an EVM address.`
         );
       }
       if (!_algosdk2.default.isValidAddress(payTo)) {
-        throw new (0, _chunkQONQSZHJcjs.WrongFamilyError)(
+        throw new (0, _chunk6XTNI2OQcjs.WrongFamilyError)(
           `chain ${network} is Algorand, but payTo "${payTo}" is not a valid Algorand address.`
         );
       }
@@ -533,14 +677,14 @@ function makeAlgorandNetwork(preset, algodUrl) {
         const info = await _algosdk2.default.waitForConfirmation(algod, ref, 10);
         return { height: String(_nullishCoalesce(info.confirmedRound, () => ( 0))) };
       } catch (err) {
-        throw new (0, _chunkQONQSZHJcjs.ConfirmationTimeoutError)(`Algorand tx ${ref} did not confirm in time.`, {
+        throw new (0, _chunk6XTNI2OQcjs.ConfirmationTimeoutError)(`Algorand tx ${ref} did not confirm in time.`, {
           cause: err
         });
       }
     },
     async estimateCost(accept) {
       if (accept.scheme === "exact") {
-        return _chunkQONQSZHJcjs.nativeCost.call(void 0, {
+        return _chunk6XTNI2OQcjs.nativeCost.call(void 0, {
           symbol: ALGO_SYMBOL,
           decimals: ALGO_DECIMALS,
           fee: 0n,
@@ -548,7 +692,7 @@ function makeAlgorandNetwork(preset, algodUrl) {
           detail: "gasless \u2014 the fee payer (facilitator/relayer) pools the group fee; the buyer pays 0 ALGO"
         });
       }
-      return _chunkQONQSZHJcjs.nativeCost.call(void 0, {
+      return _chunk6XTNI2OQcjs.nativeCost.call(void 0, {
         symbol: ALGO_SYMBOL,
         decimals: ALGO_DECIMALS,
         fee: 1000n,
@@ -556,21 +700,30 @@ function makeAlgorandNetwork(preset, algodUrl) {
         detail: "min fee 1000 \xB5Algos (1 transaction)"
       });
     },
+    /** The bound wallet's own address — where THIS wallet gets paid. Derived from the key
+     *  material only: no RPC, nothing moved. See {@link ResolvedNetwork.addressOf}. */
+    async addressOf(wallet) {
+      return String(resolveAlgorandWallet(wallet._native).addr);
+    },
     async balanceOf(wallet, asset) {
       let owner;
       try {
         owner = resolveAlgorandWallet(wallet._native).addr;
-      } catch (e6) {
+      } catch (e7) {
         return { token: null, native: null };
       }
       let info;
       try {
         info = await algod.accountInformation(owner).do();
-      } catch (e7) {
+      } catch (e8) {
         return { token: null, native: null };
       }
       const native = info.amount != null ? BigInt(info.amount) : null;
-      if (asset === "native") return { token: native, native };
+      if (asset === "native") {
+        if (native === null) return { token: null, native };
+        const min = info.minBalance != null ? BigInt(info.minBalance) : ALGO_MIN_BALANCE + ALGO_MIN_BALANCE_PER_ASSET * BigInt((_nullishCoalesce(info.assets, () => ( []))).length);
+        return { token: native > min ? native - min : 0n, native };
+      }
       const assetId = parseAlgorandAssetId(asset);
       const holding = (_nullishCoalesce(info.assets, () => ( []))).find((a) => Number(a.assetId) === assetId);
       return { token: holding ? BigInt(holding.amount) : 0n, native };
@@ -584,12 +737,20 @@ function makeAlgorandNetwork(preset, algodUrl) {
         const optedIn = (_nullishCoalesce(info.assets, () => ( []))).some((a) => Number(a.assetId) === assetId);
         return optedIn ? { ready: true } : { ready: false, reason: "NOT_OPTED_IN" };
       } catch (e) {
-        if (/does not exist|no accounts found|404|account not found/i.test(String(_nullishCoalesce(_optionalChain([e, 'optionalAccess', _16 => _16.message]), () => ( e))))) {
+        if (/does not exist|no accounts found|404|account not found/i.test(String(_nullishCoalesce(_optionalChain([e, 'optionalAccess', _27 => _27.message]), () => ( e))))) {
           return { ready: false, reason: "NOT_OPTED_IN" };
         }
         return { ready: "unknown" };
       }
     },
+    /* ---- swap (OPTIONAL, opt-in): via Vestige, keyless + no integrator fee. See ./swap.ts ---- */
+    async quoteSwap({ from, to, wantAmount, slippageBps }) {
+      return quoteAlgorandSwap({ network, from, to, wantAmount, slippageBps });
+    },
+    async swap(wallet, quote) {
+      const signer = resolveAlgorandWallet(wallet._native);
+      return swapAlgorand({ algosdk: _algosdk2.default, algod, signer, quote });
+    },
     async verify(_ref, accept) {
       return verifyAlgorand({ reader, accept });
     },
@@ -635,7 +796,7 @@ function makeAlgorandNetwork(preset, algodUrl) {
       if (!fp && relayer) {
         try {
           fp = resolveAlgorandWallet(relayer._native).addr;
-        } catch (e8) {
+        } catch (e9) {
           return null;
         }
       }
@@ -679,7 +840,7 @@ function adaptTxn(raw) {
 function decodeNote(bytes) {
   try {
     return new TextDecoder().decode(bytes);
-  } catch (e9) {
+  } catch (e10) {
     return void 0;
   }
 }