@t402/tron 1.0.0

package/dist/esm/chunk-RHOZZ6XV.mjs

@@ -0,0 +1,285 @@
+import {
+  DEFAULT_USDT_DECIMALS,
+  SCHEME_EXACT,
+  TRON_MAINNET_CAIP2,
+  TRON_NILE_CAIP2,
+  TRON_SHASTA_CAIP2,
+  USDT_ADDRESSES,
+  __esm,
+  __export,
+  __toCommonJS,
+  convertToSmallestUnits,
+  init_constants,
+  normalizeNetwork
+} from "./chunk-L773HPM3.mjs";
+
+// src/tokens.ts
+var tokens_exports = {};
+__export(tokens_exports, {
+  TRC20_REGISTRY: () => TRC20_REGISTRY,
+  getDefaultToken: () => getDefaultToken,
+  getNetworkTokens: () => getNetworkTokens,
+  getNetworksForToken: () => getNetworksForToken,
+  getSupportedNetworks: () => getSupportedNetworks,
+  getTRC20Config: () => getTRC20Config,
+  getTokenByAddress: () => getTokenByAddress,
+  getUsdtNetworks: () => getUsdtNetworks,
+  isNetworkSupported: () => isNetworkSupported
+});
+function getTRC20Config(network, symbol) {
+  const registry = TRC20_REGISTRY[network];
+  if (!registry) return void 0;
+  return registry.tokens[symbol];
+}
+function getNetworkTokens(network) {
+  const registry = TRC20_REGISTRY[network];
+  if (!registry) return [];
+  return Object.values(registry.tokens);
+}
+function getDefaultToken(network) {
+  const registry = TRC20_REGISTRY[network];
+  return registry?.defaultToken;
+}
+function getTokenByAddress(network, contractAddress) {
+  const registry = TRC20_REGISTRY[network];
+  if (!registry) return void 0;
+  const upperAddress = contractAddress.toUpperCase();
+  return Object.values(registry.tokens).find(
+    (token) => token.contractAddress.toUpperCase() === upperAddress
+  );
+}
+function getNetworksForToken(symbol) {
+  return Object.entries(TRC20_REGISTRY).filter(([_, registry]) => symbol in registry.tokens).map(([network]) => network);
+}
+function getUsdtNetworks() {
+  return getNetworksForToken("USDT");
+}
+function isNetworkSupported(network) {
+  return network in TRC20_REGISTRY;
+}
+function getSupportedNetworks() {
+  return Object.keys(TRC20_REGISTRY);
+}
+var USDT_MAINNET, USDT_NILE, USDT_SHASTA, TRC20_REGISTRY;
+var init_tokens = __esm({
+  "src/tokens.ts"() {
+    "use strict";
+    init_constants();
+    USDT_MAINNET = {
+      contractAddress: USDT_ADDRESSES[TRON_MAINNET_CAIP2],
+      symbol: "USDT",
+      name: "Tether USD",
+      decimals: DEFAULT_USDT_DECIMALS
+    };
+    USDT_NILE = {
+      contractAddress: USDT_ADDRESSES[TRON_NILE_CAIP2],
+      symbol: "USDT",
+      name: "Tether USD",
+      decimals: DEFAULT_USDT_DECIMALS
+    };
+    USDT_SHASTA = {
+      contractAddress: USDT_ADDRESSES[TRON_SHASTA_CAIP2],
+      symbol: "USDT",
+      name: "Tether USD",
+      decimals: DEFAULT_USDT_DECIMALS
+    };
+    TRC20_REGISTRY = {
+      [TRON_MAINNET_CAIP2]: {
+        network: TRON_MAINNET_CAIP2,
+        defaultToken: USDT_MAINNET,
+        tokens: {
+          USDT: USDT_MAINNET
+        }
+      },
+      [TRON_NILE_CAIP2]: {
+        network: TRON_NILE_CAIP2,
+        defaultToken: USDT_NILE,
+        tokens: {
+          USDT: USDT_NILE
+        }
+      },
+      [TRON_SHASTA_CAIP2]: {
+        network: TRON_SHASTA_CAIP2,
+        defaultToken: USDT_SHASTA,
+        tokens: {
+          USDT: USDT_SHASTA
+        }
+      }
+    };
+  }
+});
+
+// src/exact/server/scheme.ts
+init_constants();
+init_tokens();
+var ExactTronScheme = class {
+  constructor(config) {
+    this.scheme = SCHEME_EXACT;
+    this.moneyParsers = [];
+    this.config = config ?? {};
+  }
+  /**
+   * Register a custom money parser
+   *
+   * Parsers are tried in registration order. Return null to pass to next parser.
+   *
+   * @param parser - Money parser function
+   * @returns This scheme for chaining
+   */
+  registerMoneyParser(parser) {
+    this.moneyParsers.push(parser);
+    return this;
+  }
+  /**
+   * Parse a price into an asset amount
+   *
+   * @param price - Price to parse (string, number, or AssetAmount)
+   * @param network - Target network
+   * @returns Parsed asset amount
+   */
+  async parsePrice(price, network) {
+    const normalizedNetwork = normalizeNetwork(String(network));
+    if (!isNetworkSupported(normalizedNetwork)) {
+      throw new Error(`Unsupported network: ${network}`);
+    }
+    if (typeof price === "object" && price !== null && "amount" in price) {
+      const assetAmount = price;
+      return {
+        amount: assetAmount.amount,
+        asset: assetAmount.asset || this.getDefaultAsset(normalizedNetwork),
+        extra: assetAmount.extra
+      };
+    }
+    const decimalAmount = this.parseMoneyToDecimal(price);
+    for (const parser of this.moneyParsers) {
+      try {
+        const result = await parser(decimalAmount, network);
+        if (result !== null) {
+          return result;
+        }
+      } catch {
+        continue;
+      }
+    }
+    return this.defaultMoneyConversion(decimalAmount, normalizedNetwork);
+  }
+  /**
+   * Enhance payment requirements with scheme-specific data
+   *
+   * @param requirements - Base payment requirements
+   * @param supportedKind - Supported payment kind
+   * @param extensionKeys - Extension keys to include
+   * @returns Enhanced payment requirements
+   */
+  async enhancePaymentRequirements(requirements, supportedKind, extensionKeys) {
+    void extensionKeys;
+    const network = normalizeNetwork(String(requirements.network));
+    let tokenConfig = requirements.asset ? getTRC20Config(network, requirements.asset) || this.getTokenByAddress(network, requirements.asset) : getDefaultToken(network);
+    if (!tokenConfig) {
+      tokenConfig = getDefaultToken(network);
+    }
+    const extra = { ...requirements.extra };
+    if (tokenConfig) {
+      extra.symbol = tokenConfig.symbol;
+      extra.name = tokenConfig.name;
+      extra.decimals = tokenConfig.decimals;
+    }
+    if (supportedKind.extra) {
+      for (const key of extensionKeys) {
+        if (key in supportedKind.extra) {
+          extra[key] = supportedKind.extra[key];
+        }
+      }
+    }
+    return {
+      ...requirements,
+      asset: tokenConfig?.contractAddress || requirements.asset,
+      extra
+    };
+  }
+  /**
+   * Parse money (string/number) to decimal number
+   */
+  parseMoneyToDecimal(price) {
+    if (typeof price === "number") {
+      return price;
+    }
+    if (typeof price === "string") {
+      let cleanPrice = price.trim();
+      cleanPrice = cleanPrice.replace(/^\$/, "").trim();
+      const parts = cleanPrice.split(/\s+/);
+      const numericPart = parts[0];
+      const parsed = parseFloat(numericPart);
+      if (isNaN(parsed)) {
+        throw new Error(`Failed to parse price: ${price}`);
+      }
+      return parsed;
+    }
+    throw new Error(`Invalid price type: ${typeof price}`);
+  }
+  /**
+   * Default money to asset conversion (USDT)
+   */
+  defaultMoneyConversion(decimalAmount, network) {
+    const tokenConfig = getDefaultToken(network);
+    if (!tokenConfig) {
+      throw new Error(`No default token for network: ${network}`);
+    }
+    const amount = convertToSmallestUnits(decimalAmount.toFixed(6), tokenConfig.decimals);
+    return {
+      amount,
+      asset: tokenConfig.contractAddress,
+      extra: {
+        symbol: tokenConfig.symbol,
+        name: tokenConfig.name,
+        decimals: tokenConfig.decimals
+      }
+    };
+  }
+  /**
+   * Get default asset address for network
+   */
+  getDefaultAsset(network) {
+    const tokenConfig = getDefaultToken(network);
+    if (!tokenConfig) {
+      throw new Error(`No default token for network: ${network}`);
+    }
+    return tokenConfig.contractAddress;
+  }
+  /**
+   * Get token config by contract address
+   */
+  getTokenByAddress(network, address) {
+    const { getTokenByAddress: getTokenByAddress2 } = (init_tokens(), __toCommonJS(tokens_exports));
+    return getTokenByAddress2(network, address);
+  }
+};
+
+// src/exact/server/register.ts
+function registerExactTronScheme(server, config = {}) {
+  const scheme = new ExactTronScheme(config.schemeConfig);
+  if (config.networks && config.networks.length > 0) {
+    config.networks.forEach((network) => {
+      server.register(network, scheme);
+    });
+  } else {
+    server.register("tron:*", scheme);
+  }
+  return server;
+}
+
+export {
+  TRC20_REGISTRY,
+  getTRC20Config,
+  getNetworkTokens,
+  getDefaultToken,
+  getTokenByAddress,
+  getNetworksForToken,
+  getUsdtNetworks,
+  isNetworkSupported,
+  getSupportedNetworks,
+  init_tokens,
+  ExactTronScheme,
+  registerExactTronScheme
+};
+//# sourceMappingURL=chunk-RHOZZ6XV.mjs.map

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

@@ -0,0 +1 @@
+{"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"]}

package/dist/esm/exact/client/index.d.mts

@@ -0,0 +1,90 @@
+import { SchemeNetworkClient, PaymentRequirements, PaymentPayload, Network } from '@t402/core/types';
+import { C as ClientTronSigner } from '../../signer-BB-HLs-P.mjs';
+import { t402Client, PaymentPolicy } from '@t402/core/client';
+
+/**
+ * TRON Exact Payment Scheme - Client Implementation
+ *
+ * Creates payment payloads for TRC20 token transfers.
+ */
+
+/**
+ * Configuration for ExactTronScheme
+ */
+type ExactTronSchemeConfig = {
+    /** Fee limit for transactions in SUN (default: 100 TRX) */
+    feeLimit?: number;
+};
+/**
+ * Client-side implementation of the TRON exact payment scheme
+ *
+ * This scheme creates pre-signed TRC20 transfer transactions
+ * that can be verified and broadcast by the facilitator.
+ */
+declare class ExactTronScheme implements SchemeNetworkClient {
+    readonly scheme = "exact";
+    private readonly signer;
+    private readonly config;
+    constructor(signer: ClientTronSigner, config?: ExactTronSchemeConfig);
+    /**
+     * Creates a payment payload for a TRC20 transfer
+     *
+     * @param t402Version - Protocol version (must be 2)
+     * @param requirements - Payment requirements from server
+     * @returns Payment payload with signed transaction
+     */
+    createPaymentPayload(t402Version: number, requirements: PaymentRequirements): Promise<Pick<PaymentPayload, "t402Version" | "payload">>;
+}
+
+/**
+ * TRON Client Scheme Registration
+ *
+ * Helper function to register TRON exact scheme with a t402 client.
+ */
+
+/**
+ * Configuration options for registering TRON schemes to a t402Client
+ */
+interface TronClientConfig {
+    /**
+     * The TRON signer to use for creating payment payloads
+     */
+    signer: ClientTronSigner;
+    /**
+     * Optional policies to apply to the client
+     */
+    policies?: PaymentPolicy[];
+    /**
+     * Optional specific networks to register
+     * If not provided, registers wildcard support (tron:*)
+     */
+    networks?: Network[];
+    /**
+     * Optional scheme configuration (fee limits, etc.)
+     */
+    schemeConfig?: ExactTronSchemeConfig;
+}
+/**
+ * Registers TRON exact payment schemes to a t402Client instance.
+ *
+ * This function registers:
+ * - V2: tron:* wildcard scheme with ExactTronScheme (or specific networks if provided)
+ *
+ * @param client - The t402Client instance to register schemes to
+ * @param config - Configuration for TRON client registration
+ * @returns The client instance for chaining
+ *
+ * @example
+ * ```typescript
+ * import { registerExactTronScheme } from "@t402/tron/exact/client";
+ * import { t402Client } from "@t402/core/client";
+ *
+ * const client = new t402Client();
+ * registerExactTronScheme(client, {
+ *   signer: tronSigner,
+ * });
+ * ```
+ */
+declare function registerExactTronScheme(client: t402Client, config: TronClientConfig): t402Client;
+
+export { ExactTronScheme, type ExactTronSchemeConfig, type TronClientConfig, registerExactTronScheme };

package/dist/esm/exact/client/index.mjs

@@ -0,0 +1,10 @@
+import {
+  ExactTronScheme,
+  registerExactTronScheme
+} from "../../chunk-A2E6FJU3.mjs";
+import "../../chunk-L773HPM3.mjs";
+export {
+  ExactTronScheme,
+  registerExactTronScheme
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/exact/client/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/esm/exact/facilitator/index.d.mts

@@ -0,0 +1,114 @@
+import { SchemeNetworkFacilitator, PaymentPayload, PaymentRequirements, VerifyResponse, SettleResponse, Network } from '@t402/core/types';
+import { F as FacilitatorTronSigner } from '../../signer-BB-HLs-P.mjs';
+import { t402Facilitator } from '@t402/core/facilitator';
+
+/**
+ * TRON Exact Payment Scheme - Facilitator Implementation
+ *
+ * Verifies and settles TRC20 token transfer payments.
+ */
+
+/**
+ * Configuration for ExactTronScheme (facilitator)
+ */
+type ExactTronSchemeConfig = {
+    /** Whether this facilitator can sponsor gas */
+    canSponsorGas?: boolean;
+};
+/**
+ * Facilitator-side implementation of the TRON exact payment scheme
+ *
+ * This scheme verifies and settles pre-signed TRC20 transfer transactions.
+ */
+declare class ExactTronScheme implements SchemeNetworkFacilitator {
+    readonly scheme = "exact";
+    readonly caipFamily = "tron:*";
+    private readonly signer;
+    private readonly config;
+    constructor(signer: FacilitatorTronSigner, config?: ExactTronSchemeConfig);
+    /**
+     * Get extra data to include in payment requirements
+     */
+    getExtra(network: string): Record<string, unknown> | undefined;
+    /**
+     * Get facilitator addresses that can receive payments
+     */
+    getSigners(network: string): string[];
+    /**
+     * Verify a payment payload
+     *
+     * Performs comprehensive validation:
+     * 1. Scheme matching
+     * 2. Network matching
+     * 3. Payload structure validation
+     * 4. Transaction signature verification
+     * 5. Authorization expiry check
+     * 6. Balance verification
+     * 7. Amount sufficiency
+     * 8. Recipient matching
+     * 9. Contract address matching
+     * 10. Account activation check
+     */
+    verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
+    /**
+     * Settle a verified payment
+     *
+     * Broadcasts the transaction and waits for confirmation.
+     */
+    settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
+}
+
+/**
+ * TRON Facilitator Scheme Registration
+ *
+ * Helper function to register TRON exact scheme with a t402 facilitator.
+ */
+
+/**
+ * Configuration options for registering TRON schemes to a t402Facilitator
+ */
+interface TronFacilitatorConfig {
+    /**
+     * The signer to use for verification and settlement
+     */
+    signer: FacilitatorTronSigner;
+    /**
+     * Optional specific networks to register
+     * If not provided, registers wildcard support (tron:*)
+     */
+    networks?: Network[];
+    /**
+     * Optional scheme configuration
+     */
+    schemeConfig?: ExactTronSchemeConfig;
+}
+/**
+ * Registers TRON exact payment schemes to a t402Facilitator instance.
+ *
+ * This function registers:
+ * - V2: tron:* wildcard scheme with ExactTronScheme (or specific networks if provided)
+ *
+ * @param facilitator - The t402Facilitator instance to register schemes to
+ * @param config - Configuration for TRON facilitator registration
+ * @returns The facilitator instance for chaining
+ *
+ * @example
+ * ```typescript
+ * import { registerExactTronScheme } from "@t402/tron/exact/facilitator";
+ * import { t402Facilitator } from "@t402/core/facilitator";
+ *
+ * const signer = new MyTronSigner(privateKey);
+ * const facilitator = new t402Facilitator();
+ * registerExactTronScheme(facilitator, { signer });
+ *
+ * // Or with specific networks
+ * registerExactTronScheme(facilitator, {
+ *   signer,
+ *   networks: ["tron:mainnet"],
+ *   schemeConfig: { canSponsorGas: true }
+ * });
+ * ```
+ */
+declare function registerExactTronScheme(facilitator: t402Facilitator, config: TronFacilitatorConfig): t402Facilitator;
+
+export { ExactTronScheme, type ExactTronSchemeConfig, type TronFacilitatorConfig, registerExactTronScheme };

package/dist/esm/exact/facilitator/index.mjs

@@ -0,0 +1,10 @@
+import {
+  ExactTronScheme,
+  registerExactTronScheme
+} from "../../chunk-CH6GR2VO.mjs";
+import "../../chunk-L773HPM3.mjs";
+export {
+  ExactTronScheme,
+  registerExactTronScheme
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/exact/facilitator/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/esm/exact/server/index.d.mts

@@ -0,0 +1,123 @@
+import { SchemeNetworkServer, MoneyParser, Price, Network, AssetAmount, PaymentRequirements } from '@t402/core/types';
+import { t402ResourceServer } from '@t402/core/server';
+
+/**
+ * TRON Exact Payment Scheme - Server Implementation
+ *
+ * Parses prices and enhances payment requirements for TRC20 payments.
+ */
+
+/**
+ * Configuration for ExactTronScheme (server)
+ */
+type ExactTronSchemeConfig = {
+    /** Preferred token symbol (default: highest priority) */
+    preferredToken?: string;
+};
+/**
+ * Server-side implementation of the TRON exact payment scheme
+ *
+ * This scheme parses prices and prepares payment requirements
+ * for TRC20 token transfers.
+ */
+declare class ExactTronScheme implements SchemeNetworkServer {
+    readonly scheme = "exact";
+    private readonly config;
+    private readonly moneyParsers;
+    constructor(config?: ExactTronSchemeConfig);
+    /**
+     * Register a custom money parser
+     *
+     * Parsers are tried in registration order. Return null to pass to next parser.
+     *
+     * @param parser - Money parser function
+     * @returns This scheme for chaining
+     */
+    registerMoneyParser(parser: MoneyParser): ExactTronScheme;
+    /**
+     * Parse a price into an asset amount
+     *
+     * @param price - Price to parse (string, number, or AssetAmount)
+     * @param network - Target network
+     * @returns Parsed asset amount
+     */
+    parsePrice(price: Price, network: Network): Promise<AssetAmount>;
+    /**
+     * Enhance payment requirements with scheme-specific data
+     *
+     * @param requirements - Base payment requirements
+     * @param supportedKind - Supported payment kind
+     * @param extensionKeys - Extension keys to include
+     * @returns Enhanced payment requirements
+     */
+    enhancePaymentRequirements(requirements: PaymentRequirements, supportedKind: {
+        t402Version: number;
+        scheme: string;
+        network: Network;
+        extra?: Record<string, unknown>;
+    }, extensionKeys: string[]): Promise<PaymentRequirements>;
+    /**
+     * Parse money (string/number) to decimal number
+     */
+    private parseMoneyToDecimal;
+    /**
+     * Default money to asset conversion (USDT)
+     */
+    private defaultMoneyConversion;
+    /**
+     * Get default asset address for network
+     */
+    private getDefaultAsset;
+    /**
+     * Get token config by contract address
+     */
+    private getTokenByAddress;
+}
+
+/**
+ * TRON Server Scheme Registration
+ *
+ * Helper function to register TRON exact scheme with a t402 resource server.
+ */
+
+/**
+ * Configuration options for registering TRON schemes to a t402ResourceServer
+ */
+interface TronResourceServerConfig {
+    /**
+     * Optional specific networks to register
+     * If not provided, registers wildcard support (tron:*)
+     */
+    networks?: Network[];
+    /**
+     * Optional scheme configuration (preferred token, etc.)
+     */
+    schemeConfig?: ExactTronSchemeConfig;
+}
+/**
+ * Registers TRON exact payment schemes to a t402ResourceServer instance.
+ *
+ * This function registers:
+ * - V2: tron:* wildcard scheme with ExactTronScheme (or specific networks if provided)
+ *
+ * @param server - The t402ResourceServer instance to register schemes to
+ * @param config - Configuration for TRON resource server registration
+ * @returns The server instance for chaining
+ *
+ * @example
+ * ```typescript
+ * import { registerExactTronScheme } from "@t402/tron/exact/server";
+ * import { t402ResourceServer } from "@t402/core/server";
+ *
+ * const server = new t402ResourceServer(facilitatorClient);
+ * registerExactTronScheme(server, {});
+ *
+ * // Or with specific token preference
+ * registerExactTronScheme(server, {
+ *   schemeConfig: { preferredToken: "USDT" }
+ * });
+ * ```
+ */
+declare function registerExactTronScheme(server: t402ResourceServer, config?: TronResourceServerConfig): t402ResourceServer;
+
+export { ExactTronScheme, type ExactTronSchemeConfig, type TronResourceServerConfig, registerExactTronScheme };