Faremeter API / types/src / x402
x402
Type Aliases
x402PaymentId
x402PaymentId = typeof x402PaymentId.infer
Defined in: packages/types/src/x402.ts:15
x402PaymentPayload
x402PaymentPayload = typeof x402PaymentPayload.infer
Defined in: packages/types/src/x402.ts:62
x402PaymentRequiredResponse
x402PaymentRequiredResponse = typeof x402PaymentRequiredResponse.infer
Defined in: packages/types/src/x402.ts:39
x402PaymentRequiredResponseLenient
x402PaymentRequiredResponseLenient = typeof x402PaymentRequiredResponseLenient.infer
Defined in: packages/types/src/x402.ts:53
x402PaymentRequirements
x402PaymentRequirements = typeof x402PaymentRequirements.infer
Defined in: packages/types/src/x402.ts:23
x402SettleRequest
x402SettleRequest = typeof x402SettleRequest.infer
Defined in: packages/types/src/x402.ts:107
x402SettleResponse
x402SettleResponse = typeof x402SettleResponse.infer
Defined in: packages/types/src/x402.ts:131
x402SettleResponseLegacy
x402SettleResponseLegacy = typeof x402SettleResponseLegacy.infer
Defined in: packages/types/src/x402.ts:117
x402SettleResponseLenient
x402SettleResponseLenient = typeof x402SettleResponseLenient.infer
Defined in: packages/types/src/x402.ts:146
x402SupportedKind
x402SupportedKind = typeof x402SupportedKind.infer
Defined in: packages/types/src/x402.ts:180
x402SupportedResponse
x402SupportedResponse = typeof x402SupportedResponse.infer
Defined in: packages/types/src/x402.ts:189
x402VerifyRequest
x402VerifyRequest = typeof x402VerifyRequest.infer
Defined in: packages/types/src/x402.ts:77
x402VerifyResponse
x402VerifyResponse = typeof x402VerifyResponse.infer
Defined in: packages/types/src/x402.ts:86
x402VerifyResponseLenient
x402VerifyResponseLenient = typeof x402VerifyResponseLenient.infer
Defined in: packages/types/src/x402.ts:99
Variables
X_PAYMENT_HEADER
Defined in: packages/types/src/x402.ts:8 HTTP header name for v1 client payment payloads.constX_PAYMENT_HEADER:"X-PAYMENT"="X-PAYMENT"
X_PAYMENT_RESPONSE_HEADER
Defined in: packages/types/src/x402.ts:13 HTTP header name for v1 server payment responses.constX_PAYMENT_RESPONSE_HEADER:"X-PAYMENT-RESPONSE"="X-PAYMENT-RESPONSE"
x402PaymentHeaderToPayload
Defined in: packages/types/src/x402.ts:72constx402PaymentHeaderToPayload:Type<(In) =>To, { }>
x402PaymentId
Defined in: packages/types/src/x402.ts:15constx402PaymentId:Type<{asset:string;network:string;scheme:string; }, { }>
x402PaymentPayload
Defined in: packages/types/src/x402.ts:62constx402PaymentPayload:Type<{asset?:string;network:string;payload:object;scheme:string;x402Version:number; }, { }>
x402PaymentRequiredResponse
Defined in: packages/types/src/x402.ts:39constx402PaymentRequiredResponse:Type<{accepts:object[];error:string;x402Version:number; }, { }>
x402PaymentRequiredResponseLenient
Defined in: packages/types/src/x402.ts:53 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.constx402PaymentRequiredResponseLenient:Type<{accepts:object[];error?:string;x402Version:number; }, { }>
x402PaymentRequirements
Defined in: packages/types/src/x402.ts:23constx402PaymentRequirements:Type<{asset:string;description:string;extra?:object;maxAmountRequired:string;maxTimeoutSeconds:number;mimeType?:string;network:string;outputSchema?:object;payTo:string;resource:string;scheme:string; }, { }>
x402SettleRequest
Defined in: packages/types/src/x402.ts:107constx402SettleRequest:Type<{paymentHeader?:string;paymentPayload?: {asset?:string;network:string;payload:object;scheme:string;x402Version:number; };paymentRequirements: {asset:string;description:string;extra?:object;maxAmountRequired:string;maxTimeoutSeconds:number;mimeType?:string;network:string;outputSchema?:object;payTo:string;resource:string;scheme:string; };x402Version:number; }, { }> =x402VerifyRequest
x402SettleResponse
Defined in: packages/types/src/x402.ts:131 Spec-compliant settle response per x402-specification-v1.md Section 5.3. Field names: transaction, network, errorReason (not txHash, networkId, error)constx402SettleResponse:Type<{errorReason?:string;network:string;payer:string;success:boolean;transaction:string; }, { }>
x402SettleResponseLegacy
Defined in: packages/types/src/x402.ts:117 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.constx402SettleResponseLegacy:Type<{error?:null|string;networkId:null|string;payer?:string;success:boolean;txHash:null|string; }, { }>
x402SettleResponseLenient
Defined in: packages/types/src/x402.ts:146 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.constx402SettleResponseLenient:Type<{error?:null|string;errorReason?:null|string;network?:null|string;networkId?:null|string;payer?:string;success:boolean;transaction?:null|string;txHash?:null|string; }, { }>
x402SupportedKind
Defined in: packages/types/src/x402.ts:180constx402SupportedKind:Type<{extra?:object;network:string;scheme:string;x402Version:number; }, { }>
x402SupportedResponse
Defined in: packages/types/src/x402.ts:189constx402SupportedResponse:Type<{kinds:object[]; }, { }>
x402VerifyRequest
Defined in: packages/types/src/x402.ts:77constx402VerifyRequest:Type<{paymentHeader?:string;paymentPayload?: {asset?:string;network:string;payload:object;scheme:string;x402Version:number; };paymentRequirements: {asset:string;description:string;extra?:object;maxAmountRequired:string;maxTimeoutSeconds:number;mimeType?:string;network:string;outputSchema?:object;payTo:string;resource:string;scheme:string; };x402Version:number; }, { }>
x402VerifyResponse
Defined in: packages/types/src/x402.ts:86constx402VerifyResponse:Type<{invalidReason?:string;isValid:boolean;payer:string; }, { }>
x402VerifyResponseLenient
Defined in: packages/types/src/x402.ts:99 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.constx402VerifyResponseLenient:Type<{invalidReason?:null|string;isValid:boolean;payer?:string; }, { }>
Functions
generateRequirementsMatcher()
generateRequirementsMatcher(Defined in: packages/types/src/x402.ts:206 Creates a matcher function for filtering payment requirements. The matcher performs case-insensitive matching on scheme, network, and asset fields.scheme,network,asset):object
Parameters
scheme
string[]
Accepted payment scheme names
network
string[]
Accepted network identifiers
asset
string[]
Accepted asset addresses
Returns
object
Object with the matcher tuple and isMatchingRequirement function
isMatchingRequirement()
isMatchingRequirement: (req) =>boolean
Parameters
req
asset
string = ...
network
string = ...
scheme
string = ...
Returns
boolean
matchTuple
matchTuple:Type<{asset: (In) =>To;network: (In) =>To;scheme: (In) =>To; }, { }>
normalizeSettleResponse()
normalizeSettleResponse(Defined in: packages/types/src/x402.ts:164 Normalize a lenient settle response to spec-compliant field names. Converts legacy field names (txHash, networkId, error) to spec-compliant names (transaction, network, errorReason).res):object
Parameters
res
error?
null | string = “string | null”
errorReason?
null | string = “string | null”
network?
null | string = “string | null”
networkId?
null | string = “string | null”
payer?
string = "string"
success
boolean = "boolean"
transaction?
null | string = “string | null”
txHash?
null | string = “string | null”
Returns
object
errorReason?
optionalerrorReason:string="string"
network
network:string="string"
payer
payer:string="string"
success
success:boolean="boolean"
transaction
transaction:string="string"