mppx 0.6.28 → 0.6.29

package/dist/x402/Header.js

@@ -0,0 +1,18 @@
+import * as HeaderCodec from '../internal/HeaderCodec.js';
+import { PaymentPayloadSchema, PaymentRequiredSchema, SettleResponseSchema, } from './Types.js';
+const paymentRequired = HeaderCodec.createJson(PaymentRequiredSchema);
+const paymentSignature = HeaderCodec.createJson(PaymentPayloadSchema);
+const paymentResponse = HeaderCodec.createJson(SettleResponseSchema);
+/** Encodes an x402 payment-required object for the `PAYMENT-REQUIRED` header. */
+export const encodePaymentRequired = paymentRequired.encode;
+/** Decodes an x402 `PAYMENT-REQUIRED` header value. */
+export const decodePaymentRequired = paymentRequired.decode;
+/** Encodes an x402 payment payload for the `PAYMENT-SIGNATURE` header. */
+export const encodePaymentSignature = paymentSignature.encode;
+/** Decodes an x402 `PAYMENT-SIGNATURE` header value. */
+export const decodePaymentSignature = paymentSignature.decode;
+/** Encodes an x402 settlement response for the `PAYMENT-RESPONSE` header. */
+export const encodePaymentResponse = paymentResponse.encode;
+/** Decodes an x402 `PAYMENT-RESPONSE` header value. */
+export const decodePaymentResponse = paymentResponse.decode;
+//# sourceMappingURL=Header.js.map

package/dist/x402/Header.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Header.js","sourceRoot":"","sources":["../../src/x402/Header.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,4BAA4B,CAAA;AACzD,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,GAIrB,MAAM,YAAY,CAAA;AAEnB,MAAM,eAAe,GAAG,WAAW,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAA;AACrE,MAAM,gBAAgB,GAAG,WAAW,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAA;AACrE,MAAM,eAAe,GAAG,WAAW,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAA;AAEpE,iFAAiF;AACjF,MAAM,CAAC,MAAM,qBAAqB,GAChC,eAAe,CAAC,MAAM,CAAA;AAExB,uDAAuD;AACvD,MAAM,CAAC,MAAM,qBAAqB,GAAuC,eAAe,CAAC,MAAM,CAAA;AAE/F,0EAA0E;AAC1E,MAAM,CAAC,MAAM,sBAAsB,GACjC,gBAAgB,CAAC,MAAM,CAAA;AAEzB,wDAAwD;AACxD,MAAM,CAAC,MAAM,sBAAsB,GAAsC,gBAAgB,CAAC,MAAM,CAAA;AAEhG,6EAA6E;AAC7E,MAAM,CAAC,MAAM,qBAAqB,GAChC,eAAe,CAAC,MAAM,CAAA;AAExB,uDAAuD;AACvD,MAAM,CAAC,MAAM,qBAAqB,GAAsC,eAAe,CAAC,MAAM,CAAA"}

package/dist/x402/Types.d.ts

@@ -0,0 +1,289 @@
+import * as z from '../zod.js';
+export declare const versions: readonly [2];
+/** mppx method name used for EVM charge challenges backed by x402. */
+export declare const paymentMethod: "evm";
+/** mppx intent name used for EVM charge challenges backed by x402 exact. */
+export declare const exactIntent: "charge";
+export declare const schemes: readonly ["exact"];
+export declare const assetTransferMethods: readonly ["eip3009", "permit2"];
+/** CAIP-2 namespace prefix for EVM networks. */
+export declare const evmNetworkPrefix: "eip155:";
+/** Prefix for synthetic mppx challenge IDs derived from x402 `accepts` entries. */
+export declare const syntheticChallengeIdPrefix: "x402:";
+/** x402 protocol version supported by this package. */
+export type Version = 2;
+/** mppx payment method name used for EVM charge challenges backed by x402. */
+export type PaymentMethod = typeof paymentMethod;
+/** mppx intent name used for EVM charge challenges backed by x402 exact. */
+export type ExactIntent = typeof exactIntent;
+/** x402 scheme supported by this package. */
+export type Scheme = (typeof schemes)[number];
+/** x402 exact EVM asset transfer method. */
+export type AssetTransferMethod = (typeof assetTransferMethods)[number];
+/** CAIP-2 EVM network identifier. */
+export type EvmNetwork = `${typeof evmNetworkPrefix}${number}`;
+/** HTTP header carrying a base64-encoded x402 payment-required response. */
+export declare const paymentRequiredHeader = "PAYMENT-REQUIRED";
+/** HTTP header carrying a base64-encoded x402 payment payload. */
+export declare const paymentSignatureHeader = "PAYMENT-SIGNATURE";
+/** HTTP header carrying a base64-encoded x402 settlement response. */
+export declare const paymentResponseHeader = "PAYMENT-RESPONSE";
+/** Describes the protected resource in x402 v2 payment-required responses. */
+export declare const ResourceInfoSchema: z.ZodMiniObject<{
+    description: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    iconUrl: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    mimeType: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    serviceName: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    tags: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+    url: z.ZodMiniString<string>;
+}, z.core.$strip>;
+/** Describes the protected resource in x402 v2 payment-required responses. */
+export type ResourceInfo = z.infer<typeof ResourceInfoSchema>;
+/** Public transfer configuration for exact EVM payments. */
+export declare const ExactTransferSchema: z.ZodMiniDiscriminatedUnion<[z.ZodMiniObject<{
+    name: z.ZodMiniString<string>;
+    type: z.ZodMiniLiteral<"eip3009">;
+    version: z.ZodMiniString<string>;
+}, z.core.$strip>, z.ZodMiniObject<{
+    name: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    type: z.ZodMiniLiteral<"permit2">;
+    version: z.ZodMiniOptional<z.ZodMiniString<string>>;
+}, z.core.$strip>], "type">;
+/** Public EIP-3009 transfer configuration for exact EVM payments. */
+export type ExactEip3009Transfer = Extract<z.infer<typeof ExactTransferSchema>, {
+    type: 'eip3009';
+}>;
+/** Public Permit2 transfer configuration for exact EVM payments. */
+export type ExactPermit2Transfer = Extract<z.infer<typeof ExactTransferSchema>, {
+    type: 'permit2';
+}>;
+/** Public transfer configuration for exact EVM payments. */
+export type ExactTransfer = z.infer<typeof ExactTransferSchema>;
+/** Known asset metadata used to derive x402 wire `extra` fields. */
+export type Asset = {
+    address: `0x${string}`;
+    decimals: number;
+    transfer: ExactTransfer;
+};
+/** x402 v2 payment requirements for the `exact` scheme. */
+export declare const PaymentRequirementsSchema: z.ZodMiniObject<{
+    amount: z.ZodMiniString<string>;
+    asset: z.ZodMiniString<string>;
+    extra: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>>;
+    maxTimeoutSeconds: z.ZodMiniNumber<number>;
+    network: z.ZodMiniType<`eip155:${number}`, unknown, z.core.$ZodTypeInternals<`eip155:${number}`, unknown>>;
+    payTo: z.ZodMiniString<string>;
+    scheme: z.ZodMiniEnum<{
+        exact: "exact";
+    }>;
+}, z.core.$strip>;
+/** x402 v2 payment requirements for the `exact` scheme. */
+export type PaymentRequirements = z.infer<typeof PaymentRequirementsSchema>;
+/** x402 v2 protocol extension value. */
+export declare const ExtensionSchema: z.ZodMiniObject<{
+    info: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>;
+    schema: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>;
+}, z.core.$strip>;
+/** x402 v2 protocol extension value. */
+export type Extension = z.infer<typeof ExtensionSchema>;
+/** x402 v2 protocol extensions map. */
+export declare const ExtensionsSchema: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniObject<{
+    info: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>;
+    schema: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>;
+}, z.core.$strip>>;
+/** x402 v2 protocol extensions map. */
+export type Extensions = z.infer<typeof ExtensionsSchema>;
+/** Public exact EVM route request accepted by `mppx` handlers. */
+export type ExactRequest = PaymentRequirements & {
+    extensions?: Extensions | undefined;
+    resource?: ResourceInfo | undefined;
+};
+/** x402 v2 payment-required response. */
+export declare const PaymentRequiredSchema: z.ZodMiniObject<{
+    accepts: z.ZodMiniArray<z.ZodMiniObject<{
+        amount: z.ZodMiniString<string>;
+        asset: z.ZodMiniString<string>;
+        extra: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>>;
+        maxTimeoutSeconds: z.ZodMiniNumber<number>;
+        network: z.ZodMiniType<`eip155:${number}`, unknown, z.core.$ZodTypeInternals<`eip155:${number}`, unknown>>;
+        payTo: z.ZodMiniString<string>;
+        scheme: z.ZodMiniEnum<{
+            exact: "exact";
+        }>;
+    }, z.core.$strip>>;
+    error: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    extensions: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniObject<{
+        info: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>;
+        schema: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>;
+    }, z.core.$strip>>>;
+    resource: z.ZodMiniObject<{
+        description: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        iconUrl: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        mimeType: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        serviceName: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        tags: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+        url: z.ZodMiniString<string>;
+    }, z.core.$strip>;
+    x402Version: z.ZodMiniLiteral<2>;
+}, z.core.$strip>;
+/** x402 v2 payment-required response. */
+export type PaymentRequired = z.infer<typeof PaymentRequiredSchema>;
+/** EIP-3009 transferWithAuthorization payload for exact EVM payments. */
+export declare const ExactEip3009PayloadSchema: z.ZodMiniObject<{
+    authorization: z.ZodMiniObject<{
+        from: z.ZodMiniString<string>;
+        nonce: z.ZodMiniString<string>;
+        to: z.ZodMiniString<string>;
+        validAfter: z.ZodMiniString<string>;
+        validBefore: z.ZodMiniString<string>;
+        value: z.ZodMiniString<string>;
+    }, z.core.$strip>;
+    signature: z.ZodMiniString<string>;
+}, z.core.$strip>;
+/** EIP-3009 transferWithAuthorization payload for exact EVM payments. */
+export type ExactEip3009Payload = z.infer<typeof ExactEip3009PayloadSchema>;
+/** Permit2 payload for exact EVM payments. */
+export declare const ExactPermit2PayloadSchema: z.ZodMiniObject<{
+    permit2Authorization: z.ZodMiniObject<{
+        deadline: z.ZodMiniString<string>;
+        from: z.ZodMiniString<string>;
+        nonce: z.ZodMiniString<string>;
+        permitted: z.ZodMiniObject<{
+            amount: z.ZodMiniString<string>;
+            token: z.ZodMiniString<string>;
+        }, z.core.$strip>;
+        spender: z.ZodMiniString<string>;
+        witness: z.ZodMiniObject<{
+            to: z.ZodMiniString<string>;
+            validAfter: z.ZodMiniString<string>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    signature: z.ZodMiniString<string>;
+}, z.core.$strip>;
+/** Permit2 payload for exact EVM payments. */
+export type ExactPermit2Payload = z.infer<typeof ExactPermit2PayloadSchema>;
+/** Exact EVM payment payload body. */
+export declare const ExactPayloadSchema: z.ZodMiniUnion<readonly [z.ZodMiniObject<{
+    authorization: z.ZodMiniObject<{
+        from: z.ZodMiniString<string>;
+        nonce: z.ZodMiniString<string>;
+        to: z.ZodMiniString<string>;
+        validAfter: z.ZodMiniString<string>;
+        validBefore: z.ZodMiniString<string>;
+        value: z.ZodMiniString<string>;
+    }, z.core.$strip>;
+    signature: z.ZodMiniString<string>;
+}, z.core.$strip>, z.ZodMiniObject<{
+    permit2Authorization: z.ZodMiniObject<{
+        deadline: z.ZodMiniString<string>;
+        from: z.ZodMiniString<string>;
+        nonce: z.ZodMiniString<string>;
+        permitted: z.ZodMiniObject<{
+            amount: z.ZodMiniString<string>;
+            token: z.ZodMiniString<string>;
+        }, z.core.$strip>;
+        spender: z.ZodMiniString<string>;
+        witness: z.ZodMiniObject<{
+            to: z.ZodMiniString<string>;
+            validAfter: z.ZodMiniString<string>;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    signature: z.ZodMiniString<string>;
+}, z.core.$strip>]>;
+/** Exact EVM payment payload body. */
+export type ExactPayload = z.infer<typeof ExactPayloadSchema>;
+/** x402 v2 payment payload. */
+export declare const PaymentPayloadSchema: z.ZodMiniObject<{
+    accepted: z.ZodMiniObject<{
+        amount: z.ZodMiniString<string>;
+        asset: z.ZodMiniString<string>;
+        extra: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>>;
+        maxTimeoutSeconds: z.ZodMiniNumber<number>;
+        network: z.ZodMiniType<`eip155:${number}`, unknown, z.core.$ZodTypeInternals<`eip155:${number}`, unknown>>;
+        payTo: z.ZodMiniString<string>;
+        scheme: z.ZodMiniEnum<{
+            exact: "exact";
+        }>;
+    }, z.core.$strip>;
+    extensions: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniObject<{
+        info: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>;
+        schema: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>;
+    }, z.core.$strip>>>;
+    payload: z.ZodMiniUnion<readonly [z.ZodMiniObject<{
+        authorization: z.ZodMiniObject<{
+            from: z.ZodMiniString<string>;
+            nonce: z.ZodMiniString<string>;
+            to: z.ZodMiniString<string>;
+            validAfter: z.ZodMiniString<string>;
+            validBefore: z.ZodMiniString<string>;
+            value: z.ZodMiniString<string>;
+        }, z.core.$strip>;
+        signature: z.ZodMiniString<string>;
+    }, z.core.$strip>, z.ZodMiniObject<{
+        permit2Authorization: z.ZodMiniObject<{
+            deadline: z.ZodMiniString<string>;
+            from: z.ZodMiniString<string>;
+            nonce: z.ZodMiniString<string>;
+            permitted: z.ZodMiniObject<{
+                amount: z.ZodMiniString<string>;
+                token: z.ZodMiniString<string>;
+            }, z.core.$strip>;
+            spender: z.ZodMiniString<string>;
+            witness: z.ZodMiniObject<{
+                to: z.ZodMiniString<string>;
+                validAfter: z.ZodMiniString<string>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        signature: z.ZodMiniString<string>;
+    }, z.core.$strip>]>;
+    resource: z.ZodMiniOptional<z.ZodMiniObject<{
+        description: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        iconUrl: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        mimeType: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        serviceName: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        tags: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+        url: z.ZodMiniString<string>;
+    }, z.core.$strip>>;
+    x402Version: z.ZodMiniLiteral<2>;
+}, z.core.$strip>;
+/** x402 v2 payment payload. */
+export type PaymentPayload = z.infer<typeof PaymentPayloadSchema>;
+/** Facilitator verification response. */
+export declare const VerifyResponseSchema: z.ZodMiniObject<{
+    extensions: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniObject<{
+        info: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>;
+        schema: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>;
+    }, z.core.$strip>>>;
+    extra: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>>;
+    invalidMessage: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    invalidReason: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    isValid: z.ZodMiniBoolean<boolean>;
+    payer: z.ZodMiniOptional<z.ZodMiniString<string>>;
+}, z.core.$strip>;
+/** Facilitator verification response. */
+export type VerifyResponse = z.infer<typeof VerifyResponseSchema>;
+/** Facilitator settlement response and x402 `PAYMENT-RESPONSE` body. */
+export declare const SettleResponseSchema: z.ZodMiniObject<{
+    amount: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    errorMessage: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    errorReason: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    extensions: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniObject<{
+        info: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>;
+        schema: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>;
+    }, z.core.$strip>>>;
+    extra: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>>;
+    network: z.ZodMiniString<string>;
+    payer: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    success: z.ZodMiniBoolean<boolean>;
+    transaction: z.ZodMiniString<string>;
+}, z.core.$strip>;
+/** Facilitator settlement response and x402 `PAYMENT-RESPONSE` body. */
+export type SettleResponse = z.infer<typeof SettleResponseSchema>;
+/** x402 facilitator client interface used by server exact config. */
+export type Facilitator = {
+    settle: (paymentPayload: PaymentPayload, paymentRequirements: PaymentRequirements) => Promise<SettleResponse>;
+    verify: (paymentPayload: PaymentPayload, paymentRequirements: PaymentRequirements) => Promise<VerifyResponse>;
+};
+/** Extracts x402 `PaymentRequirements` from a canonical exact request. */
+export declare function toPaymentRequirements(request: ExactRequest): PaymentRequirements;
+//# sourceMappingURL=Types.d.ts.map

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

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

package/dist/x402/Types.js

@@ -0,0 +1,139 @@
+import * as z from '../zod.js';
+export const versions = [2];
+/** mppx method name used for EVM charge challenges backed by x402. */
+export const paymentMethod = 'evm';
+/** mppx intent name used for EVM charge challenges backed by x402 exact. */
+export const exactIntent = 'charge';
+export const schemes = ['exact'];
+export const assetTransferMethods = ['eip3009', 'permit2'];
+/** CAIP-2 namespace prefix for EVM networks. */
+export const evmNetworkPrefix = 'eip155:';
+/** Prefix for synthetic mppx challenge IDs derived from x402 `accepts` entries. */
+export const syntheticChallengeIdPrefix = 'x402:';
+/** HTTP header carrying a base64-encoded x402 payment-required response. */
+export const paymentRequiredHeader = 'PAYMENT-REQUIRED';
+/** HTTP header carrying a base64-encoded x402 payment payload. */
+export const paymentSignatureHeader = 'PAYMENT-SIGNATURE';
+/** HTTP header carrying a base64-encoded x402 settlement response. */
+export const paymentResponseHeader = 'PAYMENT-RESPONSE';
+const nonEmptyString = z.string().check(z.minLength(1));
+const positiveNumber = z.number().check(z.refine((value) => value > 0, 'Must be positive'));
+const atomicAmount = z.string().check(z.regex(/^\d+$/, 'Invalid atomic amount'));
+const address = z.address();
+const evmNetwork = z
+    .string()
+    .check(z.regex(new RegExp(`^${evmNetworkPrefix}\\d+$`), 'Invalid EVM CAIP-2 network'));
+/** Describes the protected resource in x402 v2 payment-required responses. */
+export const ResourceInfoSchema = z.object({
+    description: z.optional(z.string()),
+    iconUrl: z.optional(z.string()),
+    mimeType: z.optional(z.string()),
+    serviceName: z.optional(z.string()),
+    tags: z.optional(z.array(z.string())),
+    url: nonEmptyString,
+});
+/** Public transfer configuration for exact EVM payments. */
+export const ExactTransferSchema = z.discriminatedUnion('type', [
+    z.object({
+        name: nonEmptyString,
+        type: z.literal('eip3009'),
+        version: nonEmptyString,
+    }),
+    z.object({
+        name: z.optional(z.string()),
+        type: z.literal('permit2'),
+        version: z.optional(z.string()),
+    }),
+]);
+/** x402 v2 payment requirements for the `exact` scheme. */
+export const PaymentRequirementsSchema = z.object({
+    amount: atomicAmount,
+    asset: nonEmptyString,
+    extra: z.optional(z.record(z.string(), z.unknown())),
+    maxTimeoutSeconds: positiveNumber,
+    network: evmNetwork,
+    payTo: nonEmptyString,
+    scheme: z.enum(schemes),
+});
+/** x402 v2 protocol extension value. */
+export const ExtensionSchema = z.object({
+    info: z.record(z.string(), z.unknown()),
+    schema: z.record(z.string(), z.unknown()),
+});
+/** x402 v2 protocol extensions map. */
+export const ExtensionsSchema = z.record(z.string(), ExtensionSchema);
+/** x402 v2 payment-required response. */
+export const PaymentRequiredSchema = z.object({
+    accepts: z.array(PaymentRequirementsSchema).check(z.minLength(1)),
+    error: z.optional(z.string()),
+    extensions: z.optional(ExtensionsSchema),
+    resource: ResourceInfoSchema,
+    x402Version: z.literal(2),
+});
+/** EIP-3009 transferWithAuthorization payload for exact EVM payments. */
+export const ExactEip3009PayloadSchema = z.object({
+    authorization: z.object({
+        from: address,
+        nonce: z.hash(),
+        to: address,
+        validAfter: atomicAmount,
+        validBefore: atomicAmount,
+        value: atomicAmount,
+    }),
+    signature: z.signature(),
+});
+/** Permit2 payload for exact EVM payments. */
+export const ExactPermit2PayloadSchema = z.object({
+    permit2Authorization: z.object({
+        deadline: atomicAmount,
+        from: address,
+        nonce: atomicAmount,
+        permitted: z.object({
+            amount: atomicAmount,
+            token: address,
+        }),
+        spender: address,
+        witness: z.object({
+            to: address,
+            validAfter: atomicAmount,
+        }),
+    }),
+    signature: z.signature(),
+});
+/** Exact EVM payment payload body. */
+export const ExactPayloadSchema = z.union([ExactEip3009PayloadSchema, ExactPermit2PayloadSchema]);
+/** x402 v2 payment payload. */
+export const PaymentPayloadSchema = z.object({
+    accepted: PaymentRequirementsSchema,
+    extensions: z.optional(ExtensionsSchema),
+    payload: ExactPayloadSchema,
+    resource: z.optional(ResourceInfoSchema),
+    x402Version: z.literal(2),
+});
+/** Facilitator verification response. */
+export const VerifyResponseSchema = z.object({
+    extensions: z.optional(ExtensionsSchema),
+    extra: z.optional(z.record(z.string(), z.unknown())),
+    invalidMessage: z.optional(z.string()),
+    invalidReason: z.optional(z.string()),
+    isValid: z.boolean(),
+    payer: z.optional(z.string()),
+});
+/** Facilitator settlement response and x402 `PAYMENT-RESPONSE` body. */
+export const SettleResponseSchema = z.object({
+    amount: z.optional(atomicAmount),
+    errorMessage: z.optional(z.string()),
+    errorReason: z.optional(z.string()),
+    extensions: z.optional(ExtensionsSchema),
+    extra: z.optional(z.record(z.string(), z.unknown())),
+    network: nonEmptyString,
+    payer: z.optional(z.string()),
+    success: z.boolean(),
+    transaction: z.string(),
+});
+/** Extracts x402 `PaymentRequirements` from a canonical exact request. */
+export function toPaymentRequirements(request) {
+    const { extensions: _extensions, resource: _resource, ...paymentRequirements } = request;
+    return PaymentRequirementsSchema.parse(paymentRequirements);
+}
+//# sourceMappingURL=Types.js.map

package/dist/x402/Types.js.map

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

package/dist/x402/client/Exact.d.ts

@@ -0,0 +1,38 @@
+import type { Account } from 'viem';
+import type * as Challenge from '../../Challenge.js';
+import * as Assets from '../Assets.js';
+import * as Types from '../Types.js';
+/**
+ * Creates an x402 exact `PAYMENT-SIGNATURE` credential.
+ */
+export declare function createCredential(parameters: createCredential.Parameters): Promise<string>;
+export declare namespace createCredential {
+    type Parameters = {
+        challenge: Challenge.Challenge<Types.ExactRequest>;
+        config: Config;
+        context?: Context | undefined;
+    };
+}
+export type Context = {
+    account?: Account | undefined;
+};
+export type Signer = Account & {
+    signTypedData?: (parameters: any) => Promise<`0x${string}`>;
+};
+export type Config = {
+    /** Account used to sign exact EVM payment payloads. */
+    account: Account;
+    /** Optional token decimals used to parse `maxAmount` when currency metadata is not provided. */
+    decimals?: number | undefined;
+    /** Optional maximum display-unit amount the client is willing to pay. */
+    maxAmount?: string | undefined;
+    /** Optional maximum atomic amount the client is willing to pay. */
+    maxAtomicAmount?: string | undefined;
+    /** Optional allowlist of supported EVM chain IDs. */
+    networks?: readonly number[] | undefined;
+    /** Optional allowlist of supported currencies. */
+    currencies?: readonly (`0x${string}` | Assets.KnownAsset)[] | undefined;
+    /** Legacy alias for `currencies`. */
+    assets?: readonly (`0x${string}` | Assets.KnownAsset)[] | undefined;
+};
+//# sourceMappingURL=Exact.d.ts.map

package/dist/x402/client/Exact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Exact.d.ts","sourceRoot":"","sources":["../../../src/x402/client/Exact.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAGnC,OAAO,KAAK,KAAK,SAAS,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,MAAM,MAAM,cAAc,CAAA;AAGtC,OAAO,KAAK,KAAK,MAAM,aAAa,CAAA;AAEpC;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,gBAAgB,CAAC,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CA2D/F;AAED,MAAM,CAAC,OAAO,WAAW,gBAAgB,CAAC;IACxC,KAAK,UAAU,GAAG;QAChB,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;QAClD,MAAM,EAAE,MAAM,CAAA;QACd,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;KAC9B,CAAA;CACF;AAED,MAAM,MAAM,OAAO,GAAG;IACpB,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAC9B,CAAA;AAED,MAAM,MAAM,MAAM,GAAG,OAAO,GAAG;IAC7B,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,GAAG,KAAK,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC,CAAA;CAC5D,CAAA;AAED,MAAM,MAAM,MAAM,GAAG;IACnB,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAA;IAChB,gGAAgG;IAChG,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,qDAAqD;IACrD,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IACxC,kDAAkD;IAClD,UAAU,CAAC,EAAE,SAAS,CAAC,KAAK,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,EAAE,GAAG,SAAS,CAAA;IACvE,qCAAqC;IACrC,MAAM,CAAC,EAAE,SAAS,CAAC,KAAK,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,EAAE,GAAG,SAAS,CAAA;CACpE,CAAA"}

package/dist/x402/client/Exact.js

@@ -0,0 +1,141 @@
+import { getAddress, parseUnits } from 'viem';
+import * as Assets from '../Assets.js';
+import * as Header from '../Header.js';
+import * as RouteBinding from '../internal/RouteBinding.js';
+import * as Types from '../Types.js';
+/**
+ * Creates an x402 exact `PAYMENT-SIGNATURE` credential.
+ */
+export async function createCredential(parameters) {
+    const account = (parameters.context?.account ?? parameters.config.account);
+    if (!account.signTypedData)
+        throw new Error('x402 exact requires a typed-data signer.');
+    const request = parameters.challenge.request;
+    const accepted = Types.toPaymentRequirements(request);
+    assertPolicy(parameters.config, accepted);
+    if (!request.resource || !request.extensions?.mppx)
+        throw new Error('x402 exact EIP-3009 requires route binding.');
+    const extensions = withNonceSalt(request.extensions);
+    const transferMethod = accepted.extra?.assetTransferMethod ?? 'eip3009';
+    if (transferMethod !== 'eip3009')
+        throw new Error(`x402 exact ${String(transferMethod)} signing is not implemented yet.`);
+    const name = accepted.extra?.name;
+    const version = accepted.extra?.version;
+    if (typeof name !== 'string' || typeof version !== 'string')
+        throw new Error('x402 exact EIP-3009 requires token name and version.');
+    const now = Math.floor(Date.now() / 1000);
+    const authorization = {
+        from: getAddress(account.address),
+        nonce: RouteBinding.nonce({
+            accepted,
+            extensions,
+            resource: request.resource,
+        }),
+        to: getAddress(accepted.payTo),
+        validAfter: (now - 600).toString(),
+        validBefore: (now + accepted.maxTimeoutSeconds).toString(),
+        value: accepted.amount,
+    };
+    const signature = await account.signTypedData({
+        domain: {
+            chainId: chainIdOf(accepted.network),
+            name,
+            verifyingContract: getAddress(accepted.asset),
+            version,
+        },
+        message: {
+            ...authorization,
+            value: BigInt(authorization.value),
+            validAfter: BigInt(authorization.validAfter),
+            validBefore: BigInt(authorization.validBefore),
+        },
+        primaryType: 'TransferWithAuthorization',
+        types: authorizationTypes,
+    });
+    return Header.encodePaymentSignature({
+        accepted,
+        extensions,
+        payload: {
+            authorization,
+            signature,
+        },
+        ...(request.resource ? { resource: request.resource } : {}),
+        x402Version: 2,
+    });
+}
+const authorizationTypes = {
+    TransferWithAuthorization: [
+        { name: 'from', type: 'address' },
+        { name: 'to', type: 'address' },
+        { name: 'value', type: 'uint256' },
+        { name: 'validAfter', type: 'uint256' },
+        { name: 'validBefore', type: 'uint256' },
+        { name: 'nonce', type: 'bytes32' },
+    ],
+};
+function chainIdOf(network) {
+    return Number(network.slice(Types.evmNetworkPrefix.length));
+}
+function assertPolicy(parameters, accepted) {
+    const chainId = chainIdOf(accepted.network);
+    if (parameters.networks && !parameters.networks.includes(chainId))
+        throw new Error(`x402 exact chain ID is not allowed: ${chainId}.`);
+    const currencies = parameters.currencies ?? parameters.assets;
+    if (currencies?.some((currency) => !Assets.isAsset(currency)) && !parameters.networks?.length)
+        throw new Error('x402 exact raw currency allowlists require networks.');
+    if (currencies) {
+        const acceptedCurrency = getAddress(accepted.asset);
+        const allowed = currencies.some((currency) => currencyMatches(currency, acceptedCurrency, accepted.network));
+        if (!allowed)
+            throw new Error(`x402 exact currency is not allowed: ${acceptedCurrency}.`);
+    }
+    if (parameters.maxAtomicAmount !== undefined &&
+        BigInt(accepted.amount) > BigInt(parameters.maxAtomicAmount))
+        throw new Error('x402 exact amount exceeds maxAtomicAmount.');
+    if (parameters.maxAmount !== undefined) {
+        const decimals = decimalsOfAcceptedCurrency(parameters, accepted);
+        if (decimals === undefined)
+            throw new Error('x402 exact maxAmount requires currency decimals.');
+        if (BigInt(accepted.amount) > parseUnits(parameters.maxAmount, decimals))
+            throw new Error('x402 exact amount exceeds maxAmount.');
+    }
+}
+function addressOf(currency) {
+    return Assets.isAsset(currency) ? currency.address : currency;
+}
+function currencyMatches(currency, acceptedCurrency, network) {
+    if (getAddress(addressOf(currency)) !== acceptedCurrency)
+        return false;
+    return !Assets.isAsset(currency) || currency.network === network;
+}
+function decimalsOfAcceptedCurrency(parameters, accepted) {
+    const currencies = parameters.currencies ?? parameters.assets;
+    const acceptedCurrency = getAddress(accepted.asset);
+    const currency = currencies?.find((currency) => currencyMatches(currency, acceptedCurrency, accepted.network));
+    if (currency && Assets.isAsset(currency))
+        return currency.decimals;
+    return parameters.decimals;
+}
+function withNonceSalt(extensions) {
+    const mppx = extensions.mppx;
+    if (!mppx)
+        return extensions;
+    return {
+        ...extensions,
+        mppx: {
+            ...mppx,
+            info: {
+                ...mppx.info,
+                nonce: randomNonceSalt(),
+            },
+        },
+    };
+}
+function randomNonceSalt() {
+    const crypto = globalThis.crypto;
+    if (!crypto?.getRandomValues)
+        throw new Error('x402 exact requires crypto randomness.');
+    const bytes = crypto.getRandomValues(new Uint8Array(32));
+    return Array.from(bytes, (byte) => byte.toString(16).padStart(2, '0')).join('');
+}
+//# sourceMappingURL=Exact.js.map