@faremeter/types 0.16.0 → 0.17.0

package/dist/src/x402.d.ts

@@ -1,3 +1,11 @@
+/**
+ * HTTP header name for v1 client payment payloads.
+ */
+export declare const X_PAYMENT_HEADER = "X-PAYMENT";
+/**
+ * HTTP header name for v1 server payment responses.
+ */
+export declare const X_PAYMENT_RESPONSE_HEADER = "X-PAYMENT-RESPONSE";
 export declare const x402PaymentId: import("arktype/internal/methods/object.ts").ObjectType<{
     scheme: string;
     network: string;
@@ -10,10 +18,10 @@ export declare const x402PaymentRequirements: import("arktype/internal/methods/o
     maxAmountRequired: string;
     resource: string;
     description: string;
-    mimeType: string;
     payTo: string;
     maxTimeoutSeconds: number;
     asset: string;
+    mimeType?: string;
     outputSchema?: object;
     extra?: object;
 }, {}>;
@@ -26,16 +34,44 @@ export declare const x402PaymentRequiredResponse: import("arktype/internal/metho
         maxAmountRequired: string;
         resource: string;
         description: string;
-        mimeType: string;
         payTo: string;
         maxTimeoutSeconds: number;
         asset: string;
+        mimeType?: string;
         outputSchema?: object;
         extra?: object;
     }[];
-    error?: string;
+    error: string;
 }, {}>;
 export type x402PaymentRequiredResponse = typeof x402PaymentRequiredResponse.infer;
+/**
+ * Lenient payment required response parser that accepts optional error field.
+ * Use this when parsing incoming data from older servers that may not include
+ * the error field.
+ */
+export declare const x402PaymentRequiredResponseLenient: import("arktype/internal/methods/object.ts").ObjectType<{
+    x402Version: number;
+    accepts: {
+        scheme: string;
+        network: string;
+        maxAmountRequired: string;
+        resource: string;
+        description: string;
+        payTo: string;
+        maxTimeoutSeconds: number;
+        asset: string;
+        mimeType?: string;
+        outputSchema?: object;
+        extra?: object;
+    }[];
+    error?: string;
+}, {}>;
+export type x402PaymentRequiredResponseLenient = typeof x402PaymentRequiredResponseLenient.infer;
+/**
+ * Normalize a lenient payment required response to spec-compliant field values.
+ * Defaults error to empty string when missing.
+ */
+export declare function normalizePaymentRequiredResponse(res: x402PaymentRequiredResponseLenient): x402PaymentRequiredResponse;
 export declare const x402PaymentPayload: import("arktype/internal/methods/object.ts").ObjectType<{
     x402Version: number;
     scheme: string;
@@ -52,17 +88,16 @@ export declare const x402PaymentHeaderToPayload: import("arktype/internal/method
     asset?: string;
 }>, {}>;
 export declare const x402VerifyRequest: import("arktype/internal/methods/object.ts").ObjectType<{
-    x402Version: number;
     paymentRequirements: {
         scheme: string;
         network: string;
         maxAmountRequired: string;
         resource: string;
         description: string;
-        mimeType: string;
         payTo: string;
         maxTimeoutSeconds: number;
         asset: string;
+        mimeType?: string;
         outputSchema?: object;
         extra?: object;
     };
@@ -78,21 +113,37 @@ export declare const x402VerifyRequest: import("arktype/internal/methods/object.
 export type x402VerifyRequest = typeof x402VerifyRequest.infer;
 export declare const x402VerifyResponse: import("arktype/internal/methods/object.ts").ObjectType<{
     isValid: boolean;
-    invalidReason?: string | null;
+    payer: string;
+    invalidReason?: string;
 }, {}>;
 export type x402VerifyResponse = typeof x402VerifyResponse.infer;
+/**
+ * Lenient verify response parser that accepts optional payer field.
+ * Use this when parsing incoming data from older facilitators that may
+ * not include the payer field.
+ */
+export declare const x402VerifyResponseLenient: import("arktype/internal/methods/object.ts").ObjectType<{
+    isValid: boolean;
+    invalidReason?: string | null;
+    payer?: string;
+}, {}>;
+export type x402VerifyResponseLenient = typeof x402VerifyResponseLenient.infer;
+/**
+ * Normalize a lenient verify response to spec-compliant field values.
+ * Defaults payer to empty string and strips null from invalidReason.
+ */
+export declare function normalizeVerifyResponse(res: x402VerifyResponseLenient): x402VerifyResponse;
 export declare const x402SettleRequest: import("arktype/internal/methods/object.ts").ObjectType<{
-    x402Version: number;
     paymentRequirements: {
         scheme: string;
         network: string;
         maxAmountRequired: string;
         resource: string;
         description: string;
-        mimeType: string;
         payTo: string;
         maxTimeoutSeconds: number;
         asset: string;
+        mimeType?: string;
         outputSchema?: object;
         extra?: object;
     };
@@ -106,13 +157,55 @@ export declare const x402SettleRequest: import("arktype/internal/methods/object.
     };
 }, {}>;
 export type x402SettleRequest = typeof x402SettleRequest.infer;
-export declare const x402SettleResponse: import("arktype/internal/methods/object.ts").ObjectType<{
+/**
+ * Legacy settle response type with pre-spec field names (txHash, networkId, error).
+ * Use x402SettleResponse for spec-compliant field names (transaction, network, errorReason).
+ *
+ * This type exists for backward compatibility when interfacing with older clients
+ * that use legacy field names.
+ */
+export declare const x402SettleResponseLegacy: import("arktype/internal/methods/object.ts").ObjectType<{
     success: boolean;
     txHash: string | null;
     networkId: string | null;
     error?: string | null;
+    payer?: string;
+}, {}>;
+export type x402SettleResponseLegacy = typeof x402SettleResponseLegacy.infer;
+/**
+ * Spec-compliant settle response per x402-specification-v1.md Section 5.3.
+ * Field names: transaction, network, errorReason (not txHash, networkId, error)
+ */
+export declare const x402SettleResponse: import("arktype/internal/methods/object.ts").ObjectType<{
+    success: boolean;
+    transaction: string;
+    network: string;
+    payer: string;
+    errorReason?: string;
 }, {}>;
 export type x402SettleResponse = typeof x402SettleResponse.infer;
+/**
+ * Lenient settle response parser that accepts either legacy or spec-compliant
+ * field names. Use this when parsing incoming data that may come from older
+ * clients using legacy field names.
+ */
+export declare const x402SettleResponseLenient: import("arktype/internal/methods/object.ts").ObjectType<{
+    success: boolean;
+    errorReason?: string | null;
+    error?: string | null;
+    transaction?: string | null;
+    txHash?: string | null;
+    network?: string | null;
+    networkId?: string | null;
+    payer?: string;
+}, {}>;
+export type x402SettleResponseLenient = typeof x402SettleResponseLenient.infer;
+/**
+ * Normalize a lenient settle response to spec-compliant field names.
+ * Converts legacy field names (txHash, networkId, error) to spec-compliant
+ * names (transaction, network, errorReason).
+ */
+export declare function normalizeSettleResponse(res: x402SettleResponseLenient): x402SettleResponse;
 export declare const x402SupportedKind: import("arktype/internal/methods/object.ts").ObjectType<{
     x402Version: number;
     scheme: string;
@@ -129,6 +222,17 @@ export declare const x402SupportedResponse: import("arktype/internal/methods/obj
     }[];
 }, {}>;
 export type x402SupportedResponse = typeof x402SupportedResponse.infer;
+/**
+ * Creates a matcher function for filtering payment requirements.
+ *
+ * The matcher performs case-insensitive matching on scheme, network,
+ * and asset fields.
+ *
+ * @param scheme - Accepted payment scheme names
+ * @param network - Accepted network identifiers
+ * @param asset - Accepted asset addresses
+ * @returns Object with the matcher tuple and isMatchingRequirement function
+ */
 export declare function generateRequirementsMatcher(scheme: string[], network: string[], asset: string[]): {
     matchTuple: import("arktype/internal/methods/object.ts").ObjectType<{
         scheme: (In: string) => import("arktype/internal/attributes.ts").To<Lowercase<string>>;

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

@@ -1 +1 @@
-{"version":3,"file":"x402.d.ts","sourceRoot":"","sources":["../../src/x402.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,aAAa;;;;MAIxB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,KAAK,CAAC;AAEvD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;MAYlC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAC,KAAK,CAAC;AAE3E,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;MAItC,CAAC;AAEH,MAAM,MAAM,2BAA2B,GACrC,OAAO,2BAA2B,CAAC,KAAK,CAAC;AAE3C,eAAO,MAAM,kBAAkB;;;;;;MAM7B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,KAAK,CAAC;AAEjE,eAAO,MAAM,0BAA0B;;;;;;OAGd,CAAC;AAE1B,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;MAK5B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,KAAK,CAAC;AAE/D,eAAO,MAAM,kBAAkB;;;MAG7B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,KAAK,CAAC;AAEjE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;MAAoB,CAAC;AACnD,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,KAAK,CAAC;AAE/D,eAAO,MAAM,kBAAkB;;;;;MAK7B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,KAAK,CAAC;AAEjE,eAAO,MAAM,iBAAiB;;;;;MAK5B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,KAAK,CAAC;AAE/D,eAAO,MAAM,qBAAqB;;;;;;;MAEhC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,OAAO,qBAAqB,CAAC,KAAK,CAAC;AAEvE,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,EAAE,MAAM,EAAE,EACjB,KAAK,EAAE,MAAM,EAAE;;;;;;;;;;;EAgBhB"}
+{"version":3,"file":"x402.d.ts","sourceRoot":"","sources":["../../src/x402.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,eAAO,MAAM,gBAAgB,cAAc,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,yBAAyB,uBAAuB,CAAC;AAE9D,eAAO,MAAM,aAAa;;;;MAIxB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,KAAK,CAAC;AAEvD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;MAYlC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAC,KAAK,CAAC;AAE3E,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;MAItC,CAAC;AAEH,MAAM,MAAM,2BAA2B,GACrC,OAAO,2BAA2B,CAAC,KAAK,CAAC;AAE3C;;;;GAIG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;MAI7C,CAAC;AAEH,MAAM,MAAM,kCAAkC,GAC5C,OAAO,kCAAkC,CAAC,KAAK,CAAC;AAElD;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,GAAG,EAAE,kCAAkC,GACtC,2BAA2B,CAM7B;AAED,eAAO,MAAM,kBAAkB;;;;;;MAM7B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,KAAK,CAAC;AAEjE,eAAO,MAAM,0BAA0B;;;;;;OAGd,CAAC;AAE1B,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;MAI5B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,KAAK,CAAC;AAE/D,eAAO,MAAM,kBAAkB;;;;MAI7B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,KAAK,CAAC;AAEjE;;;;GAIG;AACH,eAAO,MAAM,yBAAyB;;;;MAIpC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,OAAO,yBAAyB,CAAC,KAAK,CAAC;AAE/E;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,yBAAyB,GAC7B,kBAAkB,CAUpB;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;MAAoB,CAAC;AACnD,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,KAAK,CAAC;AAE/D;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB;;;;;;MAMnC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,OAAO,wBAAwB,CAAC,KAAK,CAAC;AAE7E;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;MAM7B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,KAAK,CAAC;AAEjE;;;;GAIG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;MASpC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,OAAO,yBAAyB,CAAC,KAAK,CAAC;AAE/E;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,yBAAyB,GAC7B,kBAAkB,CAYpB;AAED,eAAO,MAAM,iBAAiB;;;;;MAK5B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,KAAK,CAAC;AAE/D,eAAO,MAAM,qBAAqB;;;;;;;MAEhC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,OAAO,qBAAqB,CAAC,KAAK,CAAC;AAEvE;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,EAAE,MAAM,EAAE,EACjB,KAAK,EAAE,MAAM,EAAE;;;;;;;;;;;EAgBhB"}

package/dist/src/x402.js

@@ -1,6 +1,14 @@
 import { type } from "arktype";
 import { caseInsensitiveLiteral } from "./literal.js";
 import { isValidationError } from "./validation.js";
+/**
+ * HTTP header name for v1 client payment payloads.
+ */
+export const X_PAYMENT_HEADER = "X-PAYMENT";
+/**
+ * HTTP header name for v1 server payment responses.
+ */
+export const X_PAYMENT_RESPONSE_HEADER = "X-PAYMENT-RESPONSE";
 export const x402PaymentId = type({
     scheme: "string",
     network: "string",
@@ -12,7 +20,7 @@ export const x402PaymentRequirements = type({
     maxAmountRequired: "string.numeric",
     resource: "string.url",
     description: "string",
-    mimeType: "string",
+    "mimeType?": "string",
     outputSchema: "object?",
     payTo: "string",
     maxTimeoutSeconds: "number.integer",
@@ -22,8 +30,29 @@ export const x402PaymentRequirements = type({
 export const x402PaymentRequiredResponse = type({
     x402Version: "number.integer",
     accepts: x402PaymentRequirements.array(),
-    error: "string?",
+    error: "string",
 });
+/**
+ * Lenient payment required response parser that accepts optional error field.
+ * Use this when parsing incoming data from older servers that may not include
+ * the error field.
+ */
+export const x402PaymentRequiredResponseLenient = type({
+    x402Version: "number.integer",
+    accepts: x402PaymentRequirements.array(),
+    "error?": "string",
+});
+/**
+ * Normalize a lenient payment required response to spec-compliant field values.
+ * Defaults error to empty string when missing.
+ */
+export function normalizePaymentRequiredResponse(res) {
+    return {
+        x402Version: res.x402Version,
+        accepts: res.accepts,
+        error: res.error ?? "",
+    };
+}
 export const x402PaymentPayload = type({
     x402Version: "number.integer",
     scheme: "string",
@@ -36,22 +65,99 @@ export const x402PaymentHeaderToPayload = type("string.base64")
     .to("string.json.parse")
     .to(x402PaymentPayload);
 export const x402VerifyRequest = type({
-    x402Version: "number.integer",
     paymentHeader: "string?",
     paymentPayload: x402PaymentPayload.optional(),
     paymentRequirements: x402PaymentRequirements,
 });
 export const x402VerifyResponse = type({
+    isValid: "boolean",
+    "invalidReason?": "string",
+    payer: "string",
+});
+/**
+ * Lenient verify response parser that accepts optional payer field.
+ * Use this when parsing incoming data from older facilitators that may
+ * not include the payer field.
+ */
+export const x402VerifyResponseLenient = type({
     isValid: "boolean",
     "invalidReason?": "string | null",
+    "payer?": "string",
 });
+/**
+ * Normalize a lenient verify response to spec-compliant field values.
+ * Defaults payer to empty string and strips null from invalidReason.
+ */
+export function normalizeVerifyResponse(res) {
+    const result = {
+        isValid: res.isValid,
+        payer: res.payer ?? "",
+    };
+    const invalidReason = res.invalidReason;
+    if (invalidReason !== undefined && invalidReason !== null) {
+        result.invalidReason = invalidReason;
+    }
+    return result;
+}
 export const x402SettleRequest = x402VerifyRequest;
-export const x402SettleResponse = type({
+/**
+ * Legacy settle response type with pre-spec field names (txHash, networkId, error).
+ * Use x402SettleResponse for spec-compliant field names (transaction, network, errorReason).
+ *
+ * This type exists for backward compatibility when interfacing with older clients
+ * that use legacy field names.
+ */
+export const x402SettleResponseLegacy = type({
     success: "boolean",
     "error?": "string | null",
     txHash: "string | null",
     networkId: "string | null",
+    "payer?": "string",
+});
+/**
+ * Spec-compliant settle response per x402-specification-v1.md Section 5.3.
+ * Field names: transaction, network, errorReason (not txHash, networkId, error)
+ */
+export const x402SettleResponse = type({
+    success: "boolean",
+    "errorReason?": "string",
+    transaction: "string",
+    network: "string",
+    payer: "string",
 });
+/**
+ * Lenient settle response parser that accepts either legacy or spec-compliant
+ * field names. Use this when parsing incoming data that may come from older
+ * clients using legacy field names.
+ */
+export const x402SettleResponseLenient = type({
+    success: "boolean",
+    "errorReason?": "string | null",
+    "error?": "string | null",
+    "transaction?": "string | null",
+    "txHash?": "string | null",
+    "network?": "string | null",
+    "networkId?": "string | null",
+    "payer?": "string",
+});
+/**
+ * Normalize a lenient settle response to spec-compliant field names.
+ * Converts legacy field names (txHash, networkId, error) to spec-compliant
+ * names (transaction, network, errorReason).
+ */
+export function normalizeSettleResponse(res) {
+    const result = {
+        success: res.success,
+        transaction: res.transaction ?? res.txHash ?? "",
+        network: res.network ?? res.networkId ?? "",
+        payer: res.payer ?? "",
+    };
+    const errorReason = res.errorReason ?? res.error;
+    if (errorReason !== undefined && errorReason !== null) {
+        result.errorReason = errorReason;
+    }
+    return result;
+}
 export const x402SupportedKind = type({
     x402Version: "number.integer",
     scheme: "string",
@@ -61,6 +167,17 @@ export const x402SupportedKind = type({
 export const x402SupportedResponse = type({
     kinds: x402SupportedKind.array(),
 });
+/**
+ * Creates a matcher function for filtering payment requirements.
+ *
+ * The matcher performs case-insensitive matching on scheme, network,
+ * and asset fields.
+ *
+ * @param scheme - Accepted payment scheme names
+ * @param network - Accepted network identifiers
+ * @param asset - Accepted asset addresses
+ * @returns Object with the matcher tuple and isMatchingRequirement function
+ */
 export function generateRequirementsMatcher(scheme, network, asset) {
     const matchTuple = type({
         scheme: caseInsensitiveLiteral(...scheme),

package/dist/src/x402v2.d.ts

@@ -0,0 +1,190 @@
+/**
+ * HTTP header name for v2 client payment signatures.
+ */
+export declare const V2_PAYMENT_HEADER = "PAYMENT-SIGNATURE";
+/**
+ * HTTP header name for v2 402 payment required responses.
+ */
+export declare const V2_PAYMENT_REQUIRED_HEADER = "PAYMENT-REQUIRED";
+/**
+ * HTTP header name for v2 server payment responses.
+ */
+export declare const V2_PAYMENT_RESPONSE_HEADER = "PAYMENT-RESPONSE";
+export declare const x402ResourceInfo: import("arktype/internal/methods/object.ts").ObjectType<{
+    url: string;
+    description?: string;
+    mimeType?: string;
+}, {}>;
+export type x402ResourceInfo = typeof x402ResourceInfo.infer;
+export declare const x402PaymentRequirements: import("arktype/internal/methods/object.ts").ObjectType<{
+    scheme: string;
+    network: string;
+    amount: string;
+    asset: string;
+    payTo: string;
+    maxTimeoutSeconds: number;
+    extra?: object;
+}, {}>;
+export type x402PaymentRequirements = typeof x402PaymentRequirements.infer;
+export declare const x402PaymentRequiredResponse: import("arktype/internal/methods/object.ts").ObjectType<{
+    x402Version: 2;
+    resource: {
+        url: string;
+        description?: string;
+        mimeType?: string;
+    };
+    accepts: {
+        scheme: string;
+        network: string;
+        amount: string;
+        asset: string;
+        payTo: string;
+        maxTimeoutSeconds: number;
+        extra?: object;
+    }[];
+    error?: string;
+    extensions?: object;
+}, {}>;
+export type x402PaymentRequiredResponse = typeof x402PaymentRequiredResponse.infer;
+export declare const x402PaymentPayload: import("arktype/internal/methods/object.ts").ObjectType<{
+    x402Version: 2;
+    accepted: {
+        scheme: string;
+        network: string;
+        amount: string;
+        asset: string;
+        payTo: string;
+        maxTimeoutSeconds: number;
+        extra?: object;
+    };
+    payload: object;
+    resource?: {
+        url: string;
+        description?: string;
+        mimeType?: string;
+    };
+    extensions?: object;
+}, {}>;
+export type x402PaymentPayload = typeof x402PaymentPayload.infer;
+export declare const x402PaymentHeaderToPayload: import("arktype/internal/methods/object.ts").ObjectType<(In: string) => import("arktype/internal/attributes.ts").To<{
+    x402Version: 2;
+    accepted: {
+        scheme: string;
+        network: string;
+        amount: string;
+        asset: string;
+        payTo: string;
+        maxTimeoutSeconds: number;
+        extra?: object;
+    };
+    payload: object;
+    resource?: {
+        url: string;
+        description?: string;
+        mimeType?: string;
+    };
+    extensions?: object;
+}>, {}>;
+export declare const x402VerifyRequest: import("arktype/internal/methods/object.ts").ObjectType<{
+    paymentPayload: {
+        x402Version: 2;
+        accepted: {
+            scheme: string;
+            network: string;
+            amount: string;
+            asset: string;
+            payTo: string;
+            maxTimeoutSeconds: number;
+            extra?: object;
+        };
+        payload: object;
+        resource?: {
+            url: string;
+            description?: string;
+            mimeType?: string;
+        };
+        extensions?: object;
+    };
+    paymentRequirements: {
+        scheme: string;
+        network: string;
+        amount: string;
+        asset: string;
+        payTo: string;
+        maxTimeoutSeconds: number;
+        extra?: object;
+    };
+}, {}>;
+export type x402VerifyRequest = typeof x402VerifyRequest.infer;
+export declare const x402VerifyResponse: import("arktype/internal/methods/object.ts").ObjectType<{
+    isValid: boolean;
+    invalidReason?: string;
+    payer?: string;
+}, {}>;
+export type x402VerifyResponse = typeof x402VerifyResponse.infer;
+export declare const x402SettleRequest: import("arktype/internal/methods/object.ts").ObjectType<{
+    paymentPayload: {
+        x402Version: 2;
+        accepted: {
+            scheme: string;
+            network: string;
+            amount: string;
+            asset: string;
+            payTo: string;
+            maxTimeoutSeconds: number;
+            extra?: object;
+        };
+        payload: object;
+        resource?: {
+            url: string;
+            description?: string;
+            mimeType?: string;
+        };
+        extensions?: object;
+    };
+    paymentRequirements: {
+        scheme: string;
+        network: string;
+        amount: string;
+        asset: string;
+        payTo: string;
+        maxTimeoutSeconds: number;
+        extra?: object;
+    };
+}, {}>;
+export type x402SettleRequest = typeof x402SettleRequest.infer;
+export declare const x402SettleResponse: import("arktype/internal/methods/object.ts").ObjectType<{
+    success: boolean;
+    transaction: string;
+    network: string;
+    errorReason?: string;
+    payer?: string;
+    extensions?: object;
+}, {}>;
+export type x402SettleResponse = typeof x402SettleResponse.infer;
+export declare const x402SupportedKind: import("arktype/internal/methods/object.ts").ObjectType<{
+    x402Version: 2;
+    scheme: string;
+    network: string;
+    extra?: object;
+}, {}>;
+export type x402SupportedKind = typeof x402SupportedKind.infer;
+export declare const x402SupportedKindAny: import("arktype/internal/methods/object.ts").ObjectType<{
+    x402Version: 1 | 2;
+    scheme: string;
+    network: string;
+    extra?: object;
+}, {}>;
+export type x402SupportedKindAny = typeof x402SupportedKindAny.infer;
+export declare const x402SupportedResponse: import("arktype/internal/methods/object.ts").ObjectType<{
+    kinds: {
+        x402Version: 1 | 2;
+        scheme: string;
+        network: string;
+        extra?: object;
+    }[];
+    extensions: string[];
+    signers: Record<string, string[]>;
+}, {}>;
+export type x402SupportedResponse = typeof x402SupportedResponse.infer;
+//# sourceMappingURL=x402v2.d.ts.map

package/dist/src/x402v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402v2.d.ts","sourceRoot":"","sources":["../../src/x402v2.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,0BAA0B,qBAAqB,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,0BAA0B,qBAAqB,CAAC;AAE7D,eAAO,MAAM,gBAAgB;;;;MAI3B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,KAAK,CAAC;AAE7D,eAAO,MAAM,uBAAuB;;;;;;;;MAQlC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAC,KAAK,CAAC;AAE3E,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;MAMtC,CAAC;AAEH,MAAM,MAAM,2BAA2B,GACrC,OAAO,2BAA2B,CAAC,KAAK,CAAC;AAE3C,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;MAM7B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,KAAK,CAAC;AAEjE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;OAGd,CAAC;AAE1B,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAG5B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,KAAK,CAAC;AAE/D,eAAO,MAAM,kBAAkB;;;;MAI7B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,KAAK,CAAC;AAEjE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAAoB,CAAC;AACnD,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,KAAK,CAAC;AAE/D,eAAO,MAAM,kBAAkB;;;;;;;MAO7B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,KAAK,CAAC;AAEjE,eAAO,MAAM,iBAAiB;;;;;MAK5B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,KAAK,CAAC;AAG/D,eAAO,MAAM,oBAAoB;;;;;MAK/B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAC,KAAK,CAAC;AAErE,eAAO,MAAM,qBAAqB;;;;;;;;;MAIhC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,OAAO,qBAAqB,CAAC,KAAK,CAAC"}

package/dist/src/x402v2.js

@@ -0,0 +1,81 @@
+import { type } from "arktype";
+/**
+ * HTTP header name for v2 client payment signatures.
+ */
+export const V2_PAYMENT_HEADER = "PAYMENT-SIGNATURE";
+/**
+ * HTTP header name for v2 402 payment required responses.
+ */
+export const V2_PAYMENT_REQUIRED_HEADER = "PAYMENT-REQUIRED";
+/**
+ * HTTP header name for v2 server payment responses.
+ */
+export const V2_PAYMENT_RESPONSE_HEADER = "PAYMENT-RESPONSE";
+export const x402ResourceInfo = type({
+    url: "string",
+    "description?": "string",
+    "mimeType?": "string",
+});
+export const x402PaymentRequirements = type({
+    scheme: "string",
+    network: "string",
+    amount: "string.numeric",
+    asset: "string",
+    payTo: "string",
+    maxTimeoutSeconds: "number.integer",
+    "extra?": "object",
+});
+export const x402PaymentRequiredResponse = type({
+    x402Version: "2",
+    "error?": "string",
+    resource: x402ResourceInfo,
+    accepts: x402PaymentRequirements.array(),
+    "extensions?": "object",
+});
+export const x402PaymentPayload = type({
+    x402Version: "2",
+    "resource?": x402ResourceInfo,
+    accepted: x402PaymentRequirements,
+    payload: "object",
+    "extensions?": "object",
+});
+export const x402PaymentHeaderToPayload = type("string.base64")
+    .pipe.try((x) => atob(x))
+    .to("string.json.parse")
+    .to(x402PaymentPayload);
+export const x402VerifyRequest = type({
+    paymentPayload: x402PaymentPayload,
+    paymentRequirements: x402PaymentRequirements,
+});
+export const x402VerifyResponse = type({
+    isValid: "boolean",
+    "invalidReason?": "string",
+    "payer?": "string",
+});
+export const x402SettleRequest = x402VerifyRequest;
+export const x402SettleResponse = type({
+    success: "boolean",
+    "errorReason?": "string",
+    "payer?": "string",
+    transaction: "string",
+    network: "string",
+    "extensions?": "object",
+});
+export const x402SupportedKind = type({
+    x402Version: "2",
+    scheme: "string",
+    network: "string",
+    "extra?": "object",
+});
+// SupportedKind that accepts either v1 or v2 version numbers
+export const x402SupportedKindAny = type({
+    x402Version: "1 | 2",
+    scheme: "string",
+    network: "string",
+    "extra?": "object",
+});
+export const x402SupportedResponse = type({
+    kinds: x402SupportedKindAny.array(),
+    extensions: "string[]",
+    signers: type("Record<string, string[]>"),
+});

package/dist/src/x402v2.test.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env pnpm tsx
+export {};
+//# sourceMappingURL=x402v2.test.d.ts.map

package/dist/src/x402v2.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402v2.test.d.ts","sourceRoot":"","sources":["../../src/x402v2.test.ts"],"names":[],"mappings":""}