@t402/tron 1.0.0

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

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

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

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

package/dist/esm/index.d.mts

@@ -0,0 +1,237 @@
+import { N as NetworkTRC20Registry, T as TRC20Config } from './signer-BB-HLs-P.mjs';
+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.mjs';
+export { ExactTronScheme as ExactTronClientScheme, ExactTronSchemeConfig as ExactTronClientSchemeConfig, TronClientConfig, registerExactTronScheme as registerExactTronClientScheme } from './exact/client/index.mjs';
+export { ExactTronScheme as ExactTronServerScheme, ExactTronSchemeConfig as ExactTronServerSchemeConfig, TronResourceServerConfig, registerExactTronScheme as registerExactTronServerScheme } from './exact/server/index.mjs';
+export { ExactTronScheme as ExactTronFacilitatorScheme, ExactTronSchemeConfig as ExactTronFacilitatorSchemeConfig, TronFacilitatorConfig, registerExactTronScheme as registerExactTronFacilitatorScheme } from './exact/facilitator/index.mjs';
+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 };

package/dist/esm/index.mjs

@@ -0,0 +1,113 @@
+import {
+  ExactTronScheme,
+  registerExactTronScheme
+} from "./chunk-A2E6FJU3.mjs";
+import {
+  ExactTronScheme as ExactTronScheme2,
+  TRC20_REGISTRY,
+  getDefaultToken,
+  getNetworkTokens,
+  getNetworksForToken,
+  getSupportedNetworks,
+  getTRC20Config,
+  getTokenByAddress,
+  getUsdtNetworks,
+  init_tokens,
+  isNetworkSupported,
+  registerExactTronScheme as registerExactTronScheme2
+} from "./chunk-RHOZZ6XV.mjs";
+import {
+  ExactTronScheme as ExactTronScheme3,
+  registerExactTronScheme as registerExactTronScheme3
+} from "./chunk-CH6GR2VO.mjs";
+import {
+  DEFAULT_FEE_LIMIT,
+  DEFAULT_TRX_DECIMALS,
+  DEFAULT_USDT_DECIMALS,
+  DEFAULT_VALIDITY_DURATION,
+  MAX_FEE_LIMIT,
+  MIN_FEE_LIMIT,
+  MIN_VALIDITY_BUFFER,
+  NETWORK_ENDPOINTS,
+  SCHEME_EXACT,
+  SUN_PER_TRX,
+  TRC20_APPROVE_SELECTOR,
+  TRC20_BALANCE_OF_SELECTOR,
+  TRC20_TRANSFER_SELECTOR,
+  TRON_ADDRESS_HEX_PREFIX,
+  TRON_ADDRESS_LENGTH,
+  TRON_ADDRESS_PREFIX,
+  TRON_MAINNET_CAIP2,
+  TRON_NETWORKS,
+  TRON_NILE_CAIP2,
+  TRON_SHASTA_CAIP2,
+  USDT_ADDRESSES,
+  addressesEqual,
+  calculateExpiration,
+  convertFromSmallestUnits,
+  convertToSmallestUnits,
+  estimateTransactionFee,
+  formatAddress,
+  generatePaymentReference,
+  getEndpoint,
+  init_constants,
+  isTronNetwork,
+  isValidHex,
+  normalizeNetwork,
+  validateTronAddress
+} from "./chunk-L773HPM3.mjs";
+
+// src/index.ts
+init_constants();
+init_tokens();
+export {
+  DEFAULT_FEE_LIMIT,
+  DEFAULT_TRX_DECIMALS,
+  DEFAULT_USDT_DECIMALS,
+  DEFAULT_VALIDITY_DURATION,
+  ExactTronScheme as ExactTronClientScheme,
+  ExactTronScheme3 as ExactTronFacilitatorScheme,
+  ExactTronScheme2 as ExactTronServerScheme,
+  MAX_FEE_LIMIT,
+  MIN_FEE_LIMIT,
+  MIN_VALIDITY_BUFFER,
+  NETWORK_ENDPOINTS,
+  SCHEME_EXACT,
+  SUN_PER_TRX,
+  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,
+  USDT_ADDRESSES,
+  addressesEqual,
+  calculateExpiration,
+  convertFromSmallestUnits,
+  convertToSmallestUnits,
+  estimateTransactionFee,
+  formatAddress,
+  generatePaymentReference,
+  getDefaultToken,
+  getEndpoint,
+  getNetworkTokens,
+  getNetworksForToken,
+  getSupportedNetworks,
+  getTRC20Config,
+  getTokenByAddress,
+  getUsdtNetworks,
+  isNetworkSupported,
+  isTronNetwork,
+  isValidHex,
+  normalizeNetwork,
+  registerExactTronScheme as registerExactTronClientScheme,
+  registerExactTronScheme3 as registerExactTronFacilitatorScheme,
+  registerExactTronScheme2 as registerExactTronServerScheme,
+  validateTronAddress
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/index.ts"],"sourcesContent":["/**\n * @t402/tron - TRON blockchain support for t402 protocol\n *\n * This package provides TRC-20 token payment support for the t402 protocol,\n * enabling micropayments on the TRON network.\n *\n * @packageDocumentation\n */\n\n// Constants\nexport {\n  TRON_MAINNET_CAIP2,\n  TRON_NILE_CAIP2,\n  TRON_SHASTA_CAIP2,\n  TRON_NETWORKS,\n  SCHEME_EXACT,\n  TRC20_TRANSFER_SELECTOR,\n  TRC20_APPROVE_SELECTOR,\n  TRC20_BALANCE_OF_SELECTOR,\n  USDT_ADDRESSES,\n  NETWORK_ENDPOINTS,\n  DEFAULT_USDT_DECIMALS,\n  DEFAULT_TRX_DECIMALS,\n  MIN_VALIDITY_BUFFER,\n  DEFAULT_VALIDITY_DURATION,\n  DEFAULT_FEE_LIMIT,\n  MIN_FEE_LIMIT,\n  MAX_FEE_LIMIT,\n  SUN_PER_TRX,\n  TRON_ADDRESS_PREFIX,\n  TRON_ADDRESS_LENGTH,\n  TRON_ADDRESS_HEX_PREFIX,\n} from \"./constants.js\";\n\n// Types from constants\nexport type { TronNetwork } from \"./constants.js\";\n\n// Types\nexport type {\n  TronAuthorization,\n  ExactTronPayload,\n  ExactTronPayloadV2,\n  VerifyMessageResult,\n  TransactionConfirmation,\n  TRC20Config,\n  NetworkTRC20Registry,\n} from \"./types.js\";\n\n// Signer interfaces\nexport type {\n  ClientTronSigner,\n  FacilitatorTronSigner,\n} from \"./signer.js\";\n\n// Token registry\nexport {\n  TRC20_REGISTRY,\n  getDefaultToken,\n  getTRC20Config,\n  getTokenByAddress,\n  getNetworkTokens,\n  getNetworksForToken,\n  getUsdtNetworks,\n  isNetworkSupported,\n  getSupportedNetworks,\n} from \"./tokens.js\";\n\n// Utilities\nexport {\n  normalizeNetwork,\n  getEndpoint,\n  isTronNetwork,\n  validateTronAddress,\n  addressesEqual,\n  formatAddress,\n  convertToSmallestUnits,\n  convertFromSmallestUnits,\n  generatePaymentReference,\n  calculateExpiration,\n  isValidHex,\n  estimateTransactionFee,\n} from \"./utils.js\";\n\n// Exact scheme exports (for convenience)\nexport * from \"./exact/index.js\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUA;AA6CA;","names":[]}

package/dist/esm/signer-BB-HLs-P.d.mts

@@ -0,0 +1,261 @@
+/**
+ * TRON Payment Types
+ *
+ * Type definitions for TRON TRC20 payment payloads.
+ */
+/**
+ * Authorization metadata for a TRON TRC20 transfer
+ *
+ * Contains all information needed to verify and track a payment
+ * without parsing the signed transaction.
+ */
+type TronAuthorization = {
+    /** Sender wallet address (T-prefix base58check) */
+    from: string;
+    /** Recipient wallet address (T-prefix base58check) */
+    to: string;
+    /** TRC20 contract address (e.g., USDT contract) */
+    contractAddress: string;
+    /** Transfer amount in smallest units (as string for large numbers) */
+    amount: string;
+    /** Transaction expiration timestamp (milliseconds since epoch) */
+    expiration: number;
+    /** Reference block bytes (hex string) */
+    refBlockBytes: string;
+    /** Reference block hash (hex string) */
+    refBlockHash: string;
+    /** Transaction timestamp (milliseconds since epoch) */
+    timestamp: number;
+};
+/**
+ * V2 TRON payment payload
+ *
+ * Contains the signed transaction ready for broadcast
+ * along with authorization metadata for verification.
+ */
+type ExactTronPayloadV2 = {
+    /** Hex-encoded signed transaction */
+    signedTransaction: string;
+    /** Transaction authorization metadata */
+    authorization: TronAuthorization;
+};
+/**
+ * Current version alias
+ */
+type ExactTronPayload = ExactTronPayloadV2;
+/**
+ * Result of verifying a signed TRON transaction
+ */
+type VerifyMessageResult = {
+    /** Whether the message is valid */
+    valid: boolean;
+    /** Reason for invalidity (if not valid) */
+    reason?: string;
+    /** Parsed transfer details (if valid) */
+    transfer?: {
+        /** Sender address */
+        from: string;
+        /** Recipient address */
+        to: string;
+        /** Contract address */
+        contractAddress: string;
+        /** Transfer amount */
+        amount: string;
+        /** Transaction ID */
+        txId: string;
+    };
+};
+/**
+ * Transaction confirmation result
+ */
+type TransactionConfirmation = {
+    /** Whether the transaction was confirmed */
+    success: boolean;
+    /** Transaction ID/hash */
+    txId?: string;
+    /** Block number containing the transaction */
+    blockNumber?: number;
+    /** Error message if failed */
+    error?: string;
+};
+/**
+ * TRC20 token configuration
+ */
+type TRC20Config = {
+    /** Contract address (T-prefix) */
+    contractAddress: string;
+    /** Token symbol (e.g., "USDT") */
+    symbol: string;
+    /** Token name (e.g., "Tether USD") */
+    name: string;
+    /** Token decimals */
+    decimals: number;
+};
+/**
+ * Network-specific token registry
+ */
+type NetworkTRC20Registry = {
+    /** Network CAIP-2 identifier */
+    network: string;
+    /** Default token for this network */
+    defaultToken: TRC20Config;
+    /** All supported tokens on this network */
+    tokens: Record<string, TRC20Config>;
+};
+
+/**
+ * TRON Signer Interfaces
+ *
+ * Defines the signer interfaces for t402 client and facilitator operations.
+ * These interfaces abstract away the specific wallet implementation,
+ * allowing integration with various TRON wallets and signing mechanisms.
+ */
+
+/**
+ * Parameters for signing a TRC20 transfer transaction
+ */
+type SignTransactionParams = {
+    /** TRC20 contract address */
+    contractAddress: string;
+    /** Recipient address (T-prefix base58check) */
+    to: string;
+    /** Amount to transfer (in smallest units) */
+    amount: string;
+    /** Fee limit in SUN (optional, defaults to 100 TRX) */
+    feeLimit?: number;
+    /** Transaction expiration time in milliseconds (optional) */
+    expiration?: number;
+};
+/**
+ * Parameters for verifying a signed transaction
+ */
+type VerifyTransactionParams = {
+    /** Hex-encoded signed transaction */
+    signedTransaction: string;
+    /** Expected sender address */
+    expectedFrom: string;
+    /** Expected transfer details */
+    expectedTransfer: {
+        /** Expected recipient address */
+        to: string;
+        /** Expected contract address */
+        contractAddress: string;
+        /** Expected amount */
+        amount: string;
+    };
+    /** Network identifier */
+    network: string;
+};
+/**
+ * Parameters for waiting on transaction confirmation
+ */
+type WaitForTransactionParams = {
+    /** Transaction ID to monitor */
+    txId: string;
+    /** Network identifier */
+    network: string;
+    /** Timeout in milliseconds (optional) */
+    timeout?: number;
+};
+/**
+ * Parameters for getting TRC20 balance
+ */
+type GetBalanceParams = {
+    /** Owner address */
+    ownerAddress: string;
+    /** TRC20 contract address */
+    contractAddress: string;
+    /** Network identifier */
+    network: string;
+};
+/**
+ * ClientTronSigner - Used by t402 clients to sign TRC20 transfer transactions
+ *
+ * This interface represents a TRON wallet that can:
+ * - Sign TRC20 transfer transactions
+ * - Query its own address
+ *
+ * Implementations may include:
+ * - TronWeb with private key
+ * - TronLink wallet adapter
+ * - Hardware wallet integration
+ */
+type ClientTronSigner = {
+    /** The wallet address (T-prefix base58check) */
+    readonly address: string;
+    /**
+     * Sign a TRC20 transfer transaction
+     * Returns the hex-encoded signed transaction ready for broadcast
+     *
+     * @param params - Transaction parameters
+     * @returns Hex-encoded signed transaction
+     */
+    signTransaction(params: SignTransactionParams): Promise<string>;
+    /**
+     * Get the current reference block info for transaction building
+     * Returns block bytes and hash for replay protection
+     *
+     * @returns Reference block info
+     */
+    getBlockInfo(): Promise<{
+        refBlockBytes: string;
+        refBlockHash: string;
+        expiration: number;
+    }>;
+};
+/**
+ * FacilitatorTronSigner - Used by t402 facilitators to verify and settle payments
+ *
+ * This interface combines RPC capabilities with verification abilities:
+ * - Query TRC20 balances
+ * - Verify signed transactions
+ * - Broadcast transactions
+ * - Wait for confirmations
+ */
+type FacilitatorTronSigner = {
+    /**
+     * Get all addresses this facilitator can use
+     * Enables dynamic address selection for load balancing
+     */
+    getAddresses(): readonly string[];
+    /**
+     * Query TRC20 balance for an owner
+     *
+     * @param params - Balance query parameters
+     * @returns Balance in smallest units
+     */
+    getBalance(params: GetBalanceParams): Promise<string>;
+    /**
+     * Verify a signed transaction matches expected parameters
+     * Validates the transaction structure and transfer details
+     *
+     * @param params - Verification parameters
+     * @returns Verification result
+     */
+    verifyTransaction(params: VerifyTransactionParams): Promise<VerifyMessageResult>;
+    /**
+     * Broadcast a signed transaction to the network
+     *
+     * @param signedTransaction - Hex-encoded signed transaction
+     * @param network - Network identifier
+     * @returns Transaction ID
+     */
+    broadcastTransaction(signedTransaction: string, network: string): Promise<string>;
+    /**
+     * Wait for transaction confirmation
+     *
+     * @param params - Transaction monitoring parameters
+     * @returns Confirmation result
+     */
+    waitForTransaction(params: WaitForTransactionParams): Promise<TransactionConfirmation>;
+    /**
+     * Check if an account is activated (has any transaction history)
+     *
+     * @param address - Address to check
+     * @param network - Network identifier
+     * @returns true if activated
+     */
+    isActivated(address: string, network: string): Promise<boolean>;
+};
+
+export type { ClientTronSigner as C, ExactTronPayload as E, FacilitatorTronSigner as F, NetworkTRC20Registry as N, TRC20Config as T, VerifyMessageResult as V, TronAuthorization as a, ExactTronPayloadV2 as b, TransactionConfirmation as c };