@absol-labs/agent 0.10.0 → 0.11.0

package/dist/x402/facilitator-server.js

@@ -0,0 +1,305 @@
+import { createServer, } from "node:http";
+import { timingSafeEqual } from "node:crypto";
+import { isAddress, isHex } from "viem";
+import { createOracleDeliveryOracle, DEFAULT_DELIVERY_FRESHNESS_SECONDS, DEFAULT_METRIK_ORACLE_URL, } from "./delivery-oracle.js";
+import { createRegistryResourceIndex } from "./resource-index.js";
+import { createX402PaymentSettler, createX402PaymentVerifier, relayerAddress, } from "./relayer.js";
+import { DEFAULT_SETTLEMENT_SCOPE, MetrikVerifiedDeliveryFacilitator, RelayerNotConfiguredError, } from "./verified-delivery-facilitator.js";
+/**
+ * Reference HTTP server for Metrik's x402 facilitator: `POST /verify`,
+ * `POST /settle`, `GET /supported` — the three endpoints the x402 facilitator
+ * interface defines, with Metrik's verified-delivery gate wired into `/verify`.
+ *
+ * Point any x402 resource server at this with
+ * `facilitator: { url: "https://<host>" }` and it becomes a resource server
+ * whose payments stop when the seller stops delivering.
+ */
+const MAX_BODY_BYTES = 256 * 1024;
+export function createMetrikFacilitatorServer(config) {
+    const httpServer = createServer((req, res) => {
+        handle(req, res, config).catch((error) => {
+            if (error instanceof RelayerNotConfiguredError) {
+                writeJson(res, 503, {
+                    success: false,
+                    errorReason: "unexpected_settle_error",
+                    transaction: "",
+                    error: error.message,
+                });
+                return;
+            }
+            logError("unhandled request error", error);
+            writeJson(res, 500, { error: "internal-error" });
+        });
+    });
+    return {
+        httpServer,
+        listen: (port, host = "0.0.0.0") => new Promise((resolve, reject) => {
+            const onError = (error) => reject(error);
+            httpServer.once("error", onError);
+            httpServer.listen(port, host, () => {
+                httpServer.removeListener("error", onError);
+                const address = httpServer.address();
+                resolve({ port: address.port, host });
+            });
+        }),
+        close: () => new Promise((resolve, reject) => {
+            httpServer.close((error) => (error ? reject(error) : resolve()));
+        }),
+    };
+}
+async function handle(req, res, config) {
+    const url = new URL(req.url ?? "/", "http://localhost");
+    const path = url.pathname.replace(/\/+$/, "") || "/";
+    if (req.method === "GET" && (path === "/supported" || path === "/")) {
+        writeJson(res, 200, {
+            ...config.facilitator.supported(),
+            settlementEnabled: config.settlementEnabled,
+        });
+        return;
+    }
+    if (req.method !== "POST") {
+        writeJson(res, 405, { error: "method-not-allowed" });
+        return;
+    }
+    if (path !== "/verify" && path !== "/settle") {
+        writeJson(res, 404, { error: "not-found" });
+        return;
+    }
+    // Authenticate BEFORE reading the body: an unauthenticated caller must not be
+    // able to make this process do work, parse input, or reach the chain.
+    if (path === "/settle" && !isAuthorizedSettle(req, config)) {
+        writeJson(res, 401, {
+            success: false,
+            errorReason: "invalid_payment",
+            transaction: "",
+            error: "POST /settle requires the facilitator's bearer token. It spends the operator's gas.",
+        });
+        return;
+    }
+    let body;
+    try {
+        body = JSON.parse(await readBody(req));
+    }
+    catch {
+        writeJson(res, 400, { error: "invalid-json" });
+        return;
+    }
+    if (path === "/verify") {
+        writeJson(res, 200, await config.facilitator.verify(body));
+        return;
+    }
+    writeJson(res, 200, await config.facilitator.settle(body));
+}
+/**
+ * Constant-time bearer check. A missing configured token denies, so a
+ * misconfiguration can never silently open the endpoint.
+ */
+function isAuthorizedSettle(req, config) {
+    const expected = config.settlementToken;
+    if (expected === undefined || expected.length === 0) {
+        return false;
+    }
+    const header = req.headers.authorization;
+    if (typeof header !== "string") {
+        return false;
+    }
+    const match = /^Bearer\s+(.+)$/i.exec(header.trim());
+    if (match === null) {
+        return false;
+    }
+    const presented = Buffer.from(match[1], "utf8");
+    const target = Buffer.from(expected, "utf8");
+    // `timingSafeEqual` throws on a length mismatch, which would itself leak the
+    // length, so compare a fixed-width digest-shaped pair instead: pad both to the
+    // longer length and AND in the length equality.
+    const width = Math.max(presented.length, target.length);
+    const a = Buffer.alloc(width);
+    const b = Buffer.alloc(width);
+    presented.copy(a);
+    target.copy(b);
+    return timingSafeEqual(a, b) && presented.length === target.length;
+}
+async function readBody(req) {
+    const chunks = [];
+    let size = 0;
+    for await (const chunk of req) {
+        const buffer = chunk;
+        size += buffer.length;
+        if (size > MAX_BODY_BYTES) {
+            throw new Error("request body too large");
+        }
+        chunks.push(buffer);
+    }
+    return Buffer.concat(chunks).toString("utf8");
+}
+function writeJson(res, status, body) {
+    if (res.headersSent) {
+        res.end();
+        return;
+    }
+    res
+        .writeHead(status, { "Content-Type": "application/json" })
+        .end(JSON.stringify(body));
+}
+function logError(context, error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`[metrik-x402-facilitator] ${context}: ${message}`);
+}
+/**
+ * Env contract:
+ * - `METRIK_X402_RPC_URL` (required) — RPC for balance checks and, when a relayer
+ *   is configured, for broadcasting.
+ * - `METRIK_X402_RELAYER_PRIVATE_KEY` (required unless
+ *   `METRIK_X402_ALLOW_VERIFY_ONLY=true`) — the relayer that broadcasts EIP-3009
+ *   transfers and pays gas.
+ * - `METRIK_X402_ALLOW_VERIFY_ONLY` (optional) — explicit opt-in to booting a
+ *   verify-only facilitator. Without it, a missing relayer key is a STARTUP
+ *   FAILURE rather than a server that silently never settles.
+ * - `METRIK_X402_CHAIN_ID` (optional) — default `84532`.
+ * - `METRIK_X402_ORACLE_URL` (optional) — default the public Metrik oracle.
+ * - `METRIK_X402_REGISTRY_URL` (optional) — listing source; default the oracle's
+ *   public credential-free registry.
+ * - `METRIK_X402_FRESHNESS_SECONDS` (optional) — default
+ *   {@link DEFAULT_DELIVERY_FRESHNESS_SECONDS}.
+ * - `METRIK_X402_INDETERMINATE_POLICY` (optional) — `allow` (default) or `deny`.
+ * - `PORT` / `METRIK_X402_PORT` (optional) — default `8788`.
+ * - `METRIK_X402_HOST` (optional) — default `0.0.0.0`.
+ */
+export function parseMetrikFacilitatorEnvConfig(env = process.env) {
+    const rpcUrl = env.METRIK_X402_RPC_URL;
+    if (rpcUrl === undefined || rpcUrl.trim().length === 0) {
+        throw new Error("METRIK_X402_RPC_URL is required (fail-closed)");
+    }
+    const rawKey = env.METRIK_X402_RELAYER_PRIVATE_KEY?.trim();
+    const allowVerifyOnly = env.METRIK_X402_ALLOW_VERIFY_ONLY === "true";
+    let relayerPrivateKey;
+    if (rawKey !== undefined && rawKey.length > 0) {
+        if (!isHex(rawKey, { strict: true }) || rawKey.length !== 66) {
+            throw new Error("METRIK_X402_RELAYER_PRIVATE_KEY must be a 32-byte 0x-prefixed hex private key");
+        }
+        relayerPrivateKey = rawKey;
+    }
+    else if (!allowVerifyOnly) {
+        throw new Error("METRIK_X402_RELAYER_PRIVATE_KEY is required to settle payments. " +
+            "This facilitator will NOT start without one, because a facilitator that " +
+            "accepts /settle and never broadcasts is worse than one that is absent. " +
+            "Set METRIK_X402_ALLOW_VERIFY_ONLY=true to deliberately run verify-only.");
+    }
+    // `/settle` makes the relayer sign and pay gas. An open one is a
+    // permissionless "broadcast for me" endpoint, so a settling facilitator
+    // cannot boot without a token. Fail closed at startup, not at request time.
+    const settlementToken = env.METRIK_X402_FACILITATOR_TOKEN?.trim();
+    if (relayerPrivateKey !== undefined) {
+        if (settlementToken === undefined || settlementToken.length < 32) {
+            throw new Error("METRIK_X402_FACILITATOR_TOKEN is required (at least 32 characters) whenever a " +
+                "settlement relayer is configured. POST /settle spends the operator's gas and " +
+                "binds 0.0.0.0; without a token anyone who can reach it can make the relayer " +
+                "broadcast and pay for it.");
+        }
+    }
+    const rawAllowlist = (env.METRIK_X402_SETTLEMENT_ASSETS ?? "")
+        .split(",")
+        .map((value) => value.trim())
+        .filter((value) => value.length > 0);
+    for (const candidate of rawAllowlist) {
+        if (!isAddress(candidate)) {
+            throw new Error(`METRIK_X402_SETTLEMENT_ASSETS must contain only EVM addresses (got ${candidate})`);
+        }
+    }
+    const rawScope = env.METRIK_X402_SETTLEMENT_SCOPE ?? DEFAULT_SETTLEMENT_SCOPE;
+    if (rawScope !== "tracked-resources" && rawScope !== "any-resource") {
+        throw new Error(`invalid METRIK_X402_SETTLEMENT_SCOPE: ${rawScope} (tracked-resources|any-resource)`);
+    }
+    const chainId = Number(env.METRIK_X402_CHAIN_ID ?? "84532");
+    if (!Number.isInteger(chainId) || chainId <= 0) {
+        throw new Error(`invalid METRIK_X402_CHAIN_ID: ${env.METRIK_X402_CHAIN_ID}`);
+    }
+    const freshnessWindowSeconds = Number(env.METRIK_X402_FRESHNESS_SECONDS ??
+        String(DEFAULT_DELIVERY_FRESHNESS_SECONDS));
+    if (!Number.isFinite(freshnessWindowSeconds) || freshnessWindowSeconds <= 0) {
+        throw new Error(`invalid METRIK_X402_FRESHNESS_SECONDS: ${env.METRIK_X402_FRESHNESS_SECONDS}`);
+    }
+    const rawPolicy = env.METRIK_X402_INDETERMINATE_POLICY ?? "allow";
+    if (rawPolicy !== "allow" && rawPolicy !== "deny") {
+        throw new Error(`invalid METRIK_X402_INDETERMINATE_POLICY: ${rawPolicy} (allow|deny)`);
+    }
+    const port = Number(env.METRIK_X402_PORT ?? env.PORT ?? "8788");
+    if (!Number.isInteger(port) || port < 0 || port > 65535) {
+        throw new Error(`invalid port: ${env.METRIK_X402_PORT ?? env.PORT}`);
+    }
+    const registryUrl = env.METRIK_X402_REGISTRY_URL;
+    return {
+        host: env.METRIK_X402_HOST ?? "0.0.0.0",
+        port,
+        chainId,
+        rpcUrl,
+        oracleUrl: env.METRIK_X402_ORACLE_URL ?? DEFAULT_METRIK_ORACLE_URL,
+        freshnessWindowSeconds,
+        indeterminatePolicy: rawPolicy,
+        settlementScope: rawScope,
+        ...(rawAllowlist.length === 0
+            ? {}
+            : { settlementAssetAllowlist: rawAllowlist }),
+        ...(registryUrl === undefined ? {} : { registryUrl }),
+        ...(relayerPrivateKey === undefined ? {} : { relayerPrivateKey }),
+        ...(settlementToken === undefined || settlementToken.length === 0
+            ? {}
+            : { settlementToken }),
+    };
+}
+export function buildMetrikFacilitatorFromEnvConfig(config) {
+    return new MetrikVerifiedDeliveryFacilitator({
+        paymentVerifier: createX402PaymentVerifier({
+            chainId: config.chainId,
+            rpcUrl: config.rpcUrl,
+        }),
+        ...(config.relayerPrivateKey === undefined
+            ? {}
+            : {
+                paymentSettler: createX402PaymentSettler({
+                    chainId: config.chainId,
+                    rpcUrl: config.rpcUrl,
+                    privateKey: config.relayerPrivateKey,
+                }),
+            }),
+        resourceIndex: createRegistryResourceIndex(config.registryUrl === undefined
+            ? {}
+            : { discoverOptions: { registryUrl: config.registryUrl } }),
+        deliveryOracle: createOracleDeliveryOracle({
+            oracleUrl: config.oracleUrl,
+            freshnessWindowSeconds: config.freshnessWindowSeconds,
+        }),
+        indeterminatePolicy: config.indeterminatePolicy,
+        chainId: config.chainId,
+        settlementScope: config.settlementScope,
+        ...(config.settlementAssetAllowlist === undefined
+            ? {}
+            : { settlementAssetAllowlist: config.settlementAssetAllowlist }),
+    });
+}
+export async function startMetrikFacilitatorServerFromEnv(env = process.env) {
+    const config = parseMetrikFacilitatorEnvConfig(env);
+    const facilitator = buildMetrikFacilitatorFromEnvConfig(config);
+    if (config.relayerPrivateKey === undefined) {
+        console.error("[metrik-x402-facilitator] SETTLEMENT DISABLED — no METRIK_X402_RELAYER_PRIVATE_KEY. " +
+            "/verify works; /settle will return 503 and broadcast nothing.");
+    }
+    else {
+        console.error(`[metrik-x402-facilitator] settlement relayer ${relayerAddress(config.relayerPrivateKey)} — this address must hold native gas on chain ${config.chainId}.`);
+    }
+    console.error(`[metrik-x402-facilitator] delivery gate: oracle=${config.oracleUrl} ` +
+        `freshness=${config.freshnessWindowSeconds}s policy-on-no-evidence=${config.indeterminatePolicy}`);
+    console.error(`[metrik-x402-facilitator] settlement policy: scope=${config.settlementScope} ` +
+        `assets=${facilitator.allowedSettlementAssets.join(",")} — the relayer will not be ` +
+        "asked to call any other contract.");
+    const server = createMetrikFacilitatorServer({
+        facilitator,
+        settlementEnabled: config.relayerPrivateKey !== undefined,
+        ...(config.settlementToken === undefined
+            ? {}
+            : { settlementToken: config.settlementToken }),
+    });
+    const { port } = await server.listen(config.port, config.host);
+    return Object.assign(server, { boundPort: port });
+}
+//# sourceMappingURL=facilitator-server.js.map

package/dist/x402/facilitator-server.js.map

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

package/dist/x402/facilitator.d.ts

@@ -1,9 +1,33 @@
+/**
+ * Metrik-native HTTP `402` challenge flow.
+ *
+ * This is NOT an implementation of the x402 protocol. It uses its own scheme
+ * string (`streamproof-verified-stream`), its own wire format, and its own
+ * request header (`x-metrik-payment`). It does not interoperate with
+ * `x402-fetch`, `x402-axios`, `x402-express`, or any other x402 client or
+ * facilitator. See `docs/x402.md` for the full explanation of why Metrik's
+ * metered-stream settlement does not fit any shipped x402 scheme.
+ *
+ * The `X402*` / `x402*` exports at the bottom of this file are deprecated
+ * aliases of the canonical names, kept so existing consumers keep working.
+ */
 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";
+/**
+ * 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 declare 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 declare const METRIK_PAYMENT_HEADER: "x-metrik-payment";
 export declare const verifiedStreamRequirementsSchema: z.ZodObject<{
     operator: z.ZodString;
     serviceRef: z.ZodString;
@@ -31,7 +55,7 @@ export declare const verifiedStreamRequirementsSchema: z.ZodObject<{
 }>;
 export interface VerifiedStreamRequirements extends z.infer<typeof verifiedStreamRequirementsSchema> {
 }
-export declare const x402StreamChallengeSchema: z.ZodObject<{
+export declare const streamChallengeSchema: z.ZodObject<{
     scheme: z.ZodLiteral<"streamproof-verified-stream">;
     requirements: z.ZodObject<{
         operator: z.ZodString;
@@ -81,9 +105,9 @@ export declare const x402StreamChallengeSchema: z.ZodObject<{
         maxBudgetUsdc: bigint;
     };
 }>;
-export interface X402StreamChallenge extends z.infer<typeof x402StreamChallengeSchema> {
+export interface StreamChallenge extends z.infer<typeof streamChallengeSchema> {
 }
-export declare const x402OpenPayloadSchema: z.ZodObject<{
+export declare const streamOpenPayloadSchema: z.ZodObject<{
     challenge: z.ZodObject<{
         scheme: z.ZodLiteral<"streamproof-verified-stream">;
         requirements: z.ZodObject<{
@@ -248,19 +272,19 @@ export declare const x402OpenPayloadSchema: z.ZodObject<{
         };
     };
 }>;
-export interface X402OpenPayload extends z.infer<typeof x402OpenPayloadSchema> {
+export interface StreamOpenPayload extends z.infer<typeof streamOpenPayloadSchema> {
 }
-export interface X402Facilitator {
+export interface StreamFacilitator {
     /** Build the 402 challenge a server returns to prompt a verified stream. */
-    challenge(req: VerifiedStreamRequirements): X402StreamChallenge;
+    challenge(req: VerifiedStreamRequirements): StreamChallenge;
     /** 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>;
+    proveConsumedHttpsResponse(input: ConsumedHttpsResponseProofInput): Promise<VerifiedConsumedHttpsResponseProof>;
 }
-export interface X402ConsumedHttpsResponseProofInput {
+export interface ConsumedHttpsResponseProofInput {
     readonly signedMandate: SignedSpendMandate;
     readonly streamId?: `0x${string}`;
     readonly operator?: `0x${string}`;
@@ -286,7 +310,7 @@ export interface VerifiedStreamFacilitatorOptions {
     readonly resolveSpentSoFarUsdc?: (signedMandate: SignedSpendMandate) => bigint | Promise<bigint>;
     readonly resolveRevokedMandateIds?: (signedMandate: SignedSpendMandate) => Iterable<`0x${string}`> | Promise<Iterable<`0x${string}`>>;
 }
-export declare class X402PayloadError extends Error {
+export declare class StreamPayloadError extends Error {
     constructor(message: string);
 }
 export declare class SettlementTargetMismatchError extends Error {
@@ -302,10 +326,10 @@ export declare 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 declare class X402SpendControlUnavailableError extends Error {
+export declare class SpendControlUnavailableError extends Error {
     constructor(message: string);
 }
-export declare class VerifiedStreamX402Facilitator implements X402Facilitator {
+export declare class VerifiedStreamFacilitator implements StreamFacilitator {
     private readonly agentClient;
     private readonly deliveryProofs;
     private readonly sdkConfig;
@@ -313,13 +337,41 @@ export declare class VerifiedStreamX402Facilitator implements X402Facilitator {
     private readonly resolveSpentSoFarUsdc;
     private readonly resolveRevokedMandateIds;
     constructor(options: VerifiedStreamFacilitatorOptions);
-    challenge(req: VerifiedStreamRequirements): X402StreamChallenge;
+    challenge(req: VerifiedStreamRequirements): StreamChallenge;
     open(payloadHeader: string): Promise<{
         streamId: `0x${string}`;
     }>;
-    proveConsumedHttpsResponse(input: X402ConsumedHttpsResponseProofInput): Promise<VerifiedConsumedHttpsResponseProof>;
+    proveConsumedHttpsResponse(input: ConsumedHttpsResponseProofInput): Promise<VerifiedConsumedHttpsResponseProof>;
 }
-export declare function encodeX402PayloadHeader(payload: X402OpenPayload): string;
-export declare function parseX402ChallengeJson(value: unknown): X402StreamChallenge;
-export declare function parseX402PayloadHeader(payloadHeader: string): X402OpenPayload;
+export declare function encodeStreamPayloadHeader(payload: StreamOpenPayload): string;
+export declare function parseStreamChallengeJson(value: unknown): StreamChallenge;
+export declare function parseStreamPayloadHeader(payloadHeader: string): StreamOpenPayload;
+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, };
+export type { 
+/** @deprecated Use {@link StreamFacilitator}. This flow is not x402. */
+StreamFacilitator as X402Facilitator, 
+/** @deprecated Use {@link StreamChallenge}. */
+StreamChallenge as X402StreamChallenge, 
+/** @deprecated Use {@link StreamOpenPayload}. */
+StreamOpenPayload as X402OpenPayload, 
+/** @deprecated Use {@link ConsumedHttpsResponseProofInput}. */
+ConsumedHttpsResponseProofInput as X402ConsumedHttpsResponseProofInput, };
 //# sourceMappingURL=facilitator.d.ts.map

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

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