run402 4.10.1 → 4.11.0

package/sdk/dist/node/paid-fetch.d.ts

@@ -18,6 +18,7 @@
 import type { CredentialsProvider } from "../credentials.js";
 import { Run402Error } from "../errors.js";
 import type { MppStack, X402Stack } from "./_paid-stack.js";
+import { PaymentBuyerError, type PayExecutor } from "../namespaces/pay.js";
 import { type PaymentAttemptStore } from "./payment-attempts.js";
 type FetchFn = typeof globalThis.fetch;
 interface RpcClient {
@@ -34,6 +35,36 @@ interface PaymentRequirementLike {
     amount?: string;
     [key: string]: unknown;
 }
+export interface X402PaymentRequirements {
+    scheme: string;
+    network: string;
+    asset: string;
+    amount: string;
+    payTo: string;
+    maxTimeoutSeconds: number;
+    extra: Record<string, unknown>;
+}
+export interface X402PaymentRequired {
+    x402Version: number;
+    error?: string;
+    resource: {
+        url: string;
+        description?: string;
+        mimeType?: string;
+    };
+    accepts: X402PaymentRequirements[];
+    extensions?: Record<string, unknown>;
+}
+export interface X402PaymentPayload {
+    x402Version: number;
+    resource?: X402PaymentRequired["resource"];
+    accepted: X402PaymentRequirements;
+    payload: Record<string, unknown>;
+    extensions?: Record<string, unknown>;
+}
+export interface X402BuyerClient {
+    createPaymentPayload(required: X402PaymentRequired): Promise<X402PaymentPayload>;
+}
 interface KnownBalance {
     status: "known";
     balance: bigint;
@@ -106,12 +137,15 @@ export interface PaymentPayerProvenance {
 }
 export type ConfiguredPaidFetch = FetchFn & {
     readonly payer: PaymentPayerProvenance;
+    readonly pay?: PayExecutor;
     /** Refreshes mutable balance state without re-resolving the selected payer. */
     refreshBalances(): Promise<void>;
 };
 export type LazyPaidFetch = FetchFn & {
     /** Initializes the selected source if needed and returns public payer provenance only. */
     getPayer(): Promise<PaymentPayerProvenance | null>;
+    /** Execute the receipt-bearing arbitrary-URL buyer flow. */
+    pay: PayExecutor;
 };
 export interface PaidFetchOptions {
     /** Explicit local allowance file. When set, no other allowance is consulted. */
@@ -131,6 +165,7 @@ interface TrackedPaidFetchOptions {
     createAttemptId?: () => string;
     now?: () => string;
     fetch?: FetchFn;
+    classifyPaymentResponse?: (response: Response) => Promise<"completed" | "failed" | "already_settled" | "intent_pending" | "ambiguous">;
 }
 /** @internal Exported only for deterministic source-level tests; not re-exported by the package. */
 export declare function checkBalanceAcrossProviders(clients: readonly RpcClient[], tokenAddress: string, walletAddress: string, network: string, options?: BalanceRetryOptions): Promise<bigint>;
@@ -148,6 +183,16 @@ export declare function createLazyPaidFetch(options?: PaidFetchOptions): LazyPai
 export declare const __paidFetchInternals: {
     createLazyPaidFetchFrom: typeof createLazyPaidFetchFrom;
 };
+interface X402BuyerFetchOptions extends TrackedPaidFetchOptions {
+    supportedNetworks: readonly string[];
+}
+/**
+ * Receipt-bearing buyer orchestration over an already-configured x402 client.
+ * Signed proofs live only in this SDK instance's memory. An ambiguous retry of
+ * the identical request re-presents that proof; it never mints a replacement.
+ */
+export declare function createX402BuyerFetch(client: X402BuyerClient, options: X402BuyerFetchOptions): PayExecutor;
+export declare function paymentNetworkUnsupportedError(challengeNetworkValues: string[], walletNetworkValues: string[], extra?: Record<string, unknown>): PaymentBuyerError;
 /**
  * Request-scoped payment tracker around `@x402/fetch`.
  *

package/sdk/dist/node/paid-fetch.d.ts.map

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

package/sdk/dist/node/paid-fetch.js

@@ -17,8 +17,10 @@
  */
 import { readAllowance } from "../../core-dist/allowance.js";
 import { AsyncLocalStorage } from "node:async_hooks";
+import { createHash } from "node:crypto";
 import { LocalError, PaymentAttemptError, Run402Error, } from "../errors.js";
 import { PaidStackUnavailable, loadMppStack, loadX402Stack } from "./_paid-stack.js";
+import { DEFAULT_PAYMENT_MAX_USD_MICROS, PaymentBuyerError, gatewayPaymentBuyerError, isTrustedRun402PaymentUrl, isTrustedRun402PendingResponse, payResponseMetadata, paymentExceedsMaxError, readPaymentErrorEnvelope, responseSignalsReplay, walletUnavailableError, } from "../namespaces/pay.js";
 import { attemptIdFromRequest, createFilePaymentAttemptStore, createPaymentAttemptId, hasPaymentAuthorization, requestSummary, withPaymentAttemptHeader, } from "./payment-attempts.js";
 /**
  * A machine-readable x402 balance-preflight failure.
@@ -361,6 +363,13 @@ export async function setupPaidFetch(options = {}) {
                 }
             };
         }, client);
+        const supportedNetworks = [
+            ...(mainnetSigner ? ["eip155:8453"] : []),
+            ...(sepoliaSigner ? ["eip155:84532"] : []),
+        ];
+        const buyer = createX402BuyerFetch(client, {
+            supportedNetworks,
+        });
         return withPayer(trackedFetch, {
             source: options.paymentSigner ? "payment_signer" : resolvedAllowance.source,
             rail: "x402",
@@ -368,7 +377,7 @@ export async function setupPaidFetch(options = {}) {
                 ...(mainnetSigner ? [{ address: mainnetSigner.address, network: "eip155:8453" }] : []),
                 ...(sepoliaSigner ? [{ address: sepoliaSigner.address, network: "eip155:84532" }] : []),
             ],
-        }, refreshBalances);
+        }, refreshBalances, buyer);
     }
     catch (err) {
         // Missing optional peers are a stable local capability state. Other setup
@@ -479,6 +488,25 @@ export function createLazyPaidFetch(options = {}) {
         async getPayer() {
             return (await initialize())?.payer ?? null;
         },
+        async pay(url, init, payOptions) {
+            const configured = await initialize();
+            if (configured?.pay)
+                return configured.pay(url, init, payOptions);
+            const response = await globalThis.fetch(url, init);
+            if (response.status !== 402) {
+                return {
+                    response,
+                    payment: null,
+                    outcome: "not_required",
+                    replay: await responseSignalsReplay(response, payOptions.idempotencyKey !== undefined),
+                    ...payResponseMetadata(response),
+                };
+            }
+            if (configured?.payer.rail === "mpp") {
+                throw paymentNetworkUnsupportedError(challengeNetworks(response), configured.payer.payers.flatMap((payer) => payer.network ? [payer.network] : []), { configured_rail: "mpp" });
+            }
+            throw walletUnavailableError({ challenge_networks: challengeNetworks(response) });
+        },
     });
 }
 function validatePaymentSource(options) {
@@ -515,8 +543,8 @@ async function resolveAllowance(options) {
         return null;
     }
 }
-function withPayer(fetchFn, payer, refreshBalances = async () => { }) {
-    return Object.assign(fetchFn, { payer, refreshBalances });
+function withPayer(fetchFn, payer, refreshBalances = async () => { }, pay) {
+    return Object.assign(fetchFn, { payer, refreshBalances, ...(pay ? { pay } : {}) });
 }
 function localAllowanceSigners(stack, allowance, mainnetClient, sepoliaClient) {
     const account = stack.privateKeyToAccount(allowance.privateKey);
@@ -529,6 +557,431 @@ function localAllowanceSigners(stack, allowance, mainnetClient, sepoliaClient) {
 export const __paidFetchInternals = {
     createLazyPaidFetchFrom,
 };
+/**
+ * Receipt-bearing buyer orchestration over an already-configured x402 client.
+ * Signed proofs live only in this SDK instance's memory. An ambiguous retry of
+ * the identical request re-presents that proof; it never mints a replacement.
+ */
+export function createX402BuyerFetch(client, options) {
+    const calls = new AsyncLocalStorage();
+    const proofs = new Map();
+    const creatingProofs = new Map();
+    const tracked = createTrackedX402Fetch((baseFetch) => async (input, init) => {
+        const call = calls.getStore();
+        if (!call) {
+            throw settlementError("The x402 buyer lost its request context before dispatch.", false);
+        }
+        const request = new Request(input, init);
+        const cached = proofs.get(call.fingerprint);
+        if (cached) {
+            call.proof = cached;
+            call.replayedProof = true;
+            return baseFetch(withProof(request, cached.headers));
+        }
+        const retryRequest = request.clone();
+        const firstResponse = await baseFetch(request);
+        if (firstResponse.status !== 402)
+            return firstResponse;
+        const required = await decodePaymentRequired(firstResponse);
+        const guarded = guardPaymentRequired(required, options.supportedNetworks, call.maxUsdMicros, request.url);
+        let pending = creatingProofs.get(call.fingerprint);
+        if (!pending) {
+            pending = createProof(client, guarded)
+                .finally(() => creatingProofs.delete(call.fingerprint));
+            creatingProofs.set(call.fingerprint, pending);
+        }
+        const proof = await pending;
+        proofs.set(call.fingerprint, proof);
+        call.proof = proof;
+        return baseFetch(withProof(retryRequest, proof.headers));
+    }, client, {
+        store: options.store,
+        createAttemptId: options.createAttemptId,
+        now: options.now,
+        fetch: options.fetch,
+        async classifyPaymentResponse(response) {
+            const call = calls.getStore();
+            const envelope = await readPaymentErrorEnvelope(response);
+            if (call && isTrustedRun402PendingResponse({
+                requestUrl: call.requestUrl,
+                response,
+                envelope,
+                paymentBearing: true,
+                redirectsDisabled: true,
+            })) {
+                return "intent_pending";
+            }
+            if (call && envelope && trustedRun402ResponseOrigin(call.requestUrl, response) &&
+                gatewayPaymentBuyerError(response, envelope)) {
+                return "failed";
+            }
+            const failure = await upstreamFailure(response);
+            if (call?.replayedProof && isAlreadyUsedFailure(failure)) {
+                call.alreadySettled = true;
+                return "already_settled";
+            }
+            return isProvenNoSettlementFailure(failure) ? "failed" : "ambiguous";
+        },
+    });
+    return async (url, init, payOptions) => {
+        const maxUsdMicros = payOptions.maxUsdMicros ?? DEFAULT_PAYMENT_MAX_USD_MICROS;
+        const fingerprint = await paymentRequestFingerprint(url, init, maxUsdMicros);
+        const call = {
+            fingerprint,
+            requestUrl: url,
+            maxUsdMicros,
+            replayedProof: false,
+            alreadySettled: false,
+        };
+        try {
+            const response = await calls.run(call, () => tracked(url, init));
+            if (!call.proof) {
+                return {
+                    response,
+                    payment: null,
+                    outcome: "not_required",
+                    replay: await responseSignalsReplay(response, payOptions.idempotencyKey !== undefined),
+                    ...payResponseMetadata(response),
+                };
+            }
+            if (call.alreadySettled) {
+                proofs.delete(fingerprint);
+                return {
+                    response,
+                    payment: null,
+                    outcome: "already_settled",
+                    replay: true,
+                    ...payResponseMetadata(response),
+                };
+            }
+            if (!response.ok) {
+                const envelope = await readPaymentErrorEnvelope(response);
+                if (envelope && trustedRun402ResponseOrigin(url, response)) {
+                    const gatewayError = gatewayPaymentBuyerError(response, envelope);
+                    if (gatewayError)
+                        throw gatewayError;
+                }
+                const failure = await upstreamFailure(response);
+                proofs.delete(fingerprint);
+                if (failure.code === "payment_insufficient_funds") {
+                    throw walletUnavailableError({
+                        upstream_code: failure.code,
+                        ...(failure.details ?? {}),
+                    });
+                }
+                throw settlementError("The x402 payment proof was rejected before settlement.", false, {
+                    upstream_code: failure.code,
+                    ...(failure.x402Error ? { x402_error: failure.x402Error } : {}),
+                });
+            }
+            const payment = receiptFromResponse(response, call.proof.accepted, url);
+            proofs.delete(fingerprint);
+            return {
+                response,
+                payment,
+                outcome: "settled",
+                replay: call.replayedProof,
+                ...payResponseMetadata(response),
+            };
+        }
+        catch (cause) {
+            if (cause instanceof PaymentBuyerError)
+                throw cause;
+            if (cause instanceof X402BalanceError) {
+                if (cause.code === "X402_INSUFFICIENT_FUNDS") {
+                    throw walletUnavailableError(asRecord(cause.details));
+                }
+                throw settlementError("The buyer could not confirm wallet funds before signing; no funds moved.", false, { upstream_code: cause.code, ...(asRecord(cause.details)) }, cause, true);
+            }
+            if (cause instanceof PaymentAttemptError) {
+                const fundsMoved = cause.mutationState === "ambiguous" ? "unknown" : false;
+                throw settlementError(fundsMoved === "unknown"
+                    ? "The payment-bearing request lost its response; settlement may have occurred. The same SDK instance retains the original proof for an identical retry."
+                    : "The payment attempt failed before funds could move.", fundsMoved, {
+                    payment_attempt_id: cause.paymentAttemptId,
+                    phase: cause.phase,
+                    provider_started: cause.providerStarted,
+                    upstream_code: cause.code,
+                }, cause, cause.safeToRetry, cause.nextActions);
+            }
+            throw settlementError("The x402 payment authorization could not be created; no funds moved.", false, {}, cause);
+        }
+    };
+}
+async function createProof(client, required) {
+    try {
+        const payload = await client.createPaymentPayload(required);
+        return {
+            accepted: payload.accepted,
+            headers: {
+                [payload.x402Version === 1 ? "X-PAYMENT" : "PAYMENT-SIGNATURE"]: encodeBase64Json(payload),
+            },
+        };
+    }
+    catch (cause) {
+        throw unwrapPolicyError(cause) ?? cause;
+    }
+}
+function guardPaymentRequired(required, supportedNetworks, maxUsdMicros, requestUrl) {
+    let challengeUrl;
+    try {
+        challengeUrl = new URL(required.resource.url).toString();
+    }
+    catch (cause) {
+        throw settlementError("The x402 challenge resource URL is invalid.", false, { challenge_url: required.resource.url, request_url: requestUrl }, cause);
+    }
+    if (challengeUrl !== new URL(requestUrl).toString()) {
+        throw settlementError("The x402 challenge is bound to a different resource URL.", false, { challenge_url: challengeUrl, request_url: requestUrl });
+    }
+    const supportedByNetwork = required.accepts.filter((accept) => accept.scheme === "exact" && supportedNetworks.includes(accept.network));
+    if (supportedByNetwork.length === 0) {
+        throw paymentNetworkUnsupportedError([...new Set(required.accepts.map((accept) => accept.network))], [...supportedNetworks]);
+    }
+    const supported = supportedByNetwork.filter((accept) => accept.asset.toLowerCase() === supportedPaymentAsset(accept.network)?.toLowerCase());
+    if (supported.length === 0) {
+        throw paymentNetworkUnsupportedError([...new Set(required.accepts.map((accept) => accept.network))], [...supportedNetworks], {
+            challenge_assets: [...new Set(supportedByNetwork.map((accept) => accept.asset))],
+            wallet_assets: [...new Set(supportedNetworks.flatMap((network) => {
+                    const asset = supportedPaymentAsset(network);
+                    return asset ? [asset] : [];
+                }))],
+        });
+    }
+    const valid = supported.map((accept) => ({ accept, amount: atomicAmount(accept.amount) }));
+    if (valid.some(({ amount }) => amount === null)) {
+        throw settlementError("The x402 challenge contains an invalid atomic amount.", false, { challenge_amounts: supported.map((accept) => accept.amount) });
+    }
+    const withinLimit = valid.filter((entry) => entry.amount !== null && entry.amount <= maxUsdMicros);
+    if (withinLimit.length === 0) {
+        const challenged = Math.min(...valid.map(({ amount }) => amount));
+        throw paymentExceedsMaxError(challenged, maxUsdMicros);
+    }
+    return { ...required, accepts: withinLimit.map(({ accept }) => accept) };
+}
+function supportedPaymentAsset(network) {
+    if (network === "eip155:8453")
+        return USDC_MAINNET;
+    if (network === "eip155:84532")
+        return USDC_SEPOLIA;
+    return null;
+}
+function atomicAmount(value) {
+    if (!/^\d+$/.test(value))
+        return null;
+    const amount = Number(value);
+    return Number.isSafeInteger(amount) ? amount : null;
+}
+function withProof(request, proofHeaders) {
+    const headers = new Headers(request.headers);
+    for (const [name, value] of Object.entries(proofHeaders))
+        headers.set(name, value);
+    return new Request(request, { headers });
+}
+async function decodePaymentRequired(response) {
+    const header = response.headers.get("PAYMENT-REQUIRED");
+    if (!header) {
+        throw settlementError("The 402 response did not include a PAYMENT-REQUIRED challenge header.", false);
+    }
+    let decoded;
+    try {
+        decoded = decodeBase64Json(header);
+    }
+    catch (cause) {
+        throw settlementError("The PAYMENT-REQUIRED challenge header is invalid.", false, {}, cause);
+    }
+    if (!isPaymentRequired(decoded)) {
+        throw settlementError("The PAYMENT-REQUIRED challenge has an invalid shape.", false);
+    }
+    return decoded;
+}
+function isPaymentRequired(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const candidate = value;
+    return Number.isInteger(candidate.x402Version) &&
+        Boolean(candidate.resource && typeof candidate.resource.url === "string") &&
+        Array.isArray(candidate.accepts) &&
+        candidate.accepts.every((accept) => Boolean(accept &&
+            typeof accept.scheme === "string" &&
+            typeof accept.network === "string" &&
+            typeof accept.asset === "string" &&
+            typeof accept.amount === "string" &&
+            typeof accept.payTo === "string"));
+}
+function receiptFromResponse(response, accepted, url) {
+    const header = response.headers.get("PAYMENT-RESPONSE") ?? response.headers.get("X-PAYMENT-RESPONSE");
+    if (!header) {
+        throw settlementError("The paid response omitted the standard PAYMENT-RESPONSE settlement receipt, so settlement cannot be reported faithfully.", "unknown", { response_status: response.status });
+    }
+    let settlement;
+    try {
+        settlement = decodeBase64Json(header);
+    }
+    catch (cause) {
+        throw settlementError("The PAYMENT-RESPONSE settlement receipt is invalid.", "unknown", { response_status: response.status }, cause);
+    }
+    const record = asRecord(settlement);
+    if (record.success !== true || typeof record.transaction !== "string" || record.transaction === "") {
+        throw settlementError("The payment response does not prove a successful on-chain settlement.", record.success === false ? false : "unknown", { response_status: response.status });
+    }
+    if (record.network !== accepted.network) {
+        throw settlementError("The payment response network does not match the accepted x402 challenge.", "unknown", {
+            accepted_network: accepted.network,
+            receipt_network: typeof record.network === "string" ? record.network : null,
+            response_status: response.status,
+        });
+    }
+    const amount = atomicAmount(accepted.amount);
+    if (amount === null) {
+        throw settlementError("The selected payment amount cannot be represented as usd_micros.", "unknown");
+    }
+    return {
+        amount_usd_micros: amount,
+        pay_to: accepted.payTo,
+        network: record.network,
+        tx_ref: record.transaction,
+        url,
+    };
+}
+async function upstreamFailure(response) {
+    const challengeError = paymentRequiredError(response);
+    if (!response.headers.get("content-type")?.includes("application/json")) {
+        return { code: null, x402Error: challengeError, details: null };
+    }
+    try {
+        const body = asRecord(await response.clone().json());
+        const details = asRecord(body.details);
+        return {
+            code: typeof body.code === "string" ? body.code : null,
+            x402Error: typeof details.x402_error === "string" ? details.x402_error : challengeError,
+            details: Object.keys(details).length > 0 ? details : null,
+        };
+    }
+    catch {
+        return { code: null, x402Error: challengeError, details: null };
+    }
+}
+function paymentRequiredError(response) {
+    const header = response.headers.get("PAYMENT-REQUIRED");
+    if (!header)
+        return null;
+    try {
+        const decoded = asRecord(decodeBase64Json(header));
+        return typeof decoded.error === "string" ? decoded.error : null;
+    }
+    catch {
+        return null;
+    }
+}
+function isAlreadyUsedFailure(failure) {
+    if (failure.code !== "TENANT_X402_PAYMENT_INVALID")
+        return false;
+    return /already.{0,20}used|used.{0,20}(authorization|nonce)|nonce.{0,20}used/i.test(failure.x402Error ?? "");
+}
+function isProvenNoSettlementFailure(failure) {
+    if (failure.code === "payment_insufficient_funds")
+        return true;
+    if (failure.code === "TENANT_X402_SETTLEMENT_FAILED")
+        return true;
+    return failure.code === "TENANT_X402_PAYMENT_INVALID" && !isAlreadyUsedFailure(failure);
+}
+export function paymentNetworkUnsupportedError(challengeNetworkValues, walletNetworkValues, extra = {}) {
+    return new PaymentBuyerError({
+        code: "PAYMENT_NETWORK_UNSUPPORTED",
+        message: "The x402 challenge does not offer an exact-scheme network and asset supported by this wallet.",
+        fundsMoved: false,
+        details: {
+            challenge_networks: challengeNetworkValues,
+            wallet_networks: walletNetworkValues,
+            ...extra,
+        },
+        nextActions: [
+            {
+                type: "edit_request",
+                why: "Use a priced endpoint on one of the wallet networks, or configure a signer for a challenge network.",
+            },
+        ],
+    });
+}
+function settlementError(message, fundsMoved, details = {}, cause, retryable = false, nextActions) {
+    return new PaymentBuyerError({
+        code: "PAYMENT_SETTLEMENT_FAILED",
+        message,
+        fundsMoved,
+        details,
+        retryable,
+        safeToRetry: fundsMoved === false,
+        cause,
+        nextActions: nextActions && nextActions.length > 0
+            ? nextActions
+            : fundsMoved === "unknown"
+                ? [
+                    {
+                        type: "reconcile_payment",
+                        safe_to_auto_execute: false,
+                        why: "Confirm the original settlement before authorizing a different payment proof.",
+                    },
+                ]
+                : [
+                    {
+                        type: "retry",
+                        why: "No funds moved; retry after correcting the reported pre-settlement failure.",
+                    },
+                ],
+    });
+}
+function challengeNetworks(response) {
+    const header = response.headers.get("PAYMENT-REQUIRED");
+    if (!header)
+        return [];
+    try {
+        const decoded = decodeBase64Json(header);
+        return [...new Set((decoded.accepts ?? []).flatMap((accept) => typeof accept.network === "string" ? [accept.network] : []))];
+    }
+    catch {
+        return [];
+    }
+}
+async function paymentRequestFingerprint(url, init, maxUsdMicros) {
+    let request;
+    try {
+        request = new Request(url, init);
+    }
+    catch (cause) {
+        throw settlementError("The paid request could not be constructed.", false, {}, cause);
+    }
+    const headerEntries = [];
+    request.headers.forEach((value, name) => headerEntries.push([name, value]));
+    const headers = headerEntries
+        .filter(([name]) => ![
+        "payment-signature",
+        "x-payment",
+        "x-run402-payment-attempt-id",
+    ].includes(name.toLowerCase()))
+        .sort(([a], [b]) => a.localeCompare(b));
+    let bodyHash = "";
+    try {
+        const body = new Uint8Array(await request.clone().arrayBuffer());
+        bodyHash = createHash("sha256").update(body).digest("hex");
+    }
+    catch (cause) {
+        throw settlementError("The paid request body cannot be replayed safely.", false, {}, cause);
+    }
+    return createHash("sha256")
+        .update(JSON.stringify({ method: request.method, url: request.url, headers, bodyHash, maxUsdMicros }))
+        .digest("hex");
+}
+function encodeBase64Json(value) {
+    return Buffer.from(JSON.stringify(value)).toString("base64url");
+}
+function decodeBase64Json(value) {
+    return JSON.parse(Buffer.from(value, "base64url").toString("utf8"));
+}
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
 /**
  * Request-scoped payment tracker around `@x402/fetch`.
  *
@@ -678,13 +1131,29 @@ export function createTrackedX402Fetch(wrapFetchWithPayment, client, opts = {})
             try {
                 const response = await paidFetch(input, init);
                 if (context.providerStarted) {
-                    const completed = response.ok;
+                    const classification = response.ok
+                        ? "completed"
+                        : await opts.classifyPaymentResponse?.(response) ?? "ambiguous";
+                    const completed = classification === "completed" || classification === "already_settled";
+                    const failed = classification === "failed";
+                    const intentPending = classification === "intent_pending";
+                    const retryAfter = retryAfterSeconds(response);
                     writeRecordBestEffort(context, store, {
-                        state: completed ? "completed" : "ambiguous",
-                        mutation_state: completed ? "completed" : "ambiguous",
+                        state: completed ? "completed" : failed ? "failed" : intentPending ? "intent_pending" : "ambiguous",
+                        mutation_state: completed ? "completed" : failed ? "not_started" : "ambiguous",
                         response_status: response.status,
+                        ...(intentPending ? {
+                            last_error_code: "PAYMENT_INTENT_PENDING",
+                            ...(nonEmptyHeader(response, "x-run402-payment-id")
+                                ? { payment_id: nonEmptyHeader(response, "x-run402-payment-id") }
+                                : {}),
+                            intent_state: "pending",
+                            ...(retryAfter !== null ? { retry_after_seconds: retryAfter } : {}),
+                        } : {}),
                     });
-                    if (!completed) {
+                    if (intentPending)
+                        return response;
+                    if (!completed && !failed) {
                         throw new PaymentAttemptError({
                             code: "X402_PAYMENT_OUTCOME_AMBIGUOUS",
                             message: "The x402 payment target returned a non-success response after provider dispatch; reconcile the attempt before paying again.",
@@ -793,6 +1262,9 @@ function claimIntent(context, store, now) {
         method: context.request.method,
         origin: context.request.origin,
         path_sha256: context.request.path_sha256,
+        ...(context.request.caller_key_sha256
+            ? { caller_key_sha256: context.request.caller_key_sha256 }
+            : {}),
         created_at: context.createdAt,
         updated_at: updatedAt,
     };
@@ -807,6 +1279,29 @@ function claimIntent(context, store, now) {
         throw new AttemptJournalWriteError(cause);
     }
 }
+function trustedRun402ResponseOrigin(requestUrl, response) {
+    if (!response.url || response.redirected)
+        return false;
+    try {
+        const request = new URL(requestUrl);
+        const returned = new URL(response.url);
+        return request.origin === returned.origin && isTrustedRun402PaymentUrl(request);
+    }
+    catch {
+        return false;
+    }
+}
+function retryAfterSeconds(response) {
+    const raw = response.headers.get("retry-after");
+    if (!raw || !/^\d+$/.test(raw))
+        return null;
+    const seconds = Number(raw);
+    return Number.isSafeInteger(seconds) ? seconds : null;
+}
+function nonEmptyHeader(response, name) {
+    const value = response.headers.get(name)?.trim();
+    return value ? value : null;
+}
 function writeRecord(context, store, patch) {
     if (!context.record)
         throw new AttemptJournalWriteError("payment intent missing");