tronewb
Version:
JavaScript SDK that encapsulates the TRON HTTP API
365 lines • 13.8 kB
JavaScript
"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
exports.TronWeb = void 0;
const tslib_1 = require("tslib");
const index_js_1 = require("./lib/providers/index.js");
const index_js_2 = tslib_1.__importDefault(require("./utils/index.js"));
const bignumber_js_1 = require("bignumber.js");
const eventemitter3_1 = tslib_1.__importDefault(require("eventemitter3"));
const semver_1 = tslib_1.__importDefault(require("semver"));
const TransactionBuilder_js_1 = require("./lib/TransactionBuilder/TransactionBuilder.js");
const trx_js_1 = require("./lib/trx.js");
const index_js_3 = require("./lib/contract/index.js");
const plugin_js_1 = require("./lib/plugin.js");
const event_js_1 = require("./lib/event.js");
const ethersUtils_js_1 = require("./utils/ethersUtils.js");
const address_js_1 = require("./utils/address.js");
const validations_js_1 = require("./utils/validations.js");
const DEFAULT_VERSION = '4.7.1';
const FEE_LIMIT = 150000000;
const version = '6.0.0';
function isValidOptions(options) {
return (!!options &&
typeof options === 'object' &&
(!!options.fullNode || !!options.fullHost));
}
class TronWeb extends eventemitter3_1.default {
providers;
BigNumber;
transactionBuilder;
trx;
plugin;
event;
version;
static version = version;
utils;
defaultBlock;
defaultPrivateKey;
defaultAddress;
fullnodeVersion;
feeLimit;
fullNode;
solidityNode;
eventServer;
constructor(options, solidityNode = '', eventServer, privateKey = '') {
super();
let fullNode;
let headers = false;
let eventHeaders = false;
if (isValidOptions(options)) {
fullNode = options.fullNode || options.fullHost;
solidityNode = (options.solidityNode || options.fullHost);
eventServer = (options.eventServer || options.fullHost);
headers = options.headers || false;
eventHeaders = options.eventHeaders || headers;
privateKey = options.privateKey;
}
else {
fullNode = options;
}
if (index_js_2.default.isString(fullNode))
fullNode = new index_js_1.providers.HttpProvider(fullNode);
if (index_js_2.default.isString(solidityNode))
solidityNode = new index_js_1.providers.HttpProvider(solidityNode);
if (index_js_2.default.isString(eventServer))
eventServer = new index_js_1.providers.HttpProvider(eventServer);
this.event = new event_js_1.Event(this);
this.transactionBuilder = new TransactionBuilder_js_1.TransactionBuilder(this);
this.trx = new trx_js_1.Trx(this);
this.plugin = new plugin_js_1.Plugin(this, {
disablePlugins: isValidOptions(options) ? options.disablePlugins : false,
});
this.utils = index_js_2.default;
this.setFullNode(fullNode);
this.setSolidityNode(solidityNode);
this.setEventServer(eventServer);
this.providers = index_js_1.providers;
this.BigNumber = bignumber_js_1.BigNumber;
this.defaultBlock = false;
this.defaultPrivateKey = false;
this.defaultAddress = {
hex: false,
base58: false,
};
this.version = TronWeb.version;
this.sha3 = TronWeb.sha3;
this.fromUtf8 = TronWeb.fromUtf8;
this.address = TronWeb.address;
this.toAscii = TronWeb.toAscii;
this.toUtf8 = TronWeb.toUtf8;
this.isAddress = TronWeb.isAddress;
this.fromAscii = TronWeb.fromAscii;
this.toHex = TronWeb.toHex;
this.toBigNumber = TronWeb.toBigNumber;
this.toDecimal = TronWeb.toDecimal;
this.fromDecimal = TronWeb.fromDecimal;
this.toSun = TronWeb.toSun;
this.fromSun = TronWeb.fromSun;
this.createAccount = TronWeb.createAccount;
this.createRandom = TronWeb.createRandom;
this.fromMnemonic = TronWeb.fromMnemonic;
if (privateKey)
this.setPrivateKey(privateKey);
this.fullnodeVersion = DEFAULT_VERSION;
this.feeLimit = FEE_LIMIT;
if (headers) {
this.setFullNodeHeader(headers);
}
if (eventHeaders) {
this.setEventHeader(eventHeaders);
}
}
async getFullnodeVersion() {
try {
const nodeInfo = await this.trx.getNodeInfo();
this.fullnodeVersion = nodeInfo.configNodeInfo.codeVersion;
if (this.fullnodeVersion.split('.').length === 2) {
this.fullnodeVersion += '.0';
}
}
catch (err) {
this.fullnodeVersion = DEFAULT_VERSION;
}
}
setDefaultBlock(blockID = false) {
if ([false, 'latest', 'earliest', 0].includes(blockID)) {
return (this.defaultBlock = blockID);
}
if (!index_js_2.default.isInteger(blockID) || !blockID)
throw new Error('Invalid block ID provided');
return (this.defaultBlock = Math.abs(blockID));
}
setPrivateKey(privateKey) {
try {
this.setAddress(TronWeb.address.fromPrivateKey(privateKey));
}
catch {
throw new Error('Invalid private key provided');
}
this.defaultPrivateKey = privateKey;
this.emit('privateKeyChanged', privateKey);
}
setAddress(address) {
if (!TronWeb.isAddress(address))
throw new Error('Invalid address provided');
const hex = TronWeb.address.toHex(address);
const base58 = TronWeb.address.fromHex(address);
if (this.defaultPrivateKey && TronWeb.address.fromPrivateKey(this.defaultPrivateKey) !== base58)
this.defaultPrivateKey = false;
this.defaultAddress = {
hex,
base58,
};
this.emit('addressChanged', { hex, base58 });
}
fullnodeSatisfies(version) {
return semver_1.default.satisfies(this.fullnodeVersion, version);
}
isValidProvider(provider) {
return Object.values(index_js_1.providers).some((knownProvider) => provider instanceof knownProvider);
}
setFullNode(fullNode) {
if ((0, validations_js_1.isString)(fullNode))
fullNode = new index_js_1.providers.HttpProvider(fullNode);
if (!this.isValidProvider(fullNode))
throw new Error('Invalid full node provided');
this.fullNode = fullNode;
this.fullNode.setStatusPage('wallet/getnowblock');
}
setSolidityNode(solidityNode) {
if (index_js_2.default.isString(solidityNode))
solidityNode = new index_js_1.providers.HttpProvider(solidityNode);
if (!this.isValidProvider(solidityNode))
throw new Error('Invalid solidity node provided');
this.solidityNode = solidityNode;
this.solidityNode.setStatusPage('walletsolidity/getnowblock');
}
setEventServer(eventServer, healthcheck) {
this.event.setServer(eventServer, healthcheck);
}
setHeader(headers = {}) {
const fullNode = new index_js_1.providers.HttpProvider(this.fullNode.host, 30000, '', '', headers);
const solidityNode = new index_js_1.providers.HttpProvider(this.solidityNode.host, 30000, '', '', headers);
const eventServer = new index_js_1.providers.HttpProvider(this.eventServer.host, 30000, '', '', headers);
this.setFullNode(fullNode);
this.setSolidityNode(solidityNode);
this.setEventServer(eventServer);
}
setFullNodeHeader(headers = {}) {
const fullNode = new index_js_1.providers.HttpProvider(this.fullNode.host, 30000, '', '', headers);
const solidityNode = new index_js_1.providers.HttpProvider(this.solidityNode.host, 30000, '', '', headers);
this.setFullNode(fullNode);
this.setSolidityNode(solidityNode);
}
setEventHeader(headers = {}) {
const eventServer = new index_js_1.providers.HttpProvider(this.eventServer.host, 30000, '', '', headers);
this.setEventServer(eventServer);
}
currentProviders() {
return {
fullNode: this.fullNode,
solidityNode: this.solidityNode,
eventServer: this.eventServer,
};
}
currentProvider() {
return this.currentProviders();
}
getEventResult(...params) {
return this.event.getEventsByContractAddress(...params);
}
getEventByTransactionID(...params) {
return this.event.getEventsByTransactionID(...params);
}
contract(abi = [], address) {
return new index_js_3.Contract(this, abi, address);
}
address;
static get address() {
return {
fromHex(address) {
return (0, address_js_1.fromHex)(address);
},
toHex(address) {
return (0, address_js_1.toHex)(address);
},
toChecksumAddress(address) {
return (0, address_js_1.toChecksumAddress)(address);
},
isChecksumAddress(address) {
return (0, address_js_1.isChecksumAddress)(address);
},
fromPrivateKey(privateKey, strict = false) {
return (0, address_js_1.fromPrivateKey)(privateKey, strict);
},
};
}
sha3;
static sha3(string, prefix = true) {
return (prefix ? '0x' : '') + (0, ethersUtils_js_1.keccak256)(Buffer.from(string, 'utf-8')).toString().substring(2);
}
toHex;
static toHex(val) {
if (index_js_2.default.isBoolean(val))
return TronWeb.fromDecimal(+val);
if (index_js_2.default.isBigNumber(val))
return TronWeb.fromDecimal(val);
if (typeof val === 'object')
return TronWeb.fromUtf8(JSON.stringify(val));
if (index_js_2.default.isString(val)) {
if (/^(-|)0x/.test(val))
return val;
// eslint-disable-next-line @typescript-eslint/ban-ts-comment
// @ts-ignore
if (!isFinite(val) || /^\s*$/.test(val))
return TronWeb.fromUtf8(val);
}
const result = TronWeb.fromDecimal(val);
if (result === '0xNaN') {
throw new Error('The passed value is not convertible to a hex string');
}
else {
return result;
}
}
toUtf8;
static toUtf8(hex) {
if (index_js_2.default.isHex(hex)) {
hex = hex.replace(/^0x/, '');
return Buffer.from(hex, 'hex').toString('utf8');
}
else {
throw new Error('The passed value is not a valid hex string');
}
}
fromUtf8;
static fromUtf8(string) {
if (!index_js_2.default.isString(string)) {
throw new Error('The passed value is not a valid utf-8 string');
}
return '0x' + Buffer.from(string, 'utf8').toString('hex');
}
toAscii;
static toAscii(hex) {
if (index_js_2.default.isHex(hex)) {
let str = '';
let i = 0;
const l = hex.length;
if (hex.substring(0, 2) === '0x') {
i = 2;
}
for (; i < l; i += 2) {
const code = parseInt(hex.substr(i, 2), 16);
str += String.fromCharCode(code);
}
return str;
}
else {
throw new Error('The passed value is not a valid hex string');
}
}
fromAscii;
static fromAscii(string, padding) {
if (!index_js_2.default.isString(string)) {
throw new Error('The passed value is not a valid utf-8 string');
}
return '0x' + Buffer.from(string, 'ascii').toString('hex').padEnd(padding, '0');
}
toDecimal;
static toDecimal(value) {
return TronWeb.toBigNumber(value).toNumber();
}
fromDecimal;
static fromDecimal(value) {
const number = TronWeb.toBigNumber(value);
const result = number.toString(16);
return number.isLessThan(0) ? '-0x' + result.substr(1) : '0x' + result;
}
fromSun;
static fromSun(sun) {
const trx = TronWeb.toBigNumber(sun).div(1_000_000);
return index_js_2.default.isBigNumber(sun) ? trx : trx.toString(10);
}
toSun;
static toSun(trx) {
const sun = TronWeb.toBigNumber(trx).times(1_000_000);
return index_js_2.default.isBigNumber(trx) ? sun : sun.toString(10);
}
toBigNumber;
static toBigNumber(amount = 0) {
if (index_js_2.default.isBigNumber(amount))
return amount;
if (index_js_2.default.isString(amount) && /^(-|)0x/.test(amount))
return new bignumber_js_1.BigNumber(amount.replace('0x', ''), 16);
return new bignumber_js_1.BigNumber(amount.toString(10), 10);
}
isAddress;
static isAddress(address = '') {
return (0, address_js_1.isAddress)(address);
}
createAccount;
static async createAccount() {
const account = index_js_2.default.accounts.generateAccount();
return account;
}
createRandom;
static createRandom(...params) {
const account = index_js_2.default.accounts.generateRandom(...params);
return account;
}
fromMnemonic;
static fromMnemonic(...params) {
const account = index_js_2.default.accounts.generateAccountWithMnemonic(...params);
return account;
}
async isConnected() {
return {
fullNode: await this.fullNode.isConnected(),
solidityNode: await this.solidityNode.isConnected(),
eventServer: this.eventServer && (await this.eventServer.isConnected()),
};
}
}
exports.TronWeb = TronWeb;
exports.default = TronWeb;
//# sourceMappingURL=tronweb.js.map