@piprail/sdk 2.15.0 → 2.16.0

package/dist/index.js

@@ -4,6 +4,59 @@ import {
 import {
   signReceiptEvm
 } from "./chunk-3SBTJKAG.js";
+import {
+  DEFAULT_EXACT_TRANSFER_METHOD,
+  EXT_OFFER_RECEIPT,
+  EXT_PAYMENT_IDENTIFIER,
+  HEADER_REQUIRED,
+  HEADER_RESPONSE,
+  HEADER_RESPONSE_V1,
+  HEADER_SIGNATURE,
+  HEADER_SIGNATURE_V1,
+  KNOWN_EXACT_TRANSFER_METHODS,
+  buildChallengeHeader,
+  buildExactSignatureHeader,
+  buildPaymentIdentifierAdvertisement,
+  buildReceiptExtension,
+  buildReceiptHeader,
+  buildSignatureHeader,
+  buildUptoSignatureHeader,
+  buildV1PaymentHeader,
+  chainIdFromNetwork,
+  decodeBase64Json,
+  exactTransferMethod,
+  isSettleableExactMethod,
+  networkForChain,
+  normalizeV1Challenge,
+  parseChallenge,
+  parseExactObject,
+  parseExactPaymentHeader,
+  parseReceipt,
+  parseReceiptExtension,
+  parseSettleResponse,
+  parseSignatureHeader,
+  parseSignatureObject,
+  parseUptoObject,
+  parseUptoPaymentHeader,
+  pickAccept,
+  readPaymentIdentifier
+} from "./chunk-C52H5TYB.js";
+import {
+  DIRECTORY_INFO,
+  REGISTER_ATTRIBUTION,
+  appendAttribution,
+  appendKeywords,
+  claim402IndexDomain,
+  decorateOutcome,
+  getDirectoryInfo,
+  normalizeNetwork,
+  rankResources,
+  register402Index,
+  registerX402Scan,
+  scoreResource,
+  searchOpenIndexes,
+  verify402IndexDomain
+} from "./chunk-2CX7XRZK.js";
 import {
   ConfirmationTimeoutError,
   InsufficientFundsError,
@@ -32,7 +85,7 @@ import {
   parseUnits,
   rejectForeignToken,
   toInsufficientFundsError
-} from "./chunk-3ZWM3DKM.js";
+} from "./chunk-QU25LSVS.js";
 
 // src/drivers/registry.ts
 var byFamily = /* @__PURE__ */ new Map();
@@ -896,8 +949,8 @@ async function verifyAndSettleExactEvm(input) {
     try {
       recovered = await recoverTypedDataAddress({
         domain: {
-          name: accept.extra.name,
-          version: accept.extra.version,
+          name: accept.extra?.name,
+          version: accept.extra?.version,
           chainId: chain.id,
           verifyingContract: token
         },
@@ -969,7 +1022,7 @@ async function verifyAndSettleExactEvm(input) {
     );
   }
   try {
-    const confirmations = accept.extra.minConfirmations ?? 1;
+    const confirmations = accept.extra?.minConfirmations ?? 1;
     const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash, confirmations });
     if (receipt.status !== "success") {
       return { ok: false, error: "tx_reverted", detail: `Settlement tx ${txHash} reverted on-chain.` };
@@ -1338,7 +1391,7 @@ async function verifyAndSettlePermit2Evm(input) {
     );
   }
   try {
-    const confirmations = accept.extra.minConfirmations ?? 1;
+    const confirmations = accept.extra?.minConfirmations ?? 1;
     const receipt = await publicClient.waitForTransactionReceipt({ hash: txHash, confirmations });
     if (receipt.status !== "success") {
       return { ok: false, error: "tx_reverted", detail: `Settlement tx ${txHash} reverted on-chain.` };
@@ -1720,318 +1773,6 @@ async function verifyAndSettleUptoEvm(input) {
   };
 }
 
-// src/x402.ts
-var HEADER_REQUIRED = "payment-required";
-var HEADER_SIGNATURE = "payment-signature";
-var HEADER_RESPONSE = "payment-response";
-var HEADER_SIGNATURE_V1 = "x-payment";
-var HEADER_RESPONSE_V1 = "x-payment-response";
-function encodeBase64(str) {
-  if (typeof Buffer !== "undefined") return Buffer.from(str, "utf8").toString("base64");
-  if (typeof btoa === "function" && typeof TextEncoder !== "undefined") {
-    const bytes = new TextEncoder().encode(str);
-    let binary = "";
-    for (let i = 0; i < bytes.length; i++) binary += String.fromCharCode(bytes[i]);
-    return btoa(binary);
-  }
-  throw new Error("No base64 encoder available in this runtime.");
-}
-function decodeBase64(b64) {
-  if (typeof Buffer !== "undefined") return Buffer.from(b64, "base64").toString("utf8");
-  if (typeof atob === "function" && typeof TextDecoder !== "undefined") {
-    const binary = atob(b64);
-    const bytes = new Uint8Array(binary.length);
-    for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
-    return new TextDecoder().decode(bytes);
-  }
-  throw new Error("No base64 decoder available in this runtime.");
-}
-function fromBase64Json(b64) {
-  try {
-    return JSON.parse(decodeBase64(b64));
-  } catch {
-    return null;
-  }
-}
-function decodeBase64Json(value) {
-  return fromBase64Json(value);
-}
-function toBase64Json(value) {
-  return encodeBase64(JSON.stringify(value));
-}
-function networkForChain(chainId) {
-  return `eip155:${chainId}`;
-}
-function chainIdFromNetwork(network) {
-  const match = /^eip155:(\d+)$/.exec(network);
-  if (!match || !match[1]) return null;
-  const n = Number(match[1]);
-  return Number.isSafeInteger(n) && n > 0 ? n : null;
-}
-function buildChallengeHeader(challenge) {
-  return toBase64Json(challenge);
-}
-function buildReceiptHeader(receipt, extensions) {
-  return toBase64Json(extensions ? { ...receipt, extensions } : receipt);
-}
-var EXT_OFFER_RECEIPT = "offer-receipt";
-function buildReceiptExtension(bundle) {
-  const info = { settlement: bundle.receipt, resource: bundle.resource };
-  if (typeof bundle.decimals === "number") info.decimals = bundle.decimals;
-  if (bundle.attestation) info.receipt = bundle.attestation;
-  return { [EXT_OFFER_RECEIPT]: { info } };
-}
-var EXT_PAYMENT_IDENTIFIER = "payment-identifier";
-var PAYMENT_ID_MIN = 16;
-var PAYMENT_ID_MAX = 128;
-var PAYMENT_ID_RE = /^[A-Za-z0-9_-]+$/;
-function buildPaymentIdentifierAdvertisement() {
-  return {
-    [EXT_PAYMENT_IDENTIFIER]: {
-      info: { required: false },
-      schema: { properties: { id: { type: "string", minLength: PAYMENT_ID_MIN, maxLength: PAYMENT_ID_MAX } } }
-    }
-  };
-}
-function readPaymentIdentifier(payload) {
-  if (typeof payload !== "object" || payload === null) return null;
-  const ext = payload.extensions;
-  if (typeof ext !== "object" || ext === null) return null;
-  const block = ext[EXT_PAYMENT_IDENTIFIER];
-  if (typeof block !== "object" || block === null) return null;
-  const info = block.info;
-  if (typeof info !== "object" || info === null) return null;
-  const id = info.id;
-  if (id === void 0) return null;
-  if (typeof id !== "string") return { invalid: "payment-identifier id must be a string" };
-  if (id.length < PAYMENT_ID_MIN || id.length > PAYMENT_ID_MAX) {
-    return { invalid: `payment-identifier id must be ${PAYMENT_ID_MIN}\u2013${PAYMENT_ID_MAX} chars (got ${id.length})` };
-  }
-  if (!PAYMENT_ID_RE.test(id)) {
-    return { invalid: "payment-identifier id must match [A-Za-z0-9_-]" };
-  }
-  return id;
-}
-function buildSignatureHeader(signature) {
-  return toBase64Json(signature);
-}
-function buildExactSignatureHeader(input) {
-  return toBase64Json({ x402Version: 2, accepted: input.accepted, payload: input.payload });
-}
-function buildUptoSignatureHeader(input) {
-  return toBase64Json({ x402Version: 2, accepted: input.accepted, payload: input.payload });
-}
-async function parseChallenge(response) {
-  const headerValue = response.headers.get(HEADER_REQUIRED);
-  if (headerValue) {
-    const parsed = fromBase64Json(headerValue);
-    if (isValidChallenge(parsed)) return parsed;
-  }
-  try {
-    const body = await response.clone().json();
-    if (isValidChallenge(body)) return body;
-  } catch {
-  }
-  return null;
-}
-function parseReceipt(response) {
-  const headerValue = response.headers.get(HEADER_RESPONSE) ?? response.headers.get(HEADER_RESPONSE_V1);
-  if (!headerValue) return null;
-  const parsed = fromBase64Json(headerValue);
-  if (!isValidReceipt(parsed)) return null;
-  const r = parsed;
-  if (typeof r.transaction !== "string" && typeof r.txHash === "string") r.transaction = r.txHash;
-  return r;
-}
-function parseReceiptExtension(response) {
-  const headerValue = response.headers.get(HEADER_RESPONSE) ?? response.headers.get(HEADER_RESPONSE_V1);
-  if (!headerValue) return null;
-  const parsed = fromBase64Json(headerValue);
-  if (!parsed || typeof parsed !== "object") return null;
-  const ext = parsed.extensions;
-  const block = ext?.[EXT_OFFER_RECEIPT];
-  const info = block?.info;
-  if (!info) return null;
-  const settlement = isValidReceipt(info.settlement) ? info.settlement : isValidReceipt(info.receipt) ? info.receipt : void 0;
-  if (!settlement) return null;
-  const attestation = info.receipt && info.receipt !== settlement ? info.receipt : void 0;
-  const res = info.resource;
-  return {
-    piprail: "1",
-    receipt: settlement,
-    resource: { url: res && typeof res.url === "string" ? res.url : "" },
-    ...typeof info.decimals === "number" ? { decimals: info.decimals } : {},
-    ...attestation ? { attestation } : {}
-  };
-}
-function parseSettleResponse(response) {
-  const headerValue = response.headers.get(HEADER_RESPONSE) ?? response.headers.get(HEADER_RESPONSE_V1);
-  if (!headerValue) return null;
-  const parsed = fromBase64Json(headerValue);
-  if (!parsed || typeof parsed !== "object" || typeof parsed.success !== "boolean") return null;
-  return {
-    success: parsed.success,
-    // Tolerate the legacy v1 `txHash` alias for `transaction` (mirrors isValidReceipt/parseReceipt).
-    ...typeof parsed.transaction === "string" ? { transaction: parsed.transaction } : typeof parsed.txHash === "string" ? { transaction: parsed.txHash } : {},
-    ...typeof parsed.network === "string" ? { network: parsed.network } : {},
-    ...typeof parsed.payer === "string" ? { payer: parsed.payer } : {},
-    ...typeof parsed.errorReason === "string" ? { errorReason: parsed.errorReason } : {},
-    // The upto SettleResponse's REQUIRED `amount` (actual settled atomic units) — string
-    // passthrough so the upto buyer records ACTUAL, not MAX. Absent on onchain-proof/exact.
-    ...typeof parsed.amount === "string" ? { amount: parsed.amount } : {}
-  };
-}
-function parseSignatureObject(parsed) {
-  if (!parsed || typeof parsed !== "object") return null;
-  const v = parsed;
-  const accepted = v.accepted;
-  const scheme = accepted?.scheme ?? v.scheme;
-  if (scheme !== "onchain-proof") return null;
-  const payload = v.payload;
-  if (!payload || typeof payload.txHash !== "string" || typeof payload.nonce !== "string") {
-    return null;
-  }
-  if (!accepted) {
-    const synthesized = {
-      scheme: "onchain-proof",
-      ...typeof v.network === "string" ? { network: v.network } : {},
-      ...typeof v.asset === "string" ? { asset: v.asset } : {}
-    };
-    return { ...v, accepted: synthesized, payload };
-  }
-  return parsed;
-}
-function parseSignatureHeader(value) {
-  return parseSignatureObject(fromBase64Json(value));
-}
-function parseExactPaymentHeader(value) {
-  return parseExactObject(fromBase64Json(value));
-}
-function parseExactObject(parsed) {
-  if (!parsed || typeof parsed !== "object") return null;
-  const v = parsed;
-  const accepted = v.accepted ?? null;
-  const scheme = accepted?.scheme ?? v.scheme;
-  if (scheme !== "exact") return null;
-  const network = accepted?.network ?? v.network;
-  if (typeof network !== "string") return null;
-  const payload = v.payload;
-  if (!payload || typeof payload !== "object") return null;
-  const x402Version = typeof v.x402Version === "number" ? v.x402Version : 2;
-  const asset = accepted && typeof accepted.asset === "string" ? accepted.asset : void 0;
-  const base2 = { x402Version, network, ...asset ? { asset } : {}, raw: v };
-  if (typeof payload.signedDelegateAction === "string") {
-    return { ...base2, method: "near", payload: { signedDelegateAction: payload.signedDelegateAction } };
-  }
-  if (typeof payload.transaction === "string" && typeof payload.senderAuth === "string") {
-    return { ...base2, method: "aptos", payload: { transaction: payload.transaction, senderAuth: payload.senderAuth } };
-  }
-  if (typeof payload.transaction === "string") {
-    return { ...base2, method: "svm", payload: { transaction: payload.transaction } };
-  }
-  if (Array.isArray(payload.paymentGroup)) {
-    const group = payload.paymentGroup;
-    const index = payload.paymentIndex;
-    if (group.length === 0 || group.length > 16 || !group.every((t) => typeof t === "string") || typeof index !== "number" || !Number.isInteger(index) || index < 0 || index >= group.length) {
-      return null;
-    }
-    return {
-      ...base2,
-      method: "algorand",
-      payload: { paymentIndex: index, paymentGroup: group }
-    };
-  }
-  const signature = payload.signature;
-  if (typeof signature !== "string") return null;
-  const authorization = payload.authorization;
-  if (authorization && typeof authorization === "object") {
-    for (const k of ["from", "to", "value", "validAfter", "validBefore", "nonce"]) {
-      if (typeof authorization[k] !== "string") return null;
-    }
-    return {
-      ...base2,
-      method: "eip3009",
-      payload: { signature, authorization }
-    };
-  }
-  const p2 = payload.permit2Authorization;
-  if (p2 && typeof p2 === "object") {
-    const permitted = p2.permitted;
-    const witness = p2.witness;
-    if (!permitted || typeof permitted !== "object" || !witness || typeof witness !== "object") return null;
-    if (typeof permitted.token !== "string" || typeof permitted.amount !== "string") return null;
-    if (typeof witness.to !== "string" || typeof witness.validAfter !== "string") return null;
-    for (const k of ["from", "spender", "nonce", "deadline"]) {
-      if (typeof p2[k] !== "string") return null;
-    }
-    return {
-      ...base2,
-      method: "permit2",
-      payload: { signature, permit2Authorization: p2 }
-    };
-  }
-  return null;
-}
-function parseUptoPaymentHeader(value) {
-  return parseUptoObject(fromBase64Json(value));
-}
-function parseUptoObject(parsed) {
-  if (!parsed || typeof parsed !== "object") return null;
-  const v = parsed;
-  const accepted = v.accepted ?? null;
-  const scheme = accepted?.scheme ?? v.scheme;
-  if (scheme !== "upto") return null;
-  const network = accepted?.network ?? v.network;
-  if (typeof network !== "string") return null;
-  const payload = v.payload;
-  if (!payload || typeof payload !== "object") return null;
-  const signature = payload.signature;
-  if (typeof signature !== "string") return null;
-  const p2 = payload.permit2Authorization;
-  if (!p2 || typeof p2 !== "object") return null;
-  const permitted = p2.permitted;
-  const witness = p2.witness;
-  if (!permitted || typeof permitted !== "object" || !witness || typeof witness !== "object") return null;
-  if (typeof permitted.token !== "string" || typeof permitted.amount !== "string") return null;
-  if (typeof witness.to !== "string" || typeof witness.facilitator !== "string" || typeof witness.validAfter !== "string") {
-    return null;
-  }
-  for (const k of ["from", "spender", "nonce", "deadline"]) {
-    if (typeof p2[k] !== "string") return null;
-  }
-  const x402Version = typeof v.x402Version === "number" ? v.x402Version : 2;
-  const asset = accepted && typeof accepted.asset === "string" ? accepted.asset : void 0;
-  const base2 = { x402Version, network, ...asset ? { asset } : {}, raw: v };
-  return {
-    ...base2,
-    method: "permit2-upto",
-    payload: { signature, permit2Authorization: p2 }
-  };
-}
-function isValidChallenge(value) {
-  if (!value || typeof value !== "object") return false;
-  const v = value;
-  if (v.x402Version !== 2) return false;
-  if (!Array.isArray(v.accepts) || v.accepts.length === 0) return false;
-  if (!v.accepts.every((a) => a !== null && typeof a === "object")) return false;
-  if (!v.resource || typeof v.resource !== "object") return false;
-  return true;
-}
-function isValidReceipt(value) {
-  if (!value || typeof value !== "object") return false;
-  const v = value;
-  if (v.scheme !== "onchain-proof" && v.scheme !== "exact" && v.scheme !== "upto") return false;
-  if (typeof v.transaction !== "string" && typeof v.txHash !== "string") return false;
-  if (typeof v.payer !== "string") return false;
-  return true;
-}
-function pickAccept(challenge, matches) {
-  for (const accept of challenge.accepts) {
-    if (accept.scheme === "onchain-proof" && matches(accept.network)) return accept;
-  }
-  return null;
-}
-
 // src/drivers/evm/index.ts
 var evmDriver = {
   family: "evm",
@@ -2260,7 +2001,7 @@ function makeEvmNetwork(resolved) {
     // Throws UnsupportedSchemeError for a contract signer (or a non-EIP-3009 token on the eip3009 path).
     async payExact(wallet, accept) {
       const a = wallet._native;
-      const method = accept.extra.assetTransferMethod;
+      const method = exactTransferMethod(accept);
       if (method === "permit2" || method === "permit2-exact") {
         const { payload: payload2, payerFrom: payerFrom2, nonce: nonce2 } = await payPermit2Evm({
           publicClient,
@@ -2296,7 +2037,19 @@ function makeEvmNetwork(resolved) {
       return resolveExactRailEvm({
         asset,
         method,
-        readDomain: (a) => readExactDomain(publicClient, a),
+        // `readExactDomain` fails CLOSED to null on two very different causes: the token really
+        // isn't EIP-3009, or the RPC read blipped (rate-limit, timeout, an HTML error page from a
+        // proxy). Treating a blip as "not EIP-3009" silently downgrades a perfectly good gasless
+        // rail to onchain-proof — the merchant's buyers start paying gas and the warning blames
+        // their TOKEN, which is the one thing that isn't wrong. The buyer side already retries
+        // once for exactly this reason (see payExactEvm); the gate side did not, so a rate-limited
+        // public RPC could turn real Base USDC into "this token isn't EIP-3009". Mirror it.
+        readDomain: async (a) => {
+          const first = await readExactDomain(publicClient, a);
+          if (first) return first;
+          await new Promise((r) => setTimeout(r, 300));
+          return readExactDomain(publicClient, a);
+        },
         permit2Supported: () => isPermit2ProxyChain(resolved.chainId)
       });
     },
@@ -2321,6 +2074,9 @@ function makeEvmNetwork(resolved) {
       if ("signedDelegateAction" in payload) {
         return { ok: false, error: "signature_invalid", detail: "A NEAR payload was submitted to an EVM exact rail." };
       }
+      if ("signedTxBlob" in payload) {
+        return { ok: false, error: "signature_invalid", detail: "An XRPL payload was submitted to an EVM exact rail." };
+      }
       return verifyAndSettleExactEvm({
         publicClient,
         walletClient: a.walletClient,
@@ -2382,7 +2138,7 @@ var loaders = {
   solana: async () => {
     let mod;
     try {
-      mod = await import("./solana-MB6G3OA5.js");
+      mod = await import("./solana-HTKDRTD3.js");
     } catch (cause) {
       throw new MissingDriverError(
         `Solana selected, but its packages aren't installed. Run: npm install @solana/web3.js @solana/spl-token bs58`,
@@ -2394,7 +2150,7 @@ var loaders = {
   ton: async () => {
     let mod;
     try {
-      mod = await import("./ton-EJMGM3YI.js");
+      mod = await import("./ton-WH2JVQOO.js");
     } catch (cause) {
       throw new MissingDriverError(
         `TON selected, but its packages aren't installed. Run: npm install @ton/ton @ton/core @ton/crypto`,
@@ -2406,7 +2162,7 @@ var loaders = {
   stellar: async () => {
     let mod;
     try {
-      mod = await import("./stellar-WDWSYOED.js");
+      mod = await import("./stellar-EUFZLX6J.js");
     } catch (cause) {
       throw new MissingDriverError(
         `Stellar selected, but its package isn't installed. Run: npm install @stellar/stellar-sdk`,
@@ -2418,7 +2174,7 @@ var loaders = {
   xrpl: async () => {
     let mod;
     try {
-      mod = await import("./xrpl-Q2UWPCTJ.js");
+      mod = await import("./xrpl-RUOB37QH.js");
     } catch (cause) {
       throw new MissingDriverError(
         `XRPL selected, but its package isn't installed. Run: npm install xrpl`,
@@ -2430,7 +2186,7 @@ var loaders = {
   tron: async () => {
     let mod;
     try {
-      mod = await import("./tron-VAPVMGJK.js");
+      mod = await import("./tron-FXBXDNEY.js");
     } catch (cause) {
       throw new MissingDriverError(
         `Tron selected, but its package isn't installed. Run: npm install tronweb`,
@@ -2442,7 +2198,7 @@ var loaders = {
   sui: async () => {
     let mod;
     try {
-      mod = await import("./sui-GVSFNNJX.js");
+      mod = await import("./sui-KCIITCYH.js");
     } catch (cause) {
       throw new MissingDriverError(
         `Sui selected, but its package isn't installed. Run: npm install @mysten/sui`,
@@ -2454,7 +2210,7 @@ var loaders = {
   near: async () => {
     let mod;
     try {
-      mod = await import("./near-YA4Y4IGC.js");
+      mod = await import("./near-OLKCMTBI.js");
     } catch (cause) {
       throw new MissingDriverError(
         `NEAR selected, but its package isn't installed. Run: npm install near-api-js`,
@@ -2466,7 +2222,7 @@ var loaders = {
   aptos: async () => {
     let mod;
     try {
-      mod = await import("./aptos-J7QGCWNW.js");
+      mod = await import("./aptos-SBV6SGDP.js");
     } catch (cause) {
       throw new MissingDriverError(
         `Aptos selected, but its package isn't installed. Run: npm install @aptos-labs/ts-sdk`,
@@ -2478,7 +2234,7 @@ var loaders = {
   algorand: async () => {
     let mod;
     try {
-      mod = await import("./algorand-CSEUTWNW.js");
+      mod = await import("./algorand-25FMBCT3.js");
     } catch (cause) {
       throw new MissingDriverError(
         `Algorand selected, but its package isn't installed. Run: npm install algosdk`,
@@ -2510,619 +2266,6 @@ async function resolveNetwork2(opts) {
   return resolveNetwork(opts);
 }
 
-// src/indexes.ts
-var DIRECTORY_INFO = Object.freeze({
-  "402index": {
-    source: "402index",
-    review: "probe-sync",
-    auth: "none",
-    chains: null,
-    onSuccess: "pending-review",
-    readByDiscover: true,
-    caveat: "402 Index probes your URL on submit (rejecting anything that does not return a real 402), then lists it \u2014 a self-registered resource becomes searchable once it passes automated health + payment-validity checks, with NO domain verification required (observed live: searchable within ~2 days for a healthy endpoint). Verify your domain on 402index.io for instant, guaranteed approval + a verified badge, which also flips every pending listing on that domain live at once."
-  },
-  x402scan: {
-    source: "x402scan",
-    review: "probe-sync",
-    auth: "siwx",
-    chains: ["eip155:8453", "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],
-    onSuccess: "live",
-    readByDiscover: false,
-    caveat: "x402scan lists Base/Solana only, needs one wallet signature (SIWX), and requires a resolvable input schema (from /openapi.json or the bazaar extension in the 402 body). It goes live on x402scan.com immediately on success \u2014 but discover() does NOT read x402scan, so the listing won't appear in discover() results."
-  },
-  bazaar: {
-    source: "bazaar",
-    review: "settle-coupled",
-    auth: "facilitator-only",
-    chains: null,
-    onSuccess: "not-listable",
-    readByDiscover: true,
-    caveat: "CDP Bazaar has no register endpoint \u2014 it catalogs a resource only when its own facilitator settles a payment. PipRail verifies locally with no facilitator, so a PipRail resource cannot be listed here (you can still READ Bazaar to find others). List on 402 Index or x402scan instead."
-  }
-});
-function getDirectoryInfo(source) {
-  return DIRECTORY_INFO[source];
-}
-function decorateOutcome(o) {
-  const info = DIRECTORY_INFO[o.source];
-  return { ...o, visibility: o.visibility ?? (o.ok ? info.onSuccess : "not-listable"), note: info.caveat };
-}
-var BAZAAR_URL = "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources";
-var INDEX402_SEARCH = "https://402index.io/api/v1/services";
-var INDEX402_REGISTER = "https://402index.io/api/v1/register";
-var INDEX402_CLAIM = "https://402index.io/api/v1/claim";
-var INDEX402_VERIFY = "https://402index.io/api/v1/claim/verify";
-var X402SCAN_REGISTER = "https://www.x402scan.com/api/x402/registry/register";
-var USER_AGENT = "@piprail/sdk (+https://piprail.com)";
-function clientHeaders(extra = {}) {
-  return { "user-agent": USER_AGENT, ...extra };
-}
-var SLUG_TO_CAIP2 = {
-  // EVM (the common index-reported slugs; others fall through to net.supports)
-  ethereum: "eip155:1",
-  base: "eip155:8453",
-  polygon: "eip155:137",
-  arbitrum: "eip155:42161",
-  optimism: "eip155:10",
-  avalanche: "eip155:43114",
-  bnb: "eip155:56",
-  bsc: "eip155:56",
-  // non-EVM families — values mirror each driver's bound caip2 exactly
-  solana: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
-  ton: "tvm:-239",
-  tron: "tron:mainnet",
-  near: "near:mainnet",
-  sui: "sui:mainnet",
-  aptos: "aptos:1",
-  algorand: "algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8=",
-  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 SLUG_TO_CAIP2[network.toLowerCase()] ?? network;
-}
-async function searchOpenIndexes(opts = {}) {
-  const sources = opts.sources ?? ["bazaar", "402index"];
-  const limit = opts.limit ?? 20;
-  const filters = {
-    ...optionalRaw("category", opts.category),
-    ...optionalRaw("asset", opts.asset),
-    ...optionalRaw("maxPrice", opts.maxPrice),
-    ...optionalRaw("verified", opts.verified),
-    ...optionalRaw("paymentValid", opts.paymentValid),
-    ...optionalRaw("sort", opts.sort),
-    ...optionalRaw("order", opts.order)
-  };
-  const results = await Promise.all(
-    sources.map((source) => {
-      if (source === "bazaar") return safeSearch(() => searchBazaar(opts.query, limit, opts.signal));
-      if (source === "402index") return safeSearch(() => search402Index(opts.query, limit, filters, opts.signal));
-      return Promise.resolve([]);
-    })
-  );
-  const merged = applyClientFilters(dedupeByResource(results.flat()), opts);
-  const wantRelevance = opts.query !== void 0 && (opts.sort ?? "relevance") === "relevance";
-  if (wantRelevance) return rankResources(merged, opts.query);
-  if (opts.sort && opts.sort !== "relevance") return sortResources(merged, opts.sort, opts.order ?? "desc");
-  return merged;
-}
-function optionalRaw(field, value) {
-  return value !== void 0 ? { [field]: value } : {};
-}
-function applyClientFilters(items, opts) {
-  let out = items;
-  if (opts.category) {
-    const want = opts.category.toLowerCase();
-    out = out.filter((r) => r.category !== void 0 && r.category.toLowerCase().startsWith(want));
-  }
-  if (opts.maxPrice !== void 0) {
-    const max = opts.maxPrice;
-    out = out.filter((r) => r.priceUsd === void 0 || r.priceUsd <= max);
-  }
-  if (opts.asset) {
-    const want = opts.asset.toLowerCase();
-    out = out.filter((r) => {
-      const known = r.rails.map((x) => x.symbol ?? x.asset).filter((a) => !!a);
-      return known.length === 0 || known.some((a) => a.toLowerCase() === want);
-    });
-  }
-  if (opts.minReliability !== void 0) {
-    const min = opts.minReliability;
-    out = out.filter((r) => r.reliabilityScore === void 0 || r.reliabilityScore >= min);
-  }
-  return out;
-}
-function tokenize(s) {
-  return (s ?? "").toLowerCase().match(/[a-z0-9]+/g) ?? [];
-}
-var FIELD_WEIGHTS = { name: 6, category: 4, tags: 4, path: 3, description: 2 };
-function fieldTokens(r) {
-  let pathText = r.resource;
-  try {
-    const u = new URL(r.resource);
-    pathText = `${u.hostname} ${u.pathname}`;
-  } catch {
-  }
-  return [
-    [tokenize(r.name), FIELD_WEIGHTS.name],
-    [tokenize(r.category), FIELD_WEIGHTS.category],
-    [tokenize((r.tags ?? []).join(" ")), FIELD_WEIGHTS.tags],
-    [tokenize(pathText), FIELD_WEIGHTS.path],
-    [tokenize(r.description), FIELD_WEIGHTS.description]
-  ];
-}
-function scoreResource(r, queryTokens) {
-  if (queryTokens.length === 0) return 0;
-  const fields = fieldTokens(r);
-  let score = 0;
-  let matched = 0;
-  for (const qt of queryTokens) {
-    let hit = false;
-    for (const [toks, w] of fields) {
-      if (toks.includes(qt)) {
-        score += w;
-        hit = true;
-      } else if (qt.length >= 4 && toks.some((t) => t.startsWith(qt) || t.length >= 4 && qt.startsWith(t))) {
-        score += w * 0.4;
-        hit = true;
-      }
-    }
-    if (hit) matched++;
-  }
-  if (matched === 0) return 0;
-  if (matched === queryTokens.length) score += 8;
-  if (r.reliabilityScore !== void 0) score += r.reliabilityScore / 1e3;
-  return score;
-}
-function rankResources(items, query) {
-  const qTokens = tokenize(query);
-  if (qTokens.length === 0) return items;
-  return items.map((r, i) => ({ r, i, s: scoreResource(r, qTokens) })).filter((x) => x.s > 0).sort((a, b) => b.s - a.s || a.i - b.i).map((x) => ({ ...x.r, score: x.s }));
-}
-function sortResources(items, sort, order) {
-  const dir = order === "asc" ? 1 : -1;
-  const key = (r) => sort === "reliability" || sort === "uptime" ? r.reliabilityScore : sort === "price" ? r.priceUsd : sort === "name" ? (r.name ?? r.resource).toLowerCase() : void 0;
-  return items.map((r, i) => ({ r, i })).sort((a, b) => {
-    const ka = key(a.r);
-    const kb = key(b.r);
-    if (ka === void 0 && kb === void 0) return a.i - b.i;
-    if (ka === void 0) return 1;
-    if (kb === void 0) return -1;
-    if (ka < kb) return -1 * dir;
-    if (ka > kb) return 1 * dir;
-    return a.i - b.i;
-  }).map((x) => x.r);
-}
-async function safeSearch(run) {
-  try {
-    return await run();
-  } catch {
-    return [];
-  }
-}
-function dedupeByResource(items) {
-  const seen = /* @__PURE__ */ new Set();
-  const out = [];
-  for (const it of items) {
-    const key = it.resource;
-    if (!key || seen.has(key)) continue;
-    seen.add(key);
-    out.push(it);
-  }
-  return out;
-}
-async function searchBazaar(query, limit, signal) {
-  const res = await fetch(`${BAZAAR_URL}?limit=${encodeURIComponent(String(limit))}`, {
-    headers: clientHeaders({ accept: "application/json" }),
-    ...signal ? { signal } : {}
-  });
-  if (!res.ok) return [];
-  const body = await res.json();
-  const items = Array.isArray(body.items) ? body.items : [];
-  const mapped = items.map(mapBazaarItem).filter((r) => r !== null);
-  return query ? mapped.filter((r) => matchesQuery(r, query)) : mapped;
-}
-function mapBazaarItem(raw) {
-  if (!raw || typeof raw !== "object") return null;
-  const o = raw;
-  const resource = pickString(o, "resource", "url", "endpoint");
-  if (!resource) return null;
-  const meta = o.metadata && typeof o.metadata === "object" ? o.metadata : {};
-  return {
-    resource,
-    source: "bazaar",
-    rails: mapRails(o.accepts),
-    ...optionalString("name", pickString(meta, "name", "title")),
-    ...optionalString("description", pickString(meta, "description") ?? pickString(o, "description")),
-    ...optionalString("category", pickString(meta, "category"))
-  };
-}
-async function search402Index(query, limit, filters, signal) {
-  const tokens = tokenize(query);
-  const queries = query && tokens.length > 1 ? [.../* @__PURE__ */ new Set([query, ...tokens])].slice(0, 5) : [query];
-  const pages = await Promise.all(queries.map((q) => safeSearch(() => fetch402Page(q, limit, filters, signal))));
-  return dedupeByResource(pages.flat());
-}
-async function fetch402Page(query, limit, filters, signal) {
-  const qs = new URLSearchParams({ limit: String(limit) });
-  if (query) qs.set("q", query);
-  if (filters.category) qs.set("category", filters.category);
-  if (filters.asset) qs.set("payment_asset", filters.asset);
-  if (filters.maxPrice !== void 0) qs.set("max_price_usd", String(filters.maxPrice));
-  if (filters.verified) qs.set("verified", "true");
-  if (filters.paymentValid) qs.set("payment_valid", "true");
-  if (filters.sort && filters.sort !== "relevance") {
-    qs.set("sort", filters.sort);
-    qs.set("order", filters.order ?? "desc");
-  }
-  const res = await fetch(`${INDEX402_SEARCH}?${qs.toString()}`, {
-    headers: clientHeaders({ accept: "application/json" }),
-    ...signal ? { signal } : {}
-  });
-  if (!res.ok) return [];
-  const body = await res.json();
-  const list = firstArray(body, "services", "results", "items", "data");
-  return list.map(map402IndexItem).filter((r) => r !== null).filter((r) => r.rails.length > 0);
-}
-function map402IndexItem(raw) {
-  if (!raw || typeof raw !== "object") return null;
-  const o = raw;
-  const resource = pickString(o, "url", "resource", "endpoint");
-  if (!resource) return null;
-  const protocol = (pickString(o, "protocol") ?? "x402").toLowerCase();
-  if (protocol !== "x402") return null;
-  const rails = Array.isArray(o.accepts) ? mapRails(o.accepts) : railFrom402IndexFields(o);
-  const priceUsd = pickNumber(o, "price_usd", "priceUsd", "price");
-  const reliabilityScore = pickNumber(o, "reliability_score", "reliabilityScore");
-  const tags = pickStringArray(o, "tags", "keywords");
-  return {
-    resource,
-    source: "402index",
-    rails,
-    ...priceUsd !== void 0 ? { priceUsd } : {},
-    ...reliabilityScore !== void 0 ? { reliabilityScore } : {},
-    ...tags ? { tags } : {},
-    ...optionalString("name", pickString(o, "name", "title")),
-    ...optionalString("description", pickString(o, "description")),
-    ...optionalString("category", pickString(o, "category", "tag")),
-    ...optionalString("health", pickString(o, "health_status", "health")),
-    // 402 Index reports domain_verified as 0/1; surface a boolean only when the field is present.
-    ...o.domain_verified !== void 0 || o.verified !== void 0 ? { verified: isTruthyFlag(o.domain_verified) || isTruthyFlag(o.verified) } : {}
-  };
-}
-function isTruthyFlag(v) {
-  return v === 1 || v === true || v === "1" || v === "true";
-}
-function railFrom402IndexFields(o) {
-  const network = pickString(o, "payment_network", "network");
-  const asset = pickString(o, "payment_asset", "asset", "token");
-  if (!network && !asset) return [];
-  return [
-    {
-      scheme: "exact",
-      network: network ?? "unknown",
-      ...asset ? { asset } : {},
-      ...optionalString("symbol", asset)
-    }
-  ];
-}
-async function register402Index(input) {
-  try {
-    const attributionOn = input.attribution !== false;
-    const withTags = appendKeywords(input.description, input.tags);
-    const description = attributionOn ? appendAttribution(withTags) : withTags;
-    const payload = {
-      url: input.url,
-      name: input.name ?? hostOf(input.url),
-      protocol: "x402",
-      ...description ? { description } : {},
-      ...typeof input.priceUsd === "number" ? { price_usd: input.priceUsd } : {},
-      ...input.asset ? { payment_asset: input.asset } : {},
-      ...input.network ? { payment_network: input.network } : {},
-      ...input.method ? { http_method: input.method.toUpperCase() } : {},
-      ...input.category ? { category: input.category } : {},
-      ...input.tags && input.tags.length > 0 ? { tags: input.tags } : {},
-      ...input.provider ? { provider: input.provider } : {},
-      ...input.contactEmail ? { contact_email: input.contactEmail } : {},
-      ...input.probeBody !== void 0 ? { probe_body: input.probeBody } : {},
-      ...attributionOn ? { via: "@piprail/sdk" } : {}
-    };
-    const res = await fetch(INDEX402_REGISTER, {
-      method: "POST",
-      headers: clientHeaders({ "content-type": "application/json", accept: "application/json" }),
-      body: JSON.stringify(payload)
-    });
-    if (res.ok) {
-      const body = await res.json().catch(() => ({}));
-      const msg = typeof body.message === "string" && body.message.length > 0 ? body.message : void 0;
-      const live = body.service?.status === "active";
-      return {
-        source: "402index",
-        ok: true,
-        status: res.status,
-        ...live ? { visibility: "live" } : {},
-        detail: msg ?? (live ? "Registered + live on 402 Index (domain verified)." : "Registered on 402 Index \u2014 probed on submit, then searchable once it passes automated health + payment checks (verify your domain on 402index.io for instant approval + a verified badge).")
-      };
-    }
-    const why = await readIndexError(res);
-    return {
-      source: "402index",
-      ok: false,
-      status: res.status,
-      detail: why ? `402 Index rejected it (HTTP ${res.status}): ${why}` : `402 Index returned HTTP ${res.status}.`
-    };
-  } catch (err) {
-    return { source: "402index", ok: false, detail: errMsg(err) };
-  }
-}
-async function readIndexError(res) {
-  try {
-    const body = await res.json();
-    const parts = [body.error, body.detail, body.message].filter(
-      (p) => typeof p === "string" && p.length > 0
-    );
-    return parts.length ? [...new Set(parts)].join(" \u2014 ") : void 0;
-  } catch {
-    return void 0;
-  }
-}
-async function registerX402Scan(input, signer) {
-  try {
-    const challengeRes = await fetch(X402SCAN_REGISTER, {
-      method: "POST",
-      headers: clientHeaders({ "content-type": "application/json", accept: "application/json" }),
-      body: JSON.stringify({ url: input.url })
-    });
-    if (challengeRes.status !== 402) {
-      return {
-        source: "x402scan",
-        ok: challengeRes.ok,
-        status: challengeRes.status,
-        detail: challengeRes.ok ? "Listed on x402scan." : `x402scan returned HTTP ${challengeRes.status} (expected a SIWX 402 challenge).`
-      };
-    }
-    const info = await readSiwxInfo(challengeRes);
-    if (!info) {
-      return { source: "x402scan", ok: false, status: 402, detail: "x402scan SIWX challenge was unparseable." };
-    }
-    const resolvedInfo = { ...info, issuedAt: info.issuedAt ?? (/* @__PURE__ */ new Date()).toISOString() };
-    const message = formatSiweMessage(resolvedInfo, signer.address);
-    const signature = await signer.signMessage(message);
-    const header = encodeBase642(
-      JSON.stringify({ ...resolvedInfo, address: signer.address, type: "eip191", message, signature })
-    );
-    const res = await fetch(X402SCAN_REGISTER, {
-      method: "POST",
-      headers: clientHeaders({
-        "content-type": "application/json",
-        accept: "application/json",
-        "sign-in-with-x": header
-      }),
-      body: JSON.stringify({ url: input.url })
-    });
-    if (res.ok) {
-      return { source: "x402scan", ok: true, status: res.status, detail: "Listed on x402scan (SIWX)." };
-    }
-    const why = await readIndexError(res);
-    return {
-      source: "x402scan",
-      ok: false,
-      status: res.status,
-      detail: why ? `x402scan rejected it (HTTP ${res.status}): ${why}` : `x402scan returned HTTP ${res.status} after signing.`
-    };
-  } catch (err) {
-    return { source: "x402scan", ok: false, detail: errMsg(err) };
-  }
-}
-async function claim402IndexDomain(domainOrUrl, opts = {}) {
-  const domain = hostOf(domainOrUrl);
-  try {
-    const res = await fetch(INDEX402_CLAIM, {
-      method: "POST",
-      headers: clientHeaders({ "content-type": "application/json", accept: "application/json" }),
-      body: JSON.stringify({ domain, ...opts.contactEmail ? { contact_email: opts.contactEmail } : {} })
-    });
-    const body = await res.json().catch(() => ({}));
-    if (!res.ok) {
-      return { ok: false, domain, httpStatus: res.status, detail: pickString(body, "error", "detail", "message") ?? `402 Index claim returned HTTP ${res.status}.` };
-    }
-    const verificationToken = pickString(body, "verification_token");
-    const verificationHash = pickString(body, "verification_hash") ?? (verificationToken ? await sha256Hex(verificationToken) : void 0);
-    return {
-      ok: true,
-      domain,
-      httpStatus: res.status,
-      ...optionalString("verificationHash", verificationHash),
-      ...optionalString("verificationToken", verificationToken),
-      ...optionalString("verificationUrl", pickString(body, "verification_url")),
-      ...optionalString("instructions", pickString(body, "instructions"))
-    };
-  } catch (err) {
-    return { ok: false, domain, detail: errMsg(err) };
-  }
-}
-async function sha256Hex(input) {
-  const digest = await globalThis.crypto.subtle.digest("SHA-256", new TextEncoder().encode(input));
-  return Array.from(new Uint8Array(digest)).map((b) => b.toString(16).padStart(2, "0")).join("");
-}
-async function verify402IndexDomain(domainOrUrl) {
-  const domain = hostOf(domainOrUrl);
-  try {
-    const res = await fetch(INDEX402_VERIFY, {
-      method: "POST",
-      headers: clientHeaders({ "content-type": "application/json", accept: "application/json" }),
-      body: JSON.stringify({ domain })
-    });
-    const body = await res.json().catch(() => ({}));
-    if (!res.ok) {
-      return { ok: false, domain, httpStatus: res.status, detail: pickString(body, "error", "detail", "message") ?? `402 Index verify returned HTTP ${res.status}.` };
-    }
-    return {
-      ok: true,
-      domain,
-      httpStatus: res.status,
-      ...optionalString("status", pickString(body, "status")),
-      ...typeof body.services_count === "number" ? { servicesCount: body.services_count } : {}
-    };
-  } catch (err) {
-    return { ok: false, domain, detail: errMsg(err) };
-  }
-}
-async function readSiwxInfo(res) {
-  try {
-    const body = await res.json();
-    const ext = body.extensions;
-    const siwx = ext?.["sign-in-with-x"];
-    const info = siwx?.info ?? siwx;
-    if (info && info.chainId == null && Array.isArray(siwx?.supportedChains)) {
-      const evm = siwx.supportedChains.find(
-        (c) => typeof c?.chainId === "string" && c.chainId.startsWith("eip155:")
-      );
-      if (evm && typeof evm.chainId === "string") info.chainId = evm.chainId;
-    }
-    if (info && typeof info.domain === "string" && info.domain.length > 0 && typeof info.nonce === "string" && info.nonce.length > 0 && typeof info.uri === "string" && info.uri.length > 0) {
-      return info;
-    }
-    return null;
-  } catch {
-    return null;
-  }
-}
-function formatSiweMessage(info, address) {
-  const chainId = info.chainId ? caip2ToChainId(info.chainId) : 1;
-  const statement = info.statement && info.statement.trim() ? info.statement : void 0;
-  const lines = [
-    `${info.domain} wants you to sign in with your Ethereum account:`,
-    address,
-    "",
-    ...statement ? [statement, ""] : [""],
-    `URI: ${info.uri}`,
-    "Version: 1",
-    `Chain ID: ${chainId}`,
-    `Nonce: ${info.nonce}`,
-    `Issued At: ${info.issuedAt}`,
-    ...info.expirationTime ? [`Expiration Time: ${info.expirationTime}`] : []
-  ];
-  return lines.join("\n");
-}
-function caip2ToChainId(caip2) {
-  const m = /^eip155:(\d+)$/.exec(caip2);
-  const n = m ? Number(m[1]) : Number(caip2);
-  return Number.isSafeInteger(n) && n > 0 ? n : 1;
-}
-function mapRails(accepts) {
-  if (!Array.isArray(accepts)) return [];
-  const out = [];
-  for (const raw of accepts) {
-    if (!raw || typeof raw !== "object") continue;
-    const a = raw;
-    const network = pickString(a, "network");
-    if (!network) continue;
-    const extra = a.extra && typeof a.extra === "object" ? a.extra : {};
-    out.push({
-      scheme: pickString(a, "scheme") ?? "exact",
-      network,
-      ...optionalString("asset", pickString(a, "asset")),
-      ...optionalString("amount", pickString(a, "amount", "maxAmountRequired")),
-      ...optionalString("payTo", pickString(a, "payTo")),
-      ...optionalString("symbol", pickString(extra, "symbol"))
-    });
-  }
-  return out;
-}
-function matchesQuery(r, query) {
-  const haystack = [r.name, r.description, r.category, (r.tags ?? []).join(" "), r.resource].filter(Boolean).join(" ").toLowerCase();
-  if (haystack.includes(query.toLowerCase())) return true;
-  const qTokens = tokenize(query);
-  const hayTokens = new Set(tokenize(haystack));
-  return qTokens.some((t) => hayTokens.has(t));
-}
-function pickStringArray(o, ...keys) {
-  for (const k of keys) {
-    const v = o[k];
-    if (Array.isArray(v)) {
-      const arr = v.filter((x) => typeof x === "string" && x.length > 0);
-      if (arr.length) return arr;
-    } else if (typeof v === "string" && v.trim()) {
-      const arr = v.split(/[,\s]+/).filter((x) => x.length > 0);
-      if (arr.length) return arr;
-    }
-  }
-  return void 0;
-}
-function pickString(o, ...keys) {
-  for (const k of keys) {
-    const v = o[k];
-    if (typeof v === "string" && v.length > 0) return v;
-  }
-  return void 0;
-}
-function pickNumber(o, ...keys) {
-  for (const k of keys) {
-    const v = o[k];
-    if (typeof v === "number" && Number.isFinite(v)) return v;
-    if (typeof v === "string" && /^\d+(\.\d+)?$/.test(v.trim())) {
-      const n = Number(v.trim());
-      if (Number.isFinite(n)) return n;
-    }
-  }
-  return void 0;
-}
-function optionalString(field, value) {
-  return value !== void 0 ? { [field]: value } : {};
-}
-function firstArray(o, ...keys) {
-  for (const k of keys) {
-    if (Array.isArray(o[k])) return o[k];
-  }
-  return Array.isArray(o) ? o : [];
-}
-function hostOf(url) {
-  try {
-    const withScheme = /^[a-z][a-z0-9+.-]*:\/\//i.test(url) ? url : `https://${url}`;
-    return new URL(withScheme).hostname || url;
-  } catch {
-    return url;
-  }
-}
-function errMsg(err) {
-  return err instanceof Error ? err.message : String(err);
-}
-var REGISTER_ATTRIBUTION = "\xB7 Built with @piprail/sdk";
-function appendAttribution(description) {
-  if (!description) return description;
-  if (/piprail/i.test(description)) return description;
-  const next = `${description.trimEnd()} ${REGISTER_ATTRIBUTION}`;
-  return next.length <= 500 ? next : description;
-}
-function appendKeywords(description, tags) {
-  const clean = (tags ?? []).map((t) => t.trim()).filter((t) => t.length > 0);
-  if (clean.length === 0) return description;
-  const have = (description ?? "").toLowerCase();
-  const fresh = [...new Set(clean.filter((t) => !have.includes(t.toLowerCase())))];
-  if (fresh.length === 0) return description;
-  const tail = `Keywords: ${fresh.join(", ")}`;
-  if (!description) return tail;
-  const next = `${description.trimEnd()} \xB7 ${tail}`;
-  return next.length <= 500 ? next : description;
-}
-function encodeBase642(str) {
-  if (typeof Buffer !== "undefined") return Buffer.from(str, "utf8").toString("base64");
-  if (typeof btoa === "function" && typeof TextEncoder !== "undefined") {
-    const bytes = new TextEncoder().encode(str);
-    let binary = "";
-    for (let i = 0; i < bytes.length; i++) binary += String.fromCharCode(bytes[i]);
-    return btoa(binary);
-  }
-  throw new Error("No base64 encoder available in this runtime.");
-}
-
 // src/policy.ts
 var DENOM_PRECISION = MAX_DECIMALS;
 var BUILTIN_DENOMS = {
@@ -4086,7 +3229,7 @@ var PipRailClient = class {
    * - Results are cross-scheme (mostly the mainstream `exact` scheme); `fetch()` pays
    *   `onchain-proof` rails by default, and standard `exact` rails too once you opt in
    *   with `schemes: ['onchain-proof', 'exact']` (EVM EIP-3009/Permit2 + Solana SVM + Algorand
-   *   + Aptos + NEAR).
+   *   + Aptos + NEAR + XRPL native XRP).
    */
   async discover(opts = {}) {
     const found = await searchOpenIndexes({
@@ -4261,7 +3404,7 @@ var PipRailClient = class {
       return this.payUptoRail(net, wallet, accept, url, init, quote);
     }
     if (accept.scheme === "exact") {
-      return this.payExactRail(net, wallet, accept, url, init, quote);
+      return this.payExactRail(net, wallet, accept, url, init, quote, challenge.x402Version);
     }
     if (accept.scheme !== "onchain-proof") {
       throw new UnsupportedSchemeError(
@@ -4347,15 +3490,35 @@ var PipRailClient = class {
     if (schemes.includes("exact")) {
       out.push(
         ...challenge.accepts.filter(
-          (a) => a.scheme === "exact" && this.supportsNetwork(net, a.network) && typeof net.payExact === "function" && // `native` is never `exact`-payable on ANY family (exact = an EIP-3009/Permit2-style
-          // signed-authorization scheme a native coin can't support; every driver's payExact
-          // throws/returns-null for it). describeAsset('native') IS non-null (onchain-proof needs
-          // it), so without this guard a malformed 402 advertising a native `exact` rail would be
-          // gathered, planned `payable`, even chosen by autoRoute — then throw at pay time.
-          a.asset !== "native" && // the exact pay path (payExact → driver) reads `extra.assetTransferMethod`; a malformed
-          // 402 offering an exact rail for a RECOGNISED token but omitting `extra` would otherwise
-          // be planned payable then throw a raw TypeError mid-pay. Require it at gather time.
-          typeof a.extra?.assetTransferMethod === "string" && net.describeAsset(a.asset) != null && // a foreign rail's maxTimeoutSeconds must be a usable positive integer, or
+          (a) => a.scheme === "exact" && this.supportsNetwork(net, a.network) && typeof net.payExact === "function" && /*
+           * Can this family sign an `exact` payment for THIS asset?
+           *
+           * The default — for every family that doesn't say otherwise — is "any recognised token
+           * yes, the native coin no". `exact` is an EIP-3009/Permit2-style signed-authorization
+           * scheme a native coin can't carry, and `describeAsset('native')` IS non-null
+           * (onchain-proof needs it), so without the rule a 402 advertising a native exact rail
+           * would gather, plan `payable`, even win autoRoute — then throw at pay time.
+           *
+           * XRPL is the first family to overturn it, in BOTH directions. There an `exact` payment
+           * is simply a fully signed `Payment`, so native XRP is the most natural thing to send —
+           * 863 of its 1,732 live rails are priced in XRP. Its ISSUED currencies are excluded
+           * instead: they state a decimal `value` on the wire while the spend policy caps in base
+           * units, so pricing one as base units would let a 12-RLUSD rail slip under any cap.
+           * A driver that declares `exactPayableAsset` replaces this rule for all of its assets.
+           */
+          (net.exactPayableAsset ? net.exactPayableAsset(a.asset) : a.asset !== "native") && /*
+           * The rail's transfer method must be one a driver can sign — but an ABSENT method is
+           * not an unknown one. `scheme_exact_evm.md`: "If no `assetTransferMethod` is specified
+           * in `PaymentRequired.extra`, clients should default to `eip3009`", and the SVM /
+           * Algorand / Aptos / NEAR / Hedera schemes never define the key at all. This predicate
+           * previously REQUIRED the key, which rejected 91% of the deployed x402 web — every
+           * Solana rail, every Arbitrum rail, 85% of Base — while the pay path had always
+           * handled its absence correctly (the EVM driver defaults to eip3009 and re-derives the
+           * EIP-712 domain on-chain). `isSettleableExactMethod` keeps the real guard: a rail that
+           * NAMES a method we don't implement (the spec's `erc7710`) is still skipped, because
+           * signing an EIP-3009 authorization for it would just be rejected by its facilitator.
+           */
+          isSettleableExactMethod(a) && net.describeAsset(a.asset) != null && // a foreign rail's maxTimeoutSeconds must be a usable positive integer, or
           // signing it would build a NaN/garbage validBefore — drop it silently
           // (symmetric with an unrecognised token) rather than leak a raw SyntaxError.
           Number.isInteger(a.maxTimeoutSeconds) && a.maxTimeoutSeconds > 0
@@ -4472,6 +3635,14 @@ var PipRailClient = class {
       accept,
       quote,
       cost,
+      // Surface the transfer method we INFERRED, not just the one the rail named — an absent
+      // marker means the scheme's default, and saying so is how an agent (or a maintainer) sees
+      // why a domain-only rail is payable and gasless. The default is PER FAMILY: a Solana rail
+      // naming nothing means `svm`, never `eip3009`.
+      ...accept.scheme === "exact" ? {
+        method: accept.extra?.assetTransferMethod ? exactTransferMethod(accept) : `${exactTransferMethod(accept, net.family)} (default)`
+      } : {},
+      ...accept.scheme === "upto" ? { method: "permit2-upto" } : {},
       state,
       blockers,
       warnings,
@@ -4513,7 +3684,7 @@ var PipRailClient = class {
     const symbol = described?.symbol ?? accept.extra?.symbol;
     const amountFormatted = formatUnits(amountBase, decimals);
     const intent = {
-      host: hostOf2(url),
+      host: hostOf(url),
       chain: this.opts.chain,
       network: accept.network,
       asset: accept.asset,
@@ -4654,7 +3825,7 @@ var PipRailClient = class {
     }
     const record = {
       url: quote.url,
-      host: hostOf2(quote.url),
+      host: hostOf(quote.url),
       network: quote.network,
       asset: quote.asset,
       amountBase,
@@ -4838,7 +4009,7 @@ var PipRailClient = class {
    *   • a 200 whose SettleResponse says `success:false` → a rejection, NEVER a spend;
    *   • the spend is recorded EXACTLY ONCE, on an affirmative settlement only.
    */
-  async payExactRail(net, wallet, accept, url, init, quote) {
+  async payExactRail(net, wallet, accept, url, init, quote, x402Version = 2) {
     if (!net.payExact) {
       throw new UnsupportedSchemeError(
         `the ${net.family} family can't pay a standard 'exact' rail (supported on EVM, Solana, Algorand, Aptos + NEAR today).`
@@ -4847,7 +4018,18 @@ var PipRailClient = class {
     throwIfAborted(init?.signal);
     const { payload, accepted, payerFrom, nonce } = await net.payExact(wallet, accept);
     const headers = new Headers(init?.headers);
-    headers.set(HEADER_SIGNATURE, buildExactSignatureHeader({ accepted, payload }));
+    if (x402Version === 1) {
+      headers.set(
+        HEADER_SIGNATURE_V1,
+        buildV1PaymentHeader({
+          scheme: accepted.scheme,
+          network: accept.wireNetwork ?? accepted.network,
+          payload
+        })
+      );
+    } else {
+      headers.set(HEADER_SIGNATURE, buildExactSignatureHeader({ accepted, payload }));
+    }
     const rejectDefinitive = (why2) => {
       this.safeEmit({ kind: "payment-failed", reason: `exact: facilitator rejected nonce=${nonce} (${why2})`, code: why2 });
       throw new MaxRetriesExceededError(
@@ -4874,7 +4056,7 @@ var PipRailClient = class {
         response = await fetch(url, { ...init ?? {}, headers, signal });
       } catch (err) {
         throw new PaymentTimeoutError(
-          `exact: no response after submitting the authorization (nonce=${nonce}) to ${hostOf2(url)}. The facilitator may have already settled it \u2014 verify on-chain via ${exactSettleCheckHint(net.family, payerFrom, nonce)} before re-presenting the SAME signed authorization; do NOT re-pay.`,
+          `exact: no response after submitting the authorization (nonce=${nonce}) to ${hostOf(url)}. The facilitator may have already settled it \u2014 verify on-chain via ${exactSettleCheckHint(net.family, payerFrom, nonce)} before re-presenting the SAME signed authorization; do NOT re-pay.`,
           { cause: err, ref: nonce }
         );
       } finally {
@@ -4958,7 +4140,7 @@ var PipRailClient = class {
         response = await fetch(url, { ...init ?? {}, headers, signal });
       } catch (err) {
         throw new PaymentTimeoutError(
-          `upto: no response after submitting the authorization (nonce=${nonce}) to ${hostOf2(url)}. The merchant may have already settled it \u2014 verify on-chain before re-presenting; do NOT re-pay.`,
+          `upto: no response after submitting the authorization (nonce=${nonce}) to ${hostOf(url)}. The merchant may have already settled it \u2014 verify on-chain before re-presenting; do NOT re-pay.`,
           { cause: err, ref: nonce }
         );
       } finally {
@@ -5132,7 +4314,7 @@ function reasonCodeForPolicy(code) {
       return "POLICY";
   }
 }
-function hostOf2(url) {
+function hostOf(url) {
   try {
     return new URL(url).hostname;
   } catch {
@@ -5586,6 +4768,9 @@ A 402 may offer up to three rails; you don't choose per payment \u2014 the clien
   (e.g. PayAI) \u2014 broadcasts it, so you pay ZERO gas (you need only the token, no native coin). It
   works on EVM, Solana, Algorand, Aptos + NEAR, and the on-chain method (EIP-3009 / Permit2 / SVM /
   Algorand fee-pooled group / Aptos fee-payer / NEAR SignedDelegateAction) is picked automatically.
+  XRPL also supports exact (native XRP), with ONE difference that matters to your budget: there the
+  PAYER pays the network fee, because on the XRP Ledger the fee lives inside the signed transaction.
+  So keep a little XRP for fees on that chain \u2014 everywhere else exact means you need no native coin.
 - upto (the metered/variable x402 rail, opt-in, EVM): the amount you see is a MAXIMUM \u2014 you sign
   a ceiling, the server meters real usage and settles the ACTUAL (<= the max). BUDGET AGAINST THE MAX:
   the plan/policy treat the ceiling as the spend (a server may charge up to it), so a payable plan
@@ -6395,82 +5580,61 @@ var KNOWN_FACILITATORS = {
       keyless: true,
       schemes: ["exact"],
       settles: ["eip3009"],
-      note: "PayAI \u2014 keyless, sponsors gas (Base USDC EIP-3009). Verified 2026-06-14 (/supported + live demo)."
+      note: "PayAI: keyless, sponsors gas (Base USDC EIP-3009). Verified 2026-06-14 (/supported + live demo)."
     },
     {
       url: "https://facilitator.xpay.sh",
       keyless: true,
       schemes: ["exact"],
       settles: ["eip3009"],
-      note: "xpay \u2014 keyless, zero-fee, sponsors gas. LIVE-settled on Base 2026-06-15 (tx 0x2273d5\u2026)."
+      note: "xpay: keyless, zero-fee, sponsors gas. LIVE-settled on Base 2026-06-15 (tx 0x2273d5\u2026)."
     },
     {
       url: "https://facilitator.ultravioletadao.xyz",
       keyless: true,
       schemes: ["exact"],
       settles: ["eip3009"],
-      note: "Ultravioleta DAO \u2014 keyless, 100% gas-sponsored (Base USDC EIP-3009). LIVE-settled on Base 2026-06-17 (tx 0x58a69042a4129be649c5642456752ede95a5ff921daddfd30560ae70ae5907ff). 2nd UVD validation chain (after HyperEVM)."
+      note: "Ultravioleta DAO: keyless, 100% gas-sponsored (Base USDC EIP-3009). LIVE-settled on Base 2026-06-17 (tx 0x58a69042a4129be649c5642456752ede95a5ff921daddfd30560ae70ae5907ff). 2nd UVD validation chain (after HyperEVM)."
     },
     {
       url: "https://x402.dexter.cash",
       keyless: true,
       schemes: ["exact"],
       settles: ["eip3009"],
-      note: "Dexter \u2014 keyless, gas-sponsored (Base USDC EIP-3009). LIVE-settled on Base 2026-06-17 (tx 0xdf030e4d5bf41a88c5a3bfe73bb433dfbb90b058d3b8ded63b68e026eedb9de8). Note: ~$0.001 dynamic floor on Base."
-    },
-    {
-      url: "https://facilitator.corbits.dev",
-      keyless: true,
-      schemes: ["exact"],
-      settles: ["eip3009"],
-      note: "Corbits (Faremeter) \u2014 keyless, sponsors gas (Base USDC EIP-3009). LIVE-settled on Base 2026-06-17 (tx 0x2e41c581af023100429ada81f1371bef82d41dd577ed438d72ddc18676d4213d). Also seeded on Monad + Solana."
+      note: "Dexter: keyless, gas-sponsored (Base USDC EIP-3009). LIVE-settled on Base 2026-06-17 (tx 0xdf030e4d5bf41a88c5a3bfe73bb433dfbb90b058d3b8ded63b68e026eedb9de8). Note: ~$0.001 dynamic floor on Base."
     },
     {
       url: "https://facilitator.goplausible.xyz",
       keyless: true,
       schemes: ["exact"],
       settles: ["eip3009"],
-      note: "GoPlausible \u2014 keyless, sponsors gas (Base USDC EIP-3009). LIVE-settled on Base 2026-06-17 (tx 0x9bcbc1f01fe1fd1aed2a79e5582555164cc4185e9800189df378a6b46eb9c59e). 2nd GoPlausible validation chain (after Algorand)."
+      note: "GoPlausible: keyless, sponsors gas (Base USDC EIP-3009). LIVE-settled on Base 2026-06-17 (tx 0x9bcbc1f01fe1fd1aed2a79e5582555164cc4185e9800189df378a6b46eb9c59e). 2nd GoPlausible validation chain (after Algorand)."
     },
     {
       url: "https://facilitator.cascade.fyi",
       keyless: true,
       schemes: ["exact"],
       settles: ["eip3009"],
-      note: "Cascade \u2014 keyless, sponsors gas (Base USDC EIP-3009). LIVE-settled on Base 2026-06-18 (tx 0x2e784725f3c66e170720cc8df43a9248f02ad80914fcbe05dadbdbe411c3b52b)."
-    },
-    {
-      url: "https://facilitator.bitcoinsapi.com",
-      keyless: true,
-      schemes: ["exact"],
-      settles: ["eip3009"],
-      note: "Satoshi (bitcoinsapi) \u2014 keyless, sponsors gas (Base USDC EIP-3009). LIVE-settled on Base 2026-06-18 (tx 0xbb2b6c354b12c6d07cce91e2b337e38327d4b0833bbd1dfbeda3ad495b67b819)."
+      note: "Cascade: keyless, sponsors gas (Base USDC EIP-3009). LIVE-settled on Base 2026-06-18 (tx 0x2e784725f3c66e170720cc8df43a9248f02ad80914fcbe05dadbdbe411c3b52b)."
     }
   ],
   // Monad (eip155:143). Corbits + Ultravioleta DAO each keyless-settle the EVM EIP-3009 exact rail
   // (Monad's native Circle USDC), buyer paid zero gas — real LIVE settles, not just /supported reads.
   // Makes `exact: true` zero-config gasless on Monad.
   "eip155:143": [
-    {
-      url: "https://facilitator.corbits.dev",
-      keyless: true,
-      schemes: ["exact"],
-      settles: ["eip3009"],
-      note: "Corbits (Faremeter) \u2014 keyless, sponsors gas (Monad native USDC EIP-3009). LIVE-settled on Monad 2026-06-17 (tx 0x7797be27ce22c17f7433a0389bd22d46e338899b1faac505fffd068174428ae6)."
-    },
     {
       url: "https://facilitator.ultravioletadao.xyz",
       keyless: true,
       schemes: ["exact"],
       settles: ["eip3009"],
-      note: "Ultravioleta DAO \u2014 keyless, 100% gas-sponsored (Monad native USDC EIP-3009). LIVE-settled on Monad 2026-06-17 (tx 0xb107576effbaceb5586c07a9ddc996ef2b6d455f1858314995ef83a7c6e64d11). 3rd UVD validation chain."
+      note: "Ultravioleta DAO: keyless, 100% gas-sponsored (Monad native USDC EIP-3009). LIVE-settled on Monad 2026-06-17 (tx 0xb107576effbaceb5586c07a9ddc996ef2b6d455f1858314995ef83a7c6e64d11). 3rd UVD validation chain."
     },
     {
       url: "https://facilitator.pieverse.io",
       keyless: true,
       schemes: ["exact"],
       settles: ["eip3009"],
-      note: "Pieverse \u2014 keyless, sponsors gas (Monad USDC EIP-3009). LIVE-settled on Monad 2026-06-17 (tx 0x00cfeb93876e5ef57dcb002510038b7304913233ca286d7ab33c72a8b119eb0d)."
+      note: "Pieverse: keyless, sponsors gas (Monad USDC EIP-3009). LIVE-settled on Monad 2026-06-17 (tx 0x00cfeb93876e5ef57dcb002510038b7304913233ca286d7ab33c72a8b119eb0d)."
     }
   ],
   // BNB Chain (eip155:56). Dexter + Pieverse keyless-settle the EVM EIP-3009 exact rail for BNB's
@@ -6484,14 +5648,14 @@ var KNOWN_FACILITATORS = {
       keyless: true,
       schemes: ["exact"],
       settles: ["eip3009"],
-      note: "Dexter \u2014 keyless, gas-sponsored. BNB EIP-3009 tokens FDUSD/USD1/U (Binance-Peg USDC/USDT are Permit2 \u2192 not facilitator-settleable); ~$0.003 dynamic floor. LIVE-settled on BNB 2026-06-17 with FDUSD (tx 0x6d9eb4e4939f3f3c74cb19424cc7822d66ec8ed5c5c7c330d9f88a5f9ad59e9e); accepts U (verify confirmed 2026-06-21)."
+      note: "Dexter: keyless, gas-sponsored. BNB EIP-3009 tokens FDUSD/USD1/U (Binance-Peg USDC/USDT are Permit2 \u2192 not facilitator-settleable); ~$0.003 dynamic floor. LIVE-settled on BNB 2026-06-17 with FDUSD (tx 0x6d9eb4e4939f3f3c74cb19424cc7822d66ec8ed5c5c7c330d9f88a5f9ad59e9e); accepts U (verify confirmed 2026-06-21)."
     },
     {
       url: "https://facilitator.pieverse.io",
       keyless: true,
       schemes: ["exact"],
       settles: ["eip3009"],
-      note: "Pieverse \u2014 keyless, sponsors gas. BNB EIP-3009 tokens FDUSD/USD1/U (same Binance-Peg caveat as Dexter). LIVE-settled on BNB with FDUSD 2026-06-17 (tx 0xb9c76affc45bd07a51559efd813ca71516fc30625478724476c2cf42fc2203d3) AND with the U / United Stables token 2026-06-21 (tx 0x2b3b8c51ae81df441551301c44a64652c84c796af3b9d03ec58ea38f1cb013d5, buyer 0 BNB) \u2014 a 2nd keyless BNB facilitator (failover for Dexter)."
+      note: "Pieverse: keyless, sponsors gas. BNB EIP-3009 tokens FDUSD/USD1/U (same Binance-Peg caveat as Dexter). LIVE-settled on BNB with FDUSD 2026-06-17 (tx 0xb9c76affc45bd07a51559efd813ca71516fc30625478724476c2cf42fc2203d3) AND with the U / United Stables token 2026-06-21 (tx 0x2b3b8c51ae81df441551301c44a64652c84c796af3b9d03ec58ea38f1cb013d5, buyer 0 BNB). A 2nd keyless BNB facilitator (failover for Dexter)."
     }
   ],
   // HyperEVM (eip155:999). Ultravioleta DAO keyless-settles the EVM EIP-3009 exact rail (HyperEVM's
@@ -6504,7 +5668,7 @@ var KNOWN_FACILITATORS = {
       keyless: true,
       schemes: ["exact"],
       settles: ["eip3009"],
-      note: "Ultravioleta DAO \u2014 keyless, 100% gas-sponsored (HyperEVM native USDC EIP-3009). LIVE-settled on HyperEVM 2026-06-17 (tx 0x56af8148a92a291f0ce362e250919f7742074e5464ac0f315ad68abaec93bd0a)."
+      note: "Ultravioleta DAO: keyless, 100% gas-sponsored (HyperEVM native USDC EIP-3009). LIVE-settled on HyperEVM 2026-06-17 (tx 0x56af8148a92a291f0ce362e250919f7742074e5464ac0f315ad68abaec93bd0a)."
     }
   ],
   // ── gasless-extension (2026-06-18): 7 more EVM mainnets, each LIVE-settled by us — a real EIP-3009
@@ -6521,7 +5685,7 @@ var KNOWN_FACILITATORS = {
       keyless: true,
       schemes: ["exact"],
       settles: ["eip3009"],
-      note: "Ultravioleta DAO \u2014 keyless, 100% gas-sponsored (Ethereum native USDC EIP-3009; no settlement floor). LIVE-settled on Ethereum mainnet 2026-06-18 (tx 0x7fcc3cafdf43c52888f0117cde633eff35371f832dfb8dbd84e6fd7704ae5cfc)."
+      note: "Ultravioleta DAO: keyless, 100% gas-sponsored (Ethereum native USDC EIP-3009; no settlement floor). LIVE-settled on Ethereum mainnet 2026-06-18 (tx 0x7fcc3cafdf43c52888f0117cde633eff35371f832dfb8dbd84e6fd7704ae5cfc)."
     }
   ],
   // Polygon PoS (eip155:137) — FIVE keyless facilitators (the broadest after Base), all live-settled.
@@ -6531,35 +5695,28 @@ var KNOWN_FACILITATORS = {
       keyless: true,
       schemes: ["exact"],
       settles: ["eip3009"],
-      note: "PayAI \u2014 keyless, sponsors gas (Polygon native USDC EIP-3009). LIVE-settled on Polygon 2026-06-18 (tx 0xb37630871504618c4db35e8ef0edd3c99deac102b143b7e5eb738c03fb13a619)."
+      note: "PayAI: keyless, sponsors gas (Polygon native USDC EIP-3009). LIVE-settled on Polygon 2026-06-18 (tx 0xb37630871504618c4db35e8ef0edd3c99deac102b143b7e5eb738c03fb13a619)."
     },
     {
       url: "https://x402.polygon.technology",
       keyless: true,
       schemes: ["exact"],
       settles: ["eip3009"],
-      note: "Polygon Labs (the official Polygon facilitator) \u2014 keyless, sponsors gas. LIVE-settled on Polygon 2026-06-18 (tx 0x6a8ca60ea111959a61a85ad6c4f2ed99e192052ec7b9ffb59baa33691a86f419)."
-    },
-    {
-      url: "https://facilitator.corbits.dev",
-      keyless: true,
-      schemes: ["exact"],
-      settles: ["eip3009"],
-      note: "Corbits (Faremeter) \u2014 keyless, sponsors gas. LIVE-settled on Polygon 2026-06-18 (tx 0x2fadca2ee3cd7fcff32d015e8b06109de6b747d7cd0f80dcd8fb022b2d58d008)."
+      note: "Polygon Labs (the official Polygon facilitator): keyless, sponsors gas. LIVE-settled on Polygon 2026-06-18 (tx 0x6a8ca60ea111959a61a85ad6c4f2ed99e192052ec7b9ffb59baa33691a86f419)."
     },
     {
       url: "https://facilitator.ultravioletadao.xyz",
       keyless: true,
       schemes: ["exact"],
       settles: ["eip3009"],
-      note: "Ultravioleta DAO \u2014 keyless, 100% gas-sponsored. LIVE-settled on Polygon 2026-06-18 (tx 0x0922cd78f3b7c35cc294cf0c0d9b7609e6596eb337be0d197fa5fc511eacba34)."
+      note: "Ultravioleta DAO: keyless, 100% gas-sponsored. LIVE-settled on Polygon 2026-06-18 (tx 0x0922cd78f3b7c35cc294cf0c0d9b7609e6596eb337be0d197fa5fc511eacba34)."
     },
     {
       url: "https://x402.dexter.cash",
       keyless: true,
       schemes: ["exact"],
       settles: ["eip3009"],
-      note: "Dexter \u2014 keyless, sponsors gas; ~$0.004 dynamic settlement floor (sub-floor \u2192 amount_too_low). LIVE-settled on Polygon 2026-06-18 at $0.005 (tx 0x4a7cfc96e4e2496652435c77b0021db4a459e7bcd97948c15e6bea09077c164b)."
+      note: "Dexter: keyless, sponsors gas; ~$0.004 dynamic settlement floor (sub-floor \u2192 amount_too_low). LIVE-settled on Polygon 2026-06-18 at $0.005 (tx 0x4a7cfc96e4e2496652435c77b0021db4a459e7bcd97948c15e6bea09077c164b)."
     }
   ],
   // Arbitrum One (eip155:42161) — PayAI + UVD + Dexter.
@@ -6569,21 +5726,21 @@ var KNOWN_FACILITATORS = {
       keyless: true,
       schemes: ["exact"],
       settles: ["eip3009"],
-      note: "PayAI \u2014 keyless, sponsors gas (Arbitrum native USDC EIP-3009). LIVE-settled on Arbitrum 2026-06-18 (tx 0x4c7fbfb37ef087bb9bc8872b1b2b0b83ea7ca4cf6b50bc883e51f9b85be61199)."
+      note: "PayAI: keyless, sponsors gas (Arbitrum native USDC EIP-3009). LIVE-settled on Arbitrum 2026-06-18 (tx 0x4c7fbfb37ef087bb9bc8872b1b2b0b83ea7ca4cf6b50bc883e51f9b85be61199)."
     },
     {
       url: "https://facilitator.ultravioletadao.xyz",
       keyless: true,
       schemes: ["exact"],
       settles: ["eip3009"],
-      note: "Ultravioleta DAO \u2014 keyless, 100% gas-sponsored. LIVE-settled on Arbitrum 2026-06-18 (tx 0xd1fa7e6ffbd59502bba5809ce181d7936749b93a45c8c2277b4f6d8638326dec)."
+      note: "Ultravioleta DAO: keyless, 100% gas-sponsored. LIVE-settled on Arbitrum 2026-06-18 (tx 0xd1fa7e6ffbd59502bba5809ce181d7936749b93a45c8c2277b4f6d8638326dec)."
     },
     {
       url: "https://x402.dexter.cash",
       keyless: true,
       schemes: ["exact"],
       settles: ["eip3009"],
-      note: "Dexter \u2014 keyless, sponsors gas; ~$0.004 dynamic floor. LIVE-settled on Arbitrum 2026-06-18 at $0.005 (tx 0x0993d51b3859dfd7e8d5b2af709ce64f01ff34ed14bfef665dbb340e7373d599)."
+      note: "Dexter: keyless, sponsors gas; ~$0.004 dynamic floor. LIVE-settled on Arbitrum 2026-06-18 at $0.005 (tx 0x0993d51b3859dfd7e8d5b2af709ce64f01ff34ed14bfef665dbb340e7373d599)."
     }
   ],
   // Optimism (eip155:10) — Dexter + UVD.
@@ -6593,14 +5750,14 @@ var KNOWN_FACILITATORS = {
       keyless: true,
       schemes: ["exact"],
       settles: ["eip3009"],
-      note: "Dexter \u2014 keyless, sponsors gas; ~$0.004 dynamic floor. LIVE-settled on Optimism 2026-06-18 at $0.005 (tx 0x98b282a5dd698054eff4900ff8547170d4f7605b51140c55147fc5ae485f81da)."
+      note: "Dexter: keyless, sponsors gas; ~$0.004 dynamic floor. LIVE-settled on Optimism 2026-06-18 at $0.005 (tx 0x98b282a5dd698054eff4900ff8547170d4f7605b51140c55147fc5ae485f81da)."
     },
     {
       url: "https://facilitator.ultravioletadao.xyz",
       keyless: true,
       schemes: ["exact"],
       settles: ["eip3009"],
-      note: "Ultravioleta DAO \u2014 keyless, 100% gas-sponsored. LIVE-settled on Optimism 2026-06-18 (tx 0xdd91dfdf12bed2d196e37fa1dea9a0da71a97e3c39a0ec0ed114be6a9af22837)."
+      note: "Ultravioleta DAO: keyless, 100% gas-sponsored. LIVE-settled on Optimism 2026-06-18 (tx 0xdd91dfdf12bed2d196e37fa1dea9a0da71a97e3c39a0ec0ed114be6a9af22837)."
     }
   ],
   // Avalanche C-Chain (eip155:43114) — PayAI + Dexter. (UVD advertises it but contract_call_failed → unseeded.)
@@ -6610,14 +5767,14 @@ var KNOWN_FACILITATORS = {
       keyless: true,
       schemes: ["exact"],
       settles: ["eip3009"],
-      note: "PayAI \u2014 keyless, sponsors gas (Avalanche native USDC EIP-3009). LIVE-settled on Avalanche 2026-06-18 (tx 0x6a1307bc48a157de236ea03440ea2cb6ad4f27e22dd9c89a4345b4c3edb270c7)."
+      note: "PayAI: keyless, sponsors gas (Avalanche native USDC EIP-3009). LIVE-settled on Avalanche 2026-06-18 (tx 0x6a1307bc48a157de236ea03440ea2cb6ad4f27e22dd9c89a4345b4c3edb270c7)."
     },
     {
       url: "https://x402.dexter.cash",
       keyless: true,
       schemes: ["exact"],
       settles: ["eip3009"],
-      note: "Dexter \u2014 keyless, sponsors gas (no floor hit at $0.001 here). LIVE-settled on Avalanche 2026-06-18 (tx 0xb2263e9a4ea3917eee6acabcb454d42a50264fdd69a0781ed8fcaec5590e264b)."
+      note: "Dexter: keyless, sponsors gas (no floor hit at $0.001 here). LIVE-settled on Avalanche 2026-06-18 (tx 0xb2263e9a4ea3917eee6acabcb454d42a50264fdd69a0781ed8fcaec5590e264b)."
     }
   ],
   // Sei (eip155:1329) — PayAI (the only keyless facilitator that lists Sei).
@@ -6627,7 +5784,7 @@ var KNOWN_FACILITATORS = {
       keyless: true,
       schemes: ["exact"],
       settles: ["eip3009"],
-      note: "PayAI \u2014 keyless, sponsors gas (Sei native USDC EIP-3009). LIVE-settled on Sei 2026-06-18 (tx 0xde63679b64749cb59625527e5c7682503c851d66b9b8b8ba217ed7b099461312)."
+      note: "PayAI: keyless, sponsors gas (Sei native USDC EIP-3009). LIVE-settled on Sei 2026-06-18 (tx 0xde63679b64749cb59625527e5c7682503c851d66b9b8b8ba217ed7b099461312)."
     }
   ],
   // Unichain (eip155:130) — UVD (the only keyless facilitator that lists Unichain).
@@ -6637,7 +5794,7 @@ var KNOWN_FACILITATORS = {
       keyless: true,
       schemes: ["exact"],
       settles: ["eip3009"],
-      note: "Ultravioleta DAO \u2014 keyless, 100% gas-sponsored (Unichain native USDC EIP-3009). LIVE-settled on Unichain 2026-06-18 (tx 0xf8bf4a9a200f24159ac67c6315c30b194257999d7da21471b39d5f2cc32b2236)."
+      note: "Ultravioleta DAO: keyless, 100% gas-sponsored (Unichain native USDC EIP-3009). LIVE-settled on Unichain 2026-06-18 (tx 0xf8bf4a9a200f24159ac67c6315c30b194257999d7da21471b39d5f2cc32b2236)."
     }
   ],
   // Algorand (mainnet, CAIP-2 = full base64 genesis hash). GoPlausible keyless-settles the ratified
@@ -6653,7 +5810,7 @@ var KNOWN_FACILITATORS = {
       keyless: true,
       schemes: ["exact"],
       settles: ["algorand"],
-      note: "GoPlausible \u2014 keyless, 100% gas-sponsored (Algorand USDCa, atomic-group fee pooling; both buyer AND merchant pay 0 ALGO). LIVE-settled on Algorand mainnet 2026-06-17 (tx PDVDVRFGJAG2K6AJ7L26OTSCSRL7AURVKEX4D4KHBAOLNSCYENXA). The only keyless Algorand x402 facilitator."
+      note: "GoPlausible: keyless, 100% gas-sponsored (Algorand USDCa, atomic-group fee pooling; both buyer AND merchant pay 0 ALGO). LIVE-settled on Algorand mainnet 2026-06-17 (tx PDVDVRFGJAG2K6AJ7L26OTSCSRL7AURVKEX4D4KHBAOLNSCYENXA). The only keyless Algorand x402 facilitator."
     }
   ],
   // Solana (mainnet-beta). Keyless fee-payer sponsors for the SVM exact rail, each LIVE-settled
@@ -6666,21 +5823,14 @@ var KNOWN_FACILITATORS = {
       keyless: true,
       schemes: ["exact"],
       settles: ["svm"],
-      note: "PayAI \u2014 keyless fee-payer sponsor (Solana SPL SVM). LIVE-settled 2026-06-14 (tx 4dL8jRKH\u2026)."
+      note: "PayAI: keyless fee-payer sponsor (Solana SPL SVM). LIVE-settled 2026-06-14 (tx 4dL8jRKH\u2026)."
     },
     {
       url: "https://pay.openfacilitator.io",
       keyless: true,
       schemes: ["exact"],
       settles: ["svm"],
-      note: "OpenFacilitator \u2014 keyless (no signup), fee-payer sponsor. LIVE-settled on Solana 2026-06-15 (tx 5BabDtX\u2026)."
-    },
-    {
-      url: "https://facilitator.corbits.dev",
-      keyless: true,
-      schemes: ["exact"],
-      settles: ["svm"],
-      note: "Corbits \u2014 keyless, Solana-first fee-payer sponsor. LIVE-settled on Solana 2026-06-15 (tx BCreYer\u2026)."
+      note: "OpenFacilitator: keyless (no signup), fee-payer sponsor. LIVE-settled on Solana 2026-06-15 (tx 5BabDtX\u2026)."
     }
   ]
   // NEAR (near:mainnet) — DELIBERATELY UNSEEDED: no x402 facilitator settles NEAR yet.
@@ -6871,7 +6021,7 @@ function createPaymentGate(options) {
         );
       }
       return {
-        skipReason: `${net.network}: this token isn't EIP-3009 (auto-selected Permit2), which a third-party facilitator can't settle \u2014 it would serve onchain-proof only here. Use an EIP-3009 token (USDC / EURC) with the facilitator, or \`settle: 'self'\` to settle Permit2 yourself.`
+        skipReason: `${net.network}: auto-selected Permit2, which a third-party facilitator can't settle \u2014 it would serve onchain-proof only here. Either this token isn't EIP-3009 (use USDC / EURC with the facilitator, or \`settle: 'self'\` to settle Permit2 yourself), OR the EIP-712 domain read failed on your RPC (transient): if you expected a gasless rail here, pass a reliable \`rpcUrl\` and retry.`
       };
     }
     const mode = settle === "self" ? { kind: "self", relayer } : {
@@ -7198,8 +6348,8 @@ function createPaymentGate(options) {
         maxTimeoutSeconds,
         ...s.symbol ? { symbol: s.symbol } : {}
       };
-      if (s.exact) accepts.push({ scheme: "exact", ...base2, ...railExtra(buildExactAccept(s).extra) });
-      if (s.upto) accepts.push({ scheme: "upto", ...base2, ...railExtra(buildUptoAccept(s).extra) });
+      if (s.exact) accepts.push({ scheme: "exact", ...base2, ...railExtra(buildExactAccept(s).extra ?? {}) });
+      if (s.upto) accepts.push({ scheme: "upto", ...base2, ...railExtra(buildUptoAccept(s).extra ?? {}) });
       accepts.push({ scheme: "onchain-proof", ...base2 });
     }
     return {
@@ -7212,7 +6362,7 @@ function createPaymentGate(options) {
   async function verifyOnchainProof(sig) {
     const specs = await ready();
     const spec = specs.find(
-      (s) => s.net.network === sig.accepted.network && s.asset === sig.accepted.asset
+      (s) => normalizeNetwork(s.net.network) === normalizeNetwork(sig.accepted.network) && s.asset === sig.accepted.asset
     );
     if (!spec) {
       return rejection(
@@ -7220,7 +6370,7 @@ function createPaymentGate(options) {
         `Proof claims ${sig.accepted.asset} on ${sig.accepted.network}, which this resource doesn't accept (offered: ${specs.map((s) => `${s.asset}@${s.net.network}`).join(", ")}).`
       );
     }
-    const ref = sig.payload.txHash;
+    const ref = typeof sig.payload.txHash === "string" ? sig.payload.txHash.trim() : sig.payload.txHash;
     if (await claimTx(ref)) return rejection("tx_already_used", `Proof ${ref} was already redeemed.`);
     let result;
     try {
@@ -7254,7 +6404,8 @@ function createPaymentGate(options) {
       return rejection("transfer_not_found", "This resource offers no standard `exact` rail.");
     }
     const isCaip = exact.network.includes(":");
-    let candidates = isCaip ? exactSpecs.filter((s) => s.net.network === exact.network) : exactSpecs;
+    const wantExactNet = normalizeNetwork(exact.network);
+    let candidates = isCaip ? exactSpecs.filter((s) => normalizeNetwork(s.net.network) === wantExactNet) : exactSpecs;
     if (exact.asset) {
       candidates = candidates.filter((s) => s.asset.toLowerCase() === exact.asset.toLowerCase());
     }
@@ -7297,6 +6448,8 @@ function createPaymentGate(options) {
       } catch {
         nonce = exact.payload.signedDelegateAction;
       }
+    } else if ("signedTxBlob" in exact.payload) {
+      nonce = exact.payload.signedTxBlob.trim().toUpperCase();
     } else if ("permit2Authorization" in exact.payload) {
       evmAuth = exact.payload.permit2Authorization;
       nonce = evmAuth.nonce;
@@ -7314,9 +6467,9 @@ function createPaymentGate(options) {
       if (mode.kind === "self") {
         result = await spec.net.settleExactSelf({ relayer: mode.relayer, payload: exact.payload, accept });
       } else {
-        const ftMethod = accept.extra.assetTransferMethod;
+        const ftMethod = accept.extra?.assetTransferMethod;
         const needsFeePayer = ftMethod === "svm" || ftMethod === "algorand" || ftMethod === "aptos" || ftMethod === "near";
-        if (needsFeePayer && !accept.extra.feePayer) {
+        if (needsFeePayer && !accept.extra?.feePayer) {
           throw new SettlementError(
             `exact settle: the ${ftMethod} facilitator rail is missing extra.feePayer (the gas sponsor) \u2014 cannot settle.`
           );
@@ -7337,7 +6490,7 @@ function createPaymentGate(options) {
             amount: accept.amount,
             payTo: accept.payTo,
             maxTimeoutSeconds: accept.maxTimeoutSeconds,
-            extra: needsFeePayer ? { feePayer: accept.extra.feePayer } : { name: accept.extra.name ?? "", version: accept.extra.version ?? "" }
+            extra: needsFeePayer ? { feePayer: accept.extra.feePayer } : { name: accept.extra?.name ?? "", version: accept.extra?.version ?? "" }
           },
           receipt: { network: accept.network, asset: accept.asset, payTo: accept.payTo, amount: accept.amount },
           // The buyer address, for the receipt's `payer` fallback. EVM carries it in the
@@ -7385,7 +6538,8 @@ function createPaymentGate(options) {
       return rejection("transfer_not_found", "This resource offers no standard `upto` (metered) rail.");
     }
     const isCaip = upto.network.includes(":");
-    let candidates = isCaip ? uptoSpecs.filter((s) => s.net.network === upto.network) : uptoSpecs;
+    const wantUptoNet = normalizeNetwork(upto.network);
+    let candidates = isCaip ? uptoSpecs.filter((s) => normalizeNetwork(s.net.network) === wantUptoNet) : uptoSpecs;
     if (upto.asset) {
       candidates = candidates.filter((s) => s.asset.toLowerCase() === upto.asset.toLowerCase());
     }
@@ -8130,6 +7284,7 @@ export {
   BUILTIN_DENOMS,
   CHAINS,
   ConfirmationTimeoutError,
+  DEFAULT_EXACT_TRANSFER_METHOD,
   DENOM_PRECISION,
   DIRECTORY_INFO,
   EIP3009_TYPES,
@@ -8145,6 +7300,7 @@ export {
   InsufficientFundsError,
   InvalidConfigError,
   InvalidEnvelopeError,
+  KNOWN_EXACT_TRANSFER_METHODS,
   KNOWN_FACILITATORS,
   MCP_PAYMENT_META_KEY,
   MCP_PAYMENT_RESPONSE_META_KEY,
@@ -8193,6 +7349,7 @@ export {
   buildSelfDescription,
   buildSignatureHeader,
   buildUptoSignatureHeader,
+  buildV1PaymentHeader,
   buildWellKnownX402,
   buildWellKnownX402Manifest,
   buildX402DnsTxt,
@@ -8213,6 +7370,7 @@ export {
   eip3009Abi,
   encodeXPaymentHeader,
   evaluatePolicy,
+  exactTransferMethod,
   explainDecline,
   facilitatorCoverage,
   fetchAcross,
@@ -8226,10 +7384,12 @@ export {
   getDirectoryInfo,
   isMcpPaymentRequired,
   isPermit2ProxyChain,
+  isSettleableExactMethod,
   isUptoProxyChain,
   knownFacilitatorsFor,
   memorySpendStore,
   normalizeNetwork,
+  normalizeV1Challenge,
   parseChallenge,
   parseExactObject,
   parseExactPaymentHeader,