essential-eth 0.9.0 → 0.9.1-next.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.
Files changed (134) hide show
  1. package/dist/cjs/classes/Contract.js +66 -307
  2. package/dist/cjs/classes/test/Contract/crv-abi.js +256 -252
  3. package/dist/cjs/classes/test/Contract/ens-abi.d.ts +1 -1
  4. package/dist/cjs/classes/test/Contract/ens-abi.js +212 -497
  5. package/dist/cjs/classes/test/Contract/fei-abi.js +284 -605
  6. package/dist/cjs/classes/test/Contract/foo-abi.d.ts +1 -1
  7. package/dist/cjs/classes/test/Contract/foo-abi.js +21 -44
  8. package/dist/cjs/classes/test/Contract/uniswap-abi.js +68 -64
  9. package/dist/cjs/classes/utils/clean-block.js +30 -52
  10. package/dist/cjs/classes/utils/clean-log.js +20 -42
  11. package/dist/cjs/classes/utils/clean-transaction-receipt.js +30 -51
  12. package/dist/cjs/classes/utils/clean-transaction.js +30 -52
  13. package/dist/cjs/classes/utils/encode-decode-transaction.js +107 -148
  14. package/dist/cjs/classes/utils/fetchers.d.ts +8 -2
  15. package/dist/cjs/classes/utils/fetchers.js +52 -166
  16. package/dist/cjs/classes/utils/hex-to-decimal.js +6 -1
  17. package/dist/cjs/classes/utils/prepare-transaction.js +36 -59
  18. package/dist/cjs/index.d.ts +21 -22
  19. package/dist/cjs/index.js +56 -26
  20. package/dist/cjs/index.umd.js +1 -1
  21. package/dist/cjs/index.umd.js.map +1 -1
  22. package/dist/cjs/logger/logger.js +23 -79
  23. package/dist/cjs/logger/package-version.d.ts +1 -1
  24. package/dist/cjs/logger/package-version.js +4 -1
  25. package/dist/cjs/providers/AlchemyProvider.js +9 -82
  26. package/dist/cjs/providers/BaseProvider.js +511 -882
  27. package/dist/cjs/providers/FallthroughProvider.js +46 -123
  28. package/dist/cjs/providers/JsonRpcProvider.js +28 -93
  29. package/dist/cjs/providers/test/json-rpc-provider/get-logs/mocks.d.ts +14 -0
  30. package/dist/cjs/providers/test/json-rpc-provider/get-logs/mocks.js +152 -0
  31. package/dist/cjs/providers/test/mock-of.js +6 -8
  32. package/dist/cjs/providers/test/rpc-urls.d.ts +1 -0
  33. package/dist/cjs/providers/test/rpc-urls.js +23 -14
  34. package/dist/cjs/providers/utils/chains-info.d.ts +5 -448
  35. package/dist/cjs/providers/utils/chains-info.js +16 -1345
  36. package/dist/cjs/shared/tiny-big/helpers.js +42 -93
  37. package/dist/cjs/shared/tiny-big/tiny-big.js +72 -161
  38. package/dist/cjs/shared/validate-type.d.ts +1 -1
  39. package/dist/cjs/shared/validate-type.js +7 -7
  40. package/dist/cjs/types/Block.types.d.ts +3 -3
  41. package/dist/cjs/types/Block.types.js +2 -1
  42. package/dist/cjs/types/Contract.types.d.ts +4 -4
  43. package/dist/cjs/types/Contract.types.js +2 -1
  44. package/dist/cjs/types/FeeData.types.js +2 -1
  45. package/dist/cjs/types/Filter.types.js +2 -1
  46. package/dist/cjs/types/Network.types.js +2 -3
  47. package/dist/cjs/types/Transaction.types.d.ts +5 -5
  48. package/dist/cjs/types/Transaction.types.js +2 -1
  49. package/dist/cjs/utils/bytes.d.ts +4 -4
  50. package/dist/cjs/utils/bytes.js +318 -286
  51. package/dist/cjs/utils/compute-address.js +15 -8
  52. package/dist/cjs/utils/compute-public-key.js +10 -5
  53. package/dist/cjs/utils/ether-to-gwei.js +11 -10
  54. package/dist/cjs/utils/ether-to-wei.js +11 -10
  55. package/dist/cjs/utils/gwei-to-ether.js +11 -10
  56. package/dist/cjs/utils/hash-message.js +16 -11
  57. package/dist/cjs/utils/is-address.js +12 -8
  58. package/dist/cjs/utils/keccak256.js +14 -8
  59. package/dist/cjs/utils/solidity-keccak256.js +60 -49
  60. package/dist/cjs/utils/split-signature.js +73 -55
  61. package/dist/cjs/utils/to-checksum-address.js +20 -15
  62. package/dist/cjs/utils/to-utf8-bytes.js +6 -1
  63. package/dist/cjs/utils/wei-to-ether.js +15 -13
  64. package/dist/esm/classes/test/Contract/ens-abi.d.ts +1 -1
  65. package/dist/esm/classes/test/Contract/foo-abi.d.ts +1 -1
  66. package/dist/esm/classes/utils/fetchers.d.ts +8 -2
  67. package/dist/esm/classes/utils/fetchers.js +6 -3
  68. package/dist/esm/index.d.ts +21 -22
  69. package/dist/esm/index.js +16 -17
  70. package/dist/esm/logger/package-version.d.ts +1 -1
  71. package/dist/esm/logger/package-version.js +1 -1
  72. package/dist/esm/providers/FallthroughProvider.js +3 -3
  73. package/dist/esm/providers/test/json-rpc-provider/get-logs/mocks.d.ts +14 -0
  74. package/dist/esm/providers/test/json-rpc-provider/get-logs/mocks.js +142 -0
  75. package/dist/esm/providers/test/rpc-urls.d.ts +1 -0
  76. package/dist/esm/providers/test/rpc-urls.js +7 -4
  77. package/dist/esm/providers/utils/chains-info.d.ts +5 -448
  78. package/dist/esm/providers/utils/chains-info.js +13 -1344
  79. package/dist/esm/shared/validate-type.d.ts +1 -1
  80. package/dist/esm/types/Block.types.d.ts +3 -3
  81. package/dist/esm/types/Contract.types.d.ts +4 -4
  82. package/dist/esm/types/Transaction.types.d.ts +5 -5
  83. package/dist/esm/utils/bytes.d.ts +4 -4
  84. package/package.json +23 -51
  85. package/readme.md +15 -38
  86. package/dist/cjs/classes/test/Contract/crv.test.js +0 -690
  87. package/dist/cjs/classes/test/Contract/ens.test.js +0 -217
  88. package/dist/cjs/classes/test/Contract/fei.test.js +0 -224
  89. package/dist/cjs/classes/test/Contract/foo.test.js +0 -33
  90. package/dist/cjs/classes/test/Contract/uni.test.js +0 -387
  91. package/dist/cjs/providers/test/fallthrough-provider/get-gas-price.test.js +0 -228
  92. package/dist/cjs/providers/test/get-transaction-count.test.js +0 -276
  93. package/dist/cjs/providers/test/json-rpc-provider/call.test.js +0 -436
  94. package/dist/cjs/providers/test/json-rpc-provider/estimate-gas.test.js +0 -288
  95. package/dist/cjs/providers/test/json-rpc-provider/get-balance.test.js +0 -261
  96. package/dist/cjs/providers/test/json-rpc-provider/get-block-number.test.js +0 -159
  97. package/dist/cjs/providers/test/json-rpc-provider/get-block.test.js +0 -477
  98. package/dist/cjs/providers/test/json-rpc-provider/get-code.test.js +0 -311
  99. package/dist/cjs/providers/test/json-rpc-provider/get-fee-data.test.js +0 -212
  100. package/dist/cjs/providers/test/json-rpc-provider/get-gas-price.test.js +0 -164
  101. package/dist/cjs/providers/test/json-rpc-provider/get-logs.test.js +0 -361
  102. package/dist/cjs/providers/test/json-rpc-provider/get-network.test.js +0 -274
  103. package/dist/cjs/providers/test/json-rpc-provider/get-transaction-receipt.test.js +0 -301
  104. package/dist/cjs/providers/test/json-rpc-provider/get-transaction.test.js +0 -307
  105. package/dist/cjs/providers/test/test-alchemy-provider.test.js +0 -151
  106. package/dist/cjs/shared/tiny-big/helpers.test.js +0 -29
  107. package/dist/cjs/shared/tiny-big/tiny-big.test.js +0 -34
  108. package/dist/cjs/utils/tests/bytes/arrayify.test.js +0 -40
  109. package/dist/cjs/utils/tests/bytes/concat.test.js +0 -15
  110. package/dist/cjs/utils/tests/bytes/hex-concat.test.js +0 -63
  111. package/dist/cjs/utils/tests/bytes/hex-data-length.test.js +0 -49
  112. package/dist/cjs/utils/tests/bytes/hex-data-slice.test.js +0 -52
  113. package/dist/cjs/utils/tests/bytes/hex-strip-zeros.test.js +0 -58
  114. package/dist/cjs/utils/tests/bytes/hex-value.test.js +0 -85
  115. package/dist/cjs/utils/tests/bytes/hex-zero-pad.test.js +0 -62
  116. package/dist/cjs/utils/tests/bytes/hexlify.test.js +0 -62
  117. package/dist/cjs/utils/tests/bytes/is-bytes-like.test.js +0 -69
  118. package/dist/cjs/utils/tests/bytes/is-bytes.test.js +0 -33
  119. package/dist/cjs/utils/tests/bytes/is-hex-string.test.js +0 -88
  120. package/dist/cjs/utils/tests/bytes/strip-zeros.test.js +0 -57
  121. package/dist/cjs/utils/tests/bytes/zero-pad.test.js +0 -80
  122. package/dist/cjs/utils/tests/compute-address.test.js +0 -27
  123. package/dist/cjs/utils/tests/compute-public-key.test.js +0 -15
  124. package/dist/cjs/utils/tests/ether-to-gwei.test.js +0 -26
  125. package/dist/cjs/utils/tests/ether-to-wei.test.js +0 -44
  126. package/dist/cjs/utils/tests/gwei-to-ether.test.js +0 -28
  127. package/dist/cjs/utils/tests/hash-message.test.js +0 -21
  128. package/dist/cjs/utils/tests/is-address.test.js +0 -55
  129. package/dist/cjs/utils/tests/keccak256.test.js +0 -97
  130. package/dist/cjs/utils/tests/solidity-keccak256.test.js +0 -310
  131. package/dist/cjs/utils/tests/split-signature.test.js +0 -25
  132. package/dist/cjs/utils/tests/to-checksum-address.test.js +0 -42
  133. package/dist/cjs/utils/tests/to-utf8-bytes.test.js +0 -14
  134. package/dist/cjs/utils/tests/wei-to-ether.test.js +0 -51
@@ -1,188 +1,28 @@
1
- function _arrayLikeToArray(arr, len) {
2
- if (len == null || len > arr.length) len = arr.length;
3
- for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
4
- return arr2;
5
- }
6
- function _arrayWithHoles(arr) {
7
- if (Array.isArray(arr)) return arr;
8
- }
9
- function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
10
- try {
11
- var info = gen[key](arg);
12
- var value = info.value;
13
- } catch (error) {
14
- reject(error);
15
- return;
16
- }
17
- if (info.done) {
18
- resolve(value);
19
- } else {
20
- Promise.resolve(value).then(_next, _throw);
21
- }
22
- }
23
- function _asyncToGenerator(fn) {
24
- return function() {
25
- var self = this, args = arguments;
26
- return new Promise(function(resolve, reject) {
27
- var gen = fn.apply(self, args);
28
- function _next(value) {
29
- asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
30
- }
31
- function _throw(err) {
32
- asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
33
- }
34
- _next(undefined);
35
- });
36
- };
37
- }
38
- function _classCallCheck(instance, Constructor) {
39
- if (!(instance instanceof Constructor)) {
40
- throw new TypeError("Cannot call a class as a function");
41
- }
42
- }
43
- function _iterableToArrayLimit(arr, i) {
44
- var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
45
- if (_i == null) return;
46
- var _arr = [];
47
- var _n = true;
48
- var _d = false;
49
- var _s, _e;
50
- try {
51
- for(_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true){
52
- _arr.push(_s.value);
53
- if (i && _arr.length === i) break;
54
- }
55
- } catch (err) {
56
- _d = true;
57
- _e = err;
58
- } finally{
59
- try {
60
- if (!_n && _i["return"] != null) _i["return"]();
61
- } finally{
62
- if (_d) throw _e;
63
- }
64
- }
65
- return _arr;
66
- }
67
- function _nonIterableRest() {
68
- throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
69
- }
70
- function _slicedToArray(arr, i) {
71
- return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest();
72
- }
73
- function _unsupportedIterableToArray(o, minLen) {
74
- if (!o) return;
75
- if (typeof o === "string") return _arrayLikeToArray(o, minLen);
76
- var n = Object.prototype.toString.call(o).slice(8, -1);
77
- if (n === "Object" && o.constructor) n = o.constructor.name;
78
- if (n === "Map" || n === "Set") return Array.from(n);
79
- if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen);
80
- }
81
- var __generator = this && this.__generator || function(thisArg, body) {
82
- var f, y, t, g, _ = {
83
- label: 0,
84
- sent: function() {
85
- if (t[0] & 1) throw t[1];
86
- return t[1];
87
- },
88
- trys: [],
89
- ops: []
90
- };
91
- return g = {
92
- next: verb(0),
93
- "throw": verb(1),
94
- "return": verb(2)
95
- }, typeof Symbol === "function" && (g[Symbol.iterator] = function() {
96
- return this;
97
- }), g;
98
- function verb(n) {
99
- return function(v) {
100
- return step([
101
- n,
102
- v
103
- ]);
104
- };
105
- }
106
- function step(op) {
107
- if (f) throw new TypeError("Generator is already executing.");
108
- while(_)try {
109
- if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
110
- if (y = 0, t) op = [
111
- op[0] & 2,
112
- t.value
113
- ];
114
- switch(op[0]){
115
- case 0:
116
- case 1:
117
- t = op;
118
- break;
119
- case 4:
120
- _.label++;
121
- return {
122
- value: op[1],
123
- done: false
124
- };
125
- case 5:
126
- _.label++;
127
- y = op[1];
128
- op = [
129
- 0
130
- ];
131
- continue;
132
- case 7:
133
- op = _.ops.pop();
134
- _.trys.pop();
135
- continue;
136
- default:
137
- if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
138
- _ = 0;
139
- continue;
140
- }
141
- if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
142
- _.label = op[1];
143
- break;
144
- }
145
- if (op[0] === 6 && _.label < t[1]) {
146
- _.label = t[1];
147
- t = op;
148
- break;
149
- }
150
- if (t && _.label < t[2]) {
151
- _.label = t[2];
152
- _.ops.push(op);
153
- break;
154
- }
155
- if (t[2]) _.ops.pop();
156
- _.trys.pop();
157
- continue;
158
- }
159
- op = body.call(thisArg, _);
160
- } catch (e) {
161
- op = [
162
- 6,
163
- e
164
- ];
165
- y = 0;
166
- } finally{
167
- f = t = 0;
168
- }
169
- if (op[0] & 5) throw op[1];
170
- return {
171
- value: op[0] ? op[1] : void 0,
172
- done: true
173
- };
174
- }
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 };
175
13
  };
176
- import { cleanBlock } from "../classes/utils/clean-block";
177
- import { cleanLog } from "../classes/utils/clean-log";
178
- import { cleanTransaction } from "../classes/utils/clean-transaction";
179
- import { cleanTransactionReceipt } from "../classes/utils/clean-transaction-receipt";
180
- import { buildRPCPostBody, post } from "../classes/utils/fetchers";
181
- import { hexToDecimal } from "../classes/utils/hex-to-decimal";
182
- import { prepareTransaction } from "../classes/utils/prepare-transaction";
183
- import { logger } from "../logger/logger";
184
- import { tinyBig } from "../shared/tiny-big/tiny-big";
185
- import chainsInfo from "./utils/chains-info";
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"));
186
26
  /**
187
27
  * Converts a block tag into the right format when needed.
188
28
  *
@@ -202,719 +42,508 @@ import chainsInfo from "./utils/chains-info";
202
42
  * prepBlockTag('0xe290b7');
203
43
  * // '0xe290b7'
204
44
  * ```
205
- */ function prepBlockTag(blockTag) {
206
- return typeof blockTag === "number" ? tinyBig(blockTag).toHexString() : blockTag;
45
+ */
46
+ function prepBlockTag(blockTag) {
47
+ return typeof blockTag === 'number'
48
+ ? (0, tiny_big_1.tinyBig)(blockTag).toHexString()
49
+ : blockTag;
207
50
  }
208
- export var BaseProvider = /*#__PURE__*/ function() {
209
- "use strict";
210
- function BaseProvider(rpcUrls) {
211
- var _this = this;
212
- _classCallCheck(this, BaseProvider);
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) {
213
60
  /**
214
- * @ignore
215
- */ this._rpcUrls = [];
61
+ * @ignore
62
+ */
63
+ this._rpcUrls = [];
216
64
  /**
217
- * @ignore
218
- */ this._post = function(body) {
219
- return post(_this.selectRpcUrl(), body);
220
- };
65
+ * @ignore
66
+ */
67
+ this._post = (body) => (0, fetchers_1.post)(this.selectRpcUrl(), body);
221
68
  this._rpcUrls = rpcUrls;
222
69
  }
223
- var _proto = BaseProvider.prototype;
224
70
  /**
225
- * Gets information (name, chainId, and ensAddress when applicable) about the network the provider is connected to.
226
- *
227
- * * [Identical](/docs/api#isd) to [`ethers.provider.getNetwork`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getNetwork) in ethers.js
228
- * * [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`
229
- *
230
- * @returns information about the network this provider is currently connected to
231
- * @example
232
- * ```javascript
233
- * jsonRpcProvider('https://free-eth-node.com/api/eth').getNetwork();
234
- * // { chainId: 1, name: 'eth', ensAddress: '0x00000000000C2E074eC69A0dFb2997BA6C7d2e1e' }
235
- * ```
236
- * @example
237
- * ```javascript
238
- * jsonRpcProvider('https://free-eth-node.com/api/MATIC').getNetwork();
239
- * // { chainId: 137, name: 'MATIC', ensAddress: null }
240
- * ```
241
- */ _proto.getNetwork = function getNetwork() {
242
- var _this = this;
243
- return _asyncToGenerator(function() {
244
- var hexChainId, chainId, info;
245
- return __generator(this, function(_state) {
246
- switch(_state.label){
247
- case 0:
248
- return [
249
- 4,
250
- _this.post(buildRPCPostBody("eth_chainId", []))
251
- ];
252
- case 1:
253
- hexChainId = _state.sent();
254
- chainId = hexToDecimal(hexChainId);
255
- info = chainsInfo[chainId];
256
- return [
257
- 2,
258
- {
259
- chainId: Number(chainId),
260
- name: info[0] || "unknown",
261
- ensAddress: info[1] || null
262
- }
263
- ];
264
- }
265
- });
266
- })();
267
- };
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
+ }
268
100
  /**
269
- * Gets the number of the most recently mined block on the network the provider is connected to.
270
- *
271
- * * [Identical](/docs/api#isd) to [`ethers.provider.getBlockNumber`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getBlockNumber) in ethers.js
272
- * * [Identical](/docs/api#isd) to [`web3.eth.getBlockNumber`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getblocknumber) in web3.js
273
- *
274
- * @returns the number of the most recently mined block
275
- * @example
276
- * ```javascript
277
- * await provider.getBlockNumber();
278
- * // 1053312
279
- * ```
280
- */ _proto.getBlockNumber = function getBlockNumber() {
281
- var _this = this;
282
- return _asyncToGenerator(function() {
283
- var currentBlockNumber;
284
- return __generator(this, function(_state) {
285
- switch(_state.label){
286
- case 0:
287
- return [
288
- 4,
289
- _this.post(buildRPCPostBody("eth_blockNumber", []))
290
- ];
291
- case 1:
292
- currentBlockNumber = _state.sent();
293
- return [
294
- 2,
295
- Number(hexToDecimal(currentBlockNumber))
296
- ];
297
- }
298
- });
299
- })();
300
- };
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
+ }
301
119
  /**
302
- * Gets information about a specified transaction, even if it hasn't been mined yet.
303
- *
304
- * * [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
305
- * * [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
306
- *
307
- * @param transactionHash the hash of the transaction to get information about
308
- * @returns information about the specified transaction
309
- * @example
310
- * ```javascript
311
- * await provider.getTransaction('0x9014ae6ef92464338355a79e5150e542ff9a83e2323318b21f40d6a3e65b4789');
312
- * // {
313
- * // accessList: [],
314
- * // blockHash: "0x876810a013dbcd140f6fd6048c1dc33abbb901f1f96b394c2fa63aef3cb40b5d",
315
- * // blockNumber: 14578286,
316
- * // chainId: 1,
317
- * // from: "0xdfD9dE5f6FA60BD70636c0900752E93a6144AEd4",
318
- * // gas: { TinyBig: 112163 },
319
- * // gasPrice: { TinyBig: 48592426858 },
320
- * // hash: "0x9014ae6ef92464338355a79e5150e542ff9a83e2323318b21f40d6a3e65b4789",
321
- * // input: "0x83259f17000000000000000000000000000000000000000000...",
322
- * // maxFeePerGas: { TinyBig: 67681261618 },
323
- * // maxPriorityFeePerGas: { TinyBig: 1500000000 },
324
- * // nonce: { TinyBig: 129 },
325
- * // r: "0x59a7c15b12c18cd68d6c440963d959bff3e73831ffc938e75ecad07f7ee43fbc",
326
- * // s: "0x1ebaf05f0d9273b16c2a7748b150a79d22533a8cd74552611cbe620fee3dcf1c",
327
- * // to: "0x39B72d136ba3e4ceF35F48CD09587ffaB754DD8B",
328
- * // transactionIndex: 29,
329
- * // type: 2,
330
- * // v: 0,
331
- * // value: { TinyBig: 0 },
332
- * // confirmations: 298140,
333
- * // }
334
- * ```
335
- */ _proto.getTransaction = function getTransaction(transactionHash) {
336
- var _this = this;
337
- return _asyncToGenerator(function() {
338
- var _ref, rpcTransaction, blockNumber, cleanedTransaction;
339
- return __generator(this, function(_state) {
340
- switch(_state.label){
341
- case 0:
342
- return [
343
- 4,
344
- Promise.all([
345
- _this.post(buildRPCPostBody("eth_getTransactionByHash", [
346
- transactionHash
347
- ])),
348
- _this.getBlock("latest")
349
- ])
350
- ];
351
- case 1:
352
- _ref = _slicedToArray.apply(void 0, [
353
- _state.sent(),
354
- 2
355
- ]), rpcTransaction = _ref[0], blockNumber = _ref[1];
356
- cleanedTransaction = cleanTransaction(rpcTransaction);
357
- // https://ethereum.stackexchange.com/questions/2881/how-to-get-the-transaction-confirmations-using-the-json-rpc
358
- cleanedTransaction.confirmations = blockNumber.number - cleanedTransaction.blockNumber + 1;
359
- return [
360
- 2,
361
- cleanedTransaction
362
- ];
363
- }
364
- });
365
- })();
366
- };
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
+ }
367
167
  /**
368
- * Gives information about a transaction that has already been mined. Includes additional information beyond what's provided by [`getTransaction`](/docs/api/modules#gettransaction).
369
- *
370
- * * [Identical](/docs/api#isd) to [`ethers.provider.getTransactionReceipt`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getTransactionReceipt) in ethers.js
371
- * * [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
372
- *
373
- * @param transactionHash the hash of the transaction to get information about
374
- * @returns information about the specified transaction that has already been mined
375
- * @example
376
- * ```javascript
377
- * await provider.getTransactionReceipt('0x9014ae6ef92464338355a79e5150e542ff9a83e2323318b21f40d6a3e65b4789');
378
- * // {
379
- * // blockHash: "0x876810a013dbcd140f6fd6048c1dc33abbb901f1f96b394c2fa63aef3cb40b5d",
380
- * // blockNumber: 14578286,
381
- * // contractAddress: null,
382
- * // cumulativeGasUsed: { TinyBig: 3067973 },
383
- * // effectiveGasPrice: { TinyBig: 48592426858 },
384
- * // from: "0xdfD9dE5f6FA60BD70636c0900752E93a6144AEd4",
385
- * // gasUsed: { TinyBig: 112163 },
386
- * // logs: [
387
- * // {
388
- * // address: "0x0eDF9bc41Bbc1354c70e2107F80C42caE7FBBcA8",
389
- * // blockHash: "0x876810a013dbcd140f6fd6048c1dc33abbb901f1f96b394c2fa63aef3cb40b5d",
390
- * // blockNumber: 14578286,
391
- * // data: "0x0000000000000000000000000000000000000000000003a12ec797b5484968c1",
392
- * // logIndex: 42,
393
- * // topics: [
394
- * // "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
395
- * // "0x00000000000000000000000039b72d136ba3e4cef35f48cd09587ffab754dd8b",
396
- * // "0x000000000000000000000000dfd9de5f6fa60bd70636c0900752e93a6144aed4",
397
- * // ],
398
- * // transactionHash: "0x9014ae6ef92464338355a79e5150e542ff9a83e2323318b21f40d6a3e65b4789",
399
- * // transactionIndex: 29,
400
- * // },
401
- * // {
402
- * // address: "0x39B72d136ba3e4ceF35F48CD09587ffaB754DD8B",
403
- * // blockHash: "0x876810a013dbcd140f6fd6048c1dc33abbb901f1f96b394c2fa63aef3cb40b5d",
404
- * // blockNumber: 14578286,
405
- * // data: "0x0000000000000000000000000000000000000000000003a12ec797b5484968c1",
406
- * // logIndex: 43,
407
- * // topics: [
408
- * // "0x34fcbac0073d7c3d388e51312faf357774904998eeb8fca628b9e6f65ee1cbf7",
409
- * // "0x000000000000000000000000dfd9de5f6fa60bd70636c0900752e93a6144aed4",
410
- * // "0x0000000000000000000000000000000000000000000000000000000000000003",
411
- * // ],
412
- * // transactionHash: "0x9014ae6ef92464338355a79e5150e542ff9a83e2323318b21f40d6a3e65b4789",
413
- * // transactionIndex: 29,
414
- * // },
415
- * // ],
416
- * // logsBloom: "0x00000000000000000000000000000...",
417
- * // status: 1,
418
- * // to: "0x39B72d136ba3e4ceF35F48CD09587ffaB754DD8B",
419
- * // transactionHash: "0x9014ae6ef92464338355a79e5150e542ff9a83e2323318b21f40d6a3e65b4789",
420
- * // transactionIndex: 29,
421
- * // type: 2,
422
- * // byzantium: true,
423
- * // confirmations: 298171,
424
- * // }
425
- * ```
426
- */ _proto.getTransactionReceipt = function getTransactionReceipt(transactionHash) {
427
- var _this = this;
428
- return _asyncToGenerator(function() {
429
- var _ref, rpcTransaction, blockNumber, cleanedTransactionReceipt;
430
- return __generator(this, function(_state) {
431
- switch(_state.label){
432
- case 0:
433
- return [
434
- 4,
435
- Promise.all([
436
- _this.post(buildRPCPostBody("eth_getTransactionReceipt", [
437
- transactionHash
438
- ])),
439
- _this.getBlock("latest")
440
- ])
441
- ];
442
- case 1:
443
- _ref = _slicedToArray.apply(void 0, [
444
- _state.sent(),
445
- 2
446
- ]), rpcTransaction = _ref[0], blockNumber = _ref[1];
447
- cleanedTransactionReceipt = cleanTransactionReceipt(rpcTransaction);
448
- cleanedTransactionReceipt.confirmations = blockNumber.number - cleanedTransactionReceipt.blockNumber + 1;
449
- return [
450
- 2,
451
- cleanedTransactionReceipt
452
- ];
453
- }
454
- });
455
- })();
456
- };
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
+ }
457
239
  /**
458
- * Returns the number of sent transactions by an address, from genesis (or as far back as a provider looks) up to specified block.
459
- *
460
- * * [Identical](/docs/api#isd) to [`ethers.provider.getTransactionCount`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getTransactionCount) in ethers.js
461
- * * [Identical](/docs/api#isd) to [`web3.eth.getTransactionCount`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#gettransactioncount) in web3.js
462
- *
463
- * @param address the address to count number of sent transactions
464
- * @param blockTag the block to count transactions up to, inclusive
465
- * @returns the number of transactions sent by the specified address
466
- * @example
467
- * ```javascript
468
- * await provider.getTransactionCount('0x71660c4005ba85c37ccec55d0c4493e66fe775d3');
469
- * // 1060000
470
- * ```
471
- * @example
472
- * ```javascript
473
- * await provider.getTransactionCount('0x71660c4005ba85c37ccec55d0c4493e66fe775d3', 'latest');
474
- * // 1060000
475
- * ```
476
- * @example
477
- * ```javascript
478
- * await provider.getTransactionCount('0x71660c4005ba85c37ccec55d0c4493e66fe775d3', 14649390);
479
- * // 1053312
480
- * ```
481
- */ _proto.getTransactionCount = function getTransactionCount(address) {
482
- var blockTag = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : "latest";
483
- var _this = this;
484
- return _asyncToGenerator(function() {
485
- var transactionCount;
486
- return __generator(this, function(_state) {
487
- switch(_state.label){
488
- case 0:
489
- blockTag = prepBlockTag(blockTag);
490
- return [
491
- 4,
492
- _this.post(buildRPCPostBody("eth_getTransactionCount", [
493
- address,
494
- blockTag
495
- ]))
496
- ];
497
- case 1:
498
- transactionCount = _state.sent();
499
- return [
500
- 2,
501
- Number(hexToDecimal(transactionCount))
502
- ];
503
- }
504
- });
505
- })();
506
- };
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
+ }
507
271
  /**
508
- * Gets information about a certain block, optionally with full transaction objects.
509
- *
510
- * * [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`]
511
- * * [Identical](/docs/api#isd) to [`web3.eth.getBlock`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getpastlogs) in web3.js
512
- *
513
- * @param timeFrame The number, hash, or text-based description ('latest', 'earliest', or 'pending') of the block to collect information on.
514
- * @param returnTransactionObjects Whether to also return data about the transactions on the block.
515
- * @returns A BlockResponse object with information about the specified block
516
- * @example
517
- * ```javascript
518
- * await provider.getBlock(14879862);
519
- * // {
520
- * // baseFeePerGas: { TinyBig: 39095728776 },
521
- * // difficulty: { TinyBig: 14321294455359973 },
522
- * // extraData: "0x486976656f6e2073672d6865617679",
523
- * // gasLimit: { TinyBig: 29970620 },
524
- * // gasUsed: { TinyBig: 20951384 },
525
- * // hash: "0x563b458ec3c4f87393b53f70bdddc0058497109b784d8cacd9247ddf267049ab",
526
- * // logsBloom:
527
- * // "0x9f38794fe80b521794df6efad8b0d2e9582f9ec3959a3f9384bda0fa371cfa5fac5af9d515c6bdf1ec325f5b5f7ebdd6a3a9fae17b38a86d4dc4b0971afc68d8086640550f4c156e6f923f4a1bb94fb0bed6cdcc474c5c64bfeff7a4a906f72b9a7b94004ee58efc53d63ac66961acd3a431b2d896cc9fd75f6072960bced45f770587caf130f57504decfcb63c6ca8fbc5bdbd749edd5a99a7375d2b81872289adb775fb3c928259f4be39c6d3f4d5b6217822979bb88c1f1fb62429b1b6d41cf4e3f77f9e1db3f5723108f1e5b1255dd734ad8cdb11e7ea22487c788e67c83777b6f395e504ca59c64f52245ee6de3804cf809e5caa4f0ea6a9aa9eb6ed801",
528
- * // miner: "0x1aD91ee08f21bE3dE0BA2ba6918E714dA6B45836",
529
- * // mixHash: "0x73cc9419bfb89c9d41c3a8c34ce56b5ebe468bdcf870258d2e77262275d580ec",
530
- * // nonce: "0x976f3f5d596ffb08",
531
- * // number: 14879862,
532
- * // parentHash: "0x95986ae14a71face8d9a6a379edd875b2e8bc73e4de0d9d460e7752bddb0f579",
533
- * // receiptsRoot: "0x8e6ba2fd9bee602b653dae6e3132f16538c2c5df24f1df8c000392053f73defa",
534
- * // sha3Uncles: "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
535
- * // size: { TinyBig: 134483 },
536
- * // stateRoot: "0xbf2bb67bd1c741f3d00904b8451d7c2cf4e3a2726f5a5884792ede2074747b85",
537
- * // timestamp: { TinyBig: 1654016186 },
538
- * // totalDifficulty: { TinyBig: 50478104614257705213748 },
539
- * // transactions: [
540
- * // "0xb3326a9149809603a2c28545e50e4f7d16e194bf5ee9764e0544603854c4a8d2",
541
- * // "0x8b42095f8d335404a4896b2817b8e5e3d86a5a87cb434a8eec295d5280a7f48e",
542
- * // "0x882f78fcb73f0f7ad0700bb0424a8b4beb366aaa93b88a3562c49a8d0ce4dcff",
543
- * // ...
544
- * // ],
545
- * // transactionsRoot: "0x5934902f3dcc263ec34f24318179bf6301f53f4834685792066026f3a4849d72",
546
- * // uncles: [],
547
- * // }
548
- * ```
549
- */ _proto.getBlock = function getBlock() {
550
- var timeFrame = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : "latest", returnTransactionObjects = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : false;
551
- var _this = this;
552
- return _asyncToGenerator(function() {
553
- var type, rpcBlock;
554
- return __generator(this, function(_state) {
555
- switch(_state.label){
556
- case 0:
557
- type = "Number";
558
- if (typeof timeFrame === "string" && timeFrame.length === 66) {
559
- // use endpoint that accepts string
560
- type = "Hash";
561
- } else {
562
- timeFrame = prepBlockTag(timeFrame);
563
- }
564
- return [
565
- 4,
566
- _this.post(buildRPCPostBody("eth_getBlockBy".concat(type), [
567
- timeFrame,
568
- returnTransactionObjects
569
- ]))
570
- ];
571
- case 1:
572
- rpcBlock = _state.sent();
573
- return [
574
- 2,
575
- cleanBlock(rpcBlock, returnTransactionObjects)
576
- ];
577
- }
578
- });
579
- })();
580
- };
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
+ }
581
331
  /**
582
- * Gives an estimate of the current gas price in wei.
583
- *
584
- * * [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)
585
- * * [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
586
- *
587
- * @returns an estimate of the current gas price in wei
588
- * @example
589
- * ```javascript
590
- * await provider.getGasPrice();
591
- * // 52493941856
592
- * ```
593
- */ _proto.getGasPrice = function getGasPrice() {
594
- var _this = this;
595
- return _asyncToGenerator(function() {
596
- var hexGasPrice;
597
- return __generator(this, function(_state) {
598
- switch(_state.label){
599
- case 0:
600
- return [
601
- 4,
602
- _this.post(buildRPCPostBody("eth_gasPrice", []))
603
- ];
604
- case 1:
605
- hexGasPrice = _state.sent();
606
- return [
607
- 2,
608
- tinyBig(hexToDecimal(hexGasPrice))
609
- ];
610
- }
611
- });
612
- })();
613
- };
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
+ }
614
350
  /**
615
- * Returns the balance of the account in wei.
616
- *
617
- * * [Identical](/docs/api#isd) to [`ethers.provider.getBalance`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getBalance) in ethers.js
618
- * * [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
619
- *
620
- * @param address the address to check the balance of
621
- * @param blockTag the block to check the specified address' balance on
622
- * @returns the balance of the network's native token for the specified address on the specified block
623
- * @example
624
- * ```javascript
625
- * await provider.getBalance('0x7cB57B5A97eAbe94205C07890BE4c1aD31E486A8');
626
- * // 28798127851528138
627
- * ```
628
- */ _proto.getBalance = function getBalance(address) {
629
- var blockTag = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : "latest";
630
- var _this = this;
631
- return _asyncToGenerator(function() {
632
- var hexBalance;
633
- return __generator(this, function(_state) {
634
- switch(_state.label){
635
- case 0:
636
- blockTag = prepBlockTag(blockTag);
637
- return [
638
- 4,
639
- _this.post(buildRPCPostBody("eth_getBalance", [
640
- address,
641
- blockTag
642
- ]))
643
- ];
644
- case 1:
645
- hexBalance = _state.sent();
646
- return [
647
- 2,
648
- tinyBig(hexToDecimal(hexBalance))
649
- ];
650
- }
651
- });
652
- })();
653
- };
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
+ }
654
372
  /**
655
- * Gets the code of a contract on a specified block.
656
- *
657
- * * [Identical](/docs/api#isd) to [`ethers.provider.getCode`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getCode) in ethers.js
658
- * * [Identical](/docs/api#isd) to [`web3.eth.getCode`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getcode) in web3.js
659
- *
660
- * @param address the contract address to get the contract code from
661
- * @param blockTag the block height to search for the contract code from. Contract code can change, so this allows for checking a specific block
662
- * @returns the contract creation code for the specified address at the specified block height
663
- * @example
664
- * ```javascript
665
- * await jsonRpcProvider().getCode('0xaC6095720221C79C6E7C638d260A2eFBC5D8d880', 'latest');
666
- * // '0x608060405234801561001057600080fd5b506004361061...'
667
- * ```
668
- */ _proto.getCode = function getCode(address) {
669
- var blockTag = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : "latest";
670
- var _this = this;
671
- return _asyncToGenerator(function() {
672
- var contractCode;
673
- return __generator(this, function(_state) {
674
- switch(_state.label){
675
- case 0:
676
- blockTag = prepBlockTag(blockTag);
677
- return [
678
- 4,
679
- _this.post(buildRPCPostBody("eth_getCode", [
680
- address,
681
- blockTag
682
- ]))
683
- ];
684
- case 1:
685
- contractCode = _state.sent();
686
- return [
687
- 2,
688
- contractCode
689
- ];
690
- }
691
- });
692
- })();
693
- };
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
+ }
694
394
  /**
695
- * Returns an estimate of the amount of gas that would be required to submit transaction to the network.
696
- * An estimate may not be accurate since there could be another transaction on the network that was not accounted for.
697
- *
698
- * * [Identical](/docs/api#isd) to [`ethers.provider.estimateGas`](https://docs.ethers.io/v5/api/providers/provider/#Provider-estimateGas) in ethers.js
699
- * * [Identical](/docs/api#isd) to [`web3.eth.estimateGas`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#estimateGas) in web3.js
700
- *
701
- * @param transaction the transaction to check the estimated gas cost for
702
- * @returns the estimated amount of gas charged for submitting the specified transaction to the blockchain
703
- * @example
704
- * ```javascript
705
- * await provider.estimateGas({
706
- * // Wrapped ETH address
707
- * to: "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
708
- * data: "0xd0e30db0",
709
- * value: etherToWei('1.0').toHexString(),
710
- * });
711
- * // { TinyBig: "27938" }
712
- * ```
713
- */ _proto.estimateGas = function estimateGas(transaction) {
714
- var _this = this;
715
- return _asyncToGenerator(function() {
716
- var rpcTransaction, gasUsed;
717
- return __generator(this, function(_state) {
718
- switch(_state.label){
719
- case 0:
720
- rpcTransaction = prepareTransaction(transaction);
721
- return [
722
- 4,
723
- _this.post(buildRPCPostBody("eth_estimateGas", [
724
- rpcTransaction
725
- ]))
726
- ];
727
- case 1:
728
- gasUsed = _state.sent();
729
- return [
730
- 2,
731
- tinyBig(hexToDecimal(gasUsed))
732
- ];
733
- }
734
- });
735
- })();
736
- };
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
+ }
737
421
  /**
738
- * Returns the current recommended FeeData to use in a transaction.
739
- * For an EIP-1559 transaction, the maxFeePerGas and maxPriorityFeePerGas should be used.
740
- * 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.
741
- *
742
- * * [Identical](/docs/api#isd) to [`ethers.provider.getFeeData`](https://docs.ethers.org/v5/api/providers/provider/#Provider-getFeeData) in ethers.js
743
- *
744
- * @returns an object with gas estimates for the network currently
745
- * @example
746
- * ```javascript
747
- * await provider.getFeeData();
748
- * // {
749
- * // gasPrice: { TinyBig: "14184772639" },
750
- * // lastBaseFeePerGas: { TinyBig: "14038523098" },
751
- * // maxFeePerGas: { TinyBig: "29577046196" },
752
- * // maxPriorityFeePerGas: { TinyBig: "1500000000" }
753
- * // }
754
- * ```
755
- */ _proto.getFeeData = function getFeeData() {
756
- var _this = this;
757
- return _asyncToGenerator(function() {
758
- var _ref, block, gasPrice, lastBaseFeePerGas, maxFeePerGas, maxPriorityFeePerGas;
759
- return __generator(this, function(_state) {
760
- switch(_state.label){
761
- case 0:
762
- return [
763
- 4,
764
- Promise.all([
765
- _this.getBlock("latest"),
766
- _this.getGasPrice()
767
- ])
768
- ];
769
- case 1:
770
- _ref = _slicedToArray.apply(void 0, [
771
- _state.sent(),
772
- 2
773
- ]), block = _ref[0], gasPrice = _ref[1];
774
- lastBaseFeePerGas = null, maxFeePerGas = null, maxPriorityFeePerGas = null;
775
- if (block && block.baseFeePerGas) {
776
- // We may want to compute this more accurately in the future,
777
- // using the formula "check if the base fee is correct".
778
- // See: https://eips.ethereum.org/EIPS/eip-1559
779
- lastBaseFeePerGas = block.baseFeePerGas;
780
- maxPriorityFeePerGas = tinyBig("1500000000");
781
- maxFeePerGas = tinyBig(block.baseFeePerGas.mul(2).add(maxPriorityFeePerGas));
782
- }
783
- return [
784
- 2,
785
- {
786
- lastBaseFeePerGas: lastBaseFeePerGas,
787
- maxFeePerGas: maxFeePerGas,
788
- maxPriorityFeePerGas: maxPriorityFeePerGas,
789
- gasPrice: gasPrice
790
- }
791
- ];
792
- }
793
- });
794
- })();
795
- };
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
+ }
796
458
  /**
797
- * Returns transaction receipt event logs that match a specified filter.
798
- * May return `[]` if parameters are too broad, even if logs exist.
799
- *
800
- * * [Identical](/docs/api#isd) to [`ethers.provider.getLogs`](https://docs.ethers.io/v5/api/providers/provider/#Provider-getLogs) in ethers.js
801
- * * [Identical](/docs/api#isd) to [`web3.eth.getPastLogs`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#getpastlogs) in web3.js
802
- *
803
- * @param filter parameters to filter the logs by
804
- * @returns an array of logs matching the specified filter
805
- * @example
806
- * ```javascript
807
- * provider.getLogs({
808
- * address: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
809
- * topics: [
810
- * "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
811
- * "0x00000000000000000000000021b8065d10f73ee2e260e5b47d3344d3ced7596e",
812
- * ],
813
- * fromBlock: 14825027,
814
- * toBlock: 14825039,
815
- * });
816
- *
817
- * [
818
- * {
819
- * address: '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2',
820
- * blockHash: '0x8e0dfac2f704851960f866c8708b3bef2f66c0fee0329cf25ff0261b264ca6bc',
821
- * blockNumber: 14825029,
822
- * data: '0x000000000000000000000000000000000000000000000000005f862ee352a38a',
823
- * logIndex: 384,
824
- * removed: false,
825
- * topics: [
826
- * '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
827
- * '0x00000000000000000000000021b8065d10f73ee2e260e5b47d3344d3ced7596e',
828
- * '0x00000000000000000000000068b3465833fb72a70ecdf485e0e4c7bd8665fc45'
829
- * ],
830
- * transactionHash: '0xbd49031be16f8fd1775f4e0fe79b408ffd8ae9c65b2827ee47e3238e3f51f4c0',
831
- * transactionIndex: 226
832
- * }
833
- * ]
834
- * ```
835
- */ _proto.getLogs = function getLogs(filter) {
836
- var _this = this;
837
- return _asyncToGenerator(function() {
838
- var filterByRange, rpcLogs, logs;
839
- return __generator(this, function(_state) {
840
- switch(_state.label){
841
- case 0:
842
- filterByRange = filter;
843
- if (filterByRange.fromBlock) filterByRange.fromBlock = prepBlockTag(filterByRange.fromBlock);
844
- if (filterByRange.toBlock) filterByRange.toBlock = prepBlockTag(filterByRange.toBlock);
845
- return [
846
- 4,
847
- _this.post(buildRPCPostBody("eth_getLogs", [
848
- filter
849
- ]))
850
- ];
851
- case 1:
852
- rpcLogs = _state.sent();
853
- logs = rpcLogs.map(function(log) {
854
- return cleanLog(log, false);
855
- });
856
- return [
857
- 2,
858
- logs
859
- ];
860
- }
861
- });
862
- })();
863
- };
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
+ }
864
510
  /**
865
- * Returns the result of adding a transaction to the blockchain without actually adding that transaction to the blockchain.
866
- * Does not require any ether as gas.
867
- *
868
- * * [Identical](/docs/api#isd) to [`ethers.provider.call`](https://docs.ethers.io/v5/api/providers/provider/#Provider-call) in ethers.js
869
- * * [Identical](/docs/api#isd) to [`web3.eth.call`](https://web3js.readthedocs.io/en/v1.7.3/web3-eth.html#call) in web3.js
870
- *
871
- * @param transaction the transaction object to, in theory, execute. Doesn't actually get added to the blockchain.
872
- * @param blockTag the block to execute this transaction on
873
- * @returns the result of executing the transaction on the specified block
874
- * @example
875
- * ```javascript
876
- * await provider.call({ to: "0x6b175474e89094c44da98b954eedeac495271d0f", data: "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE" });
877
- * // '0x0000000000000000000000000000000000000000000000000858898f93629000'
878
- * ```
879
- */ _proto.call = function call(transaction) {
880
- var blockTag = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : "latest";
881
- var _this = this;
882
- return _asyncToGenerator(function() {
883
- var rpcTransaction, transactionRes;
884
- return __generator(this, function(_state) {
885
- switch(_state.label){
886
- case 0:
887
- if (transaction.gasPrice && (transaction.maxPriorityFeePerGas || transaction.maxFeePerGas)) {
888
- logger.throwError('Cannot specify both "gasPrice" and ("maxPriorityFeePerGas" or "maxFeePerGas")', {
889
- gasPrice: transaction.gasPrice,
890
- maxFeePerGas: transaction.maxFeePerGas,
891
- maxPriorityFeePerGas: transaction.maxPriorityFeePerGas
892
- });
893
- }
894
- if (transaction.maxFeePerGas && transaction.maxPriorityFeePerGas) {
895
- logger.throwError('Cannot specify both "maxFeePerGas" and "maxPriorityFeePerGas"', {
896
- maxFeePerGas: transaction.maxFeePerGas,
897
- maxPriorityFeePerGas: transaction.maxPriorityFeePerGas
898
- });
899
- }
900
- blockTag = prepBlockTag(blockTag);
901
- rpcTransaction = prepareTransaction(transaction);
902
- return [
903
- 4,
904
- _this.post(buildRPCPostBody("eth_call", [
905
- rpcTransaction,
906
- blockTag
907
- ]))
908
- ];
909
- case 1:
910
- transactionRes = _state.sent();
911
- return [
912
- 2,
913
- transactionRes
914
- ];
915
- }
916
- });
917
- })();
918
- };
919
- return BaseProvider;
920
- }();
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;