@piprail/sdk 2.16.2 → 3.0.0

package/dist/{solana-AI2G7V33.cjs → solana-EBV6PUCU.cjs}

@@ -1,5 +1,6 @@
 "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 _chunkMZXVXC3Ccjs = require('./chunk-MZXVXC3C.cjs');
 
 
 
@@ -8,7 +9,11 @@
 
 
 
-var _chunkQONQSZHJcjs = require('./chunk-QONQSZHJ.cjs');
+
+
+
+
+var _chunk6XTNI2OQcjs = require('./chunk-6XTNI2OQ.cjs');
 
 // src/drivers/solana/index.ts
 var _web3js = require('@solana/web3.js');
@@ -102,6 +107,148 @@ async function paySolana(params) {
   return signature;
 }
 
+// src/drivers/solana/swap.ts
+
+var JUPITER_API = "https://lite-api.jup.ag/swap/v1";
+var WSOL_MINT = "So11111111111111111111111111111111111111112";
+function sourceFor(platformFee) {
+  const charged = platformFee != null && !(typeof platformFee === "object" && Object.keys(platformFee).length === 0);
+  return {
+    kind: "provider",
+    name: "Jupiter",
+    note: "Third-party Solana DEX aggregator (lite-api.jup.ag), used keyless. It routes and builds the transaction; your own key signs it and Jupiter never holds your funds. " + (charged ? `\u26A0\uFE0F THIS QUOTE CARRIES A PLATFORM FEE: ${JSON.stringify(platformFee)}. PipRail did not set one.` : "This quote carries no platform fee, and PipRail adds none.")
+  };
+}
+function mintFor(t) {
+  return t.asset === "native" ? WSOL_MINT : t.asset;
+}
+function side(t, amount) {
+  const decimals = t.asset === "native" ? SOL_DECIMALS : t.decimals;
+  return {
+    asset: t.asset,
+    symbol: _nullishCoalesce(t.symbol, () => ( (t.asset === "native" ? "SOL" : t.asset))),
+    decimals,
+    amount: amount.toString(),
+    amountFormatted: _chunk6XTNI2OQcjs.formatUnits.call(void 0, amount, decimals)
+  };
+}
+async function getJson(url, init) {
+  const ctrl = new AbortController();
+  const timer = setTimeout(() => ctrl.abort(), 1e4);
+  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 quoteSolanaSwap(p) {
+  if (p.wantAmount <= 0n) return null;
+  const inputMint = mintFor(p.from);
+  const outputMint = mintFor(p.to);
+  if (inputMint === outputMint) return null;
+  const url = `${JUPITER_API}/quote?inputMint=${inputMint}&outputMint=${outputMint}&amount=${p.wantAmount.toString()}&swapMode=ExactOut&slippageBps=${p.slippageBps}`;
+  const q = await getJson(url);
+  if (!_optionalChain([q, 'optionalAccess', _ => _.otherAmountThreshold]) || !q.inAmount) return null;
+  if (q.swapMode !== "ExactOut") return null;
+  if (q.outAmount !== p.wantAmount.toString()) return null;
+  let spend;
+  let maxSpend;
+  try {
+    spend = BigInt(q.inAmount);
+    const jupCap = BigInt(q.otherAmountThreshold);
+    const ourCap = _chunkMZXVXC3Ccjs.applySlippage.call(void 0, spend, p.slippageBps);
+    maxSpend = jupCap > ourCap ? jupCap : ourCap;
+  } catch (e3) {
+    return null;
+  }
+  if (spend <= 0n) return null;
+  const fromDecimals = p.from.asset === "native" ? SOL_DECIMALS : p.from.decimals;
+  return {
+    source: sourceFor(q.platformFee),
+    network: p.network,
+    from: side(p.from, spend),
+    to: side(p.to, p.wantAmount),
+    maxSpend: maxSpend.toString(),
+    maxSpendFormatted: _chunk6XTNI2OQcjs.formatUnits.call(void 0, maxSpend, fromDecimals),
+    slippageBps: p.slippageBps,
+    // Jupiter needs its own quote object back verbatim to build the transaction.
+    route: q
+  };
+}
+async function swapSolana(p) {
+  const { connection, keypair, quote } = p;
+  const jupQuote = quote.route;
+  if (!_optionalChain([jupQuote, 'optionalAccess', _2 => _2.otherAmountThreshold])) {
+    throw new Error("Solana: swap quote is missing its Jupiter routing data \u2014 re-quote before swapping.");
+  }
+  const built = await getJson(`${JUPITER_API}/swap`, {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({
+      quoteResponse: jupQuote,
+      userPublicKey: keypair.publicKey.toBase58(),
+      // Let Jupiter create + close the wrapped-SOL account in the same transaction,
+      // so a SOL leg needs no separate setup step from the caller.
+      wrapAndUnwrapSol: true,
+      dynamicComputeUnitLimit: true
+    })
+  });
+  if (!_optionalChain([built, 'optionalAccess', _3 => _3.swapTransaction])) {
+    throw new (0, _chunk6XTNI2OQcjs.InsufficientFundsError)(
+      "Jupiter could not build this swap transaction (no route, or the market moved). Nothing was spent \u2014 re-quote and retry."
+    );
+  }
+  let tx;
+  try {
+    tx = _web3js.VersionedTransaction.deserialize(Buffer.from(built.swapTransaction, "base64"));
+  } catch (cause) {
+    throw new Error("Solana: Jupiter returned a transaction this SDK could not decode.", { cause });
+  }
+  tx.sign([keypair]);
+  try {
+    const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash();
+    const sig = await connection.sendRawTransaction(tx.serialize(), {
+      skipPreflight: false,
+      maxRetries: 3
+    });
+    const conf = await connection.confirmTransaction(
+      { signature: sig, blockhash, lastValidBlockHeight },
+      "confirmed"
+    );
+    if (_optionalChain([conf, 'optionalAccess', _4 => _4.value, 'optionalAccess', _5 => _5.err])) {
+      throw new (0, _chunk6XTNI2OQcjs.InsufficientFundsError)(
+        `Solana swap failed on-chain (tx ${sig}): ${JSON.stringify(conf.value.err)}. Nothing was swapped. The usual cause is slippage \u2014 re-quote and retry.`
+      );
+    }
+    return {
+      transaction: sig,
+      network: quote.network,
+      source: quote.source,
+      from: quote.from,
+      to: quote.to
+    };
+  } catch (err) {
+    const msg = String(_nullishCoalesce(_optionalChain([err, 'optionalAccess', _6 => _6.message]), () => ( err)));
+    if (/insufficient|0x1\b/i.test(msg)) {
+      throw new (0, _chunk6XTNI2OQcjs.InsufficientFundsError)(
+        `Solana swap failed: the wallet can't cover it (token balance, or SOL for fees and rent). (${msg.slice(0, 160)})`,
+        { cause: err }
+      );
+    }
+    if (/slippage|0x1771/i.test(msg)) {
+      throw new (0, _chunk6XTNI2OQcjs.InsufficientFundsError)(
+        "Solana swap refused: the price moved past your slippage cap, so nothing was spent. Re-quote and retry, or raise slippageBps.",
+        { cause: err }
+      );
+    }
+    throw err;
+  }
+}
+
 // src/drivers/solana/verify.ts
 async function verifySolana(params) {
   const { connection, signature, accept } = params;
@@ -112,7 +259,7 @@ async function verifySolana(params) {
       commitment: "confirmed",
       maxSupportedTransactionVersion: 0
     });
-  } catch (e2) {
+  } catch (e4) {
     return notFound(signature);
   }
   if (!tx) return notFound(signature);
@@ -171,7 +318,7 @@ async function verifySolana(params) {
     for (const p of post) {
       if (p.mint !== mint || p.owner !== accept.payTo) continue;
       const before = pre.find((x) => x.accountIndex === p.accountIndex);
-      delta += BigInt(p.uiTokenAmount.amount) - BigInt(_nullishCoalesce(_optionalChain([before, 'optionalAccess', _ => _.uiTokenAmount, 'access', _2 => _2.amount]), () => ( "0")));
+      delta += BigInt(p.uiTokenAmount.amount) - BigInt(_nullishCoalesce(_optionalChain([before, 'optionalAccess', _7 => _7.uiTokenAmount, 'access', _8 => _8.amount]), () => ( "0")));
     }
     if (delta < required) {
       return {
@@ -229,15 +376,15 @@ var MAX_COMPUTE_UNIT_PRICE_MICROLAMPORTS = 100000n;
 var CB_SET_UNIT_LIMIT = 2;
 var CB_SET_UNIT_PRICE = 3;
 function tokenProgramFor(accept) {
-  return _optionalChain([accept, 'access', _3 => _3.extra, 'optionalAccess', _4 => _4.tokenProgram]) === "token-2022" ? _spltoken.TOKEN_2022_PROGRAM_ID : _spltoken.TOKEN_PROGRAM_ID;
+  return _optionalChain([accept, 'access', _9 => _9.extra, 'optionalAccess', _10 => _10.tokenProgram]) === "token-2022" ? _spltoken.TOKEN_2022_PROGRAM_ID : _spltoken.TOKEN_PROGRAM_ID;
 }
 async function readMintDecimals(connection, mint) {
   try {
     const info = await connection.getAccountInfo(mint);
-    const data = _optionalChain([info, 'optionalAccess', _5 => _5.data]);
+    const data = _optionalChain([info, 'optionalAccess', _11 => _11.data]);
     if (!data || data.length < 45) return void 0;
     return data[44];
-  } catch (e3) {
+  } catch (e5) {
     return void 0;
   }
 }
@@ -246,8 +393,8 @@ function isEmptySig(sig) {
 }
 function memoRandomNonce() {
   const g = globalThis.crypto;
-  if (!_optionalChain([g, 'optionalAccess', _6 => _6.getRandomValues])) {
-    throw new (0, _chunkQONQSZHJcjs.UnsupportedSchemeError)(
+  if (!_optionalChain([g, 'optionalAccess', _12 => _12.getRandomValues])) {
+    throw new (0, _chunk6XTNI2OQcjs.UnsupportedSchemeError)(
       "this runtime lacks Web Crypto (globalThis.crypto.getRandomValues); SVM exact needs a CSPRNG nonce."
     );
   }
@@ -256,10 +403,10 @@ function memoRandomNonce() {
   return Buffer.from([...raw].map((b) => b.toString(16).padStart(2, "0")).join(""), "utf8");
 }
 function memoDataFor(accept) {
-  if (_optionalChain([accept, 'access', _7 => _7.extra, 'optionalAccess', _8 => _8.memo]) !== void 0) {
+  if (_optionalChain([accept, 'access', _13 => _13.extra, 'optionalAccess', _14 => _14.memo]) !== void 0) {
     const bytes = Buffer.from(accept.extra.memo, "utf8");
     if (bytes.length > MAX_MEMO_BYTES) {
-      throw new (0, _chunkQONQSZHJcjs.UnsupportedSchemeError)(
+      throw new (0, _chunk6XTNI2OQcjs.UnsupportedSchemeError)(
         `SVM exact: extra.memo is ${bytes.length} bytes; the scheme caps it at ${MAX_MEMO_BYTES}.`
       );
     }
@@ -273,13 +420,13 @@ function memoInstruction(accept) {
 async function payExactSolana(input) {
   const { connection, keypair, accept } = input;
   if (accept.asset === "native") {
-    throw new (0, _chunkQONQSZHJcjs.UnsupportedSchemeError)(
+    throw new (0, _chunk6XTNI2OQcjs.UnsupportedSchemeError)(
       "SVM exact is SPL-token only (TransferChecked); native SOL is not exact-payable. Pay via onchain-proof."
     );
   }
   const extra = _nullishCoalesce(accept.extra, () => ( {}));
   if (!extra.feePayer) {
-    throw new (0, _chunkQONQSZHJcjs.UnsupportedSchemeError)("SVM exact rail must advertise extra.feePayer (the merchant sponsor key).");
+    throw new (0, _chunk6XTNI2OQcjs.UnsupportedSchemeError)("SVM exact rail must advertise extra.feePayer (the merchant sponsor key).");
   }
   let feePayer;
   let mint;
@@ -289,24 +436,24 @@ async function payExactSolana(input) {
     mint = new (0, _web3js.PublicKey)(accept.asset);
     payTo = new (0, _web3js.PublicKey)(accept.payTo);
   } catch (err) {
-    throw new (0, _chunkQONQSZHJcjs.UnsupportedSchemeError)(
+    throw new (0, _chunk6XTNI2OQcjs.UnsupportedSchemeError)(
       `SVM exact: bad feePayer/asset/payTo (${err instanceof Error ? err.message : String(err)}).`
     );
   }
   const onChainDecimals = await readMintDecimals(connection, mint);
   const decimals = _nullishCoalesce(onChainDecimals, () => ( extra.decimals));
   if (decimals === void 0) {
-    throw new (0, _chunkQONQSZHJcjs.UnsupportedSchemeError)(
+    throw new (0, _chunk6XTNI2OQcjs.UnsupportedSchemeError)(
       `SVM exact: couldn't read the decimals of mint ${accept.asset} on-chain, and the rail states none. Retry with a reliable rpcUrl \u2014 TransferChecked cannot be built without them.`
     );
   }
   if (onChainDecimals !== void 0 && extra.decimals !== void 0 && extra.decimals !== onChainDecimals) {
-    throw new (0, _chunkQONQSZHJcjs.UnsupportedSchemeError)(
+    throw new (0, _chunk6XTNI2OQcjs.UnsupportedSchemeError)(
       `SVM exact: the rail states ${extra.decimals} decimals for ${accept.asset} but the mint says ${onChainDecimals} \u2014 refusing to sign (a mismatch this size misprices the transfer).`
     );
   }
   if (feePayer.equals(payTo)) {
-    throw new (0, _chunkQONQSZHJcjs.UnsupportedSchemeError)(
+    throw new (0, _chunk6XTNI2OQcjs.UnsupportedSchemeError)(
       "SVM exact: the fee payer must differ from payTo \u2014 payTo appears in the transfer instruction, which the fee payer must not (a scheme MUST-rule). Use a separate relayer key for the gate."
     );
   }
@@ -316,11 +463,11 @@ async function payExactSolana(input) {
   let destInfo = "unknown";
   try {
     destInfo = await input.connection.getAccountInfo(dest);
-  } catch (e4) {
+  } catch (e6) {
     destInfo = "unknown";
   }
   if (destInfo === null) {
-    throw new (0, _chunkQONQSZHJcjs.UnsupportedSchemeError)(
+    throw new (0, _chunk6XTNI2OQcjs.UnsupportedSchemeError)(
       `SVM exact: the recipient's token account for ${mint.toBase58()} doesn't exist yet \u2014 the exact rail can't create it. Pay via onchain-proof (which creates it), or have ${payTo.toBase58()} create its associated token account first.`
     );
   }
@@ -352,11 +499,11 @@ async function payExactSolana(input) {
   tx.sign([keypair]);
   const buyerIndex = message.staticAccountKeys.findIndex((k) => k.equals(keypair.publicKey));
   if (buyerIndex < 1 || buyerIndex >= message.header.numRequiredSignatures) {
-    throw new (0, _chunkQONQSZHJcjs.UnsupportedSchemeError)("SVM exact: could not locate the buyer signer slot.");
+    throw new (0, _chunk6XTNI2OQcjs.UnsupportedSchemeError)("SVM exact: could not locate the buyer signer slot.");
   }
   const buyerSig = tx.signatures[buyerIndex];
   if (!buyerSig || isEmptySig(buyerSig)) {
-    throw new (0, _chunkQONQSZHJcjs.UnsupportedSchemeError)("SVM exact: the wallet did not produce a buyer signature.");
+    throw new (0, _chunk6XTNI2OQcjs.UnsupportedSchemeError)("SVM exact: the wallet did not produce a buyer signature.");
   }
   const transaction = Buffer.from(tx.serialize()).toString("base64");
   return {
@@ -380,18 +527,18 @@ async function verifyAndSettleExactSolana(input) {
   try {
     payTo = new (0, _web3js.PublicKey)(accept.payTo);
     mint = new (0, _web3js.PublicKey)(accept.asset);
-    if (!_optionalChain([accept, 'access', _9 => _9.extra, 'optionalAccess', _10 => _10.feePayer])) throw new Error("rail is missing extra.feePayer");
+    if (!_optionalChain([accept, 'access', _15 => _15.extra, 'optionalAccess', _16 => _16.feePayer])) throw new Error("rail is missing extra.feePayer");
     railFeePayer = new (0, _web3js.PublicKey)(accept.extra.feePayer);
   } catch (err) {
-    throw new (0, _chunkQONQSZHJcjs.SettlementError)(`SVM exact: rail has a bad payTo/asset/feePayer (${err instanceof Error ? err.message : String(err)}).`);
+    throw new (0, _chunk6XTNI2OQcjs.SettlementError)(`SVM exact: rail has a bad payTo/asset/feePayer (${err instanceof Error ? err.message : String(err)}).`);
   }
   if (!railFeePayer.equals(feePayerKeypair.publicKey)) {
-    throw new (0, _chunkQONQSZHJcjs.SettlementError)(
+    throw new (0, _chunk6XTNI2OQcjs.SettlementError)(
       "SVM exact: the gate relayer key does not match the rail extra.feePayer \u2014 misconfigured rail."
     );
   }
   if (feePayerKeypair.publicKey.equals(payTo)) {
-    throw new (0, _chunkQONQSZHJcjs.SettlementError)("SVM exact: the fee payer must differ from payTo \u2014 misconfigured rail.");
+    throw new (0, _chunk6XTNI2OQcjs.SettlementError)("SVM exact: the fee payer must differ from payTo \u2014 misconfigured rail.");
   }
   const program = tokenProgramFor(accept);
   let tx;
@@ -410,7 +557,7 @@ async function verifyAndSettleExactSolana(input) {
     try {
       ;
       ({ value } = await connection.getAddressLookupTable(lookup.accountKey));
-    } catch (e5) {
+    } catch (e7) {
       return fail("tx_not_found", `Could not read lookup table ${lookup.accountKey.toBase58()} (transient RPC) \u2014 retry.`);
     }
     if (!value) {
@@ -432,7 +579,7 @@ async function verifyAndSettleExactSolana(input) {
       return fail("signature_invalid", "The fee payer is invoked as a program.");
     }
     for (const i of ix.accountKeyIndexes) {
-      if (_optionalChain([keys, 'access', _11 => _11.get, 'call', _12 => _12(i), 'optionalAccess', _13 => _13.equals, 'call', _14 => _14(feePayerKey)])) {
+      if (_optionalChain([keys, 'access', _17 => _17.get, 'call', _18 => _18(i), 'optionalAccess', _19 => _19.equals, 'call', _20 => _20(feePayerKey)])) {
         return fail("signature_invalid", "The fee payer appears in an instruction account list (would risk a fund drain).");
       }
     }
@@ -481,14 +628,14 @@ async function verifyAndSettleExactSolana(input) {
         }),
         program
       );
-    } catch (e6) {
+    } catch (e8) {
       continue;
     }
     if (!decoded.keys.mint.pubkey.equals(mint)) continue;
     if (!decoded.keys.destination.pubkey.equals(expectedDest)) {
       return fail("wrong_recipient", `A transfer pays ${decoded.keys.destination.pubkey.toBase58()}, not payTo's ATA ${expectedDest.toBase58()}.`);
     }
-    if (_optionalChain([accept, 'access', _15 => _15.extra, 'optionalAccess', _16 => _16.decimals]) !== void 0 && decoded.data.decimals !== accept.extra.decimals) {
+    if (_optionalChain([accept, 'access', _21 => _21.extra, 'optionalAccess', _22 => _22.decimals]) !== void 0 && decoded.data.decimals !== accept.extra.decimals) {
       return fail("transfer_not_found", `Transfer decimals ${decoded.data.decimals} \u2260 rail decimals ${accept.extra.decimals}.`);
     }
     sawTransferToPayTo = true;
@@ -533,7 +680,7 @@ async function verifyAndSettleExactSolana(input) {
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     if (/blockhash|block height|expired/i.test(msg)) return fail("payment_expired", `Settle broadcast rejected \u2014 blockhash expired: ${shorten(msg)}.`);
-    throw new (0, _chunkQONQSZHJcjs.SettlementError)(
+    throw new (0, _chunk6XTNI2OQcjs.SettlementError)(
       `SVM exact settle: the merchant fee payer failed to broadcast (${shorten(msg)}). The buyer's signed transaction is still valid \u2014 fund/fix the fee payer and the buyer can re-present it.`,
       { cause: err }
     );
@@ -543,7 +690,7 @@ async function verifyAndSettleExactSolana(input) {
     return fail("tx_reverted", `Settle tx ${txid} reverted on-chain (a post-simulate race).`);
   }
   if (confirmed === "timeout") {
-    throw new (0, _chunkQONQSZHJcjs.SettlementError)(
+    throw new (0, _chunk6XTNI2OQcjs.SettlementError)(
       `SVM exact settle: broadcast ${txid} but it did not confirm in time. It likely landed \u2014 re-verify by signature before re-presenting; do NOT re-pay.`
     );
   }
@@ -569,7 +716,7 @@ async function pollConfirmed(connection, signature) {
     try {
       const { value } = await connection.getSignatureStatuses([signature], { searchTransactionHistory: true });
       info = value[0];
-    } catch (e7) {
+    } catch (e9) {
       info = null;
     }
     if (info) {
@@ -586,18 +733,18 @@ async function pollConfirmed(connection, signature) {
 
 function toKeypair(wallet, network) {
   if (typeof wallet !== "object" || wallet === null) {
-    throw new (0, _chunkQONQSZHJcjs.WrongFamilyError)(
+    throw new (0, _chunk6XTNI2OQcjs.WrongFamilyError)(
       `chain ${network} is Solana; wallet must be { key } (base58 secret) or { signer }.`
     );
   }
-  _chunkQONQSZHJcjs.assertNoLegacyWalletKey.call(void 0, wallet, "Solana");
+  _chunk6XTNI2OQcjs.assertNoLegacyWalletKey.call(void 0, wallet, "Solana");
   if ("signer" in wallet) {
     return wallet.signer;
   }
   if ("key" in wallet) {
     const sk = wallet.key;
     if (typeof sk === "string" && sk.startsWith("0x")) {
-      throw new (0, _chunkQONQSZHJcjs.WrongFamilyError)(
+      throw new (0, _chunk6XTNI2OQcjs.WrongFamilyError)(
         `chain ${network} is Solana, but the wallet { key } is a 0x\u2026 hex key \u2014 that's an EVM key. A Solana key is a base58 secret string (or a 64-byte Uint8Array).`
       );
     }
@@ -605,12 +752,12 @@ function toKeypair(wallet, network) {
       const bytes = typeof sk === "string" ? _bs582.default.decode(sk) : sk;
       return _web3js.Keypair.fromSecretKey(bytes);
     } catch (err) {
-      throw new (0, _chunkQONQSZHJcjs.WrongFamilyError)(
+      throw new (0, _chunk6XTNI2OQcjs.WrongFamilyError)(
         `chain ${network} is Solana; the wallet { key } isn't a valid Solana secret (expected a base58 secret string or a 64-byte Uint8Array): ${err instanceof Error ? err.message : String(err)}.`
       );
     }
   }
-  throw new (0, _chunkQONQSZHJcjs.WrongFamilyError)(
+  throw new (0, _chunk6XTNI2OQcjs.WrongFamilyError)(
     `chain ${network} is Solana; wallet must be { key } (base58 secret) or { signer }.`
   );
 }
@@ -639,15 +786,15 @@ function makeSolanaNetwork(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 Solana (known: ${known}). Pass { mint, decimals } instead, or use 'native'.`
           );
         }
         return { asset: info.mint, decimals: info.decimals, symbol: info.symbol };
       }
-      _chunkQONQSZHJcjs.rejectForeignToken.call(void 0, token, "solana", network);
+      _chunk6XTNI2OQcjs.rejectForeignToken.call(void 0, token, "solana", network);
       if (!("mint" in token)) {
-        throw new (0, _chunkQONQSZHJcjs.WrongFamilyError)(
+        throw new (0, _chunk6XTNI2OQcjs.WrongFamilyError)(
           `chain ${network} is Solana; a custom token must be { mint, decimals }.`
         );
       }
@@ -666,14 +813,14 @@ function makeSolanaNetwork(preset, rpcUrl) {
     },
     assertValidPayTo(payTo) {
       if (payTo.startsWith("0x")) {
-        throw new (0, _chunkQONQSZHJcjs.WrongFamilyError)(
+        throw new (0, _chunk6XTNI2OQcjs.WrongFamilyError)(
           `chain ${network} is Solana, but payTo "${payTo}" looks like an EVM address.`
         );
       }
       try {
         new (0, _web3js.PublicKey)(payTo);
-      } catch (e8) {
-        throw new (0, _chunkQONQSZHJcjs.WrongFamilyError)(
+      } catch (e10) {
+        throw new (0, _chunk6XTNI2OQcjs.WrongFamilyError)(
           `chain ${network} is Solana, but payTo "${payTo}" is not a base58 address.`
         );
       }
@@ -685,7 +832,7 @@ function makeSolanaNetwork(preset, rpcUrl) {
       try {
         return await paySolana({ connection, keypair: wallet._native, accept });
       } catch (err) {
-        throw _nullishCoalesce(_chunkQONQSZHJcjs.toInsufficientFundsError.call(void 0, err), () => ( err));
+        throw _nullishCoalesce(_chunk6XTNI2OQcjs.toInsufficientFundsError.call(void 0, err), () => ( err));
       }
     },
     async confirm(ref) {
@@ -696,19 +843,19 @@ function makeSolanaNetwork(preset, rpcUrl) {
         });
         info = value[0];
       } catch (err) {
-        throw new (0, _chunkQONQSZHJcjs.ConfirmationTimeoutError)(
+        throw new (0, _chunk6XTNI2OQcjs.ConfirmationTimeoutError)(
           `Solana payment ${ref} could not be confirmed (RPC read failed).`,
           { cause: err }
         );
       }
       if (!info || info.err || info.confirmationStatus !== "confirmed" && info.confirmationStatus !== "finalized") {
-        throw new (0, _chunkQONQSZHJcjs.ConfirmationTimeoutError)(`Solana payment ${ref} did not confirm in time.`);
+        throw new (0, _chunk6XTNI2OQcjs.ConfirmationTimeoutError)(`Solana payment ${ref} did not confirm in time.`);
       }
       return { height: String(info.slot) };
     },
     async estimateCost(accept) {
       if (accept.scheme === "exact") {
-        return _chunkQONQSZHJcjs.nativeCost.call(void 0, {
+        return _chunk6XTNI2OQcjs.nativeCost.call(void 0, {
           symbol: "SOL",
           decimals: SOL_DECIMALS,
           fee: 0n,
@@ -718,7 +865,7 @@ function makeSolanaNetwork(preset, rpcUrl) {
       }
       const base = 5000n;
       if (accept.asset === "native") {
-        return _chunkQONQSZHJcjs.nativeCost.call(void 0, {
+        return _chunk6XTNI2OQcjs.nativeCost.call(void 0, {
           symbol: "SOL",
           decimals: SOL_DECIMALS,
           fee: base,
@@ -727,7 +874,7 @@ function makeSolanaNetwork(preset, rpcUrl) {
         });
       }
       const ataRent = 2039280n;
-      return _chunkQONQSZHJcjs.nativeCost.call(void 0, {
+      return _chunk6XTNI2OQcjs.nativeCost.call(void 0, {
         symbol: "SOL",
         decimals: SOL_DECIMALS,
         fee: base + ataRent,
@@ -735,6 +882,11 @@ function makeSolanaNetwork(preset, rpcUrl) {
         detail: "1 signature + recipient token-account rent (~0.00204 SOL, if not already created)"
       });
     },
+    /** 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 wallet._native.publicKey.toBase58();
+    },
     async balanceOf(wallet, asset) {
       const owner = wallet._native.publicKey;
       const native = await connection.getBalance(owner).then((n) => BigInt(n)).catch(() => null);
@@ -743,7 +895,7 @@ function makeSolanaNetwork(preset, rpcUrl) {
       try {
         const mint = new (0, _web3js.PublicKey)(asset);
         const info = await connection.getAccountInfo(mint);
-        const programId = _optionalChain([info, 'optionalAccess', _17 => _17.owner, 'access', _18 => _18.equals, 'call', _19 => _19(_spltoken.TOKEN_2022_PROGRAM_ID)]) ? _spltoken.TOKEN_2022_PROGRAM_ID : _spltoken.TOKEN_PROGRAM_ID;
+        const programId = _optionalChain([info, 'optionalAccess', _23 => _23.owner, 'access', _24 => _24.equals, 'call', _25 => _25(_spltoken.TOKEN_2022_PROGRAM_ID)]) ? _spltoken.TOKEN_2022_PROGRAM_ID : _spltoken.TOKEN_PROGRAM_ID;
         const ata = _spltoken.getAssociatedTokenAddressSync.call(void 0, mint, owner, false, programId);
         token = (await _spltoken.getAccount.call(void 0, connection, ata, "confirmed", programId)).amount;
       } catch (e) {
@@ -764,6 +916,13 @@ function makeSolanaNetwork(preset, rpcUrl) {
     async recipientReady() {
       return { ready: "n/a" };
     },
+    /* ---- swap (OPTIONAL, opt-in): via Jupiter, keyless + no platform fee. See ./swap.ts ---- */
+    async quoteSwap({ from, to, wantAmount, slippageBps }) {
+      return quoteSolanaSwap({ network, from, to, wantAmount, slippageBps });
+    },
+    async swap(wallet, quote) {
+      return swapSolana({ connection, keypair: wallet._native, quote });
+    },
     async verify(ref, accept) {
       return verifySolana({ connection, signature: ref, accept });
     },
@@ -801,14 +960,14 @@ function makeSolanaNetwork(preset, rpcUrl) {
       if (!fp) return null;
       try {
         new (0, _web3js.PublicKey)(fp);
-      } catch (e9) {
+      } catch (e11) {
         return null;
       }
       let tokenProgram = "spl-token";
       try {
         const info = await connection.getAccountInfo(new (0, _web3js.PublicKey)(asset));
-        if (_optionalChain([info, 'optionalAccess', _20 => _20.owner, 'access', _21 => _21.equals, 'call', _22 => _22(_spltoken.TOKEN_2022_PROGRAM_ID)])) tokenProgram = "token-2022";
-      } catch (e10) {
+        if (_optionalChain([info, 'optionalAccess', _26 => _26.owner, 'access', _27 => _27.equals, 'call', _28 => _28(_spltoken.TOKEN_2022_PROGRAM_ID)])) tokenProgram = "token-2022";
+      } catch (e12) {
       }
       return { method: "svm", extra: { feePayer: fp, tokenProgram } };
     }