@t402/tron 1.0.0 → 2.3.0

package/dist/esm/chunk-RHOZZ6XV.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/tokens.ts","../../src/exact/server/scheme.ts","../../src/exact/server/register.ts"],"sourcesContent":["/**\n * TRC20 Token Configuration\n *\n * Registry of supported TRC20 tokens for each TRON network.\n */\n\nimport type { TRC20Config, NetworkTRC20Registry } from \"./types.js\";\nimport {\n  TRON_MAINNET_CAIP2,\n  TRON_NILE_CAIP2,\n  TRON_SHASTA_CAIP2,\n  USDT_ADDRESSES,\n  DEFAULT_USDT_DECIMALS,\n} from \"./constants.js\";\n\n// =============================================================================\n// USDT Token Configurations\n// =============================================================================\n\n/** USDT on TRON Mainnet */\nconst USDT_MAINNET: TRC20Config = {\n  contractAddress: USDT_ADDRESSES[TRON_MAINNET_CAIP2],\n  symbol: \"USDT\",\n  name: \"Tether USD\",\n  decimals: DEFAULT_USDT_DECIMALS,\n};\n\n/** USDT on TRON Nile Testnet */\nconst USDT_NILE: TRC20Config = {\n  contractAddress: USDT_ADDRESSES[TRON_NILE_CAIP2],\n  symbol: \"USDT\",\n  name: \"Tether USD\",\n  decimals: DEFAULT_USDT_DECIMALS,\n};\n\n/** USDT on TRON Shasta Testnet */\nconst USDT_SHASTA: TRC20Config = {\n  contractAddress: USDT_ADDRESSES[TRON_SHASTA_CAIP2],\n  symbol: \"USDT\",\n  name: \"Tether USD\",\n  decimals: DEFAULT_USDT_DECIMALS,\n};\n\n// =============================================================================\n// Token Registry\n// =============================================================================\n\n/**\n * Registry of TRC20 tokens by network\n */\nexport const TRC20_REGISTRY: Record<string, NetworkTRC20Registry> = {\n  [TRON_MAINNET_CAIP2]: {\n    network: TRON_MAINNET_CAIP2,\n    defaultToken: USDT_MAINNET,\n    tokens: {\n      USDT: USDT_MAINNET,\n    },\n  },\n  [TRON_NILE_CAIP2]: {\n    network: TRON_NILE_CAIP2,\n    defaultToken: USDT_NILE,\n    tokens: {\n      USDT: USDT_NILE,\n    },\n  },\n  [TRON_SHASTA_CAIP2]: {\n    network: TRON_SHASTA_CAIP2,\n    defaultToken: USDT_SHASTA,\n    tokens: {\n      USDT: USDT_SHASTA,\n    },\n  },\n};\n\n// =============================================================================\n// Utility Functions\n// =============================================================================\n\n/**\n * Get TRC20 configuration for a specific token on a network\n *\n * @param network - CAIP-2 network identifier\n * @param symbol - Token symbol (e.g., \"USDT\")\n * @returns Token configuration or undefined if not found\n */\nexport function getTRC20Config(network: string, symbol: string): TRC20Config | undefined {\n  const registry = TRC20_REGISTRY[network];\n  if (!registry) return undefined;\n  return registry.tokens[symbol];\n}\n\n/**\n * Get all TRC20 tokens for a network\n *\n * @param network - CAIP-2 network identifier\n * @returns Array of token configurations\n */\nexport function getNetworkTokens(network: string): TRC20Config[] {\n  const registry = TRC20_REGISTRY[network];\n  if (!registry) return [];\n  return Object.values(registry.tokens);\n}\n\n/**\n * Get the default TRC20 token for a network\n *\n * @param network - CAIP-2 network identifier\n * @returns Default token configuration or undefined\n */\nexport function getDefaultToken(network: string): TRC20Config | undefined {\n  const registry = TRC20_REGISTRY[network];\n  return registry?.defaultToken;\n}\n\n/**\n * Get token by contract address\n *\n * @param network - CAIP-2 network identifier\n * @param contractAddress - TRC20 contract address\n * @returns Token configuration or undefined\n */\nexport function getTokenByAddress(network: string, contractAddress: string): TRC20Config | undefined {\n  const registry = TRC20_REGISTRY[network];\n  if (!registry) return undefined;\n\n  const upperAddress = contractAddress.toUpperCase();\n  return Object.values(registry.tokens).find(\n    token => token.contractAddress.toUpperCase() === upperAddress,\n  );\n}\n\n/**\n * Get all networks that support a specific token\n *\n * @param symbol - Token symbol (e.g., \"USDT\")\n * @returns Array of network identifiers\n */\nexport function getNetworksForToken(symbol: string): string[] {\n  return Object.entries(TRC20_REGISTRY)\n    .filter(([_, registry]) => symbol in registry.tokens)\n    .map(([network]) => network);\n}\n\n/**\n * Get all networks that support USDT\n *\n * @returns Array of network identifiers\n */\nexport function getUsdtNetworks(): string[] {\n  return getNetworksForToken(\"USDT\");\n}\n\n/**\n * Check if a network is supported\n *\n * @param network - CAIP-2 network identifier\n * @returns true if network is supported\n */\nexport function isNetworkSupported(network: string): boolean {\n  return network in TRC20_REGISTRY;\n}\n\n/**\n * Get all supported networks\n *\n * @returns Array of network identifiers\n */\nexport function getSupportedNetworks(): string[] {\n  return Object.keys(TRC20_REGISTRY);\n}\n","/**\n * TRON Exact Payment Scheme - Server Implementation\n *\n * Parses prices and enhances payment requirements for TRC20 payments.\n */\n\nimport type {\n  AssetAmount,\n  Network,\n  PaymentRequirements,\n  Price,\n  SchemeNetworkServer,\n  MoneyParser,\n} from \"@t402/core/types\";\nimport { SCHEME_EXACT, DEFAULT_USDT_DECIMALS } from \"../../constants.js\";\nimport { normalizeNetwork, convertToSmallestUnits } from \"../../utils.js\";\nimport { getDefaultToken, getTRC20Config, isNetworkSupported } from \"../../tokens.js\";\n\n/**\n * Configuration for ExactTronScheme (server)\n */\nexport type ExactTronSchemeConfig = {\n  /** Preferred token symbol (default: highest priority) */\n  preferredToken?: string;\n};\n\n/**\n * Server-side implementation of the TRON exact payment scheme\n *\n * This scheme parses prices and prepares payment requirements\n * for TRC20 token transfers.\n */\nexport class ExactTronScheme implements SchemeNetworkServer {\n  readonly scheme = SCHEME_EXACT;\n  private readonly config: ExactTronSchemeConfig;\n  private readonly moneyParsers: MoneyParser[] = []\n\n  constructor(config?: ExactTronSchemeConfig) {\n    this.config = config ?? {};\n  }\n\n  /**\n   * Register a custom money parser\n   *\n   * Parsers are tried in registration order. Return null to pass to next parser.\n   *\n   * @param parser - Money parser function\n   * @returns This scheme for chaining\n   */\n  registerMoneyParser(parser: MoneyParser): ExactTronScheme {\n    this.moneyParsers.push(parser);\n    return this;\n  }\n\n  /**\n   * Parse a price into an asset amount\n   *\n   * @param price - Price to parse (string, number, or AssetAmount)\n   * @param network - Target network\n   * @returns Parsed asset amount\n   */\n  async parsePrice(price: Price, network: Network): Promise<AssetAmount> {\n    const normalizedNetwork = normalizeNetwork(String(network));\n\n    // Validate network support\n    if (!isNetworkSupported(normalizedNetwork)) {\n      throw new Error(`Unsupported network: ${network}`);\n    }\n\n    // If already an AssetAmount, return it\n    if (typeof price === \"object\" && price !== null && \"amount\" in price) {\n      const assetAmount = price as AssetAmount;\n      return {\n        amount: assetAmount.amount,\n        asset: assetAmount.asset || this.getDefaultAsset(normalizedNetwork),\n        extra: assetAmount.extra,\n      };\n    }\n\n    // Parse money to decimal\n    const decimalAmount = this.parseMoneyToDecimal(price);\n\n    // Try custom parsers first\n    for (const parser of this.moneyParsers) {\n      try {\n        const result = await parser(decimalAmount, network);\n        if (result !== null) {\n          return result;\n        }\n      } catch {\n        // Parser failed, try next one\n        continue;\n      }\n    }\n\n    // Use default conversion (USDT with 6 decimals)\n    return this.defaultMoneyConversion(decimalAmount, normalizedNetwork);\n  }\n\n  /**\n   * Enhance payment requirements with scheme-specific data\n   *\n   * @param requirements - Base payment requirements\n   * @param supportedKind - Supported payment kind\n   * @param extensionKeys - Extension keys to include\n   * @returns Enhanced payment requirements\n   */\n  async enhancePaymentRequirements(\n    requirements: PaymentRequirements,\n    supportedKind: {\n      t402Version: number;\n      scheme: string;\n      network: Network;\n      extra?: Record<string, unknown>;\n    },\n    extensionKeys: string[],\n  ): Promise<PaymentRequirements> {\n    void extensionKeys;\n    const network = normalizeNetwork(String(requirements.network));\n\n    // Get token config\n    let tokenConfig = requirements.asset\n      ? getTRC20Config(network, requirements.asset) || this.getTokenByAddress(network, requirements.asset)\n      : getDefaultToken(network);\n\n    if (!tokenConfig) {\n      tokenConfig = getDefaultToken(network);\n    }\n\n    // Initialize extra if needed\n    const extra: Record<string, unknown> = { ...requirements.extra };\n\n    // Add token metadata\n    if (tokenConfig) {\n      extra.symbol = tokenConfig.symbol;\n      extra.name = tokenConfig.name;\n      extra.decimals = tokenConfig.decimals;\n    }\n\n    // Copy extension data\n    if (supportedKind.extra) {\n      for (const key of extensionKeys) {\n        if (key in supportedKind.extra) {\n          extra[key] = supportedKind.extra[key];\n        }\n      }\n    }\n\n    return {\n      ...requirements,\n      asset: tokenConfig?.contractAddress || requirements.asset,\n      extra,\n    };\n  }\n\n  /**\n   * Parse money (string/number) to decimal number\n   */\n  private parseMoneyToDecimal(price: Price): number {\n    if (typeof price === \"number\") {\n      return price;\n    }\n\n    if (typeof price === \"string\") {\n      // Remove currency symbols and whitespace\n      let cleanPrice = price.trim();\n      cleanPrice = cleanPrice.replace(/^\\$/, \"\").trim();\n\n      // Parse the numeric part\n      const parts = cleanPrice.split(/\\s+/);\n      const numericPart = parts[0];\n      const parsed = parseFloat(numericPart);\n\n      if (isNaN(parsed)) {\n        throw new Error(`Failed to parse price: ${price}`);\n      }\n\n      return parsed;\n    }\n\n    throw new Error(`Invalid price type: ${typeof price}`);\n  }\n\n  /**\n   * Default money to asset conversion (USDT)\n   */\n  private defaultMoneyConversion(decimalAmount: number, network: string): AssetAmount {\n    const tokenConfig = getDefaultToken(network);\n    if (!tokenConfig) {\n      throw new Error(`No default token for network: ${network}`);\n    }\n\n    const amount = convertToSmallestUnits(decimalAmount.toFixed(6), tokenConfig.decimals);\n\n    return {\n      amount,\n      asset: tokenConfig.contractAddress,\n      extra: {\n        symbol: tokenConfig.symbol,\n        name: tokenConfig.name,\n        decimals: tokenConfig.decimals,\n      },\n    };\n  }\n\n  /**\n   * Get default asset address for network\n   */\n  private getDefaultAsset(network: string): string {\n    const tokenConfig = getDefaultToken(network);\n    if (!tokenConfig) {\n      throw new Error(`No default token for network: ${network}`);\n    }\n    return tokenConfig.contractAddress;\n  }\n\n  /**\n   * Get token config by contract address\n   */\n  private getTokenByAddress(network: string, address: string): { contractAddress: string; symbol: string; name: string; decimals: number } | undefined {\n    // Import dynamically to avoid circular deps\n    const { getTokenByAddress } = require(\"../../tokens.js\");\n    return getTokenByAddress(network, address);\n  }\n}\n","/**\n * TRON Server Scheme Registration\n *\n * Helper function to register TRON exact scheme with a t402 resource server.\n */\n\nimport { t402ResourceServer } from \"@t402/core/server\";\nimport { Network } from \"@t402/core/types\";\nimport { ExactTronScheme, ExactTronSchemeConfig } from \"./scheme.js\";\n\n/**\n * Configuration options for registering TRON schemes to a t402ResourceServer\n */\nexport interface TronResourceServerConfig {\n  /**\n   * Optional specific networks to register\n   * If not provided, registers wildcard support (tron:*)\n   */\n  networks?: Network[];\n\n  /**\n   * Optional scheme configuration (preferred token, etc.)\n   */\n  schemeConfig?: ExactTronSchemeConfig;\n}\n\n/**\n * Registers TRON exact payment schemes to a t402ResourceServer instance.\n *\n * This function registers:\n * - V2: tron:* wildcard scheme with ExactTronScheme (or specific networks if provided)\n *\n * @param server - The t402ResourceServer instance to register schemes to\n * @param config - Configuration for TRON resource server registration\n * @returns The server instance for chaining\n *\n * @example\n * ```typescript\n * import { registerExactTronScheme } from \"@t402/tron/exact/server\";\n * import { t402ResourceServer } from \"@t402/core/server\";\n *\n * const server = new t402ResourceServer(facilitatorClient);\n * registerExactTronScheme(server, {});\n *\n * // Or with specific token preference\n * registerExactTronScheme(server, {\n *   schemeConfig: { preferredToken: \"USDT\" }\n * });\n * ```\n */\nexport function registerExactTronScheme(\n  server: t402ResourceServer,\n  config: TronResourceServerConfig = {},\n): t402ResourceServer {\n  const scheme = new ExactTronScheme(config.schemeConfig);\n\n  // Register V2 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 TRON networks\n    server.register(\"tron:*\", scheme);\n  }\n\n  return server;\n}\n"],"mappings":"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","names":["getTokenByAddress"]}