@t402/stacks 2.4.0

package/dist/index.mjs

@@ -0,0 +1,212 @@
+// 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;
+}
+export {
+  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.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants.ts","../src/tokens.ts","../src/utils.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"],"mappings":"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","names":[]}

package/dist/types-Bxzo3eQ1.d.cts

@@ -0,0 +1,172 @@
+import { Network } from '@t402/core/types';
+
+/**
+ * Stacks T402 Types
+ */
+
+/**
+ * Payment payload for exact-direct scheme on Stacks
+ */
+type ExactDirectStacksPayload = {
+    /** Transaction ID (0x-prefixed hex, 64 chars) */
+    txId: string;
+    /** Sender address (Stacks principal) */
+    from: string;
+    /** Recipient address (Stacks principal) */
+    to: string;
+    /** Amount in smallest unit (atomic) */
+    amount: string;
+    /** SIP-010 contract address (principal.contract-name) */
+    contractAddress: string;
+};
+/**
+ * Result of a Stacks transaction query from Hiro API
+ */
+interface StacksTransactionResult {
+    /** Transaction ID */
+    txId: string;
+    /** Transaction type */
+    txType: string;
+    /** Transaction status */
+    txStatus: "success" | "abort_by_response" | "abort_by_post_condition" | "pending";
+    /** Block hash */
+    blockHash: string;
+    /** Block height */
+    blockHeight: number;
+    /** Burn block time (unix timestamp) */
+    burnBlockTime: number;
+    /** Sender address */
+    senderAddress: string;
+    /** Contract call details (for contract-call transactions) */
+    contractCall?: StacksContractCall;
+    /** Post-condition mode */
+    postConditionMode: string;
+    /** Post conditions */
+    postConditions: StacksPostCondition[];
+    /** Events */
+    events: StacksEvent[];
+}
+/**
+ * Stacks contract call details
+ */
+interface StacksContractCall {
+    /** Contract ID (principal.contract-name) */
+    contractId: string;
+    /** Function name */
+    functionName: string;
+    /** Function arguments */
+    functionArgs: StacksFunctionArg[];
+}
+/**
+ * Stacks function argument
+ */
+interface StacksFunctionArg {
+    /** Hex-encoded value */
+    hex: string;
+    /** Human-readable representation */
+    repr: string;
+    /** Argument type */
+    type: string;
+}
+/**
+ * Stacks post condition
+ */
+interface StacksPostCondition {
+    /** Principal (sender) */
+    principal: {
+        type_id: string;
+        address: string;
+        contract_name?: string;
+    };
+    /** Condition code */
+    conditionCode: string;
+    /** Amount */
+    amount: string;
+    /** Asset info */
+    asset?: {
+        contractAddress: string;
+        contractName: string;
+        assetName: string;
+    };
+}
+/**
+ * Stacks transaction event
+ */
+interface StacksEvent {
+    /** Event type */
+    eventType: string;
+    /** Event index */
+    eventIndex: number;
+    /** Fungible token transfer asset event (for ft_transfer events) */
+    asset?: {
+        assetEventType: string;
+        assetId: string;
+        sender: string;
+        recipient: string;
+        amount: string;
+    };
+}
+/**
+ * Parsed token transfer from transaction events
+ */
+interface ParsedTokenTransfer {
+    /** Contract address (principal.contract-name) */
+    contractAddress: string;
+    /** Sender address */
+    from: string;
+    /** Recipient address */
+    to: string;
+    /** Amount transferred (atomic units) */
+    amount: string;
+    /** Whether the transfer was successful */
+    success: boolean;
+}
+/**
+ * Signer interface for Stacks facilitator
+ */
+interface FacilitatorStacksSigner {
+    /**
+     * Get the facilitator's addresses for a network
+     */
+    getAddresses(network: Network): string[];
+    /**
+     * Query a transaction by ID from Hiro API
+     */
+    queryTransaction(txId: string): Promise<StacksTransactionResult | null>;
+}
+/**
+ * Client signer interface for signing transactions
+ */
+interface ClientStacksSigner {
+    /**
+     * Get the signer's address
+     */
+    getAddress(): Promise<string>;
+    /**
+     * Sign and submit a SIP-010 token transfer
+     * Returns the transaction ID
+     */
+    transferToken(contractAddress: string, to: string, amount: string): Promise<{
+        txId: string;
+    }>;
+}
+/**
+ * Configuration for Stacks server
+ */
+interface StacksServerConfig {
+    /** Custom API URL */
+    apiUrl?: string;
+    /** Facilitator addresses per network */
+    facilitatorAddresses?: Record<string, string>;
+}
+/**
+ * Configuration for Stacks facilitator
+ */
+interface StacksFacilitatorConfig {
+    /** Maximum age of transaction to accept (in seconds) */
+    maxTransactionAge?: number;
+    /** Duration to cache used transaction IDs */
+    usedTxCacheDuration?: number;
+}
+
+export type { ClientStacksSigner as C, ExactDirectStacksPayload as E, FacilitatorStacksSigner as F, ParsedTokenTransfer as P, StacksTransactionResult as S, StacksContractCall as a, StacksFunctionArg as b, StacksPostCondition as c, StacksEvent as d, StacksServerConfig as e, StacksFacilitatorConfig as f };

package/dist/types-Bxzo3eQ1.d.ts

@@ -0,0 +1,172 @@
+import { Network } from '@t402/core/types';
+
+/**
+ * Stacks T402 Types
+ */
+
+/**
+ * Payment payload for exact-direct scheme on Stacks
+ */
+type ExactDirectStacksPayload = {
+    /** Transaction ID (0x-prefixed hex, 64 chars) */
+    txId: string;
+    /** Sender address (Stacks principal) */
+    from: string;
+    /** Recipient address (Stacks principal) */
+    to: string;
+    /** Amount in smallest unit (atomic) */
+    amount: string;
+    /** SIP-010 contract address (principal.contract-name) */
+    contractAddress: string;
+};
+/**
+ * Result of a Stacks transaction query from Hiro API
+ */
+interface StacksTransactionResult {
+    /** Transaction ID */
+    txId: string;
+    /** Transaction type */
+    txType: string;
+    /** Transaction status */
+    txStatus: "success" | "abort_by_response" | "abort_by_post_condition" | "pending";
+    /** Block hash */
+    blockHash: string;
+    /** Block height */
+    blockHeight: number;
+    /** Burn block time (unix timestamp) */
+    burnBlockTime: number;
+    /** Sender address */
+    senderAddress: string;
+    /** Contract call details (for contract-call transactions) */
+    contractCall?: StacksContractCall;
+    /** Post-condition mode */
+    postConditionMode: string;
+    /** Post conditions */
+    postConditions: StacksPostCondition[];
+    /** Events */
+    events: StacksEvent[];
+}
+/**
+ * Stacks contract call details
+ */
+interface StacksContractCall {
+    /** Contract ID (principal.contract-name) */
+    contractId: string;
+    /** Function name */
+    functionName: string;
+    /** Function arguments */
+    functionArgs: StacksFunctionArg[];
+}
+/**
+ * Stacks function argument
+ */
+interface StacksFunctionArg {
+    /** Hex-encoded value */
+    hex: string;
+    /** Human-readable representation */
+    repr: string;
+    /** Argument type */
+    type: string;
+}
+/**
+ * Stacks post condition
+ */
+interface StacksPostCondition {
+    /** Principal (sender) */
+    principal: {
+        type_id: string;
+        address: string;
+        contract_name?: string;
+    };
+    /** Condition code */
+    conditionCode: string;
+    /** Amount */
+    amount: string;
+    /** Asset info */
+    asset?: {
+        contractAddress: string;
+        contractName: string;
+        assetName: string;
+    };
+}
+/**
+ * Stacks transaction event
+ */
+interface StacksEvent {
+    /** Event type */
+    eventType: string;
+    /** Event index */
+    eventIndex: number;
+    /** Fungible token transfer asset event (for ft_transfer events) */
+    asset?: {
+        assetEventType: string;
+        assetId: string;
+        sender: string;
+        recipient: string;
+        amount: string;
+    };
+}
+/**
+ * Parsed token transfer from transaction events
+ */
+interface ParsedTokenTransfer {
+    /** Contract address (principal.contract-name) */
+    contractAddress: string;
+    /** Sender address */
+    from: string;
+    /** Recipient address */
+    to: string;
+    /** Amount transferred (atomic units) */
+    amount: string;
+    /** Whether the transfer was successful */
+    success: boolean;
+}
+/**
+ * Signer interface for Stacks facilitator
+ */
+interface FacilitatorStacksSigner {
+    /**
+     * Get the facilitator's addresses for a network
+     */
+    getAddresses(network: Network): string[];
+    /**
+     * Query a transaction by ID from Hiro API
+     */
+    queryTransaction(txId: string): Promise<StacksTransactionResult | null>;
+}
+/**
+ * Client signer interface for signing transactions
+ */
+interface ClientStacksSigner {
+    /**
+     * Get the signer's address
+     */
+    getAddress(): Promise<string>;
+    /**
+     * Sign and submit a SIP-010 token transfer
+     * Returns the transaction ID
+     */
+    transferToken(contractAddress: string, to: string, amount: string): Promise<{
+        txId: string;
+    }>;
+}
+/**
+ * Configuration for Stacks server
+ */
+interface StacksServerConfig {
+    /** Custom API URL */
+    apiUrl?: string;
+    /** Facilitator addresses per network */
+    facilitatorAddresses?: Record<string, string>;
+}
+/**
+ * Configuration for Stacks facilitator
+ */
+interface StacksFacilitatorConfig {
+    /** Maximum age of transaction to accept (in seconds) */
+    maxTransactionAge?: number;
+    /** Duration to cache used transaction IDs */
+    usedTxCacheDuration?: number;
+}
+
+export type { ClientStacksSigner as C, ExactDirectStacksPayload as E, FacilitatorStacksSigner as F, ParsedTokenTransfer as P, StacksTransactionResult as S, StacksContractCall as a, StacksFunctionArg as b, StacksPostCondition as c, StacksEvent as d, StacksServerConfig as e, StacksFacilitatorConfig as f };

package/package.json

@@ -0,0 +1,102 @@
+{
+  "name": "@t402/stacks",
+  "version": "2.4.0",
+  "description": "T402 Stacks mechanism - SIP-010 token transfers on Bitcoin L2",
+  "type": "module",
+  "main": "./dist/cjs/index.cjs",
+  "module": "./dist/esm/index.mjs",
+  "types": "./dist/esm/index.d.mts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.mts",
+        "default": "./dist/esm/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.cts",
+        "default": "./dist/cjs/index.cjs"
+      }
+    },
+    "./exact-direct/client": {
+      "import": {
+        "types": "./dist/esm/exact-direct/client/index.d.mts",
+        "default": "./dist/esm/exact-direct/client/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/exact-direct/client/index.d.cts",
+        "default": "./dist/cjs/exact-direct/client/index.cjs"
+      }
+    },
+    "./exact-direct/server": {
+      "import": {
+        "types": "./dist/esm/exact-direct/server/index.d.mts",
+        "default": "./dist/esm/exact-direct/server/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/exact-direct/server/index.d.cts",
+        "default": "./dist/cjs/exact-direct/server/index.cjs"
+      }
+    },
+    "./exact-direct/facilitator": {
+      "import": {
+        "types": "./dist/esm/exact-direct/facilitator/index.d.mts",
+        "default": "./dist/esm/exact-direct/facilitator/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/exact-direct/facilitator/index.d.cts",
+        "default": "./dist/cjs/exact-direct/facilitator/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "@t402/core": "2.4.0"
+  },
+  "peerDependencies": {
+    "@stacks/transactions": ">=7.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@stacks/transactions": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.0",
+    "@vitest/coverage-v8": "^3.2.4",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^3.2.4"
+  },
+  "keywords": [
+    "t402",
+    "stacks",
+    "bitcoin",
+    "sip-010",
+    "payment",
+    "cryptocurrency",
+    "web3"
+  ],
+  "author": "T402 Team",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/t402-io/t402.git",
+    "directory": "typescript/packages/mechanisms/stacks"
+  },
+  "bugs": {
+    "url": "https://github.com/t402-io/t402/issues"
+  },
+  "homepage": "https://t402.io",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}