viem 0.0.1-alpha.14 → 0.0.1-alpha.16

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 (456) hide show
  1. package/dist/chains.js +6 -5
  2. package/dist/chains.js.map +1 -0
  3. package/dist/chains.mjs +2 -1
  4. package/dist/chains.mjs.map +1 -0
  5. package/dist/chunk-4XREGFHD.js +153 -0
  6. package/dist/chunk-4XREGFHD.js.map +1 -0
  7. package/dist/{chunk-DUNJAMH5.mjs → chunk-B7A2CAHU.mjs} +95 -480
  8. package/dist/chunk-B7A2CAHU.mjs.map +1 -0
  9. package/dist/{chunk-6Z62LPKB.js → chunk-EWTLCB3N.js} +18 -6
  10. package/dist/chunk-EWTLCB3N.js.map +1 -0
  11. package/dist/chunk-KCMYVU3Z.mjs +153 -0
  12. package/dist/chunk-KCMYVU3Z.mjs.map +1 -0
  13. package/dist/{chunk-KB6CBNKW.mjs → chunk-KM6AFT2K.mjs} +18 -6
  14. package/dist/chunk-KM6AFT2K.mjs.map +1 -0
  15. package/dist/chunk-LQXQPPTU.js +256 -0
  16. package/dist/chunk-LQXQPPTU.js.map +1 -0
  17. package/dist/{chunk-5TCPFLFT.mjs → chunk-TSJ3OOJW.mjs} +2 -1
  18. package/dist/chunk-TSJ3OOJW.mjs.map +1 -0
  19. package/dist/chunk-U7QDLGQL.mjs +256 -0
  20. package/dist/chunk-U7QDLGQL.mjs.map +1 -0
  21. package/dist/{chunk-VUNR7KGG.js → chunk-WTXKCAG7.js} +146 -531
  22. package/dist/chunk-WTXKCAG7.js.map +1 -0
  23. package/dist/{chunk-E7IQYTLV.js → chunk-XJKOJIX3.js} +12 -11
  24. package/dist/chunk-XJKOJIX3.js.map +1 -0
  25. package/dist/clients/index.d.ts +6 -3
  26. package/dist/clients/index.js +4 -3
  27. package/dist/clients/index.js.map +1 -0
  28. package/dist/clients/index.mjs +3 -2
  29. package/dist/clients/index.mjs.map +1 -0
  30. package/dist/createClient-cd948138.d.ts +62 -0
  31. package/dist/createPublicClient-989a0556.d.ts +19 -0
  32. package/dist/createTestClient-81507f58.d.ts +34 -0
  33. package/dist/createWalletClient-43f801b9.d.ts +30 -0
  34. package/dist/{eip1193-c001fcd5.d.ts → eip1193-4330b722.d.ts} +1 -1
  35. package/dist/index.d.ts +13 -6
  36. package/dist/index.js +9 -4
  37. package/dist/index.js.map +1 -0
  38. package/dist/index.mjs +34 -29
  39. package/dist/index.mjs.map +1 -0
  40. package/dist/{parseGwei-21f98a29.d.ts → parseGwei-f2d23de6.d.ts} +1 -1
  41. package/dist/public.d.ts +12 -0
  42. package/dist/public.js +59 -0
  43. package/dist/public.js.map +1 -0
  44. package/dist/public.mjs +59 -0
  45. package/dist/public.mjs.map +1 -0
  46. package/dist/sendTransaction-7a9d241a.d.ts +13 -0
  47. package/dist/stopImpersonatingAccount-8113150e.d.ts +156 -0
  48. package/dist/test.d.ts +7 -0
  49. package/dist/test.js +60 -0
  50. package/dist/test.js.map +1 -0
  51. package/dist/test.mjs +60 -0
  52. package/dist/test.mjs.map +1 -0
  53. package/dist/{transactionRequest-1d4e4385.d.ts → transactionReceipt-5d332aab.d.ts} +4 -32
  54. package/dist/transactionRequest-327eb7c2.d.ts +33 -0
  55. package/dist/utils/index.d.ts +4 -3
  56. package/dist/utils/index.js +3 -2
  57. package/dist/utils/index.js.map +1 -0
  58. package/dist/utils/index.mjs +2 -1
  59. package/dist/utils/index.mjs.map +1 -0
  60. package/dist/wallet.d.ts +9 -0
  61. package/dist/wallet.js +24 -0
  62. package/dist/wallet.js.map +1 -0
  63. package/dist/wallet.mjs +24 -0
  64. package/dist/wallet.mjs.map +1 -0
  65. package/dist/watchAsset-0088384c.d.ts +39 -0
  66. package/dist/{stopImpersonatingAccount-fcc5a678.d.ts → watchPendingTransactions-670a7ca3.d.ts} +7 -197
  67. package/dist/{webSocket-3385e295.d.ts → webSocket-9a3b0b26.d.ts} +1 -1
  68. package/dist/window.d.ts +1 -1
  69. package/dist/window.js +1 -1
  70. package/dist/window.js.map +1 -0
  71. package/dist/window.mjs +1 -0
  72. package/dist/window.mjs.map +1 -0
  73. package/package.json +18 -6
  74. package/src/_test/abis.ts +1225 -0
  75. package/src/_test/bench.ts +15 -0
  76. package/src/_test/constants.ts +63 -0
  77. package/src/_test/globalSetup.ts +11 -0
  78. package/src/_test/index.ts +20 -0
  79. package/src/_test/setup.ts +8 -0
  80. package/src/_test/utils.ts +112 -0
  81. package/src/actions/index.test.ts +72 -0
  82. package/src/actions/index.ts +156 -0
  83. package/src/actions/public/call.bench.ts +48 -0
  84. package/src/actions/public/call.test.ts +99 -0
  85. package/src/actions/public/call.ts +96 -0
  86. package/src/actions/public/callContract.bench.ts +24 -0
  87. package/src/actions/public/callContract.test.ts +285 -0
  88. package/src/actions/public/callContract.ts +80 -0
  89. package/src/actions/public/createBlockFilter.bench.ts +11 -0
  90. package/src/actions/public/createBlockFilter.test.ts +9 -0
  91. package/src/actions/public/createBlockFilter.ts +14 -0
  92. package/src/actions/public/createEventFilter.test.ts +245 -0
  93. package/src/actions/public/createEventFilter.ts +81 -0
  94. package/src/actions/public/createPendingTransactionFilter.bench.ts +11 -0
  95. package/src/actions/public/createPendingTransactionFilter.test.ts +9 -0
  96. package/src/actions/public/createPendingTransactionFilter.ts +14 -0
  97. package/src/actions/public/deployContract.test.ts +56 -0
  98. package/src/actions/public/deployContract.ts +39 -0
  99. package/src/actions/public/estimateGas.bench.ts +46 -0
  100. package/src/actions/public/estimateGas.test.ts +92 -0
  101. package/src/actions/public/estimateGas.ts +61 -0
  102. package/src/actions/public/getBalance.test.ts +83 -0
  103. package/src/actions/public/getBalance.ts +37 -0
  104. package/src/actions/public/getBlock.bench.ts +28 -0
  105. package/src/actions/public/getBlock.test.ts +575 -0
  106. package/src/actions/public/getBlock.ts +66 -0
  107. package/src/actions/public/getBlockNumber.bench.ts +28 -0
  108. package/src/actions/public/getBlockNumber.test.ts +27 -0
  109. package/src/actions/public/getBlockNumber.ts +32 -0
  110. package/src/actions/public/getBlockTransactionCount.bench.ts +15 -0
  111. package/src/actions/public/getBlockTransactionCount.test.ts +57 -0
  112. package/src/actions/public/getBlockTransactionCount.ts +53 -0
  113. package/src/actions/public/getBytecode.test.ts +27 -0
  114. package/src/actions/public/getBytecode.ts +32 -0
  115. package/src/actions/public/getChainId.bench.ts +15 -0
  116. package/src/actions/public/getChainId.test.ts +8 -0
  117. package/src/actions/public/getChainId.ts +7 -0
  118. package/src/actions/public/getFeeHistory.bench.ts +18 -0
  119. package/src/actions/public/getFeeHistory.test.ts +137 -0
  120. package/src/actions/public/getFeeHistory.ts +44 -0
  121. package/src/actions/public/getFilterChanges.bench.ts +13 -0
  122. package/src/actions/public/getFilterChanges.test.ts +187 -0
  123. package/src/actions/public/getFilterChanges.ts +23 -0
  124. package/src/actions/public/getFilterLogs.test.ts +102 -0
  125. package/src/actions/public/getFilterLogs.ts +20 -0
  126. package/src/actions/public/getGasPrice.bench.ts +28 -0
  127. package/src/actions/public/getGasPrice.test.ts +8 -0
  128. package/src/actions/public/getGasPrice.ts +15 -0
  129. package/src/actions/public/getTransaction.bench.ts +33 -0
  130. package/src/actions/public/getTransaction.test.ts +311 -0
  131. package/src/actions/public/getTransaction.ts +96 -0
  132. package/src/actions/public/getTransactionConfirmations.test.ts +69 -0
  133. package/src/actions/public/getTransactionConfirmations.ts +39 -0
  134. package/src/actions/public/getTransactionCount.test.ts +56 -0
  135. package/src/actions/public/getTransactionCount.ts +34 -0
  136. package/src/actions/public/getTransactionReceipt.bench.ts +33 -0
  137. package/src/actions/public/getTransactionReceipt.test.ts +217 -0
  138. package/src/actions/public/getTransactionReceipt.ts +35 -0
  139. package/src/actions/public/index.test.ts +36 -0
  140. package/src/actions/public/index.ts +120 -0
  141. package/src/actions/public/uninstallFilter.bench.ts +13 -0
  142. package/src/actions/public/uninstallFilter.test.ts +65 -0
  143. package/src/actions/public/uninstallFilter.ts +17 -0
  144. package/src/actions/public/waitForTransactionReceipt.test.ts +322 -0
  145. package/src/actions/public/waitForTransactionReceipt.ts +171 -0
  146. package/src/actions/public/watchBlockNumber.test.ts +166 -0
  147. package/src/actions/public/watchBlockNumber.ts +79 -0
  148. package/src/actions/public/watchBlocks.test.ts +185 -0
  149. package/src/actions/public/watchBlocks.ts +95 -0
  150. package/src/actions/public/watchPendingTransactions.test.ts +116 -0
  151. package/src/actions/public/watchPendingTransactions.ts +73 -0
  152. package/src/actions/test/dropTransaction.test.ts +34 -0
  153. package/src/actions/test/dropTransaction.ts +17 -0
  154. package/src/actions/test/getAutomine.test.ts +14 -0
  155. package/src/actions/test/getAutomine.ts +11 -0
  156. package/src/actions/test/getTxpoolContent.test.ts +45 -0
  157. package/src/actions/test/getTxpoolContent.ts +7 -0
  158. package/src/actions/test/getTxpoolStatus.test.ts +41 -0
  159. package/src/actions/test/getTxpoolStatus.ts +12 -0
  160. package/src/actions/test/impersonateAccount.test.ts +28 -0
  161. package/src/actions/test/impersonateAccount.ts +17 -0
  162. package/src/actions/test/increaseTime.test.ts +18 -0
  163. package/src/actions/test/increaseTime.ts +17 -0
  164. package/src/actions/test/index.test.ts +38 -0
  165. package/src/actions/test/index.ts +77 -0
  166. package/src/actions/test/inspectTxpool.test.ts +50 -0
  167. package/src/actions/test/inspectTxpool.ts +7 -0
  168. package/src/actions/test/mine.test.ts +20 -0
  169. package/src/actions/test/mine.ts +16 -0
  170. package/src/actions/test/removeBlockTimestampInterval.test.ts +23 -0
  171. package/src/actions/test/removeBlockTimestampInterval.ts +7 -0
  172. package/src/actions/test/reset.test.ts +19 -0
  173. package/src/actions/test/reset.ts +18 -0
  174. package/src/actions/test/revert.test.ts +39 -0
  175. package/src/actions/test/revert.ts +14 -0
  176. package/src/actions/test/sendUnsignedTransaction.test.ts +52 -0
  177. package/src/actions/test/sendUnsignedTransaction.ts +19 -0
  178. package/src/actions/test/setAutomine.test.ts +14 -0
  179. package/src/actions/test/setAutomine.ts +8 -0
  180. package/src/actions/test/setBalance.test.ts +29 -0
  181. package/src/actions/test/setBalance.ts +20 -0
  182. package/src/actions/test/setBlockGasLimit.test.ts +21 -0
  183. package/src/actions/test/setBlockGasLimit.ts +17 -0
  184. package/src/actions/test/setBlockTimestampInterval.test.ts +23 -0
  185. package/src/actions/test/setBlockTimestampInterval.ts +16 -0
  186. package/src/actions/test/setCode.test.ts +26 -0
  187. package/src/actions/test/setCode.ts +19 -0
  188. package/src/actions/test/setCoinbase.test.ts +11 -0
  189. package/src/actions/test/setCoinbase.ts +17 -0
  190. package/src/actions/test/setIntervalMining.test.ts +30 -0
  191. package/src/actions/test/setIntervalMining.ts +16 -0
  192. package/src/actions/test/setLoggingEnabled.test.ts +10 -0
  193. package/src/actions/test/setLoggingEnabled.ts +8 -0
  194. package/src/actions/test/setMinGasPrice.test.ts +22 -0
  195. package/src/actions/test/setMinGasPrice.ts +17 -0
  196. package/src/actions/test/setNextBlockBaseFeePerGas.test.ts +23 -0
  197. package/src/actions/test/setNextBlockBaseFeePerGas.ts +17 -0
  198. package/src/actions/test/setNextBlockTimestamp.test.ts +19 -0
  199. package/src/actions/test/setNextBlockTimestamp.ts +17 -0
  200. package/src/actions/test/setNonce.test.ts +28 -0
  201. package/src/actions/test/setNonce.ts +20 -0
  202. package/src/actions/test/setRpcUrl.test.ts +9 -0
  203. package/src/actions/test/setRpcUrl.ts +8 -0
  204. package/src/actions/test/setStorageAt.test.ts +36 -0
  205. package/src/actions/test/setStorageAt.ts +26 -0
  206. package/src/actions/test/snapshot.test.ts +18 -0
  207. package/src/actions/test/snapshot.ts +7 -0
  208. package/src/actions/test/stopImpersonatingAccount.test.ts +31 -0
  209. package/src/actions/test/stopImpersonatingAccount.ts +17 -0
  210. package/src/actions/wallet/addChain.test.ts +14 -0
  211. package/src/actions/wallet/addChain.ts +21 -0
  212. package/src/actions/wallet/getAccounts.test.ts +22 -0
  213. package/src/actions/wallet/getAccounts.ts +7 -0
  214. package/src/actions/wallet/getPermissions.test.ts +24 -0
  215. package/src/actions/wallet/getPermissions.ts +9 -0
  216. package/src/actions/wallet/index.test.ts +19 -0
  217. package/src/actions/wallet/index.ts +27 -0
  218. package/src/actions/wallet/requestAccounts.test.ts +13 -0
  219. package/src/actions/wallet/requestAccounts.ts +7 -0
  220. package/src/actions/wallet/requestPermissions.test.ts +26 -0
  221. package/src/actions/wallet/requestPermissions.ts +19 -0
  222. package/src/actions/wallet/sendTransaction.bench.ts +57 -0
  223. package/src/actions/wallet/sendTransaction.test.ts +440 -0
  224. package/src/actions/wallet/sendTransaction.ts +76 -0
  225. package/src/actions/wallet/signMessage.test.ts +62 -0
  226. package/src/actions/wallet/signMessage.ts +35 -0
  227. package/src/actions/wallet/switchChain.test.ts +22 -0
  228. package/src/actions/wallet/switchChain.ts +19 -0
  229. package/src/actions/wallet/watchAsset.test.ts +41 -0
  230. package/src/actions/wallet/watchAsset.ts +16 -0
  231. package/src/chains.test.ts +1134 -0
  232. package/src/chains.ts +167 -0
  233. package/src/clients/createClient.test.ts +295 -0
  234. package/src/clients/createClient.ts +81 -0
  235. package/src/clients/createPublicClient.test.ts +165 -0
  236. package/src/clients/createPublicClient.ts +49 -0
  237. package/src/clients/createTestClient.test.ts +145 -0
  238. package/src/clients/createTestClient.ts +72 -0
  239. package/src/clients/createWalletClient.test.ts +121 -0
  240. package/src/clients/createWalletClient.ts +54 -0
  241. package/src/clients/index.test.ts +19 -0
  242. package/src/clients/index.ts +31 -0
  243. package/src/clients/transports/createTransport.test.ts +58 -0
  244. package/src/clients/transports/createTransport.ts +48 -0
  245. package/src/clients/transports/custom.test.ts +98 -0
  246. package/src/clients/transports/custom.ts +34 -0
  247. package/src/clients/transports/fallback.test.ts +223 -0
  248. package/src/clients/transports/fallback.ts +48 -0
  249. package/src/clients/transports/http.test.ts +110 -0
  250. package/src/clients/transports/http.ts +51 -0
  251. package/src/clients/transports/index.test.ts +15 -0
  252. package/src/clients/transports/index.ts +17 -0
  253. package/src/clients/transports/webSocket.test.ts +164 -0
  254. package/src/clients/transports/webSocket.ts +117 -0
  255. package/src/constants.test.ts +27 -0
  256. package/src/constants.ts +18 -0
  257. package/src/errors/abi.test.ts +83 -0
  258. package/src/errors/abi.ts +238 -0
  259. package/src/errors/address.test.ts +14 -0
  260. package/src/errors/address.ts +9 -0
  261. package/src/errors/base.test.ts +72 -0
  262. package/src/errors/base.ts +57 -0
  263. package/src/errors/block.test.ts +24 -0
  264. package/src/errors/block.ts +18 -0
  265. package/src/errors/contract.ts +125 -0
  266. package/src/errors/data.ts +20 -0
  267. package/src/errors/encoding.ts +60 -0
  268. package/src/errors/index.ts +77 -0
  269. package/src/errors/log.ts +8 -0
  270. package/src/errors/request.test.ts +331 -0
  271. package/src/errors/request.ts +163 -0
  272. package/src/errors/rpc.test.ts +88 -0
  273. package/src/errors/rpc.ts +113 -0
  274. package/src/errors/transaction.test.ts +83 -0
  275. package/src/errors/transaction.ts +54 -0
  276. package/src/errors/transport.test.ts +12 -0
  277. package/src/errors/transport.ts +12 -0
  278. package/src/index.test.ts +208 -0
  279. package/src/index.ts +353 -0
  280. package/src/public.ts +80 -0
  281. package/src/test.ts +51 -0
  282. package/src/types/block.ts +71 -0
  283. package/src/types/contract.ts +327 -0
  284. package/src/types/eip1193.ts +1038 -0
  285. package/src/types/fee.ts +47 -0
  286. package/src/types/filter.ts +8 -0
  287. package/src/types/index.ts +72 -0
  288. package/src/types/log.ts +22 -0
  289. package/src/types/misc.ts +4 -0
  290. package/src/types/rpc.ts +35 -0
  291. package/src/types/transaction.ts +145 -0
  292. package/src/types/utils.ts +67 -0
  293. package/src/types/window.ts +9 -0
  294. package/src/utils/abi/decodeAbi.bench.ts +135 -0
  295. package/src/utils/abi/decodeAbi.test.ts +1615 -0
  296. package/src/utils/abi/decodeAbi.ts +296 -0
  297. package/src/utils/abi/decodeDeployData.test.ts +159 -0
  298. package/src/utils/abi/decodeDeployData.ts +41 -0
  299. package/src/utils/abi/decodeErrorResult.test.ts +130 -0
  300. package/src/utils/abi/decodeErrorResult.ts +28 -0
  301. package/src/utils/abi/decodeFunctionData.test.ts +140 -0
  302. package/src/utils/abi/decodeFunctionData.ts +29 -0
  303. package/src/utils/abi/decodeFunctionResult.test.ts +262 -0
  304. package/src/utils/abi/decodeFunctionResult.ts +53 -0
  305. package/src/utils/abi/encodeAbi.bench.ts +163 -0
  306. package/src/utils/abi/encodeAbi.test.ts +1414 -0
  307. package/src/utils/abi/encodeAbi.ts +258 -0
  308. package/src/utils/abi/encodeDeployData.test.ts +131 -0
  309. package/src/utils/abi/encodeDeployData.ts +37 -0
  310. package/src/utils/abi/encodeErrorResult.test.ts +197 -0
  311. package/src/utils/abi/encodeErrorResult.ts +40 -0
  312. package/src/utils/abi/encodeEventTopics.test.ts +348 -0
  313. package/src/utils/abi/encodeEventTopics.ts +69 -0
  314. package/src/utils/abi/encodeFunctionData.test.ts +140 -0
  315. package/src/utils/abi/encodeFunctionData.ts +38 -0
  316. package/src/utils/abi/encodeFunctionResult.test.ts +284 -0
  317. package/src/utils/abi/encodeFunctionResult.ts +39 -0
  318. package/src/utils/abi/formatAbiItemWithArgs.test.ts +291 -0
  319. package/src/utils/abi/formatAbiItemWithArgs.ts +27 -0
  320. package/src/utils/abi/formatAbiItemWithParams.test.ts +335 -0
  321. package/src/utils/abi/formatAbiItemWithParams.ts +41 -0
  322. package/src/utils/abi/getAbiItem.ts +5 -0
  323. package/src/utils/abi/index.test.ts +23 -0
  324. package/src/utils/abi/index.ts +38 -0
  325. package/src/utils/address/getAddress.bench.ts +22 -0
  326. package/src/utils/address/getAddress.test.ts +46 -0
  327. package/src/utils/address/getAddress.ts +28 -0
  328. package/src/utils/address/getContractAddress.bench.ts +20 -0
  329. package/src/utils/address/getContractAddress.test.ts +78 -0
  330. package/src/utils/address/getContractAddress.ts +59 -0
  331. package/src/utils/address/index.test.ts +17 -0
  332. package/src/utils/address/index.ts +16 -0
  333. package/src/utils/address/isAddress.test.ts +10 -0
  334. package/src/utils/address/isAddress.ts +10 -0
  335. package/src/utils/address/isAddressEqual.test.ts +55 -0
  336. package/src/utils/address/isAddressEqual.ts +6 -0
  337. package/src/utils/buildRequest.test.ts +365 -0
  338. package/src/utils/buildRequest.ts +45 -0
  339. package/src/utils/contract/extractFunctionParts.test.ts +109 -0
  340. package/src/utils/contract/extractFunctionParts.ts +27 -0
  341. package/src/utils/contract/getContractError.test.ts +97 -0
  342. package/src/utils/contract/getContractError.ts +70 -0
  343. package/src/utils/contract/index.test.ts +15 -0
  344. package/src/utils/contract/index.ts +8 -0
  345. package/src/utils/data/concat.test.ts +35 -0
  346. package/src/utils/data/concat.ts +34 -0
  347. package/src/utils/data/index.test.ts +23 -0
  348. package/src/utils/data/index.ts +13 -0
  349. package/src/utils/data/isBytes.test.ts +9 -0
  350. package/src/utils/data/isBytes.ts +7 -0
  351. package/src/utils/data/isHex.test.ts +13 -0
  352. package/src/utils/data/isHex.ts +5 -0
  353. package/src/utils/data/pad.bench.ts +39 -0
  354. package/src/utils/data/pad.test.ts +367 -0
  355. package/src/utils/data/pad.ts +53 -0
  356. package/src/utils/data/size.test.ts +18 -0
  357. package/src/utils/data/size.ts +13 -0
  358. package/src/utils/data/slice.test.ts +203 -0
  359. package/src/utils/data/slice.ts +60 -0
  360. package/src/utils/data/trim.bench.ts +50 -0
  361. package/src/utils/data/trim.test.ts +175 -0
  362. package/src/utils/data/trim.ts +33 -0
  363. package/src/utils/encoding/decodeBytes.bench.ts +40 -0
  364. package/src/utils/encoding/decodeBytes.test.ts +144 -0
  365. package/src/utils/encoding/decodeBytes.ts +63 -0
  366. package/src/utils/encoding/decodeHex.bench.ts +24 -0
  367. package/src/utils/encoding/decodeHex.test.ts +167 -0
  368. package/src/utils/encoding/decodeHex.ts +76 -0
  369. package/src/utils/encoding/decodeRlp.bench.ts +34 -0
  370. package/src/utils/encoding/decodeRlp.test.ts +350 -0
  371. package/src/utils/encoding/decodeRlp.ts +121 -0
  372. package/src/utils/encoding/encodeBytes.bench.ts +41 -0
  373. package/src/utils/encoding/encodeBytes.test.ts +676 -0
  374. package/src/utils/encoding/encodeBytes.ts +59 -0
  375. package/src/utils/encoding/encodeHex.bench.ts +60 -0
  376. package/src/utils/encoding/encodeHex.test.ts +232 -0
  377. package/src/utils/encoding/encodeHex.ts +104 -0
  378. package/src/utils/encoding/encodeRlp.bench.ts +54 -0
  379. package/src/utils/encoding/encodeRlp.test.ts +254 -0
  380. package/src/utils/encoding/encodeRlp.ts +48 -0
  381. package/src/utils/encoding/index.test.ts +32 -0
  382. package/src/utils/encoding/index.ts +36 -0
  383. package/src/utils/formatters/block.bench.ts +51 -0
  384. package/src/utils/formatters/block.test.ts +115 -0
  385. package/src/utils/formatters/block.ts +36 -0
  386. package/src/utils/formatters/extract.test.ts +14 -0
  387. package/src/utils/formatters/extract.ts +18 -0
  388. package/src/utils/formatters/feeHistory.test.ts +66 -0
  389. package/src/utils/formatters/feeHistory.ts +12 -0
  390. package/src/utils/formatters/format.test.ts +93 -0
  391. package/src/utils/formatters/format.ts +53 -0
  392. package/src/utils/formatters/index.test.ts +17 -0
  393. package/src/utils/formatters/index.ts +24 -0
  394. package/src/utils/formatters/log.test.ts +79 -0
  395. package/src/utils/formatters/log.ts +12 -0
  396. package/src/utils/formatters/transaction.test.ts +271 -0
  397. package/src/utils/formatters/transaction.ts +51 -0
  398. package/src/utils/formatters/transactionReceipt.bench.ts +73 -0
  399. package/src/utils/formatters/transactionReceipt.test.ts +151 -0
  400. package/src/utils/formatters/transactionReceipt.ts +54 -0
  401. package/src/utils/formatters/transactionRequest.bench.ts +29 -0
  402. package/src/utils/formatters/transactionRequest.test.ts +237 -0
  403. package/src/utils/formatters/transactionRequest.ts +47 -0
  404. package/src/utils/hash/getEventSignature.test.ts +61 -0
  405. package/src/utils/hash/getEventSignature.ts +4 -0
  406. package/src/utils/hash/getFunctionSignature.test.ts +22 -0
  407. package/src/utils/hash/getFunctionSignature.ts +5 -0
  408. package/src/utils/hash/hashFunction.test.ts +65 -0
  409. package/src/utils/hash/hashFunction.ts +12 -0
  410. package/src/utils/hash/index.test.ts +13 -0
  411. package/src/utils/hash/index.ts +5 -0
  412. package/src/utils/hash/keccak256.test.ts +59 -0
  413. package/src/utils/hash/keccak256.ts +23 -0
  414. package/src/utils/index.test.ts +87 -0
  415. package/src/utils/index.ts +126 -0
  416. package/src/utils/observe.test.ts +176 -0
  417. package/src/utils/observe.ts +66 -0
  418. package/src/utils/poll.test.ts +127 -0
  419. package/src/utils/poll.ts +42 -0
  420. package/src/utils/promise/index.test.ts +14 -0
  421. package/src/utils/promise/index.ts +3 -0
  422. package/src/utils/promise/withCache.test.ts +97 -0
  423. package/src/utils/promise/withCache.ts +73 -0
  424. package/src/utils/promise/withRetry.test.ts +231 -0
  425. package/src/utils/promise/withRetry.ts +61 -0
  426. package/src/utils/promise/withTimeout.test.ts +37 -0
  427. package/src/utils/promise/withTimeout.ts +39 -0
  428. package/src/utils/rpc.test.ts +992 -0
  429. package/src/utils/rpc.ts +292 -0
  430. package/src/utils/stringify.test.ts +13 -0
  431. package/src/utils/stringify.ts +5 -0
  432. package/src/utils/uid.ts +14 -0
  433. package/src/utils/unit/formatEther.test.ts +75 -0
  434. package/src/utils/unit/formatEther.ts +6 -0
  435. package/src/utils/unit/formatGwei.test.ts +32 -0
  436. package/src/utils/unit/formatGwei.ts +6 -0
  437. package/src/utils/unit/formatUnit.bench.ts +26 -0
  438. package/src/utils/unit/formatUnit.test.ts +40 -0
  439. package/src/utils/unit/formatUnit.ts +16 -0
  440. package/src/utils/unit/index.test.ts +16 -0
  441. package/src/utils/unit/index.ts +6 -0
  442. package/src/utils/unit/parseEther.test.ts +126 -0
  443. package/src/utils/unit/parseEther.ts +6 -0
  444. package/src/utils/unit/parseGwei.test.ts +50 -0
  445. package/src/utils/unit/parseGwei.ts +6 -0
  446. package/src/utils/unit/parseUnit.bench.ts +26 -0
  447. package/src/utils/unit/parseUnit.test.ts +54 -0
  448. package/src/utils/unit/parseUnit.ts +27 -0
  449. package/src/utils/wait.ts +3 -0
  450. package/src/wallet.ts +23 -0
  451. package/src/window.ts +1 -0
  452. package/actions/package.json +0 -4
  453. package/dist/actions/index.d.ts +0 -8
  454. package/dist/actions/index.js +0 -129
  455. package/dist/actions/index.mjs +0 -129
  456. package/dist/createWalletClient-3f9fa8b6.d.ts +0 -130
@@ -0,0 +1,1038 @@
1
+ import type { BlockTag } from './block'
2
+ import type { Address, Hash, Hex } from './misc'
3
+ import type {
4
+ RpcBlock as Block,
5
+ RpcBlockIdentifier as BlockIdentifier,
6
+ RpcBlockNumber as BlockNumber,
7
+ RpcEstimateGasParameters as EstimateGasParameters,
8
+ RpcFeeHistory as FeeHistory,
9
+ RpcLog as Log,
10
+ Quantity,
11
+ RpcTransaction as Transaction,
12
+ RpcTransactionReceipt as TransactionReceipt,
13
+ RpcTransactionRequest as TransactionRequest,
14
+ RpcUncle as Uncle,
15
+ } from './rpc'
16
+
17
+ //////////////////////////////////////////////////
18
+ // Errors
19
+
20
+ export class RpcError extends Error {
21
+ code: number
22
+ details: string
23
+
24
+ constructor(code: number, message: string) {
25
+ super(message)
26
+ this.code = code
27
+ this.details = message
28
+ }
29
+ }
30
+
31
+ //////////////////////////////////////////////////
32
+ // Provider Events
33
+
34
+ export type ProviderConnectInfo = {
35
+ chainId: string
36
+ }
37
+
38
+ export type ProviderMessage = {
39
+ type: string
40
+ data: unknown
41
+ }
42
+
43
+ export type Events = {
44
+ on(
45
+ event: 'connect',
46
+ listener: (connectInfo: ProviderConnectInfo) => void,
47
+ ): void
48
+ on(event: 'disconnect', listener: (error: RpcError) => void): void
49
+ on(event: 'chainChanged', listener: (chainId: string) => void): void
50
+ on(event: 'accountsChanged', listener: (accounts: string[]) => void): void
51
+ on(event: 'message', listener: (message: ProviderMessage) => void): void
52
+
53
+ removeListener(
54
+ event: 'connect',
55
+ listener: (connectInfo: ProviderConnectInfo) => void,
56
+ ): void
57
+ removeListener(event: 'disconnect', listener: (error: RpcError) => void): void
58
+ removeListener(
59
+ event: 'chainChanged',
60
+ listener: (chainId: string) => void,
61
+ ): void
62
+ removeListener(
63
+ event: 'accountsChanged',
64
+ listener: (accounts: Address[]) => void,
65
+ ): void
66
+ removeListener(
67
+ event: 'message',
68
+ listener: (message: ProviderMessage) => void,
69
+ ): void
70
+ }
71
+
72
+ //////////////////////////////////////////////////
73
+ // Provider Requests
74
+
75
+ export type Chain = {
76
+ /** A 0x-prefixed hexadecimal string */
77
+ chainId: string
78
+ /** The chain name. */
79
+ chainName: string
80
+ /** Native currency for the chain. */
81
+ nativeCurrency?: {
82
+ name: string
83
+ symbol: string
84
+ decimals: number
85
+ }
86
+ rpcUrls: readonly string[]
87
+ blockExplorerUrls?: string[]
88
+ iconUrls?: string[]
89
+ }
90
+
91
+ export type NetworkSync = {
92
+ /** The current block number */
93
+ currentBlock: Quantity
94
+ /** Number of latest block on the network */
95
+ highestBlock: Quantity
96
+ /** Block number at which syncing started */
97
+ startingBlock: Quantity
98
+ }
99
+
100
+ export type WalletPermissionCaveat = {
101
+ type: string
102
+ value: any
103
+ }
104
+
105
+ export type WalletPermission = {
106
+ caveats: WalletPermissionCaveat[]
107
+ date: number
108
+ id: string
109
+ invoker: `http://${string}` | `https://${string}`
110
+ parentCapability: 'eth_accounts' | string
111
+ }
112
+
113
+ export type WatchAssetParams = {
114
+ /** Token type. */
115
+ type: 'ERC20'
116
+ options: {
117
+ /** The address of the token contract */
118
+ address: string
119
+ /** A ticker symbol or shorthand, up to 11 characters */
120
+ symbol: string
121
+ /** The number of token decimals */
122
+ decimals: number
123
+ /** A string url of the token logo */
124
+ image: string
125
+ }
126
+ }
127
+
128
+ export type PublicRequests = {
129
+ request(args: {
130
+ /**
131
+ * @description Returns the version of the current client
132
+ * @link https://eips.ethereum.org/EIPS/eip-1474
133
+ * @example
134
+ * provider.request({ method: 'web3_clientVersion' })
135
+ * // => 'MetaMask/v1.0.0'
136
+ */
137
+ method: 'web3_clientVersion'
138
+ params?: never
139
+ }): Promise<string>
140
+ request(args: {
141
+ /**
142
+ * @description Hashes data using the Keccak-256 algorithm
143
+ * @link https://eips.ethereum.org/EIPS/eip-1474
144
+ * @example
145
+ * provider.request({ method: 'web3_sha3', params: ['0x68656c6c6f20776f726c64'] })
146
+ * // => '0xc94770007dda54cF92009BFF0dE90c06F603a09f'
147
+ */
148
+ method: 'web3_sha3'
149
+ params: [data: Hash]
150
+ }): Promise<string>
151
+ request(args: {
152
+ /**
153
+ * @description Determines if this client is listening for new network connections
154
+ * @link https://eips.ethereum.org/EIPS/eip-1474
155
+ * @example
156
+ * provider.request({ method: 'net_listening' })
157
+ * // => true
158
+ */
159
+ method: 'net_listening'
160
+ params?: never
161
+ }): Promise<boolean>
162
+ request(args: {
163
+ /**
164
+ * @description Returns the number of peers currently connected to this client
165
+ * @link https://eips.ethereum.org/EIPS/eip-1474
166
+ * @example
167
+ * provider.request({ method: 'net_peerCount' })
168
+ * // => '0x1'
169
+ */
170
+ method: 'net_peerCount'
171
+ params?: never
172
+ }): Promise<Quantity>
173
+ request(args: {
174
+ /**
175
+ * @description Returns the chain ID associated with the current network
176
+ * @link https://eips.ethereum.org/EIPS/eip-1474
177
+ * @example
178
+ * provider.request({ method: 'net_version' })
179
+ * // => '1'
180
+ */
181
+ method: 'net_version'
182
+ params?: never
183
+ }): Promise<Quantity>
184
+ request(args: {
185
+ /**
186
+ * @description Returns the number of the most recent block seen by this client
187
+ * @link https://eips.ethereum.org/EIPS/eip-1474
188
+ * @example
189
+ * provider.request({ method: 'eth_blockNumber' })
190
+ * // => '0x1b4'
191
+ * */
192
+ method: 'eth_blockNumber'
193
+ params?: never
194
+ }): Promise<Quantity>
195
+ request(args: {
196
+ /**
197
+ * @description Executes a new message call immediately without submitting a transaction to the network
198
+ * @link https://eips.ethereum.org/EIPS/eip-1474
199
+ * @example
200
+ * provider.request({ method: 'eth_call', params: [{ to: '0x...', data: '0x...' }] })
201
+ * // => '0x...'
202
+ */
203
+ method: 'eth_call'
204
+ params: [
205
+ request: TransactionRequest,
206
+ block: BlockNumber | BlockTag | BlockIdentifier,
207
+ ]
208
+ }): Promise<Hex>
209
+ request(args: {
210
+ /**
211
+ * @description Returns the chain ID associated with the current network
212
+ * @example
213
+ * provider.request({ method: 'eth_chainId' })
214
+ * // => '1'
215
+ */
216
+ method: 'eth_chainId'
217
+ params?: never
218
+ }): Promise<Quantity>
219
+ request(args: { method: 'eth_coinbase'; params?: never }): Promise<Address>
220
+ request(args: {
221
+ /**
222
+ * @description Estimates the gas necessary to complete a transaction without submitting it to the network
223
+ * @link https://eips.ethereum.org/EIPS/eip-1474
224
+ * @example
225
+ * provider.request({
226
+ * method: 'eth_estimateGas',
227
+ * params: [{ from: '0x...', to: '0x...', value: '0x...' }]
228
+ * })
229
+ * // => '0x5208'
230
+ * */
231
+ method: 'eth_estimateGas'
232
+ params: [parameters: EstimateGasParameters, block: BlockNumber | BlockTag]
233
+ }): Promise<Quantity>
234
+ request(args: {
235
+ /**
236
+ * @description Returns a collection of historical gas information
237
+ * @link https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1559.md
238
+ * @example
239
+ * provider.request({
240
+ * method: 'eth_feeHistory',
241
+ * params: ['4', 'latest', ['25', '75']]
242
+ * })
243
+ * // => {
244
+ * // oldestBlock: '0x1',
245
+ * // baseFeePerGas: ['0x1', '0x2', '0x3', '0x4'],
246
+ * // gasUsedRatio: ['0x1', '0x2', '0x3', '0x4'],
247
+ * // reward: [['0x1', '0x2'], ['0x3', '0x4'], ['0x5', '0x6'], ['0x7', '0x8']]
248
+ * // }
249
+ * */
250
+ method: 'eth_feeHistory'
251
+ params: [
252
+ /** Number of blocks in the requested range. Between 1 and 1024 blocks can be requested in a single query. Less than requested may be returned if not all blocks are available. */
253
+ blockCount: Quantity,
254
+ /** Highest number block of the requested range. */
255
+ newestBlock: BlockNumber | BlockTag,
256
+ /** A monotonically increasing list of percentile values to sample from each block's effective priority fees per gas in ascending order, weighted by gas used. */
257
+ rewardPercentiles: number[] | undefined,
258
+ ]
259
+ }): Promise<FeeHistory>
260
+ request(args: {
261
+ /**
262
+ * @description Returns the current price of gas expressed in wei
263
+ * @link https://eips.ethereum.org/EIPS/eip-1474
264
+ * @example
265
+ * provider.request({ method: 'eth_gasPrice' })
266
+ * // => '0x09184e72a000'
267
+ * */
268
+ method: 'eth_gasPrice'
269
+ params?: never
270
+ }): Promise<Quantity>
271
+ request(args: {
272
+ /**
273
+ * @description Returns the balance of an address in wei
274
+ * @link https://eips.ethereum.org/EIPS/eip-1474
275
+ * @example
276
+ * provider.request({ method: 'eth_getBalance', params: ['0x...', 'latest'] })
277
+ * // => '0x12a05...'
278
+ * */
279
+ method: 'eth_getBalance'
280
+ params: [address: Address, block: BlockNumber | BlockTag | BlockIdentifier]
281
+ }): Promise<Quantity>
282
+ request(args: {
283
+ /**
284
+ * @description Returns information about a block specified by hash
285
+ * @link https://eips.ethereum.org/EIPS/eip-1474
286
+ * @example
287
+ * provider.request({ method: 'eth_getBlockByHash', params: ['0x...', true] })
288
+ * // => {
289
+ * // number: '0x1b4',
290
+ * // hash: '0x...',
291
+ * // parentHash: '0x...',
292
+ * // ...
293
+ * // }
294
+ * */
295
+ method: 'eth_getBlockByHash'
296
+ params: [
297
+ /** hash of a block */
298
+ hash: Hash,
299
+ /** true will pull full transaction objects, false will pull transaction hashes */
300
+ includeTransactionObjects: boolean,
301
+ ]
302
+ }): Promise<Block | null>
303
+ request(args: {
304
+ /**
305
+ * @description Returns information about a block specified by number
306
+ * @link https://eips.ethereum.org/EIPS/eip-1474
307
+ * @example
308
+ * provider.request({ method: 'eth_getBlockByNumber', params: ['0x1b4', true] })
309
+ * // => {
310
+ * // number: '0x1b4',
311
+ * // hash: '0x...',
312
+ * // parentHash: '0x...',
313
+ * // ...
314
+ * // }
315
+ * */
316
+ method: 'eth_getBlockByNumber'
317
+ params: [
318
+ /** block number, or one of "latest", "safe", "finalized", "earliest" or "pending" */
319
+ block: BlockNumber | BlockTag,
320
+ /** true will pull full transaction objects, false will pull transaction hashes */
321
+ includeTransactionObjects: boolean,
322
+ ]
323
+ }): Promise<Block | null>
324
+ request(args: {
325
+ /**
326
+ * @description Returns the number of transactions in a block specified by block hash
327
+ * @link https://eips.ethereum.org/EIPS/eip-1474
328
+ * @example
329
+ * provider.request({ method: 'eth_getBlockTransactionCountByHash', params: ['0x...'] })
330
+ * // => '0x1'
331
+ * */
332
+ method: 'eth_getBlockTransactionCountByHash'
333
+ params: [hash: Hash]
334
+ }): Promise<Quantity>
335
+ request(args: {
336
+ /**
337
+ * @description Returns the number of transactions in a block specified by block number
338
+ * @link https://eips.ethereum.org/EIPS/eip-1474
339
+ * @example
340
+ * provider.request({ method: 'eth_getBlockTransactionCountByNumber', params: ['0x1b4'] })
341
+ * // => '0x1'
342
+ * */
343
+ method: 'eth_getBlockTransactionCountByNumber'
344
+ params: [block: BlockNumber | BlockTag]
345
+ }): Promise<Quantity>
346
+ request(args: {
347
+ /**
348
+ * @description Returns the contract code stored at a given address
349
+ * @link https://eips.ethereum.org/EIPS/eip-1474
350
+ * @example
351
+ * provider.request({ method: 'eth_getCode', params: ['0x...', 'latest'] })
352
+ * // => '0x...'
353
+ * */
354
+ method: 'eth_getCode'
355
+ params: [address: Address, block: BlockNumber | BlockTag | BlockIdentifier]
356
+ }): Promise<Hex>
357
+ request(args: {
358
+ /**
359
+ * @description Returns a list of all logs based on filter ID since the last log retrieval
360
+ * @link https://eips.ethereum.org/EIPS/eip-1474
361
+ * @example
362
+ * provider.request({ method: 'eth_getFilterChanges', params: ['0x...'] })
363
+ * // => [{ ... }, { ... }]
364
+ * */
365
+ method: 'eth_getFilterChanges'
366
+ params: [filterId: Quantity]
367
+ }): Promise<Log[] | Hex[]>
368
+ request(args: {
369
+ /**
370
+ * @description Returns a list of all logs based on filter ID
371
+ * @link https://eips.ethereum.org/EIPS/eip-1474
372
+ * @example
373
+ * provider.request({ method: 'eth_getFilterLogs', params: ['0x...'] })
374
+ * // => [{ ... }, { ... }]
375
+ * */
376
+ method: 'eth_getFilterLogs'
377
+ params: [filterId: Quantity]
378
+ }): Promise<Log[]>
379
+ request(args: {
380
+ /**
381
+ * @description Returns a list of all logs based on a filter object
382
+ * @link https://eips.ethereum.org/EIPS/eip-1474
383
+ * @example
384
+ * provider.request({ method: 'eth_getLogs', params: [{ ... }] })
385
+ * // => [{ ... }, { ... }]
386
+ * */
387
+ method: 'eth_getLogs'
388
+ params: [
389
+ filter: {
390
+ address?: Address | Address[]
391
+ topics?: Hex[]
392
+ } & (
393
+ | {
394
+ fromBlock?: BlockNumber | BlockTag
395
+ toBlock?: BlockNumber | BlockTag
396
+ }
397
+ | {
398
+ blockHash?: Hash
399
+ }
400
+ ),
401
+ ]
402
+ }): Promise<Log>
403
+ request(args: {
404
+ /**
405
+ * @description Returns the value from a storage position at an address
406
+ * @link https://eips.ethereum.org/EIPS/eip-1474
407
+ * @example
408
+ * provider.request({ method: 'eth_getStorageAt', params: ['0x...', '0x...', 'latest'] })
409
+ * // => '0x...'
410
+ * */
411
+ method: 'eth_getStorageAt'
412
+ params: [
413
+ address: Address,
414
+ index: Quantity,
415
+ block: BlockNumber | BlockTag | BlockIdentifier,
416
+ ]
417
+ }): Promise<Log>
418
+ request(args: {
419
+ /**
420
+ * @description Returns information about a transaction specified by block hash and transaction index
421
+ * @link https://eips.ethereum.org/EIPS/eip-1474
422
+ * @example
423
+ * provider.request({ method: 'eth_getTransactionByBlockHashAndIndex', params: ['0x...', '0x...'] })
424
+ * // => { ... }
425
+ * */
426
+ method: 'eth_getTransactionByBlockHashAndIndex'
427
+ params: [hash: Hash, index: Quantity]
428
+ }): Promise<Transaction | null>
429
+ request(args: {
430
+ /**
431
+ * @description Returns information about a transaction specified by block number and transaction index
432
+ * @link https://eips.ethereum.org/EIPS/eip-1474
433
+ * @example
434
+ * provider.request({ method: 'eth_getTransactionByBlockNumberAndIndex', params: ['0x...', '0x...'] })
435
+ * // => { ... }
436
+ * */
437
+ method: 'eth_getTransactionByBlockNumberAndIndex'
438
+ params: [block: BlockNumber | BlockTag, index: Quantity]
439
+ }): Promise<Transaction | null>
440
+ request(args: {
441
+ /**
442
+ * @description Returns information about a transaction specified by hash
443
+ * @link https://eips.ethereum.org/EIPS/eip-1474
444
+ * @example
445
+ * provider.request({ method: 'eth_getTransactionByHash', params: ['0x...'] })
446
+ * // => { ... }
447
+ * */
448
+ method: 'eth_getTransactionByHash'
449
+ params: [hash: Hash]
450
+ }): Promise<Transaction | null>
451
+ request(args: {
452
+ /**
453
+ * @description Returns the number of transactions sent from an address
454
+ * @link https://eips.ethereum.org/EIPS/eip-1474
455
+ * @example
456
+ * provider.request({ method: 'eth_getTransactionCount', params: ['0x...', 'latest'] })
457
+ * // => '0x1'
458
+ * */
459
+ method: 'eth_getTransactionCount'
460
+ params: [address: Address, block: BlockNumber | BlockTag | BlockIdentifier]
461
+ }): Promise<Quantity>
462
+ request(args: {
463
+ /**
464
+ * @description Returns the receipt of a transaction specified by hash
465
+ * @link https://eips.ethereum.org/EIPS/eip-1474
466
+ * @example
467
+ * provider.request({ method: 'eth_getTransactionReceipt', params: ['0x...'] })
468
+ * // => { ... }
469
+ * */
470
+ method: 'eth_getTransactionReceipt'
471
+ params: [hash: Hash]
472
+ }): Promise<TransactionReceipt | null>
473
+ request(args: {
474
+ /**
475
+ * @description Returns information about an uncle specified by block hash and uncle index position
476
+ * @link https://eips.ethereum.org/EIPS/eip-1474
477
+ * @example
478
+ * provider.request({ method: 'eth_getUncleByBlockHashAndIndex', params: ['0x...', '0x...'] })
479
+ * // => { ... }
480
+ * */
481
+ method: 'eth_getUncleByBlockHashAndIndex'
482
+ params: [hash: Hash, index: Quantity]
483
+ }): Promise<Uncle | null>
484
+ request(args: {
485
+ /**
486
+ * @description Returns information about an uncle specified by block number and uncle index position
487
+ * @link https://eips.ethereum.org/EIPS/eip-1474
488
+ * @example
489
+ * provider.request({ method: 'eth_getUncleByBlockNumberAndIndex', params: ['0x...', '0x...'] })
490
+ * // => { ... }
491
+ * */
492
+ method: 'eth_getUncleByBlockNumberAndIndex'
493
+ params: [block: BlockNumber | BlockTag, index: Quantity]
494
+ }): Promise<Uncle | null>
495
+ request(args: {
496
+ /**
497
+ * @description Returns the number of uncles in a block specified by block hash
498
+ * @link https://eips.ethereum.org/EIPS/eip-1474
499
+ * @example
500
+ * provider.request({ method: 'eth_getUncleCountByBlockHash', params: ['0x...'] })
501
+ * // => '0x1'
502
+ * */
503
+ method: 'eth_getUncleCountByBlockHash'
504
+ params: [hash: Hash]
505
+ }): Promise<Quantity>
506
+ request(args: {
507
+ /**
508
+ * @description Returns the number of uncles in a block specified by block number
509
+ * @link https://eips.ethereum.org/EIPS/eip-1474
510
+ * @example
511
+ * provider.request({ method: 'eth_getUncleCountByBlockNumber', params: ['0x...'] })
512
+ * // => '0x1'
513
+ * */
514
+ method: 'eth_getUncleCountByBlockNumber'
515
+ params: [block: BlockNumber | BlockTag]
516
+ }): Promise<Quantity>
517
+ request(args: {
518
+ /**
519
+ * @description Creates a filter to listen for new blocks that can be used with `eth_getFilterChanges`
520
+ * @link https://eips.ethereum.org/EIPS/eip-1474
521
+ * @example
522
+ * provider.request({ method: 'eth_newBlockFilter' })
523
+ * // => '0x1'
524
+ * */
525
+ method: 'eth_newBlockFilter'
526
+ params?: never
527
+ }): Promise<Quantity>
528
+ request(args: {
529
+ /**
530
+ * @description Creates a filter to listen for specific state changes that can then be used with `eth_getFilterChanges`
531
+ * @link https://eips.ethereum.org/EIPS/eip-1474
532
+ * @example
533
+ * provider.request({ method: 'eth_newFilter', params: [{ fromBlock: '0x...', toBlock: '0x...', address: '0x...', topics: ['0x...'] }] })
534
+ * // => '0x1'
535
+ * */
536
+ method: 'eth_newFilter'
537
+ params: [
538
+ filter: {
539
+ fromBlock?: BlockNumber | BlockTag
540
+ toBlock?: BlockNumber | BlockTag
541
+ address?: Address | Address[]
542
+ topics?: (Hex | Hex[] | null)[]
543
+ },
544
+ ]
545
+ }): Promise<Quantity>
546
+ request(args: {
547
+ /**
548
+ * @description Creates a filter to listen for new pending transactions that can be used with `eth_getFilterChanges`
549
+ * @link https://eips.ethereum.org/EIPS/eip-1474
550
+ * @example
551
+ * provider.request({ method: 'eth_newPendingTransactionFilter' })
552
+ * // => '0x1'
553
+ * */
554
+ method: 'eth_newPendingTransactionFilter'
555
+ params?: never
556
+ }): Promise<Quantity>
557
+ request(args: {
558
+ /**
559
+ * @description Returns the current Ethereum protocol version
560
+ * @link https://eips.ethereum.org/EIPS/eip-1474
561
+ * @example
562
+ * provider.request({ method: 'eth_protocolVersion' })
563
+ * // => '54'
564
+ * */
565
+ method: 'eth_protocolVersion'
566
+ params?: never
567
+ }): Promise<string>
568
+ request(args: {
569
+ /**
570
+ * @description Sends and already-signed transaction to the network
571
+ * @link https://eips.ethereum.org/EIPS/eip-1474
572
+ * @example
573
+ * provider.request({ method: 'eth_sendRawTransaction', params: ['0x...'] })
574
+ * // => '0x...'
575
+ * */
576
+ method: 'eth_sendRawTransaction'
577
+ params: [signedTransaction: Hex]
578
+ }): Promise<Hex>
579
+ request(args: {
580
+ /**
581
+ * @description Destroys a filter based on filter ID
582
+ * @link https://eips.ethereum.org/EIPS/eip-1474
583
+ * @example
584
+ * provider.request({ method: 'eth_uninstallFilter', params: ['0x1'] })
585
+ * // => true
586
+ * */
587
+ method: 'eth_uninstallFilter'
588
+ params: [
589
+ /** ID of the filter to destroy */
590
+ filterId: Quantity,
591
+ ]
592
+ }): Promise<boolean>
593
+ }
594
+
595
+ export type TestRequests<Name extends string> = {
596
+ request(args: {
597
+ /**
598
+ * @description Add information about compiled contracts
599
+ * @link https://hardhat.org/hardhat-network/docs/reference#hardhat_addcompilationresult
600
+ */
601
+ method: `${Name}_addCompilationResult`
602
+ params: any[]
603
+ }): Promise<any>
604
+ request(args: {
605
+ /**
606
+ * @description Remove a transaction from the mempool
607
+ * @link https://hardhat.org/hardhat-network/docs/reference#hardhat_droptransaction
608
+ */
609
+ method: `${Name}_dropTransaction`
610
+ params: [hash: Hash]
611
+ }): Promise<void>
612
+ request(args: {
613
+ /**
614
+ * @description Turn on call traces for transactions that are returned to the user when they execute a transaction (instead of just txhash/receipt).
615
+ */
616
+ method: `${Name}_enableTraces`
617
+ params?: never
618
+ }): Promise<void>
619
+ request(args: {
620
+ /**
621
+ * @description Impersonate an account or contract address.
622
+ * @link https://hardhat.org/hardhat-network/docs/reference#hardhat_impersonateaccount
623
+ */
624
+ method: `${Name}_impersonateAccount`
625
+ params: [address: Address]
626
+ }): Promise<void>
627
+ request(args: {
628
+ /**
629
+ * @description Returns true if automatic mining is enabled, and false otherwise. See [Mining Modes](https://hardhat.org/hardhat-network/explanation/mining-modes) to learn more.
630
+ * @link https://hardhat.org/hardhat-network/docs/reference#hardhat_getautomine
631
+ */
632
+ method: `${Name}_getAutomine`
633
+ }): Promise<boolean>
634
+ request(args: {
635
+ /**
636
+ * @description Advance the block number of the network by a certain number of blocks
637
+ * @link https://hardhat.org/hardhat-network/docs/reference#hardhat_mine
638
+ */
639
+ method: `${Name}_mine`
640
+ params: [
641
+ /** Number of blocks to mine. */
642
+ count: Hex,
643
+ /** Interval between each block in seconds. */
644
+ interval: Hex | undefined,
645
+ ]
646
+ }): Promise<void>
647
+ request(args: {
648
+ /**
649
+ * @description Resets the fork.
650
+ * @link https://hardhat.org/hardhat-network/docs/reference#hardhat_reset
651
+ */
652
+ method: `${Name}_reset`
653
+ params: any[]
654
+ }): Promise<void>
655
+ request(args: {
656
+ /**
657
+ * @description Modifies the balance of an account.
658
+ * @link https://hardhat.org/hardhat-network/docs/reference#hardhat_setbalance
659
+ */
660
+ method: `${Name}_setBalance`
661
+ params: [
662
+ /** The address of the target account. */
663
+ address: Address,
664
+ /** Amount to send in wei. */
665
+ value: Quantity,
666
+ ]
667
+ }): Promise<void>
668
+ request(args: {
669
+ /**
670
+ * @description Modifies the bytecode stored at an account's address.
671
+ * @link https://hardhat.org/hardhat-network/docs/reference#hardhat_setcode
672
+ */
673
+ method: `${Name}_setCode`
674
+ params: [
675
+ /** The address of the contract. */
676
+ address: Address,
677
+ /** Data bytecode. */
678
+ data: string,
679
+ ]
680
+ }): Promise<void>
681
+ request(args: {
682
+ /**
683
+ * @description Sets the coinbase address to be used in new blocks.
684
+ * @link https://hardhat.org/hardhat-network/docs/reference#hardhat_setcoinbase
685
+ */
686
+ method: `${Name}_setCoinbase`
687
+ params: [
688
+ /** The address to set as the coinbase address. */
689
+ address: Address,
690
+ ]
691
+ }): Promise<void>
692
+ request(args: {
693
+ /**
694
+ * @description Enable or disable logging on the test node network.
695
+ * @link https://hardhat.org/hardhat-network/docs/reference#hardhat_setcoinbase
696
+ */
697
+ method: `${Name}_setLoggingEnabled`
698
+ params: [enabled: boolean]
699
+ }): Promise<void>
700
+ request(args: {
701
+ /**
702
+ * @description Change the minimum gas price accepted by the network (in wei).
703
+ * @link https://hardhat.org/hardhat-network/docs/reference#hardhat_setmingasprice
704
+ */
705
+ method: `${Name}_setMinGasPrice`
706
+ params: [gasPrice: Quantity]
707
+ }): Promise<void>
708
+ request(args: {
709
+ /**
710
+ * @description Sets the base fee of the next block.
711
+ * @link https://hardhat.org/hardhat-network/docs/reference#hardhat_setnextblockbasefeepergas
712
+ */
713
+ method: `${Name}_setNextBlockBaseFeePerGas`
714
+ params: [baseFeePerGas: Quantity]
715
+ }): Promise<void>
716
+ request(args: {
717
+ /**
718
+ * @description Modifies an account's nonce by overwriting it.
719
+ * @link https://hardhat.org/hardhat-network/docs/reference#hardhat_setnonce
720
+ */
721
+ method: `${Name}_setNonce`
722
+ params: [
723
+ /** The account address. */
724
+ address: Address,
725
+ /** The new nonce. */
726
+ nonce: Quantity,
727
+ ]
728
+ }): Promise<void>
729
+ request(args: {
730
+ /**
731
+ * @description Sets the backend RPC URL.
732
+ */
733
+ method: `${Name}_setRpcUrl`
734
+ params: [url: string]
735
+ }): Promise<void>
736
+ request(args: {
737
+ /**
738
+ * @description Writes a single position of an account's storage.
739
+ * @link https://hardhat.org/hardhat-network/docs/reference#hardhat_setstorageat
740
+ */
741
+ method: `${Name}_setStorageAt`
742
+ params: [
743
+ /** The account address. */
744
+ address: Address,
745
+ /** The storage position index. */
746
+ index: Quantity,
747
+ /** The storage value. */
748
+ value: Quantity,
749
+ ]
750
+ }): Promise<void>
751
+ request(args: {
752
+ /**
753
+ * @description Use this method to stop impersonating an account after having previously used impersonateAccount.
754
+ * @link https://hardhat.org/hardhat-network/docs/reference#hardhat_stopimpersonatingaccount
755
+ */
756
+ method: `${Name}_stopImpersonatingAccount`
757
+ params: [
758
+ /** The address to stop impersonating. */
759
+ address: Address,
760
+ ]
761
+ }): Promise<void>
762
+ request(args: {
763
+ /**
764
+ * @description Jump forward in time by the given amount of time, in seconds.
765
+ * @link https://github.com/trufflesuite/ganache/blob/ef1858d5d6f27e4baeb75cccd57fb3dc77a45ae8/src/chains/ethereum/ethereum/RPC-METHODS.md#evm_increasetime
766
+ */
767
+ method: 'evm_increaseTime'
768
+ params: [seconds: Quantity]
769
+ }): Promise<Quantity>
770
+ request(args: {
771
+ /**
772
+ * @description Enables or disables, based on the single boolean argument, the automatic mining of new blocks with each new transaction submitted to the network.
773
+ * @link https://hardhat.org/hardhat-network/docs/reference#evm_setautomine
774
+ */
775
+ method: 'evm_setAutomine'
776
+ params: [boolean]
777
+ }): Promise<void>
778
+ request(args: {
779
+ /**
780
+ * @description Sets the block's gas limit.
781
+ * @link https://hardhat.org/hardhat-network/docs/reference#evm_setblockgaslimit
782
+ */
783
+ method: 'evm_setBlockGasLimit'
784
+ params: [gasLimit: Quantity]
785
+ }): Promise<void>
786
+ request(args: {
787
+ /**
788
+ * @description Similar to `evm_increaseTime` but sets a block timestamp `interval`.
789
+ * The timestamp of the next block will be computed as `lastBlock_timestamp` + `interval`
790
+ */
791
+ method: `${Name}_setBlockTimestampInterval`
792
+ params: [seconds: number]
793
+ }): Promise<void>
794
+ request(args: {
795
+ /**
796
+ * @description Removes `setBlockTimestampInterval` if it exists
797
+ */
798
+ method: `${Name}_removeBlockTimestampInterval`
799
+ }): Promise<void>
800
+ request(args: {
801
+ /**
802
+ * @description Enables (with a numeric argument greater than 0) or disables (with a numeric argument equal to 0), the automatic mining of blocks at a regular interval of milliseconds, each of which will include all pending transactions.
803
+ * @link https://hardhat.org/hardhat-network/docs/reference#evm_setintervalmining
804
+ */
805
+ method: 'evm_setIntervalMining'
806
+ params: [number]
807
+ }): Promise<void>
808
+ request(args: {
809
+ /**
810
+ * @description Set the timestamp of the next block.
811
+ * @link https://hardhat.org/hardhat-network/docs/reference#evm_setnextblocktimestamp
812
+ */
813
+ method: 'evm_setNextBlockTimestamp'
814
+ params: [Quantity]
815
+ }): Promise<void>
816
+ request(args: {
817
+ /**
818
+ * @description Snapshot the state of the blockchain at the current block. Takes no parameters. Returns the id of the snapshot that was created.
819
+ * @link https://hardhat.org/hardhat-network/docs/reference#evm_snapshot
820
+ */
821
+ method: 'evm_snapshot'
822
+ params?: never
823
+ }): Promise<Quantity>
824
+ request(args: {
825
+ /**
826
+ * @description Revert the state of the blockchain to a previous snapshot. Takes a single parameter, which is the snapshot id to revert to.
827
+ */
828
+ method: 'evm_revert'
829
+ params?: [id: Quantity]
830
+ }): Promise<void>
831
+ request(args: {
832
+ /**
833
+ * @link https://geth.ethereum.org/docs/interacting-with-geth/rpc/ns-txpool#txpool-content
834
+ */
835
+ method: 'txpool_content'
836
+ params?: never
837
+ }): Promise<{
838
+ pending: Record<Address, Record<string, Transaction>>
839
+ queued: Record<Address, Record<string, Transaction>>
840
+ }>
841
+ request(args: {
842
+ /**
843
+ * @link https://geth.ethereum.org/docs/interacting-with-geth/rpc/ns-txpool#txpool-inspect
844
+ */
845
+ method: 'txpool_inspect'
846
+ params?: never
847
+ }): Promise<{
848
+ pending: Record<Address, Record<string, string>>
849
+ queued: Record<Address, Record<string, string>>
850
+ }>
851
+ request(args: {
852
+ /**
853
+ * @link https://geth.ethereum.org/docs/interacting-with-geth/rpc/ns-txpool#txpool-inspect
854
+ */
855
+ method: 'txpool_status'
856
+ params?: never
857
+ }): Promise<{
858
+ pending: Quantity
859
+ queued: Quantity
860
+ }>
861
+ request(args: {
862
+ /**
863
+ * @description Creates, signs, and sends a new transaction to the network regardless of the signature.
864
+ * @link https://eips.ethereum.org/EIPS/eip-1474
865
+ * @example
866
+ * provider.request({ method: 'eth_sendTransaction', params: [{ from: '0x...', to: '0x...', value: '0x...' }] })
867
+ * // => '0x...'
868
+ * */
869
+ method: 'eth_sendUnsignedTransaction'
870
+ params: [request: TransactionRequest]
871
+ }): Promise<Hash>
872
+ }
873
+
874
+ export type SignableRequests = {
875
+ request(args: {
876
+ /**
877
+ * @description Creates, signs, and sends a new transaction to the network
878
+ * @link https://eips.ethereum.org/EIPS/eip-1474
879
+ * @example
880
+ * provider.request({ method: 'eth_sendTransaction', params: [{ from: '0x...', to: '0x...', value: '0x...' }] })
881
+ * // => '0x...'
882
+ * */
883
+ method: 'eth_sendTransaction'
884
+ params: [request: TransactionRequest]
885
+ }): Promise<Hash>
886
+ request(args: {
887
+ /**
888
+ * @description Calculates an Ethereum-specific signature in the form of `keccak256("\x19Ethereum Signed Message:\n" + len(message) + message))`
889
+ * @link https://eips.ethereum.org/EIPS/eip-1474
890
+ * @example
891
+ * provider.request({ method: 'eth_sign', params: ['0x...', '0x...'] })
892
+ * // => '0x...'
893
+ * */
894
+ method: 'eth_sign'
895
+ params: [
896
+ /** Address to use for signing */
897
+ address: Address,
898
+ /** Data to sign */
899
+ data: Hex,
900
+ ]
901
+ }): Promise<Hex>
902
+ request(args: {
903
+ /**
904
+ * @description Signs a transaction that can be submitted to the network at a later time using with `eth_sendRawTransaction`
905
+ * @link https://eips.ethereum.org/EIPS/eip-1474
906
+ * @example
907
+ * provider.request({ method: 'eth_signTransaction', params: [{ from: '0x...', to: '0x...', value: '0x...' }] })
908
+ * // => '0x...'
909
+ * */
910
+ method: 'eth_signTransaction'
911
+ params: [request: TransactionRequest]
912
+ }): Promise<Hex>
913
+ request(args: {
914
+ /**
915
+ * @description Calculates an Ethereum-specific signature in the form of `keccak256("\x19Ethereum Signed Message:\n" + len(message) + message))`
916
+ * @link https://eips.ethereum.org/EIPS/eip-1474
917
+ * @example
918
+ * provider.request({ method: 'eth_signTypedData', params: [{ from: '0x...', data: [{ type: 'string', name: 'message', value: 'hello world' }] }] })
919
+ * // => '0x...'
920
+ * */
921
+ method: 'eth_signTypedData'
922
+ params: [
923
+ /** Address to use for signing */
924
+ address: Address,
925
+ /** Message to sign containing type information, a domain separator, and data */
926
+ message: Hex,
927
+ ]
928
+ }): Promise<Hex>
929
+ request(args: {
930
+ /**
931
+ * @description Returns information about the status of this client’s network synchronization
932
+ * @link https://eips.ethereum.org/EIPS/eip-1474
933
+ * @example
934
+ * provider.request({ method: 'eth_syncing' })
935
+ * // => { startingBlock: '0x...', currentBlock: '0x...', highestBlock: '0x...' }
936
+ * */
937
+ method: 'eth_syncing'
938
+ params?: never
939
+ }): Promise<NetworkSync | false>
940
+ request(args: {
941
+ /**
942
+ * @description Calculates an Ethereum-specific signature in the form of `keccak256("\x19Ethereum Signed Message:\n" + len(message) + message))`
943
+ * @link https://eips.ethereum.org/EIPS/eip-1474
944
+ * @example
945
+ * provider.request({ method: 'personal_sign', params: ['0x...', '0x...'] })
946
+ * // => '0x...'
947
+ * */
948
+ method: 'personal_sign'
949
+ params: [
950
+ /** Data to sign */
951
+ data: Hex,
952
+ /** Address to use for signing */
953
+ address: Address,
954
+ ]
955
+ }): Promise<Hex>
956
+ }
957
+
958
+ export type WalletRequests = {
959
+ request(args: {
960
+ /**
961
+ * @description Returns a list of addresses owned by this client
962
+ * @link https://eips.ethereum.org/EIPS/eip-1474
963
+ * @example
964
+ * provider.request({ method: 'eth_accounts' })
965
+ * // => ['0x0fB69...']
966
+ * */
967
+ method: 'eth_accounts'
968
+ params?: never
969
+ }): Promise<Address[]>
970
+ request(args: {
971
+ /**
972
+ * @description Requests that the user provides an Ethereum address to be identified by. Typically causes a browser extension popup to appear.
973
+ * @link https://eips.ethereum.org/EIPS/eip-1102
974
+ * @example
975
+ * provider.request({ method: 'eth_requestAccounts' }] })
976
+ * // => ['0x...', '0x...']
977
+ * */
978
+ method: 'eth_requestAccounts'
979
+ params?: never
980
+ }): Promise<Address[]>
981
+ request(args: {
982
+ /**
983
+ * @description Requests the given permissions from the user.
984
+ * @link https://eips.ethereum.org/EIPS/eip-2255
985
+ * @example
986
+ * provider.request({ method: 'wallet_requestPermissions', params: [{ eth_accounts: {} }] })
987
+ * // => { ... }
988
+ * */
989
+ method: 'wallet_requestPermissions'
990
+ params: [permissions: { eth_accounts: Record<string, any> }]
991
+ }): Promise<WalletPermission[]>
992
+ request(args: {
993
+ /**
994
+ * @description Gets the wallets current permissions.
995
+ * @link https://eips.ethereum.org/EIPS/eip-2255
996
+ * @example
997
+ * provider.request({ method: 'wallet_getPermissions' })
998
+ * // => { ... }
999
+ * */
1000
+ method: 'wallet_getPermissions'
1001
+ params?: never
1002
+ }): Promise<WalletPermission[]>
1003
+ request(args: {
1004
+ /**
1005
+ * @description Add an Ethereum chain to the wallet.
1006
+ * @link https://eips.ethereum.org/EIPS/eip-3085
1007
+ * @example
1008
+ * provider.request({ method: 'wallet_addEthereumChain', params: [{ chainId: 1, rpcUrl: 'https://mainnet.infura.io/v3/...' }] })
1009
+ * // => { ... }
1010
+ */
1011
+ method: 'wallet_addEthereumChain'
1012
+ params: [chain: Chain]
1013
+ }): Promise<null>
1014
+ request(args: {
1015
+ /**
1016
+ * @description Switch the wallet to the given Ethereum chain.
1017
+ * @link https://eips.ethereum.org/EIPS/eip-3326
1018
+ * @example
1019
+ * provider.request({ method: 'wallet_switchEthereumChain', params: [{ chainId: '0xf00' }] })
1020
+ * // => { ... }
1021
+ * */
1022
+ method: 'wallet_switchEthereumChain'
1023
+ params: [chain: { chainId: string }]
1024
+ }): Promise<null>
1025
+ /**
1026
+ * @description Requests that the user tracks the token in their wallet. Returns a boolean indicating if the token was successfully added.
1027
+ * @link https://eips.ethereum.org/EIPS/eip-747
1028
+ * @example
1029
+ * provider.request({ method: 'wallet_watchAsset' }] })
1030
+ * // => true
1031
+ * */
1032
+ request(args: {
1033
+ method: 'wallet_watchAsset'
1034
+ params: [WatchAssetParams]
1035
+ }): Promise<boolean>
1036
+ }
1037
+
1038
+ export type Requests = PublicRequests & SignableRequests & WalletRequests