@routedock/routedock 0.1.2 → 0.2.0

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 (74) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +227 -4
  3. package/dist/MppSessionHandler-B4TyD7Xg.d.cts +121 -0
  4. package/dist/MppSessionHandler-CLB5SzgN.d.ts +121 -0
  5. package/dist/ProviderRegistry-BJ9oJLVz.d.cts +142 -0
  6. package/dist/ProviderRegistry-C50nyhaF.d.ts +142 -0
  7. package/dist/RouteDockClient-B1roCa8h.d.cts +455 -0
  8. package/dist/RouteDockClient-BbkqjhMG.d.ts +455 -0
  9. package/dist/SessionReconciler-Dscw43F3.d.ts +125 -0
  10. package/dist/SessionReconciler-bi0z2qtN.d.cts +125 -0
  11. package/dist/SessionStore-BpK8vv0L.d.cts +111 -0
  12. package/dist/SessionStore-DvkZv8-E.d.ts +111 -0
  13. package/dist/client.cjs +2419 -202
  14. package/dist/client.d.cts +50 -81
  15. package/dist/client.d.ts +50 -81
  16. package/dist/client.js +2373 -203
  17. package/dist/index.cjs +3080 -298
  18. package/dist/index.d.cts +12 -3
  19. package/dist/index.d.ts +12 -3
  20. package/dist/index.js +3026 -298
  21. package/dist/provider/fastify.cjs +882 -0
  22. package/dist/provider/fastify.d.cts +35 -0
  23. package/dist/provider/fastify.d.ts +35 -0
  24. package/dist/provider/fastify.js +880 -0
  25. package/dist/provider/hono.cjs +948 -0
  26. package/dist/provider/hono.d.cts +99 -0
  27. package/dist/provider/hono.d.ts +99 -0
  28. package/dist/provider/hono.js +938 -0
  29. package/dist/provider.cjs +827 -97
  30. package/dist/provider.d.cts +32 -25
  31. package/dist/provider.d.ts +32 -25
  32. package/dist/provider.js +810 -99
  33. package/dist/react.cjs +2641 -0
  34. package/dist/react.d.cts +107 -0
  35. package/dist/react.d.ts +107 -0
  36. package/dist/react.js +2634 -0
  37. package/dist/routedockMiddleware-BlDsHuPl.d.ts +59 -0
  38. package/dist/routedockMiddleware-D97A5ptQ.d.cts +59 -0
  39. package/dist/schema.cjs +364 -0
  40. package/dist/schema.d.cts +3 -0
  41. package/dist/schema.d.ts +3 -0
  42. package/dist/schema.js +359 -0
  43. package/dist/sign-CUf3rhTx.d.cts +53 -0
  44. package/dist/sign-Dpj2Mp7k.d.ts +53 -0
  45. package/dist/testing.cjs +57 -0
  46. package/dist/testing.d.cts +95 -0
  47. package/dist/testing.d.ts +95 -0
  48. package/dist/testing.js +54 -0
  49. package/dist/types-DmhmfLzP.d.cts +410 -0
  50. package/dist/types-DmhmfLzP.d.ts +410 -0
  51. package/package.json +143 -23
  52. package/PUBLISH_CHECKLIST.md +0 -70
  53. package/dist/SessionStore-CCVO0PHM.d.cts +0 -152
  54. package/dist/SessionStore-CCVO0PHM.d.ts +0 -152
  55. package/dist/routedockMiddleware-B7WTB3LT.d.cts +0 -53
  56. package/dist/routedockMiddleware-DRgdrycG.d.ts +0 -53
  57. package/src/client/ModeRouter.ts +0 -104
  58. package/src/client/MppChargeClient.ts +0 -44
  59. package/src/client/MppSessionClient.ts +0 -144
  60. package/src/client/RouteDockClient.ts +0 -124
  61. package/src/client/index.ts +0 -8
  62. package/src/client/x402Client.ts +0 -84
  63. package/src/index.ts +0 -9
  64. package/src/provider/MppChargeHandler.ts +0 -90
  65. package/src/provider/MppSessionHandler.ts +0 -157
  66. package/src/provider/index.ts +0 -7
  67. package/src/provider/routedockMiddleware.ts +0 -154
  68. package/src/provider/x402Handler.ts +0 -164
  69. package/src/schemas/routedock.schema.json +0 -159
  70. package/src/store/SessionStore.ts +0 -90
  71. package/src/tests/smoke.test.ts +0 -228
  72. package/src/types.ts +0 -165
  73. package/tsconfig.json +0 -14
  74. package/tsup.config.ts +0 -15
@@ -0,0 +1,880 @@
1
+ import { Keypair, StrKey, Contract, nativeToScVal, TransactionBuilder, BASE_FEE } from '@stellar/stellar-sdk';
2
+ import { ExactStellarScheme } from '@x402/stellar/exact/facilitator';
3
+ import { ExactStellarScheme as ExactStellarScheme$1 } from '@x402/stellar/exact/server';
4
+ import { HTTPFacilitatorClient, x402ResourceServer } from '@x402/core/server';
5
+ import { createEd25519Signer } from '@x402/stellar';
6
+ import { encodePaymentRequiredHeader, decodePaymentSignatureHeader, encodePaymentResponseHeader } from '@x402/core/http';
7
+ import { usdcToStroops } from '@routedock/nulth-sdk';
8
+ import { stellar } from '@stellar/mpp/charge/server';
9
+ import { Mppx, Request } from 'mppx/server';
10
+ import { Store, stellar as stellar$1, close } from '@stellar/mpp/channel/server';
11
+ import { Errors } from 'mppx';
12
+ import { createHash } from 'crypto';
13
+
14
+ // src/provider/x402Handler.ts
15
+
16
+ // src/provider/payee.ts
17
+ function resolvePayee(manifest, mode) {
18
+ const override = manifest.pricing[mode]?.payee;
19
+ return override ?? manifest.payee;
20
+ }
21
+ var usdcToUnits = usdcToStroops;
22
+ function extractPayerAddress(key) {
23
+ if (typeof key !== "string") return null;
24
+ return StrKey.isValidEd25519PublicKey(key) || StrKey.isValidMed25519PublicKey(key) ? key : null;
25
+ }
26
+
27
+ // src/provider/SeenTxStore.ts
28
+ var InMemorySeenTxStore = class {
29
+ map = /* @__PURE__ */ new Map();
30
+ order = [];
31
+ constructor(maxEntriesOrOptions = 1e4) {
32
+ const options = typeof maxEntriesOrOptions === "number" ? { maxEntries: maxEntriesOrOptions } : maxEntriesOrOptions;
33
+ this.maxEntries = options.maxEntries ?? 1e4;
34
+ if (options.warn !== false) {
35
+ const isServerless = typeof globalThis.navigator !== "undefined" && globalThis.navigator.userAgent === "Cloudflare-Workers";
36
+ if (isServerless) {
37
+ console.warn(
38
+ "[RouteDock] Using in-memory SeenTxStore: settlement deduplication is NOT durable and resets on every isolate restart. Supply a SupabaseSeenTxStore (or other durable SeenTxStore) for production safety."
39
+ );
40
+ }
41
+ }
42
+ }
43
+ maxEntries;
44
+ get(key) {
45
+ return this.map.get(key);
46
+ }
47
+ set(key, record) {
48
+ if (!this.map.has(key)) {
49
+ this.order.push(key);
50
+ if (this.order.length > this.maxEntries) {
51
+ const evicted = this.order.shift();
52
+ if (evicted !== void 0) this.map.delete(evicted);
53
+ }
54
+ }
55
+ this.map.set(key, record);
56
+ }
57
+ };
58
+ async function sha256Hex(input) {
59
+ const buf = new TextEncoder().encode(input);
60
+ const digest = await crypto.subtle.digest("SHA-256", buf);
61
+ return Array.from(new Uint8Array(digest)).map((b) => b.toString(16).padStart(2, "0")).join("");
62
+ }
63
+ async function paymentIdempotencyKey(getHeader) {
64
+ const material = getHeader("payment-signature") ?? getHeader("x-payment") ?? getHeader("authorization");
65
+ if (!material) return null;
66
+ return sha256Hex(material);
67
+ }
68
+
69
+ // src/provider/x402Handler.ts
70
+ var CAIP2 = {
71
+ testnet: "stellar:testnet",
72
+ mainnet: "stellar:pubnet"
73
+ };
74
+ var OZ_FACILITATOR_URL = "https://channels.openzeppelin.com/x402";
75
+ function createX402Handler(opts) {
76
+ const caip2 = CAIP2[opts.network];
77
+ const payeeKeypair = Keypair.fromSecret(opts.payeeSecretKey);
78
+ const signer = createEd25519Signer(opts.payeeSecretKey, caip2);
79
+ const seenTxStore = opts.seenTxStore ?? new InMemorySeenTxStore();
80
+ const useOzFacilitator = opts.network === "mainnet" && opts.facilitatorApiKey;
81
+ const localFacilitator = new ExactStellarScheme([signer], {
82
+ areFeesSponsored: true
83
+ });
84
+ let ozServer = null;
85
+ if (useOzFacilitator) {
86
+ const apiKey = opts.facilitatorApiKey;
87
+ const facilitator = new HTTPFacilitatorClient({
88
+ url: OZ_FACILITATOR_URL,
89
+ createAuthHeaders: async () => ({
90
+ verify: { Authorization: `Bearer ${apiKey}` },
91
+ settle: { Authorization: `Bearer ${apiKey}` },
92
+ supported: { Authorization: `Bearer ${apiKey}` }
93
+ })
94
+ });
95
+ ozServer = new x402ResourceServer(facilitator);
96
+ ozServer.register(caip2, new ExactStellarScheme$1());
97
+ }
98
+ const amountInBaseUnits = String(usdcToUnits(opts.amount));
99
+ const payTo = resolvePayee(opts.manifest, "x402");
100
+ const requirements = {
101
+ scheme: "exact",
102
+ network: caip2,
103
+ asset: opts.assetContract,
104
+ amount: amountInBaseUnits,
105
+ payTo,
106
+ maxTimeoutSeconds: 60,
107
+ extra: {
108
+ areFeesSponsored: true,
109
+ ...useOzFacilitator ? {} : { facilitatorAddresses: [payeeKeypair.publicKey()] }
110
+ }
111
+ };
112
+ return async (req, res, next) => {
113
+ try {
114
+ const paymentHeader = req.headers["payment-signature"] ?? req.headers["x-payment"];
115
+ if (!paymentHeader) {
116
+ if (ozServer) {
117
+ const resourceInfo = {
118
+ url: `${req.protocol}://${req.get("host") ?? ""}${req.originalUrl}`,
119
+ description: opts.manifest.name
120
+ };
121
+ const paymentRequired = await ozServer.createPaymentRequiredResponse(
122
+ [requirements],
123
+ resourceInfo
124
+ );
125
+ res.status(402).setHeader("Content-Type", "application/json").setHeader("X-Payment-Requirements", encodePaymentRequiredHeader(paymentRequired)).json({ error: "Payment Required" });
126
+ } else {
127
+ const x402Response = {
128
+ x402Version: 2,
129
+ resource: {
130
+ url: `${req.protocol}://${req.get("host") ?? ""}${req.originalUrl}`,
131
+ description: opts.manifest.name
132
+ },
133
+ accepts: [requirements]
134
+ };
135
+ res.status(402).setHeader("Content-Type", "application/json").setHeader("X-Payment-Requirements", encodePaymentRequiredHeader(x402Response)).json({ error: "Payment Required" });
136
+ }
137
+ return;
138
+ }
139
+ const idempotencyKey = await paymentIdempotencyKey((name) => {
140
+ const v = req.headers[name.toLowerCase()];
141
+ return Array.isArray(v) ? v[0] : v;
142
+ });
143
+ if (idempotencyKey) {
144
+ const cached = await seenTxStore.get(idempotencyKey);
145
+ if (cached) {
146
+ if (cached.headers) {
147
+ for (const [k, val] of Object.entries(cached.headers)) {
148
+ res.setHeader(k, val);
149
+ }
150
+ }
151
+ next();
152
+ return;
153
+ }
154
+ }
155
+ const payload = decodePaymentSignatureHeader(paymentHeader);
156
+ let txHash = null;
157
+ let payerAddress = null;
158
+ try {
159
+ const creds = payload.authorization?.credentials;
160
+ const key = Array.isArray(creds) ? creds[0]?.publicKey : void 0;
161
+ payerAddress = extractPayerAddress(key);
162
+ } catch {
163
+ }
164
+ if (ozServer) {
165
+ const settleResult = await ozServer.settlePayment(payload, requirements);
166
+ txHash = settleResult.transaction ?? null;
167
+ if (settleResult) {
168
+ res.setHeader(
169
+ "X-Payment-Response",
170
+ encodePaymentResponseHeader(
171
+ settleResult
172
+ )
173
+ );
174
+ }
175
+ } else {
176
+ const verifyResult = await localFacilitator.verify(
177
+ payload,
178
+ requirements
179
+ );
180
+ if (!verifyResult.isValid) {
181
+ res.status(401).json({
182
+ error: "Payment verification failed",
183
+ reason: verifyResult.invalidReason
184
+ });
185
+ return;
186
+ }
187
+ const settleResult = await localFacilitator.settle(
188
+ payload,
189
+ requirements
190
+ );
191
+ txHash = settleResult.transaction ?? null;
192
+ if (settleResult) {
193
+ res.setHeader(
194
+ "X-Payment-Response",
195
+ encodePaymentResponseHeader(
196
+ settleResult
197
+ )
198
+ );
199
+ }
200
+ }
201
+ if (idempotencyKey) {
202
+ const headers = {};
203
+ const paymentResponse = res.getHeader("X-Payment-Response");
204
+ if (typeof paymentResponse === "string") {
205
+ headers["X-Payment-Response"] = paymentResponse;
206
+ }
207
+ await seenTxStore.set(idempotencyKey, { txHash, headers });
208
+ }
209
+ if (txHash && opts.onSettled) {
210
+ Promise.resolve().then(() => opts.onSettled(txHash, opts.amount, "x402", payerAddress)).catch((err) => {
211
+ console.error("[x402] onSettled callback error:", err);
212
+ opts.onCallbackError?.(err, "onSettled");
213
+ });
214
+ }
215
+ next();
216
+ } catch (err) {
217
+ console.error("[x402] Settlement error:", err);
218
+ res.status(500).json({ error: "Payment settlement failed" });
219
+ }
220
+ };
221
+ }
222
+ var MPP_NETWORK = {
223
+ testnet: "stellar:testnet",
224
+ mainnet: "stellar:pubnet"
225
+ };
226
+ function createMppChargeHandler(opts) {
227
+ const networkId = MPP_NETWORK[opts.network];
228
+ const amountHumanReadable = opts.amount;
229
+ const recipient = resolvePayee(opts.manifest, "mpp-charge");
230
+ const seenTxStore = opts.seenTxStore ?? new InMemorySeenTxStore();
231
+ const mppx = Mppx.create({
232
+ secretKey: opts.payeeSecretKey,
233
+ methods: [
234
+ stellar.charge({
235
+ recipient,
236
+ currency: opts.assetContract,
237
+ network: networkId,
238
+ feePayer: { envelopeSigner: opts.payeeSecretKey }
239
+ })
240
+ ]
241
+ });
242
+ return async (req, res, next) => {
243
+ try {
244
+ let payerAddress = null;
245
+ try {
246
+ const authHeader = req.headers["authorization"];
247
+ if (typeof authHeader === "string" && authHeader.startsWith("Payment ")) {
248
+ const credPart = authHeader.replace(/^Payment\s+/, "").split(",").find((p) => p.trim().startsWith("credential="));
249
+ if (credPart) {
250
+ const b64 = credPart.split("=").slice(1).join("=").replace(/^"|"$/g, "");
251
+ const credJson = Buffer.from(b64, "base64").toString("utf8");
252
+ const cred = JSON.parse(credJson);
253
+ const key = cred.sender ?? cred.payload?.sender ?? cred.payload?.from;
254
+ payerAddress = extractPayerAddress(key);
255
+ }
256
+ }
257
+ } catch {
258
+ }
259
+ const idempotencyKey = await paymentIdempotencyKey((name) => {
260
+ const v = req.headers[name.toLowerCase()];
261
+ return Array.isArray(v) ? v[0] : v;
262
+ });
263
+ if (idempotencyKey) {
264
+ const cached = await seenTxStore.get(idempotencyKey);
265
+ if (cached) {
266
+ if (cached.headers) {
267
+ for (const [k, val] of Object.entries(cached.headers)) {
268
+ res.setHeader(k, val);
269
+ }
270
+ }
271
+ next();
272
+ return;
273
+ }
274
+ }
275
+ const fetchReq = Request.fromNodeListener(req, res);
276
+ const handler = mppx["stellar/charge"];
277
+ const result = await handler({
278
+ amount: amountHumanReadable,
279
+ currency: opts.assetContract,
280
+ recipient,
281
+ description: opts.manifest.name
282
+ })(fetchReq);
283
+ if (result.status === 402) {
284
+ const challenge = result.challenge;
285
+ res.status(402);
286
+ challenge.headers.forEach((v, k) => res.setHeader(k, v));
287
+ res.send(await challenge.text());
288
+ return;
289
+ }
290
+ const receipt = result.withReceipt(new Response(""));
291
+ const receiptHeaders = {};
292
+ receipt.headers.forEach((v, k) => {
293
+ res.setHeader(k, v);
294
+ receiptHeaders[k] = v;
295
+ });
296
+ const receiptHeader = receipt.headers.get("payment-receipt");
297
+ let reference;
298
+ if (receiptHeader) {
299
+ try {
300
+ const parsed = JSON.parse(
301
+ Buffer.from(receiptHeader, "base64").toString("utf8")
302
+ );
303
+ reference = parsed.reference;
304
+ } catch {
305
+ }
306
+ }
307
+ if (idempotencyKey) {
308
+ await seenTxStore.set(idempotencyKey, {
309
+ txHash: reference ?? null,
310
+ headers: receiptHeaders
311
+ });
312
+ }
313
+ if (reference && opts.onSettled) {
314
+ Promise.resolve().then(() => opts.onSettled(reference, opts.amount, "mpp-charge", payerAddress)).catch((err) => {
315
+ console.error("[mpp-charge] onSettled callback error:", err);
316
+ opts.onCallbackError?.(err, "onSettled");
317
+ });
318
+ }
319
+ next();
320
+ } catch (err) {
321
+ next(err);
322
+ }
323
+ };
324
+ }
325
+ function resolveVaultSettlementAddresses(payer, payee) {
326
+ if (!payer) return null;
327
+ return { payer, payee };
328
+ }
329
+ function buildSessionSettlementTransaction(source, vaultContractId, channelId, addresses, amount, voucherCount, networkPassphrase) {
330
+ const vault = new Contract(vaultContractId);
331
+ const op = vault.call(
332
+ "record_session_settlement",
333
+ nativeToScVal(channelId, { type: "address" }),
334
+ nativeToScVal(addresses.payer, { type: "address" }),
335
+ nativeToScVal(addresses.payee, { type: "address" }),
336
+ nativeToScVal(amount, { type: "i128" }),
337
+ nativeToScVal(voucherCount, { type: "u32" })
338
+ );
339
+ return new TransactionBuilder(source, {
340
+ fee: BASE_FEE,
341
+ networkPassphrase
342
+ }).addOperation(op).setTimeout(30).build();
343
+ }
344
+ function channelAuthorizer(envelopeSigner) {
345
+ return { envelopeSigner };
346
+ }
347
+ function formatMppError(error) {
348
+ if (error instanceof Error) return error.message;
349
+ if (typeof error === "string") return error;
350
+ try {
351
+ const serialized = JSON.stringify(error);
352
+ return serialized === void 0 ? String(error) : serialized;
353
+ } catch {
354
+ return String(error);
355
+ }
356
+ }
357
+ function withTypedChannelErrors(method) {
358
+ return {
359
+ ...method,
360
+ async verify(parameters) {
361
+ try {
362
+ return await method.verify(parameters);
363
+ } catch (error) {
364
+ throw mapChannelError(error);
365
+ }
366
+ }
367
+ };
368
+ }
369
+ function onVerifiedCredential(method, commit) {
370
+ return {
371
+ ...method,
372
+ async verify(parameters) {
373
+ const receipt = await method.verify(parameters);
374
+ await commit(parameters.credential);
375
+ return receipt;
376
+ }
377
+ };
378
+ }
379
+ function mapChannelError(error) {
380
+ const message = formatMppError(error);
381
+ const details = error && typeof error === "object" && "details" in error ? error.details : void 0;
382
+ const reason = details && Object.keys(details).length > 0 ? `${message} (${JSON.stringify(details)})` : message;
383
+ if (/signer mismatch|authori[sz]er|unauthori[sz]ed/i.test(message)) {
384
+ return new Errors.SignerMismatchError({ reason });
385
+ }
386
+ if (/already used|replay|challenge/i.test(message)) {
387
+ return new Errors.InvalidChallengeError({ reason });
388
+ }
389
+ if (/channel has been closed|channel is closed|finalized/i.test(message)) {
390
+ return new Errors.ChannelClosedError({ reason });
391
+ }
392
+ if (/exceeds channel balance|exceeds.*deposit/i.test(message)) {
393
+ return new Errors.AmountExceedsDepositError({ reason });
394
+ }
395
+ if (/channel not found|no channel/i.test(message)) {
396
+ return new Errors.ChannelNotFoundError({ reason });
397
+ }
398
+ if (/must be greater|does not cover|below.*minimum/i.test(message)) {
399
+ return new Errors.DeltaTooSmallError({ reason });
400
+ }
401
+ if (/signature/i.test(message)) {
402
+ return new Errors.InvalidSignatureError({ reason });
403
+ }
404
+ return new Errors.VerificationFailedError({ reason });
405
+ }
406
+
407
+ // src/provider/MppSessionHandler.ts
408
+ var MPP_NETWORK2 = {
409
+ testnet: "stellar:testnet",
410
+ mainnet: "stellar:pubnet"
411
+ };
412
+ function createMppSessionHandler(opts) {
413
+ const networkId = MPP_NETWORK2[opts.network];
414
+ const rateHuman = opts.rate;
415
+ const payeeKeypair = Keypair.fromSecret(opts.payeeSecretKey);
416
+ const voucherRecordKey = `routedock:session:voucher:${opts.channelFactory}`;
417
+ const innerStore = Store.memory();
418
+ let record = null;
419
+ let voucherCount = 0;
420
+ let sessionOpened = false;
421
+ let idleTimer = null;
422
+ let settledCleanly = false;
423
+ let closeListenerArmed = false;
424
+ function clearIdleTimer() {
425
+ if (idleTimer) {
426
+ clearTimeout(idleTimer);
427
+ idleTimer = null;
428
+ }
429
+ }
430
+ function armIdleTimer() {
431
+ if (!opts.idleTimeoutMs) return;
432
+ clearIdleTimer();
433
+ idleTimer = setTimeout(() => {
434
+ void flagOrphan("idle-timeout");
435
+ }, opts.idleTimeoutMs);
436
+ if (typeof idleTimer.unref === "function") idleTimer.unref();
437
+ }
438
+ async function loadPersistedRecord() {
439
+ if (record) return record;
440
+ try {
441
+ const stored = await innerStore.get(voucherRecordKey);
442
+ if (!stored || typeof stored.amount !== "string" || typeof stored.signature !== "string") {
443
+ return null;
444
+ }
445
+ record = { amount: BigInt(stored.amount), signature: stored.signature, payer: stored.payer ?? null };
446
+ } catch {
447
+ return null;
448
+ }
449
+ return record;
450
+ }
451
+ async function flagOrphan(reason) {
452
+ await loadPersistedRecord();
453
+ if (!sessionOpened || settledCleanly) return;
454
+ sessionOpened = false;
455
+ closeListenerArmed = false;
456
+ clearIdleTimer();
457
+ const cumulativeAmount = record ? (Number(record.amount) / 1e7).toFixed(7) : "0.0000000";
458
+ if (opts.onOrphaned) {
459
+ try {
460
+ await opts.onOrphaned(opts.channelFactory, {
461
+ cumulativeAmount,
462
+ lastSignature: record?.signature ?? "",
463
+ voucherCount,
464
+ reason
465
+ });
466
+ } catch (err) {
467
+ console.error("[mpp-session] onOrphaned handler failed:", err);
468
+ }
469
+ }
470
+ }
471
+ const wrappedStore = {
472
+ async get(key) {
473
+ return innerStore.get(key);
474
+ },
475
+ async put(key, value) {
476
+ return innerStore.put(key, value);
477
+ },
478
+ async delete(key) {
479
+ return innerStore.delete(key);
480
+ },
481
+ async update(key, fn) {
482
+ const storeWithUpdate = innerStore;
483
+ if (typeof storeWithUpdate.update === "function") {
484
+ return storeWithUpdate.update(key, fn);
485
+ }
486
+ throw new Error("Store does not support atomic update operations");
487
+ }
488
+ };
489
+ async function commit(credential) {
490
+ await loadPersistedRecord();
491
+ const payload = credential.payload;
492
+ if (typeof payload?.amount !== "string" || typeof payload.signature !== "string") return;
493
+ let amount;
494
+ try {
495
+ amount = BigInt(payload.amount);
496
+ } catch {
497
+ return;
498
+ }
499
+ if (record && amount < record.amount) return;
500
+ const payer = record?.payer ?? extractPayerAddress(credential.source);
501
+ record = { amount, signature: payload.signature, payer };
502
+ await innerStore.put(voucherRecordKey, {
503
+ amount: record.amount.toString(),
504
+ signature: record.signature,
505
+ payer: record.payer
506
+ });
507
+ voucherCount++;
508
+ settledCleanly = false;
509
+ armIdleTimer();
510
+ if (!sessionOpened) {
511
+ sessionOpened = true;
512
+ if (opts.onSessionOpen) {
513
+ Promise.resolve().then(() => opts.onSessionOpen(opts.channelFactory, record.payer)).catch((err) => {
514
+ console.error("[mpp-session] onSessionOpen callback error:", err);
515
+ opts.onCallbackError?.(err, "onSessionOpen");
516
+ });
517
+ }
518
+ }
519
+ if (opts.onVoucher) {
520
+ const humanAmount = (Number(record.amount) / 1e7).toFixed(7);
521
+ Promise.resolve().then(() => opts.onVoucher(opts.channelFactory, voucherCount, humanAmount, record.signature)).catch((err) => {
522
+ console.error("[mpp-session] onVoucher callback error:", err);
523
+ opts.onCallbackError?.(err, "onVoucher");
524
+ });
525
+ }
526
+ }
527
+ const mppx = Mppx.create({
528
+ secretKey: opts.payeeSecretKey,
529
+ methods: [
530
+ withTypedChannelErrors(
531
+ onVerifiedCredential(
532
+ stellar$1.channel({
533
+ channel: opts.channelFactory,
534
+ commitmentKey: opts.commitmentPublicKey,
535
+ network: networkId,
536
+ store: wrappedStore,
537
+ sourceAccount: payeeKeypair.publicKey(),
538
+ feePayer: channelAuthorizer(payeeKeypair)
539
+ }),
540
+ commit
541
+ )
542
+ )
543
+ ]
544
+ });
545
+ return async (req, res, next) => {
546
+ try {
547
+ if (req.method === "DELETE") {
548
+ await loadPersistedRecord();
549
+ const body = req.body;
550
+ const bodyAmount = body?.amount ? BigInt(body.amount) : 0n;
551
+ const recordAmount = record?.amount ?? 0n;
552
+ let closeAmount;
553
+ let closeSig;
554
+ if (bodyAmount > recordAmount) {
555
+ closeAmount = bodyAmount;
556
+ closeSig = body?.signature ?? record?.signature ?? "";
557
+ } else {
558
+ closeAmount = recordAmount;
559
+ closeSig = record?.signature ?? "";
560
+ }
561
+ if (closeAmount > 0n && closeSig) {
562
+ const closePayer = record?.payer ?? null;
563
+ const closeTxHash = await close({
564
+ channel: opts.channelFactory,
565
+ amount: closeAmount,
566
+ signature: Buffer.from(closeSig, "hex"),
567
+ feePayer: channelAuthorizer(payeeKeypair),
568
+ network: networkId
569
+ });
570
+ settledCleanly = true;
571
+ clearIdleTimer();
572
+ if (opts.onSettled) {
573
+ const totalPaid = (Number(closeAmount) / 1e7).toFixed(7);
574
+ Promise.resolve().then(() => opts.onSettled(closeTxHash, totalPaid, "mpp-session", closePayer)).catch((err) => {
575
+ console.error("[mpp-session] onSettled callback error:", err);
576
+ opts.onCallbackError?.(err, "onSettled");
577
+ });
578
+ }
579
+ const vaultContract = process.env.AGENT_VAULT_CONTRACT;
580
+ if (vaultContract) {
581
+ const settlementAddresses = resolveVaultSettlementAddresses(
582
+ closePayer,
583
+ payeeKeypair.publicKey()
584
+ );
585
+ if (!settlementAddresses) {
586
+ console.error("[mpp-session] skipped session_settled vault record: payer address unavailable");
587
+ } else {
588
+ try {
589
+ const { Networks } = await import('@stellar/stellar-sdk');
590
+ const { Server } = await import('@stellar/stellar-sdk/rpc');
591
+ const networkPassphrase = opts.network === "mainnet" ? Networks.PUBLIC : Networks.TESTNET;
592
+ const rpcUrl = opts.network === "mainnet" ? "https://mainnet.sorobanrpc.com" : "https://soroban-testnet.stellar.org";
593
+ const server = new Server(rpcUrl);
594
+ const payeePublicKey = payeeKeypair.publicKey();
595
+ const sourceAccount = await server.getAccount(payeePublicKey);
596
+ const tx = buildSessionSettlementTransaction(
597
+ sourceAccount,
598
+ vaultContract,
599
+ opts.channelFactory,
600
+ settlementAddresses,
601
+ closeAmount,
602
+ voucherCount,
603
+ networkPassphrase
604
+ );
605
+ const preparedTx = await server.prepareTransaction(tx);
606
+ preparedTx.sign(payeeKeypair);
607
+ await server.sendTransaction(preparedTx);
608
+ } catch (recordErr) {
609
+ console.error("[mpp-session] failed to record session_settled on vault:", recordErr);
610
+ }
611
+ }
612
+ }
613
+ res.json({ closeTxHash });
614
+ } else {
615
+ res.json({ closeTxHash: null, message: "no vouchers received" });
616
+ }
617
+ sessionOpened = false;
618
+ voucherCount = 0;
619
+ record = null;
620
+ await innerStore.delete(voucherRecordKey);
621
+ closeListenerArmed = false;
622
+ clearIdleTimer();
623
+ return;
624
+ }
625
+ const fetchReq = Request.fromNodeListener(req, res);
626
+ const result = await mppx.channel({
627
+ amount: rateHuman,
628
+ description: opts.manifest.name
629
+ })(fetchReq);
630
+ if (result.status === 402) {
631
+ const challenge = result.challenge;
632
+ res.status(402);
633
+ challenge.headers.forEach((v, k) => res.setHeader(k, v));
634
+ const body = await challenge.text();
635
+ res.send(body);
636
+ return;
637
+ }
638
+ if (!closeListenerArmed) {
639
+ closeListenerArmed = true;
640
+ req.on("close", () => {
641
+ void flagOrphan("connection-closed");
642
+ });
643
+ }
644
+ next();
645
+ } catch (err) {
646
+ next(err);
647
+ }
648
+ };
649
+ }
650
+ var MANIFEST_SIGNATURE_VERSION = "2";
651
+ function canonicalize(value) {
652
+ if (Array.isArray(value)) {
653
+ return value.map(canonicalize);
654
+ }
655
+ if (value !== null && typeof value === "object") {
656
+ return Object.fromEntries(
657
+ Object.keys(value).sort().map((key) => [key, canonicalize(value[key])])
658
+ );
659
+ }
660
+ return value;
661
+ }
662
+ function manifestDigest(manifest) {
663
+ const { signature: _omit, ...rest } = manifest;
664
+ const canonical = JSON.stringify(canonicalize(rest));
665
+ return createHash("sha256").update(canonical, "utf8").digest();
666
+ }
667
+ function signManifest(manifest, payeeSecretKey) {
668
+ const keypair = Keypair.fromSecret(payeeSecretKey);
669
+ const versionedManifest = {
670
+ ...manifest,
671
+ signature_version: MANIFEST_SIGNATURE_VERSION
672
+ };
673
+ const digest = manifestDigest(versionedManifest);
674
+ const sig = keypair.sign(digest);
675
+ return { ...versionedManifest, signature: Buffer.from(sig).toString("base64") };
676
+ }
677
+
678
+ // src/provider/fastify.ts
679
+ function buildExpressShims(rawReq, rawRes, fastifyRequest, fastifyReply) {
680
+ const req = rawReq;
681
+ const urlStr = rawReq.url ?? "/";
682
+ const parsedUrl = new URL(urlStr, "http://placeholder");
683
+ const reqGet = (name) => {
684
+ const val = rawReq.headers[name.toLowerCase()];
685
+ return Array.isArray(val) ? val[0] : val;
686
+ };
687
+ if (!("get" in req && typeof req.get === "function")) {
688
+ Object.defineProperty(req, "get", { value: reqGet, configurable: true });
689
+ Object.defineProperty(req, "header", { value: reqGet, configurable: true });
690
+ }
691
+ if (!("protocol" in req)) {
692
+ Object.defineProperty(req, "protocol", {
693
+ get: () => fastifyRequest.protocol ?? "http",
694
+ configurable: true
695
+ });
696
+ }
697
+ if (!("originalUrl" in req)) {
698
+ Object.defineProperty(req, "originalUrl", { value: urlStr, configurable: true });
699
+ }
700
+ if (!("path" in req)) {
701
+ Object.defineProperty(req, "path", { value: parsedUrl.pathname, configurable: true });
702
+ }
703
+ if (!("query" in req)) {
704
+ const q = {};
705
+ parsedUrl.searchParams.forEach((v, k) => {
706
+ q[k] = v;
707
+ });
708
+ Object.defineProperty(req, "query", { value: q, configurable: true });
709
+ }
710
+ const res = rawRes;
711
+ const nativeSetHeader = rawRes.setHeader.bind(rawRes);
712
+ const nativeGetHeader = rawRes.getHeader.bind(rawRes);
713
+ const nativeEnd = rawRes.end.bind(rawRes);
714
+ const extraHeaders = {};
715
+ const resSend = (body) => {
716
+ if (!rawRes.headersSent) {
717
+ for (const [k, v] of Object.entries(extraHeaders)) {
718
+ nativeSetHeader(k, v);
719
+ }
720
+ if (typeof body === "string") {
721
+ nativeEnd(body);
722
+ } else if (body !== void 0 && body !== null) {
723
+ if (!nativeGetHeader("content-type")) {
724
+ nativeSetHeader("Content-Type", "application/json");
725
+ }
726
+ nativeEnd(JSON.stringify(body));
727
+ } else {
728
+ nativeEnd();
729
+ }
730
+ }
731
+ return res;
732
+ };
733
+ const resJson = (data) => {
734
+ if (!nativeGetHeader("content-type")) {
735
+ nativeSetHeader("Content-Type", "application/json");
736
+ }
737
+ return resSend(data);
738
+ };
739
+ const resStatus = (code) => {
740
+ rawRes.statusCode = code;
741
+ return res;
742
+ };
743
+ const resSet = (field, val) => {
744
+ if (typeof field === "object") {
745
+ for (const [k, v] of Object.entries(field)) nativeSetHeader(k, v);
746
+ } else if (val !== void 0) {
747
+ extraHeaders[field] = val;
748
+ nativeSetHeader(field, val);
749
+ }
750
+ return res;
751
+ };
752
+ const resSetHeader = (name, value) => {
753
+ nativeSetHeader(name, value);
754
+ return res;
755
+ };
756
+ if (!("status" in res && typeof res.status === "function")) {
757
+ Object.defineProperty(res, "status", { value: resStatus, configurable: true });
758
+ Object.defineProperty(res, "json", { value: resJson, configurable: true });
759
+ Object.defineProperty(res, "send", { value: resSend, configurable: true });
760
+ Object.defineProperty(res, "set", { value: resSet, configurable: true });
761
+ Object.defineProperty(res, "setHeader", { value: resSetHeader, configurable: true });
762
+ Object.defineProperty(res, "end", {
763
+ value: (data) => {
764
+ nativeEnd(data);
765
+ },
766
+ configurable: true
767
+ });
768
+ }
769
+ return { req, res };
770
+ }
771
+ function runExpressHandler(handler, fastifyRequest, fastifyReply) {
772
+ const rawRes = fastifyReply.raw;
773
+ const { req, res } = buildExpressShims(
774
+ fastifyRequest.raw,
775
+ rawRes,
776
+ fastifyRequest);
777
+ return new Promise((resolve, reject) => {
778
+ let settled = false;
779
+ const finish = (err) => {
780
+ if (settled) return;
781
+ settled = true;
782
+ if (err != null) return reject(err);
783
+ if (rawRes.writableEnded || rawRes.headersSent) fastifyReply.hijack();
784
+ resolve();
785
+ };
786
+ Promise.resolve(handler(req, res, (err) => finish(err))).then(() => finish(), finish);
787
+ });
788
+ }
789
+ var MPP_MODES = ["mpp-session", "mpp-charge"];
790
+ function routedockFastify(opts) {
791
+ const signedManifest = signManifest(opts.manifest, opts.payeeSecretKey);
792
+ const handlerMap = /* @__PURE__ */ new Map();
793
+ if (opts.modes.includes("x402")) {
794
+ const x402Price = opts.pricing.x402;
795
+ if (x402Price) {
796
+ handlerMap.set(
797
+ "x402",
798
+ createX402Handler({
799
+ payeeSecretKey: opts.payeeSecretKey,
800
+ network: opts.network,
801
+ amount: x402Price,
802
+ assetContract: opts.assetContract,
803
+ ...opts.facilitatorApiKey ? { facilitatorApiKey: opts.facilitatorApiKey } : {},
804
+ manifest: signedManifest,
805
+ ...opts.onSettled ? { onSettled: opts.onSettled } : {},
806
+ ...opts.onCallbackError ? { onCallbackError: opts.onCallbackError } : {},
807
+ ...opts.seenTxStore ? { seenTxStore: opts.seenTxStore } : {}
808
+ })
809
+ );
810
+ }
811
+ }
812
+ if (opts.modes.includes("mpp-charge")) {
813
+ const chargePrice = opts.pricing["mpp-charge"];
814
+ if (chargePrice) {
815
+ handlerMap.set(
816
+ "mpp-charge",
817
+ createMppChargeHandler({
818
+ payeeSecretKey: opts.payeeSecretKey,
819
+ network: opts.network,
820
+ amount: chargePrice,
821
+ assetContract: opts.assetContract,
822
+ manifest: signedManifest,
823
+ ...opts.onSettled ? { onSettled: opts.onSettled } : {},
824
+ ...opts.onCallbackError ? { onCallbackError: opts.onCallbackError } : {},
825
+ ...opts.seenTxStore ? { seenTxStore: opts.seenTxStore } : {}
826
+ })
827
+ );
828
+ }
829
+ }
830
+ if (opts.modes.includes("mpp-session")) {
831
+ const sessionPricing = opts.pricing["mpp-session"];
832
+ if (sessionPricing) {
833
+ if (!opts.commitmentPublicKey) {
834
+ throw new Error("routedockFastify: mpp-session mode requires commitmentPublicKey");
835
+ }
836
+ handlerMap.set(
837
+ "mpp-session",
838
+ createMppSessionHandler({
839
+ payeeSecretKey: opts.payeeSecretKey,
840
+ network: opts.network,
841
+ channelFactory: sessionPricing.channelFactory,
842
+ rate: sessionPricing.rate,
843
+ assetContract: opts.assetContract,
844
+ manifest: signedManifest,
845
+ commitmentPublicKey: opts.commitmentPublicKey,
846
+ ...opts.onSettled ? { onSettled: opts.onSettled } : {},
847
+ ...opts.onSessionOpen ? { onSessionOpen: opts.onSessionOpen } : {},
848
+ ...opts.onVoucher ? { onVoucher: opts.onVoucher } : {},
849
+ ...opts.onCallbackError ? { onCallbackError: opts.onCallbackError } : {},
850
+ ...opts.onOrphaned ? { onOrphaned: opts.onOrphaned } : {},
851
+ ...opts.idleTimeoutMs != null ? { idleTimeoutMs: opts.idleTimeoutMs } : {}
852
+ })
853
+ );
854
+ }
855
+ }
856
+ const defaultMode = MPP_MODES.find((mode) => handlerMap.has(mode)) ?? (handlerMap.has("x402") ? "x402" : void 0);
857
+ const plugin = async (fastify) => {
858
+ fastify.addHook("onRequest", async (request, reply) => {
859
+ if (request.url === "/.well-known/routedock.json") {
860
+ reply.hijack();
861
+ const body = JSON.stringify(signedManifest);
862
+ reply.raw.setHeader("Content-Type", "application/json");
863
+ reply.raw.setHeader("Content-Length", Buffer.byteLength(body));
864
+ reply.raw.end(body);
865
+ return;
866
+ }
867
+ if (handlerMap.size === 0) return;
868
+ const prefersX402 = !!(request.headers["payment-signature"] || request.headers["x-payment"]) || request.headers["x-preferred-mode"] === "x402";
869
+ const selectedMode = prefersX402 ? handlerMap.has("x402") ? "x402" : defaultMode : defaultMode;
870
+ if (!selectedMode) return;
871
+ const handler = handlerMap.get(selectedMode);
872
+ if (!handler) return;
873
+ await runExpressHandler(handler, request, reply);
874
+ });
875
+ };
876
+ Object.defineProperty(plugin, /* @__PURE__ */ Symbol.for("skip-override"), { value: true });
877
+ return plugin;
878
+ }
879
+
880
+ export { routedockFastify };