@t402/tron 1.0.0

package/dist/cjs/exact/server/index.js

@@ -0,0 +1,350 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/constants.ts
+var TRON_MAINNET_CAIP2, TRON_NILE_CAIP2, TRON_SHASTA_CAIP2, TRON_NETWORKS, TRON_MAINNET_ENDPOINT, TRON_NILE_ENDPOINT, TRON_SHASTA_ENDPOINT, NETWORK_ENDPOINTS, SCHEME_EXACT, USDT_ADDRESSES, DEFAULT_USDT_DECIMALS;
+var init_constants = __esm({
+  "src/constants.ts"() {
+    "use strict";
+    TRON_MAINNET_CAIP2 = "tron:mainnet";
+    TRON_NILE_CAIP2 = "tron:nile";
+    TRON_SHASTA_CAIP2 = "tron:shasta";
+    TRON_NETWORKS = [TRON_MAINNET_CAIP2, TRON_NILE_CAIP2, TRON_SHASTA_CAIP2];
+    TRON_MAINNET_ENDPOINT = "https://api.trongrid.io";
+    TRON_NILE_ENDPOINT = "https://api.nileex.io";
+    TRON_SHASTA_ENDPOINT = "https://api.shasta.trongrid.io";
+    NETWORK_ENDPOINTS = {
+      [TRON_MAINNET_CAIP2]: TRON_MAINNET_ENDPOINT,
+      [TRON_NILE_CAIP2]: TRON_NILE_ENDPOINT,
+      [TRON_SHASTA_CAIP2]: TRON_SHASTA_ENDPOINT
+    };
+    SCHEME_EXACT = "exact";
+    USDT_ADDRESSES = {
+      [TRON_MAINNET_CAIP2]: "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
+      [TRON_NILE_CAIP2]: "TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf",
+      [TRON_SHASTA_CAIP2]: "TG3XXyExBkPp9nzdajDZsozEu4BkaSJozs"
+    };
+    DEFAULT_USDT_DECIMALS = 6;
+  }
+});
+
+// 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/index.ts
+var server_exports = {};
+__export(server_exports, {
+  ExactTronScheme: () => ExactTronScheme,
+  registerExactTronScheme: () => registerExactTronScheme
+});
+module.exports = __toCommonJS(server_exports);
+
+// src/exact/server/scheme.ts
+init_constants();
+
+// src/utils.ts
+init_constants();
+function normalizeNetwork(network) {
+  if (TRON_NETWORKS.includes(network)) {
+    return network;
+  }
+  const lower = network.toLowerCase();
+  if (lower === "mainnet" || lower === "tron") {
+    return "tron:mainnet";
+  }
+  if (lower === "nile" || lower === "tron-nile") {
+    return "tron:nile";
+  }
+  if (lower === "shasta" || lower === "tron-shasta") {
+    return "tron:shasta";
+  }
+  throw new Error(`Unsupported TRON network: ${network}`);
+}
+function convertToSmallestUnits(decimalAmount, decimals = DEFAULT_USDT_DECIMALS) {
+  const parts = decimalAmount.split(".");
+  const wholePart = parts[0] || "0";
+  let fractionalPart = parts[1] || "";
+  if (fractionalPart.length > decimals) {
+    fractionalPart = fractionalPart.slice(0, decimals);
+  } else {
+    fractionalPart = fractionalPart.padEnd(decimals, "0");
+  }
+  const result = (wholePart + fractionalPart).replace(/^0+/, "") || "0";
+  return result;
+}
+
+// src/exact/server/scheme.ts
+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;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ExactTronScheme,
+  registerExactTronScheme
+});
+//# sourceMappingURL=index.js.map

package/dist/cjs/exact/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/constants.ts","../../../../src/tokens.ts","../../../../src/exact/server/index.ts","../../../../src/exact/server/scheme.ts","../../../../src/utils.ts","../../../../src/exact/server/register.ts"],"sourcesContent":["/**\n * TRON Network Constants\n *\n * Network identifiers, endpoints, and configuration for TRON blockchain.\n */\n\n// =============================================================================\n// Network Identifiers (CAIP-2 Format)\n// =============================================================================\n\n/** TRON Mainnet CAIP-2 identifier */\nexport const TRON_MAINNET_CAIP2 = \"tron:mainnet\";\n\n/** TRON Nile Testnet CAIP-2 identifier */\nexport const TRON_NILE_CAIP2 = \"tron:nile\";\n\n/** TRON Shasta Testnet CAIP-2 identifier */\nexport const TRON_SHASTA_CAIP2 = \"tron:shasta\";\n\n/** All supported TRON networks */\nexport const TRON_NETWORKS = [TRON_MAINNET_CAIP2, TRON_NILE_CAIP2, TRON_SHASTA_CAIP2] as const;\n\n/** TRON network type */\nexport type TronNetwork = (typeof TRON_NETWORKS)[number];\n\n// =============================================================================\n// RPC Endpoints\n// =============================================================================\n\n/** TRON Mainnet API endpoint (TronGrid) */\nexport const TRON_MAINNET_ENDPOINT = \"https://api.trongrid.io\";\n\n/** TRON Nile Testnet API endpoint */\nexport const TRON_NILE_ENDPOINT = \"https://api.nileex.io\";\n\n/** TRON Shasta Testnet API endpoint */\nexport const TRON_SHASTA_ENDPOINT = \"https://api.shasta.trongrid.io\";\n\n/** Network to endpoint mapping */\nexport const NETWORK_ENDPOINTS: Record<string, string> = {\n  [TRON_MAINNET_CAIP2]: TRON_MAINNET_ENDPOINT,\n  [TRON_NILE_CAIP2]: TRON_NILE_ENDPOINT,\n  [TRON_SHASTA_CAIP2]: TRON_SHASTA_ENDPOINT,\n};\n\n// =============================================================================\n// TRC20 Contract Operations\n// =============================================================================\n\n/** TRC20 transfer function selector (transfer(address,uint256)) */\nexport const TRC20_TRANSFER_SELECTOR = \"a9059cbb\";\n\n/** TRC20 approve function selector (approve(address,uint256)) */\nexport const TRC20_APPROVE_SELECTOR = \"095ea7b3\";\n\n/** TRC20 balanceOf function selector (balanceOf(address)) */\nexport const TRC20_BALANCE_OF_SELECTOR = \"70a08231\";\n\n// =============================================================================\n// Gas and Fee Constants\n// =============================================================================\n\n/** Default fee limit for TRC20 transfers (in SUN, 1 TRX = 1,000,000 SUN) */\nexport const DEFAULT_FEE_LIMIT = 100_000_000; // 100 TRX\n\n/** Minimum fee limit for TRC20 transfers */\nexport const MIN_FEE_LIMIT = 10_000_000; // 10 TRX\n\n/** Maximum fee limit for TRC20 transfers */\nexport const MAX_FEE_LIMIT = 1_000_000_000; // 1000 TRX\n\n/** SUN per TRX (1 TRX = 1,000,000 SUN) */\nexport const SUN_PER_TRX = 1_000_000;\n\n// =============================================================================\n// Scheme Constants\n// =============================================================================\n\n/** Payment scheme identifier */\nexport const SCHEME_EXACT = \"exact\";\n\n/** Default transaction validity duration in seconds (1 hour) */\nexport const DEFAULT_VALIDITY_DURATION = 3600;\n\n/** Minimum validity buffer for verification (30 seconds) */\nexport const MIN_VALIDITY_BUFFER = 30;\n\n// =============================================================================\n// Address Constants\n// =============================================================================\n\n/** TRON address prefix (base58check) */\nexport const TRON_ADDRESS_PREFIX = \"T\";\n\n/** TRON address length (base58check format) */\nexport const TRON_ADDRESS_LENGTH = 34;\n\n/** TRON address hex prefix (0x41 in decimal = 65) */\nexport const TRON_ADDRESS_HEX_PREFIX = 0x41;\n\n// =============================================================================\n// USDT Contract Addresses\n// =============================================================================\n\n/** USDT TRC20 contract addresses by network */\nexport const USDT_ADDRESSES: Record<string, string> = {\n  [TRON_MAINNET_CAIP2]: \"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t\",\n  [TRON_NILE_CAIP2]: \"TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf\",\n  [TRON_SHASTA_CAIP2]: \"TG3XXyExBkPp9nzdajDZsozEu4BkaSJozs\",\n};\n\n// =============================================================================\n// Token Decimals\n// =============================================================================\n\n/** Default decimals for USDT */\nexport const DEFAULT_USDT_DECIMALS = 6;\n\n/** Default decimals for TRX */\nexport const DEFAULT_TRX_DECIMALS = 6;\n","/**\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","export { ExactTronScheme } from \"./scheme.js\";\nexport type { ExactTronSchemeConfig } from \"./scheme.js\";\nexport { registerExactTronScheme } from \"./register.js\";\nexport type { TronResourceServerConfig } from \"./register.js\";\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 Utility Functions\n *\n * Address validation, amount conversion, and network utilities.\n */\n\nimport {\n  TRON_NETWORKS,\n  TRON_ADDRESS_LENGTH,\n  TRON_ADDRESS_PREFIX,\n  NETWORK_ENDPOINTS,\n  DEFAULT_USDT_DECIMALS,\n} from \"./constants.js\";\nimport type { TronNetwork } from \"./constants.js\";\n\n// =============================================================================\n// Network Utilities\n// =============================================================================\n\n/**\n * Normalize network identifier to CAIP-2 format\n *\n * @param network - Network identifier (e.g., \"tron:mainnet\", \"mainnet\")\n * @returns Normalized CAIP-2 identifier\n * @throws Error if network is not supported\n */\nexport function normalizeNetwork(network: string): TronNetwork {\n  // Already in correct format\n  if (TRON_NETWORKS.includes(network as TronNetwork)) {\n    return network as TronNetwork;\n  }\n\n  // Handle shorthand formats\n  const lower = network.toLowerCase();\n  if (lower === \"mainnet\" || lower === \"tron\") {\n    return \"tron:mainnet\";\n  }\n  if (lower === \"nile\" || lower === \"tron-nile\") {\n    return \"tron:nile\";\n  }\n  if (lower === \"shasta\" || lower === \"tron-shasta\") {\n    return \"tron:shasta\";\n  }\n\n  throw new Error(`Unsupported TRON network: ${network}`);\n}\n\n/**\n * Get RPC endpoint for a network\n *\n * @param network - CAIP-2 network identifier\n * @returns RPC endpoint URL\n * @throws Error if network is not supported\n */\nexport function getEndpoint(network: string): string {\n  const normalized = normalizeNetwork(network);\n  const endpoint = NETWORK_ENDPOINTS[normalized];\n  if (!endpoint) {\n    throw new Error(`No endpoint configured for network: ${network}`);\n  }\n  return endpoint;\n}\n\n/**\n * Check if a network identifier is a TRON network\n *\n * @param network - Network identifier\n * @returns true if TRON network\n */\nexport function isTronNetwork(network: string): boolean {\n  try {\n    normalizeNetwork(network);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n// =============================================================================\n// Address Utilities\n// =============================================================================\n\n/**\n * Base58 alphabet for TRON addresses\n */\nconst BASE58_ALPHABET = \"123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz\";\n\n/**\n * Validate a TRON address\n *\n * TRON addresses are:\n * - Base58check encoded\n * - 34 characters long\n * - Start with 'T' (mainnet) or 'A'/'4' (testnet - rare)\n *\n * @param address - Address to validate\n * @returns true if valid TRON address\n */\nexport function validateTronAddress(address: string): boolean {\n  // Check length\n  if (!address || address.length !== TRON_ADDRESS_LENGTH) {\n    return false;\n  }\n\n  // Check prefix (mainnet addresses start with T)\n  if (!address.startsWith(TRON_ADDRESS_PREFIX)) {\n    return false;\n  }\n\n  // Check base58 characters\n  for (const char of address) {\n    if (!BASE58_ALPHABET.includes(char)) {\n      return false;\n    }\n  }\n\n  return true;\n}\n\n/**\n * Compare two TRON addresses for equality\n *\n * Handles case-insensitivity and different formats.\n *\n * @param addr1 - First address\n * @param addr2 - Second address\n * @returns true if addresses are equal\n */\nexport function addressesEqual(addr1: string, addr2: string): boolean {\n  if (!addr1 || !addr2) return false;\n\n  // TRON addresses are case-sensitive in base58, but we normalize for comparison\n  // This handles potential mixed-case issues from different sources\n  return addr1 === addr2;\n}\n\n/**\n * Format a TRON address for display\n *\n * @param address - Address to format\n * @param options - Formatting options\n * @returns Formatted address\n */\nexport function formatAddress(\n  address: string,\n  options?: {\n    /** Truncate to first/last N characters */\n    truncate?: number;\n  },\n): string {\n  if (!address) return \"\";\n\n  if (options?.truncate && address.length > options.truncate * 2 + 3) {\n    return `${address.slice(0, options.truncate)}...${address.slice(-options.truncate)}`;\n  }\n\n  return address;\n}\n\n// =============================================================================\n// Amount Utilities\n// =============================================================================\n\n/**\n * Convert decimal amount to smallest units\n *\n * @param decimalAmount - Amount as decimal string (e.g., \"1.50\")\n * @param decimals - Token decimals (default: 6 for USDT)\n * @returns Amount in smallest units as string\n */\nexport function convertToSmallestUnits(decimalAmount: string, decimals: number = DEFAULT_USDT_DECIMALS): string {\n  const parts = decimalAmount.split(\".\");\n  const wholePart = parts[0] || \"0\";\n  let fractionalPart = parts[1] || \"\";\n\n  // Pad or truncate fractional part to match decimals\n  if (fractionalPart.length > decimals) {\n    fractionalPart = fractionalPart.slice(0, decimals);\n  } else {\n    fractionalPart = fractionalPart.padEnd(decimals, \"0\");\n  }\n\n  // Combine and remove leading zeros\n  const result = (wholePart + fractionalPart).replace(/^0+/, \"\") || \"0\";\n  return result;\n}\n\n/**\n * Convert smallest units to decimal amount\n *\n * @param smallestUnits - Amount in smallest units as string\n * @param decimals - Token decimals (default: 6 for USDT)\n * @returns Amount as decimal string\n */\nexport function convertFromSmallestUnits(smallestUnits: string, decimals: number = DEFAULT_USDT_DECIMALS): string {\n  const padded = smallestUnits.padStart(decimals + 1, \"0\");\n  const wholePart = padded.slice(0, -decimals) || \"0\";\n  const fractionalPart = padded.slice(-decimals);\n\n  // Remove trailing zeros from fractional part\n  const trimmedFractional = fractionalPart.replace(/0+$/, \"\");\n\n  if (trimmedFractional) {\n    return `${wholePart}.${trimmedFractional}`;\n  }\n  return wholePart;\n}\n\n// =============================================================================\n// Transaction Utilities\n// =============================================================================\n\n/**\n * Generate a unique memo/reference for payment tracking\n *\n * @returns Unique reference string\n */\nexport function generatePaymentReference(): string {\n  const timestamp = Date.now();\n  const random = Math.floor(Math.random() * 1000000);\n  return `t402_${timestamp}_${random}`;\n}\n\n/**\n * Calculate transaction expiration time\n *\n * @param validitySeconds - Validity duration in seconds\n * @returns Expiration timestamp in milliseconds\n */\nexport function calculateExpiration(validitySeconds: number): number {\n  return Date.now() + validitySeconds * 1000;\n}\n\n/**\n * Validate a hex string\n *\n * @param hex - String to validate\n * @returns true if valid hex string\n */\nexport function isValidHex(hex: string): boolean {\n  if (!hex) return false;\n  // Remove 0x prefix if present\n  const cleanHex = hex.startsWith(\"0x\") ? hex.slice(2) : hex;\n  return /^[0-9a-fA-F]+$/.test(cleanHex);\n}\n\n/**\n * Estimate transaction fee\n *\n * Note: Actual fees depend on energy/bandwidth consumption.\n * This provides a conservative estimate.\n *\n * @param isActivated - Whether recipient account is activated\n * @returns Estimated fee in SUN\n */\nexport function estimateTransactionFee(isActivated: boolean = true): number {\n  // TRC20 transfer typically costs ~15-30 TRX in energy\n  // New account activation adds ~1 TRX\n  const baseFee = 30_000_000; // 30 TRX\n  const activationFee = isActivated ? 0 : 1_000_000; // 1 TRX\n  return baseFee + activationFee;\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/cjs/index.d.ts

@@ -0,0 +1,237 @@
+import { N as NetworkTRC20Registry, T as TRC20Config } from './signer-BB-HLs-P.js';
+export { C as ClientTronSigner, E as ExactTronPayload, b as ExactTronPayloadV2, F as FacilitatorTronSigner, c as TransactionConfirmation, a as TronAuthorization, V as VerifyMessageResult } from './signer-BB-HLs-P.js';
+export { ExactTronScheme as ExactTronClientScheme, ExactTronSchemeConfig as ExactTronClientSchemeConfig, TronClientConfig, registerExactTronScheme as registerExactTronClientScheme } from './exact/client/index.js';
+export { ExactTronScheme as ExactTronServerScheme, ExactTronSchemeConfig as ExactTronServerSchemeConfig, TronResourceServerConfig, registerExactTronScheme as registerExactTronServerScheme } from './exact/server/index.js';
+export { ExactTronScheme as ExactTronFacilitatorScheme, ExactTronSchemeConfig as ExactTronFacilitatorSchemeConfig, TronFacilitatorConfig, registerExactTronScheme as registerExactTronFacilitatorScheme } from './exact/facilitator/index.js';
+import '@t402/core/types';
+import '@t402/core/client';
+import '@t402/core/server';
+import '@t402/core/facilitator';
+
+/**
+ * TRON Network Constants
+ *
+ * Network identifiers, endpoints, and configuration for TRON blockchain.
+ */
+/** TRON Mainnet CAIP-2 identifier */
+declare const TRON_MAINNET_CAIP2 = "tron:mainnet";
+/** TRON Nile Testnet CAIP-2 identifier */
+declare const TRON_NILE_CAIP2 = "tron:nile";
+/** TRON Shasta Testnet CAIP-2 identifier */
+declare const TRON_SHASTA_CAIP2 = "tron:shasta";
+/** All supported TRON networks */
+declare const TRON_NETWORKS: readonly ["tron:mainnet", "tron:nile", "tron:shasta"];
+/** TRON network type */
+type TronNetwork = (typeof TRON_NETWORKS)[number];
+/** Network to endpoint mapping */
+declare const NETWORK_ENDPOINTS: Record<string, string>;
+/** TRC20 transfer function selector (transfer(address,uint256)) */
+declare const TRC20_TRANSFER_SELECTOR = "a9059cbb";
+/** TRC20 approve function selector (approve(address,uint256)) */
+declare const TRC20_APPROVE_SELECTOR = "095ea7b3";
+/** TRC20 balanceOf function selector (balanceOf(address)) */
+declare const TRC20_BALANCE_OF_SELECTOR = "70a08231";
+/** Default fee limit for TRC20 transfers (in SUN, 1 TRX = 1,000,000 SUN) */
+declare const DEFAULT_FEE_LIMIT = 100000000;
+/** Minimum fee limit for TRC20 transfers */
+declare const MIN_FEE_LIMIT = 10000000;
+/** Maximum fee limit for TRC20 transfers */
+declare const MAX_FEE_LIMIT = 1000000000;
+/** SUN per TRX (1 TRX = 1,000,000 SUN) */
+declare const SUN_PER_TRX = 1000000;
+/** Payment scheme identifier */
+declare const SCHEME_EXACT = "exact";
+/** Default transaction validity duration in seconds (1 hour) */
+declare const DEFAULT_VALIDITY_DURATION = 3600;
+/** Minimum validity buffer for verification (30 seconds) */
+declare const MIN_VALIDITY_BUFFER = 30;
+/** TRON address prefix (base58check) */
+declare const TRON_ADDRESS_PREFIX = "T";
+/** TRON address length (base58check format) */
+declare const TRON_ADDRESS_LENGTH = 34;
+/** TRON address hex prefix (0x41 in decimal = 65) */
+declare const TRON_ADDRESS_HEX_PREFIX = 65;
+/** USDT TRC20 contract addresses by network */
+declare const USDT_ADDRESSES: Record<string, string>;
+/** Default decimals for USDT */
+declare const DEFAULT_USDT_DECIMALS = 6;
+/** Default decimals for TRX */
+declare const DEFAULT_TRX_DECIMALS = 6;
+
+/**
+ * TRC20 Token Configuration
+ *
+ * Registry of supported TRC20 tokens for each TRON network.
+ */
+
+/**
+ * Registry of TRC20 tokens by network
+ */
+declare const TRC20_REGISTRY: Record<string, NetworkTRC20Registry>;
+/**
+ * Get TRC20 configuration for a specific token on a network
+ *
+ * @param network - CAIP-2 network identifier
+ * @param symbol - Token symbol (e.g., "USDT")
+ * @returns Token configuration or undefined if not found
+ */
+declare function getTRC20Config(network: string, symbol: string): TRC20Config | undefined;
+/**
+ * Get all TRC20 tokens for a network
+ *
+ * @param network - CAIP-2 network identifier
+ * @returns Array of token configurations
+ */
+declare function getNetworkTokens(network: string): TRC20Config[];
+/**
+ * Get the default TRC20 token for a network
+ *
+ * @param network - CAIP-2 network identifier
+ * @returns Default token configuration or undefined
+ */
+declare function getDefaultToken(network: string): TRC20Config | undefined;
+/**
+ * Get token by contract address
+ *
+ * @param network - CAIP-2 network identifier
+ * @param contractAddress - TRC20 contract address
+ * @returns Token configuration or undefined
+ */
+declare function getTokenByAddress(network: string, contractAddress: string): TRC20Config | undefined;
+/**
+ * Get all networks that support a specific token
+ *
+ * @param symbol - Token symbol (e.g., "USDT")
+ * @returns Array of network identifiers
+ */
+declare function getNetworksForToken(symbol: string): string[];
+/**
+ * Get all networks that support USDT
+ *
+ * @returns Array of network identifiers
+ */
+declare function getUsdtNetworks(): string[];
+/**
+ * Check if a network is supported
+ *
+ * @param network - CAIP-2 network identifier
+ * @returns true if network is supported
+ */
+declare function isNetworkSupported(network: string): boolean;
+/**
+ * Get all supported networks
+ *
+ * @returns Array of network identifiers
+ */
+declare function getSupportedNetworks(): string[];
+
+/**
+ * TRON Utility Functions
+ *
+ * Address validation, amount conversion, and network utilities.
+ */
+
+/**
+ * Normalize network identifier to CAIP-2 format
+ *
+ * @param network - Network identifier (e.g., "tron:mainnet", "mainnet")
+ * @returns Normalized CAIP-2 identifier
+ * @throws Error if network is not supported
+ */
+declare function normalizeNetwork(network: string): TronNetwork;
+/**
+ * Get RPC endpoint for a network
+ *
+ * @param network - CAIP-2 network identifier
+ * @returns RPC endpoint URL
+ * @throws Error if network is not supported
+ */
+declare function getEndpoint(network: string): string;
+/**
+ * Check if a network identifier is a TRON network
+ *
+ * @param network - Network identifier
+ * @returns true if TRON network
+ */
+declare function isTronNetwork(network: string): boolean;
+/**
+ * Validate a TRON address
+ *
+ * TRON addresses are:
+ * - Base58check encoded
+ * - 34 characters long
+ * - Start with 'T' (mainnet) or 'A'/'4' (testnet - rare)
+ *
+ * @param address - Address to validate
+ * @returns true if valid TRON address
+ */
+declare function validateTronAddress(address: string): boolean;
+/**
+ * Compare two TRON addresses for equality
+ *
+ * Handles case-insensitivity and different formats.
+ *
+ * @param addr1 - First address
+ * @param addr2 - Second address
+ * @returns true if addresses are equal
+ */
+declare function addressesEqual(addr1: string, addr2: string): boolean;
+/**
+ * Format a TRON address for display
+ *
+ * @param address - Address to format
+ * @param options - Formatting options
+ * @returns Formatted address
+ */
+declare function formatAddress(address: string, options?: {
+    /** Truncate to first/last N characters */
+    truncate?: number;
+}): string;
+/**
+ * Convert decimal amount to smallest units
+ *
+ * @param decimalAmount - Amount as decimal string (e.g., "1.50")
+ * @param decimals - Token decimals (default: 6 for USDT)
+ * @returns Amount in smallest units as string
+ */
+declare function convertToSmallestUnits(decimalAmount: string, decimals?: number): string;
+/**
+ * Convert smallest units to decimal amount
+ *
+ * @param smallestUnits - Amount in smallest units as string
+ * @param decimals - Token decimals (default: 6 for USDT)
+ * @returns Amount as decimal string
+ */
+declare function convertFromSmallestUnits(smallestUnits: string, decimals?: number): string;
+/**
+ * Generate a unique memo/reference for payment tracking
+ *
+ * @returns Unique reference string
+ */
+declare function generatePaymentReference(): string;
+/**
+ * Calculate transaction expiration time
+ *
+ * @param validitySeconds - Validity duration in seconds
+ * @returns Expiration timestamp in milliseconds
+ */
+declare function calculateExpiration(validitySeconds: number): number;
+/**
+ * Validate a hex string
+ *
+ * @param hex - String to validate
+ * @returns true if valid hex string
+ */
+declare function isValidHex(hex: string): boolean;
+/**
+ * Estimate transaction fee
+ *
+ * Note: Actual fees depend on energy/bandwidth consumption.
+ * This provides a conservative estimate.
+ *
+ * @param isActivated - Whether recipient account is activated
+ * @returns Estimated fee in SUN
+ */
+declare function estimateTransactionFee(isActivated?: boolean): number;
+
+export { DEFAULT_FEE_LIMIT, DEFAULT_TRX_DECIMALS, DEFAULT_USDT_DECIMALS, DEFAULT_VALIDITY_DURATION, MAX_FEE_LIMIT, MIN_FEE_LIMIT, MIN_VALIDITY_BUFFER, NETWORK_ENDPOINTS, NetworkTRC20Registry, SCHEME_EXACT, SUN_PER_TRX, TRC20Config, TRC20_APPROVE_SELECTOR, TRC20_BALANCE_OF_SELECTOR, TRC20_REGISTRY, TRC20_TRANSFER_SELECTOR, TRON_ADDRESS_HEX_PREFIX, TRON_ADDRESS_LENGTH, TRON_ADDRESS_PREFIX, TRON_MAINNET_CAIP2, TRON_NETWORKS, TRON_NILE_CAIP2, TRON_SHASTA_CAIP2, type TronNetwork, USDT_ADDRESSES, addressesEqual, calculateExpiration, convertFromSmallestUnits, convertToSmallestUnits, estimateTransactionFee, formatAddress, generatePaymentReference, getDefaultToken, getEndpoint, getNetworkTokens, getNetworksForToken, getSupportedNetworks, getTRC20Config, getTokenByAddress, getUsdtNetworks, isNetworkSupported, isTronNetwork, isValidHex, normalizeNetwork, validateTronAddress };