@hyperlane-xyz/tron-sdk 21.0.2 → 21.1.0

package/dist/ethers/TronContractFactory.d.ts

@@ -0,0 +1,32 @@
+import { ContractFactory } from 'ethers';
+import { TronWallet } from './TronWallet.js';
+/**
+ * TronContractFactory wraps a ContractFactory to handle Tron's deployment flow
+ * where contract addresses come from TronWeb rather than being predictable via nonce.
+ *
+ * This class overrides deploy() to extract the correct contract address from the
+ * Tron transaction response, since ethers computes the wrong address using
+ * Ethereum's CREATE formula.
+ *
+ * Usage:
+ * ```ts
+ * const factory = new TronContractFactory(new Mailbox__factory(), tronWallet);
+ * const contract = await factory.deploy(localDomain);
+ * ```
+ */
+export declare class TronContractFactory<F extends ContractFactory> extends ContractFactory {
+    private readonly factory;
+    constructor(factory: F, signer?: TronWallet);
+    /**
+     * Deploy a contract and return the connected contract instance.
+     *
+     * Uses the typed CreateSmartContractTransaction from TronWeb to get
+     * the contract address directly from the transaction response.
+     */
+    deploy(...args: Parameters<F['deploy']>): Promise<Awaited<ReturnType<F['deploy']>>>;
+    /**
+     * Returns a new TronContractFactory connected to the given signer.
+     */
+    connect(signer: TronWallet): TronContractFactory<F>;
+}
+//# sourceMappingURL=TronContractFactory.d.ts.map

package/dist/ethers/TronContractFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TronContractFactory.d.ts","sourceRoot":"","sources":["../../src/ethers/TronContractFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAKzC,OAAO,EAA2B,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAWtE;;;;;;;;;;;;;GAaG;AACH,qBAAa,mBAAmB,CAC9B,CAAC,SAAS,eAAe,CACzB,SAAQ,eAAe;IAErB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,CAAC,EAC3B,MAAM,CAAC,EAAE,UAAU;IAKrB;;;;;OAKG;IACY,MAAM,CACnB,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAC/B,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAsB5C;;OAEG;IACM,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,mBAAmB,CAAC,CAAC,CAAC;CAG7D"}

package/dist/ethers/TronContractFactory.js

@@ -0,0 +1,54 @@
+import { ContractFactory } from 'ethers';
+import { assert } from '@hyperlane-xyz/utils';
+/**
+ * Type guard for CreateSmartContractTransaction
+ */
+function isDeployTransaction(tx) {
+    return 'contract_address' in tx;
+}
+/**
+ * TronContractFactory wraps a ContractFactory to handle Tron's deployment flow
+ * where contract addresses come from TronWeb rather than being predictable via nonce.
+ *
+ * This class overrides deploy() to extract the correct contract address from the
+ * Tron transaction response, since ethers computes the wrong address using
+ * Ethereum's CREATE formula.
+ *
+ * Usage:
+ * ```ts
+ * const factory = new TronContractFactory(new Mailbox__factory(), tronWallet);
+ * const contract = await factory.deploy(localDomain);
+ * ```
+ */
+export class TronContractFactory extends ContractFactory {
+    factory;
+    constructor(factory, signer) {
+        super(factory.interface, factory.bytecode, signer);
+        this.factory = factory;
+    }
+    /**
+     * Deploy a contract and return the connected contract instance.
+     *
+     * Uses the typed CreateSmartContractTransaction from TronWeb to get
+     * the contract address directly from the transaction response.
+     */
+    async deploy(...args) {
+        const contract = await super.deploy(...args);
+        const { tronTransaction } = contract.deployTransaction;
+        assert(isDeployTransaction(tronTransaction), 'Expected CreateSmartContractTransaction for deployment');
+        const tronWallet = this.signer;
+        const evmAddress = tronWallet.toEvmAddress(tronTransaction.contract_address);
+        // Re-attach to correct address, preserving deployTransaction
+        const deployTransaction = contract.deployTransaction;
+        const correctedContract = this.attach(evmAddress);
+        correctedContract.deployTransaction = deployTransaction;
+        return correctedContract;
+    }
+    /**
+     * Returns a new TronContractFactory connected to the given signer.
+     */
+    connect(signer) {
+        return new TronContractFactory(this.factory, signer);
+    }
+}
+//# sourceMappingURL=TronContractFactory.js.map

package/dist/ethers/TronContractFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TronContractFactory.js","sourceRoot":"","sources":["../../src/ethers/TronContractFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAGzC,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAI9C;;GAEG;AACH,SAAS,mBAAmB,CAC1B,EAA8C;IAE9C,OAAO,kBAAkB,IAAI,EAAE,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,mBAEX,SAAQ,eAAe;IAEJ;IADnB,YACmB,OAAU,EAC3B,MAAmB;QAEnB,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAHlC,YAAO,GAAP,OAAO,CAAG;IAI7B,CAAC;IAED;;;;;OAKG;IACM,KAAK,CAAC,MAAM,CACnB,GAAG,IAA6B;QAEhC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;QAC7C,MAAM,EAAE,eAAe,EAAE,GACvB,QAAQ,CAAC,iBAA4C,CAAC;QAExD,MAAM,CACJ,mBAAmB,CAAC,eAAe,CAAC,EACpC,wDAAwD,CACzD,CAAC;QAEF,MAAM,UAAU,GAAG,IAAI,CAAC,MAAoB,CAAC;QAC7C,MAAM,UAAU,GAAG,UAAU,CAAC,YAAY,CACxC,eAAe,CAAC,gBAAgB,CACjC,CAAC;QAEF,6DAA6D;QAC7D,MAAM,iBAAiB,GAAG,QAAQ,CAAC,iBAAiB,CAAC;QACrD,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACjD,iBAAyB,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;QACjE,OAAO,iBAAqD,CAAC;IAC/D,CAAC;IAED;;OAEG;IACM,OAAO,CAAC,MAAkB;QACjC,OAAO,IAAI,mBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACvD,CAAC;CACF"}

package/dist/ethers/TronJsonRpcProvider.d.ts

@@ -0,0 +1,23 @@
+import { providers } from 'ethers';
+/**
+ * TronJsonRpcProvider extends ethers JsonRpcProvider for Tron's JSON-RPC API.
+ *
+ * Tron's JSON-RPC endpoint supports most standard Ethereum JSON-RPC methods,
+ * but with a few notable exceptions:
+ * - eth_sendRawTransaction: Not supported (must use TronWeb for transactions)
+ * - eth_getTransactionCount: Not supported (Tron doesn't use nonces)
+ *
+ * This provider handles these gaps by returning appropriate defaults.
+ */
+export declare class TronJsonRpcProvider extends providers.JsonRpcProvider {
+    constructor(url: string, network?: providers.Networkish);
+    /**
+     * Tron doesn't use nonces - always return 0.
+     */
+    getTransactionCount(_addressOrName: string, _blockTag?: providers.BlockTag): Promise<number>;
+    /**
+     * Return legacy gas pricing only - Tron doesn't support EIP-1559.
+     */
+    getFeeData(): Promise<providers.FeeData>;
+}
+//# sourceMappingURL=TronJsonRpcProvider.d.ts.map

package/dist/ethers/TronJsonRpcProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TronJsonRpcProvider.d.ts","sourceRoot":"","sources":["../../src/ethers/TronJsonRpcProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAEnC;;;;;;;;;GASG;AACH,qBAAa,mBAAoB,SAAQ,SAAS,CAAC,eAAe;gBACpD,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,UAAU;IAMvD;;OAEG;IACG,mBAAmB,CACvB,cAAc,EAAE,MAAM,EACtB,SAAS,CAAC,EAAE,SAAS,CAAC,QAAQ,GAC7B,OAAO,CAAC,MAAM,CAAC;IAIlB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC;CAS/C"}

package/dist/ethers/TronJsonRpcProvider.js

@@ -0,0 +1,37 @@
+import { providers } from 'ethers';
+/**
+ * TronJsonRpcProvider extends ethers JsonRpcProvider for Tron's JSON-RPC API.
+ *
+ * Tron's JSON-RPC endpoint supports most standard Ethereum JSON-RPC methods,
+ * but with a few notable exceptions:
+ * - eth_sendRawTransaction: Not supported (must use TronWeb for transactions)
+ * - eth_getTransactionCount: Not supported (Tron doesn't use nonces)
+ *
+ * This provider handles these gaps by returning appropriate defaults.
+ */
+export class TronJsonRpcProvider extends providers.JsonRpcProvider {
+    constructor(url, network) {
+        // Ensure we're pointing to the /jsonrpc endpoint
+        const jsonRpcUrl = url.endsWith('/jsonrpc') ? url : `${url}/jsonrpc`;
+        super(jsonRpcUrl, network);
+    }
+    /**
+     * Tron doesn't use nonces - always return 0.
+     */
+    async getTransactionCount(_addressOrName, _blockTag) {
+        return 0;
+    }
+    /**
+     * Return legacy gas pricing only - Tron doesn't support EIP-1559.
+     */
+    async getFeeData() {
+        const gasPrice = await this.getGasPrice();
+        return {
+            gasPrice,
+            maxFeePerGas: null,
+            maxPriorityFeePerGas: null,
+            lastBaseFeePerGas: null,
+        };
+    }
+}
+//# sourceMappingURL=TronJsonRpcProvider.js.map

package/dist/ethers/TronJsonRpcProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TronJsonRpcProvider.js","sourceRoot":"","sources":["../../src/ethers/TronJsonRpcProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAEnC;;;;;;;;;GASG;AACH,MAAM,OAAO,mBAAoB,SAAQ,SAAS,CAAC,eAAe;IAChE,YAAY,GAAW,EAAE,OAA8B;QACrD,iDAAiD;QACjD,MAAM,UAAU,GAAG,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,UAAU,CAAC;QACrE,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,mBAAmB,CACvB,cAAsB,EACtB,SAA8B;QAE9B,OAAO,CAAC,CAAC;IACX,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1C,OAAO;YACL,QAAQ;YACR,YAAY,EAAE,IAAI;YAClB,oBAAoB,EAAE,IAAI;YAC1B,iBAAiB,EAAE,IAAI;SACxB,CAAC;IACJ,CAAC;CACF"}

package/dist/ethers/TronWallet.d.ts

@@ -0,0 +1,52 @@
+import { Wallet, providers } from 'ethers';
+import { Types } from 'tronweb';
+/** Union of possible TronWeb transaction types */
+export type TronTransaction = Types.CreateSmartContractTransaction | Types.Transaction | Types.SignedTransaction;
+/**
+ * Extended transaction response that includes Tron-specific fields.
+ */
+export interface TronTransactionResponse extends providers.TransactionResponse {
+    /** Raw TronWeb transaction object */
+    tronTransaction: TronTransaction;
+}
+/**
+ * TronWallet extends ethers Wallet to handle Tron's transaction format.
+ *
+ * Takes a single Tron node URL (e.g. http://localhost:9090) and derives:
+ * - JSON-RPC provider at {url}/jsonrpc for ethers compatibility
+ * - TronWeb HTTP client at {url} for transaction building/signing
+ *
+ * Tron's JSON-RPC doesn't support eth_sendRawTransaction, so we override
+ * sendTransaction to use TronWeb for building, signing, and broadcasting.
+ *
+ * Gas estimation is handled by ethers (via eth_estimateGas), and we convert
+ * gasLimit to Tron's feeLimit using: feeLimit = gasLimit × gasPrice.
+ */
+export declare class TronWallet extends Wallet {
+    /**
+     * Static counter to ensure unique txIDs across all wallet instances.
+     * Must be static because connect() creates new instances, and Tron txIDs
+     * are derived from transaction content + expiration. Without a shared counter,
+     * two instances could generate identical txIDs in the same block.
+     */
+    private static txCounter;
+    private readonly tronUrl;
+    private tronWeb;
+    private tronAddress;
+    private tronAddressHex;
+    constructor(privateKey: string, tronUrl: string);
+    /**
+     * Override connect to preserve TronWallet type.
+     * Base Wallet.connect() returns a plain Wallet, losing Tron behavior.
+     */
+    connect(_provider: providers.Provider): TronWallet;
+    /** Convert ethers 0x address to Tron 41-prefixed hex */
+    private toTronHex;
+    /** Convert Tron address (base58 or 41-hex) to ethers 0x address */
+    toEvmAddress(tronAddress: string): string;
+    /** Tron doesn't use nonces */
+    getTransactionCount(_blockTag?: providers.BlockTag): Promise<number>;
+    sendTransaction(transaction: providers.TransactionRequest): Promise<TronTransactionResponse>;
+    private makeUnique;
+}
+//# sourceMappingURL=TronWallet.d.ts.map

package/dist/ethers/TronWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TronWallet.d.ts","sourceRoot":"","sources":["../../src/ethers/TronWallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,MAAM,EAAU,SAAS,EAAE,MAAM,QAAQ,CAAC;AAE9D,OAAO,EAAW,KAAK,EAAE,MAAM,SAAS,CAAC;AAMzC,kDAAkD;AAClD,MAAM,MAAM,eAAe,GACvB,KAAK,CAAC,8BAA8B,GACpC,KAAK,CAAC,WAAW,GACjB,KAAK,CAAC,iBAAiB,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,SAAS,CAAC,mBAAmB;IAC5E,qCAAqC;IACrC,eAAe,EAAE,eAAe,CAAC;CAClC;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,UAAW,SAAQ,MAAM;IACpC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS,CAAK;IAE7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,cAAc,CAAS;gBAEnB,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAe/C;;;OAGG;IACH,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,QAAQ,GAAG,UAAU;IAIlD,wDAAwD;IACxD,OAAO,CAAC,SAAS;IAIjB,mEAAmE;IACnE,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAMzC,8BAA8B;IACxB,mBAAmB,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAIpE,eAAe,CACnB,WAAW,EAAE,SAAS,CAAC,kBAAkB,GACxC,OAAO,CAAC,uBAAuB,CAAC;YA2FrB,UAAU;CAoBzB"}

package/dist/ethers/TronWallet.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=TronWallet.integration.test.d.ts.map

package/dist/ethers/TronWallet.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TronWallet.integration.test.d.ts","sourceRoot":"","sources":["../../src/ethers/TronWallet.integration.test.ts"],"names":[],"mappings":""}

package/dist/ethers/TronWallet.integration.test.js

@@ -0,0 +1,117 @@
+import { expect } from 'chai';
+import { BigNumber } from 'ethers';
+import { runTronNode, stopTronNode, } from '../testing/node.js';
+import { TestStorage__factory } from '../typechain/factories/contracts/test/TestStorage__factory.js';
+import { TronContractFactory } from './TronContractFactory.js';
+import { TronWallet } from './TronWallet.js';
+const TEST_CHAIN = {
+    name: 'tron-test',
+    chainId: 3360022319,
+    domainId: 3360022319,
+    port: 19090,
+};
+describe('TronWallet Integration Tests', function () {
+    this.timeout(120_000); // 2 minutes for container startup
+    let node;
+    let wallet;
+    before(async () => {
+        node = await runTronNode(TEST_CHAIN);
+        const tronUrl = `http://127.0.0.1:${TEST_CHAIN.port}`;
+        wallet = new TronWallet(node.privateKeys[0], tronUrl);
+    });
+    after(async () => {
+        if (node) {
+            await stopTronNode(node);
+        }
+    });
+    describe('TRX Transfer', () => {
+        it('should transfer TRX to another address', async () => {
+            // Generate a random recipient address
+            const recipientPrivateKey = '0x1111111111111111111111111111111111111111111111111111111111111111';
+            const recipientWallet = new TronWallet(recipientPrivateKey, `http://127.0.0.1:${TEST_CHAIN.port}`);
+            const recipientAddress = recipientWallet.address;
+            // Get initial balances
+            const senderBalanceBefore = await wallet.provider.getBalance(wallet.address);
+            const recipientBalanceBefore = await wallet.provider.getBalance(recipientAddress);
+            // Transfer 1 TRX (1,000,000 SUN)
+            const transferAmount = BigNumber.from(1_000_000);
+            const tx = await wallet.sendTransaction({
+                to: recipientAddress,
+                value: transferAmount,
+            });
+            // Wait for confirmation
+            const receipt = await tx.wait();
+            expect(receipt.status).to.equal(1);
+            // Verify balances changed
+            const senderBalanceAfter = await wallet.provider.getBalance(wallet.address);
+            const recipientBalanceAfter = await wallet.provider.getBalance(recipientAddress);
+            expect(recipientBalanceAfter.sub(recipientBalanceBefore)).to.deep.equal(transferAmount);
+            expect(senderBalanceBefore.gt(senderBalanceAfter)).to.be.true;
+        });
+    });
+    describe('TronContractFactory', () => {
+        let contract;
+        const INITIAL_VALUE = 100;
+        it('should get deploy transaction and estimate gas', async () => {
+            const factory = new TronContractFactory(new TestStorage__factory(), wallet);
+            // Get deploy transaction (pure ethers, no network call)
+            const deployTx = factory.getDeployTransaction(INITIAL_VALUE, wallet.address);
+            expect(deployTx.data).to.be.a('string');
+            expect(deployTx.data).to.match(/^0x/);
+            // Estimate gas via Tron JSON-RPC
+            const estimatedGas = await wallet.estimateGas(deployTx);
+            expect(estimatedGas.gt(0)).to.be.true;
+        });
+        it('should deploy with gas limit override (like handleDeploy)', async () => {
+            const factory = new TronContractFactory(new TestStorage__factory(), wallet);
+            // Simulate handleDeploy flow: estimate then deploy with buffered gas limit
+            const deployTx = factory.getDeployTransaction(INITIAL_VALUE, wallet.address);
+            const estimatedGas = await wallet.estimateGas(deployTx);
+            const bufferedGasLimit = estimatedGas.mul(120).div(100); // 20% buffer
+            const deployed = await factory.deploy(INITIAL_VALUE, wallet.address, {
+                gasLimit: bufferedGasLimit,
+            });
+            expect(deployed.address).to.be.a('string');
+            expect(deployed.address).to.match(/^0x[a-fA-F0-9]{40}$/);
+            // Verify we can interact with the deployed contract
+            const value = await deployed.get();
+            expect(value.toNumber()).to.equal(INITIAL_VALUE);
+        });
+        it('should deploy a contract with constructor args', async () => {
+            const factory = new TronContractFactory(new TestStorage__factory(), wallet);
+            contract = await factory.deploy(INITIAL_VALUE, wallet.address);
+            expect(contract.address).to.be.a('string');
+            expect(contract.address).to.match(/^0x[a-fA-F0-9]{40}$/);
+        });
+        it('should have correct initial value from constructor', async () => {
+            const value = await contract.get();
+            expect(value.toNumber()).to.equal(INITIAL_VALUE);
+        });
+        it('should have correct owner from constructor', async () => {
+            const owner = await contract.owner();
+            expect(owner.toLowerCase()).to.equal(wallet.address.toLowerCase());
+        });
+        it('should set a value', async () => {
+            const newValue = 42;
+            const tx = await contract.set(newValue);
+            const receipt = await tx.wait();
+            expect(receipt.status).to.equal(1);
+        });
+        it('should get the updated value', async () => {
+            const value = await contract.get();
+            expect(value.toNumber()).to.equal(42);
+        });
+        it('should read value property directly', async () => {
+            const value = await contract.value();
+            expect(value.toNumber()).to.equal(42);
+        });
+        it('should update value and read again', async () => {
+            const newValue = 123;
+            const tx = await contract.set(newValue);
+            await tx.wait();
+            const value = await contract.get();
+            expect(value.toNumber()).to.equal(newValue);
+        });
+    });
+});
+//# sourceMappingURL=TronWallet.integration.test.js.map

package/dist/ethers/TronWallet.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TronWallet.integration.test.js","sourceRoot":"","sources":["../../src/ethers/TronWallet.integration.test.ts"],"names":[],"mappings":"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"}

package/dist/ethers/TronWallet.js

@@ -0,0 +1,143 @@
+import { BigNumber, Wallet, ethers } from 'ethers';
+import { keccak256 as ethersKeccak256 } from 'ethers/lib/utils.js';
+import { TronWeb } from 'tronweb';
+import { assert, ensure0x, strip0x } from '@hyperlane-xyz/utils';
+import { TronJsonRpcProvider } from './TronJsonRpcProvider.js';
+/**
+ * TronWallet extends ethers Wallet to handle Tron's transaction format.
+ *
+ * Takes a single Tron node URL (e.g. http://localhost:9090) and derives:
+ * - JSON-RPC provider at {url}/jsonrpc for ethers compatibility
+ * - TronWeb HTTP client at {url} for transaction building/signing
+ *
+ * Tron's JSON-RPC doesn't support eth_sendRawTransaction, so we override
+ * sendTransaction to use TronWeb for building, signing, and broadcasting.
+ *
+ * Gas estimation is handled by ethers (via eth_estimateGas), and we convert
+ * gasLimit to Tron's feeLimit using: feeLimit = gasLimit × gasPrice.
+ */
+export class TronWallet extends Wallet {
+    /**
+     * Static counter to ensure unique txIDs across all wallet instances.
+     * Must be static because connect() creates new instances, and Tron txIDs
+     * are derived from transaction content + expiration. Without a shared counter,
+     * two instances could generate identical txIDs in the same block.
+     */
+    static txCounter = 0;
+    tronUrl;
+    tronWeb;
+    tronAddress;
+    tronAddressHex;
+    constructor(privateKey, tronUrl) {
+        super(privateKey, new TronJsonRpcProvider(tronUrl));
+        this.tronUrl = tronUrl;
+        this.tronWeb = new TronWeb({ fullHost: tronUrl });
+        const cleanKey = strip0x(privateKey);
+        this.tronWeb.setPrivateKey(cleanKey);
+        const derivedAddress = this.tronWeb.address.fromPrivateKey(cleanKey);
+        assert(derivedAddress, 'Failed to derive Tron address from private key');
+        this.tronAddress = derivedAddress;
+        this.tronAddressHex = this.tronWeb.address.toHex(this.tronAddress);
+        this.tronWeb.setAddress(this.tronAddress);
+    }
+    /**
+     * Override connect to preserve TronWallet type.
+     * Base Wallet.connect() returns a plain Wallet, losing Tron behavior.
+     */
+    connect(_provider) {
+        return new TronWallet(this.privateKey, this.tronUrl);
+    }
+    /** Convert ethers 0x address to Tron 41-prefixed hex */
+    toTronHex(address) {
+        return '41' + strip0x(address).toLowerCase();
+    }
+    /** Convert Tron address (base58 or 41-hex) to ethers 0x address */
+    toEvmAddress(tronAddress) {
+        const hex = this.tronWeb.address.toHex(tronAddress);
+        const rawAddress = ensure0x(hex.slice(2)).toLowerCase();
+        return ethers.utils.getAddress(rawAddress);
+    }
+    /** Tron doesn't use nonces */
+    async getTransactionCount(_blockTag) {
+        return 0;
+    }
+    async sendTransaction(transaction) {
+        // Populate transaction (estimates gas and gas price if not set)
+        const tx = await this.populateTransaction(transaction);
+        assert(tx.gasLimit, 'gasLimit is required');
+        assert(tx.gasPrice, 'gasPrice is required');
+        // Convert gasLimit to feeLimit in SUN (1 TRX = 1,000,000 SUN)
+        const gasPrice = BigNumber.from(tx.gasPrice);
+        const gasLimit = BigNumber.from(tx.gasLimit);
+        let feeLimit = gasLimit.mul(gasPrice).toNumber() * 1.5; // Add 50% buffer to feeLimit to avoid "Out of energy" errors
+        feeLimit = Math.min(feeLimit, 1000000000); // Tron max fee is 1000000000 SUN (1000 TRX)
+        feeLimit = feeLimit <= 0 ? 1000000000 : feeLimit; // Ensure we have at least some fee limit
+        const callValue = tx.value ? BigNumber.from(tx.value).toNumber() : 0;
+        let tronTx;
+        if (!tx.to) {
+            // Contract deployment
+            assert(tx.data, 'Deployment transaction must have data');
+            tronTx = await this.tronWeb.transactionBuilder.createSmartContract({
+                abi: [],
+                bytecode: strip0x(tx.data.toString()),
+                feeLimit,
+                callValue,
+                originEnergyLimit: gasLimit.toNumber(),
+            }, this.tronAddress);
+        }
+        else if (tx.data && tx.data !== '0x') {
+            // Contract call - use 'input' option for raw ABI-encoded calldata
+            const tronHexTo = this.toTronHex(tx.to);
+            const result = await this.tronWeb.transactionBuilder.triggerSmartContract(tronHexTo, '', // Empty functionSelector since we pass raw encoded data via input
+            {
+                feeLimit,
+                callValue,
+                input: strip0x(tx.data.toString()),
+            }, [], this.tronAddress);
+            assert(result.result?.result, `triggerSmartContract failed: ${result.result?.message}`);
+            tronTx = result.transaction;
+        }
+        else {
+            // Simple TRX transfer
+            tronTx = await this.tronWeb.transactionBuilder.sendTrx(this.toTronHex(tx.to), callValue, this.tronAddress);
+        }
+        // Ensure unique txID by extending expiration with a counter.
+        // Tron has no nonces, so identical txs in the same block produce the same txID.
+        tronTx = await this.makeUnique(tronTx);
+        // Sign and broadcast
+        const signedTx = await this.tronWeb.trx.sign(tronTx);
+        const broadcastResult = await this.tronWeb.trx.sendRawTransaction(signedTx);
+        assert(broadcastResult.result, `Broadcast failed: ${broadcastResult.message}`);
+        const txHash = ensure0x(tronTx.txID);
+        // Build the transaction response with Tron-specific fields
+        const response = {
+            hash: txHash,
+            confirmations: 0,
+            from: this.address,
+            to: tx.to ?? undefined,
+            nonce: 0,
+            gasLimit,
+            gasPrice,
+            data: tx.data?.toString() ?? '0x',
+            value: BigNumber.from(tx.value ?? 0),
+            chainId: tx.chainId,
+            tronTransaction: tronTx,
+            wait: (confirmations) => this.provider.waitForTransaction(txHash, confirmations),
+        };
+        return response;
+    }
+    async makeUnique(tronTx) {
+        const extension = ++TronWallet.txCounter;
+        const altered = await this.tronWeb.transactionBuilder.alterTransaction(tronTx, {
+            extension,
+        });
+        // For deployments, recompute contract_address from the new txID.
+        // genContractAddress = '41' + keccak256(txID + ownerHex)[24:]
+        if ('contract_address' in tronTx) {
+            const hash = ethersKeccak256(Buffer.from(altered.txID + this.tronAddressHex, 'hex'));
+            altered.contract_address = '41' + hash.substring(2).slice(24);
+        }
+        return altered;
+    }
+}
+//# sourceMappingURL=TronWallet.js.map

package/dist/ethers/TronWallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TronWallet.js","sourceRoot":"","sources":["../../src/ethers/TronWallet.ts"],"names":[],"mappings":"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"}

package/dist/ethers/index.d.ts

@@ -0,0 +1,4 @@
+export { TronContractFactory } from './TronContractFactory.js';
+export { TronJsonRpcProvider } from './TronJsonRpcProvider.js';
+export { TronTransaction, TronTransactionResponse, TronWallet, } from './TronWallet.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ethers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ethers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,UAAU,GACX,MAAM,iBAAiB,CAAC"}

package/dist/ethers/index.js

@@ -0,0 +1,4 @@
+export { TronContractFactory } from './TronContractFactory.js';
+export { TronJsonRpcProvider } from './TronJsonRpcProvider.js';
+export { TronWallet, } from './TronWallet.js';
+//# sourceMappingURL=index.js.map

package/dist/ethers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ethers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAGL,UAAU,GACX,MAAM,iBAAiB,CAAC"}

package/dist/factories/index.d.ts

@@ -0,0 +1,2 @@
+export * from '../typechain/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/factories/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/factories/index.ts"],"names":[],"mappings":"AAMA,cAAc,uBAAuB,CAAC"}

package/dist/factories/index.js

@@ -0,0 +1,8 @@
+// Re-export all typechain types and factories (flattened).
+// These factories are generated from the same Solidity source as @hyperlane-xyz/core
+// via the tron-solc compiler. They have identical ABIs and deploy signatures, differing
+// only in bytecode (TVM-compiled with 0x41 Create2 prefix). This 1:1 correspondence
+// with core factory class names is relied upon by the SDK's MultiProvider.handleDeploy
+// to dynamically resolve the correct factory at deploy time.
+export * from '../typechain/index.js';
+//# sourceMappingURL=index.js.map

package/dist/factories/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/factories/index.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,qFAAqF;AACrF,wFAAwF;AACxF,oFAAoF;AACpF,uFAAuF;AACvF,6DAA6D;AAC7D,cAAc,uBAAuB,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,7 @@
+export * from './ethers/index.js';
+export * from './factories/index.js';
 export { TronProvider } from './clients/provider.js';
 export { TronSigner } from './clients/signer.js';
 export { TronProtocolProvider } from './clients/protocol.js';
-export { TronReceipt, TronTransaction } from './utils/types.js';
+export { TronReceipt } from './utils/types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAGlC,cAAc,sBAAsB,CAAC;AAGrC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -1,3 +1,8 @@
+// Ethers-compatible adapters (primary interface)
+export * from './ethers/index.js';
+// Contract factories (typechain re-exports)
+export * from './factories/index.js';
+// AltVM clients (provider-sdk pattern)
 export { TronProvider } from './clients/provider.js';
 export { TronSigner } from './clients/signer.js';
 export { TronProtocolProvider } from './clients/protocol.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,cAAc,mBAAmB,CAAC;AAElC,4CAA4C;AAC5C,cAAc,sBAAsB,CAAC;AAErC,uCAAuC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/testing/constants.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Test private key for tronbox/tre local network (account 0).
+ * Derived from the fixed mnemonic in node.ts ("abandon abandon ... about")
+ * via HD path m/44'/195'/0'/0/0. Pre-funded with 10,000 TRX.
+ */
+export declare const TEST_TRON_PRIVATE_KEY = "b5a4cea271ff424d7c31dc12a3e43e401df7a40d7412a15750f3f0b6b5449a28";
+//# sourceMappingURL=constants.d.ts.map

package/dist/testing/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/testing/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,qEACkC,CAAC"}

package/dist/testing/constants.js

@@ -0,0 +1,7 @@
+/**
+ * Test private key for tronbox/tre local network (account 0).
+ * Derived from the fixed mnemonic in node.ts ("abandon abandon ... about")
+ * via HD path m/44'/195'/0'/0/0. Pre-funded with 10,000 TRX.
+ */
+export const TEST_TRON_PRIVATE_KEY = 'b5a4cea271ff424d7c31dc12a3e43e401df7a40d7412a15750f3f0b6b5449a28';
+//# sourceMappingURL=constants.js.map

package/dist/testing/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/testing/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAChC,kEAAkE,CAAC"}

package/dist/testing/index.d.ts

@@ -0,0 +1,3 @@
+export { enableInstamine, runTronNode, stopTronNode, type TronNodeInfo, type TronTestChainMetadata, } from './node.js';
+export { TEST_TRON_PRIVATE_KEY } from './constants.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,eAAe,EACf,WAAW,EACX,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,qBAAqB,GAC3B,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/testing/index.js

@@ -0,0 +1,4 @@
+// Testing utilities for Tron SDK
+export { enableInstamine, runTronNode, stopTronNode, } from './node.js';
+export { TEST_TRON_PRIVATE_KEY } from './constants.js';
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,OAAO,EACL,eAAe,EACf,WAAW,EACX,YAAY,GAGb,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC"}