@piprail/sdk 2.6.0 → 2.8.0

package/dist/index.cjs

@@ -24,7 +24,7 @@
 
 
 
-var _chunkJG6KRAW6cjs = require('./chunk-JG6KRAW6.cjs');
+var _chunkVPENSVOIcjs = require('./chunk-VPENSVOI.cjs');
 
 // src/drivers/registry.ts
 var byFamily = /* @__PURE__ */ new Map();
@@ -53,13 +53,13 @@ function resolveNetwork(opts) {
   const family = familyForChain(opts.chain);
   const driver = byFamily.get(family);
   if (!driver) {
-    throw new (0, _chunkJG6KRAW6cjs.UnsupportedNetworkError)(
+    throw new (0, _chunkVPENSVOIcjs.UnsupportedNetworkError)(
       `No driver registered for the "${family}" family \u2014 it may not be mounted yet (use the async resolveNetwork()).`
     );
   }
   const net = driver.resolve(opts);
   if (!net) {
-    throw new (0, _chunkJG6KRAW6cjs.UnsupportedNetworkError)(
+    throw new (0, _chunkVPENSVOIcjs.UnsupportedNetworkError)(
       `The ${family} driver didn't recognise this chain input.`
     );
   }
@@ -320,12 +320,12 @@ function resolveChain(input, rpcUrlOverride) {
 
 var _accounts = require('viem/accounts');
 function createWalletAdapter(config, resolved) {
-  _chunkJG6KRAW6cjs.assertNoLegacyWalletKey.call(void 0, config, "EVM");
+  _chunkVPENSVOIcjs.assertNoLegacyWalletKey.call(void 0, config, "EVM");
   if ("key" in config) {
     const key = config.key;
     if (typeof key !== "string" || !/^0x[0-9a-fA-F]{64}$/.test(key)) {
       const hint = typeof key === "string" && !key.startsWith("0x") ? " (got a non-0x string \u2014 a base58/seed key belongs to another family; pass { key } as the EVM chain's 0x\u2026 hex secret)." : " (expected 0x followed by 64 hex characters).";
-      throw new (0, _chunkJG6KRAW6cjs.WrongFamilyError)(
+      throw new (0, _chunkVPENSVOIcjs.WrongFamilyError)(
         `chain is EVM; the wallet { key } is not a valid 0x\u2026 32-byte hex private key${hint}`
       );
     }
@@ -333,7 +333,7 @@ function createWalletAdapter(config, resolved) {
     try {
       account = _accounts.privateKeyToAccount.call(void 0, key);
     } catch (err) {
-      throw new (0, _chunkJG6KRAW6cjs.WrongFamilyError)(
+      throw new (0, _chunkVPENSVOIcjs.WrongFamilyError)(
         `chain is EVM; the wallet { key } is not a valid 0x\u2026 32-byte hex private key: ${err instanceof Error ? err.message : String(err)}.`
       );
     }
@@ -343,12 +343,12 @@ function createWalletAdapter(config, resolved) {
   }
   const wc = config.walletClient;
   if (!wc.account) {
-    throw new (0, _chunkJG6KRAW6cjs.WrongFamilyError)(
+    throw new (0, _chunkVPENSVOIcjs.WrongFamilyError)(
       "chain is EVM; the provided walletClient has no attached account. Use `createWalletClient({ account, chain, transport })`, or pass { key }."
     );
   }
   if (wc.chain && wc.chain.id !== resolved.chainId) {
-    throw new (0, _chunkJG6KRAW6cjs.WrongChainError)(
+    throw new (0, _chunkVPENSVOIcjs.WrongChainError)(
       `PipRailClient: walletClient is on chain ${wc.chain.id} but the SDK was configured with chain ${resolved.chainId}. They must match.`
     );
   }
@@ -678,7 +678,7 @@ async function payExactEvm(input) {
     code = void 0;
   }
   if (code && code !== "0x") {
-    throw new (0, _chunkJG6KRAW6cjs.UnsupportedSchemeError)(
+    throw new (0, _chunkVPENSVOIcjs.UnsupportedSchemeError)(
       `exact buyer rail requires an EOA signer; ${account.address} is a contract / EIP-1271 / EIP-7702-delegated account (no recoverable ECDSA signature). Pay via onchain-proof.`
     );
   }
@@ -688,13 +688,13 @@ async function payExactEvm(input) {
     domain = await readExactDomain(publicClient, accept.asset);
   }
   if (!domain) {
-    throw new (0, _chunkJG6KRAW6cjs.UnsupportedSchemeError)(
+    throw new (0, _chunkVPENSVOIcjs.UnsupportedSchemeError)(
       `exact: couldn't derive the EIP-712 domain for ${accept.asset} on ${accept.network}. Either it isn't an EIP-3009 token (USDT needs Permit2; native/plain ERC-20 aren't exact-payable) \u2014 pay via onchain-proof \u2014 OR your RPC couldn't read it (transient): if the gate advertised eip3009, pass a reliable rpcUrl and retry.`
     );
   }
   const g = globalThis.crypto;
   if (!_optionalChain([g, 'optionalAccess', _5 => _5.getRandomValues])) {
-    throw new (0, _chunkJG6KRAW6cjs.UnsupportedSchemeError)(
+    throw new (0, _chunkVPENSVOIcjs.UnsupportedSchemeError)(
       "this runtime lacks Web Crypto (globalThis.crypto.getRandomValues); the exact rail needs a CSPRNG nonce."
     );
   }
@@ -951,7 +951,7 @@ async function verifyAndSettleExactEvm(input) {
       args: writeArgs
     });
   } catch (err) {
-    throw new (0, _chunkJG6KRAW6cjs.SettlementError)(
+    throw new (0, _chunkVPENSVOIcjs.SettlementError)(
       `exact settle: the merchant relayer failed to broadcast transferWithAuthorization (${shorten(err instanceof Error ? err.message : String(err))}). The payer's authorization is still valid and unused \u2014 fund/fix the relayer and the payer can retry.`,
       { cause: err }
     );
@@ -963,7 +963,7 @@ async function verifyAndSettleExactEvm(input) {
       return { ok: false, error: "tx_reverted", detail: `Settlement tx ${txHash} reverted on-chain.` };
     }
   } catch (err) {
-    throw new (0, _chunkJG6KRAW6cjs.SettlementError)(
+    throw new (0, _chunkVPENSVOIcjs.SettlementError)(
       `exact settle: broadcast ${txHash} but couldn't confirm it (${shorten(err instanceof Error ? err.message : String(err))}).`,
       { cause: err }
     );
@@ -1094,7 +1094,7 @@ function shorten2(msg) {
 function randomPermit2Nonce() {
   const g = globalThis.crypto;
   if (!_optionalChain([g, 'optionalAccess', _8 => _8.getRandomValues])) {
-    throw new (0, _chunkJG6KRAW6cjs.UnsupportedSchemeError)(
+    throw new (0, _chunkVPENSVOIcjs.UnsupportedSchemeError)(
       "this runtime lacks Web Crypto (globalThis.crypto.getRandomValues); the permit2 rail needs a CSPRNG nonce."
     );
   }
@@ -1113,7 +1113,7 @@ async function ensurePermit2Allowance(input) {
       args: [account.address, PERMIT2_ADDRESS]
     });
   } catch (err) {
-    throw new (0, _chunkJG6KRAW6cjs.UnsupportedSchemeError)(
+    throw new (0, _chunkVPENSVOIcjs.UnsupportedSchemeError)(
       `permit2: couldn't read the Permit2 allowance for ${token} (${shorten2(err instanceof Error ? err.message : String(err))}).`
     );
   }
@@ -1130,7 +1130,7 @@ async function ensurePermit2Allowance(input) {
     await publicClient.waitForTransactionReceipt({ hash, confirmations: 1 });
     return hash;
   } catch (err) {
-    throw _nullishCoalesce(_chunkJG6KRAW6cjs.toInsufficientFundsError.call(void 0, err), () => ( new (0, _chunkJG6KRAW6cjs.SettlementError)(
+    throw _nullishCoalesce(_chunkVPENSVOIcjs.toInsufficientFundsError.call(void 0, err), () => ( new (0, _chunkVPENSVOIcjs.SettlementError)(
       `permit2: the one-time Permit2 approval for ${token} failed to broadcast (${shorten2(err instanceof Error ? err.message : String(err))}).`,
       { cause: err }
     )));
@@ -1145,7 +1145,7 @@ async function payPermit2Evm(input) {
     code = void 0;
   }
   if (code && code !== "0x") {
-    throw new (0, _chunkJG6KRAW6cjs.UnsupportedSchemeError)(
+    throw new (0, _chunkVPENSVOIcjs.UnsupportedSchemeError)(
       `permit2 buyer rail requires an EOA signer; ${account.address} is a contract / EIP-1271 / EIP-7702-delegated account. Pay via onchain-proof.`
     );
   }
@@ -1320,7 +1320,7 @@ async function verifyAndSettlePermit2Evm(input) {
       args: settleArgs
     });
   } catch (err) {
-    throw new (0, _chunkJG6KRAW6cjs.SettlementError)(
+    throw new (0, _chunkVPENSVOIcjs.SettlementError)(
       `permit2 settle: the merchant relayer failed to broadcast the proxy settle (${shorten2(err instanceof Error ? err.message : String(err))}). The payer's signature is still valid and its nonce unused \u2014 fund/fix the relayer and the payer can retry.`,
       { cause: err }
     );
@@ -1332,7 +1332,7 @@ async function verifyAndSettlePermit2Evm(input) {
       return { ok: false, error: "tx_reverted", detail: `Settlement tx ${txHash} reverted on-chain.` };
     }
   } catch (err) {
-    throw new (0, _chunkJG6KRAW6cjs.SettlementError)(
+    throw new (0, _chunkVPENSVOIcjs.SettlementError)(
       `permit2 settle: broadcast ${txHash} but couldn't confirm it (${shorten2(err instanceof Error ? err.message : String(err))}).`,
       { cause: err }
     );
@@ -1584,15 +1584,15 @@ function makeEvmNetwork(resolved) {
         const info = resolved.tokens[token.toUpperCase()];
         if (!info) {
           const known = Object.keys(resolved.tokens).join(", ") || "(none built in)";
-          throw new (0, _chunkJG6KRAW6cjs.UnknownTokenError)(
+          throw new (0, _chunkVPENSVOIcjs.UnknownTokenError)(
             `token "${token}" isn't built in for ${resolved.chain.name} (known: ${known}). Pass { address, decimals } instead, or use 'native'.`
           );
         }
         return { asset: info.address, decimals: info.decimals, symbol: info.symbol };
       }
-      _chunkJG6KRAW6cjs.rejectForeignToken.call(void 0, token, "evm", network);
+      _chunkVPENSVOIcjs.rejectForeignToken.call(void 0, token, "evm", network);
       if (!("address" in token)) {
-        throw new (0, _chunkJG6KRAW6cjs.WrongFamilyError)(
+        throw new (0, _chunkVPENSVOIcjs.WrongFamilyError)(
           `chain ${network} is EVM; a custom token must be { address, decimals }.`
         );
       }
@@ -1624,20 +1624,20 @@ function makeEvmNetwork(resolved) {
     },
     assertValidPayTo(payTo) {
       if (!_viem.isAddress.call(void 0, payTo)) {
-        throw new (0, _chunkJG6KRAW6cjs.WrongFamilyError)(
+        throw new (0, _chunkVPENSVOIcjs.WrongFamilyError)(
           `chain ${network} is EVM, but payTo "${payTo}" is not a valid 0x address.`
         );
       }
     },
     bindWallet(wallet) {
       if (typeof wallet !== "object" || wallet === null) {
-        throw new (0, _chunkJG6KRAW6cjs.WrongFamilyError)(
+        throw new (0, _chunkVPENSVOIcjs.WrongFamilyError)(
           `chain ${network} is EVM; wallet must be { key } (0x\u2026 hex) or { walletClient }.`
         );
       }
-      _chunkJG6KRAW6cjs.assertNoLegacyWalletKey.call(void 0, wallet, "EVM");
+      _chunkVPENSVOIcjs.assertNoLegacyWalletKey.call(void 0, wallet, "EVM");
       if (!("key" in wallet) && !("walletClient" in wallet)) {
-        throw new (0, _chunkJG6KRAW6cjs.WrongFamilyError)(
+        throw new (0, _chunkVPENSVOIcjs.WrongFamilyError)(
           `chain ${network} is EVM; wallet must be { key } (0x\u2026 hex) or { walletClient }.`
         );
       }
@@ -1654,12 +1654,12 @@ function makeEvmNetwork(resolved) {
         });
       } catch (err) {
         if (isViemInsufficientFunds(err)) {
-          throw new (0, _chunkJG6KRAW6cjs.InsufficientFundsError)(
+          throw new (0, _chunkVPENSVOIcjs.InsufficientFundsError)(
             err instanceof Error ? err.message : "Insufficient funds for payment.",
             { cause: err }
           );
         }
-        throw _nullishCoalesce(_chunkJG6KRAW6cjs.toInsufficientFundsError.call(void 0, err), () => ( err));
+        throw _nullishCoalesce(_chunkVPENSVOIcjs.toInsufficientFundsError.call(void 0, err), () => ( err));
       }
     },
     async confirm(ref, minConfirmations) {
@@ -1670,7 +1670,7 @@ function makeEvmNetwork(resolved) {
         });
         return { height: receipt.blockNumber.toString() };
       } catch (err) {
-        throw new (0, _chunkJG6KRAW6cjs.ConfirmationTimeoutError)(
+        throw new (0, _chunkVPENSVOIcjs.ConfirmationTimeoutError)(
           `EVM tx ${ref} did not reach ${minConfirmations} confirmation(s) in time.`,
           { cause: err }
         );
@@ -1680,7 +1680,7 @@ function makeEvmNetwork(resolved) {
       const { decimals, symbol } = resolved.chain.nativeCurrency;
       if (accept.scheme === "exact") {
         const permit2 = accept.extra.assetTransferMethod === "permit2";
-        return _chunkJG6KRAW6cjs.nativeCost.call(void 0, {
+        return _chunkVPENSVOIcjs.nativeCost.call(void 0, {
           symbol,
           decimals,
           fee: 0n,
@@ -1691,7 +1691,7 @@ function makeEvmNetwork(resolved) {
       const gasLimit = accept.asset === "native" ? 21000n : 65000n;
       try {
         const gasPrice = await publicClient.getGasPrice();
-        return _chunkJG6KRAW6cjs.nativeCost.call(void 0, {
+        return _chunkVPENSVOIcjs.nativeCost.call(void 0, {
           symbol,
           decimals,
           fee: gasPrice * gasLimit,
@@ -1700,7 +1700,7 @@ function makeEvmNetwork(resolved) {
         });
       } catch (e20) {
         const gasPrice = 5000000000n;
-        return _chunkJG6KRAW6cjs.nativeCost.call(void 0, {
+        return _chunkVPENSVOIcjs.nativeCost.call(void 0, {
           symbol,
           decimals,
           fee: gasPrice * gasLimit,
@@ -1840,9 +1840,9 @@ var loaders = {
   solana: async () => {
     let mod;
     try {
-      mod = await Promise.resolve().then(() => _interopRequireWildcard(require("./solana-M3VOHCMO.cjs")));
+      mod = await Promise.resolve().then(() => _interopRequireWildcard(require("./solana-L342QCSV.cjs")));
     } catch (cause) {
-      throw new (0, _chunkJG6KRAW6cjs.MissingDriverError)(
+      throw new (0, _chunkVPENSVOIcjs.MissingDriverError)(
         `Solana selected, but its packages aren't installed. Run: npm install @solana/web3.js @solana/spl-token bs58`,
         { cause }
       );
@@ -1852,9 +1852,9 @@ var loaders = {
   ton: async () => {
     let mod;
     try {
-      mod = await Promise.resolve().then(() => _interopRequireWildcard(require("./ton-MMPKWT6N.cjs")));
+      mod = await Promise.resolve().then(() => _interopRequireWildcard(require("./ton-LZKJWYHV.cjs")));
     } catch (cause) {
-      throw new (0, _chunkJG6KRAW6cjs.MissingDriverError)(
+      throw new (0, _chunkVPENSVOIcjs.MissingDriverError)(
         `TON selected, but its packages aren't installed. Run: npm install @ton/ton @ton/core @ton/crypto`,
         { cause }
       );
@@ -1864,9 +1864,9 @@ var loaders = {
   stellar: async () => {
     let mod;
     try {
-      mod = await Promise.resolve().then(() => _interopRequireWildcard(require("./stellar-FW6C6FBE.cjs")));
+      mod = await Promise.resolve().then(() => _interopRequireWildcard(require("./stellar-YEXRVR3W.cjs")));
     } catch (cause) {
-      throw new (0, _chunkJG6KRAW6cjs.MissingDriverError)(
+      throw new (0, _chunkVPENSVOIcjs.MissingDriverError)(
         `Stellar selected, but its package isn't installed. Run: npm install @stellar/stellar-sdk`,
         { cause }
       );
@@ -1876,9 +1876,9 @@ var loaders = {
   xrpl: async () => {
     let mod;
     try {
-      mod = await Promise.resolve().then(() => _interopRequireWildcard(require("./xrpl-PECT4IMX.cjs")));
+      mod = await Promise.resolve().then(() => _interopRequireWildcard(require("./xrpl-K3U3SBF4.cjs")));
     } catch (cause) {
-      throw new (0, _chunkJG6KRAW6cjs.MissingDriverError)(
+      throw new (0, _chunkVPENSVOIcjs.MissingDriverError)(
         `XRPL selected, but its package isn't installed. Run: npm install xrpl`,
         { cause }
       );
@@ -1888,9 +1888,9 @@ var loaders = {
   tron: async () => {
     let mod;
     try {
-      mod = await Promise.resolve().then(() => _interopRequireWildcard(require("./tron-JOT4STIG.cjs")));
+      mod = await Promise.resolve().then(() => _interopRequireWildcard(require("./tron-DQU4WTGQ.cjs")));
     } catch (cause) {
-      throw new (0, _chunkJG6KRAW6cjs.MissingDriverError)(
+      throw new (0, _chunkVPENSVOIcjs.MissingDriverError)(
         `Tron selected, but its package isn't installed. Run: npm install tronweb`,
         { cause }
       );
@@ -1900,9 +1900,9 @@ var loaders = {
   sui: async () => {
     let mod;
     try {
-      mod = await Promise.resolve().then(() => _interopRequireWildcard(require("./sui-47C2KEZI.cjs")));
+      mod = await Promise.resolve().then(() => _interopRequireWildcard(require("./sui-EFRSCDWN.cjs")));
     } catch (cause) {
-      throw new (0, _chunkJG6KRAW6cjs.MissingDriverError)(
+      throw new (0, _chunkVPENSVOIcjs.MissingDriverError)(
         `Sui selected, but its package isn't installed. Run: npm install @mysten/sui`,
         { cause }
       );
@@ -1912,9 +1912,9 @@ var loaders = {
   near: async () => {
     let mod;
     try {
-      mod = await Promise.resolve().then(() => _interopRequireWildcard(require("./near-H5AQ253I.cjs")));
+      mod = await Promise.resolve().then(() => _interopRequireWildcard(require("./near-NYFMX2KA.cjs")));
     } catch (cause) {
-      throw new (0, _chunkJG6KRAW6cjs.MissingDriverError)(
+      throw new (0, _chunkVPENSVOIcjs.MissingDriverError)(
         `NEAR selected, but its package isn't installed. Run: npm install near-api-js`,
         { cause }
       );
@@ -1924,9 +1924,9 @@ var loaders = {
   aptos: async () => {
     let mod;
     try {
-      mod = await Promise.resolve().then(() => _interopRequireWildcard(require("./aptos-JQMZNTMD.cjs")));
+      mod = await Promise.resolve().then(() => _interopRequireWildcard(require("./aptos-CVHLVMAF.cjs")));
     } catch (cause) {
-      throw new (0, _chunkJG6KRAW6cjs.MissingDriverError)(
+      throw new (0, _chunkVPENSVOIcjs.MissingDriverError)(
         `Aptos selected, but its package isn't installed. Run: npm install @aptos-labs/ts-sdk`,
         { cause }
       );
@@ -1936,9 +1936,9 @@ var loaders = {
   algorand: async () => {
     let mod;
     try {
-      mod = await Promise.resolve().then(() => _interopRequireWildcard(require("./algorand-TMA62DN2.cjs")));
+      mod = await Promise.resolve().then(() => _interopRequireWildcard(require("./algorand-EKD34T4Q.cjs")));
     } catch (cause) {
-      throw new (0, _chunkJG6KRAW6cjs.MissingDriverError)(
+      throw new (0, _chunkVPENSVOIcjs.MissingDriverError)(
         `Algorand selected, but its package isn't installed. Run: npm install algosdk`,
         { cause }
       );
@@ -2027,7 +2027,7 @@ var SLUG_TO_CAIP2 = {
   bsc: "eip155:56",
   // non-EVM families — values mirror each driver's bound caip2 exactly
   solana: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
-  ton: "ton:-239",
+  ton: "tvm:-239",
   tron: "tron:mainnet",
   near: "near:mainnet",
   sui: "sui:mainnet",
@@ -2036,7 +2036,12 @@ var SLUG_TO_CAIP2 = {
   stellar: "stellar:pubnet",
   xrpl: "xrpl:0"
 };
+var LEGACY_CAIP2_ALIAS = {
+  "ton:-239": "tvm:-239"
+};
 function normalizeNetwork(network) {
+  const legacy = LEGACY_CAIP2_ALIAS[network];
+  if (legacy) return legacy;
   if (network.includes(":")) return network;
   return _nullishCoalesce(SLUG_TO_CAIP2[network.toLowerCase()], () => ( network));
 }
@@ -2643,7 +2648,7 @@ function evaluatePolicy(intent, policy, spentForAssetBase, ctx) {
     }
   }
   if (policy.maxAmount !== void 0) {
-    const cap = _chunkJG6KRAW6cjs.floorUnits.call(void 0, policy.maxAmount, intent.decimals);
+    const cap = _chunkVPENSVOIcjs.floorUnits.call(void 0, policy.maxAmount, intent.decimals);
     if (intent.amountBase > cap) {
       return deny(
         "MAX_AMOUNT",
@@ -2652,7 +2657,7 @@ function evaluatePolicy(intent, policy, spentForAssetBase, ctx) {
     }
   }
   if (policy.maxTotal !== void 0) {
-    const cap = _chunkJG6KRAW6cjs.floorUnits.call(void 0, policy.maxTotal, intent.decimals);
+    const cap = _chunkVPENSVOIcjs.floorUnits.call(void 0, policy.maxTotal, intent.decimals);
     if (spentForAssetBase + intent.amountBase > cap) {
       return deny(
         "MAX_TOTAL",
@@ -2661,7 +2666,7 @@ function evaluatePolicy(intent, policy, spentForAssetBase, ctx) {
     }
   }
   if (ctx && policy.windowTotal !== void 0 && policy.windowSeconds !== void 0) {
-    const cap = _chunkJG6KRAW6cjs.floorUnits.call(void 0, policy.windowTotal, intent.decimals);
+    const cap = _chunkVPENSVOIcjs.floorUnits.call(void 0, policy.windowTotal, intent.decimals);
     if (ctx.spentInWindowBase + intent.amountBase > cap) {
       return deny(
         "WINDOW_TOTAL",
@@ -2750,7 +2755,7 @@ var SpendLedger = (_class = class {constructor() { _class.prototype.__init.call(
         symbol: b.symbol,
         decimals: b.decimals,
         totalBase: b.total.toString(),
-        totalFormatted: _chunkJG6KRAW6cjs.formatUnits.call(void 0, b.total, b.decimals),
+        totalFormatted: _chunkVPENSVOIcjs.formatUnits.call(void 0, b.total, b.decimals),
         count: b.count
       })),
       records: [...this.records]
@@ -2967,13 +2972,13 @@ var PipRailClient = (_class2 = class {
         spentBase: b.totalBase.toString()
       };
       if (maxTotal === void 0) return base2;
-      const capBase = _chunkJG6KRAW6cjs.floorUnits.call(void 0, maxTotal, b.decimals);
+      const capBase = _chunkVPENSVOIcjs.floorUnits.call(void 0, maxTotal, b.decimals);
       const remainingBase = capBase > b.totalBase ? capBase - b.totalBase : 0n;
       return {
         ...base2,
         capBase: capBase.toString(),
         remainingBase: remainingBase.toString(),
-        remainingFormatted: _chunkJG6KRAW6cjs.formatUnits.call(void 0, remainingBase, b.decimals)
+        remainingFormatted: _chunkVPENSVOIcjs.formatUnits.call(void 0, remainingBase, b.decimals)
       };
     });
   }
@@ -3013,11 +3018,11 @@ var PipRailClient = (_class2 = class {
     if (res.status !== 402) return null;
     const challenge = await parseChallenge(res);
     if (!challenge) {
-      throw new (0, _chunkJG6KRAW6cjs.InvalidEnvelopeError)("402 response did not include a parseable x402 challenge.");
+      throw new (0, _chunkVPENSVOIcjs.InvalidEnvelopeError)("402 response did not include a parseable x402 challenge.");
     }
     const { net, wallet } = await this.ensure();
     if (!wallet) {
-      throw new (0, _chunkJG6KRAW6cjs.WalletRequiredError)(
+      throw new (0, _chunkVPENSVOIcjs.WalletRequiredError)(
         "planPayment needs a wallet (it checks YOUR balance, gas, and recipient-readiness). This client is read-only \u2014 construct it with a `wallet` to plan or pay."
       );
     }
@@ -3192,7 +3197,7 @@ var PipRailClient = (_class2 = class {
   async fetch(url, init) {
     const body = _optionalChain([init, 'optionalAccess', _31 => _31.body]);
     if (body !== void 0 && body !== null && !isReplayableBodyInit(body)) {
-      throw new (0, _chunkJG6KRAW6cjs.NonReplayableBodyError)(
+      throw new (0, _chunkVPENSVOIcjs.NonReplayableBodyError)(
         "fetch(): init.body is not replayable. Pass a string, FormData, URLSearchParams, ArrayBuffer, or Blob \u2014 not a ReadableStream."
       );
     }
@@ -3202,7 +3207,7 @@ var PipRailClient = (_class2 = class {
     const resolved = await this.resolveChallenge(url, firstResponse, schemes);
     const { net, wallet, challenge } = resolved;
     if (!wallet) {
-      throw new (0, _chunkJG6KRAW6cjs.WalletRequiredError)(
+      throw new (0, _chunkVPENSVOIcjs.WalletRequiredError)(
         "Paying a 402 needs a wallet to sign + settle. This client is read-only \u2014 construct it with a `wallet` to pay (quote/discover/register still work without one)."
       );
     }
@@ -3212,7 +3217,9 @@ var PipRailClient = (_class2 = class {
     if (autoRoute) {
       const plan = await this.planFromChallenge(net, wallet, challenge, url, schemes);
       if (!plan.best) {
-        throw new (0, _chunkJG6KRAW6cjs.PaymentDeclinedError)(_nullishCoalesce(plan.fundingHint, () => ( "No rail is settleable for this payment.")));
+        const reason = _nullishCoalesce(plan.fundingHint, () => ( "No rail is settleable for this payment."));
+        this.safeEmit({ kind: "payment-failed", reason });
+        throw new (0, _chunkVPENSVOIcjs.PaymentDeclinedError)(reason);
       }
       accept = plan.best.accept;
       quote = plan.best.quote;
@@ -3236,7 +3243,7 @@ var PipRailClient = (_class2 = class {
   async resolveChallenge(url, response, schemes) {
     const challenge = await parseChallenge(response);
     if (!challenge) {
-      throw new (0, _chunkJG6KRAW6cjs.InvalidEnvelopeError)(
+      throw new (0, _chunkVPENSVOIcjs.InvalidEnvelopeError)(
         "402 response did not include a parseable x402 challenge."
       );
     }
@@ -3247,7 +3254,7 @@ var PipRailClient = (_class2 = class {
         (a) => a.scheme === "exact" && this.supportsNetwork(net, a.network)
       );
       if (schemes.includes("exact") && exactOnNet && typeof net.payExact !== "function") {
-        throw new (0, _chunkJG6KRAW6cjs.UnsupportedSchemeError)(
+        throw new (0, _chunkVPENSVOIcjs.UnsupportedSchemeError)(
           `This 402 offers a standard 'exact' rail on ${net.network}, but the ${net.family} family can't pay 'exact' (supported on EVM, Solana, Algorand + NEAR today), and no 'onchain-proof' rail was offered.`
         );
       }
@@ -3256,13 +3263,13 @@ var PipRailClient = (_class2 = class {
           (a) => a.scheme === "exact" && this.supportsNetwork(net, a.network) && net.describeAsset(a.asset) != null
         );
         if (payable) {
-          throw new (0, _chunkJG6KRAW6cjs.NoCompatibleAcceptError)(
+          throw new (0, _chunkVPENSVOIcjs.NoCompatibleAcceptError)(
             `This 402 is payable only via the standard 'exact' rail on ${net.network}, which is OFF by default. Enable it: new PipRailClient({ \u2026, schemes: ['onchain-proof', 'exact'] }) or per call fetch(url, { schemes: ['exact'] }) (MCP: PIPRAIL_SCHEMES=onchain-proof,exact).`
           );
         }
       }
       const networks = [...new Set(challenge.accepts.map((a) => a.network))].join(", ");
-      throw new (0, _chunkJG6KRAW6cjs.NoCompatibleAcceptError)(
+      throw new (0, _chunkVPENSVOIcjs.NoCompatibleAcceptError)(
         `No accepts[] entry payable by this client on ${net.network} (schemes: ${schemes.join(", ")}; challenge offered: ${networks || "none"}).`
       );
     }
@@ -3375,21 +3382,21 @@ var PipRailClient = (_class2 = class {
     if (isExact) {
       if (tokenKnown && bal.token < amount) {
         blockers.push("INSUFFICIENT_TOKEN");
-        shortfall.token = _chunkJG6KRAW6cjs.formatUnits.call(void 0, amount - bal.token, quote.decimals);
+        shortfall.token = _chunkVPENSVOIcjs.formatUnits.call(void 0, amount - bal.token, quote.decimals);
       }
     } else if (isNative) {
       if (nativeKnown && bal.native < amount + fee) {
         blockers.push("INSUFFICIENT_TOKEN");
-        shortfall.token = _chunkJG6KRAW6cjs.formatUnits.call(void 0, amount + fee - bal.native, quote.decimals);
+        shortfall.token = _chunkVPENSVOIcjs.formatUnits.call(void 0, amount + fee - bal.native, quote.decimals);
       }
     } else {
       if (tokenKnown && bal.token < amount) {
         blockers.push("INSUFFICIENT_TOKEN");
-        shortfall.token = _chunkJG6KRAW6cjs.formatUnits.call(void 0, amount - bal.token, quote.decimals);
+        shortfall.token = _chunkVPENSVOIcjs.formatUnits.call(void 0, amount - bal.token, quote.decimals);
       }
       if (nativeKnown && bal.native < fee) {
         blockers.push("INSUFFICIENT_GAS");
-        shortfall.native = _chunkJG6KRAW6cjs.formatUnits.call(void 0, fee - bal.native, cost.feeDecimals);
+        shortfall.native = _chunkVPENSVOIcjs.formatUnits.call(void 0, fee - bal.native, cost.feeDecimals);
       } else if (nativeKnown && fee > 0n && bal.native < fee * 3n / 2n) {
         warnings.push("THIN_GAS_MARGIN");
       }
@@ -3414,8 +3421,8 @@ var PipRailClient = (_class2 = class {
       blockers,
       warnings,
       balance: {
-        token: bal.token != null ? _chunkJG6KRAW6cjs.formatUnits.call(void 0, bal.token, quote.decimals) : null,
-        native: bal.native != null ? _chunkJG6KRAW6cjs.formatUnits.call(void 0, bal.native, cost.feeDecimals) : null
+        token: bal.token != null ? _chunkVPENSVOIcjs.formatUnits.call(void 0, bal.token, quote.decimals) : null,
+        native: bal.native != null ? _chunkVPENSVOIcjs.formatUnits.call(void 0, bal.native, cost.feeDecimals) : null
       },
       need: { token: quote.amountFormatted, native: cost.feeFormatted },
       ...shortfall.token || shortfall.native ? { shortfall } : {},
@@ -3426,12 +3433,12 @@ var PipRailClient = (_class2 = class {
    *  driver's describeAsset) + the policy verdict + a symbol-mismatch flag. */
   buildQuote(net, accept, url, description) {
     if (typeof accept.amount !== "string" || !/^\d+$/.test(accept.amount)) {
-      throw new (0, _chunkJG6KRAW6cjs.InvalidEnvelopeError)(
+      throw new (0, _chunkVPENSVOIcjs.InvalidEnvelopeError)(
         `challenge amount "${String(accept.amount)}" is not a base-unit integer string.`
       );
     }
     if (typeof accept.asset !== "string" || accept.asset.length === 0) {
-      throw new (0, _chunkJG6KRAW6cjs.InvalidEnvelopeError)(
+      throw new (0, _chunkVPENSVOIcjs.InvalidEnvelopeError)(
         `challenge on ${accept.network} states no (string) asset \u2014 refusing to price it.`
       );
     }
@@ -3439,12 +3446,12 @@ var PipRailClient = (_class2 = class {
     const described = net.describeAsset(accept.asset);
     const decimals = _nullishCoalesce(_optionalChain([described, 'optionalAccess', _34 => _34.decimals]), () => ( _optionalChain([accept, 'access', _35 => _35.extra, 'optionalAccess', _36 => _36.decimals])));
     if (typeof decimals !== "number" || !Number.isInteger(decimals) || decimals < 0) {
-      throw new (0, _chunkJG6KRAW6cjs.InvalidEnvelopeError)(
+      throw new (0, _chunkVPENSVOIcjs.InvalidEnvelopeError)(
         `challenge for ${accept.asset} on ${accept.network} states no valid decimals and the SDK doesn't recognise the token \u2014 refusing to price it.`
       );
     }
     const symbol = _nullishCoalesce(_optionalChain([described, 'optionalAccess', _37 => _37.symbol]), () => ( _optionalChain([accept, 'access', _38 => _38.extra, 'optionalAccess', _39 => _39.symbol])));
-    const amountFormatted = _chunkJG6KRAW6cjs.formatUnits.call(void 0, amountBase, decimals);
+    const amountFormatted = _chunkVPENSVOIcjs.formatUnits.call(void 0, amountBase, decimals);
     const intent = {
       host: hostOf2(url),
       chain: this.opts.chain,
@@ -3502,10 +3509,10 @@ var PipRailClient = (_class2 = class {
    *  TERMINAL expiry/approval decline it must not retry) without parsing prose. */
   async authorize(quote) {
     if (!quote.withinPolicy) {
-      throw new (0, _chunkJG6KRAW6cjs.PaymentDeclinedError)(
-        `Payment refused by policy: ${_nullishCoalesce(quote.policyReason, () => ( "not allowed"))}`,
-        { reasonCode: reasonCodeForPolicy(quote.policyCode) }
-      );
+      const reason = `Payment refused by policy: ${_nullishCoalesce(quote.policyReason, () => ( "not allowed"))}`;
+      const reasonCode = reasonCodeForPolicy(quote.policyCode);
+      this.safeEmit({ kind: "payment-failed", reason, code: reasonCode });
+      throw new (0, _chunkVPENSVOIcjs.PaymentDeclinedError)(reason, { reasonCode });
     }
     const hook = this.opts.onBeforePay;
     if (!hook) return;
@@ -3513,16 +3520,14 @@ var PipRailClient = (_class2 = class {
     try {
       approved = await hook(quote);
     } catch (err) {
-      throw new (0, _chunkJG6KRAW6cjs.PaymentDeclinedError)("onBeforePay threw \u2014 refusing to pay.", {
-        cause: err,
-        reasonCode: "APPROVAL"
-      });
+      const reason = "onBeforePay threw \u2014 refusing to pay.";
+      this.safeEmit({ kind: "payment-failed", reason, code: "APPROVAL" });
+      throw new (0, _chunkVPENSVOIcjs.PaymentDeclinedError)(reason, { cause: err, reasonCode: "APPROVAL" });
     }
     if (!approved) {
-      throw new (0, _chunkJG6KRAW6cjs.PaymentDeclinedError)(
-        `onBeforePay declined ${quote.amountFormatted} ${_nullishCoalesce(quote.symbol, () => ( ""))}`.trimEnd() + ` on ${quote.network}.`,
-        { reasonCode: "APPROVAL" }
-      );
+      const reason = `onBeforePay declined ${quote.amountFormatted} ${_nullishCoalesce(quote.symbol, () => ( ""))}`.trimEnd() + ` on ${quote.network}.`;
+      this.safeEmit({ kind: "payment-failed", reason, code: "APPROVAL" });
+      throw new (0, _chunkVPENSVOIcjs.PaymentDeclinedError)(reason, { reasonCode: "APPROVAL" });
     }
   }
   /** Record a settled payment in the ledger (true decimals for the running total). */
@@ -3544,7 +3549,7 @@ var PipRailClient = (_class2 = class {
   }
   async payAndConfirm(net, wallet, accept) {
     if (!this.supportsNetwork(net, accept.network)) {
-      throw new (0, _chunkJG6KRAW6cjs.WrongChainError)(
+      throw new (0, _chunkVPENSVOIcjs.WrongChainError)(
         `Challenge expects ${accept.network} but client is on ${net.network}.`
       );
     }
@@ -3597,7 +3602,7 @@ var PipRailClient = (_class2 = class {
         });
       } catch (err) {
         if (timeoutController.signal.aborted) {
-          throw new (0, _chunkJG6KRAW6cjs.PaymentTimeoutError)(
+          throw new (0, _chunkVPENSVOIcjs.PaymentTimeoutError)(
             `Server did not respond within ${this.retryTimeoutMs}ms after broadcasting payment ${ref}. Re-verify or re-submit ref=${ref} \u2014 do NOT re-pay.`,
             { cause: err, ref }
           );
@@ -3617,9 +3622,10 @@ var PipRailClient = (_class2 = class {
     const unconfirmedNote = confirmed ? "" : " (broadcast but NOT locally confirmed \u2014 it may still have settled on-chain)";
     this.safeEmit({
       kind: "payment-failed",
-      reason: `server returned 402 after broadcasting payment ${ref}${unconfirmedNote} (${why})`
+      reason: `server returned 402 after broadcasting payment ${ref}${unconfirmedNote} (${why})`,
+      ...lastReason ? { code: lastReason.error, detail: lastReason.detail } : {}
     });
-    throw new (0, _chunkJG6KRAW6cjs.MaxRetriesExceededError)(
+    throw new (0, _chunkVPENSVOIcjs.MaxRetriesExceededError)(
       `Server still returned 402 after ${attempts} attempt(s) with on-chain proof ref=${ref}${unconfirmedNote}. Last server rejection: ${why}. Re-verify or re-submit ref=${ref} before retrying \u2014 never re-pay (it would double-spend).`,
       { ref }
     );
@@ -3643,7 +3649,7 @@ var PipRailClient = (_class2 = class {
    */
   async payExactRail(net, wallet, accept, url, init, quote) {
     if (!net.payExact) {
-      throw new (0, _chunkJG6KRAW6cjs.UnsupportedSchemeError)(
+      throw new (0, _chunkVPENSVOIcjs.UnsupportedSchemeError)(
         `the ${net.family} family can't pay a standard 'exact' rail (supported on EVM, Solana, Algorand + NEAR today).`
       );
     }
@@ -3652,8 +3658,8 @@ var PipRailClient = (_class2 = class {
     const headers = new Headers(_optionalChain([init, 'optionalAccess', _49 => _49.headers]));
     headers.set(HEADER_SIGNATURE, buildExactSignatureHeader({ accepted, payload }));
     const rejectDefinitive = (why2) => {
-      this.safeEmit({ kind: "payment-failed", reason: `exact: facilitator rejected nonce=${nonce} (${why2})` });
-      throw new (0, _chunkJG6KRAW6cjs.MaxRetriesExceededError)(
+      this.safeEmit({ kind: "payment-failed", reason: `exact: facilitator rejected nonce=${nonce} (${why2})`, code: why2 });
+      throw new (0, _chunkVPENSVOIcjs.MaxRetriesExceededError)(
         `exact: the facilitator rejected the payment (${why2}). Fix the cause, then re-present the SAME signed authorization (nonce=${nonce}) \u2014 do NOT re-sign a fresh nonce. ref=${nonce}.`,
         { ref: nonce }
       );
@@ -3676,7 +3682,7 @@ var PipRailClient = (_class2 = class {
       try {
         response = await fetch(url, { ..._nullishCoalesce(init, () => ( {})), headers, signal });
       } catch (err) {
-        throw new (0, _chunkJG6KRAW6cjs.PaymentTimeoutError)(
+        throw new (0, _chunkVPENSVOIcjs.PaymentTimeoutError)(
           `exact: no response after submitting the authorization (nonce=${nonce}) to ${hostOf2(url)}. The facilitator may have already settled it \u2014 verify on-chain with authorizationState(${payerFrom}, ${nonce}) before re-presenting; do NOT re-pay.`,
           { cause: err, ref: nonce }
         );
@@ -3707,9 +3713,10 @@ var PipRailClient = (_class2 = class {
     const why = lastReason ? `${lastReason.error}${lastReason.detail ? ` \u2014 ${lastReason.detail}` : ""}` : "server gave no reason";
     this.safeEmit({
       kind: "payment-failed",
-      reason: `exact: 402 after submitting authorization nonce=${nonce} (${why})`
+      reason: `exact: 402 after submitting authorization nonce=${nonce} (${why})`,
+      ...lastReason ? { code: lastReason.error, detail: lastReason.detail } : {}
     });
-    throw new (0, _chunkJG6KRAW6cjs.MaxRetriesExceededError)(
+    throw new (0, _chunkVPENSVOIcjs.MaxRetriesExceededError)(
       `exact: server still returned 402 after submitting the signed authorization (nonce=${nonce}). Last rejection: ${why}. Re-present the SAME authorization \u2014 do NOT re-sign a fresh nonce; verify authorizationState(${payerFrom}, ${nonce}) first. ref=${nonce}.`,
       { ref: nonce }
     );
@@ -3822,7 +3829,7 @@ async function fetchAcross(clients, url, init) {
   const best = rankAcross(live.map((p) => p.plan)).find((o) => o.state === "payable");
   if (!best) {
     const hint = mergeDeclineHint(live.map((p) => p.plan));
-    throw new (0, _chunkJG6KRAW6cjs.PaymentDeclinedError)(hint || "No funded chain can settle this payment right now.");
+    throw new (0, _chunkVPENSVOIcjs.PaymentDeclinedError)(hint || "No funded chain can settle this payment right now.");
   }
   const owner = live.find((p) => p.plan.options.includes(best)).client;
   return owner.fetch(url, { ..._nullishCoalesce(init, () => ( {})), autoRoute: true });
@@ -4142,7 +4149,7 @@ function summarizePlan(plan) {
   return `NOT payable: ${_nullishCoalesce(plan.fundingHint, () => ( `no settleable rail on ${plan.network}`))}`;
 }
 function explainDecline(err) {
-  if (!(err instanceof _chunkJG6KRAW6cjs.PipRailError)) {
+  if (!(err instanceof _chunkVPENSVOIcjs.PipRailError)) {
     return `Payment failed: ${err instanceof Error ? err.message : String(err)}`;
   }
   switch (err.code) {
@@ -4280,14 +4287,14 @@ async function readBody(res) {
   }
 }
 function toToolError(err) {
-  if (!(err instanceof _chunkJG6KRAW6cjs.PipRailError)) throw err;
+  if (!(err instanceof _chunkVPENSVOIcjs.PipRailError)) throw err;
   const out = {
     ok: false,
     code: err.code,
     reason: err.message,
     explain: explainDecline(err)
   };
-  if (err instanceof _chunkJG6KRAW6cjs.PaymentDeclinedError) {
+  if (err instanceof _chunkVPENSVOIcjs.PaymentDeclinedError) {
     out.declined = true;
     if (err.reasonCode) out.reasonCode = err.reasonCode;
   }
@@ -4501,14 +4508,14 @@ function paymentTools(client) {
             receipt: parseReceipt(res)
           };
         } catch (err) {
-          if (err instanceof _chunkJG6KRAW6cjs.PipRailError) {
+          if (err instanceof _chunkVPENSVOIcjs.PipRailError) {
             const out = {
               ok: false,
               code: err.code,
               reason: err.message,
               explain: explainDecline(err)
             };
-            if (err instanceof _chunkJG6KRAW6cjs.PaymentDeclinedError) {
+            if (err instanceof _chunkVPENSVOIcjs.PaymentDeclinedError) {
               out.declined = true;
               if (err.reasonCode) out.reasonCode = err.reasonCode;
             }
@@ -4862,13 +4869,13 @@ async function settleViaFacilitator(input) {
   try {
     verify = await post(`${base2}/verify`, body, auth);
   } catch (err) {
-    throw new (0, _chunkJG6KRAW6cjs.SettlementError)(
+    throw new (0, _chunkVPENSVOIcjs.SettlementError)(
       `exact settle (facilitator ${base2}): /verify request failed (${err instanceof Error ? err.message : String(err)}).`,
       { cause: err }
     );
   }
   if (verify.status !== 200) {
-    throw new (0, _chunkJG6KRAW6cjs.SettlementError)(
+    throw new (0, _chunkVPENSVOIcjs.SettlementError)(
       `exact settle (facilitator ${base2}): /verify returned HTTP ${verify.status} (transport/auth error).`
     );
   }
@@ -4884,13 +4891,13 @@ async function settleViaFacilitator(input) {
   try {
     settle = await post(`${base2}/settle`, body, auth);
   } catch (err) {
-    throw new (0, _chunkJG6KRAW6cjs.SettlementError)(
+    throw new (0, _chunkVPENSVOIcjs.SettlementError)(
       `exact settle (facilitator ${base2}): /settle request failed (${err instanceof Error ? err.message : String(err)}).`,
       { cause: err }
     );
   }
   if (settle.status !== 200) {
-    throw new (0, _chunkJG6KRAW6cjs.SettlementError)(
+    throw new (0, _chunkVPENSVOIcjs.SettlementError)(
       `exact settle (facilitator ${base2}): /settle returned HTTP ${settle.status} (transport/auth error).`
     );
   }
@@ -5260,6 +5267,7 @@ function normaliseExactOption(exact) {
   if (exact === true) return { settle: "keyless" };
   return exact;
 }
+var TRANSIENT_VERIFY_CODES = /* @__PURE__ */ new Set(["tx_not_found", "insufficient_confirmations"]);
 function createPaymentGate(options) {
   const minConfirmations = _nullishCoalesce(options.minConfirmations, () => ( 1));
   const maxTimeoutSeconds = _nullishCoalesce(options.maxTimeoutSeconds, () => ( 600));
@@ -5282,7 +5290,7 @@ function createPaymentGate(options) {
           }
           net.assertValidPayTo(payTo);
           const { asset, decimals, symbol } = net.resolveToken(a.token);
-          const amountBase = _chunkJG6KRAW6cjs.parseUnits.call(void 0, a.amount, decimals);
+          const amountBase = _chunkVPENSVOIcjs.parseUnits.call(void 0, a.amount, decimals);
           const spec = { net, asset, decimals, symbol, amountBase, amountFormatted: a.amount, payTo };
           if (exactOption) {
             const outcome = await resolveExactRail(net, asset);
@@ -5508,7 +5516,7 @@ function createPaymentGate(options) {
   function enrichReceipt(spec, receipt) {
     let amountFormatted = receipt.amount;
     try {
-      amountFormatted = _chunkJG6KRAW6cjs.formatUnits.call(void 0, BigInt(receipt.amount), spec.decimals);
+      amountFormatted = _chunkVPENSVOIcjs.formatUnits.call(void 0, BigInt(receipt.amount), spec.decimals);
     } catch (e36) {
     }
     return {
@@ -5544,6 +5552,32 @@ function createPaymentGate(options) {
     if (options.awaitOnPaid) await fireOnPaid(paid);
     else void fireOnPaid(paid);
   }
+  function reportOnFailedError(error, failure) {
+    if (!options.onFailedError) return;
+    try {
+      options.onFailedError(error, failure);
+    } catch (e38) {
+    }
+  }
+  function fireOnFailed(failure) {
+    if (!options.onFailed) return;
+    let outcome;
+    try {
+      outcome = options.onFailed(failure);
+    } catch (err) {
+      reportOnFailedError(err, failure);
+      return;
+    }
+    if (outcome != null && typeof outcome.then === "function") {
+      return Promise.resolve(outcome).catch((err) => reportOnFailedError(err, failure));
+    }
+  }
+  async function deliverOnFailed(result) {
+    const code = result.error;
+    const failure = { code, detail: result.detail, transient: TRANSIENT_VERIFY_CODES.has(code) };
+    if (options.awaitOnFailed) await fireOnFailed(failure);
+    else void fireOnFailed(failure);
+  }
   async function describe(resourceUrl = "") {
     const specs = await ready();
     const accepts = [];
@@ -5622,28 +5656,28 @@ function createPaymentGate(options) {
       nonce = [exact.payload.transaction, exact.payload.senderAuth].map((t) => {
         try {
           return Buffer.from(t, "base64").toString("base64");
-        } catch (e38) {
+        } catch (e39) {
           return t;
         }
       }).join("|");
     } else if ("transaction" in exact.payload) {
       try {
         nonce = Buffer.from(exact.payload.transaction, "base64").toString("base64");
-      } catch (e39) {
+      } catch (e40) {
         nonce = exact.payload.transaction;
       }
     } else if ("paymentGroup" in exact.payload) {
       nonce = exact.payload.paymentGroup.map((t) => {
         try {
           return Buffer.from(t, "base64").toString("base64");
-        } catch (e40) {
+        } catch (e41) {
           return t;
         }
       }).join("|");
     } else if ("signedDelegateAction" in exact.payload) {
       try {
         nonce = Buffer.from(exact.payload.signedDelegateAction, "base64").toString("base64");
-      } catch (e41) {
+      } catch (e42) {
         nonce = exact.payload.signedDelegateAction;
       }
     } else if ("permit2Authorization" in exact.payload) {
@@ -5666,7 +5700,7 @@ function createPaymentGate(options) {
         const ftMethod = accept.extra.assetTransferMethod;
         const needsFeePayer = ftMethod === "svm" || ftMethod === "algorand" || ftMethod === "aptos" || ftMethod === "near";
         if (needsFeePayer && !accept.extra.feePayer) {
-          throw new (0, _chunkJG6KRAW6cjs.SettlementError)(
+          throw new (0, _chunkVPENSVOIcjs.SettlementError)(
             `exact settle: the ${ftMethod} facilitator rail is missing extra.feePayer (the gas sponsor) \u2014 cannot settle.`
           );
         }
@@ -5707,6 +5741,11 @@ function createPaymentGate(options) {
     return { kind: "paid", receipt: result.receipt, receiptHeader: buildReceiptHeader(result.receipt) };
   }
   async function verify(paymentSignature) {
+    const result = await resolveVerdict(paymentSignature);
+    if (result.kind === "invalid") await deliverOnFailed(result);
+    return result;
+  }
+  async function resolveVerdict(paymentSignature) {
     const raw = normaliseHeader(paymentSignature);
     if (!raw) return asChallenge();
     const sig = parseSignatureHeader(raw);
@@ -5726,7 +5765,7 @@ function requirePayment(options) {
     try {
       result = await gate.verify(_nullishCoalesce(req.headers[HEADER_SIGNATURE], () => ( req.headers[HEADER_SIGNATURE_V1])));
     } catch (err) {
-      if (err instanceof _chunkJG6KRAW6cjs.SettlementError) {
+      if (err instanceof _chunkVPENSVOIcjs.SettlementError) {
         res.status(502);
         res.json({
           x402Version: 2,
@@ -5784,7 +5823,7 @@ async function signBody(secret, body) {
     const sig = await subtle.sign("HMAC", key, enc.encode(body));
     const hex = Array.from(new Uint8Array(sig)).map((b) => b.toString(16).padStart(2, "0")).join("");
     return `sha256=${hex}`;
-  } catch (e42) {
+  } catch (e43) {
     return null;
   }
 }
@@ -5845,7 +5884,7 @@ async function deliverReceipt(receipt, options) {
     const willRetry = !ok && retryable && attempt < maxAttempts;
     try {
       _optionalChain([onAttempt, 'optionalCall', _91 => _91({ attempt, ok, ...status !== void 0 ? { status } : {}, ...error ? { error } : {}, willRetry })]);
-    } catch (e43) {
+    } catch (e44) {
     }
     if (ok) return { delivered: true, attempts: attempt, status };
     if (!willRetry) {
@@ -5964,4 +6003,4 @@ async function deliverReceipt(receipt, options) {
 
 
 
-exports.BRAND = BRAND; exports.CHAINS = CHAINS; exports.ConfirmationTimeoutError = _chunkJG6KRAW6cjs.ConfirmationTimeoutError; exports.DIRECTORY_INFO = DIRECTORY_INFO; exports.EIP3009_TYPES = EIP3009_TYPES; exports.EXACT_NETWORK_SLUGS = EXACT_NETWORK_SLUGS; exports.GENERATOR = GENERATOR; exports.HEADER_REQUIRED = HEADER_REQUIRED; exports.HEADER_RESPONSE = HEADER_RESPONSE; exports.HEADER_RESPONSE_V1 = HEADER_RESPONSE_V1; exports.HEADER_SIGNATURE = HEADER_SIGNATURE; exports.HEADER_SIGNATURE_V1 = HEADER_SIGNATURE_V1; exports.InsufficientFundsError = _chunkJG6KRAW6cjs.InsufficientFundsError; exports.InvalidEnvelopeError = _chunkJG6KRAW6cjs.InvalidEnvelopeError; exports.KNOWN_FACILITATORS = KNOWN_FACILITATORS; exports.MaxRetriesExceededError = _chunkJG6KRAW6cjs.MaxRetriesExceededError; exports.MissingDriverError = _chunkJG6KRAW6cjs.MissingDriverError; exports.MultiChainPayer = MultiChainPayer; exports.NoCompatibleAcceptError = _chunkJG6KRAW6cjs.NoCompatibleAcceptError; exports.NonReplayableBodyError = _chunkJG6KRAW6cjs.NonReplayableBodyError; exports.PERMIT2_ADDRESS = PERMIT2_ADDRESS; exports.PERMIT2_PROXY_CHAIN_IDS = PERMIT2_PROXY_CHAIN_IDS; exports.PERMIT2_WITNESS_TYPES = PERMIT2_WITNESS_TYPES; exports.PIPRAIL_AGENT_GUIDE = PIPRAIL_AGENT_GUIDE; exports.POWERED_BY = POWERED_BY; exports.PaymentDeclinedError = _chunkJG6KRAW6cjs.PaymentDeclinedError; exports.PaymentTimeoutError = _chunkJG6KRAW6cjs.PaymentTimeoutError; exports.PipRailClient = PipRailClient; exports.PipRailError = _chunkJG6KRAW6cjs.PipRailError; exports.REGISTER_ATTRIBUTION = REGISTER_ATTRIBUTION; exports.RecipientNotReadyError = _chunkJG6KRAW6cjs.RecipientNotReadyError; exports.SettlementError = _chunkJG6KRAW6cjs.SettlementError; exports.UnknownTokenError = _chunkJG6KRAW6cjs.UnknownTokenError; exports.UnsupportedNetworkError = _chunkJG6KRAW6cjs.UnsupportedNetworkError; exports.UnsupportedSchemeError = _chunkJG6KRAW6cjs.UnsupportedSchemeError; exports.WalletRequiredError = _chunkJG6KRAW6cjs.WalletRequiredError; exports.WrongChainError = _chunkJG6KRAW6cjs.WrongChainError; exports.WrongFamilyError = _chunkJG6KRAW6cjs.WrongFamilyError; exports.X402_EXACT_PERMIT2_PROXY = X402_EXACT_PERMIT2_PROXY; exports.agentGuide = agentGuide; exports.appendAttribution = appendAttribution; exports.appendKeywords = appendKeywords; exports.buildBazaarExtension = buildBazaarExtension; exports.buildChallengeHeader = buildChallengeHeader; exports.buildEndpointInfo = buildEndpointInfo; exports.buildExactAuthorization = buildExactAuthorization; exports.buildExactSignatureHeader = buildExactSignatureHeader; exports.buildOpenApi = buildOpenApi; exports.buildReceiptHeader = buildReceiptHeader; exports.buildSelfDescription = buildSelfDescription; exports.buildSignatureHeader = buildSignatureHeader; exports.buildWellKnownX402 = buildWellKnownX402; exports.buildX402DnsTxt = buildX402DnsTxt; exports.chainIdForExactNetwork = chainIdForExactNetwork; exports.claim402IndexDomain = claim402IndexDomain; exports.classifyChallenge = classifyChallenge; exports.createPaymentGate = createPaymentGate; exports.decorateOutcome = decorateOutcome; exports.deliverReceipt = deliverReceipt; exports.describeChallenge = describeChallenge; exports.discoveryHeaders = discoveryHeaders; exports.eip3009Abi = eip3009Abi; exports.encodeXPaymentHeader = encodeXPaymentHeader; exports.evaluatePolicy = evaluatePolicy; exports.explainDecline = explainDecline; exports.facilitatorCoverage = facilitatorCoverage; exports.fetchAcross = fetchAcross; exports.firstKeylessFacilitator = firstKeylessFacilitator; exports.formatSpendReport = formatSpendReport; exports.getDirectoryInfo = getDirectoryInfo; exports.isPermit2ProxyChain = isPermit2ProxyChain; exports.knownFacilitatorsFor = knownFacilitatorsFor; exports.normalizeNetwork = normalizeNetwork; exports.parseChallenge = parseChallenge; exports.parseExactPaymentHeader = parseExactPaymentHeader; exports.parseExactRequirements = parseExactRequirements; exports.parseFacilitatorSupported = parseFacilitatorSupported; exports.parseReceipt = parseReceipt; exports.parseSettleResponse = parseSettleResponse; exports.parseSignatureHeader = parseSignatureHeader; exports.paymentTools = paymentTools; exports.pickAccept = pickAccept; exports.planAcross = planAcross; exports.rankResources = rankResources; exports.readExactDomain = readExactDomain; exports.register402Index = register402Index; exports.registerDriver = registerDriver; exports.registerX402Scan = registerX402Scan; exports.renderLandingPage = renderLandingPage; exports.requirePayment = requirePayment; exports.resolveChain = resolveChain; exports.scoreResource = scoreResource; exports.searchOpenIndexes = searchOpenIndexes; exports.settleViaFacilitator = settleViaFacilitator; exports.summarizePlan = summarizePlan; exports.toInsufficientFundsError = _chunkJG6KRAW6cjs.toInsufficientFundsError; exports.toInvalidBody = toInvalidBody; exports.verify402IndexDomain = verify402IndexDomain;
+exports.BRAND = BRAND; exports.CHAINS = CHAINS; exports.ConfirmationTimeoutError = _chunkVPENSVOIcjs.ConfirmationTimeoutError; exports.DIRECTORY_INFO = DIRECTORY_INFO; exports.EIP3009_TYPES = EIP3009_TYPES; exports.EXACT_NETWORK_SLUGS = EXACT_NETWORK_SLUGS; exports.GENERATOR = GENERATOR; exports.HEADER_REQUIRED = HEADER_REQUIRED; exports.HEADER_RESPONSE = HEADER_RESPONSE; exports.HEADER_RESPONSE_V1 = HEADER_RESPONSE_V1; exports.HEADER_SIGNATURE = HEADER_SIGNATURE; exports.HEADER_SIGNATURE_V1 = HEADER_SIGNATURE_V1; exports.InsufficientFundsError = _chunkVPENSVOIcjs.InsufficientFundsError; exports.InvalidEnvelopeError = _chunkVPENSVOIcjs.InvalidEnvelopeError; exports.KNOWN_FACILITATORS = KNOWN_FACILITATORS; exports.MaxRetriesExceededError = _chunkVPENSVOIcjs.MaxRetriesExceededError; exports.MissingDriverError = _chunkVPENSVOIcjs.MissingDriverError; exports.MultiChainPayer = MultiChainPayer; exports.NoCompatibleAcceptError = _chunkVPENSVOIcjs.NoCompatibleAcceptError; exports.NonReplayableBodyError = _chunkVPENSVOIcjs.NonReplayableBodyError; exports.PERMIT2_ADDRESS = PERMIT2_ADDRESS; exports.PERMIT2_PROXY_CHAIN_IDS = PERMIT2_PROXY_CHAIN_IDS; exports.PERMIT2_WITNESS_TYPES = PERMIT2_WITNESS_TYPES; exports.PIPRAIL_AGENT_GUIDE = PIPRAIL_AGENT_GUIDE; exports.POWERED_BY = POWERED_BY; exports.PaymentDeclinedError = _chunkVPENSVOIcjs.PaymentDeclinedError; exports.PaymentTimeoutError = _chunkVPENSVOIcjs.PaymentTimeoutError; exports.PipRailClient = PipRailClient; exports.PipRailError = _chunkVPENSVOIcjs.PipRailError; exports.REGISTER_ATTRIBUTION = REGISTER_ATTRIBUTION; exports.RecipientNotReadyError = _chunkVPENSVOIcjs.RecipientNotReadyError; exports.SettlementError = _chunkVPENSVOIcjs.SettlementError; exports.UnknownTokenError = _chunkVPENSVOIcjs.UnknownTokenError; exports.UnsupportedNetworkError = _chunkVPENSVOIcjs.UnsupportedNetworkError; exports.UnsupportedSchemeError = _chunkVPENSVOIcjs.UnsupportedSchemeError; exports.WalletRequiredError = _chunkVPENSVOIcjs.WalletRequiredError; exports.WrongChainError = _chunkVPENSVOIcjs.WrongChainError; exports.WrongFamilyError = _chunkVPENSVOIcjs.WrongFamilyError; exports.X402_EXACT_PERMIT2_PROXY = X402_EXACT_PERMIT2_PROXY; exports.agentGuide = agentGuide; exports.appendAttribution = appendAttribution; exports.appendKeywords = appendKeywords; exports.buildBazaarExtension = buildBazaarExtension; exports.buildChallengeHeader = buildChallengeHeader; exports.buildEndpointInfo = buildEndpointInfo; exports.buildExactAuthorization = buildExactAuthorization; exports.buildExactSignatureHeader = buildExactSignatureHeader; exports.buildOpenApi = buildOpenApi; exports.buildReceiptHeader = buildReceiptHeader; exports.buildSelfDescription = buildSelfDescription; exports.buildSignatureHeader = buildSignatureHeader; exports.buildWellKnownX402 = buildWellKnownX402; exports.buildX402DnsTxt = buildX402DnsTxt; exports.chainIdForExactNetwork = chainIdForExactNetwork; exports.claim402IndexDomain = claim402IndexDomain; exports.classifyChallenge = classifyChallenge; exports.createPaymentGate = createPaymentGate; exports.decorateOutcome = decorateOutcome; exports.deliverReceipt = deliverReceipt; exports.describeChallenge = describeChallenge; exports.discoveryHeaders = discoveryHeaders; exports.eip3009Abi = eip3009Abi; exports.encodeXPaymentHeader = encodeXPaymentHeader; exports.evaluatePolicy = evaluatePolicy; exports.explainDecline = explainDecline; exports.facilitatorCoverage = facilitatorCoverage; exports.fetchAcross = fetchAcross; exports.firstKeylessFacilitator = firstKeylessFacilitator; exports.formatSpendReport = formatSpendReport; exports.getDirectoryInfo = getDirectoryInfo; exports.isPermit2ProxyChain = isPermit2ProxyChain; exports.knownFacilitatorsFor = knownFacilitatorsFor; exports.normalizeNetwork = normalizeNetwork; exports.parseChallenge = parseChallenge; exports.parseExactPaymentHeader = parseExactPaymentHeader; exports.parseExactRequirements = parseExactRequirements; exports.parseFacilitatorSupported = parseFacilitatorSupported; exports.parseReceipt = parseReceipt; exports.parseSettleResponse = parseSettleResponse; exports.parseSignatureHeader = parseSignatureHeader; exports.paymentTools = paymentTools; exports.pickAccept = pickAccept; exports.planAcross = planAcross; exports.rankResources = rankResources; exports.readExactDomain = readExactDomain; exports.register402Index = register402Index; exports.registerDriver = registerDriver; exports.registerX402Scan = registerX402Scan; exports.renderLandingPage = renderLandingPage; exports.requirePayment = requirePayment; exports.resolveChain = resolveChain; exports.scoreResource = scoreResource; exports.searchOpenIndexes = searchOpenIndexes; exports.settleViaFacilitator = settleViaFacilitator; exports.summarizePlan = summarizePlan; exports.toInsufficientFundsError = _chunkVPENSVOIcjs.toInsufficientFundsError; exports.toInvalidBody = toInvalidBody; exports.verify402IndexDomain = verify402IndexDomain;