mppx 0.6.27 → 0.6.29

package/dist/x402/client/Exact.js.map

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

package/dist/x402/index.d.ts

@@ -0,0 +1,6 @@
+export * as Assets from './Assets.js';
+export * as Header from './Header.js';
+export * as Types from './Types.js';
+export * as assets from './Assets.js';
+export * from './Types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/x402/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,cAAc,YAAY,CAAA"}

package/dist/x402/index.js

@@ -0,0 +1,6 @@
+export * as Assets from './Assets.js';
+export * as Header from './Header.js';
+export * as Types from './Types.js';
+export * as assets from './Assets.js';
+export * from './Types.js';
+//# sourceMappingURL=index.js.map

package/dist/x402/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/x402/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAA;AACnC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,cAAc,YAAY,CAAA"}

package/dist/x402/internal/ChallengeBrand.d.ts

@@ -0,0 +1,5 @@
+/** Marks a synthetic challenge as originating from an x402 `PAYMENT-REQUIRED` response. */
+export declare function mark<const challenge extends object>(challenge: challenge): challenge;
+/** Returns whether a challenge originated from an x402 `PAYMENT-REQUIRED` response. */
+export declare function is(challenge: unknown): boolean;
+//# sourceMappingURL=ChallengeBrand.d.ts.map

package/dist/x402/internal/ChallengeBrand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChallengeBrand.d.ts","sourceRoot":"","sources":["../../../src/x402/internal/ChallengeBrand.ts"],"names":[],"mappings":"AAEA,2FAA2F;AAC3F,wBAAgB,IAAI,CAAC,KAAK,CAAC,SAAS,SAAS,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS,CAKpF;AAED,uFAAuF;AACvF,wBAAgB,EAAE,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAE9C"}

package/dist/x402/internal/ChallengeBrand.js

@@ -0,0 +1,13 @@
+const x402Challenge = Symbol.for('mppx.x402.challenge');
+/** Marks a synthetic challenge as originating from an x402 `PAYMENT-REQUIRED` response. */
+export function mark(challenge) {
+    Object.defineProperty(challenge, x402Challenge, {
+        value: true,
+    });
+    return challenge;
+}
+/** Returns whether a challenge originated from an x402 `PAYMENT-REQUIRED` response. */
+export function is(challenge) {
+    return Boolean(challenge?.[x402Challenge]);
+}
+//# sourceMappingURL=ChallengeBrand.js.map

package/dist/x402/internal/ChallengeBrand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChallengeBrand.js","sourceRoot":"","sources":["../../../src/x402/internal/ChallengeBrand.ts"],"names":[],"mappings":"AAAA,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAA;AAEvD,2FAA2F;AAC3F,MAAM,UAAU,IAAI,CAAiC,SAAoB;IACvE,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,aAAa,EAAE;QAC9C,KAAK,EAAE,IAAI;KACZ,CAAC,CAAA;IACF,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,EAAE,CAAC,SAAkB;IACnC,OAAO,OAAO,CAAE,SAAoD,EAAE,CAAC,aAAa,CAAC,CAAC,CAAA;AACxF,CAAC"}

package/dist/x402/internal/RouteBinding.d.ts

@@ -0,0 +1,8 @@
+import type * as Types from '../Types.js';
+/** Computes the route-bound EIP-3009 nonce for an x402 exact payment. */
+export declare function nonce(parameters: {
+    accepted: Types.PaymentRequirements;
+    extensions: Types.Extensions;
+    resource: Types.ResourceInfo;
+}): `0x${string}`;
+//# sourceMappingURL=RouteBinding.d.ts.map

package/dist/x402/internal/RouteBinding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteBinding.d.ts","sourceRoot":"","sources":["../../../src/x402/internal/RouteBinding.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,KAAK,MAAM,aAAa,CAAA;AAEzC,yEAAyE;AACzE,wBAAgB,KAAK,CAAC,UAAU,EAAE;IAChC,QAAQ,EAAE,KAAK,CAAC,mBAAmB,CAAA;IACnC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAA;IAC5B,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAA;CAC7B,GAAG,KAAK,MAAM,EAAE,CAOhB"}

package/dist/x402/internal/RouteBinding.js

@@ -0,0 +1,12 @@
+import { Bytes, Hash } from 'ox';
+import * as PaymentRequest from '../../PaymentRequest.js';
+/** Computes the route-bound EIP-3009 nonce for an x402 exact payment. */
+export function nonce(parameters) {
+    const input = [
+        PaymentRequest.serialize(parameters.accepted),
+        PaymentRequest.serialize(parameters.resource),
+        PaymentRequest.serialize(parameters.extensions),
+    ].join('|');
+    return Hash.sha256(Bytes.fromString(input), { as: 'Hex' });
+}
+//# sourceMappingURL=RouteBinding.js.map

package/dist/x402/internal/RouteBinding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteBinding.js","sourceRoot":"","sources":["../../../src/x402/internal/RouteBinding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAA;AAEhC,OAAO,KAAK,cAAc,MAAM,yBAAyB,CAAA;AAGzD,yEAAyE;AACzE,MAAM,UAAU,KAAK,CAAC,UAIrB;IACC,MAAM,KAAK,GAAG;QACZ,cAAc,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC;QAC7C,cAAc,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC;QAC7C,cAAc,CAAC,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC;KAChD,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACX,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAkB,CAAA;AAC7E,CAAC"}

package/dist/x402/server/EvmCharge.d.ts

@@ -0,0 +1,50 @@
+import type * as Credential from '../../Credential.js';
+import * as Types from '../../evm/Types.js';
+import * as ServerTransport from '../../server/Transport.js';
+import * as x402_Types from '../Types.js';
+export type Options = {
+    /** Facilitator client or base URL used for x402-compatible settlement. */
+    facilitator?: string | x402_Types.Facilitator | undefined;
+    /** Fetch implementation used for facilitator RPCs. */
+    fetch?: typeof globalThis.fetch | undefined;
+    /** Maximum time in seconds allowed for x402-compatible payment completion. @default 300 */
+    maxTimeoutSeconds?: number | undefined;
+};
+export type ResolvedOptions = {
+    authorization: Types.AuthorizationConfig;
+    facilitator?: x402_Types.Facilitator | undefined;
+    maxTimeoutSeconds: number;
+};
+export type Path = {
+    bindCredential: NonNullable<ServerTransport.Http['bindCredential']>;
+    getCredential: ServerTransport.Http['getCredential'];
+    respondChallenge: (options: Parameters<ServerTransport.Http['respondChallenge']>[0], response?: Response | undefined) => Response | Promise<Response>;
+    respondReceipt: (options: Parameters<ServerTransport.Http['respondReceipt']>[0], response: Response) => Response;
+};
+/** Resolves optional x402 compatibility options for an EVM charge. */
+export declare function resolveOptions(parameters: {
+    authorization: Types.AuthorizationConfig;
+    options?: Options | undefined;
+}): ResolvedOptions;
+/** Creates the x402 wire path for an EVM charge method. */
+export declare function createPath(config: ResolvedOptions): Path;
+/** Settles a verified EVM authorization through an x402 facilitator. */
+export declare function settleWithFacilitator(parameters: ResolvedOptions): SettleWithFacilitator;
+export type SettleWithFacilitator = (parameters: {
+    credential: Credential.Credential<Types.AuthorizationPayload>;
+    payload: Types.AuthorizationPayload;
+    request: Types.ChargeRequest;
+    source: ReturnType<typeof Types.toSource>;
+}) => Promise<{
+    reference: string;
+    timestamp?: string | undefined;
+}>;
+/** Returns whether a credential was converted from an x402 payment payload. */
+export declare function isCredential(credential: Credential.Credential): boolean;
+/** Returns whether a credential was parsed from the x402 payment header. */
+export declare function isPendingCredential(credential: Credential.Credential): boolean;
+/** Converts a native EVM charge request to x402 exact payment requirements. */
+export declare function toPaymentRequirements(request: Types.ChargeRequest, config: Pick<ResolvedOptions, 'authorization' | 'maxTimeoutSeconds'>): x402_Types.PaymentRequirements;
+/** Converts an x402 EIP-3009 payment payload to the native EVM authorization payload. */
+export declare function payloadToAuthorization(paymentPayload: x402_Types.PaymentPayload): Types.AuthorizationPayload;
+//# sourceMappingURL=EvmCharge.d.ts.map

package/dist/x402/server/EvmCharge.d.ts.map

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

package/dist/x402/server/EvmCharge.js

@@ -0,0 +1,301 @@
+import { isDeepStrictEqual } from 'node:util';
+import { Bytes, Hash } from 'ox';
+import { getAddress } from 'viem';
+import * as BodyDigest from '../../BodyDigest.js';
+import * as Challenge from '../../Challenge.js';
+import * as Credential_ from '../../Credential.js';
+import { VerificationFailedError } from '../../Errors.js';
+import * as Types from '../../evm/Types.js';
+import * as PaymentRequest from '../../PaymentRequest.js';
+import * as Scope from '../../server/internal/scope.js';
+import * as x402_Header from '../Header.js';
+import * as x402_RouteBinding from '../internal/RouteBinding.js';
+import * as x402_Types from '../Types.js';
+import * as x402_Facilitator from './Facilitator.js';
+const pendingX402Credential = Symbol('mppx.evm.pendingX402Credential');
+const x402Credential = Symbol('mppx.evm.x402Credential');
+const mppxExtensionKey = 'mppx';
+const mppxRouteBindingSchema = {
+    additionalProperties: false,
+    properties: {
+        [Scope.reservedMetaKey]: { type: 'string' },
+        digest: { type: 'string' },
+        method: { type: 'string' },
+        nonce: { type: 'string' },
+        opaque: { type: 'string' },
+    },
+    required: ['method'],
+    type: 'object',
+};
+/** Resolves optional x402 compatibility options for an EVM charge. */
+export function resolveOptions(parameters) {
+    return {
+        authorization: parameters.authorization,
+        ...(parameters.options?.facilitator
+            ? {
+                facilitator: x402_Facilitator.resolve(parameters.options.facilitator, 'EVM authorization x402 requires `facilitator`.', { fetch: parameters.options.fetch }),
+            }
+            : {}),
+        maxTimeoutSeconds: parameters.options?.maxTimeoutSeconds ?? 300,
+    };
+}
+/** Creates the x402 wire path for an EVM charge method. */
+export function createPath(config) {
+    return {
+        getCredential(request) {
+            const paymentSignature = request.headers.get(x402_Types.paymentSignatureHeader);
+            if (!paymentSignature)
+                return null;
+            const paymentPayload = x402_Header.decodePaymentSignature(paymentSignature);
+            return markPendingCredential(Credential_.from({
+                challenge: pendingChallenge(paymentPayload),
+                payload: paymentPayload,
+            }));
+        },
+        async bindCredential({ challenge, credential, input }) {
+            const paymentPayload = parsePaymentPayload(credential.payload);
+            if (!paymentPayload)
+                return credential;
+            if (!isPendingCredential(credential))
+                return credential;
+            await assertBodyDigest(challenge, input);
+            const request = challenge.request;
+            const paymentRequirements = toPaymentRequirements(request, config);
+            if (!isDeepStrictEqual(paymentPayload.accepted, paymentRequirements))
+                throw new VerificationFailedError({
+                    reason: 'x402 payment payload does not match route requirements',
+                });
+            const expectedResource = { url: input.url };
+            if (!isDeepStrictEqual(paymentPayload.resource, expectedResource))
+                throw new VerificationFailedError({
+                    reason: 'x402 payment payload resource does not match route resource',
+                });
+            const expectedExtensions = routeExtensions(challenge, input);
+            if (!containsExtensions(paymentPayload.extensions, expectedExtensions))
+                throw new VerificationFailedError({
+                    reason: 'x402 payment payload extensions do not match route binding',
+                });
+            const payload = payloadToAuthorization(paymentPayload);
+            const expectedNonce = x402_RouteBinding.nonce({
+                accepted: paymentRequirements,
+                extensions: paymentPayload.extensions,
+                resource: expectedResource,
+            });
+            if (payload.nonce !== expectedNonce)
+                throw new VerificationFailedError({
+                    reason: 'x402 authorization nonce does not match route binding',
+                });
+            return markCredential(Credential_.from({
+                challenge,
+                payload,
+                source: Types.toSource({
+                    address: getAddress(payload.from),
+                    chainId: request.methodDetails.chainId,
+                }),
+            }));
+        },
+        respondChallenge(options, response) {
+            if (!response)
+                throw new Error('x402 path requires a base challenge response.');
+            if (options.input.body !== null && options.challenge.digest === undefined)
+                return response;
+            const headers = new Headers(response.headers);
+            const request = options.challenge.request;
+            headers.set(x402_Types.paymentRequiredHeader, x402_Header.encodePaymentRequired({
+                accepts: [toPaymentRequirements(request, config)],
+                error: options.error?.message ?? `${x402_Types.paymentSignatureHeader} header is required`,
+                extensions: routeExtensions(options.challenge, options.input),
+                resource: { url: options.input.url },
+                x402Version: 2,
+            }));
+            return new Response(response.body, {
+                headers,
+                status: response.status,
+                statusText: response.statusText,
+            });
+        },
+        respondReceipt(options, response) {
+            if (!options.input.headers.has(x402_Types.paymentSignatureHeader))
+                return response;
+            const payload = Types.AuthorizationPayloadSchema.parse(options.credential.payload);
+            const request = options.credential.challenge.request;
+            const headers = new Headers(response.headers);
+            headers.set(x402_Types.paymentResponseHeader, x402_Header.encodePaymentResponse({
+                network: Types.networkOf(request.methodDetails.chainId),
+                payer: payload.from,
+                success: true,
+                transaction: options.receipt.reference,
+            }));
+            return new Response(response.body, {
+                headers,
+                status: response.status,
+                statusText: response.statusText,
+            });
+        },
+    };
+}
+/** Settles a verified EVM authorization through an x402 facilitator. */
+export function settleWithFacilitator(parameters) {
+    const { facilitator, maxTimeoutSeconds } = parameters;
+    if (!facilitator)
+        throw new Error('EVM authorization x402 requires `facilitator`.');
+    return async ({ payload, request }) => {
+        const paymentRequirements = toPaymentRequirements(request, {
+            ...parameters,
+            maxTimeoutSeconds,
+        });
+        const paymentPayload = {
+            accepted: paymentRequirements,
+            payload: {
+                authorization: {
+                    from: payload.from,
+                    nonce: payload.nonce,
+                    to: payload.to,
+                    validAfter: payload.validAfter,
+                    validBefore: payload.validBefore,
+                    value: payload.value,
+                },
+                signature: payload.signature,
+            },
+            x402Version: 2,
+        };
+        const verified = await facilitator.verify(paymentPayload, paymentRequirements);
+        if (!verified.isValid)
+            throw new VerificationFailedError({
+                reason: verified.invalidMessage ?? verified.invalidReason ?? 'EVM facilitator verify failed',
+            });
+        const settled = await facilitator.settle(paymentPayload, paymentRequirements);
+        if (!settled.success)
+            throw new VerificationFailedError({
+                reason: settled.errorMessage ?? settled.errorReason ?? 'EVM facilitator settlement failed',
+            });
+        return {
+            reference: settled.transaction,
+        };
+    };
+}
+/** Returns whether a credential was converted from an x402 payment payload. */
+export function isCredential(credential) {
+    return credential[x402Credential] === true;
+}
+/** Returns whether a credential was parsed from the x402 payment header. */
+export function isPendingCredential(credential) {
+    return credential[pendingX402Credential] === true;
+}
+/** Converts a native EVM charge request to x402 exact payment requirements. */
+export function toPaymentRequirements(request, config) {
+    return {
+        amount: request.amount,
+        asset: request.currency,
+        extra: {
+            assetTransferMethod: Types.eip3009,
+            name: config.authorization.name,
+            version: config.authorization.version,
+        },
+        maxTimeoutSeconds: config.maxTimeoutSeconds,
+        network: Types.networkOf(request.methodDetails.chainId),
+        payTo: request.recipient,
+        scheme: 'exact',
+    };
+}
+function parsePaymentPayload(payload) {
+    const parsed = x402_Types.PaymentPayloadSchema.safeParse(payload);
+    return parsed.success ? parsed.data : undefined;
+}
+/** Converts an x402 EIP-3009 payment payload to the native EVM authorization payload. */
+export function payloadToAuthorization(paymentPayload) {
+    if (!('authorization' in paymentPayload.payload))
+        throw new VerificationFailedError({
+            reason: 'EVM charge only supports x402 EIP-3009 authorization payloads',
+        });
+    return Types.AuthorizationPayloadSchema.parse({
+        ...paymentPayload.payload.authorization,
+        signature: paymentPayload.payload.signature,
+        type: 'authorization',
+    });
+}
+function pendingChallenge(paymentPayload) {
+    // The route challenge is built after request normalization in bindCredential().
+    // Until then, this deterministic local ID only carries the x402 payload through
+    // the standard credential pipeline; it is never HMAC-verified.
+    return Challenge.from({
+        id: pendingChallengeId(paymentPayload),
+        intent: Types.chargeIntent,
+        method: Types.paymentMethod,
+        realm: 'x402',
+        request: paymentPayload.accepted,
+    });
+}
+function pendingChallengeId(paymentPayload) {
+    const hash = Hash.sha256(Bytes.fromString(JSON.stringify(paymentPayload)), { as: 'Hex' });
+    return `${x402_Types.syntheticChallengeIdPrefix}${hash}`;
+}
+function routeExtensions(challenge, input) {
+    const binding = { method: input.method };
+    const scope = Scope.read(challenge.meta);
+    if (scope !== undefined)
+        binding[Scope.reservedMetaKey] = scope;
+    if (challenge.digest !== undefined)
+        binding.digest = challenge.digest;
+    const opaque = challenge.opaque ?? (challenge.meta ? PaymentRequest.serialize(challenge.meta) : undefined);
+    if (opaque !== undefined)
+        binding.opaque = opaque;
+    return {
+        [mppxExtensionKey]: {
+            info: binding,
+            schema: mppxRouteBindingSchema,
+        },
+    };
+}
+function containsExtensions(actual, expected) {
+    if (!actual)
+        return false;
+    return Object.entries(expected).every(([key, expectedExtension]) => {
+        const actualExtension = actual[key];
+        return (actualExtension !== undefined &&
+            isDeepStrictEqual(actualExtension.schema, expectedExtension.schema) &&
+            isDeepStrictEqual(stripClientNonce(actualExtension.info), expectedExtension.info));
+    });
+}
+function stripClientNonce(info) {
+    const { nonce, ...rest } = info;
+    if (nonce !== undefined && typeof nonce !== 'string')
+        return info;
+    return rest;
+}
+async function assertBodyDigest(challenge, input) {
+    if (input.body === null)
+        return;
+    if (challenge.digest === undefined)
+        throw new VerificationFailedError({
+            reason: 'x402 payment requires a body digest for body-bearing requests',
+        });
+    let body;
+    try {
+        body = await input.clone().text();
+    }
+    catch {
+        throw new VerificationFailedError({
+            reason: 'x402 payment cannot bind streaming request body',
+        });
+    }
+    if (!BodyDigest.verify(challenge.digest, body))
+        throw new VerificationFailedError({
+            reason: 'x402 payment body digest mismatch',
+        });
+}
+function markPendingCredential(credential) {
+    Object.defineProperty(credential, pendingX402Credential, {
+        enumerable: true,
+        value: true,
+    });
+    return credential;
+}
+function markCredential(credential) {
+    Object.defineProperty(credential, x402Credential, {
+        enumerable: true,
+        value: true,
+    });
+    return credential;
+}
+//# sourceMappingURL=EvmCharge.js.map

package/dist/x402/server/EvmCharge.js.map

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

package/dist/x402/server/Facilitator.d.ts

@@ -0,0 +1,12 @@
+import * as Types from '../Types.js';
+export type HttpOptions = {
+    /** Fetch implementation used for facilitator RPCs. */
+    fetch?: typeof globalThis.fetch | undefined;
+};
+/** Resolves an x402 facilitator URL or client into a facilitator client. */
+export declare function resolve(facilitator: string | Types.Facilitator, errorMessage?: string, options?: HttpOptions | undefined): Types.Facilitator;
+/** Creates an x402 facilitator client from an HTTP base URL. */
+export declare function http(url: string, options?: HttpOptions | undefined): Types.Facilitator;
+/** Returns the underlying raw fetch implementation when given an mppx wrapper. */
+export declare function unwrapFetch(fetch: typeof globalThis.fetch): typeof globalThis.fetch;
+//# sourceMappingURL=Facilitator.d.ts.map

package/dist/x402/server/Facilitator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Facilitator.d.ts","sourceRoot":"","sources":["../../../src/x402/server/Facilitator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,aAAa,CAAA;AAQpC,MAAM,MAAM,WAAW,GAAG;IACxB,sDAAsD;IACtD,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,GAAG,SAAS,CAAA;CAC5C,CAAA;AAED,4EAA4E;AAC5E,wBAAgB,OAAO,CACrB,WAAW,EAAE,MAAM,GAAG,KAAK,CAAC,WAAW,EACvC,YAAY,SAAuC,EACnD,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,GAChC,KAAK,CAAC,WAAW,CAInB;AAED,gEAAgE;AAChE,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,KAAK,CAAC,WAAW,CAqBtF;AAED,kFAAkF;AAClF,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,GAAG,OAAO,UAAU,CAAC,KAAK,CAMnF"}

package/dist/x402/server/Facilitator.js

@@ -0,0 +1,42 @@
+import * as Types from '../Types.js';
+const mppxFetchWrapper = Symbol.for('mppx.fetch.wrapper');
+/** Resolves an x402 facilitator URL or client into a facilitator client. */
+export function resolve(facilitator, errorMessage = 'x402 exact requires `facilitator`.', options) {
+    if (typeof facilitator === 'object' && facilitator !== null)
+        return facilitator;
+    if (typeof facilitator === 'string')
+        return http(facilitator, options);
+    throw new Error(errorMessage);
+}
+/** Creates an x402 facilitator client from an HTTP base URL. */
+export function http(url, options) {
+    const base = url.replace(/\/$/, '');
+    const fetch = unwrapFetch(options?.fetch ?? globalThis.fetch);
+    return {
+        async verify(paymentPayload, paymentRequirements) {
+            const response = await fetch(`${base}/verify`, {
+                body: JSON.stringify({ paymentPayload, paymentRequirements, x402Version: 2 }),
+                headers: { 'Content-Type': 'application/json' },
+                method: 'POST',
+            });
+            return Types.VerifyResponseSchema.parse(await response.json());
+        },
+        async settle(paymentPayload, paymentRequirements) {
+            const response = await fetch(`${base}/settle`, {
+                body: JSON.stringify({ paymentPayload, paymentRequirements, x402Version: 2 }),
+                headers: { 'Content-Type': 'application/json' },
+                method: 'POST',
+            });
+            return Types.SettleResponseSchema.parse(await response.json());
+        },
+    };
+}
+/** Returns the underlying raw fetch implementation when given an mppx wrapper. */
+export function unwrapFetch(fetch) {
+    let current = fetch;
+    while (current[mppxFetchWrapper]) {
+        current = current[mppxFetchWrapper];
+    }
+    return current;
+}
+//# sourceMappingURL=Facilitator.js.map

package/dist/x402/server/Facilitator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Facilitator.js","sourceRoot":"","sources":["../../../src/x402/server/Facilitator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,aAAa,CAAA;AAEpC,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAA;AAWzD,4EAA4E;AAC5E,MAAM,UAAU,OAAO,CACrB,WAAuC,EACvC,YAAY,GAAG,oCAAoC,EACnD,OAAiC;IAEjC,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,KAAK,IAAI;QAAE,OAAO,WAAW,CAAA;IAC/E,IAAI,OAAO,WAAW,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;IACtE,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAA;AAC/B,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,IAAI,CAAC,GAAW,EAAE,OAAiC;IACjE,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IACnC,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,EAAE,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,CAAA;IAC7D,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,cAAc,EAAE,mBAAmB;YAC9C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,SAAS,EAAE;gBAC7C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,cAAc,EAAE,mBAAmB,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;gBAC7E,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,MAAM,EAAE,MAAM;aACf,CAAC,CAAA;YACF,OAAO,KAAK,CAAC,oBAAoB,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;QAChE,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,cAAc,EAAE,mBAAmB;YAC9C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,SAAS,EAAE;gBAC7C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,cAAc,EAAE,mBAAmB,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;gBAC7E,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,MAAM,EAAE,MAAM;aACf,CAAC,CAAA;YACF,OAAO,KAAK,CAAC,oBAAoB,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;QAChE,CAAC;KACF,CAAA;AACH,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,WAAW,CAAC,KAA8B;IACxD,IAAI,OAAO,GAAG,KAAqB,CAAA;IACnC,OAAO,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACjC,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAiB,CAAA;IACrD,CAAC;IACD,OAAO,OAAkC,CAAA;AAC3C,CAAC"}