@absol-labs/agent 0.1.0

package/dist/x402/facilitator.d.ts

@@ -0,0 +1,315 @@
+import type { StreamProofClientConfig } from "@absol-labs/sdk";
+import { z } from "zod";
+import { type SignedSpendMandate } from "../mandates/mandate.js";
+import { type VerifiedStreamAgentOpener } from "../sdk/client.js";
+import { type ConsumerDeliveryProofService, type HttpsResponseMatch, type HttpsResponseRedaction, type VerifiedConsumedHttpsResponseProof } from "../zktls/reclaim.js";
+export declare const X402_SCHEME: "streamproof-verified-stream";
+export declare const verifiedStreamRequirementsSchema: z.ZodObject<{
+    operator: z.ZodString;
+    serviceRef: z.ZodString;
+    chainId: z.ZodNumber;
+    escrow: z.ZodString;
+    ratePerSecondUsdc: z.ZodBigInt;
+    maxDurationSeconds: z.ZodNumber;
+    maxBudgetUsdc: z.ZodBigInt;
+}, "strip", z.ZodTypeAny, {
+    maxDurationSeconds: number;
+    chainId: number;
+    operator: string;
+    serviceRef: string;
+    escrow: string;
+    ratePerSecondUsdc: bigint;
+    maxBudgetUsdc: bigint;
+}, {
+    maxDurationSeconds: number;
+    chainId: number;
+    operator: string;
+    serviceRef: string;
+    escrow: string;
+    ratePerSecondUsdc: bigint;
+    maxBudgetUsdc: bigint;
+}>;
+export interface VerifiedStreamRequirements extends z.infer<typeof verifiedStreamRequirementsSchema> {
+}
+export declare const x402StreamChallengeSchema: z.ZodObject<{
+    scheme: z.ZodLiteral<"streamproof-verified-stream">;
+    requirements: z.ZodObject<{
+        operator: z.ZodString;
+        serviceRef: z.ZodString;
+        chainId: z.ZodNumber;
+        escrow: z.ZodString;
+        ratePerSecondUsdc: z.ZodBigInt;
+        maxDurationSeconds: z.ZodNumber;
+        maxBudgetUsdc: z.ZodBigInt;
+    }, "strip", z.ZodTypeAny, {
+        maxDurationSeconds: number;
+        chainId: number;
+        operator: string;
+        serviceRef: string;
+        escrow: string;
+        ratePerSecondUsdc: bigint;
+        maxBudgetUsdc: bigint;
+    }, {
+        maxDurationSeconds: number;
+        chainId: number;
+        operator: string;
+        serviceRef: string;
+        escrow: string;
+        ratePerSecondUsdc: bigint;
+        maxBudgetUsdc: bigint;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    scheme: "streamproof-verified-stream";
+    requirements: {
+        maxDurationSeconds: number;
+        chainId: number;
+        operator: string;
+        serviceRef: string;
+        escrow: string;
+        ratePerSecondUsdc: bigint;
+        maxBudgetUsdc: bigint;
+    };
+}, {
+    scheme: "streamproof-verified-stream";
+    requirements: {
+        maxDurationSeconds: number;
+        chainId: number;
+        operator: string;
+        serviceRef: string;
+        escrow: string;
+        ratePerSecondUsdc: bigint;
+        maxBudgetUsdc: bigint;
+    };
+}>;
+export interface X402StreamChallenge extends z.infer<typeof x402StreamChallengeSchema> {
+}
+export declare const x402OpenPayloadSchema: z.ZodObject<{
+    challenge: z.ZodObject<{
+        scheme: z.ZodLiteral<"streamproof-verified-stream">;
+        requirements: z.ZodObject<{
+            operator: z.ZodString;
+            serviceRef: z.ZodString;
+            chainId: z.ZodNumber;
+            escrow: z.ZodString;
+            ratePerSecondUsdc: z.ZodBigInt;
+            maxDurationSeconds: z.ZodNumber;
+            maxBudgetUsdc: z.ZodBigInt;
+        }, "strip", z.ZodTypeAny, {
+            maxDurationSeconds: number;
+            chainId: number;
+            operator: string;
+            serviceRef: string;
+            escrow: string;
+            ratePerSecondUsdc: bigint;
+            maxBudgetUsdc: bigint;
+        }, {
+            maxDurationSeconds: number;
+            chainId: number;
+            operator: string;
+            serviceRef: string;
+            escrow: string;
+            ratePerSecondUsdc: bigint;
+            maxBudgetUsdc: bigint;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        scheme: "streamproof-verified-stream";
+        requirements: {
+            maxDurationSeconds: number;
+            chainId: number;
+            operator: string;
+            serviceRef: string;
+            escrow: string;
+            ratePerSecondUsdc: bigint;
+            maxBudgetUsdc: bigint;
+        };
+    }, {
+        scheme: "streamproof-verified-stream";
+        requirements: {
+            maxDurationSeconds: number;
+            chainId: number;
+            operator: string;
+            serviceRef: string;
+            escrow: string;
+            ratePerSecondUsdc: bigint;
+            maxBudgetUsdc: bigint;
+        };
+    }>;
+    signedMandate: z.ZodObject<{
+        mandateId: z.ZodEffects<z.ZodString, string, string>;
+        owner: z.ZodEffects<z.ZodString, `0x${string}`, string>;
+        chainId: z.ZodNumber;
+        issuedAt: z.ZodNumber;
+        mandate: z.ZodObject<{
+            maxPerStreamUsdc: z.ZodBigInt;
+            maxTotalUsdc: z.ZodBigInt;
+            maxRatePerSecondUsdc: z.ZodBigInt;
+            maxDurationSeconds: z.ZodNumber;
+            allowedOperators: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodString, `0x${string}`, string>, "many">>;
+            expiresAt: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            maxPerStreamUsdc: bigint;
+            maxTotalUsdc: bigint;
+            maxRatePerSecondUsdc: bigint;
+            maxDurationSeconds: number;
+            expiresAt: number;
+            allowedOperators?: `0x${string}`[] | undefined;
+        }, {
+            maxPerStreamUsdc: bigint;
+            maxTotalUsdc: bigint;
+            maxRatePerSecondUsdc: bigint;
+            maxDurationSeconds: number;
+            expiresAt: number;
+            allowedOperators?: string[] | undefined;
+        }>;
+        signature: z.ZodEffects<z.ZodString, string, string>;
+    }, "strip", z.ZodTypeAny, {
+        mandateId: string;
+        owner: `0x${string}`;
+        chainId: number;
+        issuedAt: number;
+        mandate: {
+            maxPerStreamUsdc: bigint;
+            maxTotalUsdc: bigint;
+            maxRatePerSecondUsdc: bigint;
+            maxDurationSeconds: number;
+            expiresAt: number;
+            allowedOperators?: `0x${string}`[] | undefined;
+        };
+        signature: string;
+    }, {
+        mandateId: string;
+        owner: string;
+        chainId: number;
+        issuedAt: number;
+        mandate: {
+            maxPerStreamUsdc: bigint;
+            maxTotalUsdc: bigint;
+            maxRatePerSecondUsdc: bigint;
+            maxDurationSeconds: number;
+            expiresAt: number;
+            allowedOperators?: string[] | undefined;
+        };
+        signature: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    signedMandate: {
+        mandateId: string;
+        owner: `0x${string}`;
+        chainId: number;
+        issuedAt: number;
+        mandate: {
+            maxPerStreamUsdc: bigint;
+            maxTotalUsdc: bigint;
+            maxRatePerSecondUsdc: bigint;
+            maxDurationSeconds: number;
+            expiresAt: number;
+            allowedOperators?: `0x${string}`[] | undefined;
+        };
+        signature: string;
+    };
+    challenge: {
+        scheme: "streamproof-verified-stream";
+        requirements: {
+            maxDurationSeconds: number;
+            chainId: number;
+            operator: string;
+            serviceRef: string;
+            escrow: string;
+            ratePerSecondUsdc: bigint;
+            maxBudgetUsdc: bigint;
+        };
+    };
+}, {
+    signedMandate: {
+        mandateId: string;
+        owner: string;
+        chainId: number;
+        issuedAt: number;
+        mandate: {
+            maxPerStreamUsdc: bigint;
+            maxTotalUsdc: bigint;
+            maxRatePerSecondUsdc: bigint;
+            maxDurationSeconds: number;
+            expiresAt: number;
+            allowedOperators?: string[] | undefined;
+        };
+        signature: string;
+    };
+    challenge: {
+        scheme: "streamproof-verified-stream";
+        requirements: {
+            maxDurationSeconds: number;
+            chainId: number;
+            operator: string;
+            serviceRef: string;
+            escrow: string;
+            ratePerSecondUsdc: bigint;
+            maxBudgetUsdc: bigint;
+        };
+    };
+}>;
+export interface X402OpenPayload extends z.infer<typeof x402OpenPayloadSchema> {
+}
+export interface X402Facilitator {
+    /** Build the 402 challenge a server returns to prompt a verified stream. */
+    challenge(req: VerifiedStreamRequirements): X402StreamChallenge;
+    /** Verify + open the stream from an agent's signed payment payload. */
+    open(payloadHeader: string): Promise<{
+        streamId: `0x${string}`;
+    }>;
+    /** Prove the HTTPS response consumed after opening a verified stream. */
+    proveConsumedHttpsResponse(input: X402ConsumedHttpsResponseProofInput): Promise<VerifiedConsumedHttpsResponseProof>;
+}
+export interface X402ConsumedHttpsResponseProofInput {
+    readonly signedMandate: SignedSpendMandate;
+    readonly streamId?: `0x${string}`;
+    readonly operator?: `0x${string}`;
+    readonly serviceRef?: `0x${string}`;
+    readonly url: string;
+    readonly method?: "GET" | "POST" | "PUT";
+    readonly headers?: Record<string, string>;
+    readonly body?: string;
+    readonly secretHeaders?: Record<string, string>;
+    readonly responseMatches: readonly HttpsResponseMatch[];
+    readonly responseRedactions?: readonly HttpsResponseRedaction[];
+    readonly cookie?: string;
+    readonly secretParamValues?: Record<string, string>;
+    readonly geoLocation?: string;
+    readonly useTee?: boolean;
+    readonly zkEngine?: "snarkjs" | "stwo";
+}
+export interface VerifiedStreamFacilitatorOptions {
+    readonly sdkConfig: StreamProofClientConfig;
+    readonly createAgentClient?: (config: StreamProofClientConfig) => VerifiedStreamAgentOpener;
+    readonly deliveryProofs?: ConsumerDeliveryProofService;
+    readonly nowSeconds?: () => number;
+    readonly resolveSpentSoFarUsdc?: (signedMandate: SignedSpendMandate) => bigint | Promise<bigint>;
+    readonly resolveRevokedMandateIds?: (signedMandate: SignedSpendMandate) => Iterable<`0x${string}`> | Promise<Iterable<`0x${string}`>>;
+}
+export declare class X402PayloadError extends Error {
+    constructor(message: string);
+}
+export declare class SettlementTargetMismatchError extends Error {
+    constructor(message: string);
+}
+export declare class DeliveryProofUnavailableError extends Error {
+    constructor(message: string);
+}
+export declare class VerifiedStreamX402Facilitator implements X402Facilitator {
+    private readonly agentClient;
+    private readonly deliveryProofs;
+    private readonly sdkConfig;
+    private readonly nowSeconds;
+    private readonly resolveSpentSoFarUsdc;
+    private readonly resolveRevokedMandateIds;
+    constructor(options: VerifiedStreamFacilitatorOptions);
+    challenge(req: VerifiedStreamRequirements): X402StreamChallenge;
+    open(payloadHeader: string): Promise<{
+        streamId: `0x${string}`;
+    }>;
+    proveConsumedHttpsResponse(input: X402ConsumedHttpsResponseProofInput): Promise<VerifiedConsumedHttpsResponseProof>;
+}
+export declare function encodeX402PayloadHeader(payload: X402OpenPayload): string;
+export declare function parseX402ChallengeJson(value: unknown): X402StreamChallenge;
+export declare function parseX402PayloadHeader(payloadHeader: string): X402OpenPayload;
+//# sourceMappingURL=facilitator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"facilitator.d.ts","sourceRoot":"","sources":["../../src/x402/facilitator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,KAAK,4BAA4B,EACjC,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,kCAAkC,EACxC,MAAM,qBAAqB,CAAC;AAE7B,eAAO,MAAM,WAAW,EAAG,6BAAsC,CAAC;AAKlE,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;EAQ3C,CAAC;AAEH,MAAM,WAAW,0BAA2B,SAAQ,CAAC,CAAC,KAAK,CACzD,OAAO,gCAAgC,CACxC;CAAG;AAEJ,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGpC,CAAC;AAEH,MAAM,WAAW,mBAAoB,SAAQ,CAAC,CAAC,KAAK,CAClD,OAAO,yBAAyB,CACjC;CAAG;AAEJ,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGhC,CAAC;AAEH,MAAM,WAAW,eAAgB,SAAQ,CAAC,CAAC,KAAK,CAC9C,OAAO,qBAAqB,CAC7B;CAAG;AAEJ,MAAM,WAAW,eAAe;IAC9B,4EAA4E;IAC5E,SAAS,CAAC,GAAG,EAAE,0BAA0B,GAAG,mBAAmB,CAAC;IAChE,uEAAuE;IACvE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,KAAK,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAClE,yEAAyE;IACzE,0BAA0B,CACxB,KAAK,EAAE,mCAAmC,GACzC,OAAO,CAAC,kCAAkC,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,aAAa,EAAE,kBAAkB,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,eAAe,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxD,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;CACxC;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAC;IAC5C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAC3B,MAAM,EAAE,uBAAuB,KAC5B,yBAAyB,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,4BAA4B,CAAC;IACvD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC;IACnC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAC/B,aAAa,EAAE,kBAAkB,KAC9B,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,QAAQ,CAAC,wBAAwB,CAAC,EAAE,CAClC,aAAa,EAAE,kBAAkB,KAC9B,QAAQ,CAAC,KAAK,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC;CACjE;AAaD,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,6BAA8B,SAAQ,KAAK;gBAC1C,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,6BAA8B,SAAQ,KAAK;gBAC1C,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,6BAA8B,YAAW,eAAe;IACnE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA4B;IACxD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA2C;IAC1E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAe;IAC1C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAER;IAC9B,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAEuB;gBAEpD,OAAO,EAAE,gCAAgC;IA8BrD,SAAS,CAAC,GAAG,EAAE,0BAA0B,GAAG,mBAAmB;IAMzD,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,KAAK,MAAM,EAAE,CAAA;KAAE,CAAC;IA0BjE,0BAA0B,CAC9B,KAAK,EAAE,mCAAmC,GACzC,OAAO,CAAC,kCAAkC,CAAC;CAuC/C;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAIxE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAQ1E;AAED,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,eAAe,CAwB7E"}

package/dist/x402/facilitator.js

@@ -0,0 +1,194 @@
+import { z } from "zod";
+import { signedSpendMandateSchema, } from "../mandates/mandate.js";
+import { VerifiedStreamAgentClient, } from "../sdk/client.js";
+export const X402_SCHEME = "streamproof-verified-stream";
+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({
+    operator: addressSchema,
+    serviceRef: bytes32Schema,
+    chainId: z.number().int().positive(),
+    escrow: addressSchema,
+    ratePerSecondUsdc: z.bigint().positive(),
+    maxDurationSeconds: z.number().int().positive(),
+    maxBudgetUsdc: z.bigint().positive(),
+});
+export const x402StreamChallengeSchema = z.object({
+    scheme: z.literal(X402_SCHEME),
+    requirements: verifiedStreamRequirementsSchema,
+});
+export const x402OpenPayloadSchema = z.object({
+    challenge: x402StreamChallengeSchema,
+    signedMandate: signedSpendMandateSchema,
+});
+const warnedFacilitatorGaps = new Set();
+/** Emits a stderr warning at most once per process for a given key. */
+function warnFacilitatorOnce(key, message) {
+    if (warnedFacilitatorGaps.has(key)) {
+        return;
+    }
+    warnedFacilitatorGaps.add(key);
+    console.error(message);
+}
+export class X402PayloadError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "X402PayloadError";
+    }
+}
+export class SettlementTargetMismatchError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SettlementTargetMismatchError";
+    }
+}
+export class DeliveryProofUnavailableError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "DeliveryProofUnavailableError";
+    }
+}
+export class VerifiedStreamX402Facilitator {
+    agentClient;
+    deliveryProofs;
+    sdkConfig;
+    nowSeconds;
+    resolveSpentSoFarUsdc;
+    resolveRevokedMandateIds;
+    constructor(options) {
+        this.sdkConfig = options.sdkConfig;
+        this.agentClient = (options.createAgentClient ?? defaultAgentClientFactory)(options.sdkConfig);
+        this.deliveryProofs = options.deliveryProofs;
+        this.nowSeconds =
+            options.nowSeconds ?? (() => Math.floor(Date.now() / 1000));
+        this.resolveSpentSoFarUsdc = options.resolveSpentSoFarUsdc ?? (() => 0n);
+        this.resolveRevokedMandateIds =
+            options.resolveRevokedMandateIds ?? (() => []);
+        // Fail-loud on the two mandate controls that require external state. This
+        // facilitator is stateless (no stream registry), so it cannot enforce the
+        // cumulative-cap or revocation without a wired resolver. Warn once so a
+        // deployment never silently ships with maxTotalUsdc / revocation disabled.
+        if (options.resolveSpentSoFarUsdc === undefined) {
+            warnFacilitatorOnce("x402-spent", "[metrik] x402 facilitator: no resolveSpentSoFarUsdc wired — the mandate cumulative cap (maxTotalUsdc) is NOT enforced across streams (per-stream/rate/duration/operator/expiry still are).");
+        }
+        if (options.resolveRevokedMandateIds === undefined) {
+            warnFacilitatorOnce("x402-revocation", "[metrik] x402 facilitator: no resolveRevokedMandateIds wired — revoked mandates will NOT be rejected until you wire a revocation store.");
+        }
+    }
+    challenge(req) {
+        const requirements = verifiedStreamRequirementsSchema.parse(req);
+        assertSettlementTarget(requirements, this.sdkConfig);
+        return { scheme: X402_SCHEME, requirements };
+    }
+    async open(payloadHeader) {
+        const payload = parseX402PayloadHeader(payloadHeader);
+        assertSettlementTarget(payload.challenge.requirements, this.sdkConfig);
+        const spentSoFarUsdc = await this.resolveSpentSoFarUsdc(payload.signedMandate);
+        const revokedMandateIds = await this.resolveRevokedMandateIds(payload.signedMandate);
+        const result = await this.agentClient.openVerifiedStream({
+            operator: payload.challenge.requirements.operator,
+            serviceRef: payload.challenge.requirements.serviceRef,
+            budgetUsdc: payload.challenge.requirements.maxBudgetUsdc,
+            ratePerSecondUsdc: payload.challenge.requirements.ratePerSecondUsdc,
+            maxDurationSeconds: payload.challenge.requirements.maxDurationSeconds,
+            signedMandate: payload.signedMandate,
+            spentSoFarUsdc,
+            nowSeconds: this.nowSeconds(),
+            revokedMandateIds,
+        });
+        return { streamId: result.streamId };
+    }
+    async proveConsumedHttpsResponse(input) {
+        if (this.deliveryProofs === undefined) {
+            throw new DeliveryProofUnavailableError("zkTLS delivery proofs are not configured on this x402 facilitator");
+        }
+        return await this.deliveryProofs.proveConsumedHttpsResponse({
+            url: input.url,
+            ...(input.method === undefined ? {} : { method: input.method }),
+            ...(input.headers === undefined ? {} : { headers: input.headers }),
+            ...(input.body === undefined ? {} : { body: input.body }),
+            ...(input.secretHeaders === undefined
+                ? {}
+                : { secretHeaders: input.secretHeaders }),
+            responseMatches: input.responseMatches,
+            ...(input.responseRedactions === undefined
+                ? {}
+                : { responseRedactions: input.responseRedactions }),
+            ...(input.cookie === undefined ? {} : { cookie: input.cookie }),
+            ...(input.secretParamValues === undefined
+                ? {}
+                : { secretParamValues: input.secretParamValues }),
+            ...(input.geoLocation === undefined
+                ? {}
+                : { geoLocation: input.geoLocation }),
+            ...(input.useTee === undefined ? {} : { useTee: input.useTee }),
+            ...(input.zkEngine === undefined ? {} : { zkEngine: input.zkEngine }),
+            delivery: {
+                owner: input.signedMandate.owner,
+                mandateId: input.signedMandate.mandateId,
+                ...(input.streamId === undefined ? {} : { streamId: input.streamId }),
+                ...(input.operator === undefined ? {} : { operator: input.operator }),
+                ...(input.serviceRef === undefined
+                    ? {}
+                    : { serviceRef: input.serviceRef }),
+            },
+        });
+    }
+}
+export function encodeX402PayloadHeader(payload) {
+    const parsed = x402OpenPayloadSchema.parse(payload);
+    const token = Buffer.from(stringifyX402Payload(parsed)).toString("base64url");
+    return `${X402_SCHEME} ${token}`;
+}
+export function parseX402ChallengeJson(value) {
+    const parsed = x402StreamChallengeSchema.safeParse(reviveBigInts(value));
+    if (!parsed.success) {
+        throw new X402PayloadError(parsed.error.issues.map((issue) => issue.message).join("; "));
+    }
+    return parsed.data;
+}
+export function parseX402PayloadHeader(payloadHeader) {
+    const [scheme, token] = payloadHeader.split(" ", 2);
+    if (scheme !== X402_SCHEME || token === undefined || token.trim() === "") {
+        throw new X402PayloadError("invalid x402 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)}`);
+    }
+    const parsed = x402OpenPayloadSchema.safeParse(reviveBigInts(decoded));
+    if (!parsed.success) {
+        throw new X402PayloadError(parsed.error.issues.map((issue) => issue.message).join("; "));
+    }
+    return parsed.data;
+}
+function defaultAgentClientFactory(config) {
+    return new VerifiedStreamAgentClient(config);
+}
+function assertSettlementTarget(requirements, sdkConfig) {
+    if (requirements.chainId !== sdkConfig.chain.id) {
+        throw new SettlementTargetMismatchError(`challenge chainId ${requirements.chainId} does not match configured chain ${sdkConfig.chain.id}`);
+    }
+    if (requirements.escrow.toLowerCase() !== sdkConfig.escrow.toLowerCase()) {
+        throw new SettlementTargetMismatchError(`challenge escrow ${requirements.escrow} does not match configured escrow ${sdkConfig.escrow}`);
+    }
+}
+function stringifyX402Payload(payload) {
+    return JSON.stringify(payload, (_key, value) => typeof value === "bigint" ? `${value.toString()}n` : value);
+}
+function reviveBigInts(value) {
+    if (Array.isArray(value)) {
+        return value.map((entry) => reviveBigInts(entry));
+    }
+    if (typeof value === "string" && /^\d+n$/.test(value)) {
+        return BigInt(value.slice(0, -1));
+    }
+    if (typeof value === "object" && value !== null) {
+        return Object.fromEntries(Object.entries(value).map(([key, entry]) => [key, reviveBigInts(entry)]));
+    }
+    return value;
+}
+//# sourceMappingURL=facilitator.js.map

package/dist/x402/facilitator.js.map

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

package/dist/zktls/reclaim.d.ts

@@ -0,0 +1,137 @@
+import { verifyProof, type Proof as ReclaimProtocolProof, type VerifyProofResult } from "@reclaimprotocol/js-sdk";
+import { z } from "zod";
+declare const responseMatchSchema: z.ZodObject<{
+    type: z.ZodEnum<["regex", "contains"]>;
+    value: z.ZodString;
+    invert: z.ZodOptional<z.ZodBoolean>;
+    isOptional: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    type: "regex" | "contains";
+    invert?: boolean | undefined;
+    isOptional?: boolean | undefined;
+}, {
+    value: string;
+    type: "regex" | "contains";
+    invert?: boolean | undefined;
+    isOptional?: boolean | undefined;
+}>;
+declare const responseRedactionSchema: z.ZodEffects<z.ZodObject<{
+    regex: z.ZodOptional<z.ZodString>;
+    jsonPath: z.ZodOptional<z.ZodString>;
+    xPath: z.ZodOptional<z.ZodString>;
+    hash: z.ZodOptional<z.ZodEnum<["oprf", "oprf-raw", "oprf-mpc"]>>;
+}, "strip", z.ZodTypeAny, {
+    regex?: string | undefined;
+    jsonPath?: string | undefined;
+    xPath?: string | undefined;
+    hash?: "oprf" | "oprf-raw" | "oprf-mpc" | undefined;
+}, {
+    regex?: string | undefined;
+    jsonPath?: string | undefined;
+    xPath?: string | undefined;
+    hash?: "oprf" | "oprf-raw" | "oprf-mpc" | undefined;
+}>, {
+    regex?: string | undefined;
+    jsonPath?: string | undefined;
+    xPath?: string | undefined;
+    hash?: "oprf" | "oprf-raw" | "oprf-mpc" | undefined;
+}, {
+    regex?: string | undefined;
+    jsonPath?: string | undefined;
+    xPath?: string | undefined;
+    hash?: "oprf" | "oprf-raw" | "oprf-mpc" | undefined;
+}>;
+export type HttpsResponseMatch = z.infer<typeof responseMatchSchema>;
+export type HttpsResponseRedaction = z.infer<typeof responseRedactionSchema>;
+export type ReclaimProof = ReclaimProtocolProof;
+export interface DeliveryProofBinding {
+    readonly owner: `0x${string}`;
+    readonly streamId?: `0x${string}`;
+    readonly operator?: `0x${string}`;
+    readonly serviceRef?: `0x${string}`;
+    readonly mandateId?: `0x${string}`;
+}
+export interface ProveConsumedHttpsResponseInput {
+    readonly url: string;
+    readonly method?: "GET" | "POST" | "PUT";
+    readonly headers?: Record<string, string>;
+    readonly body?: string;
+    readonly secretHeaders?: Record<string, string>;
+    readonly responseMatches: readonly HttpsResponseMatch[];
+    readonly responseRedactions?: readonly HttpsResponseRedaction[];
+    readonly cookie?: string;
+    readonly secretParamValues?: Record<string, string>;
+    readonly geoLocation?: string;
+    readonly useTee?: boolean;
+    readonly zkEngine?: "snarkjs" | "stwo";
+    readonly delivery: DeliveryProofBinding;
+}
+export interface VerifiedConsumedHttpsResponseProof {
+    readonly proof: ReclaimProof;
+    readonly request: {
+        readonly url: string;
+        readonly method: "GET" | "POST" | "PUT";
+        readonly body: string | null;
+        readonly responseMatches: readonly HttpsResponseMatch[];
+        readonly responseRedactions: readonly HttpsResponseRedaction[];
+    };
+    readonly verification: {
+        readonly context: Record<string, unknown>;
+        readonly extractedParameters: Record<string, string>;
+        readonly publicData: unknown;
+        readonly isTeeAttestationVerified: boolean;
+        readonly isAttestorTeeAttestationVerified: boolean;
+    };
+}
+export interface ReclaimProofServiceConfig {
+    readonly applicationId: string;
+    readonly applicationSecret: string;
+    readonly logs?: boolean;
+}
+export interface ParsedReclaimProofEnv extends ReclaimProofServiceConfig {
+}
+export interface ReclaimClientLike {
+    zkFetch(url: string, options?: {
+        method: string;
+        body?: string;
+        headers?: Record<string, string>;
+        geoLocation?: string;
+        context?: {
+            contextAddress: string;
+            contextMessage: string;
+        };
+        useTee?: boolean;
+        zkEngine?: "snarkjs" | "stwo";
+    }, secretOptions?: {
+        headers?: Record<string, string>;
+        responseMatches?: readonly HttpsResponseMatch[];
+        responseRedactions?: readonly HttpsResponseRedaction[];
+        cookieStr?: string;
+        paramValues?: Record<string, string>;
+    }): Promise<ReclaimProof | undefined>;
+}
+export type VerifyProofFn = (proof: ReclaimProof, config: Parameters<typeof verifyProof>[1]) => Promise<VerifyProofResult>;
+export interface ConsumerDeliveryProofService {
+    proveConsumedHttpsResponse(input: ProveConsumedHttpsResponseInput): Promise<VerifiedConsumedHttpsResponseProof>;
+}
+export declare class ResponseProofUnavailableError extends Error {
+    constructor(message: string);
+}
+export declare class ResponseProofVerificationError extends Error {
+    constructor(message: string);
+}
+export declare class ReclaimConsumerProofService implements ConsumerDeliveryProofService {
+    private readonly client;
+    private readonly config;
+    private readonly verifyProofImpl;
+    constructor(config: ReclaimProofServiceConfig, options?: {
+        readonly createClient?: (applicationId: string, applicationSecret: string, logs: boolean) => ReclaimClientLike;
+        readonly verifyProof?: VerifyProofFn;
+    });
+    proveConsumedHttpsResponse(input: ProveConsumedHttpsResponseInput): Promise<VerifiedConsumedHttpsResponseProof>;
+}
+export declare function parseReclaimProofEnv(env?: NodeJS.ProcessEnv): ParsedReclaimProofEnv | null;
+export declare function createReclaimConsumerProofServiceFromEnv(env?: NodeJS.ProcessEnv): ReclaimConsumerProofService | null;
+export {};
+//# sourceMappingURL=reclaim.d.ts.map

package/dist/zktls/reclaim.d.ts.map

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