@t402/stacks 2.4.0

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/exact-direct/server/index.ts","../../../src/constants.ts","../../../src/tokens.ts","../../../src/utils.ts","../../../src/exact-direct/server/scheme.ts","../../../src/exact-direct/server/register.ts"],"sourcesContent":["export {\n  ExactDirectStacksServer,\n  createExactDirectStacksServer,\n} from \"./scheme.js\";\n\nexport {\n  registerExactDirectStacksServer,\n  type StacksServerRegistrationConfig,\n} from \"./register.js\";\n","/**\n * Stacks T402 Constants\n *\n * Stacks is a Bitcoin Layer 2 that brings smart contracts and DeFi\n * to Bitcoin. SIP-010 is the fungible token standard on Stacks.\n */\n\n// CAIP-2 namespace for Stacks\nexport const STACKS_CAIP2_NAMESPACE = \"stacks\";\n\n// CAIP-2 network identifiers\n// Stacks Mainnet (chain ID: 1)\nexport const STACKS_MAINNET_CAIP2 = \"stacks:1\";\n\n// Stacks Testnet (chain ID: 2147483648)\nexport const STACKS_TESTNET_CAIP2 = \"stacks:2147483648\";\n\n// Scheme identifier\nexport const SCHEME_EXACT_DIRECT = \"exact-direct\";\n\n// Default API endpoints (Hiro API)\nexport const DEFAULT_MAINNET_API = \"https://api.mainnet.hiro.so\";\nexport const DEFAULT_TESTNET_API = \"https://api.testnet.hiro.so\";\n\n// Network configurations\nexport interface StacksNetworkConfig {\n  readonly name: string;\n  readonly caip2: string;\n  readonly apiUrl: string;\n  readonly chainId: number;\n  readonly addressPrefix: string;\n  readonly isTestnet: boolean;\n}\n\nexport const STACKS_NETWORKS: Record<string, StacksNetworkConfig> = {\n  [STACKS_MAINNET_CAIP2]: {\n    name: \"Stacks Mainnet\",\n    caip2: STACKS_MAINNET_CAIP2,\n    apiUrl: DEFAULT_MAINNET_API,\n    chainId: 1,\n    addressPrefix: \"SP\",\n    isTestnet: false,\n  },\n  [STACKS_TESTNET_CAIP2]: {\n    name: \"Stacks Testnet\",\n    caip2: STACKS_TESTNET_CAIP2,\n    apiUrl: DEFAULT_TESTNET_API,\n    chainId: 2147483648,\n    addressPrefix: \"ST\",\n    isTestnet: true,\n  },\n};\n\n/**\n * Get network configuration by CAIP-2 identifier\n */\nexport function getNetworkConfig(network: string): StacksNetworkConfig | undefined {\n  return STACKS_NETWORKS[network];\n}\n\n/**\n * Check if a network identifier is a Stacks network\n */\nexport function isStacksNetwork(network: string): boolean {\n  return network.startsWith(`${STACKS_CAIP2_NAMESPACE}:`);\n}\n","/**\n * Stacks Token Registry\n *\n * On Stacks, tokens are SIP-010 fungible tokens identified by\n * their contract address (principal.contract-name).\n */\n\nimport {\n  STACKS_MAINNET_CAIP2,\n  STACKS_TESTNET_CAIP2,\n} from \"./constants.js\";\n\n/**\n * Token configuration for Stacks SIP-010 tokens\n */\nexport interface TokenConfig {\n  /** Contract address (principal.contract-name) */\n  readonly contractAddress: string;\n  /** Token symbol */\n  readonly symbol: string;\n  /** Token name */\n  readonly name: string;\n  /** Decimal places */\n  readonly decimals: number;\n  /** Token issuer */\n  readonly issuer?: string;\n}\n\n/**\n * sUSDC on Stacks Mainnet\n * Contract: SP3Y2ZSH8P7D50B0VBTSX11S7XSG24M1VB9YFQA4K.token-susdc\n * Decimals: 6\n */\nexport const SUSDC_MAINNET: TokenConfig = {\n  contractAddress: \"SP3Y2ZSH8P7D50B0VBTSX11S7XSG24M1VB9YFQA4K.token-susdc\",\n  symbol: \"sUSDC\",\n  name: \"Stacks USDC\",\n  decimals: 6,\n  issuer: \"Stacks\",\n};\n\n/**\n * sUSDC on Stacks Testnet\n * Contract: ST1PQHQKV0RJXZFY1DGX8MNSNYVE3VGZJSRTPGZGM.token-susdc\n * Decimals: 6\n */\nexport const SUSDC_TESTNET: TokenConfig = {\n  contractAddress: \"ST1PQHQKV0RJXZFY1DGX8MNSNYVE3VGZJSRTPGZGM.token-susdc\",\n  symbol: \"sUSDC\",\n  name: \"Test Stacks USDC\",\n  decimals: 6,\n};\n\n/**\n * Network-specific token registries\n */\nexport const TOKEN_REGISTRY: Record<string, Record<string, TokenConfig>> = {\n  [STACKS_MAINNET_CAIP2]: {\n    sUSDC: SUSDC_MAINNET,\n  },\n  [STACKS_TESTNET_CAIP2]: {\n    sUSDC: SUSDC_TESTNET,\n  },\n};\n\n/**\n * Default tokens per network\n */\nexport const DEFAULT_TOKENS: Record<string, TokenConfig> = {\n  [STACKS_MAINNET_CAIP2]: SUSDC_MAINNET,\n  [STACKS_TESTNET_CAIP2]: SUSDC_TESTNET,\n};\n\n/**\n * Get token configuration by network and symbol\n */\nexport function getTokenConfig(\n  network: string,\n  symbol: string = \"sUSDC\",\n): TokenConfig | undefined {\n  return TOKEN_REGISTRY[network]?.[symbol];\n}\n\n/**\n * Get the default token for a network\n */\nexport function getDefaultToken(network: string): TokenConfig | undefined {\n  return DEFAULT_TOKENS[network];\n}\n\n/**\n * Get contract address for a token on a network\n */\nexport function getContractAddress(network: string, symbol: string = \"sUSDC\"): string | undefined {\n  return getTokenConfig(network, symbol)?.contractAddress;\n}\n","/**\n * Stacks Utility Functions\n */\n\nimport type { StacksTransactionResult, ParsedTokenTransfer } from \"./types.js\";\n\n/**\n * Validate a Stacks principal address format\n * Stacks addresses start with SP (mainnet) or ST (testnet)\n * followed by alphanumeric characters (base58-like encoding)\n */\nexport function isValidPrincipal(address: string): boolean {\n  if (!address || typeof address !== \"string\") {\n    return false;\n  }\n\n  // Standard principal: SP/ST prefix + base58 characters (33-41 chars total)\n  // Contract principal: standard-principal.contract-name\n  const parts = address.split(\".\");\n  const principal = parts[0];\n\n  // Check principal format: SP or ST prefix + alphanumeric (base58 chars)\n  const principalRegex = /^(SP|ST)[0-9A-HJ-NP-Za-km-z]{33,41}$/;\n  if (!principalRegex.test(principal)) {\n    return false;\n  }\n\n  // If it's a contract principal, validate contract name\n  if (parts.length === 2) {\n    const contractName = parts[1];\n    // Contract names: 1-128 chars, alphanumeric + hyphen + underscore\n    const contractNameRegex = /^[a-zA-Z][a-zA-Z0-9\\-_]{0,127}$/;\n    return contractNameRegex.test(contractName);\n  }\n\n  // Standard principal (no contract part) or exactly one dot for contract\n  return parts.length === 1;\n}\n\n/**\n * Validate a Stacks transaction ID format\n * Transaction IDs are 0x-prefixed 64-character hex strings\n */\nexport function isValidTxId(hash: string): boolean {\n  if (!hash || typeof hash !== \"string\") {\n    return false;\n  }\n  return /^0x[a-fA-F0-9]{64}$/.test(hash);\n}\n\n/**\n * Compare two Stacks principals (case-sensitive)\n */\nexport function comparePrincipals(a: string, b: string): boolean {\n  return a === b;\n}\n\n/**\n * Format an amount with decimals for display\n */\nexport function formatAmount(amount: string, decimals: number): string {\n  const amountBigInt = BigInt(amount);\n  const divisor = BigInt(10 ** decimals);\n  const wholePart = amountBigInt / divisor;\n  const fractionalPart = amountBigInt % divisor;\n\n  if (fractionalPart === 0n) {\n    return wholePart.toString();\n  }\n\n  const fractionalStr = fractionalPart.toString().padStart(decimals, \"0\");\n  const trimmedFractional = fractionalStr.replace(/0+$/, \"\");\n  return `${wholePart}.${trimmedFractional}`;\n}\n\n/**\n * Parse an amount string to the smallest unit (with decimals applied)\n */\nexport function parseAmount(amount: string, decimals: number): string {\n  const parts = amount.split(\".\");\n  const wholePart = parts[0] || \"0\";\n  const fractionalPart = (parts[1] || \"\").padEnd(decimals, \"0\").slice(0, decimals);\n  return BigInt(wholePart + fractionalPart).toString();\n}\n\n/**\n * Extract token transfer details from a Stacks transaction result\n * Looks for ft_transfer events matching the expected contract\n */\nexport function extractTokenTransfer(\n  result: StacksTransactionResult,\n  contractAddress?: string,\n): ParsedTokenTransfer | null {\n  if (result.txStatus !== \"success\") {\n    return null;\n  }\n\n  // Check if this is a contract-call transaction\n  if (result.txType !== \"contract_call\") {\n    return null;\n  }\n\n  // Check contract call is a transfer function\n  if (result.contractCall) {\n    const { contractId, functionName } = result.contractCall;\n\n    if (functionName !== \"transfer\") {\n      return null;\n    }\n\n    // If contractAddress specified, verify it matches\n    if (contractAddress && contractId !== contractAddress) {\n      return null;\n    }\n\n    // Look for ft_transfer event\n    const transferEvent = result.events.find(\n      (e) => e.eventType === \"fungible_token_asset\" && e.asset?.assetEventType === \"transfer\",\n    );\n\n    if (transferEvent?.asset) {\n      return {\n        contractAddress: contractId,\n        from: transferEvent.asset.sender,\n        to: transferEvent.asset.recipient,\n        amount: transferEvent.asset.amount,\n        success: true,\n      };\n    }\n\n    // Fallback: extract from function args if events not available\n    if (result.contractCall.functionArgs.length >= 3) {\n      const amountArg = result.contractCall.functionArgs[0];\n      const senderArg = result.contractCall.functionArgs[1];\n      const recipientArg = result.contractCall.functionArgs[2];\n\n      // Parse principal from repr (format: 'SP...')\n      const senderMatch = senderArg?.repr?.match(/^'?(S[PT][0-9A-HJ-NP-Za-km-z]+)/);\n      const recipientMatch = recipientArg?.repr?.match(/^'?(S[PT][0-9A-HJ-NP-Za-km-z]+)/);\n      const amountMatch = amountArg?.repr?.match(/^u(\\d+)$/);\n\n      if (senderMatch && recipientMatch && amountMatch) {\n        return {\n          contractAddress: contractId,\n          from: senderMatch[1],\n          to: recipientMatch[1],\n          amount: amountMatch[1],\n          success: true,\n        };\n      }\n    }\n  }\n\n  return null;\n}\n\n/**\n * Extract token transfer from post conditions (alternative method)\n */\nexport function extractTokenTransferFromPostConditions(\n  result: StacksTransactionResult,\n  contractAddress?: string,\n): ParsedTokenTransfer | null {\n  if (result.txStatus !== \"success\") {\n    return null;\n  }\n\n  // Look for fungible token post conditions\n  for (const pc of result.postConditions) {\n    if (pc.asset) {\n      const assetContractAddress = `${pc.asset.contractAddress}.${pc.asset.contractName}`;\n\n      if (contractAddress && assetContractAddress !== contractAddress) {\n        continue;\n      }\n\n      // Find corresponding ft_transfer event for recipient\n      const transferEvent = result.events.find(\n        (e) =>\n          e.eventType === \"fungible_token_asset\" &&\n          e.asset?.assetEventType === \"transfer\" &&\n          e.asset?.sender === pc.principal.address,\n      );\n\n      if (transferEvent?.asset) {\n        return {\n          contractAddress: assetContractAddress,\n          from: transferEvent.asset.sender,\n          to: transferEvent.asset.recipient,\n          amount: transferEvent.asset.amount,\n          success: true,\n        };\n      }\n    }\n  }\n\n  return null;\n}\n","/**\n * Stacks Exact-Direct Server Scheme\n *\n * Handles price parsing and payment requirement enhancement for\n * Stacks payments using the exact-direct scheme.\n */\n\nimport type {\n  SchemeNetworkServer,\n  PaymentRequirements,\n  Price,\n  AssetAmount,\n  Network,\n  MoneyParser,\n} from \"@t402/core/types\";\nimport { SCHEME_EXACT_DIRECT, isStacksNetwork } from \"../../constants.js\";\nimport { getDefaultToken, getTokenConfig, TOKEN_REGISTRY } from \"../../tokens.js\";\nimport { parseAmount } from \"../../utils.js\";\n\n/**\n * Configuration for ExactDirectStacksServer\n */\nexport interface ExactDirectStacksServerConfig {\n  /** Preferred token symbol (e.g., \"sUSDC\"). Defaults to network's default token. */\n  preferredToken?: string;\n}\n\n/**\n * Stacks Exact-Direct Server\n *\n * Implements the server-side price parsing and payment requirements enhancement.\n */\nexport class ExactDirectStacksServer implements SchemeNetworkServer {\n  readonly scheme = SCHEME_EXACT_DIRECT;\n  private moneyParsers: MoneyParser[] = [];\n  private config: ExactDirectStacksServerConfig;\n\n  constructor(config: ExactDirectStacksServerConfig = {}) {\n    this.config = config;\n  }\n\n  /**\n   * Register a custom money parser in the parser chain.\n   */\n  registerMoneyParser(parser: MoneyParser): ExactDirectStacksServer {\n    this.moneyParsers.push(parser);\n    return this;\n  }\n\n  /**\n   * Parse price into Stacks-specific amount\n   */\n  async parsePrice(price: Price, network: Network): Promise<AssetAmount> {\n    // Validate network\n    if (!isStacksNetwork(network)) {\n      throw new Error(`Invalid Stacks network: ${network}`);\n    }\n\n    // If already an AssetAmount, return it directly\n    if (typeof price === \"object\" && price !== null && \"amount\" in price) {\n      if (!price.asset) {\n        throw new Error(`Asset must be specified for AssetAmount on network ${network}`);\n      }\n      return {\n        amount: price.amount,\n        asset: price.asset,\n        extra: price.extra || {},\n      };\n    }\n\n    // Parse Money to decimal number\n    const amount = this.parseMoneyToDecimal(price);\n\n    // Try each custom money parser in order\n    for (const parser of this.moneyParsers) {\n      const result = await parser(amount, network);\n      if (result !== null) {\n        return result;\n      }\n    }\n\n    // All custom parsers returned null, use default conversion\n    return this.defaultMoneyConversion(amount, network);\n  }\n\n  /**\n   * Enhance payment requirements with Stacks-specific details\n   */\n  async enhancePaymentRequirements(\n    paymentRequirements: PaymentRequirements,\n    supportedKind: {\n      t402Version: number;\n      scheme: string;\n      network: Network;\n      extra?: Record<string, unknown>;\n    },\n    facilitatorExtensions: string[],\n  ): Promise<PaymentRequirements> {\n    // Mark unused parameters\n    void facilitatorExtensions;\n\n    // Start with existing extra fields\n    const extra = { ...paymentRequirements.extra };\n\n    // Add any facilitator-provided extra fields\n    if (supportedKind.extra?.contractAddress) {\n      extra.contractAddress = supportedKind.extra.contractAddress;\n    }\n    if (supportedKind.extra?.assetSymbol) {\n      extra.assetSymbol = supportedKind.extra.assetSymbol;\n    }\n    if (supportedKind.extra?.assetDecimals) {\n      extra.assetDecimals = supportedKind.extra.assetDecimals;\n    }\n    if (supportedKind.extra?.networkName) {\n      extra.networkName = supportedKind.extra.networkName;\n    }\n\n    return {\n      ...paymentRequirements,\n      extra,\n    };\n  }\n\n  /**\n   * Parse Money (string | number) to a decimal number.\n   */\n  private parseMoneyToDecimal(money: string | number): number {\n    if (typeof money === \"number\") {\n      return money;\n    }\n\n    // Remove $ sign and whitespace, then parse\n    const cleanMoney = money.replace(/^\\$/, \"\").trim();\n    const amount = parseFloat(cleanMoney);\n\n    if (isNaN(amount)) {\n      throw new Error(`Invalid money format: ${money}`);\n    }\n\n    return amount;\n  }\n\n  /**\n   * Default money conversion implementation.\n   */\n  private defaultMoneyConversion(amount: number, network: Network): AssetAmount {\n    const token = this.getDefaultAsset(network);\n\n    // Convert decimal amount to token amount\n    const tokenAmount = parseAmount(amount.toString(), token.decimals);\n\n    return {\n      amount: tokenAmount.toString(),\n      asset: this.createAssetIdentifier(network, token.contractAddress),\n      extra: {\n        symbol: token.symbol,\n        name: token.name,\n        decimals: token.decimals,\n        contractAddress: token.contractAddress,\n      },\n    };\n  }\n\n  /**\n   * Create a CAIP-19 asset identifier for Stacks tokens\n   */\n  private createAssetIdentifier(\n    network: Network,\n    contractAddress: string,\n  ): string {\n    return `${network}/sip010:${contractAddress}`;\n  }\n\n  /**\n   * Get the default asset info for a network.\n   */\n  private getDefaultAsset(\n    network: Network,\n  ): { contractAddress: string; symbol: string; name: string; decimals: number } {\n    // If a preferred token is configured, try to use it\n    if (this.config.preferredToken) {\n      const preferred = getTokenConfig(network, this.config.preferredToken);\n      if (preferred) return preferred;\n    }\n\n    // Use the network's default token\n    const defaultToken = getDefaultToken(network);\n    if (defaultToken) return defaultToken;\n\n    throw new Error(`No tokens configured for network ${network}`);\n  }\n\n  /**\n   * Get all supported networks\n   */\n  static getSupportedNetworks(): string[] {\n    return Object.keys(TOKEN_REGISTRY);\n  }\n\n  /**\n   * Check if a network is supported\n   */\n  static isNetworkSupported(network: string): boolean {\n    return network in TOKEN_REGISTRY;\n  }\n}\n\n/**\n * Create an exact-direct server for Stacks\n */\nexport function createExactDirectStacksServer(\n  config: ExactDirectStacksServerConfig = {},\n): ExactDirectStacksServer {\n  return new ExactDirectStacksServer(config);\n}\n","/**\n * Registration function for Stacks exact-direct server\n */\n\nimport { t402ResourceServer } from \"@t402/core/server\";\nimport type { Network } from \"@t402/core/types\";\nimport { STACKS_CAIP2_NAMESPACE } from \"../../constants.js\";\nimport { ExactDirectStacksServer, type ExactDirectStacksServerConfig } from \"./scheme.js\";\n\n/**\n * Configuration for registering Stacks server schemes\n */\nexport interface StacksServerRegistrationConfig extends ExactDirectStacksServerConfig {\n  /**\n   * Optional specific networks to register\n   * If not provided, registers wildcard support (stacks:*)\n   */\n  networks?: Network[];\n}\n\n/**\n * Registers Stacks exact-direct payment scheme to a t402ResourceServer instance.\n *\n * @param server - The t402ResourceServer instance to register schemes to\n * @param config - Configuration for Stacks server registration\n * @returns The server instance for chaining\n *\n * @example\n * ```typescript\n * import { registerExactDirectStacksServer } from \"@t402/stacks/exact-direct/server\";\n * import { t402ResourceServer } from \"@t402/core/server\";\n *\n * const server = new t402ResourceServer();\n * registerExactDirectStacksServer(server, {\n *   networks: [\"stacks:1\"]\n * });\n * ```\n */\nexport function registerExactDirectStacksServer(\n  server: t402ResourceServer,\n  config: StacksServerRegistrationConfig = {},\n): t402ResourceServer {\n  const scheme = new ExactDirectStacksServer(config);\n\n  // Register scheme\n  if (config.networks && config.networks.length > 0) {\n    // Register specific networks\n    config.networks.forEach((network) => {\n      server.register(network, scheme);\n    });\n  } else {\n    // Register wildcard for all Stacks networks\n    server.register(`${STACKS_CAIP2_NAMESPACE}:*`, scheme);\n  }\n\n  return server;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;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;AAYO,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;;;ACVO,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;;;ACnDO,IAAM,0BAAN,MAA6D;AAAA,EACzD,SAAS;AAAA,EACV,eAA8B,CAAC;AAAA,EAC/B;AAAA,EAER,YAAY,SAAwC,CAAC,GAAG;AACtD,SAAK,SAAS;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAKA,oBAAoB,QAA8C;AAChE,SAAK,aAAa,KAAK,MAAM;AAC7B,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,WAAW,OAAc,SAAwC;AAErE,QAAI,CAAC,gBAAgB,OAAO,GAAG;AAC7B,YAAM,IAAI,MAAM,2BAA2B,OAAO,EAAE;AAAA,IACtD;AAGA,QAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,YAAY,OAAO;AACpE,UAAI,CAAC,MAAM,OAAO;AAChB,cAAM,IAAI,MAAM,sDAAsD,OAAO,EAAE;AAAA,MACjF;AACA,aAAO;AAAA,QACL,QAAQ,MAAM;AAAA,QACd,OAAO,MAAM;AAAA,QACb,OAAO,MAAM,SAAS,CAAC;AAAA,MACzB;AAAA,IACF;AAGA,UAAM,SAAS,KAAK,oBAAoB,KAAK;AAG7C,eAAW,UAAU,KAAK,cAAc;AACtC,YAAM,SAAS,MAAM,OAAO,QAAQ,OAAO;AAC3C,UAAI,WAAW,MAAM;AACnB,eAAO;AAAA,MACT;AAAA,IACF;AAGA,WAAO,KAAK,uBAAuB,QAAQ,OAAO;AAAA,EACpD;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,2BACJ,qBACA,eAMA,uBAC8B;AAE9B,SAAK;AAGL,UAAM,QAAQ,EAAE,GAAG,oBAAoB,MAAM;AAG7C,QAAI,cAAc,OAAO,iBAAiB;AACxC,YAAM,kBAAkB,cAAc,MAAM;AAAA,IAC9C;AACA,QAAI,cAAc,OAAO,aAAa;AACpC,YAAM,cAAc,cAAc,MAAM;AAAA,IAC1C;AACA,QAAI,cAAc,OAAO,eAAe;AACtC,YAAM,gBAAgB,cAAc,MAAM;AAAA,IAC5C;AACA,QAAI,cAAc,OAAO,aAAa;AACpC,YAAM,cAAc,cAAc,MAAM;AAAA,IAC1C;AAEA,WAAO;AAAA,MACL,GAAG;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKQ,oBAAoB,OAAgC;AAC1D,QAAI,OAAO,UAAU,UAAU;AAC7B,aAAO;AAAA,IACT;AAGA,UAAM,aAAa,MAAM,QAAQ,OAAO,EAAE,EAAE,KAAK;AACjD,UAAM,SAAS,WAAW,UAAU;AAEpC,QAAI,MAAM,MAAM,GAAG;AACjB,YAAM,IAAI,MAAM,yBAAyB,KAAK,EAAE;AAAA,IAClD;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKQ,uBAAuB,QAAgB,SAA+B;AAC5E,UAAM,QAAQ,KAAK,gBAAgB,OAAO;AAG1C,UAAM,cAAc,YAAY,OAAO,SAAS,GAAG,MAAM,QAAQ;AAEjE,WAAO;AAAA,MACL,QAAQ,YAAY,SAAS;AAAA,MAC7B,OAAO,KAAK,sBAAsB,SAAS,MAAM,eAAe;AAAA,MAChE,OAAO;AAAA,QACL,QAAQ,MAAM;AAAA,QACd,MAAM,MAAM;AAAA,QACZ,UAAU,MAAM;AAAA,QAChB,iBAAiB,MAAM;AAAA,MACzB;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKQ,sBACN,SACA,iBACQ;AACR,WAAO,GAAG,OAAO,WAAW,eAAe;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA,EAKQ,gBACN,SAC6E;AAE7E,QAAI,KAAK,OAAO,gBAAgB;AAC9B,YAAM,YAAY,eAAe,SAAS,KAAK,OAAO,cAAc;AACpE,UAAI,UAAW,QAAO;AAAA,IACxB;AAGA,UAAM,eAAe,gBAAgB,OAAO;AAC5C,QAAI,aAAc,QAAO;AAEzB,UAAM,IAAI,MAAM,oCAAoC,OAAO,EAAE;AAAA,EAC/D;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,uBAAiC;AACtC,WAAO,OAAO,KAAK,cAAc;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,mBAAmB,SAA0B;AAClD,WAAO,WAAW;AAAA,EACpB;AACF;AAKO,SAAS,8BACd,SAAwC,CAAC,GAChB;AACzB,SAAO,IAAI,wBAAwB,MAAM;AAC3C;;;ACjLO,SAAS,gCACd,QACA,SAAyC,CAAC,GACtB;AACpB,QAAM,SAAS,IAAI,wBAAwB,MAAM;AAGjD,MAAI,OAAO,YAAY,OAAO,SAAS,SAAS,GAAG;AAEjD,WAAO,SAAS,QAAQ,CAAC,YAAY;AACnC,aAAO,SAAS,SAAS,MAAM;AAAA,IACjC,CAAC;AAAA,EACH,OAAO;AAEL,WAAO,SAAS,GAAG,sBAAsB,MAAM,MAAM;AAAA,EACvD;AAEA,SAAO;AACT;","names":[]}

package/dist/exact-direct/server/index.d.cts

@@ -0,0 +1,109 @@
+import { SchemeNetworkServer, MoneyParser, Price, Network, AssetAmount, PaymentRequirements } from '@t402/core/types';
+import { t402ResourceServer } from '@t402/core/server';
+
+/**
+ * Stacks Exact-Direct Server Scheme
+ *
+ * Handles price parsing and payment requirement enhancement for
+ * Stacks payments using the exact-direct scheme.
+ */
+
+/**
+ * Configuration for ExactDirectStacksServer
+ */
+interface ExactDirectStacksServerConfig {
+    /** Preferred token symbol (e.g., "sUSDC"). Defaults to network's default token. */
+    preferredToken?: string;
+}
+/**
+ * Stacks Exact-Direct Server
+ *
+ * Implements the server-side price parsing and payment requirements enhancement.
+ */
+declare class ExactDirectStacksServer implements SchemeNetworkServer {
+    readonly scheme = "exact-direct";
+    private moneyParsers;
+    private config;
+    constructor(config?: ExactDirectStacksServerConfig);
+    /**
+     * Register a custom money parser in the parser chain.
+     */
+    registerMoneyParser(parser: MoneyParser): ExactDirectStacksServer;
+    /**
+     * Parse price into Stacks-specific amount
+     */
+    parsePrice(price: Price, network: Network): Promise<AssetAmount>;
+    /**
+     * Enhance payment requirements with Stacks-specific details
+     */
+    enhancePaymentRequirements(paymentRequirements: PaymentRequirements, supportedKind: {
+        t402Version: number;
+        scheme: string;
+        network: Network;
+        extra?: Record<string, unknown>;
+    }, facilitatorExtensions: string[]): Promise<PaymentRequirements>;
+    /**
+     * Parse Money (string | number) to a decimal number.
+     */
+    private parseMoneyToDecimal;
+    /**
+     * Default money conversion implementation.
+     */
+    private defaultMoneyConversion;
+    /**
+     * Create a CAIP-19 asset identifier for Stacks tokens
+     */
+    private createAssetIdentifier;
+    /**
+     * Get the default asset info for a network.
+     */
+    private getDefaultAsset;
+    /**
+     * Get all supported networks
+     */
+    static getSupportedNetworks(): string[];
+    /**
+     * Check if a network is supported
+     */
+    static isNetworkSupported(network: string): boolean;
+}
+/**
+ * Create an exact-direct server for Stacks
+ */
+declare function createExactDirectStacksServer(config?: ExactDirectStacksServerConfig): ExactDirectStacksServer;
+
+/**
+ * Registration function for Stacks exact-direct server
+ */
+
+/**
+ * Configuration for registering Stacks server schemes
+ */
+interface StacksServerRegistrationConfig extends ExactDirectStacksServerConfig {
+    /**
+     * Optional specific networks to register
+     * If not provided, registers wildcard support (stacks:*)
+     */
+    networks?: Network[];
+}
+/**
+ * Registers Stacks exact-direct payment scheme to a t402ResourceServer instance.
+ *
+ * @param server - The t402ResourceServer instance to register schemes to
+ * @param config - Configuration for Stacks server registration
+ * @returns The server instance for chaining
+ *
+ * @example
+ * ```typescript
+ * import { registerExactDirectStacksServer } from "@t402/stacks/exact-direct/server";
+ * import { t402ResourceServer } from "@t402/core/server";
+ *
+ * const server = new t402ResourceServer();
+ * registerExactDirectStacksServer(server, {
+ *   networks: ["stacks:1"]
+ * });
+ * ```
+ */
+declare function registerExactDirectStacksServer(server: t402ResourceServer, config?: StacksServerRegistrationConfig): t402ResourceServer;
+
+export { ExactDirectStacksServer, type StacksServerRegistrationConfig, createExactDirectStacksServer, registerExactDirectStacksServer };

package/dist/exact-direct/server/index.d.ts

@@ -0,0 +1,109 @@
+import { SchemeNetworkServer, MoneyParser, Price, Network, AssetAmount, PaymentRequirements } from '@t402/core/types';
+import { t402ResourceServer } from '@t402/core/server';
+
+/**
+ * Stacks Exact-Direct Server Scheme
+ *
+ * Handles price parsing and payment requirement enhancement for
+ * Stacks payments using the exact-direct scheme.
+ */
+
+/**
+ * Configuration for ExactDirectStacksServer
+ */
+interface ExactDirectStacksServerConfig {
+    /** Preferred token symbol (e.g., "sUSDC"). Defaults to network's default token. */
+    preferredToken?: string;
+}
+/**
+ * Stacks Exact-Direct Server
+ *
+ * Implements the server-side price parsing and payment requirements enhancement.
+ */
+declare class ExactDirectStacksServer implements SchemeNetworkServer {
+    readonly scheme = "exact-direct";
+    private moneyParsers;
+    private config;
+    constructor(config?: ExactDirectStacksServerConfig);
+    /**
+     * Register a custom money parser in the parser chain.
+     */
+    registerMoneyParser(parser: MoneyParser): ExactDirectStacksServer;
+    /**
+     * Parse price into Stacks-specific amount
+     */
+    parsePrice(price: Price, network: Network): Promise<AssetAmount>;
+    /**
+     * Enhance payment requirements with Stacks-specific details
+     */
+    enhancePaymentRequirements(paymentRequirements: PaymentRequirements, supportedKind: {
+        t402Version: number;
+        scheme: string;
+        network: Network;
+        extra?: Record<string, unknown>;
+    }, facilitatorExtensions: string[]): Promise<PaymentRequirements>;
+    /**
+     * Parse Money (string | number) to a decimal number.
+     */
+    private parseMoneyToDecimal;
+    /**
+     * Default money conversion implementation.
+     */
+    private defaultMoneyConversion;
+    /**
+     * Create a CAIP-19 asset identifier for Stacks tokens
+     */
+    private createAssetIdentifier;
+    /**
+     * Get the default asset info for a network.
+     */
+    private getDefaultAsset;
+    /**
+     * Get all supported networks
+     */
+    static getSupportedNetworks(): string[];
+    /**
+     * Check if a network is supported
+     */
+    static isNetworkSupported(network: string): boolean;
+}
+/**
+ * Create an exact-direct server for Stacks
+ */
+declare function createExactDirectStacksServer(config?: ExactDirectStacksServerConfig): ExactDirectStacksServer;
+
+/**
+ * Registration function for Stacks exact-direct server
+ */
+
+/**
+ * Configuration for registering Stacks server schemes
+ */
+interface StacksServerRegistrationConfig extends ExactDirectStacksServerConfig {
+    /**
+     * Optional specific networks to register
+     * If not provided, registers wildcard support (stacks:*)
+     */
+    networks?: Network[];
+}
+/**
+ * Registers Stacks exact-direct payment scheme to a t402ResourceServer instance.
+ *
+ * @param server - The t402ResourceServer instance to register schemes to
+ * @param config - Configuration for Stacks server registration
+ * @returns The server instance for chaining
+ *
+ * @example
+ * ```typescript
+ * import { registerExactDirectStacksServer } from "@t402/stacks/exact-direct/server";
+ * import { t402ResourceServer } from "@t402/core/server";
+ *
+ * const server = new t402ResourceServer();
+ * registerExactDirectStacksServer(server, {
+ *   networks: ["stacks:1"]
+ * });
+ * ```
+ */
+declare function registerExactDirectStacksServer(server: t402ResourceServer, config?: StacksServerRegistrationConfig): t402ResourceServer;
+
+export { ExactDirectStacksServer, type StacksServerRegistrationConfig, createExactDirectStacksServer, registerExactDirectStacksServer };

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

@@ -0,0 +1,218 @@
+// 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;
+}
+export {
+  ExactDirectStacksServer,
+  createExactDirectStacksServer,
+  registerExactDirectStacksServer
+};
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/constants.ts","../../../src/tokens.ts","../../../src/utils.ts","../../../src/exact-direct/server/scheme.ts","../../../src/exact-direct/server/register.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 Server Scheme\n *\n * Handles price parsing and payment requirement enhancement for\n * Stacks payments using the exact-direct scheme.\n */\n\nimport type {\n  SchemeNetworkServer,\n  PaymentRequirements,\n  Price,\n  AssetAmount,\n  Network,\n  MoneyParser,\n} from \"@t402/core/types\";\nimport { SCHEME_EXACT_DIRECT, isStacksNetwork } from \"../../constants.js\";\nimport { getDefaultToken, getTokenConfig, TOKEN_REGISTRY } from \"../../tokens.js\";\nimport { parseAmount } from \"../../utils.js\";\n\n/**\n * Configuration for ExactDirectStacksServer\n */\nexport interface ExactDirectStacksServerConfig {\n  /** Preferred token symbol (e.g., \"sUSDC\"). Defaults to network's default token. */\n  preferredToken?: string;\n}\n\n/**\n * Stacks Exact-Direct Server\n *\n * Implements the server-side price parsing and payment requirements enhancement.\n */\nexport class ExactDirectStacksServer implements SchemeNetworkServer {\n  readonly scheme = SCHEME_EXACT_DIRECT;\n  private moneyParsers: MoneyParser[] = [];\n  private config: ExactDirectStacksServerConfig;\n\n  constructor(config: ExactDirectStacksServerConfig = {}) {\n    this.config = config;\n  }\n\n  /**\n   * Register a custom money parser in the parser chain.\n   */\n  registerMoneyParser(parser: MoneyParser): ExactDirectStacksServer {\n    this.moneyParsers.push(parser);\n    return this;\n  }\n\n  /**\n   * Parse price into Stacks-specific amount\n   */\n  async parsePrice(price: Price, network: Network): Promise<AssetAmount> {\n    // Validate network\n    if (!isStacksNetwork(network)) {\n      throw new Error(`Invalid Stacks network: ${network}`);\n    }\n\n    // If already an AssetAmount, return it directly\n    if (typeof price === \"object\" && price !== null && \"amount\" in price) {\n      if (!price.asset) {\n        throw new Error(`Asset must be specified for AssetAmount on network ${network}`);\n      }\n      return {\n        amount: price.amount,\n        asset: price.asset,\n        extra: price.extra || {},\n      };\n    }\n\n    // Parse Money to decimal number\n    const amount = this.parseMoneyToDecimal(price);\n\n    // Try each custom money parser in order\n    for (const parser of this.moneyParsers) {\n      const result = await parser(amount, network);\n      if (result !== null) {\n        return result;\n      }\n    }\n\n    // All custom parsers returned null, use default conversion\n    return this.defaultMoneyConversion(amount, network);\n  }\n\n  /**\n   * Enhance payment requirements with Stacks-specific details\n   */\n  async enhancePaymentRequirements(\n    paymentRequirements: PaymentRequirements,\n    supportedKind: {\n      t402Version: number;\n      scheme: string;\n      network: Network;\n      extra?: Record<string, unknown>;\n    },\n    facilitatorExtensions: string[],\n  ): Promise<PaymentRequirements> {\n    // Mark unused parameters\n    void facilitatorExtensions;\n\n    // Start with existing extra fields\n    const extra = { ...paymentRequirements.extra };\n\n    // Add any facilitator-provided extra fields\n    if (supportedKind.extra?.contractAddress) {\n      extra.contractAddress = supportedKind.extra.contractAddress;\n    }\n    if (supportedKind.extra?.assetSymbol) {\n      extra.assetSymbol = supportedKind.extra.assetSymbol;\n    }\n    if (supportedKind.extra?.assetDecimals) {\n      extra.assetDecimals = supportedKind.extra.assetDecimals;\n    }\n    if (supportedKind.extra?.networkName) {\n      extra.networkName = supportedKind.extra.networkName;\n    }\n\n    return {\n      ...paymentRequirements,\n      extra,\n    };\n  }\n\n  /**\n   * Parse Money (string | number) to a decimal number.\n   */\n  private parseMoneyToDecimal(money: string | number): number {\n    if (typeof money === \"number\") {\n      return money;\n    }\n\n    // Remove $ sign and whitespace, then parse\n    const cleanMoney = money.replace(/^\\$/, \"\").trim();\n    const amount = parseFloat(cleanMoney);\n\n    if (isNaN(amount)) {\n      throw new Error(`Invalid money format: ${money}`);\n    }\n\n    return amount;\n  }\n\n  /**\n   * Default money conversion implementation.\n   */\n  private defaultMoneyConversion(amount: number, network: Network): AssetAmount {\n    const token = this.getDefaultAsset(network);\n\n    // Convert decimal amount to token amount\n    const tokenAmount = parseAmount(amount.toString(), token.decimals);\n\n    return {\n      amount: tokenAmount.toString(),\n      asset: this.createAssetIdentifier(network, token.contractAddress),\n      extra: {\n        symbol: token.symbol,\n        name: token.name,\n        decimals: token.decimals,\n        contractAddress: token.contractAddress,\n      },\n    };\n  }\n\n  /**\n   * Create a CAIP-19 asset identifier for Stacks tokens\n   */\n  private createAssetIdentifier(\n    network: Network,\n    contractAddress: string,\n  ): string {\n    return `${network}/sip010:${contractAddress}`;\n  }\n\n  /**\n   * Get the default asset info for a network.\n   */\n  private getDefaultAsset(\n    network: Network,\n  ): { contractAddress: string; symbol: string; name: string; decimals: number } {\n    // If a preferred token is configured, try to use it\n    if (this.config.preferredToken) {\n      const preferred = getTokenConfig(network, this.config.preferredToken);\n      if (preferred) return preferred;\n    }\n\n    // Use the network's default token\n    const defaultToken = getDefaultToken(network);\n    if (defaultToken) return defaultToken;\n\n    throw new Error(`No tokens configured for network ${network}`);\n  }\n\n  /**\n   * Get all supported networks\n   */\n  static getSupportedNetworks(): string[] {\n    return Object.keys(TOKEN_REGISTRY);\n  }\n\n  /**\n   * Check if a network is supported\n   */\n  static isNetworkSupported(network: string): boolean {\n    return network in TOKEN_REGISTRY;\n  }\n}\n\n/**\n * Create an exact-direct server for Stacks\n */\nexport function createExactDirectStacksServer(\n  config: ExactDirectStacksServerConfig = {},\n): ExactDirectStacksServer {\n  return new ExactDirectStacksServer(config);\n}\n","/**\n * Registration function for Stacks exact-direct server\n */\n\nimport { t402ResourceServer } from \"@t402/core/server\";\nimport type { Network } from \"@t402/core/types\";\nimport { STACKS_CAIP2_NAMESPACE } from \"../../constants.js\";\nimport { ExactDirectStacksServer, type ExactDirectStacksServerConfig } from \"./scheme.js\";\n\n/**\n * Configuration for registering Stacks server schemes\n */\nexport interface StacksServerRegistrationConfig extends ExactDirectStacksServerConfig {\n  /**\n   * Optional specific networks to register\n   * If not provided, registers wildcard support (stacks:*)\n   */\n  networks?: Network[];\n}\n\n/**\n * Registers Stacks exact-direct payment scheme to a t402ResourceServer instance.\n *\n * @param server - The t402ResourceServer instance to register schemes to\n * @param config - Configuration for Stacks server registration\n * @returns The server instance for chaining\n *\n * @example\n * ```typescript\n * import { registerExactDirectStacksServer } from \"@t402/stacks/exact-direct/server\";\n * import { t402ResourceServer } from \"@t402/core/server\";\n *\n * const server = new t402ResourceServer();\n * registerExactDirectStacksServer(server, {\n *   networks: [\"stacks:1\"]\n * });\n * ```\n */\nexport function registerExactDirectStacksServer(\n  server: t402ResourceServer,\n  config: StacksServerRegistrationConfig = {},\n): t402ResourceServer {\n  const scheme = new ExactDirectStacksServer(config);\n\n  // Register scheme\n  if (config.networks && config.networks.length > 0) {\n    // Register specific networks\n    config.networks.forEach((network) => {\n      server.register(network, scheme);\n    });\n  } else {\n    // Register wildcard for all Stacks networks\n    server.register(`${STACKS_CAIP2_NAMESPACE}:*`, scheme);\n  }\n\n  return server;\n}\n"],"mappings":"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","names":[]}