essential-eth 0.9.1 → 0.9.2-beta.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/essential-eth.esm.mjs +2 -0
- package/dist/essential-eth.esm.mjs.map +1 -0
- package/dist/essential-eth.js +2 -0
- package/dist/essential-eth.js.map +1 -0
- package/dist/essential-eth.modern.mjs +2 -0
- package/dist/essential-eth.modern.mjs.map +1 -0
- package/dist/essential-eth.umd.js +2 -0
- package/dist/essential-eth.umd.js.map +1 -0
- package/dist/logger/package-version.d.ts +1 -0
- package/package.json +12 -13
- package/readme.md +1 -1
- package/dist/cjs/classes/Contract.js +0 -138
- package/dist/cjs/classes/test/Contract/crv-abi.js +0 -488
- package/dist/cjs/classes/test/Contract/ens-abi.js +0 -453
- package/dist/cjs/classes/test/Contract/fei-abi.js +0 -526
- package/dist/cjs/classes/test/Contract/foo-abi.js +0 -42
- package/dist/cjs/classes/test/Contract/uniswap-abi.js +0 -121
- package/dist/cjs/classes/utils/clean-block.js +0 -160
- package/dist/cjs/classes/utils/clean-log.js +0 -37
- package/dist/cjs/classes/utils/clean-transaction-receipt.js +0 -51
- package/dist/cjs/classes/utils/clean-transaction.js +0 -52
- package/dist/cjs/classes/utils/encode-decode-transaction.js +0 -177
- package/dist/cjs/classes/utils/fetchers.js +0 -94
- package/dist/cjs/classes/utils/hex-to-decimal.js +0 -24
- package/dist/cjs/classes/utils/prepare-transaction.js +0 -45
- package/dist/cjs/index.js +0 -56
- package/dist/cjs/index.umd.js +0 -2
- package/dist/cjs/index.umd.js.map +0 -1
- package/dist/cjs/logger/logger.js +0 -36
- package/dist/cjs/logger/package-version.d.ts +0 -1
- package/dist/cjs/logger/package-version.js +0 -5
- package/dist/cjs/providers/AlchemyProvider.js +0 -11
- package/dist/cjs/providers/BaseProvider.js +0 -549
- package/dist/cjs/providers/FallthroughProvider.js +0 -73
- package/dist/cjs/providers/JsonRpcProvider.js +0 -46
- package/dist/cjs/providers/test/json-rpc-provider/get-logs/mocks.js +0 -152
- package/dist/cjs/providers/test/mock-of.js +0 -12
- package/dist/cjs/providers/test/rpc-urls.js +0 -25
- package/dist/cjs/providers/utils/chains-info.js +0 -71
- package/dist/cjs/shared/tiny-big/helpers.js +0 -97
- package/dist/cjs/shared/tiny-big/tiny-big.js +0 -101
- package/dist/cjs/shared/validate-type.js +0 -9
- package/dist/cjs/types/Block.types.js +0 -2
- package/dist/cjs/types/Contract.types.js +0 -2
- package/dist/cjs/types/FeeData.types.js +0 -2
- package/dist/cjs/types/Filter.types.js +0 -2
- package/dist/cjs/types/Network.types.js +0 -2
- package/dist/cjs/types/Transaction.types.js +0 -2
- package/dist/cjs/utils/bytes.js +0 -711
- package/dist/cjs/utils/compute-address.js +0 -34
- package/dist/cjs/utils/compute-public-key.js +0 -26
- package/dist/cjs/utils/ether-to-gwei.js +0 -35
- package/dist/cjs/utils/ether-to-wei.js +0 -35
- package/dist/cjs/utils/gwei-to-ether.js +0 -35
- package/dist/cjs/utils/hash-message.js +0 -30
- package/dist/cjs/utils/is-address.js +0 -39
- package/dist/cjs/utils/keccak256.js +0 -31
- package/dist/cjs/utils/solidity-keccak256.js +0 -138
- package/dist/cjs/utils/split-signature.js +0 -163
- package/dist/cjs/utils/to-checksum-address.js +0 -46
- package/dist/cjs/utils/to-utf8-bytes.js +0 -21
- package/dist/cjs/utils/wei-to-ether.js +0 -45
- package/dist/esm/classes/Contract.d.ts +0 -11
- package/dist/esm/classes/Contract.js +0 -61
- package/dist/esm/classes/test/Contract/crv-abi.d.ts +0 -2
- package/dist/esm/classes/test/Contract/crv-abi.js +0 -470
- package/dist/esm/classes/test/Contract/ens-abi.d.ts +0 -2
- package/dist/esm/classes/test/Contract/ens-abi.js +0 -435
- package/dist/esm/classes/test/Contract/fei-abi.d.ts +0 -2
- package/dist/esm/classes/test/Contract/fei-abi.js +0 -521
- package/dist/esm/classes/test/Contract/foo-abi.d.ts +0 -2
- package/dist/esm/classes/test/Contract/foo-abi.js +0 -33
- package/dist/esm/classes/test/Contract/uniswap-abi.d.ts +0 -2
- package/dist/esm/classes/test/Contract/uniswap-abi.js +0 -116
- package/dist/esm/classes/utils/clean-block.d.ts +0 -2
- package/dist/esm/classes/utils/clean-block.js +0 -35
- package/dist/esm/classes/utils/clean-log.d.ts +0 -2
- package/dist/esm/classes/utils/clean-log.js +0 -26
- package/dist/esm/classes/utils/clean-transaction-receipt.d.ts +0 -2
- package/dist/esm/classes/utils/clean-transaction-receipt.js +0 -35
- package/dist/esm/classes/utils/clean-transaction.d.ts +0 -2
- package/dist/esm/classes/utils/clean-transaction.js +0 -34
- package/dist/esm/classes/utils/encode-decode-transaction.d.ts +0 -4
- package/dist/esm/classes/utils/encode-decode-transaction.js +0 -134
- package/dist/esm/classes/utils/fetchers.d.ts +0 -15
- package/dist/esm/classes/utils/fetchers.js +0 -46
- package/dist/esm/classes/utils/hex-to-decimal.d.ts +0 -1
- package/dist/esm/classes/utils/hex-to-decimal.js +0 -3
- package/dist/esm/classes/utils/prepare-transaction.d.ts +0 -2
- package/dist/esm/classes/utils/prepare-transaction.js +0 -34
- package/dist/esm/index.d.ts +0 -25
- package/dist/esm/index.js +0 -20
- package/dist/esm/logger/logger.d.ts +0 -11
- package/dist/esm/logger/logger.js +0 -33
- package/dist/esm/logger/package-version.d.ts +0 -1
- package/dist/esm/logger/package-version.js +0 -1
- package/dist/esm/providers/AlchemyProvider.d.ts +0 -4
- package/dist/esm/providers/AlchemyProvider.js +0 -7
- package/dist/esm/providers/BaseProvider.d.ts +0 -26
- package/dist/esm/providers/BaseProvider.js +0 -172
- package/dist/esm/providers/FallthroughProvider.d.ts +0 -11
- package/dist/esm/providers/FallthroughProvider.js +0 -49
- package/dist/esm/providers/JsonRpcProvider.d.ts +0 -7
- package/dist/esm/providers/JsonRpcProvider.js +0 -15
- package/dist/esm/providers/test/json-rpc-provider/get-logs/mocks.d.ts +0 -14
- package/dist/esm/providers/test/json-rpc-provider/get-logs/mocks.js +0 -142
- package/dist/esm/providers/test/mock-of.d.ts +0 -2
- package/dist/esm/providers/test/mock-of.js +0 -1
- package/dist/esm/providers/test/rpc-urls.d.ts +0 -12
- package/dist/esm/providers/test/rpc-urls.js +0 -19
- package/dist/esm/providers/utils/chains-info.d.ts +0 -24
- package/dist/esm/providers/utils/chains-info.js +0 -67
- package/dist/esm/shared/tiny-big/helpers.d.ts +0 -1
- package/dist/esm/shared/tiny-big/helpers.js +0 -58
- package/dist/esm/shared/tiny-big/tiny-big.d.ts +0 -10
- package/dist/esm/shared/tiny-big/tiny-big.js +0 -45
- package/dist/esm/shared/validate-type.d.ts +0 -3
- package/dist/esm/shared/validate-type.js +0 -5
- package/dist/esm/types/Block.types.d.ts +0 -40
- package/dist/esm/types/Block.types.js +0 -1
- package/dist/esm/types/Contract.types.d.ts +0 -24
- package/dist/esm/types/Contract.types.js +0 -1
- package/dist/esm/types/FeeData.types.d.ts +0 -7
- package/dist/esm/types/FeeData.types.js +0 -1
- package/dist/esm/types/Filter.types.d.ts +0 -12
- package/dist/esm/types/Filter.types.js +0 -1
- package/dist/esm/types/Network.types.d.ts +0 -5
- package/dist/esm/types/Network.types.js +0 -1
- package/dist/esm/types/Transaction.types.d.ts +0 -113
- package/dist/esm/types/Transaction.types.js +0 -1
- package/dist/esm/utils/bytes.d.ts +0 -40
- package/dist/esm/utils/bytes.js +0 -245
- package/dist/esm/utils/compute-address.d.ts +0 -1
- package/dist/esm/utils/compute-address.js +0 -12
- package/dist/esm/utils/compute-public-key.d.ts +0 -2
- package/dist/esm/utils/compute-public-key.js +0 -6
- package/dist/esm/utils/ether-to-gwei.d.ts +0 -3
- package/dist/esm/utils/ether-to-gwei.js +0 -7
- package/dist/esm/utils/ether-to-wei.d.ts +0 -3
- package/dist/esm/utils/ether-to-wei.js +0 -7
- package/dist/esm/utils/gwei-to-ether.d.ts +0 -3
- package/dist/esm/utils/gwei-to-ether.js +0 -7
- package/dist/esm/utils/hash-message.d.ts +0 -2
- package/dist/esm/utils/hash-message.js +0 -14
- package/dist/esm/utils/is-address.d.ts +0 -1
- package/dist/esm/utils/is-address.js +0 -12
- package/dist/esm/utils/keccak256.d.ts +0 -2
- package/dist/esm/utils/keccak256.js +0 -13
- package/dist/esm/utils/solidity-keccak256.d.ts +0 -2
- package/dist/esm/utils/solidity-keccak256.js +0 -85
- package/dist/esm/utils/split-signature.d.ts +0 -2
- package/dist/esm/utils/split-signature.js +0 -126
- package/dist/esm/utils/to-checksum-address.d.ts +0 -1
- package/dist/esm/utils/to-checksum-address.js +0 -25
- package/dist/esm/utils/to-utf8-bytes.d.ts +0 -1
- package/dist/esm/utils/to-utf8-bytes.js +0 -3
- package/dist/esm/utils/wei-to-ether.d.ts +0 -3
- package/dist/esm/utils/wei-to-ether.js +0 -16
- /package/dist/{cjs/classes → classes}/Contract.d.ts +0 -0
- /package/dist/{cjs/classes → classes}/test/Contract/crv-abi.d.ts +0 -0
- /package/dist/{cjs/classes → classes}/test/Contract/ens-abi.d.ts +0 -0
- /package/dist/{cjs/classes → classes}/test/Contract/fei-abi.d.ts +0 -0
- /package/dist/{cjs/classes → classes}/test/Contract/foo-abi.d.ts +0 -0
- /package/dist/{cjs/classes → classes}/test/Contract/uniswap-abi.d.ts +0 -0
- /package/dist/{cjs/classes → classes}/utils/clean-block.d.ts +0 -0
- /package/dist/{cjs/classes → classes}/utils/clean-log.d.ts +0 -0
- /package/dist/{cjs/classes → classes}/utils/clean-transaction-receipt.d.ts +0 -0
- /package/dist/{cjs/classes → classes}/utils/clean-transaction.d.ts +0 -0
- /package/dist/{cjs/classes → classes}/utils/encode-decode-transaction.d.ts +0 -0
- /package/dist/{cjs/classes → classes}/utils/fetchers.d.ts +0 -0
- /package/dist/{cjs/classes → classes}/utils/hex-to-decimal.d.ts +0 -0
- /package/dist/{cjs/classes → classes}/utils/prepare-transaction.d.ts +0 -0
- /package/dist/{cjs/index.d.ts → index.d.ts} +0 -0
- /package/dist/{cjs/logger → logger}/logger.d.ts +0 -0
- /package/dist/{cjs/providers → providers}/AlchemyProvider.d.ts +0 -0
- /package/dist/{cjs/providers → providers}/BaseProvider.d.ts +0 -0
- /package/dist/{cjs/providers → providers}/FallthroughProvider.d.ts +0 -0
- /package/dist/{cjs/providers → providers}/JsonRpcProvider.d.ts +0 -0
- /package/dist/{cjs/providers → providers}/test/json-rpc-provider/get-logs/mocks.d.ts +0 -0
- /package/dist/{cjs/providers → providers}/test/mock-of.d.ts +0 -0
- /package/dist/{cjs/providers → providers}/test/rpc-urls.d.ts +0 -0
- /package/dist/{cjs/providers → providers}/utils/chains-info.d.ts +0 -0
- /package/dist/{cjs/shared → shared}/tiny-big/helpers.d.ts +0 -0
- /package/dist/{cjs/shared → shared}/tiny-big/tiny-big.d.ts +0 -0
- /package/dist/{cjs/shared → shared}/validate-type.d.ts +0 -0
- /package/dist/{cjs/types → types}/Block.types.d.ts +0 -0
- /package/dist/{cjs/types → types}/Contract.types.d.ts +0 -0
- /package/dist/{cjs/types → types}/FeeData.types.d.ts +0 -0
- /package/dist/{cjs/types → types}/Filter.types.d.ts +0 -0
- /package/dist/{cjs/types → types}/Network.types.d.ts +0 -0
- /package/dist/{cjs/types → types}/Transaction.types.d.ts +0 -0
- /package/dist/{cjs/utils → utils}/bytes.d.ts +0 -0
- /package/dist/{cjs/utils → utils}/compute-address.d.ts +0 -0
- /package/dist/{cjs/utils → utils}/compute-public-key.d.ts +0 -0
- /package/dist/{cjs/utils → utils}/ether-to-gwei.d.ts +0 -0
- /package/dist/{cjs/utils → utils}/ether-to-wei.d.ts +0 -0
- /package/dist/{cjs/utils → utils}/gwei-to-ether.d.ts +0 -0
- /package/dist/{cjs/utils → utils}/hash-message.d.ts +0 -0
- /package/dist/{cjs/utils → utils}/is-address.d.ts +0 -0
- /package/dist/{cjs/utils → utils}/keccak256.d.ts +0 -0
- /package/dist/{cjs/utils → utils}/solidity-keccak256.d.ts +0 -0
- /package/dist/{cjs/utils → utils}/split-signature.d.ts +0 -0
- /package/dist/{cjs/utils → utils}/to-checksum-address.d.ts +0 -0
- /package/dist/{cjs/utils → utils}/to-utf8-bytes.d.ts +0 -0
- /package/dist/{cjs/utils → utils}/wei-to-ether.d.ts +0 -0
|
@@ -1,36 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.logger = void 0;
|
|
4
|
-
const package_version_1 = require("./package-version");
|
|
5
|
-
class Logger {
|
|
6
|
-
constructor() {
|
|
7
|
-
this.packageVersion = package_version_1.version;
|
|
8
|
-
}
|
|
9
|
-
throwError(message, args) {
|
|
10
|
-
const argsLength = Object.keys(args).length;
|
|
11
|
-
throw new Error(`${message} (${Object.entries(args).map(([key, value], index) => `${key}=${value}${index < argsLength - 1 && ', '}`)}, version=essential-eth@${this.packageVersion})`);
|
|
12
|
-
}
|
|
13
|
-
throwArgumentError(message, arg, value) {
|
|
14
|
-
throw new Error(`${message} (argument="${arg}" value=${value}, version=essential-eth@${this.packageVersion})`);
|
|
15
|
-
}
|
|
16
|
-
checkSafeUint53(value, message = 'value not safe') {
|
|
17
|
-
if (typeof value !== 'number') {
|
|
18
|
-
return;
|
|
19
|
-
}
|
|
20
|
-
if (value < 0 || value >= 0x1fffffffffffff) {
|
|
21
|
-
this.throwError(message, {
|
|
22
|
-
operation: 'checkSafeInteger',
|
|
23
|
-
fault: 'out-of-safe-range',
|
|
24
|
-
value: value,
|
|
25
|
-
});
|
|
26
|
-
}
|
|
27
|
-
if (value % 1) {
|
|
28
|
-
this.throwError(message, {
|
|
29
|
-
operation: 'checkSafeInteger',
|
|
30
|
-
fault: 'non-integer',
|
|
31
|
-
value: value,
|
|
32
|
-
});
|
|
33
|
-
}
|
|
34
|
-
}
|
|
35
|
-
}
|
|
36
|
-
exports.logger = new Logger();
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
export declare const version = "0.9.1";
|
|
@@ -1,11 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.AlchemyProvider = void 0;
|
|
4
|
-
const JsonRpcProvider_1 = require("./JsonRpcProvider");
|
|
5
|
-
class AlchemyProvider extends JsonRpcProvider_1.JsonRpcProvider {
|
|
6
|
-
constructor(apiKey, network = 'mainnet') {
|
|
7
|
-
const alchemyUrl = `https://eth-${network}.alchemyapi.io/v2/${apiKey}`;
|
|
8
|
-
super(alchemyUrl);
|
|
9
|
-
}
|
|
10
|
-
}
|
|
11
|
-
exports.AlchemyProvider = AlchemyProvider;
|
|
@@ -1,549 +0,0 @@
|
|
|
1
|
-
"use strict";
|
|
2
|
-
var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
|
|
3
|
-
function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
|
|
4
|
-
return new (P || (P = Promise))(function (resolve, reject) {
|
|
5
|
-
function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
|
|
6
|
-
function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
|
|
7
|
-
function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
|
|
8
|
-
step((generator = generator.apply(thisArg, _arguments || [])).next());
|
|
9
|
-
});
|
|
10
|
-
};
|
|
11
|
-
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
12
|
-
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
13
|
-
};
|
|
14
|
-
Object.defineProperty(exports, "__esModule", { value: true });
|
|
15
|
-
exports.BaseProvider = void 0;
|
|
16
|
-
const clean_block_1 = require("../classes/utils/clean-block");
|
|
17
|
-
const clean_log_1 = require("../classes/utils/clean-log");
|
|
18
|
-
const clean_transaction_1 = require("../classes/utils/clean-transaction");
|
|
19
|
-
const clean_transaction_receipt_1 = require("../classes/utils/clean-transaction-receipt");
|
|
20
|
-
const fetchers_1 = require("../classes/utils/fetchers");
|
|
21
|
-
const hex_to_decimal_1 = require("../classes/utils/hex-to-decimal");
|
|
22
|
-
const prepare_transaction_1 = require("../classes/utils/prepare-transaction");
|
|
23
|
-
const logger_1 = require("../logger/logger");
|
|
24
|
-
const tiny_big_1 = require("../shared/tiny-big/tiny-big");
|
|
25
|
-
const chains_info_1 = __importDefault(require("./utils/chains-info"));
|
|
26
|
-
/**
|
|
27
|
-
* Converts a block tag into the right format when needed.
|
|
28
|
-
*
|
|
29
|
-
* * No equivalent in ethers.js
|
|
30
|
-
* * No equivalent in web3.js
|
|
31
|
-
*
|
|
32
|
-
* @internal
|
|
33
|
-
* @param blockTag the block tag to convert/return as a hex string
|
|
34
|
-
* @returns the specified block tag formatted as a hex string
|
|
35
|
-
* @example
|
|
36
|
-
* ```javascript
|
|
37
|
-
* prepBlockTag(14848183);
|
|
38
|
-
* // '0xe290b7'
|
|
39
|
-
* ```
|
|
40
|
-
* @example
|
|
41
|
-
* ```javascript
|
|
42
|
-
* prepBlockTag('0xe290b7');
|
|
43
|
-
* // '0xe290b7'
|
|
44
|
-
* ```
|
|
45
|
-
*/
|
|
46
|
-
function prepBlockTag(blockTag) {
|
|
47
|
-
return typeof blockTag === 'number'
|
|
48
|
-
? (0, tiny_big_1.tinyBig)(blockTag).toHexString()
|
|
49
|
-
: blockTag;
|
|
50
|
-
}
|
|
51
|
-
class BaseProvider {
|
|
52
|
-
/**
|
|
53
|
-
* @param rpcUrls The URL(s) to your Eth node(s). Consider POKT or Infura
|
|
54
|
-
* @example
|
|
55
|
-
* `https://free-eth-node.com/api/eth`
|
|
56
|
-
* @example
|
|
57
|
-
* `https://mainnet.infura.io/v3/YOUR-PROJECT-ID`
|
|
58
|
-
*/
|
|
59
|
-
constructor(rpcUrls) {
|
|
60
|
-
/**
|
|
61
|
-
* @ignore
|
|
62
|
-
*/
|
|
63
|
-
this._rpcUrls = [];
|
|
64
|
-
/**
|
|
65
|
-
* @ignore
|
|
66
|
-
*/
|
|
67
|
-
this._post = (body) => (0, fetchers_1.post)(this.selectRpcUrl(), body);
|
|
68
|
-
this._rpcUrls = rpcUrls;
|
|
69
|
-
}
|
|
70
|
-
/**
|
|
71
|
-
* Gets information (name, chainId, and ensAddress when applicable) about the network the provider is connected to.
|
|
72
|
-
*
|
|
73
|
-
* * [Identical](/docs/api#isd) to [`ethers.provider.getNetwork`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getNetwork) in ethers.js
|
|
74
|
-
* * [Similar](/docs/api#isd) to [`web3.eth.getChainId`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getchainid) in web3.js, returns more than just the `chainId`
|
|
75
|
-
*
|
|
76
|
-
* @returns information about the network this provider is currently connected to
|
|
77
|
-
* @example
|
|
78
|
-
* ```javascript
|
|
79
|
-
* jsonRpcProvider('https://free-eth-node.com/api/eth').getNetwork();
|
|
80
|
-
* // { chainId: 1, name: 'eth', ensAddress: '0x00000000000C2E074eC69A0dFb2997BA6C7d2e1e' }
|
|
81
|
-
* ```
|
|
82
|
-
* @example
|
|
83
|
-
* ```javascript
|
|
84
|
-
* jsonRpcProvider('https://free-eth-node.com/api/MATIC').getNetwork();
|
|
85
|
-
* // { chainId: 137, name: 'MATIC', ensAddress: null }
|
|
86
|
-
* ```
|
|
87
|
-
*/
|
|
88
|
-
getNetwork() {
|
|
89
|
-
return __awaiter(this, void 0, void 0, function* () {
|
|
90
|
-
const hexChainId = (yield this.post((0, fetchers_1.buildRPCPostBody)('eth_chainId', [])));
|
|
91
|
-
const chainId = (0, hex_to_decimal_1.hexToDecimal)(hexChainId);
|
|
92
|
-
const info = chains_info_1.default[chainId];
|
|
93
|
-
return {
|
|
94
|
-
chainId: Number(chainId),
|
|
95
|
-
name: info[0] || 'unknown',
|
|
96
|
-
ensAddress: info[1] || null, // only send ensAddress if it exists
|
|
97
|
-
};
|
|
98
|
-
});
|
|
99
|
-
}
|
|
100
|
-
/**
|
|
101
|
-
* Gets the number of the most recently mined block on the network the provider is connected to.
|
|
102
|
-
*
|
|
103
|
-
* * [Identical](/docs/api#isd) to [`ethers.provider.getBlockNumber`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getBlockNumber) in ethers.js
|
|
104
|
-
* * [Identical](/docs/api#isd) to [`web3.eth.getBlockNumber`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getblocknumber) in web3.js
|
|
105
|
-
*
|
|
106
|
-
* @returns the number of the most recently mined block
|
|
107
|
-
* @example
|
|
108
|
-
* ```javascript
|
|
109
|
-
* await provider.getBlockNumber();
|
|
110
|
-
* // 1053312
|
|
111
|
-
* ```
|
|
112
|
-
*/
|
|
113
|
-
getBlockNumber() {
|
|
114
|
-
return __awaiter(this, void 0, void 0, function* () {
|
|
115
|
-
const currentBlockNumber = (yield this.post((0, fetchers_1.buildRPCPostBody)('eth_blockNumber', [])));
|
|
116
|
-
return Number((0, hex_to_decimal_1.hexToDecimal)(currentBlockNumber));
|
|
117
|
-
});
|
|
118
|
-
}
|
|
119
|
-
/**
|
|
120
|
-
* Gets information about a specified transaction, even if it hasn't been mined yet.
|
|
121
|
-
*
|
|
122
|
-
* * [Similar](/docs/api#isd) to [`ethers.provider.getTransaction`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getTransaction) in ethers.js, does not have `wait` method that waits until the transaction has been mined
|
|
123
|
-
* * [Similar](/docs/api#isd) to [`web3.eth.getTransaction`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#gettransaction) in web3.js, some information returned using different types
|
|
124
|
-
*
|
|
125
|
-
* @param transactionHash the hash of the transaction to get information about
|
|
126
|
-
* @returns information about the specified transaction
|
|
127
|
-
* @example
|
|
128
|
-
* ```javascript
|
|
129
|
-
* await provider.getTransaction('0x9014ae6ef92464338355a79e5150e542ff9a83e2323318b21f40d6a3e65b4789');
|
|
130
|
-
* // {
|
|
131
|
-
* // accessList: [],
|
|
132
|
-
* // blockHash: "0x876810a013dbcd140f6fd6048c1dc33abbb901f1f96b394c2fa63aef3cb40b5d",
|
|
133
|
-
* // blockNumber: 14578286,
|
|
134
|
-
* // chainId: 1,
|
|
135
|
-
* // from: "0xdfD9dE5f6FA60BD70636c0900752E93a6144AEd4",
|
|
136
|
-
* // gas: { TinyBig: 112163 },
|
|
137
|
-
* // gasPrice: { TinyBig: 48592426858 },
|
|
138
|
-
* // hash: "0x9014ae6ef92464338355a79e5150e542ff9a83e2323318b21f40d6a3e65b4789",
|
|
139
|
-
* // input: "0x83259f17000000000000000000000000000000000000000000...",
|
|
140
|
-
* // maxFeePerGas: { TinyBig: 67681261618 },
|
|
141
|
-
* // maxPriorityFeePerGas: { TinyBig: 1500000000 },
|
|
142
|
-
* // nonce: { TinyBig: 129 },
|
|
143
|
-
* // r: "0x59a7c15b12c18cd68d6c440963d959bff3e73831ffc938e75ecad07f7ee43fbc",
|
|
144
|
-
* // s: "0x1ebaf05f0d9273b16c2a7748b150a79d22533a8cd74552611cbe620fee3dcf1c",
|
|
145
|
-
* // to: "0x39B72d136ba3e4ceF35F48CD09587ffaB754DD8B",
|
|
146
|
-
* // transactionIndex: 29,
|
|
147
|
-
* // type: 2,
|
|
148
|
-
* // v: 0,
|
|
149
|
-
* // value: { TinyBig: 0 },
|
|
150
|
-
* // confirmations: 298140,
|
|
151
|
-
* // }
|
|
152
|
-
* ```
|
|
153
|
-
*/
|
|
154
|
-
getTransaction(transactionHash) {
|
|
155
|
-
return __awaiter(this, void 0, void 0, function* () {
|
|
156
|
-
const [rpcTransaction, blockNumber] = yield Promise.all([
|
|
157
|
-
this.post((0, fetchers_1.buildRPCPostBody)('eth_getTransactionByHash', [transactionHash])),
|
|
158
|
-
this.getBlock('latest'),
|
|
159
|
-
]);
|
|
160
|
-
const cleanedTransaction = (0, clean_transaction_1.cleanTransaction)(rpcTransaction);
|
|
161
|
-
// https://ethereum.stackexchange.com/questions/2881/how-to-get-the-transaction-confirmations-using-the-json-rpc
|
|
162
|
-
cleanedTransaction.confirmations =
|
|
163
|
-
blockNumber.number - cleanedTransaction.blockNumber + 1;
|
|
164
|
-
return cleanedTransaction;
|
|
165
|
-
});
|
|
166
|
-
}
|
|
167
|
-
/**
|
|
168
|
-
* Gives information about a transaction that has already been mined. Includes additional information beyond what's provided by [`getTransaction`](/docs/api/modules#gettransaction).
|
|
169
|
-
*
|
|
170
|
-
* * [Identical](/docs/api#isd) to [`ethers.provider.getTransactionReceipt`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getTransactionReceipt) in ethers.js
|
|
171
|
-
* * [Similar](/docs/api#isd) to [`web3.eth.getTransactionReceipt`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#gettransactionreceipt) in web3.js, some information returned using different types
|
|
172
|
-
*
|
|
173
|
-
* @param transactionHash the hash of the transaction to get information about
|
|
174
|
-
* @returns information about the specified transaction that has already been mined
|
|
175
|
-
* @example
|
|
176
|
-
* ```javascript
|
|
177
|
-
* await provider.getTransactionReceipt('0x9014ae6ef92464338355a79e5150e542ff9a83e2323318b21f40d6a3e65b4789');
|
|
178
|
-
* // {
|
|
179
|
-
* // blockHash: "0x876810a013dbcd140f6fd6048c1dc33abbb901f1f96b394c2fa63aef3cb40b5d",
|
|
180
|
-
* // blockNumber: 14578286,
|
|
181
|
-
* // contractAddress: null,
|
|
182
|
-
* // cumulativeGasUsed: { TinyBig: 3067973 },
|
|
183
|
-
* // effectiveGasPrice: { TinyBig: 48592426858 },
|
|
184
|
-
* // from: "0xdfD9dE5f6FA60BD70636c0900752E93a6144AEd4",
|
|
185
|
-
* // gasUsed: { TinyBig: 112163 },
|
|
186
|
-
* // logs: [
|
|
187
|
-
* // {
|
|
188
|
-
* // address: "0x0eDF9bc41Bbc1354c70e2107F80C42caE7FBBcA8",
|
|
189
|
-
* // blockHash: "0x876810a013dbcd140f6fd6048c1dc33abbb901f1f96b394c2fa63aef3cb40b5d",
|
|
190
|
-
* // blockNumber: 14578286,
|
|
191
|
-
* // data: "0x0000000000000000000000000000000000000000000003a12ec797b5484968c1",
|
|
192
|
-
* // logIndex: 42,
|
|
193
|
-
* // topics: [
|
|
194
|
-
* // "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
|
|
195
|
-
* // "0x00000000000000000000000039b72d136ba3e4cef35f48cd09587ffab754dd8b",
|
|
196
|
-
* // "0x000000000000000000000000dfd9de5f6fa60bd70636c0900752e93a6144aed4",
|
|
197
|
-
* // ],
|
|
198
|
-
* // transactionHash: "0x9014ae6ef92464338355a79e5150e542ff9a83e2323318b21f40d6a3e65b4789",
|
|
199
|
-
* // transactionIndex: 29,
|
|
200
|
-
* // },
|
|
201
|
-
* // {
|
|
202
|
-
* // address: "0x39B72d136ba3e4ceF35F48CD09587ffaB754DD8B",
|
|
203
|
-
* // blockHash: "0x876810a013dbcd140f6fd6048c1dc33abbb901f1f96b394c2fa63aef3cb40b5d",
|
|
204
|
-
* // blockNumber: 14578286,
|
|
205
|
-
* // data: "0x0000000000000000000000000000000000000000000003a12ec797b5484968c1",
|
|
206
|
-
* // logIndex: 43,
|
|
207
|
-
* // topics: [
|
|
208
|
-
* // "0x34fcbac0073d7c3d388e51312faf357774904998eeb8fca628b9e6f65ee1cbf7",
|
|
209
|
-
* // "0x000000000000000000000000dfd9de5f6fa60bd70636c0900752e93a6144aed4",
|
|
210
|
-
* // "0x0000000000000000000000000000000000000000000000000000000000000003",
|
|
211
|
-
* // ],
|
|
212
|
-
* // transactionHash: "0x9014ae6ef92464338355a79e5150e542ff9a83e2323318b21f40d6a3e65b4789",
|
|
213
|
-
* // transactionIndex: 29,
|
|
214
|
-
* // },
|
|
215
|
-
* // ],
|
|
216
|
-
* // logsBloom: "0x00000000000000000000000000000...",
|
|
217
|
-
* // status: 1,
|
|
218
|
-
* // to: "0x39B72d136ba3e4ceF35F48CD09587ffaB754DD8B",
|
|
219
|
-
* // transactionHash: "0x9014ae6ef92464338355a79e5150e542ff9a83e2323318b21f40d6a3e65b4789",
|
|
220
|
-
* // transactionIndex: 29,
|
|
221
|
-
* // type: 2,
|
|
222
|
-
* // byzantium: true,
|
|
223
|
-
* // confirmations: 298171,
|
|
224
|
-
* // }
|
|
225
|
-
* ```
|
|
226
|
-
*/
|
|
227
|
-
getTransactionReceipt(transactionHash) {
|
|
228
|
-
return __awaiter(this, void 0, void 0, function* () {
|
|
229
|
-
const [rpcTransaction, blockNumber] = yield Promise.all([
|
|
230
|
-
this.post((0, fetchers_1.buildRPCPostBody)('eth_getTransactionReceipt', [transactionHash])),
|
|
231
|
-
this.getBlock('latest'),
|
|
232
|
-
]);
|
|
233
|
-
const cleanedTransactionReceipt = (0, clean_transaction_receipt_1.cleanTransactionReceipt)(rpcTransaction);
|
|
234
|
-
cleanedTransactionReceipt.confirmations =
|
|
235
|
-
blockNumber.number - cleanedTransactionReceipt.blockNumber + 1;
|
|
236
|
-
return cleanedTransactionReceipt;
|
|
237
|
-
});
|
|
238
|
-
}
|
|
239
|
-
/**
|
|
240
|
-
* Returns the number of sent transactions by an address, from genesis (or as far back as a provider looks) up to specified block.
|
|
241
|
-
*
|
|
242
|
-
* * [Identical](/docs/api#isd) to [`ethers.provider.getTransactionCount`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getTransactionCount) in ethers.js
|
|
243
|
-
* * [Identical](/docs/api#isd) to [`web3.eth.getTransactionCount`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#gettransactioncount) in web3.js
|
|
244
|
-
*
|
|
245
|
-
* @param address the address to count number of sent transactions
|
|
246
|
-
* @param blockTag the block to count transactions up to, inclusive
|
|
247
|
-
* @returns the number of transactions sent by the specified address
|
|
248
|
-
* @example
|
|
249
|
-
* ```javascript
|
|
250
|
-
* await provider.getTransactionCount('0x71660c4005ba85c37ccec55d0c4493e66fe775d3');
|
|
251
|
-
* // 1060000
|
|
252
|
-
* ```
|
|
253
|
-
* @example
|
|
254
|
-
* ```javascript
|
|
255
|
-
* await provider.getTransactionCount('0x71660c4005ba85c37ccec55d0c4493e66fe775d3', 'latest');
|
|
256
|
-
* // 1060000
|
|
257
|
-
* ```
|
|
258
|
-
* @example
|
|
259
|
-
* ```javascript
|
|
260
|
-
* await provider.getTransactionCount('0x71660c4005ba85c37ccec55d0c4493e66fe775d3', 14649390);
|
|
261
|
-
* // 1053312
|
|
262
|
-
* ```
|
|
263
|
-
*/
|
|
264
|
-
getTransactionCount(address, blockTag = 'latest') {
|
|
265
|
-
return __awaiter(this, void 0, void 0, function* () {
|
|
266
|
-
blockTag = prepBlockTag(blockTag);
|
|
267
|
-
const transactionCount = (yield this.post((0, fetchers_1.buildRPCPostBody)('eth_getTransactionCount', [address, blockTag])));
|
|
268
|
-
return Number((0, hex_to_decimal_1.hexToDecimal)(transactionCount));
|
|
269
|
-
});
|
|
270
|
-
}
|
|
271
|
-
/**
|
|
272
|
-
* Gets information about a certain block, optionally with full transaction objects.
|
|
273
|
-
*
|
|
274
|
-
* * [Similar](/docs/api#isd) to [`ethers.provider.getBlock`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getLogs) in ethers.js, includes some additional information. Can also return block with full transaction objects, similar to [`ethers.providers.getBlockWithTransactions`]
|
|
275
|
-
* * [Identical](/docs/api#isd) to [`web3.eth.getBlock`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getpastlogs) in web3.js
|
|
276
|
-
*
|
|
277
|
-
* @param timeFrame The number, hash, or text-based description ('latest', 'earliest', or 'pending') of the block to collect information on.
|
|
278
|
-
* @param returnTransactionObjects Whether to also return data about the transactions on the block.
|
|
279
|
-
* @returns A BlockResponse object with information about the specified block
|
|
280
|
-
* @example
|
|
281
|
-
* ```javascript
|
|
282
|
-
* await provider.getBlock(14879862);
|
|
283
|
-
* // {
|
|
284
|
-
* // baseFeePerGas: { TinyBig: 39095728776 },
|
|
285
|
-
* // difficulty: { TinyBig: 14321294455359973 },
|
|
286
|
-
* // extraData: "0x486976656f6e2073672d6865617679",
|
|
287
|
-
* // gasLimit: { TinyBig: 29970620 },
|
|
288
|
-
* // gasUsed: { TinyBig: 20951384 },
|
|
289
|
-
* // hash: "0x563b458ec3c4f87393b53f70bdddc0058497109b784d8cacd9247ddf267049ab",
|
|
290
|
-
* // logsBloom:
|
|
291
|
-
* // "0x9f38794fe80b521794df6efad8b0d2e9582f9ec3959a3f9384bda0fa371cfa5fac5af9d515c6bdf1ec325f5b5f7ebdd6a3a9fae17b38a86d4dc4b0971afc68d8086640550f4c156e6f923f4a1bb94fb0bed6cdcc474c5c64bfeff7a4a906f72b9a7b94004ee58efc53d63ac66961acd3a431b2d896cc9fd75f6072960bced45f770587caf130f57504decfcb63c6ca8fbc5bdbd749edd5a99a7375d2b81872289adb775fb3c928259f4be39c6d3f4d5b6217822979bb88c1f1fb62429b1b6d41cf4e3f77f9e1db3f5723108f1e5b1255dd734ad8cdb11e7ea22487c788e67c83777b6f395e504ca59c64f52245ee6de3804cf809e5caa4f0ea6a9aa9eb6ed801",
|
|
292
|
-
* // miner: "0x1aD91ee08f21bE3dE0BA2ba6918E714dA6B45836",
|
|
293
|
-
* // mixHash: "0x73cc9419bfb89c9d41c3a8c34ce56b5ebe468bdcf870258d2e77262275d580ec",
|
|
294
|
-
* // nonce: "0x976f3f5d596ffb08",
|
|
295
|
-
* // number: 14879862,
|
|
296
|
-
* // parentHash: "0x95986ae14a71face8d9a6a379edd875b2e8bc73e4de0d9d460e7752bddb0f579",
|
|
297
|
-
* // receiptsRoot: "0x8e6ba2fd9bee602b653dae6e3132f16538c2c5df24f1df8c000392053f73defa",
|
|
298
|
-
* // sha3Uncles: "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
|
|
299
|
-
* // size: { TinyBig: 134483 },
|
|
300
|
-
* // stateRoot: "0xbf2bb67bd1c741f3d00904b8451d7c2cf4e3a2726f5a5884792ede2074747b85",
|
|
301
|
-
* // timestamp: { TinyBig: 1654016186 },
|
|
302
|
-
* // totalDifficulty: { TinyBig: 50478104614257705213748 },
|
|
303
|
-
* // transactions: [
|
|
304
|
-
* // "0xb3326a9149809603a2c28545e50e4f7d16e194bf5ee9764e0544603854c4a8d2",
|
|
305
|
-
* // "0x8b42095f8d335404a4896b2817b8e5e3d86a5a87cb434a8eec295d5280a7f48e",
|
|
306
|
-
* // "0x882f78fcb73f0f7ad0700bb0424a8b4beb366aaa93b88a3562c49a8d0ce4dcff",
|
|
307
|
-
* // ...
|
|
308
|
-
* // ],
|
|
309
|
-
* // transactionsRoot: "0x5934902f3dcc263ec34f24318179bf6301f53f4834685792066026f3a4849d72",
|
|
310
|
-
* // uncles: [],
|
|
311
|
-
* // }
|
|
312
|
-
* ```
|
|
313
|
-
*/
|
|
314
|
-
getBlock(timeFrame = 'latest', returnTransactionObjects = false) {
|
|
315
|
-
return __awaiter(this, void 0, void 0, function* () {
|
|
316
|
-
let type = 'Number';
|
|
317
|
-
if (typeof timeFrame === 'string' && timeFrame.length === 66) {
|
|
318
|
-
// use endpoint that accepts string
|
|
319
|
-
type = 'Hash';
|
|
320
|
-
}
|
|
321
|
-
else {
|
|
322
|
-
timeFrame = prepBlockTag(timeFrame);
|
|
323
|
-
}
|
|
324
|
-
const rpcBlock = (yield this.post((0, fetchers_1.buildRPCPostBody)(`eth_getBlockBy${type}`, [
|
|
325
|
-
timeFrame,
|
|
326
|
-
returnTransactionObjects,
|
|
327
|
-
])));
|
|
328
|
-
return (0, clean_block_1.cleanBlock)(rpcBlock, returnTransactionObjects);
|
|
329
|
-
});
|
|
330
|
-
}
|
|
331
|
-
/**
|
|
332
|
-
* Gives an estimate of the current gas price in wei.
|
|
333
|
-
*
|
|
334
|
-
* * [Similar](/docs/api#isd) to [`ethers.provider.getGasPrice`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getGasPrice) in ethers.js, does not have a parameter specifying what unit you'd like to return. See also [`weiToEther`](/docs/api/modules#weitoether) and [`etherToGwei`](/docs/api/modules#ethertogwei)
|
|
335
|
-
* * [Identical](/docs/api#isd) to [`web3.eth.getGasPrice`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getgasprice) in web3.js, returns a number (TinyBig) instead of a string
|
|
336
|
-
*
|
|
337
|
-
* @returns an estimate of the current gas price in wei
|
|
338
|
-
* @example
|
|
339
|
-
* ```javascript
|
|
340
|
-
* await provider.getGasPrice();
|
|
341
|
-
* // 52493941856
|
|
342
|
-
* ```
|
|
343
|
-
*/
|
|
344
|
-
getGasPrice() {
|
|
345
|
-
return __awaiter(this, void 0, void 0, function* () {
|
|
346
|
-
const hexGasPrice = (yield this.post((0, fetchers_1.buildRPCPostBody)('eth_gasPrice', [])));
|
|
347
|
-
return (0, tiny_big_1.tinyBig)((0, hex_to_decimal_1.hexToDecimal)(hexGasPrice));
|
|
348
|
-
});
|
|
349
|
-
}
|
|
350
|
-
/**
|
|
351
|
-
* Returns the balance of the account in wei.
|
|
352
|
-
*
|
|
353
|
-
* * [Identical](/docs/api#isd) to [`ethers.provider.getBalance`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getBalance) in ethers.js
|
|
354
|
-
* * [Identical](/docs/api#isd) to [`web3.eth.getBalance`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getbalance) in web3.js, returns a number (TinyBig) instead of a string
|
|
355
|
-
*
|
|
356
|
-
* @param address the address to check the balance of
|
|
357
|
-
* @param blockTag the block to check the specified address' balance on
|
|
358
|
-
* @returns the balance of the network's native token for the specified address on the specified block
|
|
359
|
-
* @example
|
|
360
|
-
* ```javascript
|
|
361
|
-
* await provider.getBalance('0x7cB57B5A97eAbe94205C07890BE4c1aD31E486A8');
|
|
362
|
-
* // 28798127851528138
|
|
363
|
-
* ```
|
|
364
|
-
*/
|
|
365
|
-
getBalance(address, blockTag = 'latest') {
|
|
366
|
-
return __awaiter(this, void 0, void 0, function* () {
|
|
367
|
-
blockTag = prepBlockTag(blockTag);
|
|
368
|
-
const hexBalance = (yield this.post((0, fetchers_1.buildRPCPostBody)('eth_getBalance', [address, blockTag])));
|
|
369
|
-
return (0, tiny_big_1.tinyBig)((0, hex_to_decimal_1.hexToDecimal)(hexBalance));
|
|
370
|
-
});
|
|
371
|
-
}
|
|
372
|
-
/**
|
|
373
|
-
* Gets the code of a contract on a specified block.
|
|
374
|
-
*
|
|
375
|
-
* * [Identical](/docs/api#isd) to [`ethers.provider.getCode`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getCode) in ethers.js
|
|
376
|
-
* * [Identical](/docs/api#isd) to [`web3.eth.getCode`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getcode) in web3.js
|
|
377
|
-
*
|
|
378
|
-
* @param address the contract address to get the contract code from
|
|
379
|
-
* @param blockTag the block height to search for the contract code from. Contract code can change, so this allows for checking a specific block
|
|
380
|
-
* @returns the contract creation code for the specified address at the specified block height
|
|
381
|
-
* @example
|
|
382
|
-
* ```javascript
|
|
383
|
-
* await jsonRpcProvider().getCode('0xaC6095720221C79C6E7C638d260A2eFBC5D8d880', 'latest');
|
|
384
|
-
* // '0x608060405234801561001057600080fd5b506004361061...'
|
|
385
|
-
* ```
|
|
386
|
-
*/
|
|
387
|
-
getCode(address, blockTag = 'latest') {
|
|
388
|
-
return __awaiter(this, void 0, void 0, function* () {
|
|
389
|
-
blockTag = prepBlockTag(blockTag);
|
|
390
|
-
const contractCode = (yield this.post((0, fetchers_1.buildRPCPostBody)('eth_getCode', [address, blockTag])));
|
|
391
|
-
return contractCode;
|
|
392
|
-
});
|
|
393
|
-
}
|
|
394
|
-
/**
|
|
395
|
-
* Returns an estimate of the amount of gas that would be required to submit transaction to the network.
|
|
396
|
-
* An estimate may not be accurate since there could be another transaction on the network that was not accounted for.
|
|
397
|
-
*
|
|
398
|
-
* * [Identical](/docs/api#isd) to [`ethers.provider.estimateGas`](https://docs.ethers.io/v5/api/providers/provider/#Provider-estimateGas) in ethers.js
|
|
399
|
-
* * [Identical](/docs/api#isd) to [`web3.eth.estimateGas`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#estimateGas) in web3.js
|
|
400
|
-
*
|
|
401
|
-
* @param transaction the transaction to check the estimated gas cost for
|
|
402
|
-
* @returns the estimated amount of gas charged for submitting the specified transaction to the blockchain
|
|
403
|
-
* @example
|
|
404
|
-
* ```javascript
|
|
405
|
-
* await provider.estimateGas({
|
|
406
|
-
* // Wrapped ETH address
|
|
407
|
-
* to: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
|
|
408
|
-
* data: "0xd0e30db0",
|
|
409
|
-
* value: etherToWei('1.0').toHexString(),
|
|
410
|
-
* });
|
|
411
|
-
* // { TinyBig: "27938" }
|
|
412
|
-
* ```
|
|
413
|
-
*/
|
|
414
|
-
estimateGas(transaction) {
|
|
415
|
-
return __awaiter(this, void 0, void 0, function* () {
|
|
416
|
-
const rpcTransaction = (0, prepare_transaction_1.prepareTransaction)(transaction);
|
|
417
|
-
const gasUsed = (yield this.post((0, fetchers_1.buildRPCPostBody)('eth_estimateGas', [rpcTransaction])));
|
|
418
|
-
return (0, tiny_big_1.tinyBig)((0, hex_to_decimal_1.hexToDecimal)(gasUsed));
|
|
419
|
-
});
|
|
420
|
-
}
|
|
421
|
-
/**
|
|
422
|
-
* Returns the current recommended FeeData to use in a transaction.
|
|
423
|
-
* For an EIP-1559 transaction, the maxFeePerGas and maxPriorityFeePerGas should be used.
|
|
424
|
-
* For legacy transactions and networks which do not support EIP-1559, the gasPrice should be used.Returns an estimate of the amount of gas that would be required to submit transaction to the network.
|
|
425
|
-
*
|
|
426
|
-
* * [Identical](/docs/api#isd) to [`ethers.provider.getFeeData`](https://docs.ethers.org/v5/api/providers/provider/#Provider-getFeeData) in ethers.js
|
|
427
|
-
*
|
|
428
|
-
* @returns an object with gas estimates for the network currently
|
|
429
|
-
* @example
|
|
430
|
-
* ```javascript
|
|
431
|
-
* await provider.getFeeData();
|
|
432
|
-
* // {
|
|
433
|
-
* // gasPrice: { TinyBig: "14184772639" },
|
|
434
|
-
* // lastBaseFeePerGas: { TinyBig: "14038523098" },
|
|
435
|
-
* // maxFeePerGas: { TinyBig: "29577046196" },
|
|
436
|
-
* // maxPriorityFeePerGas: { TinyBig: "1500000000" }
|
|
437
|
-
* // }
|
|
438
|
-
* ```
|
|
439
|
-
*/
|
|
440
|
-
getFeeData() {
|
|
441
|
-
return __awaiter(this, void 0, void 0, function* () {
|
|
442
|
-
const [block, gasPrice] = yield Promise.all([
|
|
443
|
-
this.getBlock('latest'),
|
|
444
|
-
this.getGasPrice(),
|
|
445
|
-
]);
|
|
446
|
-
let lastBaseFeePerGas = null, maxFeePerGas = null, maxPriorityFeePerGas = null;
|
|
447
|
-
if (block && block.baseFeePerGas) {
|
|
448
|
-
// We may want to compute this more accurately in the future,
|
|
449
|
-
// using the formula "check if the base fee is correct".
|
|
450
|
-
// See: https://eips.ethereum.org/EIPS/eip-1559
|
|
451
|
-
lastBaseFeePerGas = block.baseFeePerGas;
|
|
452
|
-
maxPriorityFeePerGas = (0, tiny_big_1.tinyBig)('1500000000');
|
|
453
|
-
maxFeePerGas = (0, tiny_big_1.tinyBig)(block.baseFeePerGas.mul(2).add(maxPriorityFeePerGas));
|
|
454
|
-
}
|
|
455
|
-
return { lastBaseFeePerGas, maxFeePerGas, maxPriorityFeePerGas, gasPrice };
|
|
456
|
-
});
|
|
457
|
-
}
|
|
458
|
-
/**
|
|
459
|
-
* Returns transaction receipt event logs that match a specified filter.
|
|
460
|
-
* May return `[]` if parameters are too broad, even if logs exist.
|
|
461
|
-
*
|
|
462
|
-
* * [Identical](/docs/api#isd) to [`ethers.provider.getLogs`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getLogs) in ethers.js
|
|
463
|
-
* * [Identical](/docs/api#isd) to [`web3.eth.getPastLogs`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getpastlogs) in web3.js
|
|
464
|
-
*
|
|
465
|
-
* @param filter parameters to filter the logs by
|
|
466
|
-
* @returns an array of logs matching the specified filter
|
|
467
|
-
* @example
|
|
468
|
-
* ```javascript
|
|
469
|
-
* provider.getLogs({
|
|
470
|
-
* address: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
|
|
471
|
-
* topics: [
|
|
472
|
-
* "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
|
|
473
|
-
* "0x00000000000000000000000021b8065d10f73ee2e260e5b47d3344d3ced7596e",
|
|
474
|
-
* ],
|
|
475
|
-
* fromBlock: 14825027,
|
|
476
|
-
* toBlock: 14825039,
|
|
477
|
-
* });
|
|
478
|
-
*
|
|
479
|
-
* [
|
|
480
|
-
* {
|
|
481
|
-
* address: '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2',
|
|
482
|
-
* blockHash: '0x8e0dfac2f704851960f866c8708b3bef2f66c0fee0329cf25ff0261b264ca6bc',
|
|
483
|
-
* blockNumber: 14825029,
|
|
484
|
-
* data: '0x000000000000000000000000000000000000000000000000005f862ee352a38a',
|
|
485
|
-
* logIndex: 384,
|
|
486
|
-
* removed: false,
|
|
487
|
-
* topics: [
|
|
488
|
-
* '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
|
|
489
|
-
* '0x00000000000000000000000021b8065d10f73ee2e260e5b47d3344d3ced7596e',
|
|
490
|
-
* '0x00000000000000000000000068b3465833fb72a70ecdf485e0e4c7bd8665fc45'
|
|
491
|
-
* ],
|
|
492
|
-
* transactionHash: '0xbd49031be16f8fd1775f4e0fe79b408ffd8ae9c65b2827ee47e3238e3f51f4c0',
|
|
493
|
-
* transactionIndex: 226
|
|
494
|
-
* }
|
|
495
|
-
* ]
|
|
496
|
-
* ```
|
|
497
|
-
*/
|
|
498
|
-
getLogs(filter) {
|
|
499
|
-
return __awaiter(this, void 0, void 0, function* () {
|
|
500
|
-
const filterByRange = filter;
|
|
501
|
-
if (filterByRange.fromBlock)
|
|
502
|
-
filterByRange.fromBlock = prepBlockTag(filterByRange.fromBlock);
|
|
503
|
-
if (filterByRange.toBlock)
|
|
504
|
-
filterByRange.toBlock = prepBlockTag(filterByRange.toBlock);
|
|
505
|
-
const rpcLogs = (yield this.post((0, fetchers_1.buildRPCPostBody)('eth_getLogs', [filter])));
|
|
506
|
-
const logs = rpcLogs.map((log) => (0, clean_log_1.cleanLog)(log, false));
|
|
507
|
-
return logs;
|
|
508
|
-
});
|
|
509
|
-
}
|
|
510
|
-
/**
|
|
511
|
-
* Returns the result of adding a transaction to the blockchain without actually adding that transaction to the blockchain.
|
|
512
|
-
* Does not require any ether as gas.
|
|
513
|
-
*
|
|
514
|
-
* * [Identical](/docs/api#isd) to [`ethers.provider.call`](https://docs.ethers.io/v5/api/providers/provider/#Provider-call) in ethers.js
|
|
515
|
-
* * [Identical](/docs/api#isd) to [`web3.eth.call`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#call) in web3.js
|
|
516
|
-
*
|
|
517
|
-
* @param transaction the transaction object to, in theory, execute. Doesn't actually get added to the blockchain.
|
|
518
|
-
* @param blockTag the block to execute this transaction on
|
|
519
|
-
* @returns the result of executing the transaction on the specified block
|
|
520
|
-
* @example
|
|
521
|
-
* ```javascript
|
|
522
|
-
* await provider.call({ to: "0x6b175474e89094c44da98b954eedeac495271d0f", data: "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE" });
|
|
523
|
-
* // '0x0000000000000000000000000000000000000000000000000858898f93629000'
|
|
524
|
-
* ```
|
|
525
|
-
*/
|
|
526
|
-
call(transaction, blockTag = 'latest') {
|
|
527
|
-
return __awaiter(this, void 0, void 0, function* () {
|
|
528
|
-
if (transaction.gasPrice &&
|
|
529
|
-
(transaction.maxPriorityFeePerGas || transaction.maxFeePerGas)) {
|
|
530
|
-
logger_1.logger.throwError('Cannot specify both "gasPrice" and ("maxPriorityFeePerGas" or "maxFeePerGas")', {
|
|
531
|
-
gasPrice: transaction.gasPrice,
|
|
532
|
-
maxFeePerGas: transaction.maxFeePerGas,
|
|
533
|
-
maxPriorityFeePerGas: transaction.maxPriorityFeePerGas,
|
|
534
|
-
});
|
|
535
|
-
}
|
|
536
|
-
if (transaction.maxFeePerGas && transaction.maxPriorityFeePerGas) {
|
|
537
|
-
logger_1.logger.throwError('Cannot specify both "maxFeePerGas" and "maxPriorityFeePerGas"', {
|
|
538
|
-
maxFeePerGas: transaction.maxFeePerGas,
|
|
539
|
-
maxPriorityFeePerGas: transaction.maxPriorityFeePerGas,
|
|
540
|
-
});
|
|
541
|
-
}
|
|
542
|
-
blockTag = prepBlockTag(blockTag);
|
|
543
|
-
const rpcTransaction = (0, prepare_transaction_1.prepareTransaction)(transaction);
|
|
544
|
-
const transactionRes = (yield this.post((0, fetchers_1.buildRPCPostBody)('eth_call', [rpcTransaction, blockTag])));
|
|
545
|
-
return transactionRes;
|
|
546
|
-
});
|
|
547
|
-
}
|
|
548
|
-
}
|
|
549
|
-
exports.BaseProvider = BaseProvider;
|