@t402/stacks 2.4.0

package/dist/index.cjs

@@ -0,0 +1,261 @@
+"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/index.ts
+var index_exports = {};
+__export(index_exports, {
+  DEFAULT_MAINNET_API: () => DEFAULT_MAINNET_API,
+  DEFAULT_TESTNET_API: () => DEFAULT_TESTNET_API,
+  DEFAULT_TOKENS: () => DEFAULT_TOKENS,
+  SCHEME_EXACT_DIRECT: () => SCHEME_EXACT_DIRECT,
+  STACKS_CAIP2_NAMESPACE: () => STACKS_CAIP2_NAMESPACE,
+  STACKS_MAINNET_CAIP2: () => STACKS_MAINNET_CAIP2,
+  STACKS_NETWORKS: () => STACKS_NETWORKS,
+  STACKS_TESTNET_CAIP2: () => STACKS_TESTNET_CAIP2,
+  SUSDC_MAINNET: () => SUSDC_MAINNET,
+  SUSDC_TESTNET: () => SUSDC_TESTNET,
+  TOKEN_REGISTRY: () => TOKEN_REGISTRY,
+  comparePrincipals: () => comparePrincipals,
+  extractTokenTransfer: () => extractTokenTransfer,
+  extractTokenTransferFromPostConditions: () => extractTokenTransferFromPostConditions,
+  formatAmount: () => formatAmount,
+  getContractAddress: () => getContractAddress,
+  getDefaultToken: () => getDefaultToken,
+  getNetworkConfig: () => getNetworkConfig,
+  getTokenConfig: () => getTokenConfig,
+  isStacksNetwork: () => isStacksNetwork,
+  isValidPrincipal: () => isValidPrincipal,
+  isValidTxId: () => isValidTxId,
+  parseAmount: () => parseAmount
+});
+module.exports = __toCommonJS(index_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 getNetworkConfig(network) {
+  return STACKS_NETWORKS[network];
+}
+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];
+}
+function getContractAddress(network, symbol = "sUSDC") {
+  return getTokenConfig(network, symbol)?.contractAddress;
+}
+
+// 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 formatAmount(amount, decimals) {
+  const amountBigInt = BigInt(amount);
+  const divisor = BigInt(10 ** decimals);
+  const wholePart = amountBigInt / divisor;
+  const fractionalPart = amountBigInt % divisor;
+  if (fractionalPart === 0n) {
+    return wholePart.toString();
+  }
+  const fractionalStr = fractionalPart.toString().padStart(decimals, "0");
+  const trimmedFractional = fractionalStr.replace(/0+$/, "");
+  return `${wholePart}.${trimmedFractional}`;
+}
+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();
+}
+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;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_MAINNET_API,
+  DEFAULT_TESTNET_API,
+  DEFAULT_TOKENS,
+  SCHEME_EXACT_DIRECT,
+  STACKS_CAIP2_NAMESPACE,
+  STACKS_MAINNET_CAIP2,
+  STACKS_NETWORKS,
+  STACKS_TESTNET_CAIP2,
+  SUSDC_MAINNET,
+  SUSDC_TESTNET,
+  TOKEN_REGISTRY,
+  comparePrincipals,
+  extractTokenTransfer,
+  extractTokenTransferFromPostConditions,
+  formatAmount,
+  getContractAddress,
+  getDefaultToken,
+  getNetworkConfig,
+  getTokenConfig,
+  isStacksNetwork,
+  isValidPrincipal,
+  isValidTxId,
+  parseAmount
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/constants.ts","../src/tokens.ts","../src/utils.ts"],"sourcesContent":["/**\n * @t402/stacks - Stacks mechanism for T402\n *\n * This package provides support for SIP-010 token payments on Stacks (Bitcoin L2)\n * using the exact-direct scheme.\n *\n * @example\n * ```typescript\n * // Client usage\n * import { createExactDirectStacksClient } from '@t402/stacks/exact-direct/client';\n *\n * const client = createExactDirectStacksClient({\n *   signer: myStacksSigner,\n * });\n *\n * // Server usage\n * import { registerExactDirectStacksServer } from '@t402/stacks/exact-direct/server';\n *\n * registerExactDirectStacksServer(server);\n *\n * // Facilitator usage\n * import { createExactDirectStacksFacilitator } from '@t402/stacks/exact-direct/facilitator';\n *\n * const facilitator = createExactDirectStacksFacilitator(signer);\n * ```\n */\n\n// Re-export constants\nexport {\n  STACKS_CAIP2_NAMESPACE,\n  STACKS_MAINNET_CAIP2,\n  STACKS_TESTNET_CAIP2,\n  SCHEME_EXACT_DIRECT,\n  DEFAULT_MAINNET_API,\n  DEFAULT_TESTNET_API,\n  STACKS_NETWORKS,\n  getNetworkConfig,\n  isStacksNetwork,\n  type StacksNetworkConfig,\n} from \"./constants.js\";\n\n// Re-export token registry\nexport {\n  SUSDC_MAINNET,\n  SUSDC_TESTNET,\n  TOKEN_REGISTRY,\n  DEFAULT_TOKENS,\n  getTokenConfig,\n  getDefaultToken,\n  getContractAddress,\n  type TokenConfig,\n} from \"./tokens.js\";\n\n// Re-export types\nexport type {\n  ExactDirectStacksPayload,\n  StacksTransactionResult,\n  StacksContractCall,\n  StacksFunctionArg,\n  StacksPostCondition,\n  StacksEvent,\n  ParsedTokenTransfer,\n  FacilitatorStacksSigner,\n  ClientStacksSigner,\n  StacksServerConfig,\n  StacksFacilitatorConfig,\n} from \"./types.js\";\n\n// Re-export utilities\nexport {\n  isValidPrincipal,\n  isValidTxId,\n  comparePrincipals,\n  formatAmount,\n  parseAmount,\n  extractTokenTransfer,\n  extractTokenTransferFromPostConditions,\n} from \"./utils.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"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACQO,IAAM,yBAAyB;AAI/B,IAAM,uBAAuB;AAG7B,IAAM,uBAAuB;AAG7B,IAAM,sBAAsB;AAG5B,IAAM,sBAAsB;AAC5B,IAAM,sBAAsB;AAY5B,IAAM,kBAAuD;AAAA,EAClE,CAAC,oBAAoB,GAAG;AAAA,IACtB,MAAM;AAAA,IACN,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,SAAS;AAAA,IACT,eAAe;AAAA,IACf,WAAW;AAAA,EACb;AAAA,EACA,CAAC,oBAAoB,GAAG;AAAA,IACtB,MAAM;AAAA,IACN,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,SAAS;AAAA,IACT,eAAe;AAAA,IACf,WAAW;AAAA,EACb;AACF;AAKO,SAAS,iBAAiB,SAAkD;AACjF,SAAO,gBAAgB,OAAO;AAChC;AAKO,SAAS,gBAAgB,SAA0B;AACxD,SAAO,QAAQ,WAAW,GAAG,sBAAsB,GAAG;AACxD;;;AChCO,IAAM,gBAA6B;AAAA,EACxC,iBAAiB;AAAA,EACjB,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,UAAU;AAAA,EACV,QAAQ;AACV;AAOO,IAAM,gBAA6B;AAAA,EACxC,iBAAiB;AAAA,EACjB,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,UAAU;AACZ;AAKO,IAAM,iBAA8D;AAAA,EACzE,CAAC,oBAAoB,GAAG;AAAA,IACtB,OAAO;AAAA,EACT;AAAA,EACA,CAAC,oBAAoB,GAAG;AAAA,IACtB,OAAO;AAAA,EACT;AACF;AAKO,IAAM,iBAA8C;AAAA,EACzD,CAAC,oBAAoB,GAAG;AAAA,EACxB,CAAC,oBAAoB,GAAG;AAC1B;AAKO,SAAS,eACd,SACA,SAAiB,SACQ;AACzB,SAAO,eAAe,OAAO,IAAI,MAAM;AACzC;AAKO,SAAS,gBAAgB,SAA0C;AACxE,SAAO,eAAe,OAAO;AAC/B;AAKO,SAAS,mBAAmB,SAAiB,SAAiB,SAA6B;AAChG,SAAO,eAAe,SAAS,MAAM,GAAG;AAC1C;;;ACpFO,SAAS,iBAAiB,SAA0B;AACzD,MAAI,CAAC,WAAW,OAAO,YAAY,UAAU;AAC3C,WAAO;AAAA,EACT;AAIA,QAAM,QAAQ,QAAQ,MAAM,GAAG;AAC/B,QAAM,YAAY,MAAM,CAAC;AAGzB,QAAM,iBAAiB;AACvB,MAAI,CAAC,eAAe,KAAK,SAAS,GAAG;AACnC,WAAO;AAAA,EACT;AAGA,MAAI,MAAM,WAAW,GAAG;AACtB,UAAM,eAAe,MAAM,CAAC;AAE5B,UAAM,oBAAoB;AAC1B,WAAO,kBAAkB,KAAK,YAAY;AAAA,EAC5C;AAGA,SAAO,MAAM,WAAW;AAC1B;AAMO,SAAS,YAAY,MAAuB;AACjD,MAAI,CAAC,QAAQ,OAAO,SAAS,UAAU;AACrC,WAAO;AAAA,EACT;AACA,SAAO,sBAAsB,KAAK,IAAI;AACxC;AAKO,SAAS,kBAAkB,GAAW,GAAoB;AAC/D,SAAO,MAAM;AACf;AAKO,SAAS,aAAa,QAAgB,UAA0B;AACrE,QAAM,eAAe,OAAO,MAAM;AAClC,QAAM,UAAU,OAAO,MAAM,QAAQ;AACrC,QAAM,YAAY,eAAe;AACjC,QAAM,iBAAiB,eAAe;AAEtC,MAAI,mBAAmB,IAAI;AACzB,WAAO,UAAU,SAAS;AAAA,EAC5B;AAEA,QAAM,gBAAgB,eAAe,SAAS,EAAE,SAAS,UAAU,GAAG;AACtE,QAAM,oBAAoB,cAAc,QAAQ,OAAO,EAAE;AACzD,SAAO,GAAG,SAAS,IAAI,iBAAiB;AAC1C;AAKO,SAAS,YAAY,QAAgB,UAA0B;AACpE,QAAM,QAAQ,OAAO,MAAM,GAAG;AAC9B,QAAM,YAAY,MAAM,CAAC,KAAK;AAC9B,QAAM,kBAAkB,MAAM,CAAC,KAAK,IAAI,OAAO,UAAU,GAAG,EAAE,MAAM,GAAG,QAAQ;AAC/E,SAAO,OAAO,YAAY,cAAc,EAAE,SAAS;AACrD;AAMO,SAAS,qBACd,QACA,iBAC4B;AAC5B,MAAI,OAAO,aAAa,WAAW;AACjC,WAAO;AAAA,EACT;AAGA,MAAI,OAAO,WAAW,iBAAiB;AACrC,WAAO;AAAA,EACT;AAGA,MAAI,OAAO,cAAc;AACvB,UAAM,EAAE,YAAY,aAAa,IAAI,OAAO;AAE5C,QAAI,iBAAiB,YAAY;AAC/B,aAAO;AAAA,IACT;AAGA,QAAI,mBAAmB,eAAe,iBAAiB;AACrD,aAAO;AAAA,IACT;AAGA,UAAM,gBAAgB,OAAO,OAAO;AAAA,MAClC,CAAC,MAAM,EAAE,cAAc,0BAA0B,EAAE,OAAO,mBAAmB;AAAA,IAC/E;AAEA,QAAI,eAAe,OAAO;AACxB,aAAO;AAAA,QACL,iBAAiB;AAAA,QACjB,MAAM,cAAc,MAAM;AAAA,QAC1B,IAAI,cAAc,MAAM;AAAA,QACxB,QAAQ,cAAc,MAAM;AAAA,QAC5B,SAAS;AAAA,MACX;AAAA,IACF;AAGA,QAAI,OAAO,aAAa,aAAa,UAAU,GAAG;AAChD,YAAM,YAAY,OAAO,aAAa,aAAa,CAAC;AACpD,YAAM,YAAY,OAAO,aAAa,aAAa,CAAC;AACpD,YAAM,eAAe,OAAO,aAAa,aAAa,CAAC;AAGvD,YAAM,cAAc,WAAW,MAAM,MAAM,iCAAiC;AAC5E,YAAM,iBAAiB,cAAc,MAAM,MAAM,iCAAiC;AAClF,YAAM,cAAc,WAAW,MAAM,MAAM,UAAU;AAErD,UAAI,eAAe,kBAAkB,aAAa;AAChD,eAAO;AAAA,UACL,iBAAiB;AAAA,UACjB,MAAM,YAAY,CAAC;AAAA,UACnB,IAAI,eAAe,CAAC;AAAA,UACpB,QAAQ,YAAY,CAAC;AAAA,UACrB,SAAS;AAAA,QACX;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAKO,SAAS,uCACd,QACA,iBAC4B;AAC5B,MAAI,OAAO,aAAa,WAAW;AACjC,WAAO;AAAA,EACT;AAGA,aAAW,MAAM,OAAO,gBAAgB;AACtC,QAAI,GAAG,OAAO;AACZ,YAAM,uBAAuB,GAAG,GAAG,MAAM,eAAe,IAAI,GAAG,MAAM,YAAY;AAEjF,UAAI,mBAAmB,yBAAyB,iBAAiB;AAC/D;AAAA,MACF;AAGA,YAAM,gBAAgB,OAAO,OAAO;AAAA,QAClC,CAAC,MACC,EAAE,cAAc,0BAChB,EAAE,OAAO,mBAAmB,cAC5B,EAAE,OAAO,WAAW,GAAG,UAAU;AAAA,MACrC;AAEA,UAAI,eAAe,OAAO;AACxB,eAAO;AAAA,UACL,iBAAiB;AAAA,UACjB,MAAM,cAAc,MAAM;AAAA,UAC1B,IAAI,cAAc,MAAM;AAAA,UACxB,QAAQ,cAAc,MAAM;AAAA,UAC5B,SAAS;AAAA,QACX;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,126 @@
+import { S as StacksTransactionResult, P as ParsedTokenTransfer } from './types-Bxzo3eQ1.cjs';
+export { C as ClientStacksSigner, E as ExactDirectStacksPayload, F as FacilitatorStacksSigner, a as StacksContractCall, d as StacksEvent, f as StacksFacilitatorConfig, b as StacksFunctionArg, c as StacksPostCondition, e as StacksServerConfig } from './types-Bxzo3eQ1.cjs';
+import '@t402/core/types';
+
+/**
+ * Stacks T402 Constants
+ *
+ * Stacks is a Bitcoin Layer 2 that brings smart contracts and DeFi
+ * to Bitcoin. SIP-010 is the fungible token standard on Stacks.
+ */
+declare const STACKS_CAIP2_NAMESPACE = "stacks";
+declare const STACKS_MAINNET_CAIP2 = "stacks:1";
+declare const STACKS_TESTNET_CAIP2 = "stacks:2147483648";
+declare const SCHEME_EXACT_DIRECT = "exact-direct";
+declare const DEFAULT_MAINNET_API = "https://api.mainnet.hiro.so";
+declare const DEFAULT_TESTNET_API = "https://api.testnet.hiro.so";
+interface StacksNetworkConfig {
+    readonly name: string;
+    readonly caip2: string;
+    readonly apiUrl: string;
+    readonly chainId: number;
+    readonly addressPrefix: string;
+    readonly isTestnet: boolean;
+}
+declare const STACKS_NETWORKS: Record<string, StacksNetworkConfig>;
+/**
+ * Get network configuration by CAIP-2 identifier
+ */
+declare function getNetworkConfig(network: string): StacksNetworkConfig | undefined;
+/**
+ * Check if a network identifier is a Stacks network
+ */
+declare function isStacksNetwork(network: string): boolean;
+
+/**
+ * Stacks Token Registry
+ *
+ * On Stacks, tokens are SIP-010 fungible tokens identified by
+ * their contract address (principal.contract-name).
+ */
+/**
+ * Token configuration for Stacks SIP-010 tokens
+ */
+interface TokenConfig {
+    /** Contract address (principal.contract-name) */
+    readonly contractAddress: string;
+    /** Token symbol */
+    readonly symbol: string;
+    /** Token name */
+    readonly name: string;
+    /** Decimal places */
+    readonly decimals: number;
+    /** Token issuer */
+    readonly issuer?: string;
+}
+/**
+ * sUSDC on Stacks Mainnet
+ * Contract: SP3Y2ZSH8P7D50B0VBTSX11S7XSG24M1VB9YFQA4K.token-susdc
+ * Decimals: 6
+ */
+declare const SUSDC_MAINNET: TokenConfig;
+/**
+ * sUSDC on Stacks Testnet
+ * Contract: ST1PQHQKV0RJXZFY1DGX8MNSNYVE3VGZJSRTPGZGM.token-susdc
+ * Decimals: 6
+ */
+declare const SUSDC_TESTNET: TokenConfig;
+/**
+ * Network-specific token registries
+ */
+declare const TOKEN_REGISTRY: Record<string, Record<string, TokenConfig>>;
+/**
+ * Default tokens per network
+ */
+declare const DEFAULT_TOKENS: Record<string, TokenConfig>;
+/**
+ * Get token configuration by network and symbol
+ */
+declare function getTokenConfig(network: string, symbol?: string): TokenConfig | undefined;
+/**
+ * Get the default token for a network
+ */
+declare function getDefaultToken(network: string): TokenConfig | undefined;
+/**
+ * Get contract address for a token on a network
+ */
+declare function getContractAddress(network: string, symbol?: string): string | undefined;
+
+/**
+ * Stacks Utility Functions
+ */
+
+/**
+ * Validate a Stacks principal address format
+ * Stacks addresses start with SP (mainnet) or ST (testnet)
+ * followed by alphanumeric characters (base58-like encoding)
+ */
+declare function isValidPrincipal(address: string): boolean;
+/**
+ * Validate a Stacks transaction ID format
+ * Transaction IDs are 0x-prefixed 64-character hex strings
+ */
+declare function isValidTxId(hash: string): boolean;
+/**
+ * Compare two Stacks principals (case-sensitive)
+ */
+declare function comparePrincipals(a: string, b: string): boolean;
+/**
+ * Format an amount with decimals for display
+ */
+declare function formatAmount(amount: string, decimals: number): string;
+/**
+ * Parse an amount string to the smallest unit (with decimals applied)
+ */
+declare function parseAmount(amount: string, decimals: number): string;
+/**
+ * Extract token transfer details from a Stacks transaction result
+ * Looks for ft_transfer events matching the expected contract
+ */
+declare function extractTokenTransfer(result: StacksTransactionResult, contractAddress?: string): ParsedTokenTransfer | null;
+/**
+ * Extract token transfer from post conditions (alternative method)
+ */
+declare function extractTokenTransferFromPostConditions(result: StacksTransactionResult, contractAddress?: string): ParsedTokenTransfer | null;
+
+export { DEFAULT_MAINNET_API, DEFAULT_TESTNET_API, DEFAULT_TOKENS, ParsedTokenTransfer, SCHEME_EXACT_DIRECT, STACKS_CAIP2_NAMESPACE, STACKS_MAINNET_CAIP2, STACKS_NETWORKS, STACKS_TESTNET_CAIP2, SUSDC_MAINNET, SUSDC_TESTNET, type StacksNetworkConfig, StacksTransactionResult, TOKEN_REGISTRY, type TokenConfig, comparePrincipals, extractTokenTransfer, extractTokenTransferFromPostConditions, formatAmount, getContractAddress, getDefaultToken, getNetworkConfig, getTokenConfig, isStacksNetwork, isValidPrincipal, isValidTxId, parseAmount };

package/dist/index.d.ts

@@ -0,0 +1,126 @@
+import { S as StacksTransactionResult, P as ParsedTokenTransfer } from './types-Bxzo3eQ1.js';
+export { C as ClientStacksSigner, E as ExactDirectStacksPayload, F as FacilitatorStacksSigner, a as StacksContractCall, d as StacksEvent, f as StacksFacilitatorConfig, b as StacksFunctionArg, c as StacksPostCondition, e as StacksServerConfig } from './types-Bxzo3eQ1.js';
+import '@t402/core/types';
+
+/**
+ * Stacks T402 Constants
+ *
+ * Stacks is a Bitcoin Layer 2 that brings smart contracts and DeFi
+ * to Bitcoin. SIP-010 is the fungible token standard on Stacks.
+ */
+declare const STACKS_CAIP2_NAMESPACE = "stacks";
+declare const STACKS_MAINNET_CAIP2 = "stacks:1";
+declare const STACKS_TESTNET_CAIP2 = "stacks:2147483648";
+declare const SCHEME_EXACT_DIRECT = "exact-direct";
+declare const DEFAULT_MAINNET_API = "https://api.mainnet.hiro.so";
+declare const DEFAULT_TESTNET_API = "https://api.testnet.hiro.so";
+interface StacksNetworkConfig {
+    readonly name: string;
+    readonly caip2: string;
+    readonly apiUrl: string;
+    readonly chainId: number;
+    readonly addressPrefix: string;
+    readonly isTestnet: boolean;
+}
+declare const STACKS_NETWORKS: Record<string, StacksNetworkConfig>;
+/**
+ * Get network configuration by CAIP-2 identifier
+ */
+declare function getNetworkConfig(network: string): StacksNetworkConfig | undefined;
+/**
+ * Check if a network identifier is a Stacks network
+ */
+declare function isStacksNetwork(network: string): boolean;
+
+/**
+ * Stacks Token Registry
+ *
+ * On Stacks, tokens are SIP-010 fungible tokens identified by
+ * their contract address (principal.contract-name).
+ */
+/**
+ * Token configuration for Stacks SIP-010 tokens
+ */
+interface TokenConfig {
+    /** Contract address (principal.contract-name) */
+    readonly contractAddress: string;
+    /** Token symbol */
+    readonly symbol: string;
+    /** Token name */
+    readonly name: string;
+    /** Decimal places */
+    readonly decimals: number;
+    /** Token issuer */
+    readonly issuer?: string;
+}
+/**
+ * sUSDC on Stacks Mainnet
+ * Contract: SP3Y2ZSH8P7D50B0VBTSX11S7XSG24M1VB9YFQA4K.token-susdc
+ * Decimals: 6
+ */
+declare const SUSDC_MAINNET: TokenConfig;
+/**
+ * sUSDC on Stacks Testnet
+ * Contract: ST1PQHQKV0RJXZFY1DGX8MNSNYVE3VGZJSRTPGZGM.token-susdc
+ * Decimals: 6
+ */
+declare const SUSDC_TESTNET: TokenConfig;
+/**
+ * Network-specific token registries
+ */
+declare const TOKEN_REGISTRY: Record<string, Record<string, TokenConfig>>;
+/**
+ * Default tokens per network
+ */
+declare const DEFAULT_TOKENS: Record<string, TokenConfig>;
+/**
+ * Get token configuration by network and symbol
+ */
+declare function getTokenConfig(network: string, symbol?: string): TokenConfig | undefined;
+/**
+ * Get the default token for a network
+ */
+declare function getDefaultToken(network: string): TokenConfig | undefined;
+/**
+ * Get contract address for a token on a network
+ */
+declare function getContractAddress(network: string, symbol?: string): string | undefined;
+
+/**
+ * Stacks Utility Functions
+ */
+
+/**
+ * Validate a Stacks principal address format
+ * Stacks addresses start with SP (mainnet) or ST (testnet)
+ * followed by alphanumeric characters (base58-like encoding)
+ */
+declare function isValidPrincipal(address: string): boolean;
+/**
+ * Validate a Stacks transaction ID format
+ * Transaction IDs are 0x-prefixed 64-character hex strings
+ */
+declare function isValidTxId(hash: string): boolean;
+/**
+ * Compare two Stacks principals (case-sensitive)
+ */
+declare function comparePrincipals(a: string, b: string): boolean;
+/**
+ * Format an amount with decimals for display
+ */
+declare function formatAmount(amount: string, decimals: number): string;
+/**
+ * Parse an amount string to the smallest unit (with decimals applied)
+ */
+declare function parseAmount(amount: string, decimals: number): string;
+/**
+ * Extract token transfer details from a Stacks transaction result
+ * Looks for ft_transfer events matching the expected contract
+ */
+declare function extractTokenTransfer(result: StacksTransactionResult, contractAddress?: string): ParsedTokenTransfer | null;
+/**
+ * Extract token transfer from post conditions (alternative method)
+ */
+declare function extractTokenTransferFromPostConditions(result: StacksTransactionResult, contractAddress?: string): ParsedTokenTransfer | null;
+
+export { DEFAULT_MAINNET_API, DEFAULT_TESTNET_API, DEFAULT_TOKENS, ParsedTokenTransfer, SCHEME_EXACT_DIRECT, STACKS_CAIP2_NAMESPACE, STACKS_MAINNET_CAIP2, STACKS_NETWORKS, STACKS_TESTNET_CAIP2, SUSDC_MAINNET, SUSDC_TESTNET, type StacksNetworkConfig, StacksTransactionResult, TOKEN_REGISTRY, type TokenConfig, comparePrincipals, extractTokenTransfer, extractTokenTransferFromPostConditions, formatAmount, getContractAddress, getDefaultToken, getNetworkConfig, getTokenConfig, isStacksNetwork, isValidPrincipal, isValidTxId, parseAmount };