@t402/stacks 2.4.0

package/dist/exact-direct/facilitator/index.mjs

@@ -0,0 +1,367 @@
+// src/constants.ts
+var STACKS_CAIP2_NAMESPACE = "stacks";
+var STACKS_MAINNET_CAIP2 = "stacks:1";
+var STACKS_TESTNET_CAIP2 = "stacks:2147483648";
+var SCHEME_EXACT_DIRECT = "exact-direct";
+var DEFAULT_MAINNET_API = "https://api.mainnet.hiro.so";
+var DEFAULT_TESTNET_API = "https://api.testnet.hiro.so";
+var STACKS_NETWORKS = {
+  [STACKS_MAINNET_CAIP2]: {
+    name: "Stacks Mainnet",
+    caip2: STACKS_MAINNET_CAIP2,
+    apiUrl: DEFAULT_MAINNET_API,
+    chainId: 1,
+    addressPrefix: "SP",
+    isTestnet: false
+  },
+  [STACKS_TESTNET_CAIP2]: {
+    name: "Stacks Testnet",
+    caip2: STACKS_TESTNET_CAIP2,
+    apiUrl: DEFAULT_TESTNET_API,
+    chainId: 2147483648,
+    addressPrefix: "ST",
+    isTestnet: true
+  }
+};
+function getNetworkConfig(network) {
+  return STACKS_NETWORKS[network];
+}
+
+// src/tokens.ts
+var SUSDC_MAINNET = {
+  contractAddress: "SP3Y2ZSH8P7D50B0VBTSX11S7XSG24M1VB9YFQA4K.token-susdc",
+  symbol: "sUSDC",
+  name: "Stacks USDC",
+  decimals: 6,
+  issuer: "Stacks"
+};
+var SUSDC_TESTNET = {
+  contractAddress: "ST1PQHQKV0RJXZFY1DGX8MNSNYVE3VGZJSRTPGZGM.token-susdc",
+  symbol: "sUSDC",
+  name: "Test Stacks USDC",
+  decimals: 6
+};
+var TOKEN_REGISTRY = {
+  [STACKS_MAINNET_CAIP2]: {
+    sUSDC: SUSDC_MAINNET
+  },
+  [STACKS_TESTNET_CAIP2]: {
+    sUSDC: SUSDC_TESTNET
+  }
+};
+var DEFAULT_TOKENS = {
+  [STACKS_MAINNET_CAIP2]: SUSDC_MAINNET,
+  [STACKS_TESTNET_CAIP2]: SUSDC_TESTNET
+};
+function getDefaultToken(network) {
+  return DEFAULT_TOKENS[network];
+}
+
+// src/utils.ts
+function isValidPrincipal(address) {
+  if (!address || typeof address !== "string") {
+    return false;
+  }
+  const parts = address.split(".");
+  const principal = parts[0];
+  const principalRegex = /^(SP|ST)[0-9A-HJ-NP-Za-km-z]{33,41}$/;
+  if (!principalRegex.test(principal)) {
+    return false;
+  }
+  if (parts.length === 2) {
+    const contractName = parts[1];
+    const contractNameRegex = /^[a-zA-Z][a-zA-Z0-9\-_]{0,127}$/;
+    return contractNameRegex.test(contractName);
+  }
+  return parts.length === 1;
+}
+function isValidTxId(hash) {
+  if (!hash || typeof hash !== "string") {
+    return false;
+  }
+  return /^0x[a-fA-F0-9]{64}$/.test(hash);
+}
+function comparePrincipals(a, b) {
+  return a === b;
+}
+function extractTokenTransfer(result, contractAddress) {
+  if (result.txStatus !== "success") {
+    return null;
+  }
+  if (result.txType !== "contract_call") {
+    return null;
+  }
+  if (result.contractCall) {
+    const { contractId, functionName } = result.contractCall;
+    if (functionName !== "transfer") {
+      return null;
+    }
+    if (contractAddress && contractId !== contractAddress) {
+      return null;
+    }
+    const transferEvent = result.events.find(
+      (e) => e.eventType === "fungible_token_asset" && e.asset?.assetEventType === "transfer"
+    );
+    if (transferEvent?.asset) {
+      return {
+        contractAddress: contractId,
+        from: transferEvent.asset.sender,
+        to: transferEvent.asset.recipient,
+        amount: transferEvent.asset.amount,
+        success: true
+      };
+    }
+    if (result.contractCall.functionArgs.length >= 3) {
+      const amountArg = result.contractCall.functionArgs[0];
+      const senderArg = result.contractCall.functionArgs[1];
+      const recipientArg = result.contractCall.functionArgs[2];
+      const senderMatch = senderArg?.repr?.match(/^'?(S[PT][0-9A-HJ-NP-Za-km-z]+)/);
+      const recipientMatch = recipientArg?.repr?.match(/^'?(S[PT][0-9A-HJ-NP-Za-km-z]+)/);
+      const amountMatch = amountArg?.repr?.match(/^u(\d+)$/);
+      if (senderMatch && recipientMatch && amountMatch) {
+        return {
+          contractAddress: contractId,
+          from: senderMatch[1],
+          to: recipientMatch[1],
+          amount: amountMatch[1],
+          success: true
+        };
+      }
+    }
+  }
+  return null;
+}
+function extractTokenTransferFromPostConditions(result, contractAddress) {
+  if (result.txStatus !== "success") {
+    return null;
+  }
+  for (const pc of result.postConditions) {
+    if (pc.asset) {
+      const assetContractAddress = `${pc.asset.contractAddress}.${pc.asset.contractName}`;
+      if (contractAddress && assetContractAddress !== contractAddress) {
+        continue;
+      }
+      const transferEvent = result.events.find(
+        (e) => e.eventType === "fungible_token_asset" && e.asset?.assetEventType === "transfer" && e.asset?.sender === pc.principal.address
+      );
+      if (transferEvent?.asset) {
+        return {
+          contractAddress: assetContractAddress,
+          from: transferEvent.asset.sender,
+          to: transferEvent.asset.recipient,
+          amount: transferEvent.asset.amount,
+          success: true
+        };
+      }
+    }
+  }
+  return null;
+}
+
+// src/exact-direct/facilitator/scheme.ts
+var DEFAULT_MAX_TRANSACTION_AGE = 3600;
+var DEFAULT_CACHE_DURATION = 24 * 60 * 60 * 1e3;
+var ExactDirectStacksFacilitator = class {
+  scheme = SCHEME_EXACT_DIRECT;
+  caipFamily = `${STACKS_CAIP2_NAMESPACE}:*`;
+  signer;
+  config;
+  usedTransactions = /* @__PURE__ */ new Map();
+  constructor(signer, config = {}) {
+    this.signer = signer;
+    this.config = {
+      maxTransactionAge: config.maxTransactionAge ?? DEFAULT_MAX_TRANSACTION_AGE,
+      usedTxCacheDuration: config.usedTxCacheDuration ?? DEFAULT_CACHE_DURATION
+    };
+    this.startCleanupInterval();
+  }
+  /**
+   * Get extra data for payment requirements
+   */
+  getExtra(network) {
+    const config = getNetworkConfig(network);
+    if (!config) return void 0;
+    const token = getDefaultToken(network);
+    return {
+      contractAddress: token?.contractAddress,
+      assetSymbol: token?.symbol,
+      assetDecimals: token?.decimals,
+      networkName: config.name
+    };
+  }
+  /**
+   * Get facilitator signer addresses for a network
+   */
+  getSigners(network) {
+    return this.signer.getAddresses(network);
+  }
+  /**
+   * Verify a payment payload
+   */
+  async verify(payload, requirements) {
+    const network = requirements.network;
+    if (payload.accepted.scheme !== SCHEME_EXACT_DIRECT) {
+      return {
+        isValid: false,
+        invalidReason: `invalid_scheme: expected ${SCHEME_EXACT_DIRECT}, got ${payload.accepted.scheme}`
+      };
+    }
+    if (payload.accepted.network !== network) {
+      return {
+        isValid: false,
+        invalidReason: `network_mismatch: expected ${network}, got ${payload.accepted.network}`
+      };
+    }
+    const stacksPayload = payload.payload;
+    if (!stacksPayload.txId) {
+      return {
+        isValid: false,
+        invalidReason: "missing_tx_id"
+      };
+    }
+    if (!isValidTxId(stacksPayload.txId)) {
+      return {
+        isValid: false,
+        invalidReason: "invalid_tx_id_format"
+      };
+    }
+    if (!stacksPayload.from) {
+      return {
+        isValid: false,
+        invalidReason: "missing_from_address"
+      };
+    }
+    if (!isValidPrincipal(stacksPayload.from)) {
+      return {
+        isValid: false,
+        invalidReason: "invalid_from_address",
+        payer: stacksPayload.from
+      };
+    }
+    if (this.isTransactionUsed(stacksPayload.txId)) {
+      return {
+        isValid: false,
+        invalidReason: "transaction_already_used",
+        payer: stacksPayload.from
+      };
+    }
+    const txResult = await this.signer.queryTransaction(stacksPayload.txId);
+    if (!txResult) {
+      return {
+        isValid: false,
+        invalidReason: "transaction_not_found",
+        payer: stacksPayload.from
+      };
+    }
+    if (txResult.txStatus !== "success") {
+      return {
+        isValid: false,
+        invalidReason: `transaction_failed: status=${txResult.txStatus}`,
+        payer: stacksPayload.from
+      };
+    }
+    if (this.config.maxTransactionAge > 0) {
+      const txTime = txResult.burnBlockTime * 1e3;
+      const age = (Date.now() - txTime) / 1e3;
+      if (age > this.config.maxTransactionAge) {
+        return {
+          isValid: false,
+          invalidReason: `transaction_too_old: ${Math.round(age)} seconds`,
+          payer: stacksPayload.from
+        };
+      }
+    }
+    const expectedContract = requirements.extra?.contractAddress ?? stacksPayload.contractAddress;
+    const transfer = extractTokenTransfer(txResult, expectedContract) || extractTokenTransferFromPostConditions(txResult, expectedContract);
+    if (!transfer) {
+      return {
+        isValid: false,
+        invalidReason: "not_token_transfer",
+        payer: stacksPayload.from
+      };
+    }
+    if (expectedContract && !comparePrincipals(transfer.contractAddress, expectedContract)) {
+      return {
+        isValid: false,
+        invalidReason: `contract_mismatch: expected ${expectedContract}, got ${transfer.contractAddress}`,
+        payer: stacksPayload.from
+      };
+    }
+    if (!comparePrincipals(transfer.to, requirements.payTo)) {
+      return {
+        isValid: false,
+        invalidReason: `recipient_mismatch: expected ${requirements.payTo}, got ${transfer.to}`,
+        payer: stacksPayload.from
+      };
+    }
+    const txAmount = BigInt(transfer.amount);
+    const requiredAmount = BigInt(requirements.amount);
+    if (txAmount < requiredAmount) {
+      return {
+        isValid: false,
+        invalidReason: `insufficient_amount: expected ${requirements.amount}, got ${transfer.amount}`,
+        payer: stacksPayload.from
+      };
+    }
+    this.markTransactionUsed(stacksPayload.txId);
+    return {
+      isValid: true,
+      payer: stacksPayload.from
+    };
+  }
+  /**
+   * Settle a payment (for exact-direct, the transfer is already complete)
+   */
+  async settle(payload, requirements) {
+    const verifyResult = await this.verify(payload, requirements);
+    if (!verifyResult.isValid) {
+      return {
+        success: false,
+        errorReason: verifyResult.invalidReason || "verification_failed",
+        payer: verifyResult.payer,
+        transaction: "",
+        network: requirements.network
+      };
+    }
+    const stacksPayload = payload.payload;
+    return {
+      success: true,
+      transaction: stacksPayload.txId,
+      network: requirements.network,
+      payer: verifyResult.payer
+    };
+  }
+  /**
+   * Check if a transaction has been used
+   */
+  isTransactionUsed(txId) {
+    return this.usedTransactions.has(txId);
+  }
+  /**
+   * Mark a transaction as used
+   */
+  markTransactionUsed(txId) {
+    this.usedTransactions.set(txId, Date.now());
+  }
+  /**
+   * Start the cleanup interval for used transactions cache
+   */
+  startCleanupInterval() {
+    setInterval(() => {
+      const cutoff = Date.now() - this.config.usedTxCacheDuration;
+      for (const [txId, timestamp] of this.usedTransactions) {
+        if (timestamp < cutoff) {
+          this.usedTransactions.delete(txId);
+        }
+      }
+    }, 60 * 60 * 1e3);
+  }
+};
+function createExactDirectStacksFacilitator(signer, config = {}) {
+  return new ExactDirectStacksFacilitator(signer, config);
+}
+export {
+  ExactDirectStacksFacilitator,
+  createExactDirectStacksFacilitator
+};
+//# sourceMappingURL=index.mjs.map

package/dist/exact-direct/facilitator/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/constants.ts","../../../src/tokens.ts","../../../src/utils.ts","../../../src/exact-direct/facilitator/scheme.ts"],"sourcesContent":["/**\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":[]}

package/dist/exact-direct/server/index.cjs

@@ -0,0 +1,247 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/exact-direct/server/index.ts
+var server_exports = {};
+__export(server_exports, {
+  ExactDirectStacksServer: () => ExactDirectStacksServer,
+  createExactDirectStacksServer: () => createExactDirectStacksServer,
+  registerExactDirectStacksServer: () => registerExactDirectStacksServer
+});
+module.exports = __toCommonJS(server_exports);
+
+// src/constants.ts
+var STACKS_CAIP2_NAMESPACE = "stacks";
+var STACKS_MAINNET_CAIP2 = "stacks:1";
+var STACKS_TESTNET_CAIP2 = "stacks:2147483648";
+var SCHEME_EXACT_DIRECT = "exact-direct";
+var DEFAULT_MAINNET_API = "https://api.mainnet.hiro.so";
+var DEFAULT_TESTNET_API = "https://api.testnet.hiro.so";
+var STACKS_NETWORKS = {
+  [STACKS_MAINNET_CAIP2]: {
+    name: "Stacks Mainnet",
+    caip2: STACKS_MAINNET_CAIP2,
+    apiUrl: DEFAULT_MAINNET_API,
+    chainId: 1,
+    addressPrefix: "SP",
+    isTestnet: false
+  },
+  [STACKS_TESTNET_CAIP2]: {
+    name: "Stacks Testnet",
+    caip2: STACKS_TESTNET_CAIP2,
+    apiUrl: DEFAULT_TESTNET_API,
+    chainId: 2147483648,
+    addressPrefix: "ST",
+    isTestnet: true
+  }
+};
+function isStacksNetwork(network) {
+  return network.startsWith(`${STACKS_CAIP2_NAMESPACE}:`);
+}
+
+// src/tokens.ts
+var SUSDC_MAINNET = {
+  contractAddress: "SP3Y2ZSH8P7D50B0VBTSX11S7XSG24M1VB9YFQA4K.token-susdc",
+  symbol: "sUSDC",
+  name: "Stacks USDC",
+  decimals: 6,
+  issuer: "Stacks"
+};
+var SUSDC_TESTNET = {
+  contractAddress: "ST1PQHQKV0RJXZFY1DGX8MNSNYVE3VGZJSRTPGZGM.token-susdc",
+  symbol: "sUSDC",
+  name: "Test Stacks USDC",
+  decimals: 6
+};
+var TOKEN_REGISTRY = {
+  [STACKS_MAINNET_CAIP2]: {
+    sUSDC: SUSDC_MAINNET
+  },
+  [STACKS_TESTNET_CAIP2]: {
+    sUSDC: SUSDC_TESTNET
+  }
+};
+var DEFAULT_TOKENS = {
+  [STACKS_MAINNET_CAIP2]: SUSDC_MAINNET,
+  [STACKS_TESTNET_CAIP2]: SUSDC_TESTNET
+};
+function getTokenConfig(network, symbol = "sUSDC") {
+  return TOKEN_REGISTRY[network]?.[symbol];
+}
+function getDefaultToken(network) {
+  return DEFAULT_TOKENS[network];
+}
+
+// src/utils.ts
+function parseAmount(amount, decimals) {
+  const parts = amount.split(".");
+  const wholePart = parts[0] || "0";
+  const fractionalPart = (parts[1] || "").padEnd(decimals, "0").slice(0, decimals);
+  return BigInt(wholePart + fractionalPart).toString();
+}
+
+// src/exact-direct/server/scheme.ts
+var ExactDirectStacksServer = class {
+  scheme = SCHEME_EXACT_DIRECT;
+  moneyParsers = [];
+  config;
+  constructor(config = {}) {
+    this.config = config;
+  }
+  /**
+   * Register a custom money parser in the parser chain.
+   */
+  registerMoneyParser(parser) {
+    this.moneyParsers.push(parser);
+    return this;
+  }
+  /**
+   * Parse price into Stacks-specific amount
+   */
+  async parsePrice(price, network) {
+    if (!isStacksNetwork(network)) {
+      throw new Error(`Invalid Stacks network: ${network}`);
+    }
+    if (typeof price === "object" && price !== null && "amount" in price) {
+      if (!price.asset) {
+        throw new Error(`Asset must be specified for AssetAmount on network ${network}`);
+      }
+      return {
+        amount: price.amount,
+        asset: price.asset,
+        extra: price.extra || {}
+      };
+    }
+    const amount = this.parseMoneyToDecimal(price);
+    for (const parser of this.moneyParsers) {
+      const result = await parser(amount, network);
+      if (result !== null) {
+        return result;
+      }
+    }
+    return this.defaultMoneyConversion(amount, network);
+  }
+  /**
+   * Enhance payment requirements with Stacks-specific details
+   */
+  async enhancePaymentRequirements(paymentRequirements, supportedKind, facilitatorExtensions) {
+    void facilitatorExtensions;
+    const extra = { ...paymentRequirements.extra };
+    if (supportedKind.extra?.contractAddress) {
+      extra.contractAddress = supportedKind.extra.contractAddress;
+    }
+    if (supportedKind.extra?.assetSymbol) {
+      extra.assetSymbol = supportedKind.extra.assetSymbol;
+    }
+    if (supportedKind.extra?.assetDecimals) {
+      extra.assetDecimals = supportedKind.extra.assetDecimals;
+    }
+    if (supportedKind.extra?.networkName) {
+      extra.networkName = supportedKind.extra.networkName;
+    }
+    return {
+      ...paymentRequirements,
+      extra
+    };
+  }
+  /**
+   * Parse Money (string | number) to a decimal number.
+   */
+  parseMoneyToDecimal(money) {
+    if (typeof money === "number") {
+      return money;
+    }
+    const cleanMoney = money.replace(/^\$/, "").trim();
+    const amount = parseFloat(cleanMoney);
+    if (isNaN(amount)) {
+      throw new Error(`Invalid money format: ${money}`);
+    }
+    return amount;
+  }
+  /**
+   * Default money conversion implementation.
+   */
+  defaultMoneyConversion(amount, network) {
+    const token = this.getDefaultAsset(network);
+    const tokenAmount = parseAmount(amount.toString(), token.decimals);
+    return {
+      amount: tokenAmount.toString(),
+      asset: this.createAssetIdentifier(network, token.contractAddress),
+      extra: {
+        symbol: token.symbol,
+        name: token.name,
+        decimals: token.decimals,
+        contractAddress: token.contractAddress
+      }
+    };
+  }
+  /**
+   * Create a CAIP-19 asset identifier for Stacks tokens
+   */
+  createAssetIdentifier(network, contractAddress) {
+    return `${network}/sip010:${contractAddress}`;
+  }
+  /**
+   * Get the default asset info for a network.
+   */
+  getDefaultAsset(network) {
+    if (this.config.preferredToken) {
+      const preferred = getTokenConfig(network, this.config.preferredToken);
+      if (preferred) return preferred;
+    }
+    const defaultToken = getDefaultToken(network);
+    if (defaultToken) return defaultToken;
+    throw new Error(`No tokens configured for network ${network}`);
+  }
+  /**
+   * Get all supported networks
+   */
+  static getSupportedNetworks() {
+    return Object.keys(TOKEN_REGISTRY);
+  }
+  /**
+   * Check if a network is supported
+   */
+  static isNetworkSupported(network) {
+    return network in TOKEN_REGISTRY;
+  }
+};
+function createExactDirectStacksServer(config = {}) {
+  return new ExactDirectStacksServer(config);
+}
+
+// src/exact-direct/server/register.ts
+function registerExactDirectStacksServer(server, config = {}) {
+  const scheme = new ExactDirectStacksServer(config);
+  if (config.networks && config.networks.length > 0) {
+    config.networks.forEach((network) => {
+      server.register(network, scheme);
+    });
+  } else {
+    server.register(`${STACKS_CAIP2_NAMESPACE}:*`, scheme);
+  }
+  return server;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ExactDirectStacksServer,
+  createExactDirectStacksServer,
+  registerExactDirectStacksServer
+});
+//# sourceMappingURL=index.cjs.map