@piprail/sdk 1.22.0 → 1.23.0

package/CHANGELOG.md

@@ -4,6 +4,53 @@ All notable changes to `@piprail/sdk` are documented here. The format
 follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the
 versions follow [Semantic Versioning](https://semver.org/).
 
+## [1.23.0] — 2026-06-14 — self-describing endpoints + discovery reach
+
+### Added — self-describing, more discoverable endpoints (discoverability plan: Phases 1, 2, 4, 5)
+
+- **Self-describing 402s, ON by default.** Every challenge a gate builds now carries an
+  `extensions.piprail` block — identity, per-rail how-to-pay, `npm i @piprail/sdk` + a paste-ready
+  snippet, the MCP command, and docs + discovery pointers — so any human, AI agent, or crawler that
+  lands on a gated endpoint (even the `onchain-proof` scheme a stock x402 client can't pay) knows what
+  it is and how to pay it. **Purely-additive** metadata in the spec-opaque `extensions` bag, and it
+  rides in the response **body** only — the base64 `payment-required` **header stays slim** (just
+  `accepts[]` + a small `bazaar`/rejection block), so the header, pay path, `accepts[]`, and status are
+  byte-identical (a rejection's `{code,detail}` are deep-merged as siblings and still win). Opt out with
+  `requirePayment({ selfDescribe: false })`. New exports: `buildSelfDescription`, `describeChallenge`, `BRAND`.
+- **Human landing page + HTTP pointers.** `gate.landingPage(challenge)` / `renderLandingPage()` render a
+  tiny, HTML-escaped 402 page for a browser (serve it on `Accept: text/html`; agents/crawlers keep the
+  JSON 402). It leads with **how to pay** and a clear **caution** that a manual send to the address won't
+  unlock the resource (pay via an x402 client — no custody, no manual-payment desk). `discoveryHeaders()`
+  + `POWERED_BY` emit a `Link` (rel `service-desc` / `x402-discovery`) + `x-powered-by` header bag to
+  spread on every response. The SDK serves nothing — the merchant does.
+- **Facilitator-coverage map.** `KNOWN_FACILITATORS` (+ `knownFacilitatorsFor` /
+  `firstKeylessFacilitator`) — shipped data of which keyless facilitators settle `exact` on which
+  networks (seeded: PayAI on Base + Solana, dated-verified). `facilitatorCoverage(url)` /
+  `parseFacilitatorSupported(body)` read a facilitator's live `GET /supported` (best-effort, never throw).
+- **Agent guide** gained a "landing cold — read the self-description" section (surfaced over the MCP).
+
+All of the above is additive + opt-in; the zero-config pay path is byte-identical to before. New pure
+modules (`selfdescribe.ts`, `landing.ts`, `facilitators.ts`) join the viem-free protocol-layer grep.
+
+### Removed
+- **`base-sepolia` (84532) testnet entry** from `EXACT_NETWORK_SLUGS` and the Permit2 proxy chain-id set
+  — mainnets only, no testnet presets (it was dead reference data; nothing settles on a testnet).
+
+### Fixed
+- **`x-powered-by` is now ASCII** (`PipRail x402 | https://piprail.com`) — the previous non-ASCII middot
+  mangled to `·` over Node's latin1 header transport. `GENERATOR` keeps its `·` (JSON body only).
+- **`renderLandingPage` never throws** on a rail missing `amount`/`asset` (matches the module's
+  never-throw contract).
+- **`fetchFacilitatorFeePayer` matches the network normalized** (CAIP-2 *or* slug) so a slug-reporting
+  facilitator's Solana exact fee-payer is found instead of silently dropped.
+
+## [1.22.1] — 2026-06-13 — docs: community links + integrations signposting
+
+Docs-only patch — **no code change** (the SDK is byte-identical to 1.22.0). Refreshes the README:
+adds a "Spread the word" section (GitHub · X · piprail.com · docs) and surfaces the first-party
+integrations (the OpenClaw skill, `clawhub install piprail`) from the repo. Published so the npm
+package page carries the updated front door.
+
 ## [1.22.0] — 2026-06-13 — optional wallet (read-only client)
 
 A purely **additive, opt-in** feature: `PipRailClient`'s `wallet` is now **optional**. Omit it for a

package/README.md

@@ -55,6 +55,12 @@ The same app can **take** payments and **make** them. → [Making payments](http
 | **[MCP server](https://docs.piprail.com/mcp/overview/)** | Give any AI agent a budget-bound wallet |
 | **[Reference](https://docs.piprail.com/reference/api/)** | The complete API surface |
 
+## Spread the word
+
+PipRail is free, open-source, and has no backend to sell you. If it saved you from building a payments backend, help other developers (and their agents) find it:
+
+⭐ **[Star on GitHub](https://github.com/piprail/piprail)**  ·  𝕏 **[Follow @piprailhq](https://x.com/piprailhq)**  ·  🌐 **[piprail.com](https://piprail.com)**  ·  📖 **[docs.piprail.com](https://docs.piprail.com)**
+
 ## License & trademark
 
 The code is **MIT** — use it, fork it, ship it. **PipRail™**, the logo, and the `@piprail` npm scope are trademarks of the PipRail project: build on the code freely, but please don't call a fork "PipRail" or imply it's official. See [TRADEMARK.md](https://github.com/piprail/piprail/blob/main/TRADEMARK.md).

package/dist/index.cjs

@@ -511,7 +511,6 @@ function sumTransfersTo(logs, asset, payTo) {
 var EXACT_NETWORK_SLUGS = {
   ethereum: 1,
   base: 8453,
-  "base-sepolia": 84532,
   arbitrum: 42161,
   optimism: 10,
   polygon: 137,
@@ -983,8 +982,6 @@ var PERMIT2_PROXY_CHAIN_IDS = /* @__PURE__ */ new Set([
   // Ethereum
   8453,
   // Base
-  84532,
-  // Base Sepolia
   42161,
   // Arbitrum
   10,
@@ -3604,6 +3601,48 @@ async function readInvalidReason(response) {
   return null;
 }
 
+// src/selfdescribe.ts
+var BRAND = {
+  name: "PipRail",
+  home: "https://piprail.com",
+  docs: "https://docs.piprail.com",
+  payDocs: "https://docs.piprail.com/paying",
+  sdkInstall: "npm i @piprail/sdk",
+  sdkSnippet: "import { PipRailClient } from '@piprail/sdk'\nconst client = new PipRailClient({ chain: '<your-chain>', wallet })\nawait client.fetch('<this-url>')",
+  mcpRun: "npx -y @piprail/mcp"
+};
+var WHAT = 'This is an x402 "402 Payment Required" endpoint. Pay one of the offered rails to access it.';
+function howFor(scheme) {
+  return scheme === "exact" ? "Standard x402 exact rail \u2014 sign an EIP-3009 / Permit2 / SVM authorization; any stock x402 client (e.g. @x402/fetch) can pay this." : "Pay this amount on-chain to payTo, then resubmit with a payment-signature header carrying the proof ref + nonce. Easiest with @piprail/sdk (see sdk.install).";
+}
+function railOf(a) {
+  const extra = _nullishCoalesce(a.extra, () => ( {}));
+  return {
+    scheme: a.scheme,
+    network: a.network,
+    asset: a.asset,
+    payTo: a.payTo,
+    amount: a.amount,
+    ...extra.amountFormatted ? { amountFormatted: extra.amountFormatted } : {},
+    ...extra.symbol ? { symbol: extra.symbol } : {},
+    how: howFor(a.scheme)
+  };
+}
+function buildSelfDescription(input) {
+  return {
+    name: "PipRail",
+    protocol: "x402",
+    version: "2",
+    what: WHAT,
+    pay: input.accepts.map(railOf),
+    sdk: { install: BRAND.sdkInstall, snippet: BRAND.sdkSnippet },
+    mcp: { run: BRAND.mcpRun, tool: "piprail_pay_request" },
+    docs: { home: BRAND.home, agents: BRAND.docs, pay: BRAND.payDocs },
+    discovery: { openapi: "/openapi.json", wellKnown: "/.well-known/x402" },
+    ...input.instruction ? { instruction: input.instruction } : {}
+  };
+}
+
 // src/render.ts
 function summarizePlan(plan) {
   if (plan == null) return "No payment required \u2014 the URL is not payment-gated.";
@@ -3644,6 +3683,18 @@ function formatSpendReport(summary) {
     (a) => `${a.totalFormatted} ${_nullishCoalesce(a.symbol, () => ( a.asset))} on ${a.network} (${a.count} payment${a.count === 1 ? "" : "s"})`
   ).join("; ");
 }
+function describeChallenge(challenge) {
+  const first = challenge.accepts[0];
+  if (!first) {
+    return `${BRAND.name} x402 payment endpoint. Pay with @piprail/sdk (${BRAND.sdkInstall}). Docs: ${BRAND.home}.`;
+  }
+  const extra = _nullishCoalesce(first.extra, () => ( {}));
+  const amount = _nullishCoalesce(extra.amountFormatted, () => ( first.amount));
+  const token = _nullishCoalesce(extra.symbol, () => ( first.asset));
+  const hasExact = challenge.accepts.some((a) => a.scheme === "exact");
+  const standard = hasExact ? "; or any standard x402 client (an exact rail is offered)" : "";
+  return `${BRAND.name} x402 payment endpoint \u2014 pay ${amount} ${token} on ${first.network} to ${first.payTo}. Programmatic: ${BRAND.sdkInstall} then client.fetch(url)${standard}. Docs: ${BRAND.home}.`;
+}
 
 // src/agentGuide.ts
 var PIPRAIL_AGENT_GUIDE = `# Paying with PipRail \u2014 the agent contract
@@ -3651,6 +3702,13 @@ var PIPRAIL_AGENT_GUIDE = `# Paying with PipRail \u2014 the agent contract
 You can pay for x402 "402 Payment Required" resources autonomously. Money moves
 straight from your wallet to the server; PipRail custodies nothing. Follow this.
 
+## Landing cold \u2014 read the self-description
+Every PipRail 402 self-describes. Read challenge.extensions.piprail for { name, what, pay[]
+(each rail's how-to-pay), sdk.install, mcp, docs } \u2014 never guess what an endpoint is. If your
+tooling can't pay a rail (e.g. a stock x402 client can't pay the onchain-proof scheme), the
+block says how: install @piprail/sdk (npm i @piprail/sdk) or run the MCP (npx -y @piprail/mcp)
+and pay with the tools below.
+
 ## The loop: quote \u2192 plan \u2192 pay
 1. piprail_quote_payment(url) \u2014 PRICE it. Returns the amount, token, chain, and
    whether it is within your spend policy. No funds move. Use it to decide if a
@@ -4011,6 +4069,13 @@ function classifyChallenge(challenge, opts) {
 
 // src/discovery.ts
 var GENERATOR = "@piprail/sdk \xB7 https://piprail.com";
+var POWERED_BY = "PipRail x402 | https://piprail.com";
+function discoveryHeaders(opts = {}) {
+  return {
+    link: '</openapi.json>; rel="service-desc", </.well-known/x402>; rel="x402-discovery"',
+    ...opts.attribution === false ? {} : { "x-powered-by": POWERED_BY }
+  };
+}
 function buildBazaarExtension(descriptor = {}) {
   const method = (_nullishCoalesce(descriptor.method, () => ( "GET"))).toUpperCase();
   const queryParams = _nullishCoalesce(descriptor.queryParams, () => ( {}));
@@ -4090,6 +4155,57 @@ function buildX402DnsTxt(input) {
   };
 }
 
+// src/landing.ts
+function esc(s) {
+  return String(_nullishCoalesce(s, () => ( ""))).replace(
+    /[&<>"']/g,
+    (c) => c === "&" ? "&amp;" : c === "<" ? "&lt;" : c === ">" ? "&gt;" : c === '"' ? "&quot;" : "&#39;"
+  );
+}
+var STYLE = `:root{color-scheme:dark}
+*{box-sizing:border-box}
+body{margin:0;background:#0a0e0f;color:#e6edf0;font:16px/1.6 ui-sans-serif,system-ui,-apple-system,Inter,sans-serif}
+main{max-width:680px;margin:0 auto;padding:48px 24px}
+h1{font-size:1.6rem;margin:0 0 .25rem}
+.lede{color:#9fb0b5;margin:.25rem 0 2rem}
+h2{font-size:1rem;text-transform:uppercase;letter-spacing:.05em;color:#34d399;margin:2rem 0 .75rem}
+table{width:100%;border-collapse:collapse;font-size:.92rem}
+th,td{text-align:left;padding:.5rem .6rem;border-bottom:1px solid #1c2426;vertical-align:top}
+th{color:#9fb0b5;font-weight:600}
+code,pre{font-family:ui-monospace,JetBrains Mono,monospace;font-size:.85rem}
+pre{background:#11181a;border:1px solid #1c2426;border-radius:8px;padding:14px;overflow-x:auto;color:#cfe9df}
+a{color:#34d399}
+.mono{font-family:ui-monospace,monospace;word-break:break-all}
+.warn{margin:0 0 2rem;padding:14px 16px;border:1px solid #5a4a1f;background:#17130a;border-radius:8px;color:#e8d9a8;font-size:.92rem;line-height:1.55}
+.warn strong{color:#f5d77a}
+.muted{color:#5b6b6f;font-weight:400;text-transform:none;letter-spacing:0;font-size:.8rem}
+footer{margin-top:2.5rem;color:#5b6b6f;font-size:.8rem}`;
+function renderLandingPage(sd) {
+  const lede = esc(_nullishCoalesce(sd.instruction, () => ( sd.what)));
+  const rows = sd.pay.map(
+    (r) => `<tr><td><code>${esc(r.scheme)}</code></td><td>${esc(r.network)}</td><td>${esc(_nullishCoalesce(r.amountFormatted, () => ( r.amount)))} ${esc(_nullishCoalesce(r.symbol, () => ( r.asset)))}</td><td class="mono">${esc(r.payTo)}</td></tr>`
+  ).join("");
+  return `<!doctype html>
+<html lang="en"><head><meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>${esc(sd.name)} \xB7 x402 payment required</title>
+<style>${STYLE}</style>
+</head><body><main>
+<h1>402 \u2014 Payment Required</h1>
+<p class="lede">${lede}</p>
+<div class="warn"><strong>Pay with an x402 client \u2014 not by hand.</strong> This endpoint is paid programmatically: an x402 client (the ${esc(sd.name)} SDK or MCP below, or any x402-compatible wallet) makes the payment <em>and proves it</em>, which is what unlocks the resource. Sending funds straight to the address below from an ordinary wallet will reach the merchant but <strong>will NOT unlock this resource and won't be matched to your request</strong> \u2014 there is no custody and no manual-payment desk. Use one of the methods below.</div>
+<h2>How to pay</h2>
+<pre>${esc(sd.sdk.install)}</pre>
+<pre>${esc(sd.sdk.snippet)}</pre>
+<p>For AI agents (MCP): <code>${esc(sd.mcp.run)}</code> &rarr; tool <code>${esc(sd.mcp.tool)}</code></p>
+<h2>Payment details <span class="muted">\u2014 what the client pays, NOT a manual-send address</span></h2>
+<table><thead><tr><th>Scheme</th><th>Chain</th><th>Amount</th><th>Settles to</th></tr></thead>
+<tbody>${rows}</tbody></table>
+<p>Docs: <a href="${esc(sd.docs.pay)}">paying</a> &middot; <a href="${esc(sd.docs.home)}">${esc(sd.docs.home)}</a> &middot; <a href="${esc(sd.discovery.openapi)}">${esc(sd.discovery.openapi)}</a></p>
+<footer>Powered by ${esc(sd.name)} &middot; x402 &middot; no backend, no fee, settled straight to the merchant's wallet (no custody).</footer>
+</main></body></html>`;
+}
+
 // src/facilitator.ts
 async function fetchFacilitatorFeePayer(url, network, timeoutMs = 8e3) {
   const base2 = url.replace(/\/+$/, "");
@@ -4100,7 +4216,8 @@ async function fetchFacilitatorFeePayer(url, network, timeoutMs = 8e3) {
     if (!res.ok) return void 0;
     const body = await res.json();
     const kinds = Array.isArray(_optionalChain([body, 'optionalAccess', _64 => _64.kinds])) ? body.kinds : [];
-    const kind = kinds.find((k) => _optionalChain([k, 'optionalAccess', _65 => _65.scheme]) === "exact" && _optionalChain([k, 'optionalAccess', _66 => _66.network]) === network);
+    const want = normalizeNetwork(network);
+    const kind = kinds.find((k) => _optionalChain([k, 'optionalAccess', _65 => _65.scheme]) === "exact" && normalizeNetwork(String(_nullishCoalesce(_optionalChain([k, 'optionalAccess', _66 => _66.network]), () => ( "")))) === want);
     const fp = _optionalChain([kind, 'optionalAccess', _67 => _67.extra, 'optionalAccess', _68 => _68.feePayer]);
     return typeof fp === "string" ? fp : void 0;
   } catch (e32) {
@@ -4109,6 +4226,33 @@ async function fetchFacilitatorFeePayer(url, network, timeoutMs = 8e3) {
     clearTimeout(timer);
   }
 }
+function parseFacilitatorSupported(body) {
+  const kinds = _optionalChain([body, 'optionalAccess', _69 => _69.kinds]);
+  if (!Array.isArray(kinds)) return [];
+  const out = [];
+  for (const k of kinds) {
+    if (!k || typeof k !== "object") continue;
+    const o = k;
+    if (typeof o.scheme !== "string" || typeof o.network !== "string") continue;
+    const fp = _optionalChain([o, 'access', _70 => _70.extra, 'optionalAccess', _71 => _71.feePayer]);
+    out.push({ scheme: o.scheme, network: o.network, ...typeof fp === "string" ? { feePayer: fp } : {} });
+  }
+  return out;
+}
+async function facilitatorCoverage(url, timeoutMs = 8e3) {
+  const base2 = url.replace(/\/+$/, "");
+  const ctrl = new AbortController();
+  const timer = setTimeout(() => ctrl.abort(), timeoutMs);
+  try {
+    const res = await fetch(`${base2}/supported`, { signal: ctrl.signal });
+    if (!res.ok) return [];
+    return parseFacilitatorSupported(await res.json());
+  } catch (e33) {
+    return [];
+  } finally {
+    clearTimeout(timer);
+  }
+}
 function safeStringify(value) {
   return JSON.stringify(value, (_k, v) => typeof v === "bigint" ? v.toString() : v);
 }
@@ -4132,7 +4276,7 @@ async function post(url, body, headers) {
   let json = null;
   try {
     json = await res.json();
-  } catch (e33) {
+  } catch (e34) {
   }
   return { status: res.status, json };
 }
@@ -4386,22 +4530,47 @@ function createPaymentGate(options) {
     const specs = await ready();
     const nonce = genNonce();
     const bazaar = options.discovery ? { bazaar: buildBazaarExtension(options.discovery === true ? {} : options.discovery) } : void 0;
-    const extensions = { ...bazaar, ..._optionalChain([opts, 'optionalAccess', _69 => _69.extensions]) };
+    const accepts = buildAccepts(specs, nonce);
+    const selfDescribe = options.selfDescribe === false ? void 0 : buildSelfDescription({
+      accepts,
+      instruction: describeChallenge({ x402Version: 2, resource: { url: resourceUrl }, accepts })
+    });
+    const rejectionExt = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _72 => _72.extensions]), () => ( {}));
+    const rejectionPiprail = _nullishCoalesce(rejectionExt.piprail, () => ( {}));
+    const bodyPiprail = { ..._nullishCoalesce(selfDescribe, () => ( {})), ...rejectionPiprail };
+    const bodyExtensions = {
+      ...bazaar,
+      ...rejectionExt,
+      ...Object.keys(bodyPiprail).length > 0 ? { piprail: bodyPiprail } : {}
+    };
+    const headerExtensions = {
+      ...bazaar,
+      ...Object.keys(rejectionPiprail).length > 0 ? { piprail: rejectionPiprail } : {}
+    };
     const challenge2 = {
       x402Version: 2,
       resource: {
         url: resourceUrl,
         ...options.description ? { description: options.description } : {}
       },
-      accepts: buildAccepts(specs, nonce),
-      ..._optionalChain([opts, 'optionalAccess', _70 => _70.error]) ? { error: opts.error } : {},
-      ...Object.keys(extensions).length > 0 ? { extensions } : {}
+      accepts,
+      ..._optionalChain([opts, 'optionalAccess', _73 => _73.error]) ? { error: opts.error } : {},
+      ...Object.keys(bodyExtensions).length > 0 ? { extensions: bodyExtensions } : {}
+    };
+    const headerChallenge = {
+      ...challenge2,
+      ...Object.keys(headerExtensions).length > 0 ? { extensions: headerExtensions } : { extensions: void 0 }
     };
-    return { challenge: challenge2, requiredHeader: buildChallengeHeader(challenge2) };
+    return { challenge: challenge2, requiredHeader: buildChallengeHeader(headerChallenge) };
   }
   async function challenge(resourceUrl = "") {
     return makeChallenge(resourceUrl);
   }
+  function landingPage(ch) {
+    return renderLandingPage(
+      buildSelfDescription({ accepts: ch.accepts, instruction: describeChallenge(ch) })
+    );
+  }
   async function asChallenge() {
     const { challenge: c, requiredHeader } = await makeChallenge("");
     return { kind: "challenge", challenge: c, requiredHeader, statusCode: 402 };
@@ -4417,7 +4586,7 @@ function createPaymentGate(options) {
     let amountFormatted = receipt.amount;
     try {
       amountFormatted = _chunkU35MG4TFcjs.formatUnits.call(void 0, BigInt(receipt.amount), spec.decimals);
-    } catch (e34) {
+    } catch (e35) {
     }
     return {
       ...receipt,
@@ -4431,7 +4600,7 @@ function createPaymentGate(options) {
     if (!options.onPaidError) return;
     try {
       options.onPaidError(error, receipt);
-    } catch (e35) {
+    } catch (e36) {
     }
   }
   function fireOnPaid(receipt) {
@@ -4528,7 +4697,7 @@ function createPaymentGate(options) {
     if ("transaction" in exact.payload) {
       try {
         nonce = Buffer.from(exact.payload.transaction, "base64").toString("base64");
-      } catch (e36) {
+      } catch (e37) {
         nonce = exact.payload.transaction;
       }
     } else if ("permit2Authorization" in exact.payload) {
@@ -4597,7 +4766,7 @@ function createPaymentGate(options) {
     if (exact) return verifyExact(exact);
     return asChallenge();
   }
-  return { challenge, verify, describe };
+  return { challenge, verify, describe, landingPage };
 }
 function requirePayment(options) {
   const gate = createPaymentGate(options);
@@ -4637,6 +4806,39 @@ function normaliseHeader(value) {
   return value;
 }
 
+// src/facilitators.ts
+var KNOWN_FACILITATORS = {
+  // PayAI — keyless (no API key), sponsors the gas. Verified 2026-06-14 against
+  // https://facilitator.payai.network/supported (exact · eip155:8453) + the live demo.
+  "eip155:8453": [
+    {
+      url: "https://facilitator.payai.network",
+      keyless: true,
+      schemes: ["exact"],
+      settles: ["eip3009"],
+      note: "PayAI \u2014 keyless, sponsors gas (Base USDC EIP-3009)"
+    }
+  ],
+  // PayAI on Solana — keyless fee-payer sponsor for the SVM exact rail. Verified 2026-06-14.
+  "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp": [
+    {
+      url: "https://facilitator.payai.network",
+      keyless: true,
+      schemes: ["exact"],
+      settles: ["svm"],
+      note: "PayAI \u2014 keyless fee-payer sponsor (Solana SPL SVM)"
+    }
+  ]
+};
+function knownFacilitatorsFor(network) {
+  return _nullishCoalesce(KNOWN_FACILITATORS[network], () => ( []));
+}
+function firstKeylessFacilitator(network, method) {
+  return knownFacilitatorsFor(network).find(
+    (f) => f.keyless && f.schemes.includes("exact") && (method === void 0 || f.settles.includes(method))
+  );
+}
+
 // src/receipts.ts
 var DEFAULT_RETRIES = 5;
 var DEFAULT_TIMEOUT_MS = 1e4;
@@ -4649,7 +4851,7 @@ function isRetryableStatus(status) {
 }
 var sleep = (ms) => ms > 0 ? new Promise((resolve) => setTimeout(resolve, ms)) : Promise.resolve();
 async function signBody(secret, body) {
-  const subtle = _optionalChain([globalThis, 'access', _71 => _71.crypto, 'optionalAccess', _72 => _72.subtle]);
+  const subtle = _optionalChain([globalThis, 'access', _74 => _74.crypto, 'optionalAccess', _75 => _75.subtle]);
   if (!subtle) return null;
   try {
     const enc = new TextEncoder();
@@ -4659,7 +4861,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 (e37) {
+  } catch (e38) {
     return null;
   }
 }
@@ -4719,8 +4921,8 @@ async function deliverReceipt(receipt, options) {
     const retryable = status === void 0 ? true : isRetryableStatus(status);
     const willRetry = !ok && retryable && attempt < maxAttempts;
     try {
-      _optionalChain([onAttempt, 'optionalCall', _73 => _73({ attempt, ok, ...status !== void 0 ? { status } : {}, ...error ? { error } : {}, willRetry })]);
-    } catch (e38) {
+      _optionalChain([onAttempt, 'optionalCall', _76 => _76({ attempt, ok, ...status !== void 0 ? { status } : {}, ...error ? { error } : {}, willRetry })]);
+    } catch (e39) {
     }
     if (ok) return { delivered: true, attempts: attempt, status };
     if (!willRetry) {
@@ -4822,4 +5024,15 @@ async function deliverReceipt(receipt, options) {
 
 
 
-exports.CHAINS = CHAINS; exports.ConfirmationTimeoutError = _chunkU35MG4TFcjs.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 = _chunkU35MG4TFcjs.InsufficientFundsError; exports.InvalidEnvelopeError = _chunkU35MG4TFcjs.InvalidEnvelopeError; exports.MaxRetriesExceededError = _chunkU35MG4TFcjs.MaxRetriesExceededError; exports.MissingDriverError = _chunkU35MG4TFcjs.MissingDriverError; exports.NoCompatibleAcceptError = _chunkU35MG4TFcjs.NoCompatibleAcceptError; exports.NonReplayableBodyError = _chunkU35MG4TFcjs.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.PaymentDeclinedError = _chunkU35MG4TFcjs.PaymentDeclinedError; exports.PaymentTimeoutError = _chunkU35MG4TFcjs.PaymentTimeoutError; exports.PipRailClient = PipRailClient; exports.PipRailError = _chunkU35MG4TFcjs.PipRailError; exports.REGISTER_ATTRIBUTION = REGISTER_ATTRIBUTION; exports.RecipientNotReadyError = _chunkU35MG4TFcjs.RecipientNotReadyError; exports.SettlementError = _chunkU35MG4TFcjs.SettlementError; exports.UnknownTokenError = _chunkU35MG4TFcjs.UnknownTokenError; exports.UnsupportedNetworkError = _chunkU35MG4TFcjs.UnsupportedNetworkError; exports.UnsupportedSchemeError = _chunkU35MG4TFcjs.UnsupportedSchemeError; exports.WalletRequiredError = _chunkU35MG4TFcjs.WalletRequiredError; exports.WrongChainError = _chunkU35MG4TFcjs.WrongChainError; exports.WrongFamilyError = _chunkU35MG4TFcjs.WrongFamilyError; exports.X402_EXACT_PERMIT2_PROXY = X402_EXACT_PERMIT2_PROXY; exports.agentGuide = agentGuide; exports.appendAttribution = appendAttribution; exports.buildBazaarExtension = buildBazaarExtension; exports.buildChallengeHeader = buildChallengeHeader; exports.buildExactAuthorization = buildExactAuthorization; exports.buildExactSignatureHeader = buildExactSignatureHeader; exports.buildOpenApi = buildOpenApi; exports.buildReceiptHeader = buildReceiptHeader; 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.eip3009Abi = eip3009Abi; exports.encodeXPaymentHeader = encodeXPaymentHeader; exports.evaluatePolicy = evaluatePolicy; exports.explainDecline = explainDecline; exports.formatSpendReport = formatSpendReport; exports.getDirectoryInfo = getDirectoryInfo; exports.isPermit2ProxyChain = isPermit2ProxyChain; exports.normalizeNetwork = normalizeNetwork; exports.parseChallenge = parseChallenge; exports.parseExactPaymentHeader = parseExactPaymentHeader; exports.parseExactRequirements = parseExactRequirements; exports.parseReceipt = parseReceipt; exports.parseSettleResponse = parseSettleResponse; exports.parseSignatureHeader = parseSignatureHeader; exports.paymentTools = paymentTools; exports.pickAccept = pickAccept; exports.planAcross = planAcross; exports.readExactDomain = readExactDomain; exports.register402Index = register402Index; exports.registerDriver = registerDriver; exports.registerX402Scan = registerX402Scan; exports.requirePayment = requirePayment; exports.resolveChain = resolveChain; exports.searchOpenIndexes = searchOpenIndexes; exports.settleViaFacilitator = settleViaFacilitator; exports.summarizePlan = summarizePlan; exports.toInsufficientFundsError = _chunkU35MG4TFcjs.toInsufficientFundsError; exports.toInvalidBody = toInvalidBody; exports.verify402IndexDomain = verify402IndexDomain;
+
+
+
+
+
+
+
+
+
+
+
+exports.BRAND = BRAND; exports.CHAINS = CHAINS; exports.ConfirmationTimeoutError = _chunkU35MG4TFcjs.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 = _chunkU35MG4TFcjs.InsufficientFundsError; exports.InvalidEnvelopeError = _chunkU35MG4TFcjs.InvalidEnvelopeError; exports.KNOWN_FACILITATORS = KNOWN_FACILITATORS; exports.MaxRetriesExceededError = _chunkU35MG4TFcjs.MaxRetriesExceededError; exports.MissingDriverError = _chunkU35MG4TFcjs.MissingDriverError; exports.NoCompatibleAcceptError = _chunkU35MG4TFcjs.NoCompatibleAcceptError; exports.NonReplayableBodyError = _chunkU35MG4TFcjs.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 = _chunkU35MG4TFcjs.PaymentDeclinedError; exports.PaymentTimeoutError = _chunkU35MG4TFcjs.PaymentTimeoutError; exports.PipRailClient = PipRailClient; exports.PipRailError = _chunkU35MG4TFcjs.PipRailError; exports.REGISTER_ATTRIBUTION = REGISTER_ATTRIBUTION; exports.RecipientNotReadyError = _chunkU35MG4TFcjs.RecipientNotReadyError; exports.SettlementError = _chunkU35MG4TFcjs.SettlementError; exports.UnknownTokenError = _chunkU35MG4TFcjs.UnknownTokenError; exports.UnsupportedNetworkError = _chunkU35MG4TFcjs.UnsupportedNetworkError; exports.UnsupportedSchemeError = _chunkU35MG4TFcjs.UnsupportedSchemeError; exports.WalletRequiredError = _chunkU35MG4TFcjs.WalletRequiredError; exports.WrongChainError = _chunkU35MG4TFcjs.WrongChainError; exports.WrongFamilyError = _chunkU35MG4TFcjs.WrongFamilyError; exports.X402_EXACT_PERMIT2_PROXY = X402_EXACT_PERMIT2_PROXY; exports.agentGuide = agentGuide; exports.appendAttribution = appendAttribution; exports.buildBazaarExtension = buildBazaarExtension; exports.buildChallengeHeader = buildChallengeHeader; 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.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.readExactDomain = readExactDomain; exports.register402Index = register402Index; exports.registerDriver = registerDriver; exports.registerX402Scan = registerX402Scan; exports.renderLandingPage = renderLandingPage; exports.requirePayment = requirePayment; exports.resolveChain = resolveChain; exports.searchOpenIndexes = searchOpenIndexes; exports.settleViaFacilitator = settleViaFacilitator; exports.summarizePlan = summarizePlan; exports.toInsufficientFundsError = _chunkU35MG4TFcjs.toInsufficientFundsError; exports.toInvalidBody = toInvalidBody; exports.verify402IndexDomain = verify402IndexDomain;