@t402/stacks 2.4.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 (40) hide show
  1. package/README.md +178 -0
  2. package/dist/exact-direct/client/index.cjs +167 -0
  3. package/dist/exact-direct/client/index.cjs.map +1 -0
  4. package/dist/exact-direct/client/index.d.cts +39 -0
  5. package/dist/exact-direct/client/index.d.ts +39 -0
  6. package/dist/exact-direct/client/index.mjs +139 -0
  7. package/dist/exact-direct/client/index.mjs.map +1 -0
  8. package/dist/exact-direct/facilitator/index.cjs +395 -0
  9. package/dist/exact-direct/facilitator/index.cjs.map +1 -0
  10. package/dist/exact-direct/facilitator/index.d.cts +55 -0
  11. package/dist/exact-direct/facilitator/index.d.ts +55 -0
  12. package/dist/exact-direct/facilitator/index.mjs +367 -0
  13. package/dist/exact-direct/facilitator/index.mjs.map +1 -0
  14. package/dist/exact-direct/server/index.cjs +247 -0
  15. package/dist/exact-direct/server/index.cjs.map +1 -0
  16. package/dist/exact-direct/server/index.d.cts +109 -0
  17. package/dist/exact-direct/server/index.d.ts +109 -0
  18. package/dist/exact-direct/server/index.mjs +218 -0
  19. package/dist/exact-direct/server/index.mjs.map +1 -0
  20. package/dist/index.cjs +261 -0
  21. package/dist/index.cjs.map +1 -0
  22. package/dist/index.d.cts +126 -0
  23. package/dist/index.d.ts +126 -0
  24. package/dist/index.mjs +212 -0
  25. package/dist/index.mjs.map +1 -0
  26. package/dist/types-Bxzo3eQ1.d.cts +172 -0
  27. package/dist/types-Bxzo3eQ1.d.ts +172 -0
  28. package/package.json +102 -0
  29. package/src/constants.ts +66 -0
  30. package/src/exact-direct/client/index.ts +5 -0
  31. package/src/exact-direct/client/scheme.ts +115 -0
  32. package/src/exact-direct/facilitator/index.ts +4 -0
  33. package/src/exact-direct/facilitator/scheme.ts +308 -0
  34. package/src/exact-direct/server/index.ts +9 -0
  35. package/src/exact-direct/server/register.ts +57 -0
  36. package/src/exact-direct/server/scheme.ts +216 -0
  37. package/src/index.ts +78 -0
  38. package/src/tokens.ts +96 -0
  39. package/src/types.ts +184 -0
  40. package/src/utils.ts +198 -0
@@ -0,0 +1,395 @@
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
+ ExactDirectStacksFacilitator: () => ExactDirectStacksFacilitator,
24
+ createExactDirectStacksFacilitator: () => createExactDirectStacksFacilitator
25
+ });
26
+ module.exports = __toCommonJS(facilitator_exports);
27
+
28
+ // src/constants.ts
29
+ var STACKS_CAIP2_NAMESPACE = "stacks";
30
+ var STACKS_MAINNET_CAIP2 = "stacks:1";
31
+ var STACKS_TESTNET_CAIP2 = "stacks:2147483648";
32
+ var SCHEME_EXACT_DIRECT = "exact-direct";
33
+ var DEFAULT_MAINNET_API = "https://api.mainnet.hiro.so";
34
+ var DEFAULT_TESTNET_API = "https://api.testnet.hiro.so";
35
+ var STACKS_NETWORKS = {
36
+ [STACKS_MAINNET_CAIP2]: {
37
+ name: "Stacks Mainnet",
38
+ caip2: STACKS_MAINNET_CAIP2,
39
+ apiUrl: DEFAULT_MAINNET_API,
40
+ chainId: 1,
41
+ addressPrefix: "SP",
42
+ isTestnet: false
43
+ },
44
+ [STACKS_TESTNET_CAIP2]: {
45
+ name: "Stacks Testnet",
46
+ caip2: STACKS_TESTNET_CAIP2,
47
+ apiUrl: DEFAULT_TESTNET_API,
48
+ chainId: 2147483648,
49
+ addressPrefix: "ST",
50
+ isTestnet: true
51
+ }
52
+ };
53
+ function getNetworkConfig(network) {
54
+ return STACKS_NETWORKS[network];
55
+ }
56
+
57
+ // src/tokens.ts
58
+ var SUSDC_MAINNET = {
59
+ contractAddress: "SP3Y2ZSH8P7D50B0VBTSX11S7XSG24M1VB9YFQA4K.token-susdc",
60
+ symbol: "sUSDC",
61
+ name: "Stacks USDC",
62
+ decimals: 6,
63
+ issuer: "Stacks"
64
+ };
65
+ var SUSDC_TESTNET = {
66
+ contractAddress: "ST1PQHQKV0RJXZFY1DGX8MNSNYVE3VGZJSRTPGZGM.token-susdc",
67
+ symbol: "sUSDC",
68
+ name: "Test Stacks USDC",
69
+ decimals: 6
70
+ };
71
+ var TOKEN_REGISTRY = {
72
+ [STACKS_MAINNET_CAIP2]: {
73
+ sUSDC: SUSDC_MAINNET
74
+ },
75
+ [STACKS_TESTNET_CAIP2]: {
76
+ sUSDC: SUSDC_TESTNET
77
+ }
78
+ };
79
+ var DEFAULT_TOKENS = {
80
+ [STACKS_MAINNET_CAIP2]: SUSDC_MAINNET,
81
+ [STACKS_TESTNET_CAIP2]: SUSDC_TESTNET
82
+ };
83
+ function getDefaultToken(network) {
84
+ return DEFAULT_TOKENS[network];
85
+ }
86
+
87
+ // src/utils.ts
88
+ function isValidPrincipal(address) {
89
+ if (!address || typeof address !== "string") {
90
+ return false;
91
+ }
92
+ const parts = address.split(".");
93
+ const principal = parts[0];
94
+ const principalRegex = /^(SP|ST)[0-9A-HJ-NP-Za-km-z]{33,41}$/;
95
+ if (!principalRegex.test(principal)) {
96
+ return false;
97
+ }
98
+ if (parts.length === 2) {
99
+ const contractName = parts[1];
100
+ const contractNameRegex = /^[a-zA-Z][a-zA-Z0-9\-_]{0,127}$/;
101
+ return contractNameRegex.test(contractName);
102
+ }
103
+ return parts.length === 1;
104
+ }
105
+ function isValidTxId(hash) {
106
+ if (!hash || typeof hash !== "string") {
107
+ return false;
108
+ }
109
+ return /^0x[a-fA-F0-9]{64}$/.test(hash);
110
+ }
111
+ function comparePrincipals(a, b) {
112
+ return a === b;
113
+ }
114
+ function extractTokenTransfer(result, contractAddress) {
115
+ if (result.txStatus !== "success") {
116
+ return null;
117
+ }
118
+ if (result.txType !== "contract_call") {
119
+ return null;
120
+ }
121
+ if (result.contractCall) {
122
+ const { contractId, functionName } = result.contractCall;
123
+ if (functionName !== "transfer") {
124
+ return null;
125
+ }
126
+ if (contractAddress && contractId !== contractAddress) {
127
+ return null;
128
+ }
129
+ const transferEvent = result.events.find(
130
+ (e) => e.eventType === "fungible_token_asset" && e.asset?.assetEventType === "transfer"
131
+ );
132
+ if (transferEvent?.asset) {
133
+ return {
134
+ contractAddress: contractId,
135
+ from: transferEvent.asset.sender,
136
+ to: transferEvent.asset.recipient,
137
+ amount: transferEvent.asset.amount,
138
+ success: true
139
+ };
140
+ }
141
+ if (result.contractCall.functionArgs.length >= 3) {
142
+ const amountArg = result.contractCall.functionArgs[0];
143
+ const senderArg = result.contractCall.functionArgs[1];
144
+ const recipientArg = result.contractCall.functionArgs[2];
145
+ const senderMatch = senderArg?.repr?.match(/^'?(S[PT][0-9A-HJ-NP-Za-km-z]+)/);
146
+ const recipientMatch = recipientArg?.repr?.match(/^'?(S[PT][0-9A-HJ-NP-Za-km-z]+)/);
147
+ const amountMatch = amountArg?.repr?.match(/^u(\d+)$/);
148
+ if (senderMatch && recipientMatch && amountMatch) {
149
+ return {
150
+ contractAddress: contractId,
151
+ from: senderMatch[1],
152
+ to: recipientMatch[1],
153
+ amount: amountMatch[1],
154
+ success: true
155
+ };
156
+ }
157
+ }
158
+ }
159
+ return null;
160
+ }
161
+ function extractTokenTransferFromPostConditions(result, contractAddress) {
162
+ if (result.txStatus !== "success") {
163
+ return null;
164
+ }
165
+ for (const pc of result.postConditions) {
166
+ if (pc.asset) {
167
+ const assetContractAddress = `${pc.asset.contractAddress}.${pc.asset.contractName}`;
168
+ if (contractAddress && assetContractAddress !== contractAddress) {
169
+ continue;
170
+ }
171
+ const transferEvent = result.events.find(
172
+ (e) => e.eventType === "fungible_token_asset" && e.asset?.assetEventType === "transfer" && e.asset?.sender === pc.principal.address
173
+ );
174
+ if (transferEvent?.asset) {
175
+ return {
176
+ contractAddress: assetContractAddress,
177
+ from: transferEvent.asset.sender,
178
+ to: transferEvent.asset.recipient,
179
+ amount: transferEvent.asset.amount,
180
+ success: true
181
+ };
182
+ }
183
+ }
184
+ }
185
+ return null;
186
+ }
187
+
188
+ // src/exact-direct/facilitator/scheme.ts
189
+ var DEFAULT_MAX_TRANSACTION_AGE = 3600;
190
+ var DEFAULT_CACHE_DURATION = 24 * 60 * 60 * 1e3;
191
+ var ExactDirectStacksFacilitator = class {
192
+ scheme = SCHEME_EXACT_DIRECT;
193
+ caipFamily = `${STACKS_CAIP2_NAMESPACE}:*`;
194
+ signer;
195
+ config;
196
+ usedTransactions = /* @__PURE__ */ new Map();
197
+ constructor(signer, config = {}) {
198
+ this.signer = signer;
199
+ this.config = {
200
+ maxTransactionAge: config.maxTransactionAge ?? DEFAULT_MAX_TRANSACTION_AGE,
201
+ usedTxCacheDuration: config.usedTxCacheDuration ?? DEFAULT_CACHE_DURATION
202
+ };
203
+ this.startCleanupInterval();
204
+ }
205
+ /**
206
+ * Get extra data for payment requirements
207
+ */
208
+ getExtra(network) {
209
+ const config = getNetworkConfig(network);
210
+ if (!config) return void 0;
211
+ const token = getDefaultToken(network);
212
+ return {
213
+ contractAddress: token?.contractAddress,
214
+ assetSymbol: token?.symbol,
215
+ assetDecimals: token?.decimals,
216
+ networkName: config.name
217
+ };
218
+ }
219
+ /**
220
+ * Get facilitator signer addresses for a network
221
+ */
222
+ getSigners(network) {
223
+ return this.signer.getAddresses(network);
224
+ }
225
+ /**
226
+ * Verify a payment payload
227
+ */
228
+ async verify(payload, requirements) {
229
+ const network = requirements.network;
230
+ if (payload.accepted.scheme !== SCHEME_EXACT_DIRECT) {
231
+ return {
232
+ isValid: false,
233
+ invalidReason: `invalid_scheme: expected ${SCHEME_EXACT_DIRECT}, got ${payload.accepted.scheme}`
234
+ };
235
+ }
236
+ if (payload.accepted.network !== network) {
237
+ return {
238
+ isValid: false,
239
+ invalidReason: `network_mismatch: expected ${network}, got ${payload.accepted.network}`
240
+ };
241
+ }
242
+ const stacksPayload = payload.payload;
243
+ if (!stacksPayload.txId) {
244
+ return {
245
+ isValid: false,
246
+ invalidReason: "missing_tx_id"
247
+ };
248
+ }
249
+ if (!isValidTxId(stacksPayload.txId)) {
250
+ return {
251
+ isValid: false,
252
+ invalidReason: "invalid_tx_id_format"
253
+ };
254
+ }
255
+ if (!stacksPayload.from) {
256
+ return {
257
+ isValid: false,
258
+ invalidReason: "missing_from_address"
259
+ };
260
+ }
261
+ if (!isValidPrincipal(stacksPayload.from)) {
262
+ return {
263
+ isValid: false,
264
+ invalidReason: "invalid_from_address",
265
+ payer: stacksPayload.from
266
+ };
267
+ }
268
+ if (this.isTransactionUsed(stacksPayload.txId)) {
269
+ return {
270
+ isValid: false,
271
+ invalidReason: "transaction_already_used",
272
+ payer: stacksPayload.from
273
+ };
274
+ }
275
+ const txResult = await this.signer.queryTransaction(stacksPayload.txId);
276
+ if (!txResult) {
277
+ return {
278
+ isValid: false,
279
+ invalidReason: "transaction_not_found",
280
+ payer: stacksPayload.from
281
+ };
282
+ }
283
+ if (txResult.txStatus !== "success") {
284
+ return {
285
+ isValid: false,
286
+ invalidReason: `transaction_failed: status=${txResult.txStatus}`,
287
+ payer: stacksPayload.from
288
+ };
289
+ }
290
+ if (this.config.maxTransactionAge > 0) {
291
+ const txTime = txResult.burnBlockTime * 1e3;
292
+ const age = (Date.now() - txTime) / 1e3;
293
+ if (age > this.config.maxTransactionAge) {
294
+ return {
295
+ isValid: false,
296
+ invalidReason: `transaction_too_old: ${Math.round(age)} seconds`,
297
+ payer: stacksPayload.from
298
+ };
299
+ }
300
+ }
301
+ const expectedContract = requirements.extra?.contractAddress ?? stacksPayload.contractAddress;
302
+ const transfer = extractTokenTransfer(txResult, expectedContract) || extractTokenTransferFromPostConditions(txResult, expectedContract);
303
+ if (!transfer) {
304
+ return {
305
+ isValid: false,
306
+ invalidReason: "not_token_transfer",
307
+ payer: stacksPayload.from
308
+ };
309
+ }
310
+ if (expectedContract && !comparePrincipals(transfer.contractAddress, expectedContract)) {
311
+ return {
312
+ isValid: false,
313
+ invalidReason: `contract_mismatch: expected ${expectedContract}, got ${transfer.contractAddress}`,
314
+ payer: stacksPayload.from
315
+ };
316
+ }
317
+ if (!comparePrincipals(transfer.to, requirements.payTo)) {
318
+ return {
319
+ isValid: false,
320
+ invalidReason: `recipient_mismatch: expected ${requirements.payTo}, got ${transfer.to}`,
321
+ payer: stacksPayload.from
322
+ };
323
+ }
324
+ const txAmount = BigInt(transfer.amount);
325
+ const requiredAmount = BigInt(requirements.amount);
326
+ if (txAmount < requiredAmount) {
327
+ return {
328
+ isValid: false,
329
+ invalidReason: `insufficient_amount: expected ${requirements.amount}, got ${transfer.amount}`,
330
+ payer: stacksPayload.from
331
+ };
332
+ }
333
+ this.markTransactionUsed(stacksPayload.txId);
334
+ return {
335
+ isValid: true,
336
+ payer: stacksPayload.from
337
+ };
338
+ }
339
+ /**
340
+ * Settle a payment (for exact-direct, the transfer is already complete)
341
+ */
342
+ async settle(payload, requirements) {
343
+ const verifyResult = await this.verify(payload, requirements);
344
+ if (!verifyResult.isValid) {
345
+ return {
346
+ success: false,
347
+ errorReason: verifyResult.invalidReason || "verification_failed",
348
+ payer: verifyResult.payer,
349
+ transaction: "",
350
+ network: requirements.network
351
+ };
352
+ }
353
+ const stacksPayload = payload.payload;
354
+ return {
355
+ success: true,
356
+ transaction: stacksPayload.txId,
357
+ network: requirements.network,
358
+ payer: verifyResult.payer
359
+ };
360
+ }
361
+ /**
362
+ * Check if a transaction has been used
363
+ */
364
+ isTransactionUsed(txId) {
365
+ return this.usedTransactions.has(txId);
366
+ }
367
+ /**
368
+ * Mark a transaction as used
369
+ */
370
+ markTransactionUsed(txId) {
371
+ this.usedTransactions.set(txId, Date.now());
372
+ }
373
+ /**
374
+ * Start the cleanup interval for used transactions cache
375
+ */
376
+ startCleanupInterval() {
377
+ setInterval(() => {
378
+ const cutoff = Date.now() - this.config.usedTxCacheDuration;
379
+ for (const [txId, timestamp] of this.usedTransactions) {
380
+ if (timestamp < cutoff) {
381
+ this.usedTransactions.delete(txId);
382
+ }
383
+ }
384
+ }, 60 * 60 * 1e3);
385
+ }
386
+ };
387
+ function createExactDirectStacksFacilitator(signer, config = {}) {
388
+ return new ExactDirectStacksFacilitator(signer, config);
389
+ }
390
+ // Annotate the CommonJS export names for ESM import in node:
391
+ 0 && (module.exports = {
392
+ ExactDirectStacksFacilitator,
393
+ createExactDirectStacksFacilitator
394
+ });
395
+ //# sourceMappingURL=index.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../../src/exact-direct/facilitator/index.ts","../../../src/constants.ts","../../../src/tokens.ts","../../../src/utils.ts","../../../src/exact-direct/facilitator/scheme.ts"],"sourcesContent":["export {\n ExactDirectStacksFacilitator,\n createExactDirectStacksFacilitator,\n} from \"./scheme.js\";\n","/**\n * Stacks T402 Constants\n *\n * Stacks is a Bitcoin Layer 2 that brings smart contracts and DeFi\n * to Bitcoin. SIP-010 is the fungible token standard on Stacks.\n */\n\n// CAIP-2 namespace for Stacks\nexport const STACKS_CAIP2_NAMESPACE = \"stacks\";\n\n// CAIP-2 network identifiers\n// Stacks Mainnet (chain ID: 1)\nexport const STACKS_MAINNET_CAIP2 = \"stacks:1\";\n\n// Stacks Testnet (chain ID: 2147483648)\nexport const STACKS_TESTNET_CAIP2 = \"stacks:2147483648\";\n\n// Scheme identifier\nexport const SCHEME_EXACT_DIRECT = \"exact-direct\";\n\n// Default API endpoints (Hiro API)\nexport const DEFAULT_MAINNET_API = \"https://api.mainnet.hiro.so\";\nexport const DEFAULT_TESTNET_API = \"https://api.testnet.hiro.so\";\n\n// Network configurations\nexport interface StacksNetworkConfig {\n readonly name: string;\n readonly caip2: string;\n readonly apiUrl: string;\n readonly chainId: number;\n readonly addressPrefix: string;\n readonly isTestnet: boolean;\n}\n\nexport const STACKS_NETWORKS: Record<string, StacksNetworkConfig> = {\n [STACKS_MAINNET_CAIP2]: {\n name: \"Stacks Mainnet\",\n caip2: STACKS_MAINNET_CAIP2,\n apiUrl: DEFAULT_MAINNET_API,\n chainId: 1,\n addressPrefix: \"SP\",\n isTestnet: false,\n },\n [STACKS_TESTNET_CAIP2]: {\n name: \"Stacks Testnet\",\n caip2: STACKS_TESTNET_CAIP2,\n apiUrl: DEFAULT_TESTNET_API,\n chainId: 2147483648,\n addressPrefix: \"ST\",\n isTestnet: true,\n },\n};\n\n/**\n * Get network configuration by CAIP-2 identifier\n */\nexport function getNetworkConfig(network: string): StacksNetworkConfig | undefined {\n return STACKS_NETWORKS[network];\n}\n\n/**\n * Check if a network identifier is a Stacks network\n */\nexport function isStacksNetwork(network: string): boolean {\n return network.startsWith(`${STACKS_CAIP2_NAMESPACE}:`);\n}\n","/**\n * Stacks Token Registry\n *\n * On Stacks, tokens are SIP-010 fungible tokens identified by\n * their contract address (principal.contract-name).\n */\n\nimport {\n STACKS_MAINNET_CAIP2,\n STACKS_TESTNET_CAIP2,\n} from \"./constants.js\";\n\n/**\n * Token configuration for Stacks SIP-010 tokens\n */\nexport interface TokenConfig {\n /** Contract address (principal.contract-name) */\n readonly contractAddress: string;\n /** Token symbol */\n readonly symbol: string;\n /** Token name */\n readonly name: string;\n /** Decimal places */\n readonly decimals: number;\n /** Token issuer */\n readonly issuer?: string;\n}\n\n/**\n * sUSDC on Stacks Mainnet\n * Contract: SP3Y2ZSH8P7D50B0VBTSX11S7XSG24M1VB9YFQA4K.token-susdc\n * Decimals: 6\n */\nexport const SUSDC_MAINNET: TokenConfig = {\n contractAddress: \"SP3Y2ZSH8P7D50B0VBTSX11S7XSG24M1VB9YFQA4K.token-susdc\",\n symbol: \"sUSDC\",\n name: \"Stacks USDC\",\n decimals: 6,\n issuer: \"Stacks\",\n};\n\n/**\n * sUSDC on Stacks Testnet\n * Contract: ST1PQHQKV0RJXZFY1DGX8MNSNYVE3VGZJSRTPGZGM.token-susdc\n * Decimals: 6\n */\nexport const SUSDC_TESTNET: TokenConfig = {\n contractAddress: \"ST1PQHQKV0RJXZFY1DGX8MNSNYVE3VGZJSRTPGZGM.token-susdc\",\n symbol: \"sUSDC\",\n name: \"Test Stacks USDC\",\n decimals: 6,\n};\n\n/**\n * Network-specific token registries\n */\nexport const TOKEN_REGISTRY: Record<string, Record<string, TokenConfig>> = {\n [STACKS_MAINNET_CAIP2]: {\n sUSDC: SUSDC_MAINNET,\n },\n [STACKS_TESTNET_CAIP2]: {\n sUSDC: SUSDC_TESTNET,\n },\n};\n\n/**\n * Default tokens per network\n */\nexport const DEFAULT_TOKENS: Record<string, TokenConfig> = {\n [STACKS_MAINNET_CAIP2]: SUSDC_MAINNET,\n [STACKS_TESTNET_CAIP2]: SUSDC_TESTNET,\n};\n\n/**\n * Get token configuration by network and symbol\n */\nexport function getTokenConfig(\n network: string,\n symbol: string = \"sUSDC\",\n): TokenConfig | undefined {\n return TOKEN_REGISTRY[network]?.[symbol];\n}\n\n/**\n * Get the default token for a network\n */\nexport function getDefaultToken(network: string): TokenConfig | undefined {\n return DEFAULT_TOKENS[network];\n}\n\n/**\n * Get contract address for a token on a network\n */\nexport function getContractAddress(network: string, symbol: string = \"sUSDC\"): string | undefined {\n return getTokenConfig(network, symbol)?.contractAddress;\n}\n","/**\n * Stacks Utility Functions\n */\n\nimport type { StacksTransactionResult, ParsedTokenTransfer } from \"./types.js\";\n\n/**\n * Validate a Stacks principal address format\n * Stacks addresses start with SP (mainnet) or ST (testnet)\n * followed by alphanumeric characters (base58-like encoding)\n */\nexport function isValidPrincipal(address: string): boolean {\n if (!address || typeof address !== \"string\") {\n return false;\n }\n\n // Standard principal: SP/ST prefix + base58 characters (33-41 chars total)\n // Contract principal: standard-principal.contract-name\n const parts = address.split(\".\");\n const principal = parts[0];\n\n // Check principal format: SP or ST prefix + alphanumeric (base58 chars)\n const principalRegex = /^(SP|ST)[0-9A-HJ-NP-Za-km-z]{33,41}$/;\n if (!principalRegex.test(principal)) {\n return false;\n }\n\n // If it's a contract principal, validate contract name\n if (parts.length === 2) {\n const contractName = parts[1];\n // Contract names: 1-128 chars, alphanumeric + hyphen + underscore\n const contractNameRegex = /^[a-zA-Z][a-zA-Z0-9\\-_]{0,127}$/;\n return contractNameRegex.test(contractName);\n }\n\n // Standard principal (no contract part) or exactly one dot for contract\n return parts.length === 1;\n}\n\n/**\n * Validate a Stacks transaction ID format\n * Transaction IDs are 0x-prefixed 64-character hex strings\n */\nexport function isValidTxId(hash: string): boolean {\n if (!hash || typeof hash !== \"string\") {\n return false;\n }\n return /^0x[a-fA-F0-9]{64}$/.test(hash);\n}\n\n/**\n * Compare two Stacks principals (case-sensitive)\n */\nexport function comparePrincipals(a: string, b: string): boolean {\n return a === b;\n}\n\n/**\n * Format an amount with decimals for display\n */\nexport function formatAmount(amount: string, decimals: number): string {\n const amountBigInt = BigInt(amount);\n const divisor = BigInt(10 ** decimals);\n const wholePart = amountBigInt / divisor;\n const fractionalPart = amountBigInt % divisor;\n\n if (fractionalPart === 0n) {\n return wholePart.toString();\n }\n\n const fractionalStr = fractionalPart.toString().padStart(decimals, \"0\");\n const trimmedFractional = fractionalStr.replace(/0+$/, \"\");\n return `${wholePart}.${trimmedFractional}`;\n}\n\n/**\n * Parse an amount string to the smallest unit (with decimals applied)\n */\nexport function parseAmount(amount: string, decimals: number): string {\n const parts = amount.split(\".\");\n const wholePart = parts[0] || \"0\";\n const fractionalPart = (parts[1] || \"\").padEnd(decimals, \"0\").slice(0, decimals);\n return BigInt(wholePart + fractionalPart).toString();\n}\n\n/**\n * Extract token transfer details from a Stacks transaction result\n * Looks for ft_transfer events matching the expected contract\n */\nexport function extractTokenTransfer(\n result: StacksTransactionResult,\n contractAddress?: string,\n): ParsedTokenTransfer | null {\n if (result.txStatus !== \"success\") {\n return null;\n }\n\n // Check if this is a contract-call transaction\n if (result.txType !== \"contract_call\") {\n return null;\n }\n\n // Check contract call is a transfer function\n if (result.contractCall) {\n const { contractId, functionName } = result.contractCall;\n\n if (functionName !== \"transfer\") {\n return null;\n }\n\n // If contractAddress specified, verify it matches\n if (contractAddress && contractId !== contractAddress) {\n return null;\n }\n\n // Look for ft_transfer event\n const transferEvent = result.events.find(\n (e) => e.eventType === \"fungible_token_asset\" && e.asset?.assetEventType === \"transfer\",\n );\n\n if (transferEvent?.asset) {\n return {\n contractAddress: contractId,\n from: transferEvent.asset.sender,\n to: transferEvent.asset.recipient,\n amount: transferEvent.asset.amount,\n success: true,\n };\n }\n\n // Fallback: extract from function args if events not available\n if (result.contractCall.functionArgs.length >= 3) {\n const amountArg = result.contractCall.functionArgs[0];\n const senderArg = result.contractCall.functionArgs[1];\n const recipientArg = result.contractCall.functionArgs[2];\n\n // Parse principal from repr (format: 'SP...')\n const senderMatch = senderArg?.repr?.match(/^'?(S[PT][0-9A-HJ-NP-Za-km-z]+)/);\n const recipientMatch = recipientArg?.repr?.match(/^'?(S[PT][0-9A-HJ-NP-Za-km-z]+)/);\n const amountMatch = amountArg?.repr?.match(/^u(\\d+)$/);\n\n if (senderMatch && recipientMatch && amountMatch) {\n return {\n contractAddress: contractId,\n from: senderMatch[1],\n to: recipientMatch[1],\n amount: amountMatch[1],\n success: true,\n };\n }\n }\n }\n\n return null;\n}\n\n/**\n * Extract token transfer from post conditions (alternative method)\n */\nexport function extractTokenTransferFromPostConditions(\n result: StacksTransactionResult,\n contractAddress?: string,\n): ParsedTokenTransfer | null {\n if (result.txStatus !== \"success\") {\n return null;\n }\n\n // Look for fungible token post conditions\n for (const pc of result.postConditions) {\n if (pc.asset) {\n const assetContractAddress = `${pc.asset.contractAddress}.${pc.asset.contractName}`;\n\n if (contractAddress && assetContractAddress !== contractAddress) {\n continue;\n }\n\n // Find corresponding ft_transfer event for recipient\n const transferEvent = result.events.find(\n (e) =>\n e.eventType === \"fungible_token_asset\" &&\n e.asset?.assetEventType === \"transfer\" &&\n e.asset?.sender === pc.principal.address,\n );\n\n if (transferEvent?.asset) {\n return {\n contractAddress: assetContractAddress,\n from: transferEvent.asset.sender,\n to: transferEvent.asset.recipient,\n amount: transferEvent.asset.amount,\n success: true,\n };\n }\n }\n }\n\n return null;\n}\n","/**\n * Stacks Exact-Direct Facilitator Scheme\n *\n * Verifies that a Stacks SIP-010 token transfer was executed correctly\n * by querying the Hiro API.\n */\n\nimport type {\n Network,\n PaymentPayload,\n PaymentRequirements,\n SchemeNetworkFacilitator,\n SettleResponse,\n VerifyResponse,\n} from \"@t402/core/types\";\nimport { STACKS_CAIP2_NAMESPACE, SCHEME_EXACT_DIRECT, getNetworkConfig } from \"../../constants.js\";\nimport { getDefaultToken } from \"../../tokens.js\";\nimport type {\n ExactDirectStacksPayload,\n FacilitatorStacksSigner,\n StacksFacilitatorConfig,\n} from \"../../types.js\";\nimport {\n comparePrincipals,\n extractTokenTransfer,\n extractTokenTransferFromPostConditions,\n isValidTxId,\n isValidPrincipal,\n} from \"../../utils.js\";\n\n// Default configuration\nconst DEFAULT_MAX_TRANSACTION_AGE = 3600; // 1 hour\nconst DEFAULT_CACHE_DURATION = 24 * 60 * 60 * 1000; // 24 hours in ms\n\n/**\n * Exact-direct facilitator scheme for Stacks\n */\nexport class ExactDirectStacksFacilitator implements SchemeNetworkFacilitator {\n readonly scheme = SCHEME_EXACT_DIRECT;\n readonly caipFamily = `${STACKS_CAIP2_NAMESPACE}:*`;\n\n private readonly signer: FacilitatorStacksSigner;\n private readonly config: Required<StacksFacilitatorConfig>;\n private readonly usedTransactions = new Map<string, number>();\n\n constructor(\n signer: FacilitatorStacksSigner,\n config: StacksFacilitatorConfig = {},\n ) {\n this.signer = signer;\n this.config = {\n maxTransactionAge: config.maxTransactionAge ?? DEFAULT_MAX_TRANSACTION_AGE,\n usedTxCacheDuration:\n config.usedTxCacheDuration ?? DEFAULT_CACHE_DURATION,\n };\n\n // Start cleanup interval\n this.startCleanupInterval();\n }\n\n /**\n * Get extra data for payment requirements\n */\n getExtra(network: Network): Record<string, unknown> | undefined {\n const config = getNetworkConfig(network);\n if (!config) return undefined;\n\n const token = getDefaultToken(network);\n return {\n contractAddress: token?.contractAddress,\n assetSymbol: token?.symbol,\n assetDecimals: token?.decimals,\n networkName: config.name,\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 const network = requirements.network;\n\n // Validate scheme\n if (payload.accepted.scheme !== SCHEME_EXACT_DIRECT) {\n return {\n isValid: false,\n invalidReason: `invalid_scheme: expected ${SCHEME_EXACT_DIRECT}, got ${payload.accepted.scheme}`,\n };\n }\n\n // Validate network\n if (payload.accepted.network !== network) {\n return {\n isValid: false,\n invalidReason: `network_mismatch: expected ${network}, got ${payload.accepted.network}`,\n };\n }\n\n // Parse payload\n const stacksPayload = payload.payload as unknown as ExactDirectStacksPayload;\n\n // Validate required fields\n if (!stacksPayload.txId) {\n return {\n isValid: false,\n invalidReason: \"missing_tx_id\",\n };\n }\n\n // Validate tx ID format\n if (!isValidTxId(stacksPayload.txId)) {\n return {\n isValid: false,\n invalidReason: \"invalid_tx_id_format\",\n };\n }\n\n // Validate from address\n if (!stacksPayload.from) {\n return {\n isValid: false,\n invalidReason: \"missing_from_address\",\n };\n }\n\n if (!isValidPrincipal(stacksPayload.from)) {\n return {\n isValid: false,\n invalidReason: \"invalid_from_address\",\n payer: stacksPayload.from,\n };\n }\n\n // Check for replay attack\n if (this.isTransactionUsed(stacksPayload.txId)) {\n return {\n isValid: false,\n invalidReason: \"transaction_already_used\",\n payer: stacksPayload.from,\n };\n }\n\n // Query transaction\n const txResult = await this.signer.queryTransaction(stacksPayload.txId);\n\n if (!txResult) {\n return {\n isValid: false,\n invalidReason: \"transaction_not_found\",\n payer: stacksPayload.from,\n };\n }\n\n // Verify transaction was successful\n if (txResult.txStatus !== \"success\") {\n return {\n isValid: false,\n invalidReason: `transaction_failed: status=${txResult.txStatus}`,\n payer: stacksPayload.from,\n };\n }\n\n // Check transaction age\n if (this.config.maxTransactionAge > 0) {\n const txTime = txResult.burnBlockTime * 1000; // Convert to milliseconds\n const age = (Date.now() - txTime) / 1000;\n if (age > this.config.maxTransactionAge) {\n return {\n isValid: false,\n invalidReason: `transaction_too_old: ${Math.round(age)} seconds`,\n payer: stacksPayload.from,\n };\n }\n }\n\n // Extract transfer details\n const expectedContract = (requirements.extra?.contractAddress as string) ??\n stacksPayload.contractAddress;\n\n const transfer =\n extractTokenTransfer(txResult, expectedContract) ||\n extractTokenTransferFromPostConditions(txResult, expectedContract);\n\n if (!transfer) {\n return {\n isValid: false,\n invalidReason: \"not_token_transfer\",\n payer: stacksPayload.from,\n };\n }\n\n // Verify contract address\n if (expectedContract && !comparePrincipals(transfer.contractAddress, expectedContract)) {\n return {\n isValid: false,\n invalidReason: `contract_mismatch: expected ${expectedContract}, got ${transfer.contractAddress}`,\n payer: stacksPayload.from,\n };\n }\n\n // Verify recipient\n if (!comparePrincipals(transfer.to, requirements.payTo)) {\n return {\n isValid: false,\n invalidReason: `recipient_mismatch: expected ${requirements.payTo}, got ${transfer.to}`,\n payer: stacksPayload.from,\n };\n }\n\n // Verify amount\n const txAmount = BigInt(transfer.amount);\n const requiredAmount = BigInt(requirements.amount);\n if (txAmount < requiredAmount) {\n return {\n isValid: false,\n invalidReason: `insufficient_amount: expected ${requirements.amount}, got ${transfer.amount}`,\n payer: stacksPayload.from,\n };\n }\n\n // Mark transaction as used\n this.markTransactionUsed(stacksPayload.txId);\n\n return {\n isValid: true,\n payer: stacksPayload.from,\n };\n }\n\n /**\n * Settle a payment (for exact-direct, the transfer is already complete)\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 stacksPayload = payload.payload as unknown as ExactDirectStacksPayload;\n\n // For exact-direct, settlement is already complete\n return {\n success: true,\n transaction: stacksPayload.txId,\n network: requirements.network,\n payer: verifyResult.payer,\n };\n }\n\n /**\n * Check if a transaction has been used\n */\n private isTransactionUsed(txId: string): boolean {\n return this.usedTransactions.has(txId);\n }\n\n /**\n * Mark a transaction as used\n */\n private markTransactionUsed(txId: string): void {\n this.usedTransactions.set(txId, Date.now());\n }\n\n /**\n * Start the cleanup interval for used transactions cache\n */\n private startCleanupInterval(): void {\n setInterval(() => {\n const cutoff = Date.now() - this.config.usedTxCacheDuration;\n for (const [txId, timestamp] of this.usedTransactions) {\n if (timestamp < cutoff) {\n this.usedTransactions.delete(txId);\n }\n }\n }, 60 * 60 * 1000); // Run every hour\n }\n}\n\n/**\n * Create an exact-direct facilitator for Stacks\n */\nexport function createExactDirectStacksFacilitator(\n signer: FacilitatorStacksSigner,\n config: StacksFacilitatorConfig = {},\n): ExactDirectStacksFacilitator {\n return new ExactDirectStacksFacilitator(signer, config);\n}\n"],"mappings":"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","names":[]}
@@ -0,0 +1,55 @@
1
+ import { SchemeNetworkFacilitator, Network, PaymentPayload, PaymentRequirements, VerifyResponse, SettleResponse } from '@t402/core/types';
2
+ import { F as FacilitatorStacksSigner, f as StacksFacilitatorConfig } from '../../types-Bxzo3eQ1.cjs';
3
+
4
+ /**
5
+ * Stacks Exact-Direct Facilitator Scheme
6
+ *
7
+ * Verifies that a Stacks SIP-010 token transfer was executed correctly
8
+ * by querying the Hiro API.
9
+ */
10
+
11
+ /**
12
+ * Exact-direct facilitator scheme for Stacks
13
+ */
14
+ declare class ExactDirectStacksFacilitator implements SchemeNetworkFacilitator {
15
+ readonly scheme = "exact-direct";
16
+ readonly caipFamily = "stacks:*";
17
+ private readonly signer;
18
+ private readonly config;
19
+ private readonly usedTransactions;
20
+ constructor(signer: FacilitatorStacksSigner, config?: StacksFacilitatorConfig);
21
+ /**
22
+ * Get extra data for payment requirements
23
+ */
24
+ getExtra(network: Network): Record<string, unknown> | undefined;
25
+ /**
26
+ * Get facilitator signer addresses for a network
27
+ */
28
+ getSigners(network: Network): string[];
29
+ /**
30
+ * Verify a payment payload
31
+ */
32
+ verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
33
+ /**
34
+ * Settle a payment (for exact-direct, the transfer is already complete)
35
+ */
36
+ settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
37
+ /**
38
+ * Check if a transaction has been used
39
+ */
40
+ private isTransactionUsed;
41
+ /**
42
+ * Mark a transaction as used
43
+ */
44
+ private markTransactionUsed;
45
+ /**
46
+ * Start the cleanup interval for used transactions cache
47
+ */
48
+ private startCleanupInterval;
49
+ }
50
+ /**
51
+ * Create an exact-direct facilitator for Stacks
52
+ */
53
+ declare function createExactDirectStacksFacilitator(signer: FacilitatorStacksSigner, config?: StacksFacilitatorConfig): ExactDirectStacksFacilitator;
54
+
55
+ export { ExactDirectStacksFacilitator, createExactDirectStacksFacilitator };
@@ -0,0 +1,55 @@
1
+ import { SchemeNetworkFacilitator, Network, PaymentPayload, PaymentRequirements, VerifyResponse, SettleResponse } from '@t402/core/types';
2
+ import { F as FacilitatorStacksSigner, f as StacksFacilitatorConfig } from '../../types-Bxzo3eQ1.js';
3
+
4
+ /**
5
+ * Stacks Exact-Direct Facilitator Scheme
6
+ *
7
+ * Verifies that a Stacks SIP-010 token transfer was executed correctly
8
+ * by querying the Hiro API.
9
+ */
10
+
11
+ /**
12
+ * Exact-direct facilitator scheme for Stacks
13
+ */
14
+ declare class ExactDirectStacksFacilitator implements SchemeNetworkFacilitator {
15
+ readonly scheme = "exact-direct";
16
+ readonly caipFamily = "stacks:*";
17
+ private readonly signer;
18
+ private readonly config;
19
+ private readonly usedTransactions;
20
+ constructor(signer: FacilitatorStacksSigner, config?: StacksFacilitatorConfig);
21
+ /**
22
+ * Get extra data for payment requirements
23
+ */
24
+ getExtra(network: Network): Record<string, unknown> | undefined;
25
+ /**
26
+ * Get facilitator signer addresses for a network
27
+ */
28
+ getSigners(network: Network): string[];
29
+ /**
30
+ * Verify a payment payload
31
+ */
32
+ verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
33
+ /**
34
+ * Settle a payment (for exact-direct, the transfer is already complete)
35
+ */
36
+ settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
37
+ /**
38
+ * Check if a transaction has been used
39
+ */
40
+ private isTransactionUsed;
41
+ /**
42
+ * Mark a transaction as used
43
+ */
44
+ private markTransactionUsed;
45
+ /**
46
+ * Start the cleanup interval for used transactions cache
47
+ */
48
+ private startCleanupInterval;
49
+ }
50
+ /**
51
+ * Create an exact-direct facilitator for Stacks
52
+ */
53
+ declare function createExactDirectStacksFacilitator(signer: FacilitatorStacksSigner, config?: StacksFacilitatorConfig): ExactDirectStacksFacilitator;
54
+
55
+ export { ExactDirectStacksFacilitator, createExactDirectStacksFacilitator };