@recoillink/tron-sdk 0.0.0-stage → 26.0.1

package/dist/ethers/TronWallet.js

@@ -0,0 +1,295 @@
+import { BigNumber, Wallet, ethers } from 'ethers';
+import { keccak256 as ethersKeccak256 } from 'ethers/lib/utils.js';
+import { TronWeb } from 'tronweb';
+import { assert, ensure0x, isNullish, retryAsync, sleep, strip0x, } from '@recoillink/utils';
+import { MAX_TRON_ORIGIN_ENERGY_LIMIT, TronJsonRpcProvider, } from './TronJsonRpcProvider.js';
+import { assertTronReceiptSuccess, toTronHex } from '../utils/index.js';
+import { stripCustomRpcHeaders, toHttpApiUrl } from './urlUtils.js';
+/** Interval between confirmation polls while waiting for a receipt. */
+const TX_CONFIRMATION_POLL_MS = 1_000;
+/**
+ * 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;
+    originalTronUrl;
+    tronWeb;
+    tronAddress;
+    tronAddressHex;
+    txBuilder;
+    constructor(privateKey, tronUrl) {
+        // `tronUrl` is the chain's HTTP RPC endpoint (root URL or a .../jsonrpc URL).
+        // TronWeb needs the Tron HTTP API base host; use the caller-provided host
+        // directly (matching the AltVM TronProvider) so a private/custom RPC is
+        // honored for building, signing and broadcasting instead of being silently
+        // redirected to the public TronGrid endpoint. Custom headers (e.g. API keys)
+        // are preserved via `custom_rpc_header`.
+        const { headers } = stripCustomRpcHeaders(tronUrl);
+        const tronWebUrl = toHttpApiUrl(tronUrl);
+        super(privateKey, new TronJsonRpcProvider(tronUrl));
+        this.originalTronUrl = tronUrl;
+        this.tronWeb = new TronWeb({ fullHost: tronWebUrl, headers });
+        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);
+        this.txBuilder = new TronTransactionBuilder(tronWebUrl, this.tronAddress, tronUrl, headers);
+    }
+    /**
+     * Override connect to preserve TronWallet type.
+     * Base Wallet.connect() returns a plain Wallet, losing Tron behavior.
+     */
+    connect(_provider) {
+        return new TronWallet(this.privateKey, this.originalTronUrl);
+    }
+    /** 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');
+        let tronTx = await this.txBuilder.buildTransaction(tx);
+        // 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}`);
+        return this.txBuilder.getTransactionResponse(tx, tronTx);
+    }
+    async makeUnique(tronTx) {
+        const counter = ++TronWallet.txCounter;
+        // Use data (memo field) instead of extension to avoid TronWeb's
+        // time-based validation which fails when node clock drifts.
+        const data = '0x' + counter.toString(16).padStart(8, '0');
+        const altered = await this.tronWeb.transactionBuilder.alterTransaction(tronTx, {
+            data,
+            dataFormat: 'hex',
+            txLocal: true,
+        });
+        // 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;
+    }
+}
+export class TronTransactionBuilder extends TronWeb {
+    tronAddress;
+    tronAddressHex;
+    confirmationTimeoutMs;
+    confirmationPollMs;
+    constructor(tronWebUrl, tronAddress, _jsonRpcUrl, headers, confirmationTimeoutMs, confirmationPollMs = TX_CONFIRMATION_POLL_MS) {
+        // Strip custom_rpc_header from the URL and merge with any provided headers
+        const { url: cleanTronWebUrl, headers: parsedHeaders } = stripCustomRpcHeaders(tronWebUrl);
+        const mergedHeaders = { ...parsedHeaders, ...headers };
+        super({ fullHost: cleanTronWebUrl, headers: mergedHeaders });
+        this.tronAddress = tronAddress;
+        this.setAddress(this.tronAddress);
+        this.tronAddressHex = this.address.toHex(this.tronAddress);
+        this.confirmationTimeoutMs = confirmationTimeoutMs;
+        this.confirmationPollMs = confirmationPollMs;
+    }
+    getTransactionResponse(evmTx, tronTx, txHash) {
+        const originalTxHash = ensure0x(tronTx.txID);
+        const gasPrice = evmTx.gasPrice
+            ? BigNumber.from(evmTx.gasPrice)
+            : BigNumber.from(0);
+        const gasLimit = evmTx.gasLimit
+            ? BigNumber.from(evmTx.gasLimit)
+            : BigNumber.from(0);
+        return {
+            hash: txHash ?? originalTxHash,
+            confirmations: 0,
+            from: ethers.utils.getAddress(ensure0x(this.tronAddressHex.slice(2)).toLowerCase()),
+            to: evmTx.to ?? undefined,
+            nonce: 0,
+            gasLimit,
+            gasPrice,
+            data: isNullish(evmTx.data) ? '0x' : ethers.utils.hexlify(evmTx.data),
+            value: BigNumber.from(evmTx.value ?? 0),
+            chainId: evmTx.chainId,
+            tronTransaction: tronTx,
+            wait: async (confirmations) => {
+                const hash = txHash ? ensure0x(txHash) : originalTxHash;
+                const receipt = await this.waitForTransactionReceipt(hash, confirmations, evmTx);
+                // CAST: ethers v5 types `TransactionResponse.wait` as returning a
+                // non-null `TransactionReceipt`, yet its own runtime resolves `null`
+                // from `wait(0)` for a still-pending tx (see MultiProvider.handleTx,
+                // which branches on that null). `waitForTransactionReceipt` mirrors
+                // that contract, so the null escapes here exactly as ethers' own
+                // `wait` does; the declared ethers type cannot be widened.
+                return receipt;
+            },
+        };
+    }
+    async waitForTransactionReceipt(txHash, confirmations = 1, evmTx) {
+        const txid = strip0x(txHash);
+        // ethers v5 `waitForTransaction(hash, 0)` resolves immediately: the receipt
+        // if the tx is already mined, otherwise `null` for a still-pending tx.
+        // MultiProvider.handleTx relies on this non-blocking probe before deciding
+        // whether to wait for inclusion, so `wait(0)` must not enter the poll loop.
+        if (confirmations < 1) {
+            const info = await retryAsync(() => this.trx.getUnconfirmedTransactionInfo(txid), 5, 500);
+            if (info?.id && info.blockNumber) {
+                // A mined tx must surface its on-chain failure even on the wait(0)
+                // probe, matching ethers, whose wait(0) throws CALL_EXCEPTION on a
+                // status-0 receipt (only a still-pending tx resolves null).
+                assertTronReceiptSuccess(info, this, txid);
+                return this.buildReceipt(info, 1, evmTx);
+            }
+            return null;
+        }
+        const deadline = isNullish(this.confirmationTimeoutMs)
+            ? undefined
+            : Date.now() + this.confirmationTimeoutMs;
+        while (isNullish(deadline) || Date.now() < deadline) {
+            const info = await retryAsync(() => this.trx.getUnconfirmedTransactionInfo(txid), 5, 500);
+            if (info?.id && info.blockNumber) {
+                const currentBlock = confirmations > 1
+                    ? await retryAsync(() => this.trx.getCurrentBlock(), 5, 500)
+                    : undefined;
+                const actualConfirmations = (currentBlock?.block_header.raw_data.number ?? info.blockNumber) -
+                    info.blockNumber +
+                    1;
+                if (actualConfirmations >= confirmations) {
+                    // Only finalize success/failure once the requested depth is reached,
+                    // so a reorgable on-chain failure is not rejected prematurely at a
+                    // single confirmation when the caller asked for more.
+                    assertTronReceiptSuccess(info, this, txid);
+                    return this.buildReceipt(info, actualConfirmations, evmTx);
+                }
+            }
+            await sleep(this.confirmationPollMs);
+        }
+        throw new Error(`Tron transaction ${txid} not confirmed within ${this.confirmationTimeoutMs}ms`);
+    }
+    /** Convert a Tron `41`-prefixed (or bare) hex address to a checksummed EVM address. */
+    tronHexToEvmAddress(address) {
+        const stripped = address.startsWith('41') && address.length === 42
+            ? address.slice(2)
+            : address;
+        return ethers.utils.getAddress(ensure0x(stripped));
+    }
+    async buildReceipt(info, confirmations, evmTx) {
+        const block = await retryAsync(() => this.trx.getBlockByNumber(info.blockNumber), 5, 500);
+        return this.toEthersReceipt(info, confirmations, evmTx, ensure0x(block.blockID));
+    }
+    toEthersReceipt(info, confirmations, evmTx, blockHash) {
+        const transactionHash = ensure0x(info.id);
+        const logs = (info.log ?? []).map((log, logIndex) => ({
+            blockNumber: info.blockNumber,
+            blockHash,
+            transactionIndex: 0,
+            removed: false,
+            address: this.tronHexToEvmAddress(log.address),
+            data: ensure0x(log.data ?? ''),
+            topics: (log.topics ?? []).map((topic) => ensure0x(topic)),
+            transactionHash,
+            logIndex,
+        }));
+        const gasUsed = BigNumber.from(info.receipt?.energy_usage_total ?? 0);
+        const receipt = {
+            to: evmTx.to ?? ethers.constants.AddressZero,
+            from: ethers.utils.getAddress(ensure0x(this.tronAddressHex.slice(2)).toLowerCase()),
+            // Tron surfaces the created contract address only for deployments; a
+            // contract call leaves it empty, matching ethers' null contractAddress.
+            contractAddress: info.contract_address
+                ? this.tronHexToEvmAddress(info.contract_address)
+                : ethers.constants.AddressZero,
+            transactionIndex: 0,
+            gasUsed,
+            logsBloom: `0x${'0'.repeat(512)}`,
+            blockHash,
+            transactionHash,
+            logs,
+            blockNumber: info.blockNumber,
+            confirmations,
+            cumulativeGasUsed: gasUsed,
+            effectiveGasPrice: BigNumber.from(0),
+            byzantium: true,
+            type: 0,
+            status: 1,
+        };
+        return receipt;
+    }
+    async buildTransaction(tx) {
+        const gasPrice = tx.gasPrice
+            ? BigNumber.from(tx.gasPrice)
+            : BigNumber.from(0);
+        const gasLimit = tx.gasLimit
+            ? BigNumber.from(tx.gasLimit)
+            : BigNumber.from(0);
+        let feeLimit = gasLimit.mul(gasPrice).toNumber() * 1.5;
+        feeLimit = Math.min(feeLimit, 1000000000);
+        feeLimit = feeLimit <= 0 ? 1000000000 : feeLimit;
+        const callValue = tx.value ? BigNumber.from(tx.value).toNumber() : 0;
+        if (!tx.to) {
+            return this.buildDeployment(tx, feeLimit, callValue, gasLimit);
+        }
+        else if (tx.data && tx.data !== '0x') {
+            return this.buildContractCall(tx, feeLimit, callValue);
+        }
+        else {
+            return this.buildTransfer(tx.to, callValue);
+        }
+    }
+    async buildDeployment(tx, feeLimit, callValue, gasLimit) {
+        assert(tx.data, 'Deployment transaction must have data');
+        return this.transactionBuilder.createSmartContract({
+            abi: [],
+            bytecode: strip0x(ethers.utils.hexlify(tx.data)),
+            feeLimit,
+            callValue,
+            originEnergyLimit: Math.min(gasLimit.toNumber(), MAX_TRON_ORIGIN_ENERGY_LIMIT),
+        }, this.tronAddress);
+    }
+    async buildContractCall(tx, feeLimit, callValue) {
+        assert(tx.to, 'Contract call transaction must have a destination');
+        assert(tx.data, 'Contract call transaction must have data');
+        const tronHexTo = toTronHex(this, tx.to);
+        const result = await this.transactionBuilder.triggerSmartContract(tronHexTo, '', {
+            feeLimit,
+            callValue,
+            input: strip0x(ethers.utils.hexlify(tx.data)),
+        }, [], this.tronAddress);
+        assert(result.result?.result, `triggerSmartContract failed: ${result.result?.message}`);
+        return result.transaction;
+    }
+    async buildTransfer(to, callValue) {
+        const tronHexTo = toTronHex(this, to);
+        return this.transactionBuilder.sendTrx(tronHexTo, callValue, this.tronAddress);
+    }
+}
+//# 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/TronWallet.test.d.ts

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

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

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

package/dist/ethers/TronWallet.test.js

@@ -0,0 +1,216 @@
+import chai, { expect } from 'chai';
+import chaiAsPromised from 'chai-as-promised';
+import { BigNumber, constants, utils } from 'ethers';
+import { assert, strip0x } from '@recoillink/utils';
+import { TronTransactionBuilder } from './TronWallet.js';
+chai.use(chaiAsPromised);
+const TXID = '42'.repeat(32);
+const ADDRESS = 'TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE';
+const BLOCK_HASH = 'ab'.repeat(32);
+// Tron surfaces the deployed contract address as a `41`-prefixed hex string.
+const DEPLOYED_TRON_HEX = '4119335987d77120c462ca7df51cf29f68a38e6d6c';
+const DEPLOYED_EVM = '0x19335987d77120c462ca7dF51cf29f68A38E6D6C';
+function makeBuilder(confirmationTimeoutMs, confirmationPollMs) {
+    return new TronTransactionBuilder('https://node.example.com', ADDRESS, undefined, undefined, confirmationTimeoutMs, confirmationPollMs);
+}
+function injectTrx(builder, trx) {
+    // CAST: overwrite the builder's private `trx` field with a minimal double.
+    builder.trx = trx;
+}
+const blockByNumber = async () => ({ blockID: BLOCK_HASH });
+// getTransactionResponse only reads `txID` off the Tron transaction; a full
+// TronWeb transaction-union member is impractical to construct here.
+function makeTronTx(txID) {
+    // CAST: minimal stand-in for the TronTransaction union.
+    return { txID };
+}
+function buildResponse(builder) {
+    return builder.getTransactionResponse({
+        chainId: 728126428,
+        gasLimit: BigNumber.from(10),
+        gasPrice: BigNumber.from(1),
+        to: '0x496ba8ba0871a037ec1617f002f0a4afe5c2bae1',
+    }, makeTronTx(TXID));
+}
+// A deployment response carries no `to`; the receipt's contractAddress must be
+// derived from the Tron transaction info instead.
+function buildDeploymentResponse(builder) {
+    return builder.getTransactionResponse({
+        chainId: 728126428,
+        gasLimit: BigNumber.from(10),
+        gasPrice: BigNumber.from(1),
+        data: '0x60016002',
+    }, makeTronTx(TXID));
+}
+describe('TronTransactionBuilder', () => {
+    it('confirms transactions through the Tron HTTP API', async () => {
+        const builder = makeBuilder();
+        injectTrx(builder, {
+            getUnconfirmedTransactionInfo: async () => ({
+                id: TXID,
+                blockNumber: 123,
+                receipt: { result: 'SUCCESS', energy_usage_total: 7 },
+                log: [
+                    {
+                        address: '496ba8ba0871a037ec1617f002f0a4afe5c2bae1',
+                        topics: ['8c5be1e5'],
+                        data: '01',
+                    },
+                    {
+                        address: '19335987d77120c462ca7df51cf29f68a38e6d6c',
+                        topics: ['788dbc1b'],
+                    },
+                ],
+            }),
+            getBlockByNumber: blockByNumber,
+        });
+        const receipt = await buildResponse(builder).wait(1);
+        expect(receipt.transactionHash).to.equal(`0x${TXID}`);
+        expect(receipt.blockHash).to.equal(`0x${BLOCK_HASH}`);
+        expect(receipt.status).to.equal(1);
+        const [firstLog, secondLog] = receipt.logs;
+        assert(firstLog && secondLog, 'Expected two receipt logs');
+        expect(firstLog.address).to.equal('0x496bA8BA0871A037eC1617f002F0A4AfE5C2bae1');
+        expect(secondLog.data).to.equal('0x');
+    });
+    it('returns once the requested confirmation depth is reached', async () => {
+        // Short timeout so a broken actualConfirmations computation fails fast
+        // instead of polling until the caller's (here unbounded) production wait.
+        const builder = makeBuilder(200, 5);
+        injectTrx(builder, {
+            getUnconfirmedTransactionInfo: async () => ({
+                id: TXID,
+                blockNumber: 100,
+                receipt: { result: 'SUCCESS', energy_usage_total: 7 },
+                log: [],
+            }),
+            getCurrentBlock: async () => ({
+                block_header: { raw_data: { number: 101 } },
+            }),
+            getBlockByNumber: blockByNumber,
+        });
+        const receipt = await buildResponse(builder).wait(2);
+        // actualConfirmations = currentBlock(101) - txBlock(100) + 1 = 2.
+        // Without the `+ 1` this would be 1 (< 2) and the poll would time out.
+        expect(receipt.confirmations).to.equal(2);
+        expect(receipt.blockNumber).to.equal(100);
+    });
+    it('wait(0) returns null without blocking for a still-pending tx', async () => {
+        // Unbounded builder: proves the wait(0) probe returns immediately rather
+        // than entering (and hanging in) the confirmation poll loop.
+        const builder = makeBuilder();
+        let lookups = 0;
+        injectTrx(builder, {
+            getUnconfirmedTransactionInfo: async () => {
+                lookups += 1;
+                return {};
+            },
+        });
+        const receipt = await buildResponse(builder).wait(0);
+        expect(receipt).to.equal(null);
+        expect(lookups).to.equal(1);
+    });
+    it('wait(0) returns the receipt for an already-mined tx', async () => {
+        const builder = makeBuilder();
+        injectTrx(builder, {
+            getUnconfirmedTransactionInfo: async () => ({
+                id: TXID,
+                blockNumber: 123,
+                receipt: { result: 'SUCCESS', energy_usage_total: 7 },
+                log: [],
+            }),
+            getBlockByNumber: blockByNumber,
+        });
+        const receipt = await buildResponse(builder).wait(0);
+        expect(receipt).to.not.equal(null);
+        expect(receipt?.blockNumber).to.equal(123);
+        expect(receipt?.blockHash).to.equal(`0x${BLOCK_HASH}`);
+        expect(receipt?.confirmations).to.equal(1);
+    });
+    it('wait(0) rejects with the revert reason for a mined-but-reverted tx', async () => {
+        const builder = makeBuilder();
+        const revertReason = 'insufficient allowance';
+        const encodedRevert = '08c379a0' +
+            strip0x(utils.defaultAbiCoder.encode(['string'], [revertReason]));
+        injectTrx(builder, {
+            getUnconfirmedTransactionInfo: async () => ({
+                id: TXID,
+                blockNumber: 123,
+                receipt: { result: 'REVERT' },
+                contractResult: [encodedRevert],
+            }),
+        });
+        // Mined-but-reverted must surface as a failure even on the wait(0) probe,
+        // matching ethers' status-0 CALL_EXCEPTION rather than a status-1 receipt.
+        await expect(buildResponse(builder).wait(0)).to.be.rejectedWith(new RegExp(`Tron Transaction Failed: ${revertReason} \\(txid: ${TXID}\\)`));
+    });
+    it('does not finalize a failed receipt before the requested depth', async () => {
+        const builder = makeBuilder(200, 5);
+        const revertReason = 'insufficient allowance';
+        const encodedRevert = '08c379a0' +
+            strip0x(utils.defaultAbiCoder.encode(['string'], [revertReason]));
+        let blockChecks = 0;
+        injectTrx(builder, {
+            getUnconfirmedTransactionInfo: async () => ({
+                id: TXID,
+                blockNumber: 100,
+                receipt: { result: 'REVERT' },
+                contractResult: [encodedRevert],
+            }),
+            // First poll yields depth 1 (< 2) so the failure must NOT be finalized;
+            // the second poll reaches depth 2 and only then may reject.
+            getCurrentBlock: async () => {
+                blockChecks += 1;
+                const number = blockChecks < 2 ? 100 : 101;
+                return {
+                    block_header: { raw_data: { number } },
+                };
+            },
+        });
+        await expect(buildResponse(builder).wait(2)).to.be.rejectedWith(new RegExp(`Tron Transaction Failed: ${revertReason} \\(txid: ${TXID}\\)`));
+        // Proves the reorgable failure was not finalized at the first confirmation.
+        expect(blockChecks).to.be.greaterThan(1);
+    });
+    it('populates the deployed contract address and block hash for a deployment', async () => {
+        const builder = makeBuilder();
+        injectTrx(builder, {
+            getUnconfirmedTransactionInfo: async () => ({
+                id: TXID,
+                blockNumber: 123,
+                contract_address: DEPLOYED_TRON_HEX,
+                receipt: { result: 'SUCCESS', energy_usage_total: 7 },
+                log: [],
+            }),
+            getBlockByNumber: blockByNumber,
+        });
+        const receipt = await buildDeploymentResponse(builder).wait(1);
+        expect(receipt.contractAddress).to.equal(DEPLOYED_EVM);
+        expect(receipt.contractAddress).to.not.equal(constants.AddressZero);
+        expect(receipt.blockHash).to.equal(`0x${BLOCK_HASH}`);
+    });
+    it('rejects with the revert reason when the receipt reports a failure', async () => {
+        const builder = makeBuilder();
+        const revertReason = 'insufficient allowance';
+        const encodedRevert = '08c379a0' +
+            strip0x(utils.defaultAbiCoder.encode(['string'], [revertReason]));
+        injectTrx(builder, {
+            getUnconfirmedTransactionInfo: async () => ({
+                id: TXID,
+                blockNumber: 123,
+                receipt: { result: 'REVERT' },
+                contractResult: [encodedRevert],
+            }),
+        });
+        await expect(buildResponse(builder).wait(1)).to.be.rejectedWith(new RegExp(`Tron Transaction Failed: ${revertReason} \\(txid: ${TXID}\\)`));
+    });
+    it('rejects with the txid once the confirmation timeout elapses', async () => {
+        const timeoutMs = 40;
+        const builder = makeBuilder(timeoutMs, 5);
+        injectTrx(builder, {
+            // Never surfaces an `id`, so the poll never confirms and must time out.
+            getUnconfirmedTransactionInfo: async () => ({}),
+        });
+        await expect(buildResponse(builder).wait(1)).to.be.rejectedWith(new RegExp(`Tron transaction ${TXID} not confirmed within ${timeoutMs}ms`));
+    });
+});
+//# sourceMappingURL=TronWallet.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TronWallet.test.js","sourceRoot":"","sources":["../../src/ethers/TronWallet.test.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, TronTransactionBuilder, } 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,EACV,sBAAsB,GACvB,MAAM,iBAAiB,CAAC"}

package/dist/ethers/index.js

@@ -0,0 +1,4 @@
+export { TronContractFactory } from './TronContractFactory.js';
+export { TronJsonRpcProvider } from './TronJsonRpcProvider.js';
+export { TronWallet, TronTransactionBuilder, } 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,EACV,sBAAsB,GACvB,MAAM,iBAAiB,CAAC"}

package/dist/ethers/urlUtils.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Parse custom_rpc_header query params from a URL into a headers object.
+ * e.g. "https://api.trongrid.io?custom_rpc_header=TRON-PRO-API-KEY:abc"
+ * returns { "TRON-PRO-API-KEY": "abc" }
+ */
+export declare function parseCustomHeaders(url: string): Record<string, string>;
+/**
+ * Strip custom_rpc_header query params from a URL and return the clean URL
+ * along with the extracted headers.
+ *
+ * e.g. "https://host/jsonrpc?custom_rpc_header=x-api-key:abc&other=1"
+ * returns { url: "https://host/jsonrpc?other=1", headers: { "x-api-key": "abc" } }
+ *
+ * If no custom_rpc_header params are present, returns the original URL unchanged.
+ */
+export declare function stripCustomRpcHeaders(url: string): {
+    url: string;
+    headers: Record<string, string>;
+};
+/**
+ * Derive the Tron HTTP API base host from an RPC URL.
+ *
+ * TronWeb needs the base HTTP API host (serving `/wallet/*`), which differs
+ * from the ethers JSON-RPC endpoint. This strips any `custom_rpc_header` query
+ * params (they are auth headers, not part of the host) and a trailing
+ * `/jsonrpc` path segment.
+ *
+ * e.g. "https://node.example.com/jsonrpc?custom_rpc_header=x-api-key:abc"
+ * returns "https://node.example.com/"
+ */
+export declare function toHttpApiUrl(url: string): string;
+//# sourceMappingURL=urlUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"urlUtils.d.ts","sourceRoot":"","sources":["../../src/ethers/urlUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAetE;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG;IAClD,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC,CAaA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOhD"}