@piprail/sdk 2.16.2 → 3.1.0

package/dist/{xrpl-SVVS445B.cjs → xrpl-G2FKFXRI.cjs}

@@ -1,7 +1,10 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } 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 _chunkOXEFPLZAcjs = require('./chunk-OXEFPLZA.cjs');
-require('./chunk-V2IJ5HUW.cjs');
+var _chunk6ZRAIQXFcjs = require('./chunk-6ZRAIQXF.cjs');
+require('./chunk-MZAJQYM3.cjs');
+
+
+var _chunkMZXVXC3Ccjs = require('./chunk-MZXVXC3C.cjs');
 
 
 var _chunkCQREG5LEcjs = require('./chunk-CQREG5LE.cjs');
@@ -18,7 +21,8 @@ var _chunkCQREG5LEcjs = require('./chunk-CQREG5LE.cjs');
 
 
 
-var _chunkQONQSZHJcjs = require('./chunk-QONQSZHJ.cjs');
+
+var _chunk6XTNI2OQcjs = require('./chunk-6XTNI2OQ.cjs');
 
 // src/drivers/xrpl/index.ts
 var _xrpl = require('xrpl');
@@ -85,6 +89,13 @@ async function payXrpl(params) {
       client.feeDrops(),
       client.currentLedgerIndex()
     ]);
+    for (const [field, value] of [["Sequence", sequence], ["LastLedgerSequence", ledgerIndex]]) {
+      if (!Number.isSafeInteger(value) || value < 0) {
+        throw new Error(
+          `XRPL: could not read ${field} from the ledger (got ${String(value)}) \u2014 the RPC read failed or was throttled. NOTHING was signed or submitted, so this is safe to retry. A dedicated rpcUrl avoids the public cluster's rate limits.`
+        );
+      }
+    }
     const tx = {
       TransactionType: "Payment",
       Account: wallet.classicAddress,
@@ -103,17 +114,17 @@ async function payXrpl(params) {
     const code = res.engine_result;
     if (code.startsWith("tes")) return _nullishCoalesce(_optionalChain([res, 'access', _ => _.tx_json, 'optionalAccess', _2 => _2.hash]), () => ( signed.hash));
     const recipientMsg = recipientNotReadyMessage(code);
-    if (recipientMsg) throw new (0, _chunkQONQSZHJcjs.RecipientNotReadyError)(recipientMsg, { cause: makeEngineError(res) });
+    if (recipientMsg) throw new (0, _chunk6XTNI2OQcjs.RecipientNotReadyError)(recipientMsg, { cause: makeEngineError(res) });
     if (isAffordabilityCode(code)) {
-      throw new (0, _chunkQONQSZHJcjs.InsufficientFundsError)(
+      throw new (0, _chunk6XTNI2OQcjs.InsufficientFundsError)(
         `XRPL payment rejected: the sender can't cover it \u2014 balance or the 1 XRP base reserve. (XRPL: ${code})`,
         { cause: makeEngineError(res) }
       );
     }
     throw makeEngineError(res);
   } catch (err) {
-    if (err instanceof _chunkQONQSZHJcjs.InsufficientFundsError || err instanceof _chunkQONQSZHJcjs.RecipientNotReadyError) throw err;
-    throw _nullishCoalesce(_chunkQONQSZHJcjs.toInsufficientFundsError.call(void 0, err), () => ( err));
+    if (err instanceof _chunk6XTNI2OQcjs.InsufficientFundsError || err instanceof _chunk6XTNI2OQcjs.RecipientNotReadyError) throw err;
+    throw _nullishCoalesce(_chunk6XTNI2OQcjs.toInsufficientFundsError.call(void 0, err), () => ( err));
   }
 }
 function amountForAccept(accept) {
@@ -150,6 +161,197 @@ function isAffordabilityCode(code) {
   return /^(tecUNFUNDED|tecINSUFF|terINSUF)/.test(code);
 }
 
+// src/drivers/xrpl/swap.ts
+var SOURCE = {
+  kind: "protocol",
+  name: "XRPL DEX + AMM",
+  note: "Rate from the ledger\u2019s own order books and AMM pools, read live via ripple_path_find, with auto-bridging through XRP where cheaper. Order books charge no protocol fee; AMM pools charge a per-pool fee (0%\u20131%) paid to the pool."
+};
+function toAmount(t, base) {
+  if (t.asset === "native") return base.toString();
+  const parts = parseXrplAssetId(t.asset);
+  if (!parts) throw new Error(`XRPL: malformed asset id "${t.asset}".`);
+  return { currency: parts.currencyHex, issuer: parts.issuer, value: _chunk6XTNI2OQcjs.formatUnits.call(void 0, base, t.decimals) };
+}
+function parseCeil(value, decimals) {
+  const [whole = "0", frac = ""] = value.trim().split(".");
+  const kept = frac.slice(0, decimals).padEnd(decimals, "0");
+  const rest = frac.slice(decimals);
+  const base = BigInt(whole + kept);
+  return /[1-9]/.test(rest) ? base + 1n : base;
+}
+function fromAmount(t, a) {
+  if (a == null) return null;
+  try {
+    return typeof a === "string" ? BigInt(a) : parseCeil(a.value, t.decimals);
+  } catch (e2) {
+    return null;
+  }
+}
+function sourceCurrency(t) {
+  if (t.asset === "native") return { currency: "XRP" };
+  const parts = parseXrplAssetId(t.asset);
+  if (!parts) throw new Error(`XRPL: malformed asset id "${t.asset}".`);
+  return { currency: parts.currencyHex, issuer: parts.issuer };
+}
+function side(t, amount) {
+  return {
+    asset: t.asset,
+    symbol: _nullishCoalesce(t.symbol, () => ( (t.asset === "native" ? XRP_SYMBOL : t.asset))),
+    decimals: t.asset === "native" ? XRP_DECIMALS : t.decimals,
+    amount: amount.toString(),
+    amountFormatted: _chunk6XTNI2OQcjs.formatUnits.call(void 0, amount, t.asset === "native" ? XRP_DECIMALS : t.decimals)
+  };
+}
+async function quoteXrplSwap(p) {
+  if (p.from.asset === p.to.asset) return null;
+  if (p.wantAmount <= 0n) return null;
+  let alternatives = [];
+  for (let attempt = 0; attempt < 2; attempt += 1) {
+    try {
+      const res = await p.client.pathFind({
+        source_account: p.owner,
+        destination_account: p.owner,
+        // ← ourselves: this is what makes it a swap
+        destination_amount: toAmount(p.to, p.wantAmount),
+        source_currencies: [sourceCurrency(p.from)]
+      });
+      alternatives = _nullishCoalesce(res.alternatives, () => ( []));
+    } catch (e3) {
+      alternatives = [];
+    }
+    if (alternatives.length) break;
+    if (attempt === 0) await new Promise((r) => setTimeout(r, 600));
+  }
+  if (!alternatives.length) return null;
+  let best = null;
+  let bestSpend = null;
+  for (const alt of alternatives) {
+    const spend = fromAmount(p.from, alt.source_amount);
+    if (spend == null || spend <= 0n) continue;
+    if (bestSpend == null || spend < bestSpend) {
+      bestSpend = spend;
+      best = alt;
+    }
+  }
+  if (!best || bestSpend == null) return null;
+  const maxSpend = _chunkMZXVXC3Ccjs.applySlippage.call(void 0, bestSpend, p.slippageBps);
+  return {
+    source: SOURCE,
+    network: p.network,
+    from: side(p.from, bestSpend),
+    to: side(p.to, p.wantAmount),
+    maxSpend: maxSpend.toString(),
+    maxSpendFormatted: _chunk6XTNI2OQcjs.formatUnits.call(void 0, maxSpend, p.from.asset === "native" ? XRP_DECIMALS : p.from.decimals),
+    slippageBps: p.slippageBps,
+    // `paths_computed` drops straight into the transaction's Paths field.
+    route: { paths: _nullishCoalesce(best.paths_computed, () => ( [])), from: p.from, to: p.to }
+  };
+}
+function sanitizePaths(paths) {
+  if (!Array.isArray(paths)) return [];
+  return paths.map(
+    (path) => (Array.isArray(path) ? path : []).map((raw) => {
+      const step = raw;
+      const clean = {};
+      if (typeof step.account === "string") clean.account = step.account;
+      if (typeof step.currency === "string") clean.currency = step.currency;
+      if (typeof step.issuer === "string") clean.issuer = step.issuer;
+      return clean;
+    }).filter((step) => Object.keys(step).length > 0)
+  ).filter((path) => path.length > 0);
+}
+async function swapXrpl(p) {
+  const { client, wallet, quote } = p;
+  const route = quote.route;
+  if (!_optionalChain([route, 'optionalAccess', _3 => _3.from]) || !_optionalChain([route, 'optionalAccess', _4 => _4.to])) {
+    throw new Error("XRPL: swap quote is missing its routing data \u2014 re-quote before swapping.");
+  }
+  try {
+    const [sequence, feeDrops, ledgerIndex] = await Promise.all([
+      client.accountSequence(wallet.classicAddress),
+      client.feeDrops(),
+      client.currentLedgerIndex()
+    ]);
+    const tx = {
+      TransactionType: "Payment",
+      Account: wallet.classicAddress,
+      Destination: wallet.classicAddress,
+      // ← ourselves: the ledger's own swap idiom
+      Amount: toAmount(route.to, BigInt(quote.to.amount)),
+      // exact output
+      SendMax: toAmount(route.from, BigInt(quote.maxSpend)),
+      // the on-chain slippage cap
+      // Sanitized: raw path steps from ripple_path_find can break xrpl.js encoding.
+      ...sanitizePaths(route.paths).length ? { Paths: sanitizePaths(route.paths) } : {},
+      Sequence: sequence,
+      Fee: feeForSubmit2(feeDrops),
+      LastLedgerSequence: ledgerIndex + 20,
+      // NOT tfPartialPayment: we want the full `Amount` delivered or nothing at all.
+      Flags: 0
+    };
+    let signed;
+    try {
+      signed = wallet.sign(tx);
+    } catch (cause) {
+      const shape = Object.fromEntries(
+        Object.entries(tx).map(([k, v]) => [k, typeof v === "object" ? JSON.stringify(v) : `${typeof v}:${String(v)}`])
+      );
+      throw new Error(
+        `XRPL could not encode the swap transaction: ${String(_nullishCoalesce(_optionalChain([cause, 'optionalAccess', _5 => _5.message]), () => ( cause)))}. Transaction was ${JSON.stringify(shape)}`,
+        { cause }
+      );
+    }
+    const res = await client.submit(signed.tx_blob);
+    const code = res.engine_result;
+    if (code.startsWith("tes")) {
+      return {
+        transaction: _nullishCoalesce(_optionalChain([res, 'access', _6 => _6.tx_json, 'optionalAccess', _7 => _7.hash]), () => ( signed.hash)),
+        network: quote.network,
+        source: quote.source,
+        from: quote.from,
+        to: quote.to
+      };
+    }
+    throw mapEngineResult(code, res);
+  } catch (err) {
+    if (err instanceof _chunk6XTNI2OQcjs.InsufficientFundsError || err instanceof _chunk6XTNI2OQcjs.RecipientNotReadyError) throw err;
+    throw _nullishCoalesce(_chunk6XTNI2OQcjs.toInsufficientFundsError.call(void 0, err), () => ( err));
+  }
+}
+function feeForSubmit2(openLedgerFee) {
+  try {
+    const f = BigInt(openLedgerFee);
+    const padded = f * 2n;
+    return (padded < 10n ? 10n : padded).toString();
+  } catch (e4) {
+    return "12";
+  }
+}
+function mapEngineResult(code, res) {
+  const err = new Error(`XRPL swap rejected: ${code}`);
+  err.cause = res;
+  if (code === "tecPATH_PARTIAL" || code === "tecPATH_DRY") {
+    return new (0, _chunk6XTNI2OQcjs.InsufficientFundsError)(
+      `XRPL swap refused: the price moved past your slippage cap, or the path ran dry, so nothing was spent. Re-quote and retry, or raise slippageBps. (XRPL: ${code})`,
+      { cause: res }
+    );
+  }
+  if (code === "tecNO_LINE" || code === "tecNO_AUTH" || code === "tecNO_ISSUER") {
+    return new (0, _chunk6XTNI2OQcjs.RecipientNotReadyError)(
+      `XRPL swap refused: your account needs a trustline for the currency you're swapping INTO before it can hold it. (XRPL: ${code})`,
+      { cause: res }
+    );
+  }
+  if (code === "tecUNFUNDED_PAYMENT" || code === "terINSUF_FEE_B" || code === "tecINSUFF_FEE") {
+    return new (0, _chunk6XTNI2OQcjs.InsufficientFundsError)(
+      `XRPL swap failed: the account can't cover it \u2014 balance or the 1 XRP base reserve. (XRPL: ${code})`,
+      { cause: res }
+    );
+  }
+  return err;
+}
+
 // src/drivers/xrpl/exact.ts
 var _crypto = require('crypto');
 var SECONDS_PER_LEDGER = 4;
@@ -165,12 +367,12 @@ var MAX_FEE_DROPS = 1e6;
 var TF_FULLY_CANONICAL_SIG = 2147483648;
 var TF_PARTIAL_PAYMENT = 131072;
 function feesAreSponsored(accept) {
-  return _optionalChain([accept, 'access', _3 => _3.extra, 'optionalAccess', _4 => _4.areFeesSponsored]) === true;
+  return _optionalChain([accept, 'access', _8 => _8.extra, 'optionalAccess', _9 => _9.areFeesSponsored]) === true;
 }
 function invoiceIdHash(invoiceId) {
   return _crypto.createHash.call(void 0, "sha256").update(invoiceId, "utf8").digest("hex").toUpperCase();
 }
-function feeForSubmit2(openLedgerFee) {
+function feeForSubmit3(openLedgerFee) {
   const fee = Number(openLedgerFee);
   const chosen = Number.isFinite(fee) && fee > MIN_FEE_DROPS ? Math.ceil(fee) : MIN_FEE_DROPS;
   return String(Math.min(chosen, MAX_FEE_DROPS));
@@ -178,23 +380,23 @@ function feeForSubmit2(openLedgerFee) {
 async function payExactXrpl(input) {
   const { client, wallet, accept } = input;
   if (!isXrpNative(accept.asset)) {
-    throw new (0, _chunkQONQSZHJcjs.UnsupportedSchemeError)(
+    throw new (0, _chunk6XTNI2OQcjs.UnsupportedSchemeError)(
       `XRPL exact currently signs native XRP only \u2014 ${accept.asset} is an issued currency, whose wire amount is a decimal rather than base units and would misprice the spend cap. Pay it via onchain-proof.`
     );
   }
   if (feesAreSponsored(accept)) {
-    throw new (0, _chunkQONQSZHJcjs.UnsupportedSchemeError)(
+    throw new (0, _chunk6XTNI2OQcjs.UnsupportedSchemeError)(
       "XRPL exact rail advertises areFeesSponsored:true, but the XRP Ledger charges the fee to the transaction Account \u2014 the scheme requires false and PipRail cannot honour a sponsor here."
     );
   }
-  const method = _chunkOXEFPLZAcjs.exactTransferMethod.call(void 0, accept, "xrpl");
+  const method = _chunk6ZRAIQXFcjs.exactTransferMethod.call(void 0, accept, "xrpl");
   if (method !== "sequence") {
-    throw new (0, _chunkQONQSZHJcjs.UnsupportedSchemeError)(
+    throw new (0, _chunk6XTNI2OQcjs.UnsupportedSchemeError)(
       `XRPL exact: unsupported assetTransferMethod "${method}". Only "sequence" is signable \u2014 "ticketSequence" needs a Ticket pre-minted on the payer account, which PipRail does not manage.`
     );
   }
   if (!/^[0-9]+$/.test(accept.amount)) {
-    throw new (0, _chunkQONQSZHJcjs.UnsupportedSchemeError)(
+    throw new (0, _chunk6XTNI2OQcjs.UnsupportedSchemeError)(
       `XRPL exact: native amount "${accept.amount}" is not an integer drops string.`
     );
   }
@@ -209,8 +411,8 @@ async function payExactXrpl(input) {
       client.currentLedgerIndex()
     ]);
   } catch (err) {
-    if (/actNotFound/i.test(String(_nullishCoalesce(_optionalChain([err, 'optionalAccess', _5 => _5.message]), () => ( err))))) {
-      throw new (0, _chunkQONQSZHJcjs.InsufficientFundsError)(
+    if (/actNotFound/i.test(String(_nullishCoalesce(_optionalChain([err, 'optionalAccess', _10 => _10.message]), () => ( err))))) {
+      throw new (0, _chunk6XTNI2OQcjs.InsufficientFundsError)(
         `XRPL exact: the payer account ${wallet.classicAddress} does not exist on the ledger. An XRPL account must hold the base reserve (currently 1 XRP) before it can send anything \u2014 fund it first.`,
         { cause: err instanceof Error ? err : new Error(String(err)) }
       );
@@ -224,25 +426,25 @@ async function payExactXrpl(input) {
     Amount: accept.amount,
     // integer drops, verbatim from the trusted accept
     Sequence: sequence,
-    Fee: feeForSubmit2(openLedgerFee),
+    Fee: feeForSubmit3(openLedgerFee),
     LastLedgerSequence: ledgerIndex + ledgerWindowFor(accept.maxTimeoutSeconds),
     // tfFullyCanonicalSig ON, tfPartialPayment OFF — the shape every other XRPL client sends.
     Flags: TF_FULLY_CANONICAL_SIG
   };
-  if (typeof _optionalChain([accept, 'access', _6 => _6.extra, 'optionalAccess', _7 => _7.destinationTag]) === "number") {
+  if (typeof _optionalChain([accept, 'access', _11 => _11.extra, 'optionalAccess', _12 => _12.destinationTag]) === "number") {
     tx.DestinationTag = accept.extra.destinationTag;
   }
-  if (typeof _optionalChain([accept, 'access', _8 => _8.extra, 'optionalAccess', _9 => _9.sourceTag]) === "number") {
+  if (typeof _optionalChain([accept, 'access', _13 => _13.extra, 'optionalAccess', _14 => _14.sourceTag]) === "number") {
     tx.SourceTag = accept.extra.sourceTag;
   }
-  if (typeof _optionalChain([accept, 'access', _10 => _10.extra, 'optionalAccess', _11 => _11.invoiceId]) === "string" && accept.extra.invoiceId.length > 0) {
+  if (typeof _optionalChain([accept, 'access', _15 => _15.extra, 'optionalAccess', _16 => _16.invoiceId]) === "string" && accept.extra.invoiceId.length > 0) {
     tx.InvoiceID = invoiceIdHash(accept.extra.invoiceId);
   }
   let signed;
   try {
     signed = wallet.sign(tx);
   } catch (err) {
-    throw new (0, _chunkQONQSZHJcjs.UnsupportedSchemeError)(
+    throw new (0, _chunk6XTNI2OQcjs.UnsupportedSchemeError)(
       `XRPL exact: could not sign this rail \u2014 ${err instanceof Error ? err.message : String(err)}`,
       { cause: err instanceof Error ? err : new Error(String(err)) }
     );
@@ -262,7 +464,7 @@ async function verifyAndSettleExactXrpl(input) {
   const attempts = _nullishCoalesce(input.pollAttempts, () => ( 8));
   const sleep = _nullishCoalesce(input.sleep, () => ( ((ms) => new Promise((r) => setTimeout(r, ms)))));
   if (feesAreSponsored(accept)) {
-    throw new (0, _chunkQONQSZHJcjs.SettlementError)("XRPL exact: rail advertises areFeesSponsored:true, which this ledger cannot honour.");
+    throw new (0, _chunk6XTNI2OQcjs.SettlementError)("XRPL exact: rail advertises areFeesSponsored:true, which this ledger cannot honour.");
   }
   let tx;
   try {
@@ -295,10 +497,10 @@ async function verifyAndSettleExactXrpl(input) {
   if (tx.Amount !== accept.amount) {
     return fail("amount_too_low", `XRPL exact: Amount ${String(tx.Amount)} \u2260 the rail's ${accept.amount} drops.`);
   }
-  if (typeof _optionalChain([accept, 'access', _12 => _12.extra, 'optionalAccess', _13 => _13.destinationTag]) === "number" && tx.DestinationTag !== accept.extra.destinationTag) {
+  if (typeof _optionalChain([accept, 'access', _17 => _17.extra, 'optionalAccess', _18 => _18.destinationTag]) === "number" && tx.DestinationTag !== accept.extra.destinationTag) {
     return fail("signature_invalid", `XRPL exact: DestinationTag ${String(tx.DestinationTag)} \u2260 the rail's ${accept.extra.destinationTag}.`);
   }
-  if (typeof _optionalChain([accept, 'access', _14 => _14.extra, 'optionalAccess', _15 => _15.invoiceId]) === "string" && accept.extra.invoiceId.length > 0) {
+  if (typeof _optionalChain([accept, 'access', _19 => _19.extra, 'optionalAccess', _20 => _20.invoiceId]) === "string" && accept.extra.invoiceId.length > 0) {
     const want = invoiceIdHash(accept.extra.invoiceId);
     if (String(_nullishCoalesce(tx.InvoiceID, () => ( ""))).toUpperCase() !== want) {
       return fail("signature_invalid", "XRPL exact: InvoiceID does not bind this challenge.");
@@ -317,24 +519,24 @@ async function verifyAndSettleExactXrpl(input) {
         `XRPL exact: submit rejected \u2014 ${res.engine_result}${res.engine_result_message ? ` (${res.engine_result_message})` : ""}.`
       );
     }
-    hash = _nullishCoalesce(_optionalChain([res, 'access', _16 => _16.tx_json, 'optionalAccess', _17 => _17.hash]), () => ( ""));
+    hash = _nullishCoalesce(_optionalChain([res, 'access', _21 => _21.tx_json, 'optionalAccess', _22 => _22.hash]), () => ( ""));
     if (!hash) throw new Error("submit returned no transaction hash");
   } catch (err) {
-    throw new (0, _chunkQONQSZHJcjs.SettlementError)(`XRPL exact: submit failed (${err instanceof Error ? err.message : String(err)}).`);
+    throw new (0, _chunk6XTNI2OQcjs.SettlementError)(`XRPL exact: submit failed (${err instanceof Error ? err.message : String(err)}).`);
   }
   for (let i = 0; i < attempts; i += 1) {
     let record;
     try {
       record = await client.txByHash(hash);
-    } catch (e2) {
+    } catch (e5) {
       record = null;
     }
-    if (_optionalChain([record, 'optionalAccess', _18 => _18.validated])) {
-      const code = _optionalChain([record, 'access', _19 => _19.meta, 'optionalAccess', _20 => _20.TransactionResult]);
+    if (_optionalChain([record, 'optionalAccess', _23 => _23.validated])) {
+      const code = _optionalChain([record, 'access', _24 => _24.meta, 'optionalAccess', _25 => _25.TransactionResult]);
       if (code !== "tesSUCCESS") {
         return fail("transfer_not_found", `XRPL exact: validated with ${String(code)}, not tesSUCCESS.`);
       }
-      const delivered = _optionalChain([record, 'access', _21 => _21.meta, 'optionalAccess', _22 => _22.delivered_amount]);
+      const delivered = _optionalChain([record, 'access', _26 => _26.meta, 'optionalAccess', _27 => _27.delivered_amount]);
       if (delivered !== void 0 && typeof delivered === "string" && delivered !== accept.amount) {
         return fail("amount_too_low", `XRPL exact: delivered ${delivered} drops, expected ${accept.amount}.`);
       }
@@ -355,7 +557,7 @@ async function verifyAndSettleExactXrpl(input) {
     }
     await sleep(1200);
   }
-  throw new (0, _chunkQONQSZHJcjs.SettlementError)(
+  throw new (0, _chunk6XTNI2OQcjs.SettlementError)(
     `XRPL exact: submitted ${hash} but it was not validated within ${attempts} polls. It may still settle; retry the request.`
   );
 }
@@ -371,7 +573,7 @@ async function verifyXrpl(params) {
   let txs;
   try {
     txs = await reader.transactionsForAccount(accept.payTo, 200);
-  } catch (e3) {
+  } catch (e6) {
     return rpcFailed(nonce);
   }
   const tx = txs.find(
@@ -435,7 +637,7 @@ async function verifyXrpl(params) {
 }
 function hasNonceMemo(memos, wantMemo) {
   if (!memos) return false;
-  return memos.some((m) => (_nullishCoalesce(_optionalChain([m, 'access', _23 => _23.Memo, 'optionalAccess', _24 => _24.MemoData]), () => ( ""))).toUpperCase() === wantMemo);
+  return memos.some((m) => (_nullishCoalesce(_optionalChain([m, 'access', _28 => _28.Memo, 'optionalAccess', _29 => _29.MemoData]), () => ( ""))).toUpperCase() === wantMemo);
 }
 function deliveredBaseUnits(delivered, want, decimals) {
   if (delivered === void 0) return null;
@@ -449,8 +651,8 @@ function deliveredBaseUnits(delivered, want, decimals) {
     return null;
   }
   try {
-    return _chunkQONQSZHJcjs.floorUnits.call(void 0, delivered.value, decimals);
-  } catch (e4) {
+    return _chunk6XTNI2OQcjs.floorUnits.call(void 0, delivered.value, decimals);
+  } catch (e7) {
     return null;
   }
 }
@@ -473,13 +675,13 @@ function rpcFailed(nonce) {
 
 function assertXrplWallet(wallet, network) {
   if (typeof wallet !== "object" || wallet === null) {
-    throw new (0, _chunkQONQSZHJcjs.WrongFamilyError)(
+    throw new (0, _chunk6XTNI2OQcjs.WrongFamilyError)(
       `chain ${network} is XRPL; wallet must be { key } (s\u2026 seed) or { wallet }.`
     );
   }
-  _chunkQONQSZHJcjs.assertNoLegacyWalletKey.call(void 0, wallet, "XRPL");
+  _chunk6XTNI2OQcjs.assertNoLegacyWalletKey.call(void 0, wallet, "XRPL");
   if (!("key" in wallet) && !("wallet" in wallet)) {
-    throw new (0, _chunkQONQSZHJcjs.WrongFamilyError)(
+    throw new (0, _chunk6XTNI2OQcjs.WrongFamilyError)(
       `chain ${network} is XRPL; wallet must be { key } (s\u2026 seed) or { wallet }.`
     );
   }
@@ -489,17 +691,19 @@ function resolveXrplWallet(config) {
   if (config.wallet) return config.wallet;
   if (config.key) {
     if (!_xrpl.isValidSecret.call(void 0, config.key)) {
-      throw new (0, _chunkQONQSZHJcjs.WrongFamilyError)("XRPL wallet { key } is not a valid s\u2026 secret seed.");
+      throw new (0, _chunk6XTNI2OQcjs.WrongFamilyError)("XRPL wallet { key } is not a valid s\u2026 secret seed.");
     }
     return _xrpl.Wallet.fromSeed(config.key);
   }
-  throw new (0, _chunkQONQSZHJcjs.WrongFamilyError)("XRPL wallet needs { key } (s\u2026 seed) or { wallet }.");
+  throw new (0, _chunk6XTNI2OQcjs.WrongFamilyError)("XRPL wallet needs { key } (s\u2026 seed) or { wallet }.");
 }
 
 // src/drivers/xrpl/index.ts
 function isXrplActNotFound(e) {
-  return /actNotFound/i.test(String(_nullishCoalesce(_optionalChain([e, 'optionalAccess', _25 => _25.message]), () => ( e))));
+  return /actNotFound/i.test(String(_nullishCoalesce(_optionalChain([e, 'optionalAccess', _30 => _30.message]), () => ( e))));
 }
+var XRPL_BASE_RESERVE_DROPS = 1000000n;
+var XRPL_OWNER_RESERVE_DROPS = 200000n;
 var xrplDriver = {
   family: "xrpl",
   resolve(opts) {
@@ -520,11 +724,14 @@ function makeXrplNetwork(preset, rpcUrl) {
     const json = await res.json();
     const result = json.result;
     if (!result || result.status === "error" || result.error) {
-      throw new Error(`XRPL RPC ${method} error: ${_nullishCoalesce(_optionalChain([result, 'optionalAccess', _26 => _26.error]), () => ( "unknown"))}`);
+      throw new Error(`XRPL RPC ${method} error: ${_nullishCoalesce(_optionalChain([result, 'optionalAccess', _31 => _31.error]), () => ( "unknown"))}`);
     }
     return result;
   }
   const payClient = {
+    async pathFind(params) {
+      return rpc("ripple_path_find", { ...params, ledger_index: "current" });
+    },
     async accountSequence(account) {
       const r = await rpc("account_info", {
         account,
@@ -549,7 +756,7 @@ function makeXrplNetwork(preset, rpcUrl) {
     async txByHash(hash) {
       try {
         return await rpc("tx", { transaction: hash, binary: false });
-      } catch (e5) {
+      } catch (e8) {
         return null;
       }
     }
@@ -578,7 +785,7 @@ function makeXrplNetwork(preset, rpcUrl) {
         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 XRPL (known: ${known}). Pass { issuer, currencyHex, decimals } for a custom IOU, or use 'native'.`
           );
         }
@@ -588,10 +795,10 @@ function makeXrplNetwork(preset, rpcUrl) {
           symbol: info.symbol
         };
       }
-      _chunkQONQSZHJcjs.rejectForeignToken.call(void 0, token, "xrpl", network);
+      _chunk6XTNI2OQcjs.rejectForeignToken.call(void 0, token, "xrpl", network);
       const t = token;
       if (!t.issuer || !t.currencyHex || typeof t.decimals !== "number") {
-        throw new (0, _chunkQONQSZHJcjs.WrongFamilyError)(
+        throw new (0, _chunk6XTNI2OQcjs.WrongFamilyError)(
           `chain ${network} is XRPL; a custom token must be { issuer, currencyHex, decimals }.`
         );
       }
@@ -612,12 +819,12 @@ function makeXrplNetwork(preset, rpcUrl) {
     },
     assertValidPayTo(payTo) {
       if (payTo.startsWith("0x")) {
-        throw new (0, _chunkQONQSZHJcjs.WrongFamilyError)(
+        throw new (0, _chunk6XTNI2OQcjs.WrongFamilyError)(
           `chain ${network} is XRPL, but payTo "${payTo}" looks like an EVM address.`
         );
       }
       if (!_xrpl.isValidClassicAddress.call(void 0, payTo)) {
-        throw new (0, _chunkQONQSZHJcjs.WrongFamilyError)(
+        throw new (0, _chunk6XTNI2OQcjs.WrongFamilyError)(
           `chain ${network} is XRPL, but payTo "${payTo}" is not a valid XRPL account (r\u2026).`
         );
       }
@@ -685,26 +892,26 @@ function makeXrplNetwork(preset, rpcUrl) {
             transaction: ref
           });
           if (tx.validated) return { height: String(_nullishCoalesce(tx.ledger_index, () => ( 0))) };
-        } catch (e6) {
+        } catch (e9) {
         }
         await _chunkCQREG5LEcjs.delay.call(void 0, 1500);
       }
-      throw new (0, _chunkQONQSZHJcjs.ConfirmationTimeoutError)(`XRPL tx ${ref} not validated on-ledger in time.`);
+      throw new (0, _chunk6XTNI2OQcjs.ConfirmationTimeoutError)(`XRPL tx ${ref} not validated on-ledger in time.`);
     },
     async estimateCost() {
       try {
         const drops = await payClient.feeDrops();
         const n = Number(drops);
         const fee = BigInt(Number.isFinite(n) && n > 12 ? Math.ceil(n) : 12);
-        return _chunkQONQSZHJcjs.nativeCost.call(void 0, {
+        return _chunk6XTNI2OQcjs.nativeCost.call(void 0, {
           symbol: XRP_SYMBOL,
           decimals: XRP_DECIMALS,
           fee,
           basis: "estimated",
           detail: `network fee ${fee} drops`
         });
-      } catch (e7) {
-        return _chunkQONQSZHJcjs.nativeCost.call(void 0, {
+      } catch (e10) {
+        return _chunk6XTNI2OQcjs.nativeCost.call(void 0, {
           symbol: XRP_SYMBOL,
           decimals: XRP_DECIMALS,
           fee: 12n,
@@ -713,24 +920,35 @@ function makeXrplNetwork(preset, rpcUrl) {
         });
       }
     },
+    /** 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 resolveXrplWallet(wallet._native).classicAddress;
+    },
     async balanceOf(wallet, asset) {
       let owner;
       try {
         owner = resolveXrplWallet(wallet._native).classicAddress;
-      } catch (e8) {
+      } catch (e11) {
         return { token: null, native: null };
       }
       let native = null;
+      let ownerCount = 0n;
       try {
         const r = await rpc("account_info", {
           account: owner,
           ledger_index: "validated"
         });
         native = BigInt(r.account_data.Balance);
+        ownerCount = BigInt(_nullishCoalesce(r.account_data.OwnerCount, () => ( 0)));
       } catch (e) {
         native = isXrplActNotFound(e) ? 0n : null;
       }
-      if (isXrpNative(asset)) return { token: native, native };
+      if (isXrpNative(asset)) {
+        if (native === null) return { token: null, native };
+        const reserve = XRPL_BASE_RESERVE_DROPS + XRPL_OWNER_RESERVE_DROPS * ownerCount;
+        return { token: native > reserve ? native - reserve : 0n, native };
+      }
       let token = null;
       try {
         const [currencyHex, issuer] = asset.split(":");
@@ -741,7 +959,7 @@ function makeXrplNetwork(preset, rpcUrl) {
         const line = r.lines.find(
           (l) => l.currency.toUpperCase() === (_nullishCoalesce(currencyHex, () => ( ""))).toUpperCase() && l.account === issuer
         );
-        token = line ? _chunkQONQSZHJcjs.floorUnits.call(void 0, line.balance, XRP_DECIMALS) : 0n;
+        token = line ? _chunk6XTNI2OQcjs.floorUnits.call(void 0, line.balance, XRP_DECIMALS) : 0n;
       } catch (e) {
         token = isXrplActNotFound(e) ? 0n : null;
       }
@@ -765,10 +983,24 @@ function makeXrplNetwork(preset, rpcUrl) {
           (l) => l.currency.toUpperCase() === (_nullishCoalesce(currencyHex, () => ( ""))).toUpperCase() && l.account === issuer
         );
         return has ? { ready: true } : { ready: false, reason: "NO_TRUSTLINE" };
-      } catch (e9) {
+      } catch (e12) {
         return { ready: "unknown" };
       }
     },
+    /* ---- swap (OPTIONAL, opt-in): a cross-currency payment to yourself. See ./swap.ts ---- */
+    async quoteSwap({ from, to, wantAmount, slippageBps, wallet }) {
+      let owner;
+      try {
+        owner = resolveXrplWallet(wallet._native).classicAddress;
+      } catch (e13) {
+        return null;
+      }
+      return quoteXrplSwap({ client: payClient, network, owner, from, to, wantAmount, slippageBps });
+    },
+    async swap(wallet, quote) {
+      const w = resolveXrplWallet(wallet._native);
+      return swapXrpl({ client: payClient, wallet: w, quote });
+    },
     async verify(_ref, accept) {
       return verifyXrpl({ reader, accept });
     }