@piprail/sdk 1.11.0 → 1.13.0

package/dist/index.cjs

@@ -1344,6 +1344,8 @@ function decorateOutcome(o) {
 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 = {}) {
@@ -1579,12 +1581,72 @@ async function registerX402Scan(input, signer) {
     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: _nullishCoalesce(pickString(body, "error", "detail", "message"), () => ( `402 Index claim returned HTTP ${res.status}.`)) };
+    }
+    const verificationToken = pickString(body, "verification_token");
+    const verificationHash = await _asyncNullishCoalesce(pickString(body, "verification_hash"), async () => ( (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: _nullishCoalesce(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 = _optionalChain([ext, 'optionalAccess', _8 => _8["sign-in-with-x"]]);
     const info = _nullishCoalesce(_optionalChain([siwx, 'optionalAccess', _9 => _9.info]), () => ( siwx));
+    if (info && info.chainId == null && Array.isArray(_optionalChain([siwx, 'optionalAccess', _10 => _10.supportedChains]))) {
+      const evm = siwx.supportedChains.find(
+        (c) => typeof _optionalChain([c, 'optionalAccess', _11 => _11.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;
     }
@@ -1637,7 +1699,7 @@ function mapRails(accepts) {
 }
 function matchesQuery(r, query) {
   const q = query.toLowerCase();
-  return r.resource.toLowerCase().includes(q) || (_nullishCoalesce(_optionalChain([r, 'access', _10 => _10.name, 'optionalAccess', _11 => _11.toLowerCase, 'call', _12 => _12(), 'access', _13 => _13.includes, 'call', _14 => _14(q)]), () => ( false))) || (_nullishCoalesce(_optionalChain([r, 'access', _15 => _15.description, 'optionalAccess', _16 => _16.toLowerCase, 'call', _17 => _17(), 'access', _18 => _18.includes, 'call', _19 => _19(q)]), () => ( false)));
+  return r.resource.toLowerCase().includes(q) || (_nullishCoalesce(_optionalChain([r, 'access', _12 => _12.name, 'optionalAccess', _13 => _13.toLowerCase, 'call', _14 => _14(), 'access', _15 => _15.includes, 'call', _16 => _16(q)]), () => ( false))) || (_nullishCoalesce(_optionalChain([r, 'access', _17 => _17.description, 'optionalAccess', _18 => _18.toLowerCase, 'call', _19 => _19(), 'access', _20 => _20.includes, 'call', _21 => _21(q)]), () => ( false)));
 }
 function pickString(o, ...keys) {
   for (const k of keys) {
@@ -1668,7 +1730,8 @@ function firstArray(o, ...keys) {
 }
 function hostOf(url) {
   try {
-    return new URL(url).hostname;
+    const withScheme = /^[a-z][a-z0-9+.-]*:\/\//i.test(url) ? url : `https://${url}`;
+    return new URL(withScheme).hostname || url;
   } catch (e20) {
     return url;
   }
@@ -1677,8 +1740,13 @@ function errMsg(err) {
   return err instanceof Error ? err.message : String(err);
 }
 function encodeBase642(str) {
-  if (typeof btoa === "function") return btoa(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.");
 }
 
@@ -1775,7 +1843,7 @@ var SpendLedger = (_class = class {constructor() { _class.prototype.__init.call(
   }
   /** Running total (base units) already spent on this (network, asset). */
   totalFor(network, asset) {
-    return _nullishCoalesce(_optionalChain([this, 'access', _20 => _20.buckets, 'access', _21 => _21.get, 'call', _22 => _22(keyFor(network, asset)), 'optionalAccess', _23 => _23.total]), () => ( 0n));
+    return _nullishCoalesce(_optionalChain([this, 'access', _22 => _22.buckets, 'access', _23 => _23.get, 'call', _24 => _24(keyFor(network, asset)), 'optionalAccess', _25 => _25.total]), () => ( 0n));
   }
   /** An immutable snapshot of all spend so far. */
   summary() {
@@ -1849,7 +1917,7 @@ var PipRailClient = (_class2 = class {
    * as-is) or a plain object (serialised as JSON).
    */
   post(url, body, init) {
-    const headers = new Headers(_optionalChain([init, 'optionalAccess', _24 => _24.headers]));
+    const headers = new Headers(_optionalChain([init, 'optionalAccess', _26 => _26.headers]));
     let payload;
     if (body === void 0 || body === null) {
       payload = void 0;
@@ -1880,7 +1948,7 @@ var PipRailClient = (_class2 = class {
    * "0.05 USDC on Base, within budget → pay it." No funds move.
    */
   async quote(url, init) {
-    const res = await fetch(url, { ..._nullishCoalesce(init, () => ( {})), method: _nullishCoalesce(_optionalChain([init, 'optionalAccess', _25 => _25.method]), () => ( "GET")) });
+    const res = await fetch(url, { ..._nullishCoalesce(init, () => ( {})), method: _nullishCoalesce(_optionalChain([init, 'optionalAccess', _27 => _27.method]), () => ( "GET")) });
     if (res.status !== 402) return null;
     const { quote } = await this.resolveChallenge(url, res);
     return quote;
@@ -1899,7 +1967,7 @@ var PipRailClient = (_class2 = class {
    * on Tron, where a USD₮ transfer can cost real TRX.
    */
   async estimateCost(url, init) {
-    const res = await fetch(url, { ..._nullishCoalesce(init, () => ( {})), method: _nullishCoalesce(_optionalChain([init, 'optionalAccess', _26 => _26.method]), () => ( "GET")) });
+    const res = await fetch(url, { ..._nullishCoalesce(init, () => ( {})), method: _nullishCoalesce(_optionalChain([init, 'optionalAccess', _28 => _28.method]), () => ( "GET")) });
     if (res.status !== 402) return null;
     const { net, accept, quote } = await this.resolveChallenge(url, res);
     const cost = await net.estimateCost(accept);
@@ -1930,7 +1998,7 @@ var PipRailClient = (_class2 = class {
    * the plan yourself. No funds move.
    */
   async planPayment(url, init) {
-    const res = await fetch(url, { ..._nullishCoalesce(init, () => ( {})), method: _nullishCoalesce(_optionalChain([init, 'optionalAccess', _27 => _27.method]), () => ( "GET")) });
+    const res = await fetch(url, { ..._nullishCoalesce(init, () => ( {})), method: _nullishCoalesce(_optionalChain([init, 'optionalAccess', _29 => _29.method]), () => ( "GET")) });
     if (res.status !== 402) return null;
     const challenge = await parseChallenge(res);
     if (!challenge) {
@@ -2052,6 +2120,32 @@ var PipRailClient = (_class2 = class {
     }
     return outcomes.map(decorateOutcome);
   }
+  /**
+   * **402 Index domain verification, step 1 of 2.** A self-registered 402 Index
+   * listing is `pending-review` (see {@link register}); verifying your domain flips
+   * it — and every other pending listing on that domain — to APPROVED/searchable.
+   * Pass the resource URL or a bare domain; returns the `verificationHash` to serve
+   * as the entire body of `verificationUrl` (your `/.well-known/402index-verify.txt`).
+   * Then serve it and call {@link verifyDomain}. Moves no funds; never throws.
+   *
+   * ```ts
+   * const claim = await client.claimDomain('https://api.example.com/report')
+   * // serve claim.verificationHash at claim.verificationUrl, then:
+   * const res = await client.verifyDomain('api.example.com')  // → { ok:true, status:'verified' }
+   * ```
+   */
+  async claimDomain(urlOrDomain, opts = {}) {
+    return claim402IndexDomain(urlOrDomain, opts);
+  }
+  /**
+   * **402 Index domain verification, step 2 of 2.** After {@link claimDomain} and
+   * serving the hash at your `/.well-known/402index-verify.txt`, this tells 402 Index
+   * to re-fetch + approve. On success the domain's pending listings become searchable
+   * (`{ ok:true, status:'verified', servicesCount }`). Moves no funds; never throws.
+   */
+  async verifyDomain(urlOrDomain) {
+    return verify402IndexDomain(urlOrDomain);
+  }
   /**
    * The discovery signer for the bound wallet (its address + a message signer),
    * or `null` if the chain family doesn't support it (EVM does today). For
@@ -2071,7 +2165,7 @@ var PipRailClient = (_class2 = class {
    * streams throw `NonReplayableBodyError`.
    */
   async fetch(url, init) {
-    const body = _optionalChain([init, 'optionalAccess', _28 => _28.body]);
+    const body = _optionalChain([init, 'optionalAccess', _30 => _30.body]);
     if (body !== void 0 && body !== null && !isReplayableBodyInit(body)) {
       throw new (0, _chunkMDLZJGLYcjs.NonReplayableBodyError)(
         "fetch(): init.body is not replayable. Pass a string, FormData, URLSearchParams, ArrayBuffer, or Blob \u2014 not a ReadableStream."
@@ -2083,7 +2177,7 @@ var PipRailClient = (_class2 = class {
     const { net, wallet, challenge } = resolved;
     let accept = resolved.accept;
     let quote = resolved.quote;
-    const autoRoute = _nullishCoalesce(_nullishCoalesce(_optionalChain([init, 'optionalAccess', _29 => _29.autoRoute]), () => ( this.opts.autoRoute)), () => ( false));
+    const autoRoute = _nullishCoalesce(_nullishCoalesce(_optionalChain([init, 'optionalAccess', _31 => _31.autoRoute]), () => ( this.opts.autoRoute)), () => ( false));
     if (autoRoute) {
       const plan = await this.planFromChallenge(net, wallet, challenge, url);
       if (!plan.best) {
@@ -2245,8 +2339,8 @@ var PipRailClient = (_class2 = class {
     }
     const amountBase = BigInt(accept.amount);
     const described = net.describeAsset(accept.asset);
-    const decimals = _nullishCoalesce(_optionalChain([described, 'optionalAccess', _30 => _30.decimals]), () => ( accept.extra.decimals));
-    const symbol = _nullishCoalesce(_optionalChain([described, 'optionalAccess', _31 => _31.symbol]), () => ( accept.extra.symbol));
+    const decimals = _nullishCoalesce(_optionalChain([described, 'optionalAccess', _32 => _32.decimals]), () => ( accept.extra.decimals));
+    const symbol = _nullishCoalesce(_optionalChain([described, 'optionalAccess', _33 => _33.symbol]), () => ( accept.extra.symbol));
     const amountFormatted = _chunkMDLZJGLYcjs.formatUnits.call(void 0, amountBase, decimals);
     const intent = {
       host: hostOf2(url),
@@ -2355,7 +2449,7 @@ var PipRailClient = (_class2 = class {
       accepted: accept,
       payload: { nonce: accept.extra.nonce, txHash: ref }
     };
-    const headers = new Headers(_optionalChain([originalInit, 'optionalAccess', _32 => _32.headers]));
+    const headers = new Headers(_optionalChain([originalInit, 'optionalAccess', _34 => _34.headers]));
     headers.set(HEADER_SIGNATURE, buildSignatureHeader(signature));
     let lastResponse = null;
     let lastReason = null;
@@ -2370,7 +2464,7 @@ var PipRailClient = (_class2 = class {
         () => timeoutController.abort(),
         this.retryTimeoutMs
       );
-      const signal = _optionalChain([originalInit, 'optionalAccess', _33 => _33.signal]) && typeof AbortSignal.any === "function" ? AbortSignal.any([timeoutController.signal, originalInit.signal]) : timeoutController.signal;
+      const signal = _optionalChain([originalInit, 'optionalAccess', _35 => _35.signal]) && typeof AbortSignal.any === "function" ? AbortSignal.any([timeoutController.signal, originalInit.signal]) : timeoutController.signal;
       try {
         lastResponse = await fetch(url, {
           ..._nullishCoalesce(originalInit, () => ( {})),
@@ -2443,10 +2537,10 @@ function buildFundingHint(options, chainLabel) {
     return `Couldn't fully read your wallet on ${chainLabel} (RPC throttled) \u2014 retry; you may already be able to pay ${target.quote.amountFormatted} ${sym}.`;
   }
   const parts = [];
-  if (target.blockers.includes("INSUFFICIENT_TOKEN") && _optionalChain([target, 'access', _34 => _34.shortfall, 'optionalAccess', _35 => _35.token])) {
+  if (target.blockers.includes("INSUFFICIENT_TOKEN") && _optionalChain([target, 'access', _36 => _36.shortfall, 'optionalAccess', _37 => _37.token])) {
     parts.push(`top up ${target.shortfall.token} ${sym}`);
   }
-  if (target.blockers.includes("INSUFFICIENT_GAS") && _optionalChain([target, 'access', _36 => _36.shortfall, 'optionalAccess', _37 => _37.native])) {
+  if (target.blockers.includes("INSUFFICIENT_GAS") && _optionalChain([target, 'access', _38 => _38.shortfall, 'optionalAccess', _39 => _39.native])) {
     parts.push(`add ~${target.shortfall.native} ${target.cost.feeSymbol} for gas`);
   }
   return parts.length ? `Can't settle on ${chainLabel}: ${parts.join(" and ")} (to pay ${target.quote.amountFormatted} ${sym}).` : `Can't settle on ${chainLabel} for ${target.quote.amountFormatted} ${sym}.`;
@@ -2460,7 +2554,7 @@ async function planAcross(clients, url, init) {
   const status = best ? "ready" : options.some((o) => o.state === "unknown") ? "unknown" : "blocked";
   return {
     url,
-    network: _nullishCoalesce(_optionalChain([best, 'optionalAccess', _38 => _38.accept, 'access', _39 => _39.network]), () => ( live[0].network)),
+    network: _nullishCoalesce(_optionalChain([best, 'optionalAccess', _40 => _40.accept, 'access', _41 => _41.network]), () => ( live[0].network)),
     status,
     payable: best !== null,
     best,
@@ -2493,8 +2587,8 @@ function isReplayableBodyInit(value) {
 async function readInvalidReason(response) {
   try {
     const body = await response.clone().json();
-    const ext = _optionalChain([body, 'optionalAccess', _40 => _40.extensions]);
-    const piprail = _optionalChain([ext, 'optionalAccess', _41 => _41.piprail]);
+    const ext = _optionalChain([body, 'optionalAccess', _42 => _42.extensions]);
+    const piprail = _optionalChain([ext, 'optionalAccess', _43 => _43.piprail]);
     if (piprail && typeof piprail.code === "string") {
       return {
         error: piprail.code,
@@ -2698,7 +2792,7 @@ function paymentTools(client) {
     },
     {
       name: "piprail_register",
-      description: "List an x402 payment-gated resource YOU run on the open indexes so other agents can discover it. Default target is 402 Index \u2014 no auth, no signature, no payment; a self-registered listing is pending review (verify your domain on 402index.io for instant approval). Returns one outcome per index ({ source, ok, detail, visibility, note }); a step the chain can't satisfy comes back ok:false with the reason. Moves no funds; nothing is PipRail-hosted.",
+      description: "List an x402 payment-gated resource YOU run on the open indexes so other agents can discover it. Default target is 402 Index \u2014 no auth, no signature, no payment; a self-registered listing is pending review (verify your domain on 402index.io for instant approval). Returns one outcome per index ({ source, ok, detail, visibility, note }); a step the chain can't satisfy comes back ok:false with the reason. Moves no funds; nothing is PipRail-hosted. NOTE: index/agent payers are overwhelmingly standard `exact` clients \u2014 a default onchain-proof-only gate gets listed but they cannot pay it, so add an `exact` rail (and set the gate's `discovery` option, required for x402scan) to be usefully discoverable AND payable.",
       annotations: {
         title: "Register an x402 endpoint",
         readOnlyHint: false,
@@ -2732,6 +2826,87 @@ function paymentTools(client) {
   ];
 }
 
+// src/discovery.ts
+var GENERATOR = "@piprail/sdk \xB7 https://piprail.com";
+function buildBazaarExtension(descriptor = {}) {
+  const method = (_nullishCoalesce(descriptor.method, () => ( "GET"))).toUpperCase();
+  const queryParams = _nullishCoalesce(descriptor.queryParams, () => ( {}));
+  return {
+    info: {
+      input: { type: "http", method, queryParams },
+      output: _nullishCoalesce(descriptor.output, () => ( { type: "json" }))
+    },
+    schema: {
+      $schema: "https://json-schema.org/draft/2020-12/schema",
+      type: "object",
+      properties: {
+        input: {
+          type: "object",
+          properties: {
+            type: { type: "string", const: "http" },
+            method: { type: "string", enum: ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD"] },
+            queryParams: { type: "object", properties: queryParams, additionalProperties: false }
+          },
+          required: ["type", "method"],
+          additionalProperties: false
+        }
+      },
+      required: ["input"]
+    }
+  };
+}
+function pathOf(url) {
+  try {
+    return new URL(url).pathname || "/";
+  } catch (e26) {
+    return url.startsWith("/") ? url : `/${url}`;
+  }
+}
+function buildOpenApi(input) {
+  const paths = {};
+  for (const r of input.resources) {
+    const path = pathOf(r.url);
+    const method = (_nullishCoalesce(r.method, () => ( "GET"))).toLowerCase();
+    const op = {
+      ...r.description ? { summary: r.description } : {},
+      responses: {
+        "200": { description: "Paid \u2014 the resource." },
+        "402": { description: "Payment required (x402)." }
+      },
+      "x-payment-info": {
+        x402Version: 2,
+        accepts: r.accepts
+      }
+    };
+    paths[path] = { ..._nullishCoalesce(paths[path], () => ( {})), [method]: op };
+  }
+  return {
+    openapi: "3.1.0",
+    info: { title: _nullishCoalesce(input.title, () => ( "PipRail x402 resources")), version: _nullishCoalesce(input.version, () => ( "1.0.0")) },
+    servers: [{ url: input.origin }],
+    paths,
+    // "Built with @piprail/sdk" — default on (opt out with attribution:false). At the
+    // document ROOT so `info` stays exactly { title, version }.
+    ...input.attribution === false ? {} : { "x-generator": GENERATOR },
+    ...input.ownershipProofs && input.ownershipProofs.length > 0 ? { "x-agentcash-provenance": { ownershipProofs: input.ownershipProofs } } : {}
+  };
+}
+function buildWellKnownX402(input) {
+  return {
+    version: 1,
+    resources: input.resources.map((r) => r.url),
+    ...input.ownershipProofs && input.ownershipProofs.length > 0 ? { ownershipProofs: input.ownershipProofs } : {}
+  };
+}
+function buildX402DnsTxt(input) {
+  const descriptor = input.descriptor ? `descriptor=${input.descriptor};` : "";
+  return {
+    name: `_x402.${input.host}`,
+    type: "TXT",
+    value: `v=x4021;${descriptor}url=${input.discoveryUrl}`
+  };
+}
+
 // src/facilitator.ts
 function safeStringify(value) {
   return JSON.stringify(value, (_k, v) => typeof v === "bigint" ? v.toString() : v);
@@ -2756,7 +2931,7 @@ async function post(url, body, headers) {
   let json = null;
   try {
     json = await res.json();
-  } catch (e26) {
+  } catch (e27) {
   }
   return { status: res.status, json };
 }
@@ -2980,6 +3155,8 @@ function createPaymentGate(options) {
   async function makeChallenge(resourceUrl, opts) {
     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', _44 => _44.extensions]) };
     const challenge2 = {
       x402Version: 2,
       resource: {
@@ -2987,8 +3164,8 @@ function createPaymentGate(options) {
         ...options.description ? { description: options.description } : {}
       },
       accepts: buildAccepts(specs, nonce),
-      ..._optionalChain([opts, 'optionalAccess', _42 => _42.error]) ? { error: opts.error } : {},
-      ..._optionalChain([opts, 'optionalAccess', _43 => _43.extensions]) ? { extensions: opts.extensions } : {}
+      ..._optionalChain([opts, 'optionalAccess', _45 => _45.error]) ? { error: opts.error } : {},
+      ...Object.keys(extensions).length > 0 ? { extensions } : {}
     };
     return { challenge: challenge2, requiredHeader: buildChallengeHeader(challenge2) };
   }
@@ -3010,7 +3187,7 @@ function createPaymentGate(options) {
     if (options.onPaid) {
       try {
         options.onPaid(receipt);
-      } catch (e27) {
+      } catch (e28) {
       }
     }
   }
@@ -3175,60 +3352,6 @@ function normaliseHeader(value) {
   return value;
 }
 
-// src/discovery.ts
-var GENERATOR = "@piprail/sdk \xB7 https://piprail.com";
-function pathOf(url) {
-  try {
-    return new URL(url).pathname || "/";
-  } catch (e28) {
-    return url.startsWith("/") ? url : `/${url}`;
-  }
-}
-function buildOpenApi(input) {
-  const paths = {};
-  for (const r of input.resources) {
-    const path = pathOf(r.url);
-    const method = (_nullishCoalesce(r.method, () => ( "GET"))).toLowerCase();
-    const op = {
-      ...r.description ? { summary: r.description } : {},
-      responses: {
-        "200": { description: "Paid \u2014 the resource." },
-        "402": { description: "Payment required (x402)." }
-      },
-      "x-payment-info": {
-        x402Version: 2,
-        accepts: r.accepts,
-        bazaar: { discoverable: true }
-      }
-    };
-    paths[path] = { ..._nullishCoalesce(paths[path], () => ( {})), [method]: op };
-  }
-  return {
-    openapi: "3.1.0",
-    info: { title: _nullishCoalesce(input.title, () => ( "PipRail x402 resources")), version: _nullishCoalesce(input.version, () => ( "1.0.0")) },
-    servers: [{ url: input.origin }],
-    paths,
-    // "Built with @piprail/sdk" — default on (opt out with attribution:false). At the
-    // document ROOT so `info` stays exactly { title, version }.
-    ...input.attribution === false ? {} : { "x-generator": GENERATOR },
-    ...input.ownershipProofs && input.ownershipProofs.length > 0 ? { "x-agentcash-provenance": { ownershipProofs: input.ownershipProofs } } : {}
-  };
-}
-function buildWellKnownX402(input) {
-  return {
-    version: 1,
-    resources: input.resources.map((r) => r.url),
-    ...input.ownershipProofs && input.ownershipProofs.length > 0 ? { ownershipProofs: input.ownershipProofs } : {}
-  };
-}
-function buildX402DnsTxt(input) {
-  const descriptor = input.descriptor ? `descriptor=${input.descriptor};` : "";
-  return {
-    name: `_x402.${input.host}`,
-    type: "TXT",
-    value: `v=x4021;${descriptor}url=${input.discoveryUrl}`
-  };
-}
 
 
 
@@ -3290,4 +3413,6 @@ function buildX402DnsTxt(input) {
 
 
 
-exports.CHAINS = CHAINS; exports.ConfirmationTimeoutError = _chunkMDLZJGLYcjs.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 = _chunkMDLZJGLYcjs.InsufficientFundsError; exports.InvalidEnvelopeError = _chunkMDLZJGLYcjs.InvalidEnvelopeError; exports.MaxRetriesExceededError = _chunkMDLZJGLYcjs.MaxRetriesExceededError; exports.MissingDriverError = _chunkMDLZJGLYcjs.MissingDriverError; exports.NoCompatibleAcceptError = _chunkMDLZJGLYcjs.NoCompatibleAcceptError; exports.NonReplayableBodyError = _chunkMDLZJGLYcjs.NonReplayableBodyError; exports.PaymentDeclinedError = _chunkMDLZJGLYcjs.PaymentDeclinedError; exports.PaymentTimeoutError = _chunkMDLZJGLYcjs.PaymentTimeoutError; exports.PipRailClient = PipRailClient; exports.PipRailError = _chunkMDLZJGLYcjs.PipRailError; exports.RecipientNotReadyError = _chunkMDLZJGLYcjs.RecipientNotReadyError; exports.SettlementError = _chunkMDLZJGLYcjs.SettlementError; exports.UnknownTokenError = _chunkMDLZJGLYcjs.UnknownTokenError; exports.UnsupportedNetworkError = _chunkMDLZJGLYcjs.UnsupportedNetworkError; exports.WrongChainError = _chunkMDLZJGLYcjs.WrongChainError; exports.WrongFamilyError = _chunkMDLZJGLYcjs.WrongFamilyError; exports.buildChallengeHeader = buildChallengeHeader; exports.buildExactAuthorization = buildExactAuthorization; exports.buildOpenApi = buildOpenApi; exports.buildReceiptHeader = buildReceiptHeader; exports.buildSignatureHeader = buildSignatureHeader; exports.buildWellKnownX402 = buildWellKnownX402; exports.buildX402DnsTxt = buildX402DnsTxt; exports.chainIdForExactNetwork = chainIdForExactNetwork; exports.createPaymentGate = createPaymentGate; exports.decorateOutcome = decorateOutcome; exports.eip3009Abi = eip3009Abi; exports.encodeXPaymentHeader = encodeXPaymentHeader; exports.evaluatePolicy = evaluatePolicy; exports.getDirectoryInfo = getDirectoryInfo; exports.normalizeNetwork = normalizeNetwork; exports.parseChallenge = parseChallenge; exports.parseExactPaymentHeader = parseExactPaymentHeader; exports.parseExactRequirements = parseExactRequirements; exports.parseReceipt = parseReceipt; 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.toInsufficientFundsError = _chunkMDLZJGLYcjs.toInsufficientFundsError; exports.toInvalidBody = toInvalidBody;
+
+
+exports.CHAINS = CHAINS; exports.ConfirmationTimeoutError = _chunkMDLZJGLYcjs.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 = _chunkMDLZJGLYcjs.InsufficientFundsError; exports.InvalidEnvelopeError = _chunkMDLZJGLYcjs.InvalidEnvelopeError; exports.MaxRetriesExceededError = _chunkMDLZJGLYcjs.MaxRetriesExceededError; exports.MissingDriverError = _chunkMDLZJGLYcjs.MissingDriverError; exports.NoCompatibleAcceptError = _chunkMDLZJGLYcjs.NoCompatibleAcceptError; exports.NonReplayableBodyError = _chunkMDLZJGLYcjs.NonReplayableBodyError; exports.PaymentDeclinedError = _chunkMDLZJGLYcjs.PaymentDeclinedError; exports.PaymentTimeoutError = _chunkMDLZJGLYcjs.PaymentTimeoutError; exports.PipRailClient = PipRailClient; exports.PipRailError = _chunkMDLZJGLYcjs.PipRailError; exports.RecipientNotReadyError = _chunkMDLZJGLYcjs.RecipientNotReadyError; exports.SettlementError = _chunkMDLZJGLYcjs.SettlementError; exports.UnknownTokenError = _chunkMDLZJGLYcjs.UnknownTokenError; exports.UnsupportedNetworkError = _chunkMDLZJGLYcjs.UnsupportedNetworkError; exports.WrongChainError = _chunkMDLZJGLYcjs.WrongChainError; exports.WrongFamilyError = _chunkMDLZJGLYcjs.WrongFamilyError; exports.buildBazaarExtension = buildBazaarExtension; exports.buildChallengeHeader = buildChallengeHeader; exports.buildExactAuthorization = buildExactAuthorization; exports.buildOpenApi = buildOpenApi; exports.buildReceiptHeader = buildReceiptHeader; exports.buildSignatureHeader = buildSignatureHeader; exports.buildWellKnownX402 = buildWellKnownX402; exports.buildX402DnsTxt = buildX402DnsTxt; exports.chainIdForExactNetwork = chainIdForExactNetwork; exports.claim402IndexDomain = claim402IndexDomain; exports.createPaymentGate = createPaymentGate; exports.decorateOutcome = decorateOutcome; exports.eip3009Abi = eip3009Abi; exports.encodeXPaymentHeader = encodeXPaymentHeader; exports.evaluatePolicy = evaluatePolicy; exports.getDirectoryInfo = getDirectoryInfo; exports.normalizeNetwork = normalizeNetwork; exports.parseChallenge = parseChallenge; exports.parseExactPaymentHeader = parseExactPaymentHeader; exports.parseExactRequirements = parseExactRequirements; exports.parseReceipt = parseReceipt; 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.toInsufficientFundsError = _chunkMDLZJGLYcjs.toInsufficientFundsError; exports.toInvalidBody = toInvalidBody; exports.verify402IndexDomain = verify402IndexDomain;

package/dist/index.d.cts

@@ -4365,6 +4365,55 @@ declare function register402Index(input: RegisterInput): Promise<RegisterOutcome
 declare function registerX402Scan(input: {
     url: string;
 }, signer: DiscoverySigner): Promise<RegisterOutcome>;
+/** What {@link claim402IndexDomain} returns — the proof to SERVE so 402 Index will
+ *  approve your domain (and flip your `pending-review` listings to searchable). */
+interface DomainClaim {
+    ok: boolean;
+    domain: string;
+    /** The exact text to serve as the ENTIRE body of `verificationUrl` — this is what
+     *  402 Index fetches and checks (the SHA-256 of the token). Always populated on
+     *  success: read from the response, or computed as `sha256(verificationToken)` if
+     *  the API returns only the token. Serve THIS. */
+    verificationHash?: string;
+    /** The raw 64-hex token 402 Index issued (the preimage of `verificationHash`). */
+    verificationToken?: string;
+    /** Where to serve `verificationHash` — your `https://<domain>/.well-known/402index-verify.txt`. */
+    verificationUrl?: string;
+    /** 402 Index's own human instructions. */
+    instructions?: string;
+    httpStatus?: number;
+    /** Failure reason when `ok:false`. */
+    detail?: string;
+}
+/** What {@link verify402IndexDomain} returns once the proof is in place. */
+interface DomainVerification {
+    ok: boolean;
+    domain: string;
+    /** 402 Index's status string, e.g. `'verified'`. */
+    status?: string;
+    /** How many of your pending listings were approved by the verification. */
+    servicesCount?: number;
+    httpStatus?: number;
+    detail?: string;
+}
+/**
+ * Step 1 of 402 Index domain verification: claim the host of `domainOrUrl`. 402 Index
+ * lists a self-registered resource as PENDING REVIEW; verifying the domain approves it
+ * (and every other pending listing on that domain) so it becomes searchable. Returns the
+ * `verificationHash` to serve as the entire body of `verificationUrl`
+ * (`https://<domain>/.well-known/402index-verify.txt`). Then call {@link verify402IndexDomain}.
+ * No funds move. Never throws.
+ */
+declare function claim402IndexDomain(domainOrUrl: string, opts?: {
+    contactEmail?: string;
+}): Promise<DomainClaim>;
+/**
+ * Step 2 of 402 Index domain verification: after {@link claim402IndexDomain} and serving
+ * the `verificationHash` at `verificationUrl`, tell 402 Index to re-fetch + approve. On
+ * success, the domain's pending listings become searchable (`status:'verified'`,
+ * `servicesCount` approved). No funds move. Never throws.
+ */
+declare function verify402IndexDomain(domainOrUrl: string): Promise<DomainVerification>;
 
 interface PaymentPolicy {
     /** Per-payment ceiling, human-readable (e.g. '0.10'). Compared using the
@@ -4849,6 +4898,30 @@ declare class PipRailClient {
      * on them before calling.
      */
     register(url: string, opts?: RegisterOptions): Promise<RegisterOutcome[]>;
+    /**
+     * **402 Index domain verification, step 1 of 2.** A self-registered 402 Index
+     * listing is `pending-review` (see {@link register}); verifying your domain flips
+     * it — and every other pending listing on that domain — to APPROVED/searchable.
+     * Pass the resource URL or a bare domain; returns the `verificationHash` to serve
+     * as the entire body of `verificationUrl` (your `/.well-known/402index-verify.txt`).
+     * Then serve it and call {@link verifyDomain}. Moves no funds; never throws.
+     *
+     * ```ts
+     * const claim = await client.claimDomain('https://api.example.com/report')
+     * // serve claim.verificationHash at claim.verificationUrl, then:
+     * const res = await client.verifyDomain('api.example.com')  // → { ok:true, status:'verified' }
+     * ```
+     */
+    claimDomain(urlOrDomain: string, opts?: {
+        contactEmail?: string;
+    }): Promise<DomainClaim>;
+    /**
+     * **402 Index domain verification, step 2 of 2.** After {@link claimDomain} and
+     * serving the hash at your `/.well-known/402index-verify.txt`, this tells 402 Index
+     * to re-fetch + approve. On success the domain's pending listings become searchable
+     * (`{ ok:true, status:'verified', servicesCount }`). Moves no funds; never throws.
+     */
+    verifyDomain(urlOrDomain: string): Promise<DomainVerification>;
     /**
      * The discovery signer for the bound wallet (its address + a message signer),
      * or `null` if the chain family doesn't support it (EVM does today). For
@@ -5061,10 +5134,6 @@ interface OpenApiOperation {
     'x-payment-info': {
         x402Version: 2;
         accepts: PaymentRail[];
-        /** Bazaar-style input schema marker so a strict index doesn't "skip" the op. */
-        bazaar: {
-            discoverable: true;
-        };
     };
 }
 /** x402scan's legacy origin file (`/.well-known/x402`). */
@@ -5073,6 +5142,46 @@ interface WellKnownX402 {
     resources: string[];
     ownershipProofs?: string[];
 }
+/**
+ * Describes a resource's INPUT for discovery. The open indexes that REQUIRE an
+ * input schema (x402scan rejects a listing without one) read this from a
+ * `extensions.bazaar` block. Pass it to a gate's `discovery` option (emits the
+ * block in the 402 challenge) or build it directly with {@link buildBazaarExtension}.
+ */
+interface DiscoveryDescriptor {
+    /** HTTP method the resource answers. Default `'GET'`. */
+    method?: string;
+    /** Query params the resource reads, as a JSON-Schema `properties` object
+     *  (name → schema). Default `{}` — a no-input GET. */
+    queryParams?: Record<string, unknown>;
+    /** Optional output hint (shape/example) for a richer listing. */
+    output?: {
+        type?: string;
+        example?: unknown;
+    };
+}
+/** The `extensions.bazaar` discovery block (the x402 "bazaar" convention the open
+ *  indexes parse: `info.input` describes the request, `schema` is its JSON Schema). */
+interface BazaarExtension {
+    info: {
+        input: {
+            type: 'http';
+            method: string;
+            queryParams: Record<string, unknown>;
+        };
+        output?: {
+            type?: string;
+            example?: unknown;
+        };
+    };
+    schema: Record<string, unknown>;
+}
+/**
+ * Build the `extensions.bazaar` block that satisfies x402scan's mandatory input-schema
+ * check, from a {@link DiscoveryDescriptor}. Pure. Defaults to a no-input GET — the
+ * minimal shape a live x402scan listing accepts.
+ */
+declare function buildBazaarExtension(descriptor?: DiscoveryDescriptor): BazaarExtension;
 /** The `_x402` DNS TXT pointer record (experimental draft). */
 interface X402DnsRecord {
     name: string;
@@ -5224,6 +5333,14 @@ interface RequirePaymentOptions {
      * Omit to keep the gate exactly as today (`onchain-proof` only).
      */
     exact?: ExactRailOption;
+    /**
+     * Make this gate's 402 self-describing for the open indexes — **x402scan REQUIRES
+     * an input schema or it won't list the resource.** Set `true` for a no-input GET,
+     * or pass a {@link DiscoveryDescriptor} to describe the request. Emits an
+     * `extensions.bazaar` block in the 402 challenge. Opt-in; omitting it leaves the
+     * challenge byte-identical to before.
+     */
+    discovery?: boolean | DiscoveryDescriptor;
 }
 type VerifyPaymentResult = {
     kind: 'paid';
@@ -5830,4 +5947,4 @@ declare function readExactDomain(publicClient: PublicClient, asset: string): Pro
     version: string;
 } | null>;
 
-export { type AcceptOption, type AddressId, type AgentTool, type AlgorandToken, type AptosToken, type AssetId, type BuildExactParams, CHAINS, type Caip2, type ChainFamily, type ChainInput, type ChainName, type ChainPreset, type ChainSelector, type ConfirmInfo, ConfirmationTimeoutError, type CostEstimate, DIRECTORY_INFO, type DirectoryInfo, type DiscoverOptions, type DiscoveredRail, type DiscoveredResource, type DiscoverySigner, type DiscoverySource, EIP3009_TYPES, EXACT_NETWORK_SLUGS, type EvmToken, type ExactAccept, type ExactAuthorization, type ExactAuthorizationWire, type ExactPaymentPayload, type ExactRailOption, type ExpressLikeMiddleware, type ExpressLikeNext, type ExpressLikeRequest, type ExpressLikeResponse, type FacilitatorConfig, type FacilitatorPaymentRequirements, GENERATOR, HEADER_REQUIRED, HEADER_RESPONSE, HEADER_RESPONSE_V1, HEADER_SIGNATURE, HEADER_SIGNATURE_V1, InsufficientFundsError, InvalidEnvelopeError, type ListingVisibility, type ManifestInput, MaxRetriesExceededError, MissingDriverError, type NearToken, NoCompatibleAcceptError, NonReplayableBodyError, type OpenApiDocument, type OpenApiOperation, type ParsedExactPayment, type PayBlocker, type PayOption, type PayWarning, PaymentDeclinedError, type PaymentDriver, type PaymentGate, type PaymentIntent, type PaymentPlan, type PaymentPolicy, type PaymentRail, PaymentTimeoutError, PipRailClient, type PipRailClientOptions, type PipRailCostQuote, PipRailError, type PipRailEvent, type PipRailQuote, type PolicyDecision, RecipientNotReadyError, type RecipientReason, type RegisterInput, type RegisterOptions, type RegisterOutcome, type RequirePaymentOptions, type ResolveOptions, type ResolvedChain, type ResolvedNetwork, type ResolvedToken, type ResourceDescription, type SearchOpenIndexesOptions, type SettleViaFacilitatorInput, SettlementError, type SolanaToken, type SpendAssetTotal, type SpendRecord, type SpendSummary, type StellarToken, type SuiToken, type TokenInfo, type TokenInput, type TonToken, type ToolAnnotations, type TronToken, UnknownTokenError, UnsupportedNetworkError, type VerifyErrorCode, type VerifyPaymentResult, type VerifyResult, type WalletBalance, type WalletHandle, type WalletInput, type WellKnownX402, WrongChainError, WrongFamilyError, type X402AcceptEntry, type X402AnyAccept, type X402Challenge, type X402DnsRecord, type X402ExactAcceptEntry, type X402InvalidBody, type X402PaymentSignature, type X402Receipt, type X402ResourceObject, type XrplToken, buildChallengeHeader, buildExactAuthorization, buildOpenApi, buildReceiptHeader, buildSignatureHeader, buildWellKnownX402, buildX402DnsTxt, chainIdForExactNetwork, createPaymentGate, decorateOutcome, eip3009Abi, encodeXPaymentHeader, evaluatePolicy, getDirectoryInfo, normalizeNetwork, parseChallenge, parseExactPaymentHeader, parseExactRequirements, parseReceipt, parseSignatureHeader, paymentTools, pickAccept, planAcross, readExactDomain, register402Index, registerDriver, registerX402Scan, requirePayment, resolveChain, searchOpenIndexes, settleViaFacilitator, toInsufficientFundsError, toInvalidBody };
+export { type AcceptOption, type AddressId, type AgentTool, type AlgorandToken, type AptosToken, type AssetId, type BazaarExtension, type BuildExactParams, CHAINS, type Caip2, type ChainFamily, type ChainInput, type ChainName, type ChainPreset, type ChainSelector, type ConfirmInfo, ConfirmationTimeoutError, type CostEstimate, DIRECTORY_INFO, type DirectoryInfo, type DiscoverOptions, type DiscoveredRail, type DiscoveredResource, type DiscoveryDescriptor, type DiscoverySigner, type DiscoverySource, type DomainClaim, type DomainVerification, EIP3009_TYPES, EXACT_NETWORK_SLUGS, type EvmToken, type ExactAccept, type ExactAuthorization, type ExactAuthorizationWire, type ExactPaymentPayload, type ExactRailOption, type ExpressLikeMiddleware, type ExpressLikeNext, type ExpressLikeRequest, type ExpressLikeResponse, type FacilitatorConfig, type FacilitatorPaymentRequirements, GENERATOR, HEADER_REQUIRED, HEADER_RESPONSE, HEADER_RESPONSE_V1, HEADER_SIGNATURE, HEADER_SIGNATURE_V1, InsufficientFundsError, InvalidEnvelopeError, type ListingVisibility, type ManifestInput, MaxRetriesExceededError, MissingDriverError, type NearToken, NoCompatibleAcceptError, NonReplayableBodyError, type OpenApiDocument, type OpenApiOperation, type ParsedExactPayment, type PayBlocker, type PayOption, type PayWarning, PaymentDeclinedError, type PaymentDriver, type PaymentGate, type PaymentIntent, type PaymentPlan, type PaymentPolicy, type PaymentRail, PaymentTimeoutError, PipRailClient, type PipRailClientOptions, type PipRailCostQuote, PipRailError, type PipRailEvent, type PipRailQuote, type PolicyDecision, RecipientNotReadyError, type RecipientReason, type RegisterInput, type RegisterOptions, type RegisterOutcome, type RequirePaymentOptions, type ResolveOptions, type ResolvedChain, type ResolvedNetwork, type ResolvedToken, type ResourceDescription, type SearchOpenIndexesOptions, type SettleViaFacilitatorInput, SettlementError, type SolanaToken, type SpendAssetTotal, type SpendRecord, type SpendSummary, type StellarToken, type SuiToken, type TokenInfo, type TokenInput, type TonToken, type ToolAnnotations, type TronToken, UnknownTokenError, UnsupportedNetworkError, type VerifyErrorCode, type VerifyPaymentResult, type VerifyResult, type WalletBalance, type WalletHandle, type WalletInput, type WellKnownX402, WrongChainError, WrongFamilyError, type X402AcceptEntry, type X402AnyAccept, type X402Challenge, type X402DnsRecord, type X402ExactAcceptEntry, type X402InvalidBody, type X402PaymentSignature, type X402Receipt, type X402ResourceObject, type XrplToken, buildBazaarExtension, buildChallengeHeader, buildExactAuthorization, buildOpenApi, buildReceiptHeader, buildSignatureHeader, buildWellKnownX402, buildX402DnsTxt, chainIdForExactNetwork, claim402IndexDomain, createPaymentGate, decorateOutcome, eip3009Abi, encodeXPaymentHeader, evaluatePolicy, getDirectoryInfo, normalizeNetwork, parseChallenge, parseExactPaymentHeader, parseExactRequirements, parseReceipt, parseSignatureHeader, paymentTools, pickAccept, planAcross, readExactDomain, register402Index, registerDriver, registerX402Scan, requirePayment, resolveChain, searchOpenIndexes, settleViaFacilitator, toInsufficientFundsError, toInvalidBody, verify402IndexDomain };