@t402/tezos 2.3.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 (42) hide show
  1. package/README.md +161 -0
  2. package/dist/exact-direct/client/index.d.cts +92 -0
  3. package/dist/exact-direct/client/index.d.ts +92 -0
  4. package/dist/exact-direct/client/index.js +204 -0
  5. package/dist/exact-direct/client/index.js.map +1 -0
  6. package/dist/exact-direct/client/index.mjs +176 -0
  7. package/dist/exact-direct/client/index.mjs.map +1 -0
  8. package/dist/exact-direct/facilitator/index.d.cts +110 -0
  9. package/dist/exact-direct/facilitator/index.d.ts +110 -0
  10. package/dist/exact-direct/facilitator/index.js +331 -0
  11. package/dist/exact-direct/facilitator/index.js.map +1 -0
  12. package/dist/exact-direct/facilitator/index.mjs +303 -0
  13. package/dist/exact-direct/facilitator/index.mjs.map +1 -0
  14. package/dist/exact-direct/server/index.d.cts +109 -0
  15. package/dist/exact-direct/server/index.d.ts +109 -0
  16. package/dist/exact-direct/server/index.js +226 -0
  17. package/dist/exact-direct/server/index.js.map +1 -0
  18. package/dist/exact-direct/server/index.mjs +198 -0
  19. package/dist/exact-direct/server/index.mjs.map +1 -0
  20. package/dist/index.d.cts +124 -0
  21. package/dist/index.d.ts +124 -0
  22. package/dist/index.js +228 -0
  23. package/dist/index.js.map +1 -0
  24. package/dist/index.mjs +170 -0
  25. package/dist/index.mjs.map +1 -0
  26. package/dist/types-DQMtUOa_.d.cts +125 -0
  27. package/dist/types-DQMtUOa_.d.ts +125 -0
  28. package/package.json +100 -0
  29. package/src/constants.ts +53 -0
  30. package/src/exact-direct/client/index.ts +13 -0
  31. package/src/exact-direct/client/register.ts +71 -0
  32. package/src/exact-direct/client/scheme.ts +177 -0
  33. package/src/exact-direct/facilitator/index.ts +13 -0
  34. package/src/exact-direct/facilitator/register.ts +74 -0
  35. package/src/exact-direct/facilitator/scheme.ts +311 -0
  36. package/src/exact-direct/server/index.ts +13 -0
  37. package/src/exact-direct/server/register.ts +64 -0
  38. package/src/exact-direct/server/scheme.ts +205 -0
  39. package/src/index.ts +32 -0
  40. package/src/tokens.ts +86 -0
  41. package/src/types.ts +160 -0
  42. package/src/utils.ts +128 -0
@@ -0,0 +1,331 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key) && key !== except)
14
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
+
20
+ // src/exact-direct/facilitator/index.ts
21
+ var facilitator_exports = {};
22
+ __export(facilitator_exports, {
23
+ ExactDirectTezosFacilitator: () => ExactDirectTezosFacilitator,
24
+ registerExactDirectTezosFacilitator: () => registerExactDirectTezosFacilitator
25
+ });
26
+ module.exports = __toCommonJS(facilitator_exports);
27
+
28
+ // src/constants.ts
29
+ var SCHEME_EXACT_DIRECT = "exact-direct";
30
+ var TEZOS_CAIP2_NAMESPACE = "tezos";
31
+ var TEZOS_MAINNET_CAIP2 = "tezos:NetXdQprcVkpaWU";
32
+ var TEZOS_GHOSTNET_CAIP2 = "tezos:NetXnHfVqm9iesp";
33
+ var DEFAULT_MAINNET_RPC = "https://mainnet.api.tez.ie";
34
+ var DEFAULT_GHOSTNET_RPC = "https://ghostnet.tezos.marigold.dev";
35
+ var DEFAULT_MAINNET_INDEXER = "https://api.tzkt.io";
36
+ var DEFAULT_GHOSTNET_INDEXER = "https://api.ghostnet.tzkt.io";
37
+ var NETWORK_CONFIGS = {
38
+ [TEZOS_MAINNET_CAIP2]: {
39
+ name: "Tezos Mainnet",
40
+ rpcUrl: DEFAULT_MAINNET_RPC,
41
+ indexerUrl: DEFAULT_MAINNET_INDEXER
42
+ },
43
+ [TEZOS_GHOSTNET_CAIP2]: {
44
+ name: "Tezos Ghostnet",
45
+ rpcUrl: DEFAULT_GHOSTNET_RPC,
46
+ indexerUrl: DEFAULT_GHOSTNET_INDEXER
47
+ }
48
+ };
49
+
50
+ // src/types.ts
51
+ function isValidOperationHash(opHash) {
52
+ if (!opHash) return false;
53
+ return opHash.startsWith("o") && opHash.length === 51;
54
+ }
55
+ function isTezosNetwork(network) {
56
+ return network.startsWith("tezos:");
57
+ }
58
+
59
+ // src/utils.ts
60
+ function compareAddresses(addr1, addr2) {
61
+ if (!addr1 || !addr2) return false;
62
+ return addr1 === addr2;
63
+ }
64
+ function extractFA2TransferDetails(parameter) {
65
+ if (!parameter || !Array.isArray(parameter)) return null;
66
+ const firstTransfer = parameter[0];
67
+ if (!firstTransfer || typeof firstTransfer !== "object") return null;
68
+ const transfer = firstTransfer;
69
+ const from = transfer.from_;
70
+ const txs = transfer.txs;
71
+ if (!from || !Array.isArray(txs) || txs.length === 0) return null;
72
+ const firstTx = txs[0];
73
+ if (!firstTx) return null;
74
+ return {
75
+ from,
76
+ to: firstTx.to_,
77
+ tokenId: typeof firstTx.token_id === "string" ? parseInt(firstTx.token_id, 10) : firstTx.token_id,
78
+ amount: String(firstTx.amount)
79
+ };
80
+ }
81
+
82
+ // src/tokens.ts
83
+ var USDT_MAINNET = {
84
+ contractAddress: "KT1XnTn74bUtxHfDtBmm2bGZAQfhPbvKWR8o",
85
+ tokenId: 0,
86
+ symbol: "USDt",
87
+ name: "Tether USD",
88
+ decimals: 6
89
+ };
90
+ var TOKEN_REGISTRY = {
91
+ [TEZOS_MAINNET_CAIP2]: [USDT_MAINNET],
92
+ [TEZOS_GHOSTNET_CAIP2]: []
93
+ };
94
+ var DEFAULT_TOKENS = {
95
+ [TEZOS_MAINNET_CAIP2]: USDT_MAINNET,
96
+ [TEZOS_GHOSTNET_CAIP2]: void 0
97
+ };
98
+ function getDefaultToken(network) {
99
+ return DEFAULT_TOKENS[network];
100
+ }
101
+
102
+ // src/exact-direct/facilitator/scheme.ts
103
+ var ExactDirectTezosFacilitator = class {
104
+ constructor(signer, config) {
105
+ this.signer = signer;
106
+ this.config = {
107
+ maxOperationAge: config?.maxOperationAge ?? 3600,
108
+ usedOpCacheDuration: config?.usedOpCacheDuration ?? 24 * 60 * 60 * 1e3
109
+ // 24 hours
110
+ };
111
+ this.startCleanupInterval();
112
+ }
113
+ scheme = SCHEME_EXACT_DIRECT;
114
+ caipFamily = `${TEZOS_CAIP2_NAMESPACE}:*`;
115
+ config;
116
+ usedOps = /* @__PURE__ */ new Map();
117
+ /**
118
+ * Get extra data for a supported kind
119
+ */
120
+ getExtra(network) {
121
+ const token = getDefaultToken(network);
122
+ if (!token) {
123
+ return void 0;
124
+ }
125
+ return {
126
+ assetSymbol: token.symbol,
127
+ assetDecimals: token.decimals
128
+ };
129
+ }
130
+ /**
131
+ * Get facilitator signer addresses for a network
132
+ */
133
+ getSigners(network) {
134
+ return this.signer.getAddresses(network);
135
+ }
136
+ /**
137
+ * Verify a payment payload
138
+ */
139
+ async verify(payload, requirements) {
140
+ if (payload.accepted.scheme !== SCHEME_EXACT_DIRECT) {
141
+ return {
142
+ isValid: false,
143
+ invalidReason: "invalid_scheme"
144
+ };
145
+ }
146
+ if (!isTezosNetwork(payload.accepted.network)) {
147
+ return {
148
+ isValid: false,
149
+ invalidReason: "invalid_network"
150
+ };
151
+ }
152
+ const tezosPayload = payload.payload;
153
+ if (!isValidOperationHash(tezosPayload.opHash)) {
154
+ return {
155
+ isValid: false,
156
+ invalidReason: "invalid_operation_hash_format"
157
+ };
158
+ }
159
+ if (this.isOpUsed(tezosPayload.opHash)) {
160
+ return {
161
+ isValid: false,
162
+ invalidReason: "operation_already_used",
163
+ payer: tezosPayload.from
164
+ };
165
+ }
166
+ try {
167
+ const op = await this.signer.queryOperation(tezosPayload.opHash);
168
+ if (!op) {
169
+ return {
170
+ isValid: false,
171
+ invalidReason: "operation_not_found",
172
+ payer: tezosPayload.from
173
+ };
174
+ }
175
+ if (op.status !== "applied") {
176
+ return {
177
+ isValid: false,
178
+ invalidReason: `operation_not_applied: status is ${op.status}`,
179
+ payer: tezosPayload.from
180
+ };
181
+ }
182
+ if (this.config.maxOperationAge > 0) {
183
+ const opTimestamp = new Date(op.timestamp).getTime() / 1e3;
184
+ const now = Date.now() / 1e3;
185
+ const age = now - opTimestamp;
186
+ if (age > this.config.maxOperationAge) {
187
+ return {
188
+ isValid: false,
189
+ invalidReason: `operation_too_old: ${Math.round(age)} seconds`,
190
+ payer: tezosPayload.from
191
+ };
192
+ }
193
+ }
194
+ if (op.target?.address !== tezosPayload.contractAddress) {
195
+ return {
196
+ isValid: false,
197
+ invalidReason: `contract_mismatch: expected ${tezosPayload.contractAddress}, got ${op.target?.address}`,
198
+ payer: tezosPayload.from
199
+ };
200
+ }
201
+ if (op.entrypoint !== "transfer") {
202
+ return {
203
+ isValid: false,
204
+ invalidReason: `entrypoint_mismatch: expected transfer, got ${op.entrypoint}`,
205
+ payer: tezosPayload.from
206
+ };
207
+ }
208
+ const transferDetails = extractFA2TransferDetails(op.parameter);
209
+ if (!transferDetails) {
210
+ return {
211
+ isValid: false,
212
+ invalidReason: "could_not_extract_transfer_details",
213
+ payer: tezosPayload.from
214
+ };
215
+ }
216
+ if (!compareAddresses(transferDetails.from, op.sender.address)) {
217
+ return {
218
+ isValid: false,
219
+ invalidReason: `sender_mismatch: parameter says ${transferDetails.from}, but sender is ${op.sender.address}`,
220
+ payer: tezosPayload.from
221
+ };
222
+ }
223
+ if (!compareAddresses(transferDetails.to, requirements.payTo)) {
224
+ return {
225
+ isValid: false,
226
+ invalidReason: `recipient_mismatch: expected ${requirements.payTo}, got ${transferDetails.to}`,
227
+ payer: tezosPayload.from
228
+ };
229
+ }
230
+ if (transferDetails.tokenId !== tezosPayload.tokenId) {
231
+ return {
232
+ isValid: false,
233
+ invalidReason: `token_id_mismatch: expected ${tezosPayload.tokenId}, got ${transferDetails.tokenId}`,
234
+ payer: tezosPayload.from
235
+ };
236
+ }
237
+ const expectedAmount = BigInt(requirements.amount);
238
+ const actualAmount = BigInt(transferDetails.amount);
239
+ if (actualAmount < expectedAmount) {
240
+ return {
241
+ isValid: false,
242
+ invalidReason: `insufficient_amount: expected ${expectedAmount}, got ${actualAmount}`,
243
+ payer: tezosPayload.from
244
+ };
245
+ }
246
+ this.markOpUsed(tezosPayload.opHash);
247
+ return {
248
+ isValid: true,
249
+ payer: transferDetails.from
250
+ };
251
+ } catch (error) {
252
+ return {
253
+ isValid: false,
254
+ invalidReason: `verification_error: ${error instanceof Error ? error.message : String(error)}`,
255
+ payer: tezosPayload.from
256
+ };
257
+ }
258
+ }
259
+ /**
260
+ * Settle a payment (no-op for exact-direct since client already executed)
261
+ */
262
+ async settle(payload, requirements) {
263
+ const verifyResult = await this.verify(payload, requirements);
264
+ if (!verifyResult.isValid) {
265
+ return {
266
+ success: false,
267
+ errorReason: verifyResult.invalidReason || "verification_failed",
268
+ payer: verifyResult.payer,
269
+ transaction: "",
270
+ network: requirements.network
271
+ };
272
+ }
273
+ const tezosPayload = payload.payload;
274
+ return {
275
+ success: true,
276
+ transaction: tezosPayload.opHash,
277
+ network: requirements.network,
278
+ payer: tezosPayload.from
279
+ };
280
+ }
281
+ /**
282
+ * Check if an operation has been used
283
+ */
284
+ isOpUsed(opHash) {
285
+ return this.usedOps.has(opHash);
286
+ }
287
+ /**
288
+ * Mark an operation as used
289
+ */
290
+ markOpUsed(opHash) {
291
+ this.usedOps.set(opHash, Date.now());
292
+ }
293
+ /**
294
+ * Start the cleanup interval for used operations
295
+ */
296
+ startCleanupInterval() {
297
+ setInterval(
298
+ () => {
299
+ const cutoff = Date.now() - this.config.usedOpCacheDuration;
300
+ for (const [opHash, usedAt] of this.usedOps.entries()) {
301
+ if (usedAt < cutoff) {
302
+ this.usedOps.delete(opHash);
303
+ }
304
+ }
305
+ },
306
+ 60 * 60 * 1e3
307
+ );
308
+ }
309
+ };
310
+
311
+ // src/exact-direct/facilitator/register.ts
312
+ function registerExactDirectTezosFacilitator(facilitator, config) {
313
+ const scheme = new ExactDirectTezosFacilitator(
314
+ config.signer,
315
+ config.schemeConfig
316
+ );
317
+ if (config.networks && config.networks.length > 0) {
318
+ config.networks.forEach((network) => {
319
+ facilitator.register(network, scheme);
320
+ });
321
+ } else {
322
+ facilitator.register("tezos:*", scheme);
323
+ }
324
+ return facilitator;
325
+ }
326
+ // Annotate the CommonJS export names for ESM import in node:
327
+ 0 && (module.exports = {
328
+ ExactDirectTezosFacilitator,
329
+ registerExactDirectTezosFacilitator
330
+ });
331
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../../src/exact-direct/facilitator/index.ts","../../../src/constants.ts","../../../src/types.ts","../../../src/utils.ts","../../../src/tokens.ts","../../../src/exact-direct/facilitator/scheme.ts","../../../src/exact-direct/facilitator/register.ts"],"sourcesContent":["/**\n * Tezos Exact-Direct Facilitator\n */\n\nexport {\n ExactDirectTezosFacilitator,\n type ExactDirectTezosFacilitatorConfig,\n} from \"./scheme.js\";\n\nexport {\n registerExactDirectTezosFacilitator,\n type TezosFacilitatorConfig,\n} from \"./register.js\";\n","/**\n * Tezos mechanism constants\n */\n\n// Scheme identifiers\nexport const SCHEME_EXACT_DIRECT = \"exact-direct\";\n\n// CAIP-2 namespace\nexport const TEZOS_CAIP2_NAMESPACE = \"tezos\";\n\n// CAIP-2 network identifiers (derived from genesis block hash)\nexport const TEZOS_MAINNET_CAIP2 = \"tezos:NetXdQprcVkpaWU\";\nexport const TEZOS_GHOSTNET_CAIP2 = \"tezos:NetXnHfVqm9iesp\";\n\n// Default RPC endpoints\nexport const DEFAULT_MAINNET_RPC = \"https://mainnet.api.tez.ie\";\nexport const DEFAULT_GHOSTNET_RPC = \"https://ghostnet.tezos.marigold.dev\";\n\n// Default indexer API endpoints (TzKT)\nexport const DEFAULT_MAINNET_INDEXER = \"https://api.tzkt.io\";\nexport const DEFAULT_GHOSTNET_INDEXER = \"https://api.ghostnet.tzkt.io\";\n\n// FA2 token standard (TZIP-12)\nexport const FA2_TRANSFER_ENTRYPOINT = \"transfer\";\nexport const FA2_BALANCE_OF_ENTRYPOINT = \"balance_of\";\nexport const FA2_UPDATE_OPERATORS_ENTRYPOINT = \"update_operators\";\n\n// Supported networks\nexport const SUPPORTED_NETWORKS = [\n TEZOS_MAINNET_CAIP2,\n TEZOS_GHOSTNET_CAIP2,\n] as const;\n\n// Network configurations\nexport const NETWORK_CONFIGS: Record<\n string,\n {\n name: string;\n rpcUrl: string;\n indexerUrl: string;\n }\n> = {\n [TEZOS_MAINNET_CAIP2]: {\n name: \"Tezos Mainnet\",\n rpcUrl: DEFAULT_MAINNET_RPC,\n indexerUrl: DEFAULT_MAINNET_INDEXER,\n },\n [TEZOS_GHOSTNET_CAIP2]: {\n name: \"Tezos Ghostnet\",\n rpcUrl: DEFAULT_GHOSTNET_RPC,\n indexerUrl: DEFAULT_GHOSTNET_INDEXER,\n },\n};\n","/**\n * Tezos mechanism types\n */\n\nimport type { Network } from \"@t402/core/types\";\n\n/**\n * Exact-direct payment payload for Tezos\n */\nexport type ExactDirectTezosPayload = {\n /** Operation hash (o...) */\n opHash: string;\n /** Sender address (tz1/tz2/tz3...) */\n from: string;\n /** Recipient address */\n to: string;\n /** Amount in smallest units */\n amount: string;\n /** FA2 contract address (KT1...) */\n contractAddress: string;\n /** Token ID within the FA2 contract */\n tokenId: number;\n};\n\n/**\n * Tezos signer interface for client-side operations\n */\nexport interface TezosSigner {\n /** Get the signer's address */\n getAddress(): Promise<string>;\n\n /**\n * Execute an FA2 transfer\n * @param contractAddress FA2 contract address\n * @param tokenId Token ID\n * @param to Recipient address\n * @param amount Amount to transfer\n * @returns Operation hash\n */\n transfer(\n contractAddress: string,\n tokenId: number,\n to: string,\n amount: bigint,\n ): Promise<string>;\n\n /**\n * Get token balance\n * @param contractAddress FA2 contract address\n * @param tokenId Token ID\n * @param address Address to check (optional, defaults to signer address)\n * @returns Balance in smallest units\n */\n getBalance(\n contractAddress: string,\n tokenId: number,\n address?: string,\n ): Promise<bigint>;\n}\n\n/**\n * Tezos signer interface for facilitator operations\n */\nexport interface FacilitatorTezosSigner {\n /** Get facilitator addresses for a network */\n getAddresses(network: Network): string[];\n\n /**\n * Query an operation by hash\n * @param opHash Operation hash\n * @returns Operation result or null if not found\n */\n queryOperation(opHash: string): Promise<TezosOperationResult | null>;\n\n /**\n * Get token balance for an address\n * @param contractAddress FA2 contract address\n * @param tokenId Token ID\n * @param address Address to check\n * @returns Balance as string\n */\n getBalance(\n contractAddress: string,\n tokenId: number,\n address: string,\n ): Promise<string>;\n}\n\n/**\n * Tezos operation result from indexer\n */\nexport interface TezosOperationResult {\n /** Operation hash */\n hash: string;\n /** Block level */\n level: number;\n /** Timestamp */\n timestamp: string;\n /** Status: applied, failed, backtracked, skipped */\n status: \"applied\" | \"failed\" | \"backtracked\" | \"skipped\";\n /** Sender address */\n sender: {\n address: string;\n };\n /** Target contract (for contract calls) */\n target?: {\n address: string;\n };\n /** Entrypoint called */\n entrypoint?: string;\n /** Parameter value */\n parameter?: unknown;\n /** Amount transferred (in mutez for XTZ) */\n amount?: number;\n /** Errors if failed */\n errors?: Array<{\n type: string;\n message?: string;\n }>;\n}\n\n/**\n * FA2 transfer parameter structure\n */\nexport interface FA2TransferParam {\n from_: string;\n txs: Array<{\n to_: string;\n token_id: number;\n amount: string;\n }>;\n}\n\n/**\n * Check if a string is a valid Tezos address\n */\nexport function isValidTezosAddress(address: string): boolean {\n if (!address) return false;\n // tz1, tz2, tz3 for implicit accounts, KT1 for contracts\n const prefixPattern = /^(tz1|tz2|tz3|KT1)/;\n if (!prefixPattern.test(address)) return false;\n // Base58 check - length should be 36 characters\n return address.length === 36;\n}\n\n/**\n * Check if a string is a valid Tezos operation hash\n */\nexport function isValidOperationHash(opHash: string): boolean {\n if (!opHash) return false;\n // Operation hashes start with 'o' and are 51 characters\n return opHash.startsWith(\"o\") && opHash.length === 51;\n}\n\n/**\n * Check if a network is a Tezos network\n */\nexport function isTezosNetwork(network: string): boolean {\n return network.startsWith(\"tezos:\");\n}\n","/**\n * Tezos utility functions\n */\n\nimport {\n NETWORK_CONFIGS,\n TEZOS_CAIP2_NAMESPACE,\n SUPPORTED_NETWORKS,\n} from \"./constants.js\";\n\n/**\n * Get network configuration\n */\nexport function getNetworkConfig(network: string) {\n return NETWORK_CONFIGS[network];\n}\n\n/**\n * Check if a network is supported\n */\nexport function isSupportedNetwork(network: string): boolean {\n return (SUPPORTED_NETWORKS as readonly string[]).includes(network);\n}\n\n/**\n * Parse a CAIP-2 network identifier to extract the chain reference\n */\nexport function parseNetworkId(network: string): {\n namespace: string;\n reference: string;\n} | null {\n const parts = network.split(\":\");\n if (parts.length !== 2) return null;\n return {\n namespace: parts[0],\n reference: parts[1],\n };\n}\n\n/**\n * Build a CAIP-2 network identifier\n */\nexport function buildNetworkId(reference: string): string {\n return `${TEZOS_CAIP2_NAMESPACE}:${reference}`;\n}\n\n/**\n * Get indexer URL for a network\n */\nexport function getIndexerUrl(network: string): string | undefined {\n return NETWORK_CONFIGS[network]?.indexerUrl;\n}\n\n/**\n * Get RPC URL for a network\n */\nexport function getRpcUrl(network: string): string | undefined {\n return NETWORK_CONFIGS[network]?.rpcUrl;\n}\n\n/**\n * Compare two Tezos addresses (case-insensitive for base58)\n */\nexport function compareAddresses(addr1: string, addr2: string): boolean {\n if (!addr1 || !addr2) return false;\n return addr1 === addr2;\n}\n\n/**\n * Format amount with decimals\n */\nexport function formatAmount(amount: bigint, decimals: number): string {\n const divisor = BigInt(10 ** decimals);\n const wholePart = amount / divisor;\n const fractionalPart = amount % divisor;\n const fractionalStr = fractionalPart.toString().padStart(decimals, \"0\");\n return `${wholePart}.${fractionalStr}`;\n}\n\n/**\n * Parse amount string to bigint\n */\nexport function parseAmount(amount: string, decimals: number): bigint {\n const [whole, fractional = \"\"] = amount.split(\".\");\n const paddedFractional = fractional.padEnd(decimals, \"0\").slice(0, decimals);\n return BigInt(whole + paddedFractional);\n}\n\n/**\n * Extract FA2 transfer details from operation parameter\n */\nexport function extractFA2TransferDetails(\n parameter: unknown,\n): {\n from: string;\n to: string;\n tokenId: number;\n amount: string;\n} | null {\n if (!parameter || !Array.isArray(parameter)) return null;\n\n // FA2 transfer parameter is an array of { from_: string, txs: [...] }\n const firstTransfer = parameter[0];\n if (!firstTransfer || typeof firstTransfer !== \"object\") return null;\n\n const transfer = firstTransfer as Record<string, unknown>;\n const from = transfer.from_ as string;\n const txs = transfer.txs as Array<{\n to_: string;\n token_id: number | string;\n amount: number | string;\n }>;\n\n if (!from || !Array.isArray(txs) || txs.length === 0) return null;\n\n const firstTx = txs[0];\n if (!firstTx) return null;\n\n return {\n from,\n to: firstTx.to_,\n tokenId:\n typeof firstTx.token_id === \"string\"\n ? parseInt(firstTx.token_id, 10)\n : firstTx.token_id,\n amount: String(firstTx.amount),\n };\n}\n","/**\n * Tezos token registry\n */\n\nimport { TEZOS_MAINNET_CAIP2, TEZOS_GHOSTNET_CAIP2 } from \"./constants.js\";\n\n/**\n * Token configuration for Tezos FA2 tokens\n */\nexport interface TokenConfig {\n /** FA2 contract address (KT1...) */\n contractAddress: string;\n /** Token ID within the FA2 contract */\n tokenId: number;\n /** Token symbol */\n symbol: string;\n /** Token name */\n name: string;\n /** Token decimals */\n decimals: number;\n}\n\n/**\n * USDT on Tezos Mainnet\n */\nexport const USDT_MAINNET: TokenConfig = {\n contractAddress: \"KT1XnTn74bUtxHfDtBmm2bGZAQfhPbvKWR8o\",\n tokenId: 0,\n symbol: \"USDt\",\n name: \"Tether USD\",\n decimals: 6,\n};\n\n/**\n * Token registry by network\n */\nexport const TOKEN_REGISTRY: Record<string, TokenConfig[]> = {\n [TEZOS_MAINNET_CAIP2]: [USDT_MAINNET],\n [TEZOS_GHOSTNET_CAIP2]: [],\n};\n\n/**\n * Default token for each network\n */\nexport const DEFAULT_TOKENS: Record<string, TokenConfig | undefined> = {\n [TEZOS_MAINNET_CAIP2]: USDT_MAINNET,\n [TEZOS_GHOSTNET_CAIP2]: undefined,\n};\n\n/**\n * Get token by symbol for a network\n */\nexport function getTokenBySymbol(\n network: string,\n symbol: string,\n): TokenConfig | undefined {\n const tokens = TOKEN_REGISTRY[network];\n if (!tokens) return undefined;\n return tokens.find(\n (t) => t.symbol.toLowerCase() === symbol.toLowerCase(),\n );\n}\n\n/**\n * Get token by contract address and token ID\n */\nexport function getTokenByContract(\n network: string,\n contractAddress: string,\n tokenId: number,\n): TokenConfig | undefined {\n const tokens = TOKEN_REGISTRY[network];\n if (!tokens) return undefined;\n return tokens.find(\n (t) =>\n t.contractAddress.toLowerCase() === contractAddress.toLowerCase() &&\n t.tokenId === tokenId,\n );\n}\n\n/**\n * Get default token for a network\n */\nexport function getDefaultToken(network: string): TokenConfig | undefined {\n return DEFAULT_TOKENS[network];\n}\n","/**\n * Tezos Exact-Direct Facilitator Scheme\n *\n * Verifies FA2 transfer operations and manages replay protection.\n */\n\nimport type {\n SchemeNetworkFacilitator,\n PaymentPayload,\n PaymentRequirements,\n VerifyResponse,\n SettleResponse,\n Network,\n} from \"@t402/core/types\";\nimport { SCHEME_EXACT_DIRECT, TEZOS_CAIP2_NAMESPACE } from \"../../constants.js\";\nimport type {\n FacilitatorTezosSigner,\n ExactDirectTezosPayload,\n} from \"../../types.js\";\nimport { isValidOperationHash, isTezosNetwork } from \"../../types.js\";\nimport {\n compareAddresses,\n extractFA2TransferDetails,\n} from \"../../utils.js\";\nimport { getDefaultToken } from \"../../tokens.js\";\n\n/**\n * Configuration for ExactDirectTezosFacilitator\n */\nexport interface ExactDirectTezosFacilitatorConfig {\n /**\n * Maximum age of operation in seconds (default: 3600 = 1 hour)\n */\n maxOperationAge?: number;\n\n /**\n * Duration to cache used operation hashes (in milliseconds)\n */\n usedOpCacheDuration?: number;\n}\n\n/**\n * Tezos Exact-Direct Facilitator\n *\n * Implements the facilitator-side verification and settlement.\n * For exact-direct, settlement is a no-op since client already executed.\n */\nexport class ExactDirectTezosFacilitator implements SchemeNetworkFacilitator {\n readonly scheme = SCHEME_EXACT_DIRECT;\n readonly caipFamily = `${TEZOS_CAIP2_NAMESPACE}:*`;\n\n private readonly config: Required<ExactDirectTezosFacilitatorConfig>;\n private usedOps: Map<string, number> = new Map();\n\n constructor(\n private readonly signer: FacilitatorTezosSigner,\n config?: ExactDirectTezosFacilitatorConfig,\n ) {\n this.config = {\n maxOperationAge: config?.maxOperationAge ?? 3600,\n usedOpCacheDuration: config?.usedOpCacheDuration ?? 24 * 60 * 60 * 1000, // 24 hours\n };\n\n // Start cleanup interval\n this.startCleanupInterval();\n }\n\n /**\n * Get extra data for a supported kind\n */\n getExtra(network: Network): Record<string, unknown> | undefined {\n const token = getDefaultToken(network);\n if (!token) {\n return undefined;\n }\n return {\n assetSymbol: token.symbol,\n assetDecimals: token.decimals,\n };\n }\n\n /**\n * Get facilitator signer addresses for a network\n */\n getSigners(network: Network): string[] {\n return this.signer.getAddresses(network);\n }\n\n /**\n * Verify a payment payload\n */\n async verify(\n payload: PaymentPayload,\n requirements: PaymentRequirements,\n ): Promise<VerifyResponse> {\n // Validate scheme\n if (payload.accepted.scheme !== SCHEME_EXACT_DIRECT) {\n return {\n isValid: false,\n invalidReason: \"invalid_scheme\",\n };\n }\n\n // Validate network\n if (!isTezosNetwork(payload.accepted.network)) {\n return {\n isValid: false,\n invalidReason: \"invalid_network\",\n };\n }\n\n // Extract Tezos-specific payload\n const tezosPayload = payload.payload as ExactDirectTezosPayload;\n\n // Validate operation hash format\n if (!isValidOperationHash(tezosPayload.opHash)) {\n return {\n isValid: false,\n invalidReason: \"invalid_operation_hash_format\",\n };\n }\n\n // Check for replay attack\n if (this.isOpUsed(tezosPayload.opHash)) {\n return {\n isValid: false,\n invalidReason: \"operation_already_used\",\n payer: tezosPayload.from,\n };\n }\n\n try {\n // Query operation\n const op = await this.signer.queryOperation(tezosPayload.opHash);\n if (!op) {\n return {\n isValid: false,\n invalidReason: \"operation_not_found\",\n payer: tezosPayload.from,\n };\n }\n\n // Verify operation was successful\n if (op.status !== \"applied\") {\n return {\n isValid: false,\n invalidReason: `operation_not_applied: status is ${op.status}`,\n payer: tezosPayload.from,\n };\n }\n\n // Check operation age\n if (this.config.maxOperationAge > 0) {\n const opTimestamp = new Date(op.timestamp).getTime() / 1000;\n const now = Date.now() / 1000;\n const age = now - opTimestamp;\n if (age > this.config.maxOperationAge) {\n return {\n isValid: false,\n invalidReason: `operation_too_old: ${Math.round(age)} seconds`,\n payer: tezosPayload.from,\n };\n }\n }\n\n // Verify it's a transfer to the correct contract\n if (op.target?.address !== tezosPayload.contractAddress) {\n return {\n isValid: false,\n invalidReason: `contract_mismatch: expected ${tezosPayload.contractAddress}, got ${op.target?.address}`,\n payer: tezosPayload.from,\n };\n }\n\n // Verify entrypoint\n if (op.entrypoint !== \"transfer\") {\n return {\n isValid: false,\n invalidReason: `entrypoint_mismatch: expected transfer, got ${op.entrypoint}`,\n payer: tezosPayload.from,\n };\n }\n\n // Extract transfer details from parameter\n const transferDetails = extractFA2TransferDetails(op.parameter);\n if (!transferDetails) {\n return {\n isValid: false,\n invalidReason: \"could_not_extract_transfer_details\",\n payer: tezosPayload.from,\n };\n }\n\n // Verify sender\n if (!compareAddresses(transferDetails.from, op.sender.address)) {\n return {\n isValid: false,\n invalidReason: `sender_mismatch: parameter says ${transferDetails.from}, but sender is ${op.sender.address}`,\n payer: tezosPayload.from,\n };\n }\n\n // Verify recipient\n if (!compareAddresses(transferDetails.to, requirements.payTo)) {\n return {\n isValid: false,\n invalidReason: `recipient_mismatch: expected ${requirements.payTo}, got ${transferDetails.to}`,\n payer: tezosPayload.from,\n };\n }\n\n // Verify token ID\n if (transferDetails.tokenId !== tezosPayload.tokenId) {\n return {\n isValid: false,\n invalidReason: `token_id_mismatch: expected ${tezosPayload.tokenId}, got ${transferDetails.tokenId}`,\n payer: tezosPayload.from,\n };\n }\n\n // Verify amount\n const expectedAmount = BigInt(requirements.amount);\n const actualAmount = BigInt(transferDetails.amount);\n if (actualAmount < expectedAmount) {\n return {\n isValid: false,\n invalidReason: `insufficient_amount: expected ${expectedAmount}, got ${actualAmount}`,\n payer: tezosPayload.from,\n };\n }\n\n // Mark operation as used\n this.markOpUsed(tezosPayload.opHash);\n\n return {\n isValid: true,\n payer: transferDetails.from,\n };\n } catch (error) {\n return {\n isValid: false,\n invalidReason: `verification_error: ${error instanceof Error ? error.message : String(error)}`,\n payer: tezosPayload.from,\n };\n }\n }\n\n /**\n * Settle a payment (no-op for exact-direct since client already executed)\n */\n async settle(\n payload: PaymentPayload,\n requirements: PaymentRequirements,\n ): Promise<SettleResponse> {\n // Verify first\n const verifyResult = await this.verify(payload, requirements);\n\n if (!verifyResult.isValid) {\n return {\n success: false,\n errorReason: verifyResult.invalidReason || \"verification_failed\",\n payer: verifyResult.payer,\n transaction: \"\",\n network: requirements.network,\n };\n }\n\n const tezosPayload = payload.payload as ExactDirectTezosPayload;\n\n // For exact-direct, settlement is already complete\n return {\n success: true,\n transaction: tezosPayload.opHash,\n network: requirements.network,\n payer: tezosPayload.from,\n };\n }\n\n /**\n * Check if an operation has been used\n */\n private isOpUsed(opHash: string): boolean {\n return this.usedOps.has(opHash);\n }\n\n /**\n * Mark an operation as used\n */\n private markOpUsed(opHash: string): void {\n this.usedOps.set(opHash, Date.now());\n }\n\n /**\n * Start the cleanup interval for used operations\n */\n private startCleanupInterval(): void {\n setInterval(\n () => {\n const cutoff = Date.now() - this.config.usedOpCacheDuration;\n for (const [opHash, usedAt] of this.usedOps.entries()) {\n if (usedAt < cutoff) {\n this.usedOps.delete(opHash);\n }\n }\n },\n 60 * 60 * 1000,\n ); // Cleanup every hour\n }\n}\n\nexport default ExactDirectTezosFacilitator;\n","/**\n * Registration function for Tezos Exact-Direct facilitator\n */\n\nimport { t402Facilitator } from \"@t402/core/facilitator\";\nimport type { Network } from \"@t402/core/types\";\nimport type { FacilitatorTezosSigner } from \"../../types.js\";\nimport {\n ExactDirectTezosFacilitator,\n type ExactDirectTezosFacilitatorConfig,\n} from \"./scheme.js\";\n\n/**\n * Configuration options for registering Tezos schemes to a t402Facilitator\n */\nexport interface TezosFacilitatorConfig {\n /**\n * The Tezos signer for facilitator operations (verify and settle)\n */\n signer: FacilitatorTezosSigner;\n\n /**\n * Optional specific networks to register\n * If not provided, registers wildcard support (tezos:*)\n */\n networks?: Network[];\n\n /**\n * Optional scheme configuration\n */\n schemeConfig?: ExactDirectTezosFacilitatorConfig;\n}\n\n/**\n * Registers Tezos exact-direct payment schemes to a t402Facilitator instance.\n *\n * @param facilitator - The t402Facilitator instance to register schemes to\n * @param config - Configuration for Tezos facilitator registration\n * @returns The facilitator instance for chaining\n *\n * @example\n * ```typescript\n * import { registerExactDirectTezosFacilitator } from \"@t402/tezos/exact-direct/facilitator\";\n * import { t402Facilitator } from \"@t402/core/facilitator\";\n *\n * const facilitator = new t402Facilitator();\n * registerExactDirectTezosFacilitator(facilitator, {\n * signer: myTezosSigner,\n * networks: [\"tezos:NetXdQprcVkpaWU\"]\n * });\n * ```\n */\nexport function registerExactDirectTezosFacilitator(\n facilitator: t402Facilitator,\n config: TezosFacilitatorConfig,\n): t402Facilitator {\n const scheme = new ExactDirectTezosFacilitator(\n config.signer,\n config.schemeConfig,\n );\n\n // Register scheme\n if (config.networks && config.networks.length > 0) {\n // Register specific networks\n config.networks.forEach((network) => {\n facilitator.register(network, scheme);\n });\n } else {\n // Register wildcard for all Tezos networks\n facilitator.register(\"tezos:*\", scheme);\n }\n\n return facilitator;\n}\n"],"mappings":"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","names":[]}
@@ -0,0 +1,303 @@
1
+ // src/constants.ts
2
+ var SCHEME_EXACT_DIRECT = "exact-direct";
3
+ var TEZOS_CAIP2_NAMESPACE = "tezos";
4
+ var TEZOS_MAINNET_CAIP2 = "tezos:NetXdQprcVkpaWU";
5
+ var TEZOS_GHOSTNET_CAIP2 = "tezos:NetXnHfVqm9iesp";
6
+ var DEFAULT_MAINNET_RPC = "https://mainnet.api.tez.ie";
7
+ var DEFAULT_GHOSTNET_RPC = "https://ghostnet.tezos.marigold.dev";
8
+ var DEFAULT_MAINNET_INDEXER = "https://api.tzkt.io";
9
+ var DEFAULT_GHOSTNET_INDEXER = "https://api.ghostnet.tzkt.io";
10
+ var NETWORK_CONFIGS = {
11
+ [TEZOS_MAINNET_CAIP2]: {
12
+ name: "Tezos Mainnet",
13
+ rpcUrl: DEFAULT_MAINNET_RPC,
14
+ indexerUrl: DEFAULT_MAINNET_INDEXER
15
+ },
16
+ [TEZOS_GHOSTNET_CAIP2]: {
17
+ name: "Tezos Ghostnet",
18
+ rpcUrl: DEFAULT_GHOSTNET_RPC,
19
+ indexerUrl: DEFAULT_GHOSTNET_INDEXER
20
+ }
21
+ };
22
+
23
+ // src/types.ts
24
+ function isValidOperationHash(opHash) {
25
+ if (!opHash) return false;
26
+ return opHash.startsWith("o") && opHash.length === 51;
27
+ }
28
+ function isTezosNetwork(network) {
29
+ return network.startsWith("tezos:");
30
+ }
31
+
32
+ // src/utils.ts
33
+ function compareAddresses(addr1, addr2) {
34
+ if (!addr1 || !addr2) return false;
35
+ return addr1 === addr2;
36
+ }
37
+ function extractFA2TransferDetails(parameter) {
38
+ if (!parameter || !Array.isArray(parameter)) return null;
39
+ const firstTransfer = parameter[0];
40
+ if (!firstTransfer || typeof firstTransfer !== "object") return null;
41
+ const transfer = firstTransfer;
42
+ const from = transfer.from_;
43
+ const txs = transfer.txs;
44
+ if (!from || !Array.isArray(txs) || txs.length === 0) return null;
45
+ const firstTx = txs[0];
46
+ if (!firstTx) return null;
47
+ return {
48
+ from,
49
+ to: firstTx.to_,
50
+ tokenId: typeof firstTx.token_id === "string" ? parseInt(firstTx.token_id, 10) : firstTx.token_id,
51
+ amount: String(firstTx.amount)
52
+ };
53
+ }
54
+
55
+ // src/tokens.ts
56
+ var USDT_MAINNET = {
57
+ contractAddress: "KT1XnTn74bUtxHfDtBmm2bGZAQfhPbvKWR8o",
58
+ tokenId: 0,
59
+ symbol: "USDt",
60
+ name: "Tether USD",
61
+ decimals: 6
62
+ };
63
+ var TOKEN_REGISTRY = {
64
+ [TEZOS_MAINNET_CAIP2]: [USDT_MAINNET],
65
+ [TEZOS_GHOSTNET_CAIP2]: []
66
+ };
67
+ var DEFAULT_TOKENS = {
68
+ [TEZOS_MAINNET_CAIP2]: USDT_MAINNET,
69
+ [TEZOS_GHOSTNET_CAIP2]: void 0
70
+ };
71
+ function getDefaultToken(network) {
72
+ return DEFAULT_TOKENS[network];
73
+ }
74
+
75
+ // src/exact-direct/facilitator/scheme.ts
76
+ var ExactDirectTezosFacilitator = class {
77
+ constructor(signer, config) {
78
+ this.signer = signer;
79
+ this.config = {
80
+ maxOperationAge: config?.maxOperationAge ?? 3600,
81
+ usedOpCacheDuration: config?.usedOpCacheDuration ?? 24 * 60 * 60 * 1e3
82
+ // 24 hours
83
+ };
84
+ this.startCleanupInterval();
85
+ }
86
+ scheme = SCHEME_EXACT_DIRECT;
87
+ caipFamily = `${TEZOS_CAIP2_NAMESPACE}:*`;
88
+ config;
89
+ usedOps = /* @__PURE__ */ new Map();
90
+ /**
91
+ * Get extra data for a supported kind
92
+ */
93
+ getExtra(network) {
94
+ const token = getDefaultToken(network);
95
+ if (!token) {
96
+ return void 0;
97
+ }
98
+ return {
99
+ assetSymbol: token.symbol,
100
+ assetDecimals: token.decimals
101
+ };
102
+ }
103
+ /**
104
+ * Get facilitator signer addresses for a network
105
+ */
106
+ getSigners(network) {
107
+ return this.signer.getAddresses(network);
108
+ }
109
+ /**
110
+ * Verify a payment payload
111
+ */
112
+ async verify(payload, requirements) {
113
+ if (payload.accepted.scheme !== SCHEME_EXACT_DIRECT) {
114
+ return {
115
+ isValid: false,
116
+ invalidReason: "invalid_scheme"
117
+ };
118
+ }
119
+ if (!isTezosNetwork(payload.accepted.network)) {
120
+ return {
121
+ isValid: false,
122
+ invalidReason: "invalid_network"
123
+ };
124
+ }
125
+ const tezosPayload = payload.payload;
126
+ if (!isValidOperationHash(tezosPayload.opHash)) {
127
+ return {
128
+ isValid: false,
129
+ invalidReason: "invalid_operation_hash_format"
130
+ };
131
+ }
132
+ if (this.isOpUsed(tezosPayload.opHash)) {
133
+ return {
134
+ isValid: false,
135
+ invalidReason: "operation_already_used",
136
+ payer: tezosPayload.from
137
+ };
138
+ }
139
+ try {
140
+ const op = await this.signer.queryOperation(tezosPayload.opHash);
141
+ if (!op) {
142
+ return {
143
+ isValid: false,
144
+ invalidReason: "operation_not_found",
145
+ payer: tezosPayload.from
146
+ };
147
+ }
148
+ if (op.status !== "applied") {
149
+ return {
150
+ isValid: false,
151
+ invalidReason: `operation_not_applied: status is ${op.status}`,
152
+ payer: tezosPayload.from
153
+ };
154
+ }
155
+ if (this.config.maxOperationAge > 0) {
156
+ const opTimestamp = new Date(op.timestamp).getTime() / 1e3;
157
+ const now = Date.now() / 1e3;
158
+ const age = now - opTimestamp;
159
+ if (age > this.config.maxOperationAge) {
160
+ return {
161
+ isValid: false,
162
+ invalidReason: `operation_too_old: ${Math.round(age)} seconds`,
163
+ payer: tezosPayload.from
164
+ };
165
+ }
166
+ }
167
+ if (op.target?.address !== tezosPayload.contractAddress) {
168
+ return {
169
+ isValid: false,
170
+ invalidReason: `contract_mismatch: expected ${tezosPayload.contractAddress}, got ${op.target?.address}`,
171
+ payer: tezosPayload.from
172
+ };
173
+ }
174
+ if (op.entrypoint !== "transfer") {
175
+ return {
176
+ isValid: false,
177
+ invalidReason: `entrypoint_mismatch: expected transfer, got ${op.entrypoint}`,
178
+ payer: tezosPayload.from
179
+ };
180
+ }
181
+ const transferDetails = extractFA2TransferDetails(op.parameter);
182
+ if (!transferDetails) {
183
+ return {
184
+ isValid: false,
185
+ invalidReason: "could_not_extract_transfer_details",
186
+ payer: tezosPayload.from
187
+ };
188
+ }
189
+ if (!compareAddresses(transferDetails.from, op.sender.address)) {
190
+ return {
191
+ isValid: false,
192
+ invalidReason: `sender_mismatch: parameter says ${transferDetails.from}, but sender is ${op.sender.address}`,
193
+ payer: tezosPayload.from
194
+ };
195
+ }
196
+ if (!compareAddresses(transferDetails.to, requirements.payTo)) {
197
+ return {
198
+ isValid: false,
199
+ invalidReason: `recipient_mismatch: expected ${requirements.payTo}, got ${transferDetails.to}`,
200
+ payer: tezosPayload.from
201
+ };
202
+ }
203
+ if (transferDetails.tokenId !== tezosPayload.tokenId) {
204
+ return {
205
+ isValid: false,
206
+ invalidReason: `token_id_mismatch: expected ${tezosPayload.tokenId}, got ${transferDetails.tokenId}`,
207
+ payer: tezosPayload.from
208
+ };
209
+ }
210
+ const expectedAmount = BigInt(requirements.amount);
211
+ const actualAmount = BigInt(transferDetails.amount);
212
+ if (actualAmount < expectedAmount) {
213
+ return {
214
+ isValid: false,
215
+ invalidReason: `insufficient_amount: expected ${expectedAmount}, got ${actualAmount}`,
216
+ payer: tezosPayload.from
217
+ };
218
+ }
219
+ this.markOpUsed(tezosPayload.opHash);
220
+ return {
221
+ isValid: true,
222
+ payer: transferDetails.from
223
+ };
224
+ } catch (error) {
225
+ return {
226
+ isValid: false,
227
+ invalidReason: `verification_error: ${error instanceof Error ? error.message : String(error)}`,
228
+ payer: tezosPayload.from
229
+ };
230
+ }
231
+ }
232
+ /**
233
+ * Settle a payment (no-op for exact-direct since client already executed)
234
+ */
235
+ async settle(payload, requirements) {
236
+ const verifyResult = await this.verify(payload, requirements);
237
+ if (!verifyResult.isValid) {
238
+ return {
239
+ success: false,
240
+ errorReason: verifyResult.invalidReason || "verification_failed",
241
+ payer: verifyResult.payer,
242
+ transaction: "",
243
+ network: requirements.network
244
+ };
245
+ }
246
+ const tezosPayload = payload.payload;
247
+ return {
248
+ success: true,
249
+ transaction: tezosPayload.opHash,
250
+ network: requirements.network,
251
+ payer: tezosPayload.from
252
+ };
253
+ }
254
+ /**
255
+ * Check if an operation has been used
256
+ */
257
+ isOpUsed(opHash) {
258
+ return this.usedOps.has(opHash);
259
+ }
260
+ /**
261
+ * Mark an operation as used
262
+ */
263
+ markOpUsed(opHash) {
264
+ this.usedOps.set(opHash, Date.now());
265
+ }
266
+ /**
267
+ * Start the cleanup interval for used operations
268
+ */
269
+ startCleanupInterval() {
270
+ setInterval(
271
+ () => {
272
+ const cutoff = Date.now() - this.config.usedOpCacheDuration;
273
+ for (const [opHash, usedAt] of this.usedOps.entries()) {
274
+ if (usedAt < cutoff) {
275
+ this.usedOps.delete(opHash);
276
+ }
277
+ }
278
+ },
279
+ 60 * 60 * 1e3
280
+ );
281
+ }
282
+ };
283
+
284
+ // src/exact-direct/facilitator/register.ts
285
+ function registerExactDirectTezosFacilitator(facilitator, config) {
286
+ const scheme = new ExactDirectTezosFacilitator(
287
+ config.signer,
288
+ config.schemeConfig
289
+ );
290
+ if (config.networks && config.networks.length > 0) {
291
+ config.networks.forEach((network) => {
292
+ facilitator.register(network, scheme);
293
+ });
294
+ } else {
295
+ facilitator.register("tezos:*", scheme);
296
+ }
297
+ return facilitator;
298
+ }
299
+ export {
300
+ ExactDirectTezosFacilitator,
301
+ registerExactDirectTezosFacilitator
302
+ };
303
+ //# sourceMappingURL=index.mjs.map