tronwb 6.0.0

package/lib/esm/lib/contract/method.js

@@ -0,0 +1,233 @@
+/* eslint-disable no-control-regex */
+import utils from '../../utils/index.js';
+import { encodeParamsV2ByABI, decodeParamsV2ByABI } from '../../utils/abi.js';
+import { sha3 } from '../../utils/crypto.js';
+const getFunctionSelector = (abi) => {
+    if ('stateMutability' in abi) {
+        abi.stateMutability = abi.stateMutability ? abi.stateMutability.toLowerCase() : 'nonpayable';
+    }
+    abi.type = abi.type ? abi.type.toLowerCase() : '';
+    if (abi.type === 'fallback' || abi.type === 'receive')
+        return '0x';
+    const iface = new utils.ethersUtils.Interface([abi]);
+    let obj;
+    if (abi.type === 'event') {
+        obj = iface.getEvent(abi.name);
+    }
+    else {
+        obj = iface.getFunction(abi.name);
+    }
+    if (obj) {
+        return obj.format('sighash');
+    }
+    throw new Error('unknown function');
+};
+const decodeOutput = (abi, output) => {
+    return decodeParamsV2ByABI(abi, output);
+};
+export class Method {
+    tronWeb;
+    contract;
+    abi;
+    name;
+    inputs;
+    outputs;
+    functionSelector;
+    signature;
+    defaultOptions;
+    constructor(contract, abi) {
+        this.tronWeb = contract.tronWeb;
+        this.contract = contract;
+        this.abi = abi;
+        this.name = abi.name || abi.type;
+        this.inputs = abi.inputs || [];
+        this.outputs = [];
+        if ('outputs' in abi && abi.outputs) {
+            this.outputs = abi.outputs;
+        }
+        this.functionSelector = getFunctionSelector(abi);
+        this.signature = sha3(this.functionSelector, false).slice(0, 8);
+        this.defaultOptions = {
+            feeLimit: this.tronWeb.feeLimit,
+            callValue: 0,
+            userFeePercentage: 100,
+            shouldPollResponse: false, // Only used for sign()
+        };
+    }
+    decodeInput(data) {
+        const abi = JSON.parse(JSON.stringify(this.abi));
+        abi.outputs = abi.inputs;
+        return decodeOutput(abi, '0x' + data);
+    }
+    onMethod(...args) {
+        let rawParameter = '';
+        if (this.abi && !/event/i.test(this.abi.type)) {
+            rawParameter = encodeParamsV2ByABI(this.abi, args);
+        }
+        return {
+            call: async (options = {}) => {
+                options = {
+                    ...options,
+                    rawParameter,
+                };
+                return await this._call([], [], options);
+            },
+            send: async (options = {}, privateKey = this.tronWeb.defaultPrivateKey) => {
+                options = {
+                    ...options,
+                    rawParameter,
+                };
+                return await this._send([], [], options, privateKey);
+            },
+        };
+    }
+    async _call(types, args, options = {}) {
+        if (types.length !== args.length) {
+            throw new Error('Invalid argument count provided');
+        }
+        if (!this.contract.address) {
+            throw new Error('Smart contract is missing address');
+        }
+        if (!this.contract.deployed) {
+            throw new Error('Calling smart contracts requires you to load the contract first');
+        }
+        if ('stateMutability' in this.abi) {
+            const { stateMutability } = this.abi;
+            if (stateMutability && !['pure', 'view'].includes(stateMutability.toLowerCase())) {
+                throw new Error(`Methods with state mutability "${stateMutability}" must use send()`);
+            }
+        }
+        options = {
+            ...this.defaultOptions,
+            from: this.tronWeb.defaultAddress.hex,
+            ...options,
+            _isConstant: true,
+        };
+        const parameters = args.map((value, index) => ({
+            type: types[index],
+            value,
+        }));
+        const transaction = await this.tronWeb.transactionBuilder.triggerSmartContract(this.contract.address, this.functionSelector, options, parameters, options.from ? this.tronWeb.address.toHex(options.from) : undefined);
+        if (!utils.hasProperty(transaction, 'constant_result')) {
+            throw new Error('Failed to execute');
+        }
+        const len = transaction.constant_result[0].length;
+        if (len === 0 || len % 64 === 8) {
+            let msg = 'The call has been reverted or has thrown an error.';
+            if (len !== 0) {
+                msg += ' Error message: ';
+                let msg2 = '';
+                const chunk = transaction.constant_result[0].substring(8);
+                for (let i = 0; i < len - 8; i += 64) {
+                    msg2 += this.tronWeb.toUtf8(chunk.substring(i, i + 64));
+                }
+                msg += msg2
+                    .replace(/(\u0000|\u000b|\f)+/g, ' ')
+                    .replace(/ +/g, ' ')
+                    .replace(/\s+$/g, '');
+            }
+            throw new Error(msg);
+        }
+        let output = decodeOutput(this.abi, '0x' + transaction.constant_result[0]);
+        if (output.length === 1 && Object.keys(output).length === 1) {
+            output = output[0];
+        }
+        return output;
+    }
+    async _send(types, args, options = {}, privateKey = this.tronWeb.defaultPrivateKey) {
+        if (types.length !== args.length) {
+            throw new Error('Invalid argument count provided');
+        }
+        if (!this.contract.address) {
+            throw new Error('Smart contract is missing address');
+        }
+        if (!this.contract.deployed) {
+            throw new Error('Calling smart contracts requires you to load the contract first');
+        }
+        const { stateMutability } = this.abi;
+        if (['pure', 'view'].includes(stateMutability.toLowerCase())) {
+            throw new Error(`Methods with state mutability "${stateMutability}" must use call()`);
+        }
+        // If a function isn't payable, dont provide a callValue.
+        if (!['payable'].includes(stateMutability.toLowerCase())) {
+            options.callValue = 0;
+        }
+        options = {
+            ...this.defaultOptions,
+            from: this.tronWeb.defaultAddress.hex,
+            ...options,
+        };
+        const parameters = args.map((value, index) => ({
+            type: types[index],
+            value,
+        }));
+        const address = privateKey ? this.tronWeb.address.fromPrivateKey(privateKey) : this.tronWeb.defaultAddress.base58;
+        const transaction = await this.tronWeb.transactionBuilder.triggerSmartContract(this.contract.address, this.functionSelector, options, parameters, this.tronWeb.address.toHex(address));
+        if (!transaction.result || !transaction.result.result) {
+            throw new Error('Unknown error: ' + JSON.stringify(transaction, null, 2));
+        }
+        // If privateKey is false, this won't be signed here. We assume sign functionality will be replaced.
+        const signedTransaction = await this.tronWeb.trx.sign(transaction.transaction, privateKey);
+        if (!signedTransaction.signature) {
+            if (!privateKey) {
+                throw new Error('Transaction was not signed properly');
+            }
+            throw new Error('Invalid private key provided');
+        }
+        const broadcast = await this.tronWeb.trx.sendRawTransaction(signedTransaction);
+        if (broadcast.code) {
+            const err = {
+                error: broadcast.code,
+                message: broadcast.code,
+            };
+            if (broadcast.message)
+                err.message = this.tronWeb.toUtf8(broadcast.message);
+            const error = new Error(err.message);
+            error.error = broadcast.code;
+            throw error;
+        }
+        if (!options.shouldPollResponse) {
+            return signedTransaction.txID;
+        }
+        const checkResult = async (index) => {
+            if (index === (options.pollTimes || 20)) {
+                const error = new Error('Cannot find result in solidity node');
+                error.error = 'Cannot find result in solidity node';
+                error.transaction = signedTransaction;
+                throw error;
+            }
+            const output = await this.tronWeb.trx.getTransactionInfo(signedTransaction.txID);
+            if (!Object.keys(output).length) {
+                await new Promise((r) => setTimeout(r, 3000));
+                return checkResult(index + 1);
+            }
+            if (output.result && output.result === 'FAILED') {
+                const error = new Error(this.tronWeb.toUtf8(output.resMessage));
+                error.error = this.tronWeb.toUtf8(output.resMessage);
+                error.transaction = signedTransaction;
+                error.output = output;
+                throw error;
+            }
+            if (!utils.hasProperty(output, 'contractResult')) {
+                const error = new Error('Failed to execute: ' + JSON.stringify(output, null, 2));
+                error.error = 'Failed to execute: ' + JSON.stringify(output, null, 2);
+                error.transaction = signedTransaction;
+                error.output = output;
+                throw error;
+            }
+            if (options.rawResponse) {
+                return output;
+            }
+            let decoded = decodeOutput(this.abi, '0x' + output.contractResult[0]);
+            if (decoded.length === 1 && Object.keys(decoded).length === 1) {
+                decoded = decoded[0];
+            }
+            if (options.keepTxID) {
+                return [signedTransaction.txID, decoded];
+            }
+            return decoded;
+        };
+        return checkResult(0);
+    }
+}
+//# sourceMappingURL=method.js.map

package/lib/esm/lib/contract/method.js.map

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

package/lib/esm/lib/event.d.ts

@@ -0,0 +1,85 @@
+import { TronWeb } from '../tronweb.js';
+import { NodeProvider } from '../types/TronWeb.js';
+export interface GetEventResultOptions {
+    /**
+     * Name of the event to filter by.
+     */
+    eventName?: string;
+    /**
+     * Specific block number to query.
+     */
+    blockNumber?: number;
+    /**
+     * Maximum number returned.
+     */
+    limit?: number;
+    /**
+     * When the data volume of the query result is large, the returned result of one query will not contain all the data, and it takes multiple queries to obtain the complete data. Therefore, the fingerprint field will appear in the last piece of data in the returned result. After specifying this field as the content of the fingerprint in the result of the previous query in the next query, the query will return subsequent data. If there is no such field in the last data of the query result, it means that there is no more data.
+     */
+    fingerprint?: string;
+    /**
+     * If set to true, only returns confirmed transactions.
+     */
+    onlyConfirmed?: boolean;
+    /**
+     * If set to true, only returns unconfirmed transactions.
+     */
+    onlyUnconfirmed?: boolean;
+    /**
+     * Specify the query order, whether to query forward or backward from the sinceTimestamp.
+     * The value can be 'block_timestamp,desc' for time sequence or 'block_timestamp,asc' for the reverse.
+     * Default is 'block_timestamp,desc'.
+     */
+    orderBy?: 'block_timestamp,desc' | 'block_timestamp,asc';
+    /**
+     * Specifies the starting timestamp of the query, in milliseconds, default value is the current time.
+     */
+    minBlockTimestamp?: number;
+    /**
+     * Specifies the ending timestamp of the query, in milliseconds.
+     */
+    maxBlockTimestamp?: number;
+}
+export interface EventResponse {
+    success: boolean;
+    error?: string;
+    data?: {
+        block_number: number;
+        block_timestamp: number;
+        caller_contract_address: string;
+        contract_address: string;
+        event_index: number;
+        event_name: string;
+        result: Record<string, string>;
+        result_type: Record<string, string>;
+        event: string;
+        transaction_id: string;
+        _unconfirmed: boolean;
+    }[];
+    meta?: {
+        at: number;
+        fingerprint?: string;
+        links?: {
+            next: string;
+        };
+        page_size: number;
+    };
+}
+export declare class Event {
+    private tronWeb;
+    constructor(tronWeb: TronWeb);
+    setServer(eventServer: NodeProvider, healthcheck?: string): undefined;
+    getEventsByContractAddress(contractAddress: string, options?: GetEventResultOptions): Promise<EventResponse>;
+    getEventsByTransactionID(transactionID: string, options?: {
+        only_unconfirmed?: boolean;
+        only_confirmed?: boolean;
+    }): Promise<EventResponse>;
+    getEventsByBlockNumber(blockNumber: number | string, options?: {
+        only_confirmed?: boolean;
+        limit?: number;
+        fingerprint?: string;
+    }): Promise<EventResponse>;
+    getEventsOfLatestBlock(options?: {
+        only_confirmed?: boolean;
+    }): Promise<EventResponse>;
+}

package/lib/esm/lib/event.js

@@ -0,0 +1,132 @@
+import { TronWeb } from '../tronweb.js';
+import utils from '../utils/index.js';
+import { HttpProvider } from './providers/index.js';
+export class Event {
+    tronWeb;
+    constructor(tronWeb) {
+        if (!tronWeb || !(tronWeb instanceof TronWeb))
+            throw new Error('Expected instance of TronWeb');
+        this.tronWeb = tronWeb;
+    }
+    setServer(eventServer, healthcheck = 'healthcheck') {
+        if (!eventServer)
+            return (this.tronWeb.eventServer = undefined);
+        if (utils.isString(eventServer))
+            eventServer = new HttpProvider(eventServer);
+        if (!this.tronWeb.isValidProvider(eventServer))
+            throw new Error('Invalid event server provided');
+        this.tronWeb.eventServer = eventServer;
+        this.tronWeb.eventServer.isConnected = () => this.tronWeb
+            .eventServer.request(healthcheck)
+            .then(() => true)
+            .catch(() => false);
+    }
+    async getEventsByContractAddress(contractAddress, options = {}) {
+        const newOptions = Object.assign({
+            limit: 20,
+        }, options);
+        const { eventName, blockNumber, onlyUnconfirmed, onlyConfirmed, minBlockTimestamp, maxBlockTimestamp, orderBy, fingerprint, } = newOptions;
+        let { limit } = newOptions;
+        if (!this.tronWeb.eventServer) {
+            throw new Error('No event server configured');
+        }
+        if (!this.tronWeb.isAddress(contractAddress)) {
+            throw new Error('Invalid contract address provided');
+        }
+        if (typeof minBlockTimestamp !== 'undefined' && !utils.isInteger(minBlockTimestamp)) {
+            throw new Error('Invalid minBlockTimestamp provided');
+        }
+        if (typeof maxBlockTimestamp !== 'undefined' && !utils.isInteger(maxBlockTimestamp)) {
+            throw new Error('Invalid maxBlockTimestamp provided');
+        }
+        if (utils.isInteger(limit) && limit > 200) {
+            console.warn('Defaulting to maximum accepted limit: 200');
+            limit = 200;
+        }
+        const qs = {};
+        if (eventName)
+            qs.event_name = eventName;
+        if (blockNumber)
+            qs.block_number = blockNumber;
+        if (typeof onlyUnconfirmed === 'boolean')
+            qs.only_unconfirmed = onlyUnconfirmed;
+        if (typeof onlyConfirmed === 'boolean')
+            qs.only_confirmed = onlyConfirmed;
+        if (minBlockTimestamp)
+            qs.min_block_timestamp = minBlockTimestamp;
+        if (maxBlockTimestamp)
+            qs.max_block_timestamp = maxBlockTimestamp;
+        if (orderBy)
+            qs.order_by = orderBy;
+        if (fingerprint)
+            qs.fingerprint = fingerprint;
+        if (utils.isInteger(limit))
+            qs.limit = limit;
+        const res = await this.tronWeb.eventServer.request(`v1/contracts/${this.tronWeb.address.fromHex(contractAddress)}/events?${new URLSearchParams(qs).toString()}`);
+        if (res.success) {
+            return res;
+        }
+        throw new Error(res.error);
+    }
+    async getEventsByTransactionID(transactionID, options = {}) {
+        if (!this.tronWeb.eventServer) {
+            throw new Error('No event server configured');
+        }
+        const qs = {};
+        if (typeof options.only_unconfirmed === 'boolean') {
+            qs.only_unconfirmed = options.only_unconfirmed;
+        }
+        if (typeof options.only_confirmed === 'boolean') {
+            qs.only_confirmed = options.only_confirmed;
+        }
+        return this.tronWeb.eventServer
+            .request(`v1/transactions/${transactionID}/events?${new URLSearchParams(qs).toString()}`)
+            .then((res) => {
+            if (res.success) {
+                return res;
+            }
+            throw new Error(JSON.parse(res.error).message);
+        });
+    }
+    async getEventsByBlockNumber(blockNumber, options = {}) {
+        if (!this.tronWeb.eventServer) {
+            throw new Error('No event server configured');
+        }
+        const qs = {};
+        if (typeof options.only_confirmed === 'boolean') {
+            qs.only_confirmed = options.only_confirmed;
+        }
+        if (options.limit) {
+            qs.limit = options.limit;
+        }
+        if (options.fingerprint) {
+            qs.fingerprint = options.fingerprint;
+        }
+        return this.tronWeb.eventServer
+            .request(`v1/blocks/${blockNumber}/events?${new URLSearchParams(qs).toString()}`)
+            .then((res) => {
+            if (res.success) {
+                return res;
+            }
+            throw new Error(res.error);
+        });
+    }
+    async getEventsOfLatestBlock(options = {}) {
+        if (!this.tronWeb.eventServer) {
+            throw new Error('No event server configured');
+        }
+        const qs = {};
+        if (typeof options.only_confirmed === 'boolean') {
+            qs.only_confirmed = options.only_confirmed;
+        }
+        return this.tronWeb.eventServer
+            .request(`v1/blocks/latest/events?${new URLSearchParams(qs).toString()}`)
+            .then((res) => {
+            if (res.success) {
+                return res;
+            }
+            throw new Error(res.error);
+        });
+    }
+}
+//# sourceMappingURL=event.js.map

package/lib/esm/lib/event.js.map

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

package/lib/esm/lib/plugin.d.ts

@@ -0,0 +1,28 @@
+import { TronWeb } from '../tronweb.js';
+interface PluginConstructorOptions {
+    disablePlugins?: boolean;
+}
+interface PluginClassInterface {
+    new (tronWeb: TronWeb): {
+        pluginInterface?: (options: PluginOptions) => PluginInterfaceReturn;
+    };
+}
+interface PluginInterfaceReturn {
+    requires: string;
+    components?: Record<string | number | symbol, any>;
+    fullClass?: boolean;
+}
+type PluginOptions = any;
+export declare class Plugin {
+    tronWeb: TronWeb;
+    pluginNoOverride: string[];
+    disablePlugins: boolean;
+    constructor(tronWeb: TronWeb, options?: PluginConstructorOptions);
+    register(Plugin: PluginClassInterface, options?: PluginOptions): {
+        libs: any[];
+        plugged: any[];
+        skipped: any[];
+        error?: string;
+    };
+}
+export {};

package/lib/esm/lib/plugin.js

@@ -0,0 +1,79 @@
+import { TronWeb } from '../tronweb.js';
+import utils from '../utils/index.js';
+import semver from 'semver';
+export class Plugin {
+    tronWeb;
+    pluginNoOverride;
+    disablePlugins;
+    constructor(tronWeb, options = {}) {
+        if (!tronWeb || !(tronWeb instanceof TronWeb))
+            throw new Error('Expected instance of TronWeb');
+        this.tronWeb = tronWeb;
+        this.pluginNoOverride = ['register'];
+        this.disablePlugins = !!options.disablePlugins;
+    }
+    register(Plugin, options) {
+        let pluginInterface = {
+            requires: '0.0.0',
+            components: {},
+        };
+        const result = {
+            libs: [],
+            plugged: [],
+            skipped: [],
+            error: undefined,
+        };
+        if (this.disablePlugins) {
+            result.error = 'This instance of TronWeb has plugins disabled.';
+            return result;
+        }
+        const plugin = new Plugin(this.tronWeb);
+        if (utils.isFunction(plugin.pluginInterface)) {
+            pluginInterface = plugin.pluginInterface(options);
+        }
+        if (semver.satisfies(TronWeb.version, pluginInterface.requires)) {
+            if (pluginInterface.fullClass) {
+                // plug the entire class at the same level of tronWeb.trx
+                const className = plugin.constructor.name;
+                const classInstanceName = className.substring(0, 1).toLowerCase() + className.substring(1);
+                if (className !== classInstanceName) {
+                    Object.assign(TronWeb, {
+                        [className]: Plugin,
+                    });
+                    Object.assign(this.tronWeb, {
+                        [classInstanceName]: plugin,
+                    });
+                    result.libs.push(className);
+                }
+            }
+            else {
+                // plug methods into a class, like trx
+                for (const component in pluginInterface.components) {
+                    // eslint-disable-next-line no-prototype-builtins
+                    if (!this.tronWeb.hasOwnProperty(component)) {
+                        continue;
+                    }
+                    const methods = pluginInterface.components[component];
+                    const pluginNoOverride = this.tronWeb[component].pluginNoOverride || [];
+                    for (const method in methods) {
+                        if (method === 'constructor' ||
+                            (this.tronWeb[component][method] &&
+                                (pluginNoOverride.includes(method) || // blacklisted methods
+                                    /^_/.test(method))) // private methods
+                        ) {
+                            result.skipped.push(method);
+                            continue;
+                        }
+                        this.tronWeb[component][method] = methods[method].bind(this.tronWeb[component]);
+                        result.plugged.push(method);
+                    }
+                }
+            }
+        }
+        else {
+            throw new Error('The plugin is not compatible with this version of TronWeb');
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=plugin.js.map

package/lib/esm/lib/plugin.js.map

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

package/lib/esm/lib/providers/HttpProvider.d.ts

@@ -0,0 +1,15 @@
+import { Method } from 'axios';
+import { HeadersType, HttpProviderInstance } from '../../types/Providers.js';
+export default class HttpProvider {
+    host: string;
+    timeout: number;
+    user: string;
+    password: string;
+    headers: HeadersType;
+    statusPage: string;
+    instance: HttpProviderInstance;
+    constructor(host: string, timeout?: number, user?: string, password?: string, headers?: HeadersType, statusPage?: string);
+    setStatusPage(statusPage?: string): void;
+    isConnected(statusPage?: string): Promise<boolean | 0>;
+    request<T = unknown>(url: string, payload?: {}, method?: Method): Promise<T>;
+}

package/lib/esm/lib/providers/HttpProvider.js

@@ -0,0 +1,59 @@
+import axios from 'axios';
+import { hasProperties, isObject, isValidURL } from '../../utils/validations.js';
+export default class HttpProvider {
+    host;
+    timeout;
+    user;
+    password;
+    headers;
+    statusPage;
+    instance;
+    constructor(host, timeout = 30000, user = '', password = '', headers = {}, statusPage = '/') {
+        if (!isValidURL(host))
+            throw new Error('Invalid URL provided to HttpProvider');
+        if (isNaN(timeout) || timeout < 0)
+            throw new Error('Invalid timeout duration provided');
+        if (!isObject(headers))
+            throw new Error('Invalid headers object provided');
+        host = host.replace(/\/+$/, '');
+        this.host = host;
+        this.timeout = timeout;
+        this.user = user;
+        this.password = password;
+        this.headers = headers;
+        this.statusPage = statusPage;
+        this.instance = axios.create({
+            baseURL: host,
+            timeout: timeout,
+            headers: headers,
+            auth: user
+                ? {
+                    username: user,
+                    password,
+                }
+                : undefined,
+        });
+    }
+    setStatusPage(statusPage = '/') {
+        this.statusPage = statusPage;
+    }
+    async isConnected(statusPage = this.statusPage) {
+        return this.request(statusPage)
+            .then((data) => {
+            return hasProperties(data, 'blockID', 'block_header');
+        })
+            .catch(() => false);
+    }
+    request(url, payload = {}, method = 'get') {
+        method = method.toLowerCase();
+        return this.instance
+            .request({
+            data: method == 'post' && Object.keys(payload).length ? payload : null,
+            params: method == 'get' && payload,
+            url,
+            method,
+        })
+            .then(({ data }) => data);
+    }
+}
+//# sourceMappingURL=HttpProvider.js.map