@absol-labs/agent 0.9.1 → 0.11.0

package/dist/x402/facilitator.js

@@ -1,7 +1,18 @@
 import { z } from "zod";
 import { signedSpendMandateSchema, } from "../mandates/mandate.js";
 import { VerifiedStreamAgentClient, } from "../sdk/client.js";
-export const X402_SCHEME = "streamproof-verified-stream";
+/**
+ * Immutable wire constant for the Metrik-native 402 scheme. The value is
+ * historical (`streamproof-*` predates the Metrik rename) and MUST NOT change:
+ * the live gateway and deployed callers depend on it.
+ */
+export const METRIK_STREAM_SCHEME = "streamproof-verified-stream";
+/**
+ * Request header carrying the Metrik verified-stream payload. Deliberately NOT
+ * `x-payment`: that header belongs to the x402 protocol, which this flow does
+ * not implement.
+ */
+export const METRIK_PAYMENT_HEADER = "x-metrik-payment";
 const addressSchema = z.string().regex(/^0x[0-9a-fA-F]{40}$/);
 const bytes32Schema = z.string().regex(/^0x[0-9a-fA-F]{64}$/);
 export const verifiedStreamRequirementsSchema = z.object({
@@ -13,12 +24,12 @@ export const verifiedStreamRequirementsSchema = z.object({
     maxDurationSeconds: z.number().int().positive(),
     maxBudgetUsdc: z.bigint().positive(),
 });
-export const x402StreamChallengeSchema = z.object({
-    scheme: z.literal(X402_SCHEME),
+export const streamChallengeSchema = z.object({
+    scheme: z.literal(METRIK_STREAM_SCHEME),
     requirements: verifiedStreamRequirementsSchema,
 });
-export const x402OpenPayloadSchema = z.object({
-    challenge: x402StreamChallengeSchema,
+export const streamOpenPayloadSchema = z.object({
+    challenge: streamChallengeSchema,
     signedMandate: signedSpendMandateSchema,
 });
 const warnedFacilitatorGaps = new Set();
@@ -30,9 +41,11 @@ function warnFacilitatorOnce(key, message) {
     warnedFacilitatorGaps.add(key);
     console.error(message);
 }
-export class X402PayloadError extends Error {
+export class StreamPayloadError extends Error {
     constructor(message) {
         super(message);
+        // Unchanged on purpose: `error.name` is an observable value that existing
+        // consumers may match on. The class was renamed; its `name` was not.
         this.name = "X402PayloadError";
     }
 }
@@ -55,13 +68,14 @@ export class DeliveryProofUnavailableError extends Error {
  * facilitator denies the open in this case (fail-closed, buyer-favoring) rather
  * than proceeding on an unverified assumption of "0 spent / none revoked".
  */
-export class X402SpendControlUnavailableError extends Error {
+export class SpendControlUnavailableError extends Error {
     constructor(message) {
         super(message);
+        // Unchanged on purpose: see StreamPayloadError above.
         this.name = "X402SpendControlUnavailableError";
     }
 }
-export class VerifiedStreamX402Facilitator {
+export class VerifiedStreamFacilitator {
     agentClient;
     deliveryProofs;
     sdkConfig;
@@ -87,19 +101,19 @@ export class VerifiedStreamX402Facilitator {
         // can NEVER verify the cap. `open()` therefore fails CLOSED (denies) until
         // both resolvers are wired; warn once so the reason is visible at deploy time.
         if (options.resolveSpentSoFarUsdc === undefined) {
-            warnFacilitatorOnce("x402-spent", "[metrik] x402 facilitator: no resolveSpentSoFarUsdc wired — the mandate cumulative cap (maxTotalUsdc) cannot be verified, so open() will DENY every spend (fail-closed) until a resolver is wired.");
+            warnFacilitatorOnce("metrik-stream-spent", "[metrik] Metrik verified-stream facilitator: no resolveSpentSoFarUsdc wired — the mandate cumulative cap (maxTotalUsdc) cannot be verified, so open() will DENY every spend (fail-closed) until a resolver is wired.");
         }
         if (options.resolveRevokedMandateIds === undefined) {
-            warnFacilitatorOnce("x402-revocation", "[metrik] x402 facilitator: no resolveRevokedMandateIds wired — revocation state cannot be verified, so open() will DENY every spend (fail-closed) until a resolver is wired.");
+            warnFacilitatorOnce("metrik-stream-revocation", "[metrik] Metrik verified-stream facilitator: no resolveRevokedMandateIds wired — revocation state cannot be verified, so open() will DENY every spend (fail-closed) until a resolver is wired.");
         }
     }
     challenge(req) {
         const requirements = verifiedStreamRequirementsSchema.parse(req);
         assertSettlementTarget(requirements, this.sdkConfig);
-        return { scheme: X402_SCHEME, requirements };
+        return { scheme: METRIK_STREAM_SCHEME, requirements };
     }
     async open(payloadHeader) {
-        const payload = parseX402PayloadHeader(payloadHeader);
+        const payload = parseStreamPayloadHeader(payloadHeader);
         assertSettlementTarget(payload.challenge.requirements, this.sdkConfig);
         // FAIL-CLOSED fund safety (B6). Both the cumulative-cap accounting and the
         // revocation state must be POSITIVELY verified before any spend. A missing
@@ -107,32 +121,32 @@ export class VerifiedStreamX402Facilitator {
         // returns a non-bigint/negative spend is treated as "state cannot be
         // verified" and DENIES the open — never a silent fail-open to 0/none.
         if (this.resolveSpentSoFarUsdc === undefined) {
-            throw new X402SpendControlUnavailableError("cannot open verified stream: no resolveSpentSoFarUsdc wired — the mandate cumulative cap (maxTotalUsdc) cannot be verified (fail-closed)");
+            throw new SpendControlUnavailableError("cannot open verified stream: no resolveSpentSoFarUsdc wired — the mandate cumulative cap (maxTotalUsdc) cannot be verified (fail-closed)");
         }
         if (this.resolveRevokedMandateIds === undefined) {
-            throw new X402SpendControlUnavailableError("cannot open verified stream: no resolveRevokedMandateIds wired — mandate revocation state cannot be verified (fail-closed)");
+            throw new SpendControlUnavailableError("cannot open verified stream: no resolveRevokedMandateIds wired — mandate revocation state cannot be verified (fail-closed)");
         }
         let spentSoFarUsdc;
         try {
             spentSoFarUsdc = await this.resolveSpentSoFarUsdc(payload.signedMandate);
         }
         catch (error) {
-            throw new X402SpendControlUnavailableError(`cannot verify mandate cumulative cap (maxTotalUsdc): ${error instanceof Error ? error.message : String(error)} (fail-closed)`);
+            throw new SpendControlUnavailableError(`cannot verify mandate cumulative cap (maxTotalUsdc): ${error instanceof Error ? error.message : String(error)} (fail-closed)`);
         }
         if (typeof spentSoFarUsdc !== "bigint" || spentSoFarUsdc < 0n) {
-            throw new X402SpendControlUnavailableError("cannot verify mandate cumulative cap (maxTotalUsdc): resolver returned an invalid spent-so-far value (fail-closed)");
+            throw new SpendControlUnavailableError("cannot verify mandate cumulative cap (maxTotalUsdc): resolver returned an invalid spent-so-far value (fail-closed)");
         }
         let revokedMandateIds;
         try {
             revokedMandateIds = await this.resolveRevokedMandateIds(payload.signedMandate);
         }
         catch (error) {
-            throw new X402SpendControlUnavailableError(`cannot verify mandate revocation state: ${error instanceof Error ? error.message : String(error)} (fail-closed)`);
+            throw new SpendControlUnavailableError(`cannot verify mandate revocation state: ${error instanceof Error ? error.message : String(error)} (fail-closed)`);
         }
         if (revokedMandateIds === null ||
             revokedMandateIds === undefined ||
             typeof revokedMandateIds[Symbol.iterator] !== "function") {
-            throw new X402SpendControlUnavailableError("cannot verify mandate revocation state: resolver returned a non-iterable value (fail-closed)");
+            throw new SpendControlUnavailableError("cannot verify mandate revocation state: resolver returned a non-iterable value (fail-closed)");
         }
         const result = await this.agentClient.openVerifiedStream({
             operator: payload.challenge.requirements.operator,
@@ -149,7 +163,7 @@ export class VerifiedStreamX402Facilitator {
     }
     async proveConsumedHttpsResponse(input) {
         if (this.deliveryProofs === undefined) {
-            throw new DeliveryProofUnavailableError("zkTLS delivery proofs are not configured on this x402 facilitator");
+            throw new DeliveryProofUnavailableError("zkTLS delivery proofs are not configured on this Metrik verified-stream facilitator");
         }
         return await this.deliveryProofs.proveConsumedHttpsResponse({
             url: input.url,
@@ -184,33 +198,35 @@ export class VerifiedStreamX402Facilitator {
         });
     }
 }
-export function encodeX402PayloadHeader(payload) {
-    const parsed = x402OpenPayloadSchema.parse(payload);
-    const token = Buffer.from(stringifyX402Payload(parsed)).toString("base64url");
-    return `${X402_SCHEME} ${token}`;
+export function encodeStreamPayloadHeader(payload) {
+    const parsed = streamOpenPayloadSchema.parse(payload);
+    const token = Buffer.from(stringifyStreamPayload(parsed)).toString("base64url");
+    return `${METRIK_STREAM_SCHEME} ${token}`;
 }
-export function parseX402ChallengeJson(value) {
-    const parsed = x402StreamChallengeSchema.safeParse(reviveBigInts(value));
+export function parseStreamChallengeJson(value) {
+    const parsed = streamChallengeSchema.safeParse(reviveBigInts(value));
     if (!parsed.success) {
-        throw new X402PayloadError(parsed.error.issues.map((issue) => issue.message).join("; "));
+        throw new StreamPayloadError(parsed.error.issues.map((issue) => issue.message).join("; "));
     }
     return parsed.data;
 }
-export function parseX402PayloadHeader(payloadHeader) {
+export function parseStreamPayloadHeader(payloadHeader) {
     const [scheme, token] = payloadHeader.split(" ", 2);
-    if (scheme !== X402_SCHEME || token === undefined || token.trim() === "") {
-        throw new X402PayloadError("invalid x402 verified-stream payload header");
+    if (scheme !== METRIK_STREAM_SCHEME ||
+        token === undefined ||
+        token.trim() === "") {
+        throw new StreamPayloadError("invalid Metrik verified-stream payload header");
     }
     let decoded;
     try {
         decoded = JSON.parse(Buffer.from(token, "base64url").toString("utf8"));
     }
     catch (error) {
-        throw new X402PayloadError(`invalid x402 verified-stream payload encoding: ${error instanceof Error ? error.message : String(error)}`);
+        throw new StreamPayloadError(`invalid Metrik verified-stream payload encoding: ${error instanceof Error ? error.message : String(error)}`);
     }
-    const parsed = x402OpenPayloadSchema.safeParse(reviveBigInts(decoded));
+    const parsed = streamOpenPayloadSchema.safeParse(reviveBigInts(decoded));
     if (!parsed.success) {
-        throw new X402PayloadError(parsed.error.issues.map((issue) => issue.message).join("; "));
+        throw new StreamPayloadError(parsed.error.issues.map((issue) => issue.message).join("; "));
     }
     return parsed.data;
 }
@@ -225,7 +241,7 @@ function assertSettlementTarget(requirements, sdkConfig) {
         throw new SettlementTargetMismatchError(`challenge escrow ${requirements.escrow} does not match configured escrow ${sdkConfig.escrow}`);
     }
 }
-function stringifyX402Payload(payload) {
+function stringifyStreamPayload(payload) {
     return JSON.stringify(payload, (_key, value) => typeof value === "bigint" ? `${value.toString()}n` : value);
 }
 function reviveBigInts(value) {
@@ -240,4 +256,31 @@ function reviveBigInts(value) {
     }
     return value;
 }
+/* -------------------------------------------------------------------------- */
+/* Deprecated `x402`-flavoured aliases.                                        */
+/*                                                                             */
+/* These names are misleading — this flow is Metrik-native and not x402 (see   */
+/* `docs/x402.md`). They are retained as aliases bound to the SAME values and  */
+/* class objects as the canonical exports above, so existing consumers and     */
+/* `instanceof` checks keep working. Prefer the canonical names.               */
+/* -------------------------------------------------------------------------- */
+export { 
+/** @deprecated Use {@link METRIK_STREAM_SCHEME}. This flow is not x402. */
+METRIK_STREAM_SCHEME as X402_SCHEME, 
+/** @deprecated Use {@link VerifiedStreamFacilitator}. This flow is not x402. */
+VerifiedStreamFacilitator as VerifiedStreamX402Facilitator, 
+/** @deprecated Use {@link StreamPayloadError}. Same class object. */
+StreamPayloadError as X402PayloadError, 
+/** @deprecated Use {@link SpendControlUnavailableError}. Same class object. */
+SpendControlUnavailableError as X402SpendControlUnavailableError, 
+/** @deprecated Use {@link streamChallengeSchema}. */
+streamChallengeSchema as x402StreamChallengeSchema, 
+/** @deprecated Use {@link streamOpenPayloadSchema}. */
+streamOpenPayloadSchema as x402OpenPayloadSchema, 
+/** @deprecated Use {@link encodeStreamPayloadHeader}. */
+encodeStreamPayloadHeader as encodeX402PayloadHeader, 
+/** @deprecated Use {@link parseStreamPayloadHeader}. */
+parseStreamPayloadHeader as parseX402PayloadHeader, 
+/** @deprecated Use {@link parseStreamChallengeJson}. */
+parseStreamChallengeJson as parseX402ChallengeJson, };
 //# sourceMappingURL=facilitator.js.map

package/dist/x402/facilitator.js.map

@@ -1 +1 @@
-{"version":3,"file":"facilitator.js","sourceRoot":"","sources":["../../src/x402/facilitator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"facilitator.js","sourceRoot":"","sources":["../../src/x402/facilitator.ts"],"names":[],"mappings":"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"}

package/dist/x402/payment-requirements.d.ts

@@ -0,0 +1,106 @@
+import type { Address, Hex } from "viem";
+import type { PaymentRequirements } from "x402/types";
+/**
+ * Standard x402 `exact` payment requirements, built from an OPERATOR-SIGNED
+ * Metrik listing.
+ *
+ * This is the "additional way in" described in `docs/x402.md`: the Metrik
+ * verified-stream flow (`./facilitator.ts`) is unchanged and is still the only
+ * path with recoverable escrow. What this module adds is the ability for a
+ * seller's gateway to ALSO quote an ordinary, fully conformant x402 `exact`
+ * price for a single call, so an agent holding nothing but `x402-fetch` can pay
+ * without knowing Metrik exists.
+ *
+ * ## What is signed and what is not
+ *
+ * `payTo` is derived from the operator's EIP-712-signed service descriptor and
+ * from nothing else. It is never read from configuration and never read from a
+ * caller-supplied field, because `payTo` is the one field whose corruption
+ * silently redirects money.
+ *
+ * The PRICE is not signed. The descriptor schema (`@absol-labs/shared`) carries
+ * `minRatePerSecond` / `maxRatePerSecond` for metered streams and has no
+ * per-call price field, so a per-call x402 amount can only come from the seller
+ * running the gateway. That is legitimate — it is the seller's own price on the
+ * seller's own gateway — but a buyer CANNOT cross-check it against the registry
+ * the way they can cross-check `payTo`. Said plainly here so nobody assumes a
+ * guarantee that does not exist.
+ */
+/** The only x402 protocol version implemented by the published `x402` package. */
+export declare const X402_VERSION: 1;
+/** The only x402 payment scheme implemented by the published `x402` package. */
+export declare const X402_EXACT_SCHEME: "exact";
+/** x402 v1 uses bare network names, not CAIP-2. Metrik settles on Base only. */
+export declare const X402_NETWORK_BY_CHAIN_ID: Readonly<Record<number, "base" | "base-sepolia">>;
+export interface X402AssetConfig {
+    readonly address: Address;
+    /** EIP-712 domain `name` of the asset, needed to sign EIP-3009 offline. */
+    readonly eip712Name: string;
+    /** EIP-712 domain `version` of the asset. */
+    readonly eip712Version: string;
+    readonly decimals: number;
+}
+/**
+ * USDC per Base chain. The EIP-712 domain values are what a client needs to
+ * sign `TransferWithAuthorization` WITHOUT an extra RPC round trip: the x402
+ * client falls back to reading `version()` on chain only when
+ * `PaymentRequirements.extra` omits it, so quoting them here removes a network
+ * dependency from the payer's hot path.
+ *
+ * Base Sepolia values read from the live contract on 2026-09-18
+ * (`name() == "USDC"`, `version() == "2"`).
+ */
+export declare const X402_USDC_BY_CHAIN_ID: Readonly<Record<number, X402AssetConfig>>;
+export declare class X402RequirementsError extends Error {
+    constructor(message: string);
+}
+/**
+ * The minimum a payee must prove. Both fields MUST be projected from the
+ * operator-signed descriptor (see `../discovery/registry.ts`, which recovers the
+ * EIP-712 signer and re-derives `serviceRef` from the signed content), never
+ * from an unsigned registry column and never from a request.
+ */
+export interface SignedListingPayee {
+    readonly serviceRef: Hex;
+    readonly operator: Address;
+}
+export interface BuildMetrikPaymentRequirementsInput {
+    readonly listing: SignedListingPayee;
+    /** Absolute URL of the paid resource, as the buyer will request it. */
+    readonly resource: string;
+    /** Price for ONE call, in the asset's base units (micro-USDC at 6 decimals). */
+    readonly priceBaseUnits: bigint;
+    readonly chainId: number;
+    readonly description?: string;
+    readonly mimeType?: string;
+    /** How long the signed authorization stays valid. Default 60s. */
+    readonly maxTimeoutSeconds?: number;
+    readonly outputSchema?: Record<string, unknown>;
+    /** Override the settlement asset (defaults to USDC for `chainId`). */
+    readonly asset?: X402AssetConfig;
+}
+/** Default authorization validity window quoted to payers, in seconds. */
+export declare const DEFAULT_X402_MAX_TIMEOUT_SECONDS = 60;
+/**
+ * Builds standard-`exact` `PaymentRequirements` for one call of a Metrik-listed
+ * resource. Throws rather than emitting anything a conformant client would
+ * reject or a payer could be harmed by.
+ */
+export declare function buildMetrikPaymentRequirements(input: BuildMetrikPaymentRequirementsInput): PaymentRequirements;
+/**
+ * The HTTP `402` response body a resource server returns.
+ *
+ * NOTE on `error`: the shipped `x402ResponseSchema` types `error` as the closed
+ * `ErrorReasons` enum, which no real x402 server obeys — `x402-express` and
+ * friends put human-readable text there, and `x402-fetch` never reads the field
+ * at all. Metrik follows the real-world behaviour (free text) rather than the
+ * schema; `test/x402-facilitator-conformance.test.ts` pins that divergence so it
+ * is a recorded decision and not an accident.
+ */
+export interface X402PaymentRequiredBody {
+    readonly x402Version: typeof X402_VERSION;
+    readonly error: string;
+    readonly accepts: readonly PaymentRequirements[];
+}
+export declare function buildX402PaymentRequiredBody(accepts: readonly PaymentRequirements[], error?: string): X402PaymentRequiredBody;
+//# sourceMappingURL=payment-requirements.d.ts.map

package/dist/x402/payment-requirements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-requirements.d.ts","sourceRoot":"","sources":["../../src/x402/payment-requirements.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAOzC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,kFAAkF;AAClF,eAAO,MAAM,YAAY,EAAG,CAAU,CAAC;AAEvC,gFAAgF;AAChF,eAAO,MAAM,iBAAiB,EAAG,OAAgB,CAAC;AAElD,gFAAgF;AAChF,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAC7C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAAC,CAIvC,CAAC;AAEH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAcxE,CAAC;AAEL,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,gFAAgF;IAChF,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,kEAAkE;IAClE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,sEAAsE;IACtE,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,CAAC;CAClC;AAED,0EAA0E;AAC1E,eAAO,MAAM,gCAAgC,KAAK,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,mCAAmC,GACzC,mBAAmB,CAyErB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,WAAW,EAAE,OAAO,YAAY,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAClD;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,SAAS,mBAAmB,EAAE,EACvC,KAAK,SAAiC,GACrC,uBAAuB,CAOzB"}

package/dist/x402/payment-requirements.js

@@ -0,0 +1,138 @@
+import { getAddress, isAddress, isHex } from "viem";
+/**
+ * Standard x402 `exact` payment requirements, built from an OPERATOR-SIGNED
+ * Metrik listing.
+ *
+ * This is the "additional way in" described in `docs/x402.md`: the Metrik
+ * verified-stream flow (`./facilitator.ts`) is unchanged and is still the only
+ * path with recoverable escrow. What this module adds is the ability for a
+ * seller's gateway to ALSO quote an ordinary, fully conformant x402 `exact`
+ * price for a single call, so an agent holding nothing but `x402-fetch` can pay
+ * without knowing Metrik exists.
+ *
+ * ## What is signed and what is not
+ *
+ * `payTo` is derived from the operator's EIP-712-signed service descriptor and
+ * from nothing else. It is never read from configuration and never read from a
+ * caller-supplied field, because `payTo` is the one field whose corruption
+ * silently redirects money.
+ *
+ * The PRICE is not signed. The descriptor schema (`@absol-labs/shared`) carries
+ * `minRatePerSecond` / `maxRatePerSecond` for metered streams and has no
+ * per-call price field, so a per-call x402 amount can only come from the seller
+ * running the gateway. That is legitimate — it is the seller's own price on the
+ * seller's own gateway — but a buyer CANNOT cross-check it against the registry
+ * the way they can cross-check `payTo`. Said plainly here so nobody assumes a
+ * guarantee that does not exist.
+ */
+/** The only x402 protocol version implemented by the published `x402` package. */
+export const X402_VERSION = 1;
+/** The only x402 payment scheme implemented by the published `x402` package. */
+export const X402_EXACT_SCHEME = "exact";
+/** x402 v1 uses bare network names, not CAIP-2. Metrik settles on Base only. */
+export const X402_NETWORK_BY_CHAIN_ID = Object.freeze({
+    8453: "base",
+    84532: "base-sepolia",
+});
+/**
+ * USDC per Base chain. The EIP-712 domain values are what a client needs to
+ * sign `TransferWithAuthorization` WITHOUT an extra RPC round trip: the x402
+ * client falls back to reading `version()` on chain only when
+ * `PaymentRequirements.extra` omits it, so quoting them here removes a network
+ * dependency from the payer's hot path.
+ *
+ * Base Sepolia values read from the live contract on 2026-09-18
+ * (`name() == "USDC"`, `version() == "2"`).
+ */
+export const X402_USDC_BY_CHAIN_ID = Object.freeze({
+    8453: Object.freeze({
+        address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+        eip712Name: "USD Coin",
+        eip712Version: "2",
+        decimals: 6,
+    }),
+    84532: Object.freeze({
+        address: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+        eip712Name: "USDC",
+        eip712Version: "2",
+        decimals: 6,
+    }),
+});
+export class X402RequirementsError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "X402RequirementsError";
+    }
+}
+/** Default authorization validity window quoted to payers, in seconds. */
+export const DEFAULT_X402_MAX_TIMEOUT_SECONDS = 60;
+/**
+ * Builds standard-`exact` `PaymentRequirements` for one call of a Metrik-listed
+ * resource. Throws rather than emitting anything a conformant client would
+ * reject or a payer could be harmed by.
+ */
+export function buildMetrikPaymentRequirements(input) {
+    const network = X402_NETWORK_BY_CHAIN_ID[input.chainId];
+    if (network === undefined) {
+        throw new X402RequirementsError(`x402 v1 has no network name for chain ${input.chainId} (Metrik settles on Base: 8453, 84532)`);
+    }
+    const asset = input.asset ?? X402_USDC_BY_CHAIN_ID[input.chainId];
+    if (asset === undefined) {
+        throw new X402RequirementsError(`no default settlement asset known for chain ${input.chainId}`);
+    }
+    if (!isAddress(input.listing.operator)) {
+        throw new X402RequirementsError("listing.operator must be an EVM address (it becomes payTo)");
+    }
+    if (!isHex(input.listing.serviceRef, { strict: true }) ||
+        input.listing.serviceRef.length !== 66) {
+        throw new X402RequirementsError("listing.serviceRef must be a 32-byte hex value");
+    }
+    if (input.priceBaseUnits <= 0n) {
+        throw new X402RequirementsError("priceBaseUnits must be positive — a zero-priced x402 quote is not a payment");
+    }
+    let resource;
+    try {
+        resource = new URL(input.resource);
+    }
+    catch {
+        throw new X402RequirementsError(`resource must be an absolute URL`);
+    }
+    const maxTimeoutSeconds = input.maxTimeoutSeconds ?? DEFAULT_X402_MAX_TIMEOUT_SECONDS;
+    if (!Number.isInteger(maxTimeoutSeconds) || maxTimeoutSeconds <= 0) {
+        throw new X402RequirementsError("maxTimeoutSeconds must be a positive integer");
+    }
+    return {
+        scheme: X402_EXACT_SCHEME,
+        network,
+        maxAmountRequired: input.priceBaseUnits.toString(),
+        resource: resource.toString(),
+        description: input.description ??
+            "One call to a Metrik-listed service. Metrik's facilitator refuses to settle this payment while its oracle reports the service as failing.",
+        mimeType: input.mimeType ?? "application/json",
+        payTo: getAddress(input.listing.operator),
+        maxTimeoutSeconds,
+        asset: getAddress(asset.address),
+        extra: {
+            // Required by the x402 `exact` EVM binding so the payer can sign the
+            // EIP-3009 authorization offline.
+            name: asset.eip712Name,
+            version: asset.eip712Version,
+            // ADVISORY ONLY. The facilitator NEVER reads this to decide anything: it
+            // arrives inside a caller-supplied request body, so trusting it would let
+            // a caller pick which service's delivery record gets checked. The
+            // facilitator re-derives the service from `resource` against its own
+            // registry view. Published purely so a client can look the listing up.
+            metrikServiceRef: input.listing.serviceRef,
+        },
+        ...(input.outputSchema === undefined
+            ? {}
+            : { outputSchema: input.outputSchema }),
+    };
+}
+export function buildX402PaymentRequiredBody(accepts, error = "X-PAYMENT header is required") {
+    if (accepts.length === 0) {
+        throw new X402RequirementsError("a 402 must advertise at least one PaymentRequirements");
+    }
+    return { x402Version: X402_VERSION, error, accepts };
+}
+//# sourceMappingURL=payment-requirements.js.map

package/dist/x402/payment-requirements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-requirements.js","sourceRoot":"","sources":["../../src/x402/payment-requirements.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAQpD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,kFAAkF;AAClF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAU,CAAC;AAEvC,gFAAgF;AAChF,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAgB,CAAC;AAElD,gFAAgF;AAChF,MAAM,CAAC,MAAM,wBAAwB,GAEjC,MAAM,CAAC,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,cAAc;CACtB,CAAC,CAAC;AAWH;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAChC,MAAM,CAAC,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;QAClB,OAAO,EAAE,4CAAuD;QAChE,UAAU,EAAE,UAAU;QACtB,aAAa,EAAE,GAAG;QAClB,QAAQ,EAAE,CAAC;KACZ,CAAC;IACF,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO,EAAE,4CAAuD;QAChE,UAAU,EAAE,MAAM;QAClB,aAAa,EAAE,GAAG;QAClB,QAAQ,EAAE,CAAC;KACZ,CAAC;CACH,CAAC,CAAC;AAEL,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AA6BD,0EAA0E;AAC1E,MAAM,CAAC,MAAM,gCAAgC,GAAG,EAAE,CAAC;AAEnD;;;;GAIG;AACH,MAAM,UAAU,8BAA8B,CAC5C,KAA0C;IAE1C,MAAM,OAAO,GAAG,wBAAwB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,qBAAqB,CAC7B,yCAAyC,KAAK,CAAC,OAAO,wCAAwC,CAC/F,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,qBAAqB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,qBAAqB,CAC7B,+CAA+C,KAAK,CAAC,OAAO,EAAE,CAC/D,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,qBAAqB,CAC7B,4DAA4D,CAC7D,CAAC;IACJ,CAAC;IACD,IACE,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAClD,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,KAAK,EAAE,EACtC,CAAC;QACD,MAAM,IAAI,qBAAqB,CAC7B,gDAAgD,CACjD,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,cAAc,IAAI,EAAE,EAAE,CAAC;QAC/B,MAAM,IAAI,qBAAqB,CAC7B,6EAA6E,CAC9E,CAAC;IACJ,CAAC;IACD,IAAI,QAAa,CAAC;IAClB,IAAI,CAAC;QACH,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,qBAAqB,CAAC,kCAAkC,CAAC,CAAC;IACtE,CAAC;IACD,MAAM,iBAAiB,GACrB,KAAK,CAAC,iBAAiB,IAAI,gCAAgC,CAAC;IAC9D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,iBAAiB,CAAC,IAAI,iBAAiB,IAAI,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,qBAAqB,CAC7B,8CAA8C,CAC/C,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,iBAAiB;QACzB,OAAO;QACP,iBAAiB,EAAE,KAAK,CAAC,cAAc,CAAC,QAAQ,EAAE;QAClD,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;QAC7B,WAAW,EACT,KAAK,CAAC,WAAW;YACjB,2IAA2I;QAC7I,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,kBAAkB;QAC9C,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QACzC,iBAAiB;QACjB,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC;QAChC,KAAK,EAAE;YACL,qEAAqE;YACrE,kCAAkC;YAClC,IAAI,EAAE,KAAK,CAAC,UAAU;YACtB,OAAO,EAAE,KAAK,CAAC,aAAa;YAC5B,yEAAyE;YACzE,0EAA0E;YAC1E,kEAAkE;YAClE,qEAAqE;YACrE,uEAAuE;YACvE,gBAAgB,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU;SAC3C;QACD,GAAG,CAAC,KAAK,CAAC,YAAY,KAAK,SAAS;YAClC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC;KAC1C,CAAC;AACJ,CAAC;AAkBD,MAAM,UAAU,4BAA4B,CAC1C,OAAuC,EACvC,KAAK,GAAG,8BAA8B;IAEtC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,qBAAqB,CAC7B,uDAAuD,CACxD,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACvD,CAAC"}

package/dist/x402/relayer.d.ts

@@ -0,0 +1,41 @@
+import { type Chain, type Hex } from "viem";
+import type { PaymentSettler, PaymentVerifier } from "./verified-delivery-facilitator.js";
+/**
+ * Chain wiring for the payment half of Metrik's x402 facilitator.
+ *
+ * Nothing here is Metrik-specific: verification and settlement are delegated
+ * VERBATIM to the real `x402/facilitator` implementation of the `exact` scheme.
+ * Metrik does not reimplement EIP-3009, and a change in the library's rules is
+ * inherited rather than drifted away from. The Metrik-specific part — the
+ * delivery gate — lives entirely in `./verified-delivery-facilitator.ts` and is
+ * layered ON TOP of whatever this returns.
+ */
+export declare const X402_CHAINS: Readonly<Record<number, Chain>>;
+export interface X402ChainOptions {
+    /** Default `84532` (Base Sepolia). */
+    readonly chainId?: number;
+    /** RPC endpoint. Required: the library's default public RPCs are not operable infrastructure. */
+    readonly rpcUrl: string;
+}
+/**
+ * Read-only verifier. Needs an RPC because the `exact` scheme checks the payer's
+ * on-chain balance; it holds no key and can broadcast nothing.
+ */
+export declare function createX402PaymentVerifier(options: X402ChainOptions): PaymentVerifier;
+export interface X402RelayerOptions extends X402ChainOptions {
+    /**
+     * The relayer's private key. This wallet BROADCASTS and pays gas; it never
+     * custodies payment funds (EIP-3009 moves value directly from payer to payee).
+     * Supplied by the operator through the environment, exactly like every other
+     * wallet in this package. Never committed, never defaulted.
+     */
+    readonly privateKey: Hex;
+}
+/**
+ * The settlement half. Constructing this is the ONLY place a key enters the
+ * facilitator, and there is no code path that broadcasts without one.
+ */
+export declare function createX402PaymentSettler(options: X402RelayerOptions): PaymentSettler;
+/** The relayer address, so an operator can check what they must fund with gas. */
+export declare function relayerAddress(privateKey: Hex): `0x${string}`;
+//# sourceMappingURL=relayer.d.ts.map

package/dist/x402/relayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relayer.d.ts","sourceRoot":"","sources":["../../src/x402/relayer.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,KAAK,EACV,KAAK,GAAG,EACT,MAAM,MAAM,CAAC;AAWd,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAChB,MAAM,oCAAoC,CAAC;AAE5C;;;;;;;;;GASG;AAEH,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAGtD,CAAC;AAEH,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,iGAAiG;IACjG,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAUD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,gBAAgB,GACxB,eAAe,CAkBjB;AAED,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,kBAAkB,GAC1B,cAAc,CAoBhB;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,UAAU,EAAE,GAAG,GAAG,KAAK,MAAM,EAAE,CAE7D"}

package/dist/x402/relayer.js

@@ -0,0 +1,64 @@
+import { createPublicClient, createWalletClient, http, publicActions, } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+import { base, baseSepolia } from "viem/chains";
+import { settle as x402Settle, verify as x402Verify } from "x402/facilitator";
+/**
+ * Chain wiring for the payment half of Metrik's x402 facilitator.
+ *
+ * Nothing here is Metrik-specific: verification and settlement are delegated
+ * VERBATIM to the real `x402/facilitator` implementation of the `exact` scheme.
+ * Metrik does not reimplement EIP-3009, and a change in the library's rules is
+ * inherited rather than drifted away from. The Metrik-specific part — the
+ * delivery gate — lives entirely in `./verified-delivery-facilitator.ts` and is
+ * layered ON TOP of whatever this returns.
+ */
+export const X402_CHAINS = Object.freeze({
+    8453: base,
+    84532: baseSepolia,
+});
+function chainFor(chainId) {
+    const chain = X402_CHAINS[chainId];
+    if (chain === undefined) {
+        throw new Error(`unsupported x402 settlement chain: ${chainId}`);
+    }
+    return chain;
+}
+/**
+ * Read-only verifier. Needs an RPC because the `exact` scheme checks the payer's
+ * on-chain balance; it holds no key and can broadcast nothing.
+ */
+export function createX402PaymentVerifier(options) {
+    const chain = chainFor(options.chainId ?? 84532);
+    const client = createPublicClient({
+        chain,
+        transport: http(options.rpcUrl),
+    });
+    return {
+        verify(payload, requirements) {
+            return x402Verify(client, payload, requirements);
+        },
+    };
+}
+/**
+ * The settlement half. Constructing this is the ONLY place a key enters the
+ * facilitator, and there is no code path that broadcasts without one.
+ */
+export function createX402PaymentSettler(options) {
+    const chain = chainFor(options.chainId ?? 84532);
+    const account = privateKeyToAccount(options.privateKey);
+    const signer = createWalletClient({
+        account,
+        chain,
+        transport: http(options.rpcUrl),
+    }).extend(publicActions);
+    return {
+        settle(payload, requirements) {
+            return x402Settle(signer, payload, requirements);
+        },
+    };
+}
+/** The relayer address, so an operator can check what they must fund with gas. */
+export function relayerAddress(privateKey) {
+    return privateKeyToAccount(privateKey).address;
+}
+//# sourceMappingURL=relayer.js.map