@zebec-network/tron-transfer-sdk 1.0.0 → 2.0.0

package/dist/services.js

@@ -1,31 +1,30 @@
 import { TronWeb } from 'tronweb';
 import { createTronWeb } from './client.js';
-import { loadConfig } from './config.js';
-import { sleep, toBaseUnits } from './utils.js';
+import { resolveServiceConfig } from './config.js';
+import { fromBaseUnits, sleep, toBaseUnits } from './utils.js';
 const TRX_DECIMALS = 6; // 1 TRX = 1,000,000 SUN
 const DEFAULT_CONFIRMATION_TIMEOUT_MS = 60_000;
 const CONFIRMATION_POLL_INTERVAL_MS = 3_000; // roughly one TRON block
-/** Thrown for any failed transfer. `txid` is set when the transaction reached the network. */
+const MAX_POLL_INTERVAL_MS = 15_000;
+const RATE_LIMIT_BASE_DELAY_MS = 1_000;
+/** Thrown for any failed transfer. `txid` is set when the transaction may have reached the network. */
 export class TronTransferError extends Error {
     txid;
-    constructor(message, txid) {
-        super(txid ? `${message} (txid: ${txid})` : message);
+    code;
+    constructor(message, txid, options = {}) {
+        super(txid ? `${message} (txid: ${txid})` : message, 'cause' in options ? { cause: options.cause } : {});
         this.name = 'TronTransferError';
         this.txid = txid;
+        this.code = options.code;
     }
 }
-function openSession(network) {
-    const config = loadConfig(network);
-    const from = TronWeb.address.fromPrivateKey(config.privateKey);
-    if (!from) {
-        throw new TronTransferError('Could not derive an address from the configured private key.');
+function assertAddress(address, label) {
+    if (!TronWeb.isAddress(address)) {
+        throw new TronTransferError(`Invalid ${label} address "${address}".`);
     }
-    return { config, tronWeb: createTronWeb(config), from };
 }
 function assertRecipient(to, from) {
-    if (!TronWeb.isAddress(to)) {
-        throw new TronTransferError(`Invalid recipient address "${to}".`);
-    }
+    assertAddress(to, 'recipient');
     if (TronWeb.address.toHex(to) === TronWeb.address.toHex(from)) {
         throw new TronTransferError('Recipient address is the same as the sender address.');
     }
@@ -35,114 +34,275 @@ function decodeNodeMessage(message) {
     if (!message)
         return 'unknown error';
     if (/^[0-9a-fA-F]+$/.test(message) && message.length % 2 === 0) {
-        return Buffer.from(message, 'hex').toString('utf8');
+        const bytes = Uint8Array.from(message.match(/../g) ?? [], (byte) => parseInt(byte, 16));
+        return new TextDecoder().decode(bytes);
     }
     return message;
 }
-async function signAndBroadcast(tronWeb, transaction) {
-    const signed = (await tronWeb.trx.sign(transaction));
-    const broadcast = await tronWeb.trx.sendRawTransaction(signed);
-    if (!broadcast.result) {
-        throw new TronTransferError(`Broadcast rejected: ${broadcast.code ?? 'ERROR'} ${decodeNodeMessage(broadcast.message)}`, broadcast.txid || signed.txID);
-    }
-    return broadcast.txid || signed.txID;
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
 }
-/** Polls until the transaction is in a block, then throws if it failed on-chain. */
-async function waitForConfirmation(tronWeb, txid, timeoutMs) {
-    const deadline = Date.now() + timeoutMs;
-    while (Date.now() < deadline) {
-        await sleep(CONFIRMATION_POLL_INTERVAL_MS);
-        const info = await tronWeb.trx.getUnconfirmedTransactionInfo(txid);
-        if (!info?.id)
-            continue;
-        const receiptResult = info.receipt?.result;
-        if (info.result === 'FAILED' || (receiptResult && receiptResult !== 'SUCCESS')) {
-            const reason = decodeNodeMessage(info.resMessage) || receiptResult || 'FAILED';
-            throw new TronTransferError(`Transaction failed on-chain: ${reason}`, txid);
-        }
-        return info;
-    }
-    throw new TronTransferError(`Transaction was broadcast but not confirmed within ${timeoutMs}ms. Check its status before retrying to avoid a double send`, txid);
+/** HTTP status of a failed TronWeb request (TronWeb uses axios), if the node sent a response. */
+function httpStatus(error) {
+    const status = error?.response?.status;
+    return typeof status === 'number' ? status : undefined;
 }
-async function finalize(session, txid, to, rawAmount, options) {
-    const result = {
-        txid,
-        network: session.config.network,
-        from: session.from,
-        to,
-        rawAmount: rawAmount.toString(),
-        confirmed: false,
-    };
-    if (options.waitForConfirmation === false)
-        return result;
-    const info = await waitForConfirmation(session.tronWeb, txid, options.confirmationTimeoutMs ?? DEFAULT_CONFIRMATION_TIMEOUT_MS);
-    return { ...result, confirmed: true, blockNumber: info.blockNumber, feeSun: info.fee ?? 0 };
-}
-async function callConstant(session, contractAddress, functionSelector, parameters = []) {
-    const response = await session.tronWeb.transactionBuilder.triggerConstantContract(contractAddress, functionSelector, {}, parameters, session.from);
-    const hex = response.constant_result?.[0];
-    if (!response.result?.result || typeof hex !== 'string' || hex.length === 0) {
-        throw new TronTransferError(`Call to ${functionSelector} on ${contractAddress} failed: ${decodeNodeMessage(response.result?.message)}. Is this a TRC-20 contract on the ${session.config.network}?`);
-    }
-    return BigInt(`0x${hex}`);
+/** Exponential backoff with jitter (~1s, ~2s, ~4s, ...), as TronGrid recommends for HTTP 429. */
+function backoffMs(attempt) {
+    return RATE_LIMIT_BASE_DELAY_MS * 2 ** attempt * (0.5 + Math.random());
 }
 /**
- * Sends native TRX from the account configured in .env.
+ * Sends TRX and TRC-20 tokens, with every transaction signed by `signer`.
  *
- * @example
- * await transferTrx({ to: 'TXYZ...', amount: '10' }); // 10 TRX
- */
-export async function transferTrx(params) {
-    const session = openSession(params.network);
-    const { tronWeb, from } = session;
-    assertRecipient(params.to, from);
-    const amountSun = toBaseUnits(params.amount, TRX_DECIMALS);
-    if (amountSun > BigInt(Number.MAX_SAFE_INTEGER)) {
-        throw new TronTransferError(`Amount ${params.amount} TRX is too large.`);
-    }
-    // getBalance() reads solidified state (~1 min behind); use the full node's latest view instead.
-    const balanceSun = BigInt(await tronWeb.trx.getUnconfirmedBalance(from));
-    if (balanceSun < amountSun) {
-        throw new TronTransferError(`Insufficient TRX balance: have ${balanceSun} SUN, need ${amountSun} SUN (plus fees if bandwidth is exhausted).`);
-    }
-    const transaction = await tronWeb.transactionBuilder.sendTrx(params.to, Number(amountSun), from);
-    const txid = await signAndBroadcast(tronWeb, transaction);
-    return finalize(session, txid, params.to, amountSun, params);
-}
-/**
- * Sends a TRC-20 token (USDT by default) from the account configured in .env.
- * The sender needs TRX to pay for energy; up to `feeLimitSun` may be burned.
+ * In a browser, pass the connected wallet adapter (or `useWallet()`) as the signer: the SDK builds
+ * and checks the transaction, the wallet asks the user to approve it, and the SDK broadcasts it and
+ * waits for confirmation. The TronWeb client here never holds a private key.
  *
  * @example
- * await transferToken({ to: 'TXYZ...', amount: '5' }); // 5 USDT
- * await transferToken({ to: 'TXYZ...', amount: '1.25', tokenAddress: 'T...' }); // any TRC-20
+ * const service = new TronTransferService(adapter, { network: 'mainnet', apiKey: TRONGRID_KEY });
+ * await service.transferToken({ to: 'TXYZ...', amount: '5' }); // 5 USDT
  */
-export async function transferToken(params) {
-    const session = openSession(params.network);
-    const { tronWeb, from, config } = session;
-    assertRecipient(params.to, from);
-    const tokenAddress = params.tokenAddress ?? config.usdtContract;
-    if (!tokenAddress) {
-        throw new TronTransferError(`No token address given and TRON_${config.network.toUpperCase()}_USDT_CONTRACT is not set.`);
-    }
-    if (!TronWeb.isAddress(tokenAddress)) {
-        throw new TronTransferError(`Invalid token contract address "${tokenAddress}".`);
-    }
-    const decimals = Number(await callConstant(session, tokenAddress, 'decimals()'));
-    const amount = toBaseUnits(params.amount, decimals);
-    // A TRC-20 transfer that reverts still burns energy, so check the balance up front.
-    const balance = await callConstant(session, tokenAddress, 'balanceOf(address)', [{ type: 'address', value: from }]);
-    if (balance < amount) {
-        throw new TronTransferError(`Insufficient token balance: have ${balance}, need ${amount} (base units).`);
-    }
-    const { result, transaction } = await tronWeb.transactionBuilder.triggerSmartContract(tokenAddress, 'transfer(address,uint256)', { feeLimit: params.feeLimitSun ?? config.feeLimitSun, callValue: 0 }, [
-        { type: 'address', value: params.to },
-        { type: 'uint256', value: amount.toString() },
-    ], from);
-    if (!result?.result) {
-        throw new TronTransferError(`Failed to build token transfer: ${decodeNodeMessage(result?.message)}`);
-    }
-    const txid = await signAndBroadcast(tronWeb, transaction);
-    return finalize(session, txid, params.to, amount, params);
+export class TronTransferService {
+    signer;
+    config;
+    tronWeb;
+    // A token's decimals never change, so read them once per token.
+    #decimals = new Map();
+    constructor(signer, config) {
+        this.signer = signer;
+        this.config = resolveServiceConfig(config);
+        this.tronWeb = createTronWeb(this.config);
+    }
+    /**
+     * Sends native TRX from the signer's account.
+     *
+     * @example
+     * await service.transferTrx({ to: 'TXYZ...', amount: '10' }); // 10 TRX
+     */
+    async transferTrx(params) {
+        const from = this.#requireSender();
+        assertRecipient(params.to, from);
+        const amountSun = toBaseUnits(params.amount, TRX_DECIMALS);
+        if (amountSun > BigInt(Number.MAX_SAFE_INTEGER)) {
+            throw new TronTransferError(`Amount ${params.amount} TRX is too large.`);
+        }
+        // getBalance() reads solidified state (~1 min behind); use the full node's latest view instead.
+        const balanceSun = BigInt(await this.#request(() => this.tronWeb.trx.getUnconfirmedBalance(from)));
+        if (balanceSun < amountSun) {
+            throw new TronTransferError(`Insufficient TRX balance: have ${balanceSun} SUN, need ${amountSun} SUN (plus fees if bandwidth is exhausted).`);
+        }
+        const transaction = await this.#request(() => this.tronWeb.transactionBuilder.sendTrx(params.to, Number(amountSun), from));
+        const txid = await this.#signAndBroadcast(transaction);
+        return this.#finalize(txid, from, params.to, amountSun, params);
+    }
+    /**
+     * Sends a TRC-20 token (USDT by default) from the signer's account.
+     * The sender needs TRX to pay for energy; up to `feeLimitSun` may be burned.
+     *
+     * @example
+     * await service.transferToken({ to: 'TXYZ...', amount: '5' }); // 5 USDT
+     * await service.transferToken({ to: 'TXYZ...', amount: '1.25', tokenAddress: 'T...' }); // any TRC-20
+     */
+    async transferToken(params) {
+        const from = this.#requireSender();
+        assertRecipient(params.to, from);
+        const tokenAddress = this.#resolveToken(params.tokenAddress);
+        const decimals = await this.#tokenDecimals(tokenAddress, from);
+        const amount = toBaseUnits(params.amount, decimals);
+        // A TRC-20 transfer that reverts still burns energy, so check the balance up front.
+        const balance = await this.#callConstant(tokenAddress, 'balanceOf(address)', [{ type: 'address', value: from }], from);
+        if (balance < amount) {
+            throw new TronTransferError(`Insufficient token balance: have ${balance}, need ${amount} (base units).`);
+        }
+        const { result, transaction } = await this.#request(() => this.tronWeb.transactionBuilder.triggerSmartContract(tokenAddress, 'transfer(address,uint256)', { feeLimit: params.feeLimitSun ?? this.config.feeLimitSun, callValue: 0 }, [
+            { type: 'address', value: params.to },
+            { type: 'uint256', value: amount.toString() },
+        ], from));
+        if (!result?.result) {
+            throw new TronTransferError(`Failed to build token transfer: ${decodeNodeMessage(result?.message)}`);
+        }
+        const txid = await this.#signAndBroadcast(transaction);
+        return this.#finalize(txid, from, params.to, amount, params);
+    }
+    /**
+     * TRX balance in whole TRX (e.g. "12.5"), from the full node's latest state.
+     * Defaults to the signer's address.
+     */
+    async getTrxBalance(address) {
+        const owner = address ?? this.#requireSender();
+        assertAddress(owner, 'account');
+        const balanceSun = BigInt(await this.#request(() => this.tronWeb.trx.getUnconfirmedBalance(owner)));
+        return fromBaseUnits(balanceSun, TRX_DECIMALS);
+    }
+    /**
+     * TRC-20 balance in whole tokens (e.g. "5.25"). Defaults to USDT and the signer's address.
+     */
+    async getTokenBalance(params = {}) {
+        const owner = params.owner ?? this.#requireSender();
+        assertAddress(owner, 'account');
+        const tokenAddress = this.#resolveToken(params.tokenAddress);
+        const decimals = await this.#tokenDecimals(tokenAddress, owner);
+        const balance = await this.#callConstant(tokenAddress, 'balanceOf(address)', [{ type: 'address', value: owner }], owner);
+        return fromBaseUnits(balance, decimals);
+    }
+    /** The signer's address, read on every call because a wallet can disconnect or switch accounts. */
+    #requireSender() {
+        const address = this.signer.address;
+        if (!address) {
+            throw new TronTransferError('No wallet connected: the signer has no address.');
+        }
+        if (!TronWeb.isAddress(address)) {
+            throw new TronTransferError(`Signer address "${address}" is not a valid TRON address.`);
+        }
+        return address;
+    }
+    #resolveToken(tokenAddress) {
+        const token = tokenAddress ?? this.config.usdtContract;
+        if (!token) {
+            throw new TronTransferError(`No token address given and no default USDT contract is known for ${this.config.fullHost}. Pass tokenAddress or set usdtContract.`);
+        }
+        if (!TronWeb.isAddress(token)) {
+            throw new TronTransferError(`Invalid token contract address "${token}".`);
+        }
+        return token;
+    }
+    /**
+     * Runs a node request that has no side effects, retrying HTTP 429 with backoff.
+     * Everything before the broadcast goes through here, so a failure means nothing was sent.
+     */
+    async #request(send) {
+        for (let attempt = 0;; attempt++) {
+            try {
+                return await send();
+            }
+            catch (error) {
+                const status = httpStatus(error);
+                if (status === 429 && attempt < this.config.rateLimitRetries) {
+                    await sleep(backoffMs(attempt));
+                    continue;
+                }
+                if (status === 429 || status === 403)
+                    throw this.#httpError(status, error);
+                throw error;
+            }
+        }
+    }
+    #httpError(status, cause, txid) {
+        const host = this.config.fullHost;
+        return status === 429
+            ? new TronTransferError(`Rate limited by ${host} (HTTP 429) after ${this.config.rateLimitRetries} retries. Try again shortly; for sustained traffic set apiKey or use another fullHost.`, txid, { cause, code: 'RATE_LIMITED' })
+            : new TronTransferError(`Request refused by ${host} (HTTP 403): the IP may be blocked, the daily quota used up, or the apiKey invalid.`, txid, { cause, code: 'ACCESS_DENIED' });
+    }
+    async #signAndBroadcast(transaction) {
+        let signed;
+        try {
+            signed = await this.signer.signTransaction(transaction);
+        }
+        catch (error) {
+            // Wallets throw here when the user rejects the request; nothing was broadcast.
+            throw new TronTransferError(`Transaction was not signed: ${errorMessage(error)}`, undefined, {
+                cause: error,
+                code: 'NOT_SIGNED',
+            });
+        }
+        // Only broadcast exactly what was built and checked above.
+        if (signed?.txID !== transaction.txID || !Array.isArray(signed.signature) || signed.signature.length === 0) {
+            throw new TronTransferError('Signer returned a transaction that is unsigned or differs from the one requested.');
+        }
+        return this.#broadcast(signed);
+    }
+    /**
+     * Broadcasts a signed transaction. Resending the same signed transaction is safe: it has the same
+     * txid, so the network accepts it at most once. That lets HTTP 429 be retried without asking the
+     * wallet to sign again and without any risk of a double send.
+     */
+    async #broadcast(signed) {
+        const txid = signed.txID;
+        for (let attempt = 0;; attempt++) {
+            let broadcast;
+            try {
+                broadcast = await this.tronWeb.trx.sendRawTransaction(signed);
+            }
+            catch (error) {
+                const status = httpStatus(error);
+                if (status === 429 && attempt < this.config.rateLimitRetries) {
+                    await sleep(backoffMs(attempt));
+                    continue;
+                }
+                // Almost certainly not broadcast, but the txid is kept so the caller checks before resending.
+                if (status === 429 || status === 403)
+                    throw this.#httpError(status, error, txid);
+                throw new TronTransferError(`Broadcast request failed: ${errorMessage(error)}. The transaction may still have reached the network; check it before retrying`, txid, { cause: error });
+            }
+            if (broadcast.result)
+                return broadcast.txid || txid;
+            // An earlier attempt got through even though its response was lost.
+            if (attempt > 0 && broadcast.code === 'DUP_TRANSACTION_ERROR')
+                return txid;
+            throw new TronTransferError(`Broadcast rejected: ${broadcast.code ?? 'ERROR'} ${decodeNodeMessage(broadcast.message)}`, broadcast.txid || txid);
+        }
+    }
+    /** Polls until the transaction is in a block, then throws if it failed on-chain. */
+    async #waitForConfirmation(txid, timeoutMs) {
+        const deadline = Date.now() + timeoutMs;
+        let interval = CONFIRMATION_POLL_INTERVAL_MS;
+        let lastError;
+        while (Date.now() < deadline) {
+            await sleep(interval);
+            let info;
+            try {
+                info = await this.tronWeb.trx.getUnconfirmedTransactionInfo(txid);
+            }
+            catch (error) {
+                // The transaction is already sent, so a failed poll must not end the wait; slow down on 429.
+                lastError = error;
+                if (httpStatus(error) === 429)
+                    interval = Math.min(interval * 2, MAX_POLL_INTERVAL_MS);
+                continue;
+            }
+            interval = CONFIRMATION_POLL_INTERVAL_MS;
+            if (!info?.id)
+                continue;
+            const receiptResult = info.receipt?.result;
+            if (info.result === 'FAILED' || (receiptResult && receiptResult !== 'SUCCESS')) {
+                const reason = decodeNodeMessage(info.resMessage) || receiptResult || 'FAILED';
+                throw new TronTransferError(`Transaction failed on-chain: ${reason}`, txid);
+            }
+            return info;
+        }
+        const pollError = lastError === undefined ? '' : ` Last polling error: ${errorMessage(lastError)}.`;
+        throw new TronTransferError(`Transaction was broadcast but not confirmed within ${timeoutMs}ms.${pollError} Check its status before retrying to avoid a double send`, txid, lastError === undefined ? {} : { cause: lastError });
+    }
+    async #finalize(txid, from, to, rawAmount, options) {
+        const result = {
+            txid,
+            network: this.config.network,
+            from,
+            to,
+            rawAmount: rawAmount.toString(),
+            confirmed: false,
+        };
+        if (options.waitForConfirmation === false)
+            return result;
+        const info = await this.#waitForConfirmation(txid, options.confirmationTimeoutMs ?? DEFAULT_CONFIRMATION_TIMEOUT_MS);
+        return { ...result, confirmed: true, blockNumber: info.blockNumber, feeSun: info.fee ?? 0 };
+    }
+    async #tokenDecimals(tokenAddress, caller) {
+        const key = TronWeb.address.toHex(tokenAddress);
+        let decimals = this.#decimals.get(key);
+        if (decimals === undefined) {
+            decimals = Number(await this.#callConstant(tokenAddress, 'decimals()', [], caller));
+            this.#decimals.set(key, decimals);
+        }
+        return decimals;
+    }
+    async #callConstant(contractAddress, functionSelector, parameters, caller) {
+        const response = await this.#request(() => this.tronWeb.transactionBuilder.triggerConstantContract(contractAddress, functionSelector, {}, parameters, caller));
+        const hex = response.constant_result?.[0];
+        if (!response.result?.result || typeof hex !== 'string' || hex.length === 0) {
+            throw new TronTransferError(`Call to ${functionSelector} on ${contractAddress} failed: ${decodeNodeMessage(response.result?.message)}. Is this a TRC-20 contract on the ${this.config.network}?`);
+        }
+        return BigInt(`0x${hex}`);
+    }
 }
 //# sourceMappingURL=services.js.map

package/dist/services.js.map

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

package/dist/signer.d.ts

@@ -0,0 +1,25 @@
+import type { Types } from 'tronweb';
+/**
+ * Signs TRON transactions for one account.
+ *
+ * This is the same shape as a TronWallet adapter (`@tronweb3/tronwallet-adapters`, e.g. TronLinkAdapter)
+ * and as the object returned by `useWallet()` from `@tronweb3/tronwallet-adapter-react-hooks`, so either
+ * can be passed to TronTransferService as-is. For Node scripts and tests, use PrivateKeySigner.
+ */
+export interface TronSigner {
+    /** Base58 address (T...) of the signing account, or null when no wallet is connected. */
+    readonly address: string | null;
+    /** Returns the transaction with its signature attached. It must not broadcast it. */
+    signTransaction(transaction: Types.Transaction): Promise<Types.SignedTransaction>;
+}
+/**
+ * Signs locally with a hex private key. For backends, scripts and tests only:
+ * never ship a private key to a browser; let the user's wallet sign there instead.
+ */
+export declare class PrivateKeySigner implements TronSigner {
+    #private;
+    readonly address: string;
+    constructor(privateKey: string);
+    signTransaction(transaction: Types.Transaction): Promise<Types.SignedTransaction>;
+}
+//# sourceMappingURL=signer.d.ts.map

package/dist/signer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signer.d.ts","sourceRoot":"","sources":["../src/signer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,yFAAyF;IACzF,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,qFAAqF;IACrF,eAAe,CAAC,WAAW,EAAE,KAAK,CAAC,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;CACnF;AAED;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,UAAU;;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAGb,UAAU,EAAE,MAAM;IAaxB,eAAe,CAAC,WAAW,EAAE,KAAK,CAAC,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC;CAIxF"}

package/dist/signer.js

@@ -0,0 +1,26 @@
+import { TronWeb, utils } from 'tronweb';
+/**
+ * Signs locally with a hex private key. For backends, scripts and tests only:
+ * never ship a private key to a browser; let the user's wallet sign there instead.
+ */
+export class PrivateKeySigner {
+    address;
+    #privateKey;
+    constructor(privateKey) {
+        const key = privateKey.trim().replace(/^0x/i, '');
+        if (!/^[0-9a-fA-F]{64}$/.test(key)) {
+            throw new Error('Private key must be a 64-character hex string.');
+        }
+        const address = TronWeb.address.fromPrivateKey(key);
+        if (!address) {
+            throw new Error('Could not derive an address from the private key.');
+        }
+        this.address = address;
+        this.#privateKey = key;
+    }
+    async signTransaction(transaction) {
+        // signTransaction() mutates its argument; copy so the caller's unsigned transaction is left as is.
+        return utils.crypto.signTransaction(this.#privateKey, { ...transaction });
+    }
+}
+//# sourceMappingURL=signer.js.map

package/dist/signer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signer.js","sourceRoot":"","sources":["../src/signer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAiBzC;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IAClB,OAAO,CAAS;IAChB,WAAW,CAAS;IAE7B,YAAY,UAAkB;QAC5B,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;QACD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,WAA8B;QAClD,mGAAmG;QACnG,OAAO,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,GAAG,WAAW,EAAE,CAAC,CAAC;IAC5E,CAAC;CACF"}

package/dist/types.d.ts

@@ -2,8 +2,6 @@ import type { TronNetwork } from './config.js';
 /** Human-readable amount, e.g. "10" TRX or "2.5" USDT. Strings avoid floating-point rounding. */
 export type Amount = string | number;
 export interface TransferOptions {
-    /** Network to use. Defaults to TRON_NETWORK from .env. */
-    network?: TronNetwork;
     /**
      * Wait until the transaction is included in a block and check it succeeded.
      * Broadcast success alone does not mean a TRC-20 transfer executed. Default: true.
@@ -12,6 +10,11 @@ export interface TransferOptions {
     /** How long to wait for confirmation, in milliseconds. Default: 60_000. */
     confirmationTimeoutMs?: number;
 }
+/** Extra option for the .env-driven transferTrx() / transferToken() in the Node entry. */
+export interface EnvTransferOptions {
+    /** Network to use. Defaults to TRON_NETWORK from .env. */
+    network?: TronNetwork;
+}
 export interface TransferTrxParams extends TransferOptions {
     /** Recipient base58 address (T...). */
     to: string;
@@ -25,9 +28,15 @@ export interface TransferTokenParams extends TransferOptions {
     amount: Amount;
     /** TRC-20 contract address. Defaults to the USDT contract configured for the network. */
     tokenAddress?: string;
-    /** Max TRX (in SUN) to burn for energy. Defaults to TRON_FEE_LIMIT_SUN. */
+    /** Max TRX (in SUN) to burn for energy. Defaults to the service's feeLimitSun. */
     feeLimitSun?: number;
 }
+export interface TokenBalanceParams {
+    /** TRC-20 contract address. Defaults to the USDT contract configured for the network. */
+    tokenAddress?: string;
+    /** Account to read. Defaults to the signer's address. */
+    owner?: string;
+}
 export interface TransferResult {
     txid: string;
     network: TronNetwork;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,iGAAiG;AACjG,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAErC,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,2EAA2E;IAC3E,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,oFAAoF;IACpF,MAAM,EAAE,MAAM,CAAC;IACf,yFAAyF;IACzF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,gGAAgG;IAChG,SAAS,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,iGAAiG;AACjG,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAErC,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,2EAA2E;IAC3E,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,0FAA0F;AAC1F,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,oFAAoF;IACpF,MAAM,EAAE,MAAM,CAAC;IACf,yFAAyF;IACzF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,yFAAyF;IACzF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,gGAAgG;IAChG,SAAS,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/utils.d.ts

@@ -4,5 +4,10 @@ import type { Amount } from './types.js';
  * e.g. toBaseUnits("1.5", 6) === 1_500_000n.
  */
 export declare function toBaseUnits(amount: Amount, decimals: number): bigint;
+/**
+ * Converts an amount in the smallest unit into a human-readable string,
+ * e.g. fromBaseUnits(1_500_000n, 6) === "1.5".
+ */
+export declare function fromBaseUnits(units: bigint, decimals: number): string;
 export declare function sleep(ms: number): Promise<void>;
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAmBpE;AAaD,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAmBpE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMrE;AAaD,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/utils.js

@@ -19,6 +19,18 @@ export function toBaseUnits(amount, decimals) {
     }
     return units;
 }
+/**
+ * Converts an amount in the smallest unit into a human-readable string,
+ * e.g. fromBaseUnits(1_500_000n, 6) === "1.5".
+ */
+export function fromBaseUnits(units, decimals) {
+    if (units < 0n)
+        return `-${fromBaseUnits(-units, decimals)}`;
+    const digits = units.toString().padStart(decimals + 1, '0');
+    const whole = digits.slice(0, digits.length - decimals);
+    const fraction = digits.slice(digits.length - decimals).replace(/0+$/, '');
+    return fraction ? `${whole}.${fraction}` : whole;
+}
 function numberToPlainString(value) {
     if (!Number.isFinite(value)) {
         throw new Error(`Invalid amount ${value}.`);

package/dist/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,QAAgB;IAC1D,MAAM,IAAI,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAEtF,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,+CAA+C,CAAC,CAAC;IAC5F,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;IAC9B,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,QAAQ,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,mBAAmB,QAAQ,kBAAkB,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;IAC7D,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,0CAA0C,MAAM,IAAI,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa;IACxC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,GAAG,CAAC,CAAC;IAC9C,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,mEAAmE,CAAC,CAAC;IACtG,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,QAAgB;IAC1D,MAAM,IAAI,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAEtF,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,+CAA+C,CAAC,CAAC;IAC5F,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;IAC9B,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,QAAQ,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,mBAAmB,QAAQ,kBAAkB,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;IAC7D,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,0CAA0C,MAAM,IAAI,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,QAAgB;IAC3D,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,IAAI,aAAa,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;IAC7D,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,QAAQ,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC3E,OAAO,QAAQ,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AACnD,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa;IACxC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,GAAG,CAAC,CAAC;IAC9C,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,mEAAmE,CAAC,CAAC;IACtG,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}