x402-express-mantle 1.0.0 → 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (125) hide show
  1. package/README.md +19 -1
  2. package/lib/cjs/index.d.ts +119 -81
  3. package/lib/cjs/index.js +3 -3
  4. package/lib/esm/index.d.mts +5 -5
  5. package/lib/esm/index.mjs +3 -3
  6. package/package.json +4 -3
  7. package/lib/cjs/client/index.d.ts +0 -243
  8. package/lib/cjs/client/index.js +0 -413
  9. package/lib/cjs/client/index.js.map +0 -1
  10. package/lib/cjs/exact/client/index.d.ts +0 -37
  11. package/lib/cjs/exact/client/index.js +0 -281
  12. package/lib/cjs/exact/client/index.js.map +0 -1
  13. package/lib/cjs/exact/facilitator/index.d.ts +0 -110
  14. package/lib/cjs/exact/facilitator/index.js +0 -714
  15. package/lib/cjs/exact/facilitator/index.js.map +0 -1
  16. package/lib/cjs/exact/server/index.d.ts +0 -87
  17. package/lib/cjs/exact/server/index.js +0 -209
  18. package/lib/cjs/exact/server/index.js.map +0 -1
  19. package/lib/cjs/exact/v1/client/index.d.ts +0 -33
  20. package/lib/cjs/exact/v1/client/index.js +0 -169
  21. package/lib/cjs/exact/v1/client/index.js.map +0 -1
  22. package/lib/cjs/exact/v1/facilitator/index.d.ts +0 -71
  23. package/lib/cjs/exact/v1/facilitator/index.js +0 -384
  24. package/lib/cjs/exact/v1/facilitator/index.js.map +0 -1
  25. package/lib/cjs/facilitator/index.d.ts +0 -192
  26. package/lib/cjs/facilitator/index.js +0 -398
  27. package/lib/cjs/facilitator/index.js.map +0 -1
  28. package/lib/cjs/http/index.d.ts +0 -52
  29. package/lib/cjs/http/index.js +0 -827
  30. package/lib/cjs/http/index.js.map +0 -1
  31. package/lib/cjs/mechanisms-CzuGzYsS.d.ts +0 -270
  32. package/lib/cjs/scheme-MoBRXFM8.d.ts +0 -29
  33. package/lib/cjs/server/index.d.ts +0 -2
  34. package/lib/cjs/server/index.js +0 -1305
  35. package/lib/cjs/server/index.js.map +0 -1
  36. package/lib/cjs/signer-5OVDxViv.d.ts +0 -79
  37. package/lib/cjs/signer-BMkbhFYE.d.ts +0 -123
  38. package/lib/cjs/types/index.d.ts +0 -1
  39. package/lib/cjs/types/index.js +0 -66
  40. package/lib/cjs/types/index.js.map +0 -1
  41. package/lib/cjs/types/v1/index.d.ts +0 -1
  42. package/lib/cjs/types/v1/index.js +0 -19
  43. package/lib/cjs/types/v1/index.js.map +0 -1
  44. package/lib/cjs/utils/index.d.ts +0 -48
  45. package/lib/cjs/utils/index.js +0 -116
  46. package/lib/cjs/utils/index.js.map +0 -1
  47. package/lib/cjs/v1/index.d.ts +0 -12
  48. package/lib/cjs/v1/index.js +0 -180
  49. package/lib/cjs/v1/index.js.map +0 -1
  50. package/lib/cjs/x402HTTPResourceServer-D1YtlH_r.d.ts +0 -719
  51. package/lib/esm/chunk-3CEIVWNN.mjs +0 -339
  52. package/lib/esm/chunk-3CEIVWNN.mjs.map +0 -1
  53. package/lib/esm/chunk-BJTO5JO5.mjs +0 -11
  54. package/lib/esm/chunk-BJTO5JO5.mjs.map +0 -1
  55. package/lib/esm/chunk-EEA7DKZI.mjs +0 -111
  56. package/lib/esm/chunk-EEA7DKZI.mjs.map +0 -1
  57. package/lib/esm/chunk-FOUXRQAV.mjs +0 -88
  58. package/lib/esm/chunk-FOUXRQAV.mjs.map +0 -1
  59. package/lib/esm/chunk-IKSTWKEM.mjs +0 -157
  60. package/lib/esm/chunk-IKSTWKEM.mjs.map +0 -1
  61. package/lib/esm/chunk-JYZWCLMP.mjs +0 -305
  62. package/lib/esm/chunk-JYZWCLMP.mjs.map +0 -1
  63. package/lib/esm/chunk-PNSAJQCF.mjs +0 -108
  64. package/lib/esm/chunk-PNSAJQCF.mjs.map +0 -1
  65. package/lib/esm/chunk-PSA4YVU2.mjs +0 -92
  66. package/lib/esm/chunk-PSA4YVU2.mjs.map +0 -1
  67. package/lib/esm/chunk-QLXM7BIB.mjs +0 -23
  68. package/lib/esm/chunk-QLXM7BIB.mjs.map +0 -1
  69. package/lib/esm/chunk-TDLQZ6MP.mjs +0 -86
  70. package/lib/esm/chunk-TDLQZ6MP.mjs.map +0 -1
  71. package/lib/esm/chunk-VE37GDG2.mjs +0 -7
  72. package/lib/esm/chunk-VE37GDG2.mjs.map +0 -1
  73. package/lib/esm/chunk-WWACQNRQ.mjs +0 -7
  74. package/lib/esm/chunk-WWACQNRQ.mjs.map +0 -1
  75. package/lib/esm/chunk-X4W4S5RB.mjs +0 -39
  76. package/lib/esm/chunk-X4W4S5RB.mjs.map +0 -1
  77. package/lib/esm/chunk-Z4QX3O5V.mjs +0 -748
  78. package/lib/esm/chunk-Z4QX3O5V.mjs.map +0 -1
  79. package/lib/esm/chunk-ZYXTTU74.mjs +0 -88
  80. package/lib/esm/chunk-ZYXTTU74.mjs.map +0 -1
  81. package/lib/esm/client/index.d.mts +0 -243
  82. package/lib/esm/client/index.mjs +0 -260
  83. package/lib/esm/client/index.mjs.map +0 -1
  84. package/lib/esm/exact/client/index.d.mts +0 -37
  85. package/lib/esm/exact/client/index.mjs +0 -36
  86. package/lib/esm/exact/client/index.mjs.map +0 -1
  87. package/lib/esm/exact/facilitator/index.d.mts +0 -110
  88. package/lib/esm/exact/facilitator/index.mjs +0 -350
  89. package/lib/esm/exact/facilitator/index.mjs.map +0 -1
  90. package/lib/esm/exact/server/index.d.mts +0 -87
  91. package/lib/esm/exact/server/index.mjs +0 -129
  92. package/lib/esm/exact/server/index.mjs.map +0 -1
  93. package/lib/esm/exact/v1/client/index.d.mts +0 -33
  94. package/lib/esm/exact/v1/client/index.mjs +0 -8
  95. package/lib/esm/exact/v1/client/index.mjs.map +0 -1
  96. package/lib/esm/exact/v1/facilitator/index.d.mts +0 -71
  97. package/lib/esm/exact/v1/facilitator/index.mjs +0 -8
  98. package/lib/esm/exact/v1/facilitator/index.mjs.map +0 -1
  99. package/lib/esm/facilitator/index.d.mts +0 -192
  100. package/lib/esm/facilitator/index.mjs +0 -373
  101. package/lib/esm/facilitator/index.mjs.map +0 -1
  102. package/lib/esm/http/index.d.mts +0 -52
  103. package/lib/esm/http/index.mjs +0 -29
  104. package/lib/esm/http/index.mjs.map +0 -1
  105. package/lib/esm/mechanisms-CzuGzYsS.d.mts +0 -270
  106. package/lib/esm/scheme-fjF-9LhT.d.mts +0 -29
  107. package/lib/esm/server/index.d.mts +0 -2
  108. package/lib/esm/server/index.mjs +0 -563
  109. package/lib/esm/server/index.mjs.map +0 -1
  110. package/lib/esm/signer-5OVDxViv.d.mts +0 -79
  111. package/lib/esm/signer-BMkbhFYE.d.mts +0 -123
  112. package/lib/esm/types/index.d.mts +0 -1
  113. package/lib/esm/types/index.mjs +0 -10
  114. package/lib/esm/types/index.mjs.map +0 -1
  115. package/lib/esm/types/v1/index.d.mts +0 -1
  116. package/lib/esm/types/v1/index.mjs +0 -1
  117. package/lib/esm/types/v1/index.mjs.map +0 -1
  118. package/lib/esm/utils/index.d.mts +0 -48
  119. package/lib/esm/utils/index.mjs +0 -20
  120. package/lib/esm/utils/index.mjs.map +0 -1
  121. package/lib/esm/v1/index.d.mts +0 -12
  122. package/lib/esm/v1/index.mjs +0 -13
  123. package/lib/esm/v1/index.mjs.map +0 -1
  124. package/lib/esm/x402HTTPResourceServer-BIfIK5HS.d.mts +0 -719
  125. package/src/index.js +0 -4
@@ -1,260 +0,0 @@
1
- import {
2
- x402HTTPClient
3
- } from "../chunk-Z4QX3O5V.mjs";
4
- import {
5
- x402Version
6
- } from "../chunk-VE37GDG2.mjs";
7
- import "../chunk-X4W4S5RB.mjs";
8
- import {
9
- findByNetworkAndScheme,
10
- findSchemesByNetwork
11
- } from "../chunk-TDLQZ6MP.mjs";
12
- import "../chunk-BJTO5JO5.mjs";
13
-
14
- // src/client/x402Client.ts
15
- var x402Client = class _x402Client {
16
- /**
17
- * Creates a new x402Client instance.
18
- *
19
- * @param paymentRequirementsSelector - Function to select payment requirements from available options
20
- */
21
- constructor(paymentRequirementsSelector) {
22
- this.registeredClientSchemes = /* @__PURE__ */ new Map();
23
- this.policies = [];
24
- this.beforePaymentCreationHooks = [];
25
- this.afterPaymentCreationHooks = [];
26
- this.onPaymentCreationFailureHooks = [];
27
- this.paymentRequirementsSelector = paymentRequirementsSelector || ((x402Version2, accepts) => accepts[0]);
28
- }
29
- /**
30
- * Creates a new x402Client instance from a configuration object.
31
- *
32
- * @param config - The client configuration including schemes, policies, and payment requirements selector
33
- * @returns A configured x402Client instance
34
- */
35
- static fromConfig(config) {
36
- const client = new _x402Client(config.paymentRequirementsSelector);
37
- config.schemes.forEach((scheme) => {
38
- if (scheme.x402Version === 1) {
39
- client.registerV1(scheme.network, scheme.client);
40
- } else {
41
- client.register(scheme.network, scheme.client);
42
- }
43
- });
44
- config.policies?.forEach((policy) => {
45
- client.registerPolicy(policy);
46
- });
47
- return client;
48
- }
49
- /**
50
- * Registers a scheme client for the current x402 version.
51
- *
52
- * @param network - The network to register the client for
53
- * @param client - The scheme network client to register
54
- * @returns The x402Client instance for chaining
55
- */
56
- register(network, client) {
57
- return this._registerScheme(x402Version, network, client);
58
- }
59
- /**
60
- * Registers a scheme client for x402 version 1.
61
- *
62
- * @param network - The v1 network identifier (e.g., 'base-sepolia', 'solana-devnet')
63
- * @param client - The scheme network client to register
64
- * @returns The x402Client instance for chaining
65
- */
66
- registerV1(network, client) {
67
- return this._registerScheme(1, network, client);
68
- }
69
- /**
70
- * Registers a policy to filter or transform payment requirements.
71
- *
72
- * Policies are applied in order after filtering by registered schemes
73
- * and before the selector chooses the final payment requirement.
74
- *
75
- * @param policy - Function to filter/transform payment requirements
76
- * @returns The x402Client instance for chaining
77
- *
78
- * @example
79
- * ```typescript
80
- * // Prefer cheaper options
81
- * client.registerPolicy((version, reqs) =>
82
- * reqs.filter(r => BigInt(r.value) < BigInt('1000000'))
83
- * );
84
- *
85
- * // Prefer specific networks
86
- * client.registerPolicy((version, reqs) =>
87
- * reqs.filter(r => r.network.startsWith('eip155:'))
88
- * );
89
- * ```
90
- */
91
- registerPolicy(policy) {
92
- this.policies.push(policy);
93
- return this;
94
- }
95
- /**
96
- * Register a hook to execute before payment payload creation.
97
- * Can abort creation by returning { abort: true, reason: string }
98
- *
99
- * @param hook - The hook function to register
100
- * @returns The x402Client instance for chaining
101
- */
102
- onBeforePaymentCreation(hook) {
103
- this.beforePaymentCreationHooks.push(hook);
104
- return this;
105
- }
106
- /**
107
- * Register a hook to execute after successful payment payload creation.
108
- *
109
- * @param hook - The hook function to register
110
- * @returns The x402Client instance for chaining
111
- */
112
- onAfterPaymentCreation(hook) {
113
- this.afterPaymentCreationHooks.push(hook);
114
- return this;
115
- }
116
- /**
117
- * Register a hook to execute when payment payload creation fails.
118
- * Can recover from failure by returning { recovered: true, payload: PaymentPayload }
119
- *
120
- * @param hook - The hook function to register
121
- * @returns The x402Client instance for chaining
122
- */
123
- onPaymentCreationFailure(hook) {
124
- this.onPaymentCreationFailureHooks.push(hook);
125
- return this;
126
- }
127
- /**
128
- * Creates a payment payload based on a PaymentRequired response.
129
- *
130
- * Automatically extracts x402Version, resource, and extensions from the PaymentRequired
131
- * response and constructs a complete PaymentPayload with the accepted requirements.
132
- *
133
- * @param paymentRequired - The PaymentRequired response from the server
134
- * @returns Promise resolving to the complete payment payload
135
- */
136
- async createPaymentPayload(paymentRequired) {
137
- const clientSchemesByNetwork = this.registeredClientSchemes.get(paymentRequired.x402Version);
138
- if (!clientSchemesByNetwork) {
139
- throw new Error(`No client registered for x402 version: ${paymentRequired.x402Version}`);
140
- }
141
- const requirements = this.selectPaymentRequirements(paymentRequired.x402Version, paymentRequired.accepts);
142
- const context = {
143
- paymentRequired,
144
- selectedRequirements: requirements
145
- };
146
- for (const hook of this.beforePaymentCreationHooks) {
147
- const result = await hook(context);
148
- if (result && "abort" in result && result.abort) {
149
- throw new Error(`Payment creation aborted: ${result.reason}`);
150
- }
151
- }
152
- try {
153
- const schemeNetworkClient = findByNetworkAndScheme(clientSchemesByNetwork, requirements.scheme, requirements.network);
154
- if (!schemeNetworkClient) {
155
- throw new Error(`No client registered for scheme: ${requirements.scheme} and network: ${requirements.network}`);
156
- }
157
- const partialPayload = await schemeNetworkClient.createPaymentPayload(paymentRequired.x402Version, requirements);
158
- let paymentPayload;
159
- if (partialPayload.x402Version == 1) {
160
- paymentPayload = partialPayload;
161
- } else {
162
- paymentPayload = {
163
- ...partialPayload,
164
- extensions: paymentRequired.extensions,
165
- resource: paymentRequired.resource,
166
- accepted: requirements
167
- };
168
- }
169
- const createdContext = {
170
- ...context,
171
- paymentPayload
172
- };
173
- for (const hook of this.afterPaymentCreationHooks) {
174
- await hook(createdContext);
175
- }
176
- return paymentPayload;
177
- } catch (error) {
178
- const failureContext = {
179
- ...context,
180
- error
181
- };
182
- for (const hook of this.onPaymentCreationFailureHooks) {
183
- const result = await hook(failureContext);
184
- if (result && "recovered" in result && result.recovered) {
185
- return result.payload;
186
- }
187
- }
188
- throw error;
189
- }
190
- }
191
- /**
192
- * Selects appropriate payment requirements based on registered clients and policies.
193
- *
194
- * Selection process:
195
- * 1. Filter by registered schemes (network + scheme support)
196
- * 2. Apply all registered policies in order
197
- * 3. Use selector to choose final requirement
198
- *
199
- * @param x402Version - The x402 protocol version
200
- * @param paymentRequirements - Array of available payment requirements
201
- * @returns The selected payment requirements
202
- */
203
- selectPaymentRequirements(x402Version2, paymentRequirements) {
204
- const clientSchemesByNetwork = this.registeredClientSchemes.get(x402Version2);
205
- if (!clientSchemesByNetwork) {
206
- throw new Error(`No client registered for x402 version: ${x402Version2}`);
207
- }
208
- const supportedPaymentRequirements = paymentRequirements.filter((requirement) => {
209
- let clientSchemes = findSchemesByNetwork(clientSchemesByNetwork, requirement.network);
210
- if (!clientSchemes) {
211
- return false;
212
- }
213
- return clientSchemes.has(requirement.scheme);
214
- });
215
- if (supportedPaymentRequirements.length === 0) {
216
- throw new Error(`No network/scheme registered for x402 version: ${x402Version2} which comply with the payment requirements. ${JSON.stringify({
217
- x402Version: x402Version2,
218
- paymentRequirements,
219
- x402Versions: Array.from(this.registeredClientSchemes.keys()),
220
- networks: Array.from(clientSchemesByNetwork.keys()),
221
- schemes: Array.from(clientSchemesByNetwork.values()).map((schemes) => Array.from(schemes.keys())).flat()
222
- })}`);
223
- }
224
- let filteredRequirements = supportedPaymentRequirements;
225
- for (const policy of this.policies) {
226
- filteredRequirements = policy(x402Version2, filteredRequirements);
227
- if (filteredRequirements.length === 0) {
228
- throw new Error(`All payment requirements were filtered out by policies for x402 version: ${x402Version2}`);
229
- }
230
- }
231
- return this.paymentRequirementsSelector(x402Version2, filteredRequirements);
232
- }
233
- /**
234
- * Internal method to register a scheme client.
235
- *
236
- * @param x402Version - The x402 protocol version
237
- * @param network - The network to register the client for
238
- * @param client - The scheme network client to register
239
- * @returns The x402Client instance for chaining
240
- */
241
- _registerScheme(x402Version2, network, client) {
242
- if (!this.registeredClientSchemes.has(x402Version2)) {
243
- this.registeredClientSchemes.set(x402Version2, /* @__PURE__ */ new Map());
244
- }
245
- const clientSchemesByNetwork = this.registeredClientSchemes.get(x402Version2);
246
- if (!clientSchemesByNetwork.has(network)) {
247
- clientSchemesByNetwork.set(network, /* @__PURE__ */ new Map());
248
- }
249
- const clientByScheme = clientSchemesByNetwork.get(network);
250
- if (!clientByScheme.has(client.scheme)) {
251
- clientByScheme.set(client.scheme, client);
252
- }
253
- return this;
254
- }
255
- };
256
- export {
257
- x402Client,
258
- x402HTTPClient
259
- };
260
- //# sourceMappingURL=index.mjs.map
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../../../src/client/x402Client.ts"],"sourcesContent":["import { x402Version } from \"..\";\nimport { SchemeNetworkClient } from \"../types/mechanisms\";\nimport { PaymentPayload, PaymentRequirements } from \"../types/payments\";\nimport { Network, PaymentRequired } from \"../types\";\nimport { findByNetworkAndScheme, findSchemesByNetwork } from \"../utils\";\n\n/**\n * Client Hook Context Interfaces\n */\n\nexport interface PaymentCreationContext {\n paymentRequired: PaymentRequired;\n selectedRequirements: PaymentRequirements;\n}\n\nexport interface PaymentCreatedContext extends PaymentCreationContext {\n paymentPayload: PaymentPayload;\n}\n\nexport interface PaymentCreationFailureContext extends PaymentCreationContext {\n error: Error;\n}\n\n/**\n * Client Hook Type Definitions\n */\n\nexport type BeforePaymentCreationHook = (\n context: PaymentCreationContext,\n) => Promise<void | { abort: true; reason: string }>;\n\nexport type AfterPaymentCreationHook = (context: PaymentCreatedContext) => Promise<void>;\n\nexport type OnPaymentCreationFailureHook = (\n context: PaymentCreationFailureContext,\n) => Promise<void | { recovered: true; payload: PaymentPayload }>;\n\nexport type SelectPaymentRequirements = (x402Version: number, paymentRequirements: PaymentRequirements[]) => PaymentRequirements;\n\n/**\n * A policy function that filters or transforms payment requirements.\n * Policies are applied in order before the selector chooses the final option.\n *\n * @param x402Version - The x402 protocol version\n * @param paymentRequirements - Array of payment requirements to filter/transform\n * @returns Filtered array of payment requirements\n */\nexport type PaymentPolicy = (x402Version: number, paymentRequirements: PaymentRequirements[]) => PaymentRequirements[];\n\n\n/**\n * Configuration for registering a payment scheme with a specific network\n */\nexport interface SchemeRegistration {\n /**\n * The network identifier (e.g., 'eip155:8453', 'solana:mainnet')\n */\n network: Network;\n\n /**\n * The scheme client implementation for this network\n */\n client: SchemeNetworkClient;\n\n /**\n * The x402 protocol version to use for this scheme\n *\n * @default 2\n */\n x402Version?: number;\n}\n\n/**\n * Configuration options for the fetch wrapper\n */\nexport interface x402ClientConfig {\n /**\n * Array of scheme registrations defining which payment methods are supported\n */\n schemes: SchemeRegistration[];\n\n /**\n * Policies to apply to the client\n */\n policies?: PaymentPolicy[];\n\n /**\n * Custom payment requirements selector function\n * If not provided, uses the default selector (first available option)\n */\n paymentRequirementsSelector?: SelectPaymentRequirements;\n}\n\n/**\n * Core client for managing x402 payment schemes and creating payment payloads.\n *\n * Handles registration of payment schemes, policy-based filtering of payment requirements,\n * and creation of payment payloads based on server requirements.\n */\nexport class x402Client {\n private readonly paymentRequirementsSelector: SelectPaymentRequirements;\n private readonly registeredClientSchemes: Map<number, Map<string, Map<string, SchemeNetworkClient>>> = new Map();\n private readonly policies: PaymentPolicy[] = [];\n\n private beforePaymentCreationHooks: BeforePaymentCreationHook[] = [];\n private afterPaymentCreationHooks: AfterPaymentCreationHook[] = [];\n private onPaymentCreationFailureHooks: OnPaymentCreationFailureHook[] = [];\n\n /**\n * Creates a new x402Client instance.\n *\n * @param paymentRequirementsSelector - Function to select payment requirements from available options\n */\n constructor(paymentRequirementsSelector?: SelectPaymentRequirements) {\n this.paymentRequirementsSelector = paymentRequirementsSelector || ((x402Version, accepts) => accepts[0]);\n }\n\n /**\n * Creates a new x402Client instance from a configuration object.\n *\n * @param config - The client configuration including schemes, policies, and payment requirements selector\n * @returns A configured x402Client instance\n */\n static fromConfig(config: x402ClientConfig): x402Client {\n const client = new x402Client(config.paymentRequirementsSelector);\n config.schemes.forEach(scheme => {\n if (scheme.x402Version === 1) {\n client.registerV1(scheme.network, scheme.client);\n } else {\n client.register(scheme.network, scheme.client);\n }\n });\n config.policies?.forEach(policy => {\n client.registerPolicy(policy);\n });\n return client;\n }\n\n /**\n * Registers a scheme client for the current x402 version.\n *\n * @param network - The network to register the client for\n * @param client - The scheme network client to register\n * @returns The x402Client instance for chaining\n */\n register(network: Network, client: SchemeNetworkClient): x402Client {\n return this._registerScheme(x402Version, network, client);\n }\n\n /**\n * Registers a scheme client for x402 version 1.\n *\n * @param network - The v1 network identifier (e.g., 'base-sepolia', 'solana-devnet')\n * @param client - The scheme network client to register\n * @returns The x402Client instance for chaining\n */\n registerV1(network: string, client: SchemeNetworkClient): x402Client {\n return this._registerScheme(1, network as Network, client);\n }\n\n /**\n * Registers a policy to filter or transform payment requirements.\n *\n * Policies are applied in order after filtering by registered schemes\n * and before the selector chooses the final payment requirement.\n *\n * @param policy - Function to filter/transform payment requirements\n * @returns The x402Client instance for chaining\n *\n * @example\n * ```typescript\n * // Prefer cheaper options\n * client.registerPolicy((version, reqs) =>\n * reqs.filter(r => BigInt(r.value) < BigInt('1000000'))\n * );\n *\n * // Prefer specific networks\n * client.registerPolicy((version, reqs) =>\n * reqs.filter(r => r.network.startsWith('eip155:'))\n * );\n * ```\n */\n registerPolicy(policy: PaymentPolicy): x402Client {\n this.policies.push(policy);\n return this;\n }\n\n /**\n * Register a hook to execute before payment payload creation.\n * Can abort creation by returning { abort: true, reason: string }\n *\n * @param hook - The hook function to register\n * @returns The x402Client instance for chaining\n */\n onBeforePaymentCreation(hook: BeforePaymentCreationHook): x402Client {\n this.beforePaymentCreationHooks.push(hook);\n return this;\n }\n\n /**\n * Register a hook to execute after successful payment payload creation.\n *\n * @param hook - The hook function to register\n * @returns The x402Client instance for chaining\n */\n onAfterPaymentCreation(hook: AfterPaymentCreationHook): x402Client {\n this.afterPaymentCreationHooks.push(hook);\n return this;\n }\n\n /**\n * Register a hook to execute when payment payload creation fails.\n * Can recover from failure by returning { recovered: true, payload: PaymentPayload }\n *\n * @param hook - The hook function to register\n * @returns The x402Client instance for chaining\n */\n onPaymentCreationFailure(hook: OnPaymentCreationFailureHook): x402Client {\n this.onPaymentCreationFailureHooks.push(hook);\n return this;\n }\n\n /**\n * Creates a payment payload based on a PaymentRequired response.\n *\n * Automatically extracts x402Version, resource, and extensions from the PaymentRequired\n * response and constructs a complete PaymentPayload with the accepted requirements.\n *\n * @param paymentRequired - The PaymentRequired response from the server\n * @returns Promise resolving to the complete payment payload\n */\n async createPaymentPayload(\n paymentRequired: PaymentRequired,\n ): Promise<PaymentPayload> {\n const clientSchemesByNetwork = this.registeredClientSchemes.get(paymentRequired.x402Version);\n if (!clientSchemesByNetwork) {\n throw new Error(`No client registered for x402 version: ${paymentRequired.x402Version}`);\n }\n\n const requirements = this.selectPaymentRequirements(paymentRequired.x402Version, paymentRequired.accepts);\n\n const context: PaymentCreationContext = {\n paymentRequired,\n selectedRequirements: requirements,\n };\n\n // Execute beforePaymentCreation hooks\n for (const hook of this.beforePaymentCreationHooks) {\n const result = await hook(context);\n if (result && \"abort\" in result && result.abort) {\n throw new Error(`Payment creation aborted: ${result.reason}`);\n }\n }\n\n try {\n const schemeNetworkClient = findByNetworkAndScheme(clientSchemesByNetwork, requirements.scheme, requirements.network);\n if (!schemeNetworkClient) {\n throw new Error(`No client registered for scheme: ${requirements.scheme} and network: ${requirements.network}`);\n }\n\n const partialPayload = await schemeNetworkClient.createPaymentPayload(paymentRequired.x402Version, requirements);\n\n let paymentPayload: PaymentPayload;\n if (partialPayload.x402Version == 1) {\n paymentPayload = partialPayload as PaymentPayload;\n } else {\n paymentPayload = {\n ...partialPayload,\n extensions: paymentRequired.extensions,\n resource: paymentRequired.resource,\n accepted: requirements,\n };\n }\n\n // Execute afterPaymentCreation hooks\n const createdContext: PaymentCreatedContext = {\n ...context,\n paymentPayload,\n };\n\n for (const hook of this.afterPaymentCreationHooks) {\n await hook(createdContext);\n }\n\n return paymentPayload;\n } catch (error) {\n const failureContext: PaymentCreationFailureContext = {\n ...context,\n error: error as Error,\n };\n\n // Execute onPaymentCreationFailure hooks\n for (const hook of this.onPaymentCreationFailureHooks) {\n const result = await hook(failureContext);\n if (result && \"recovered\" in result && result.recovered) {\n return result.payload;\n }\n }\n\n throw error;\n }\n }\n\n\n\n /**\n * Selects appropriate payment requirements based on registered clients and policies.\n *\n * Selection process:\n * 1. Filter by registered schemes (network + scheme support)\n * 2. Apply all registered policies in order\n * 3. Use selector to choose final requirement\n *\n * @param x402Version - The x402 protocol version\n * @param paymentRequirements - Array of available payment requirements\n * @returns The selected payment requirements\n */\n private selectPaymentRequirements(x402Version: number, paymentRequirements: PaymentRequirements[]): PaymentRequirements {\n const clientSchemesByNetwork = this.registeredClientSchemes.get(x402Version);\n if (!clientSchemesByNetwork) {\n throw new Error(`No client registered for x402 version: ${x402Version}`);\n }\n\n // Step 1: Filter by registered schemes\n const supportedPaymentRequirements = paymentRequirements.filter(requirement => {\n let clientSchemes = findSchemesByNetwork(clientSchemesByNetwork, requirement.network);\n if (!clientSchemes) {\n return false;\n }\n\n return clientSchemes.has(requirement.scheme);\n })\n\n if (supportedPaymentRequirements.length === 0) {\n throw new Error(`No network/scheme registered for x402 version: ${x402Version} which comply with the payment requirements. ${JSON.stringify({\n x402Version,\n paymentRequirements,\n x402Versions: Array.from(this.registeredClientSchemes.keys()),\n networks: Array.from(clientSchemesByNetwork.keys()),\n schemes: Array.from(clientSchemesByNetwork.values()).map(schemes => Array.from(schemes.keys())).flat(),\n })}`);\n }\n\n // Step 2: Apply all policies in order\n let filteredRequirements = supportedPaymentRequirements;\n for (const policy of this.policies) {\n filteredRequirements = policy(x402Version, filteredRequirements);\n\n if (filteredRequirements.length === 0) {\n throw new Error(`All payment requirements were filtered out by policies for x402 version: ${x402Version}`);\n }\n }\n\n // Step 3: Use selector to choose final requirement\n return this.paymentRequirementsSelector(x402Version, filteredRequirements);\n }\n\n /**\n * Internal method to register a scheme client.\n *\n * @param x402Version - The x402 protocol version\n * @param network - The network to register the client for\n * @param client - The scheme network client to register\n * @returns The x402Client instance for chaining\n */\n private _registerScheme(x402Version: number, network: Network, client: SchemeNetworkClient): x402Client {\n if (!this.registeredClientSchemes.has(x402Version)) {\n this.registeredClientSchemes.set(x402Version, new Map());\n }\n const clientSchemesByNetwork = this.registeredClientSchemes.get(x402Version)!;\n if (!clientSchemesByNetwork.has(network)) {\n clientSchemesByNetwork.set(network, new Map());\n }\n\n const clientByScheme = clientSchemesByNetwork.get(network)!;\n if (!clientByScheme.has(client.scheme)) {\n clientByScheme.set(client.scheme, client);\n }\n\n return this;\n }\n}\n"],"mappings":"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","names":["x402Version"]}
@@ -1,37 +0,0 @@
1
- export { E as ExactSvmScheme } from '../../scheme-fjF-9LhT.mjs';
2
- import { x402Client, SelectPaymentRequirements, PaymentPolicy } from '@x402/core/client';
3
- import { Network } from '@x402/core/types';
4
- import { C as ClientSvmSigner } from '../../signer-BMkbhFYE.mjs';
5
- import '@solana/kit';
6
-
7
- /**
8
- * Configuration options for registering SVM schemes to an x402Client
9
- */
10
- interface SvmClientConfig {
11
- /**
12
- * The SVM signer to use for creating payment payloads
13
- */
14
- signer: ClientSvmSigner;
15
- /**
16
- * Optional payment requirements selector function
17
- */
18
- paymentRequirementsSelector?: SelectPaymentRequirements;
19
- /**
20
- * Optional policies to apply to the client
21
- */
22
- policies?: PaymentPolicy[];
23
- /**
24
- * Optional specific networks to register
25
- */
26
- networks?: Network[];
27
- }
28
- /**
29
- * Registers SVM payment schemes to an existing x402Client instance.
30
- *
31
- * @param client - The x402Client instance to register schemes to
32
- * @param config - Configuration for SVM client registration
33
- * @returns The client instance for chaining
34
- */
35
- declare function registerExactSvmScheme(client: x402Client, config: SvmClientConfig): x402Client;
36
-
37
- export { type SvmClientConfig, registerExactSvmScheme };
@@ -1,36 +0,0 @@
1
- import {
2
- ExactSvmScheme
3
- } from "../../chunk-PNSAJQCF.mjs";
4
- import {
5
- NETWORKS
6
- } from "../../chunk-WWACQNRQ.mjs";
7
- import {
8
- ExactSvmSchemeV1
9
- } from "../../chunk-EEA7DKZI.mjs";
10
- import "../../chunk-3CEIVWNN.mjs";
11
- import "../../chunk-IKSTWKEM.mjs";
12
-
13
- // src/exact/client/register.ts
14
- function registerExactSvmScheme(client, config) {
15
- if (config.networks && config.networks.length > 0) {
16
- config.networks.forEach((network) => {
17
- client.register(network, new ExactSvmScheme(config.signer));
18
- });
19
- } else {
20
- client.register("solana:*", new ExactSvmScheme(config.signer));
21
- }
22
- NETWORKS.forEach((network) => {
23
- client.registerV1(network, new ExactSvmSchemeV1(config.signer));
24
- });
25
- if (config.policies) {
26
- config.policies.forEach((policy) => {
27
- client.registerPolicy(policy);
28
- });
29
- }
30
- return client;
31
- }
32
- export {
33
- ExactSvmScheme,
34
- registerExactSvmScheme
35
- };
36
- //# sourceMappingURL=index.mjs.map
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../../../../src/exact/client/register.ts"],"sourcesContent":["import { x402Client, SelectPaymentRequirements, PaymentPolicy } from \"@x402/core/client\";\nimport { Network } from \"@x402/core/types\";\nimport { ClientSvmSigner } from \"../../signer\";\nimport { ExactSvmScheme } from \"./scheme\";\nimport { ExactSvmSchemeV1 } from \"../v1/client/scheme\";\nimport { NETWORKS } from \"../../v1\";\n\n/**\n * Configuration options for registering SVM schemes to an x402Client\n */\nexport interface SvmClientConfig {\n /**\n * The SVM signer to use for creating payment payloads\n */\n signer: ClientSvmSigner;\n\n /**\n * Optional payment requirements selector function\n */\n paymentRequirementsSelector?: SelectPaymentRequirements;\n\n /**\n * Optional policies to apply to the client\n */\n policies?: PaymentPolicy[];\n\n /**\n * Optional specific networks to register\n */\n networks?: Network[];\n}\n\n/**\n * Registers SVM payment schemes to an existing x402Client instance.\n *\n * @param client - The x402Client instance to register schemes to\n * @param config - Configuration for SVM client registration\n * @returns The client instance for chaining\n */\nexport function registerExactSvmScheme(client: x402Client, config: SvmClientConfig): x402Client {\n // Register V2 scheme\n if (config.networks && config.networks.length > 0) {\n config.networks.forEach(network => {\n client.register(network, new ExactSvmScheme(config.signer));\n });\n } else {\n client.register(\"solana:*\", new ExactSvmScheme(config.signer));\n }\n\n // Register all V1 networks\n NETWORKS.forEach(network => {\n client.registerV1(network as Network, new ExactSvmSchemeV1(config.signer));\n });\n\n if (config.policies) {\n config.policies.forEach(policy => {\n client.registerPolicy(policy);\n });\n }\n\n return client;\n}\n"],"mappings":";;;;;;;;;;;;;AAuCO,SAAS,uBAAuB,QAAoB,QAAqC;AAE9F,MAAI,OAAO,YAAY,OAAO,SAAS,SAAS,GAAG;AACjD,WAAO,SAAS,QAAQ,aAAW;AACjC,aAAO,SAAS,SAAS,IAAI,eAAe,OAAO,MAAM,CAAC;AAAA,IAC5D,CAAC;AAAA,EACH,OAAO;AACL,WAAO,SAAS,YAAY,IAAI,eAAe,OAAO,MAAM,CAAC;AAAA,EAC/D;AAGA,WAAS,QAAQ,aAAW;AAC1B,WAAO,WAAW,SAAoB,IAAI,iBAAiB,OAAO,MAAM,CAAC;AAAA,EAC3E,CAAC;AAED,MAAI,OAAO,UAAU;AACnB,WAAO,SAAS,QAAQ,YAAU;AAChC,aAAO,eAAe,MAAM;AAAA,IAC9B,CAAC;AAAA,EACH;AAEA,SAAO;AACT;","names":[]}
@@ -1,110 +0,0 @@
1
- import { SchemeNetworkFacilitator, PaymentPayload, PaymentRequirements, VerifyResponse, SettleResponse, Network } from '@x402/core/types';
2
- import { F as FacilitatorSvmSigner } from '../../signer-BMkbhFYE.mjs';
3
- import { x402Facilitator } from '@x402/core/facilitator';
4
- import '@solana/kit';
5
-
6
- /**
7
- * SVM facilitator implementation for the Exact payment scheme.
8
- */
9
- declare class ExactSvmScheme implements SchemeNetworkFacilitator {
10
- private readonly signer;
11
- readonly scheme = "exact";
12
- readonly caipFamily = "solana:*";
13
- /**
14
- * Creates a new ExactSvmFacilitator instance.
15
- *
16
- * @param signer - The SVM RPC client for facilitator operations
17
- * @returns ExactSvmFacilitator instance
18
- */
19
- constructor(signer: FacilitatorSvmSigner);
20
- /**
21
- * Get mechanism-specific extra data for the supported kinds endpoint.
22
- * For SVM, this includes a randomly selected fee payer address.
23
- * Random selection distributes load across multiple signers.
24
- *
25
- * @param _ - The network identifier (unused for SVM)
26
- * @returns Extra data with feePayer address
27
- */
28
- getExtra(_: string): Record<string, unknown> | undefined;
29
- /**
30
- * Get signer addresses used by this facilitator.
31
- * For SVM, returns all available fee payer addresses.
32
- *
33
- * @param _ - The network identifier (unused for SVM)
34
- * @returns Array of fee payer addresses
35
- */
36
- getSigners(_: string): string[];
37
- /**
38
- * Verifies a payment payload.
39
- *
40
- * @param payload - The payment payload to verify
41
- * @param requirements - The payment requirements
42
- * @returns Promise resolving to verification response
43
- */
44
- verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
45
- /**
46
- * Settles a payment by submitting the transaction.
47
- * Ensures the correct signer is used based on the feePayer specified in requirements.
48
- *
49
- * @param payload - The payment payload to settle
50
- * @param requirements - The payment requirements
51
- * @returns Promise resolving to settlement response
52
- */
53
- settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
54
- /**
55
- * Verify that the compute limit instruction is valid.
56
- *
57
- * @param instruction - The compute limit instruction
58
- * @param instruction.programAddress - Program address
59
- * @param instruction.data - Instruction data bytes
60
- */
61
- private verifyComputeLimitInstruction;
62
- /**
63
- * Verify that the compute price instruction is valid.
64
- *
65
- * @param instruction - The compute price instruction
66
- * @param instruction.programAddress - Program address
67
- * @param instruction.data - Instruction data bytes
68
- */
69
- private verifyComputePriceInstruction;
70
- }
71
-
72
- /**
73
- * Configuration options for registering SVM schemes to an x402Facilitator
74
- */
75
- interface SvmFacilitatorConfig {
76
- /**
77
- * The SVM signer for facilitator operations
78
- */
79
- signer: FacilitatorSvmSigner;
80
- /**
81
- * Networks to register (single network or array of networks)
82
- * Examples: "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1", ["solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1", "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]
83
- */
84
- networks: Network | Network[];
85
- }
86
- /**
87
- * Registers SVM payment schemes to an existing x402Facilitator instance.
88
- *
89
- * @param facilitator - The x402Facilitator instance to register schemes to
90
- * @param config - Configuration for SVM facilitator registration
91
- * @returns The facilitator instance for chaining
92
- *
93
- * @example
94
- * ```typescript
95
- * // Single network
96
- * registerExactSvmScheme(facilitator, {
97
- * signer: svmSigner,
98
- * networks: "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1" // Devnet
99
- * });
100
- *
101
- * // Multiple networks (will auto-derive solana:* pattern)
102
- * registerExactSvmScheme(facilitator, {
103
- * signer: svmSigner,
104
- * networks: ["solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1", "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]
105
- * });
106
- * ```
107
- */
108
- declare function registerExactSvmScheme(facilitator: x402Facilitator, config: SvmFacilitatorConfig): x402Facilitator;
109
-
110
- export { ExactSvmScheme, type SvmFacilitatorConfig, registerExactSvmScheme };