viem 1.0.2 → 1.0.5

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 (365) hide show
  1. package/dist/cjs/actions/test/sendUnsignedTransaction.js +21 -3
  2. package/dist/cjs/actions/test/sendUnsignedTransaction.js.map +1 -1
  3. package/dist/cjs/chains.js.map +1 -1
  4. package/dist/cjs/clients/decorators/test.js.map +1 -1
  5. package/dist/cjs/errors/base.js +4 -11
  6. package/dist/cjs/errors/base.js.map +1 -1
  7. package/dist/cjs/errors/version.js +1 -1
  8. package/dist/cjs/utils/encoding/toBytes.js.map +1 -1
  9. package/dist/cjs/utils/encoding/toHex.js.map +1 -1
  10. package/dist/cjs/utils/formatters/block.js +3 -1
  11. package/dist/cjs/utils/formatters/block.js.map +1 -1
  12. package/dist/cjs/utils/formatters/transaction.js +3 -1
  13. package/dist/cjs/utils/formatters/transaction.js.map +1 -1
  14. package/dist/cjs/utils/formatters/transactionReceipt.js.map +1 -1
  15. package/dist/cjs/utils/formatters/transactionRequest.js.map +1 -1
  16. package/dist/cjs/utils/observe.js.map +1 -1
  17. package/dist/cjs/utils/promise/createBatchScheduler.js.map +1 -1
  18. package/dist/cjs/utils/promise/withCache.js.map +1 -1
  19. package/dist/cjs/utils/rpc.js.map +1 -1
  20. package/dist/cjs/utils/unit/parseUnits.js +1 -2
  21. package/dist/cjs/utils/unit/parseUnits.js.map +1 -1
  22. package/dist/esm/accounts/generateMnemonic.js +7 -0
  23. package/dist/esm/accounts/generateMnemonic.js.map +1 -1
  24. package/dist/esm/accounts/generatePrivateKey.js +5 -0
  25. package/dist/esm/accounts/generatePrivateKey.js.map +1 -1
  26. package/dist/esm/accounts/hdKeyToAccount.js +5 -0
  27. package/dist/esm/accounts/hdKeyToAccount.js.map +1 -1
  28. package/dist/esm/accounts/mnemonicToAccount.js +5 -0
  29. package/dist/esm/accounts/mnemonicToAccount.js.map +1 -1
  30. package/dist/esm/accounts/privateKeyToAccount.js +5 -0
  31. package/dist/esm/accounts/privateKeyToAccount.js.map +1 -1
  32. package/dist/esm/accounts/toAccount.js +5 -0
  33. package/dist/esm/accounts/toAccount.js.map +1 -1
  34. package/dist/esm/accounts/utils/publicKeyToAddress.js +7 -0
  35. package/dist/esm/accounts/utils/publicKeyToAddress.js.map +1 -1
  36. package/dist/esm/accounts/utils/sign.js +8 -0
  37. package/dist/esm/accounts/utils/sign.js.map +1 -1
  38. package/dist/esm/accounts/utils/signMessage.js +6 -0
  39. package/dist/esm/accounts/utils/signMessage.js.map +1 -1
  40. package/dist/esm/accounts/utils/signTypedData.js +6 -0
  41. package/dist/esm/accounts/utils/signTypedData.js.map +1 -1
  42. package/dist/esm/actions/ens/getEnsAddress.js +28 -0
  43. package/dist/esm/actions/ens/getEnsAddress.js.map +1 -1
  44. package/dist/esm/actions/ens/getEnsAvatar.js +28 -0
  45. package/dist/esm/actions/ens/getEnsAvatar.js.map +1 -1
  46. package/dist/esm/actions/ens/getEnsName.js +27 -0
  47. package/dist/esm/actions/ens/getEnsName.js.map +1 -1
  48. package/dist/esm/actions/ens/getEnsResolver.js +28 -0
  49. package/dist/esm/actions/ens/getEnsResolver.js.map +1 -1
  50. package/dist/esm/actions/ens/getEnsText.js +29 -0
  51. package/dist/esm/actions/ens/getEnsText.js.map +1 -1
  52. package/dist/esm/actions/getContract.js +36 -0
  53. package/dist/esm/actions/getContract.js.map +1 -1
  54. package/dist/esm/actions/public/call.js +31 -0
  55. package/dist/esm/actions/public/call.js.map +1 -1
  56. package/dist/esm/actions/public/createBlockFilter.js +21 -0
  57. package/dist/esm/actions/public/createBlockFilter.js.map +1 -1
  58. package/dist/esm/actions/public/createContractEventFilter.js +22 -0
  59. package/dist/esm/actions/public/createContractEventFilter.js.map +1 -1
  60. package/dist/esm/actions/public/createEventFilter.js +23 -0
  61. package/dist/esm/actions/public/createEventFilter.js.map +1 -1
  62. package/dist/esm/actions/public/createPendingTransactionFilter.js +21 -0
  63. package/dist/esm/actions/public/createPendingTransactionFilter.js.map +1 -1
  64. package/dist/esm/actions/public/estimateContractGas.js +27 -0
  65. package/dist/esm/actions/public/estimateContractGas.js.map +1 -1
  66. package/dist/esm/actions/public/estimateGas.js +26 -0
  67. package/dist/esm/actions/public/estimateGas.js.map +1 -1
  68. package/dist/esm/actions/public/getBalance.js +35 -0
  69. package/dist/esm/actions/public/getBalance.js.map +1 -1
  70. package/dist/esm/actions/public/getBlock.js +24 -0
  71. package/dist/esm/actions/public/getBlock.js.map +1 -1
  72. package/dist/esm/actions/public/getBlockNumber.js +23 -0
  73. package/dist/esm/actions/public/getBlockNumber.js.map +1 -1
  74. package/dist/esm/actions/public/getBlockTransactionCount.js +23 -0
  75. package/dist/esm/actions/public/getBlockTransactionCount.js.map +1 -1
  76. package/dist/esm/actions/public/getBytecode.js +23 -0
  77. package/dist/esm/actions/public/getBytecode.js.map +1 -1
  78. package/dist/esm/actions/public/getChainId.js +21 -0
  79. package/dist/esm/actions/public/getChainId.js.map +1 -1
  80. package/dist/esm/actions/public/getFeeHistory.js +24 -0
  81. package/dist/esm/actions/public/getFeeHistory.js.map +1 -1
  82. package/dist/esm/actions/public/getFilterChanges.js +84 -0
  83. package/dist/esm/actions/public/getFilterChanges.js.map +1 -1
  84. package/dist/esm/actions/public/getFilterLogs.js +29 -0
  85. package/dist/esm/actions/public/getFilterLogs.js.map +1 -1
  86. package/dist/esm/actions/public/getGasPrice.js +20 -0
  87. package/dist/esm/actions/public/getGasPrice.js.map +1 -1
  88. package/dist/esm/actions/public/getLogs.js +24 -0
  89. package/dist/esm/actions/public/getLogs.js.map +1 -1
  90. package/dist/esm/actions/public/getStorageAt.js +24 -0
  91. package/dist/esm/actions/public/getStorageAt.js.map +1 -1
  92. package/dist/esm/actions/public/getTransaction.js +24 -0
  93. package/dist/esm/actions/public/getTransaction.js.map +1 -1
  94. package/dist/esm/actions/public/getTransactionConfirmations.js +24 -0
  95. package/dist/esm/actions/public/getTransactionConfirmations.js.map +1 -1
  96. package/dist/esm/actions/public/getTransactionCount.js +23 -0
  97. package/dist/esm/actions/public/getTransactionCount.js.map +1 -1
  98. package/dist/esm/actions/public/getTransactionReceipt.js +24 -0
  99. package/dist/esm/actions/public/getTransactionReceipt.js.map +1 -1
  100. package/dist/esm/actions/public/multicall.js +40 -0
  101. package/dist/esm/actions/public/multicall.js.map +1 -1
  102. package/dist/esm/actions/public/readContract.js +31 -0
  103. package/dist/esm/actions/public/readContract.js.map +1 -1
  104. package/dist/esm/actions/public/simulateContract.js +31 -0
  105. package/dist/esm/actions/public/simulateContract.js.map +1 -1
  106. package/dist/esm/actions/public/uninstallFilter.js +24 -0
  107. package/dist/esm/actions/public/uninstallFilter.js.map +1 -1
  108. package/dist/esm/actions/public/verifyHash.js +10 -0
  109. package/dist/esm/actions/public/verifyHash.js.map +1 -1
  110. package/dist/esm/actions/public/verifyMessage.js +11 -0
  111. package/dist/esm/actions/public/verifyMessage.js.map +1 -1
  112. package/dist/esm/actions/public/verifyTypedData.js +9 -0
  113. package/dist/esm/actions/public/verifyTypedData.js.map +1 -1
  114. package/dist/esm/actions/public/waitForTransactionReceipt.js +52 -0
  115. package/dist/esm/actions/public/waitForTransactionReceipt.js.map +1 -1
  116. package/dist/esm/actions/public/watchBlockNumber.js +31 -0
  117. package/dist/esm/actions/public/watchBlockNumber.js.map +1 -1
  118. package/dist/esm/actions/public/watchBlocks.js +35 -1
  119. package/dist/esm/actions/public/watchBlocks.js.map +1 -1
  120. package/dist/esm/actions/public/watchContractEvent.js +36 -0
  121. package/dist/esm/actions/public/watchContractEvent.js.map +1 -1
  122. package/dist/esm/actions/public/watchEvent.js +38 -0
  123. package/dist/esm/actions/public/watchEvent.js.map +1 -1
  124. package/dist/esm/actions/public/watchPendingTransactions.js +29 -0
  125. package/dist/esm/actions/public/watchPendingTransactions.js.map +1 -1
  126. package/dist/esm/actions/test/dropTransaction.js +22 -0
  127. package/dist/esm/actions/test/dropTransaction.js.map +1 -1
  128. package/dist/esm/actions/test/getAutomine.js +20 -0
  129. package/dist/esm/actions/test/getAutomine.js.map +1 -1
  130. package/dist/esm/actions/test/getTxpoolContent.js +20 -0
  131. package/dist/esm/actions/test/getTxpoolContent.js.map +1 -1
  132. package/dist/esm/actions/test/getTxpoolStatus.js +20 -0
  133. package/dist/esm/actions/test/getTxpoolStatus.js.map +1 -1
  134. package/dist/esm/actions/test/impersonateAccount.js +22 -0
  135. package/dist/esm/actions/test/impersonateAccount.js.map +1 -1
  136. package/dist/esm/actions/test/increaseTime.js +22 -0
  137. package/dist/esm/actions/test/increaseTime.js.map +1 -1
  138. package/dist/esm/actions/test/inspectTxpool.js +20 -0
  139. package/dist/esm/actions/test/inspectTxpool.js.map +1 -1
  140. package/dist/esm/actions/test/mine.js +20 -0
  141. package/dist/esm/actions/test/mine.js.map +1 -1
  142. package/dist/esm/actions/test/removeBlockTimestampInterval.js +19 -0
  143. package/dist/esm/actions/test/removeBlockTimestampInterval.js.map +1 -1
  144. package/dist/esm/actions/test/reset.js +20 -0
  145. package/dist/esm/actions/test/reset.js.map +1 -1
  146. package/dist/esm/actions/test/revert.js +20 -0
  147. package/dist/esm/actions/test/revert.js.map +1 -1
  148. package/dist/esm/actions/test/sendUnsignedTransaction.js +48 -4
  149. package/dist/esm/actions/test/sendUnsignedTransaction.js.map +1 -1
  150. package/dist/esm/actions/test/setAutomine.js +19 -0
  151. package/dist/esm/actions/test/setAutomine.js.map +1 -1
  152. package/dist/esm/actions/test/setBalance.js +23 -0
  153. package/dist/esm/actions/test/setBalance.js.map +1 -1
  154. package/dist/esm/actions/test/setBlockGasLimit.js +20 -0
  155. package/dist/esm/actions/test/setBlockGasLimit.js.map +1 -1
  156. package/dist/esm/actions/test/setBlockTimestampInterval.js +20 -0
  157. package/dist/esm/actions/test/setBlockTimestampInterval.js.map +1 -1
  158. package/dist/esm/actions/test/setCode.js +23 -0
  159. package/dist/esm/actions/test/setCode.js.map +1 -1
  160. package/dist/esm/actions/test/setCoinbase.js +22 -0
  161. package/dist/esm/actions/test/setCoinbase.js.map +1 -1
  162. package/dist/esm/actions/test/setIntervalMining.js +20 -0
  163. package/dist/esm/actions/test/setIntervalMining.js.map +1 -1
  164. package/dist/esm/actions/test/setLoggingEnabled.js +19 -0
  165. package/dist/esm/actions/test/setLoggingEnabled.js.map +1 -1
  166. package/dist/esm/actions/test/setMinGasPrice.js +24 -0
  167. package/dist/esm/actions/test/setMinGasPrice.js.map +1 -1
  168. package/dist/esm/actions/test/setNextBlockBaseFeePerGas.js +22 -0
  169. package/dist/esm/actions/test/setNextBlockBaseFeePerGas.js.map +1 -1
  170. package/dist/esm/actions/test/setNextBlockTimestamp.js +20 -0
  171. package/dist/esm/actions/test/setNextBlockTimestamp.js.map +1 -1
  172. package/dist/esm/actions/test/setNonce.js +23 -0
  173. package/dist/esm/actions/test/setNonce.js.map +1 -1
  174. package/dist/esm/actions/test/setRpcUrl.js +20 -0
  175. package/dist/esm/actions/test/setRpcUrl.js.map +1 -1
  176. package/dist/esm/actions/test/setStorageAt.js +24 -0
  177. package/dist/esm/actions/test/setStorageAt.js.map +1 -1
  178. package/dist/esm/actions/test/snapshot.js +19 -0
  179. package/dist/esm/actions/test/snapshot.js.map +1 -1
  180. package/dist/esm/actions/test/stopImpersonatingAccount.js +22 -0
  181. package/dist/esm/actions/test/stopImpersonatingAccount.js.map +1 -1
  182. package/dist/esm/actions/wallet/addChain.js +19 -0
  183. package/dist/esm/actions/wallet/addChain.js.map +1 -1
  184. package/dist/esm/actions/wallet/deployContract.js +27 -0
  185. package/dist/esm/actions/wallet/deployContract.js.map +1 -1
  186. package/dist/esm/actions/wallet/getAddresses.js +20 -0
  187. package/dist/esm/actions/wallet/getAddresses.js.map +1 -1
  188. package/dist/esm/actions/wallet/getPermissions.js +20 -0
  189. package/dist/esm/actions/wallet/getPermissions.js.map +1 -1
  190. package/dist/esm/actions/wallet/requestAddresses.js +24 -0
  191. package/dist/esm/actions/wallet/requestAddresses.js.map +1 -1
  192. package/dist/esm/actions/wallet/requestPermissions.js +23 -0
  193. package/dist/esm/actions/wallet/requestPermissions.js.map +1 -1
  194. package/dist/esm/actions/wallet/sendTransaction.js +47 -0
  195. package/dist/esm/actions/wallet/sendTransaction.js.map +1 -1
  196. package/dist/esm/actions/wallet/signMessage.js +46 -0
  197. package/dist/esm/actions/wallet/signMessage.js.map +1 -1
  198. package/dist/esm/actions/wallet/signTypedData.js +100 -0
  199. package/dist/esm/actions/wallet/signTypedData.js.map +1 -1
  200. package/dist/esm/actions/wallet/switchChain.js +20 -0
  201. package/dist/esm/actions/wallet/switchChain.js.map +1 -1
  202. package/dist/esm/actions/wallet/watchAsset.js +28 -0
  203. package/dist/esm/actions/wallet/watchAsset.js.map +1 -1
  204. package/dist/esm/actions/wallet/writeContract.js +50 -0
  205. package/dist/esm/actions/wallet/writeContract.js.map +1 -1
  206. package/dist/esm/chains.js +96 -96
  207. package/dist/esm/chains.js.map +1 -1
  208. package/dist/esm/clients/createClient.js +3 -0
  209. package/dist/esm/clients/createClient.js.map +1 -1
  210. package/dist/esm/clients/createPublicClient.js +19 -0
  211. package/dist/esm/clients/createPublicClient.js.map +1 -1
  212. package/dist/esm/clients/createTestClient.js +23 -0
  213. package/dist/esm/clients/createTestClient.js.map +1 -1
  214. package/dist/esm/clients/createWalletClient.js +36 -0
  215. package/dist/esm/clients/createWalletClient.js.map +1 -1
  216. package/dist/esm/clients/decorators/test.js.map +1 -1
  217. package/dist/esm/clients/transports/createTransport.js +3 -0
  218. package/dist/esm/clients/transports/createTransport.js.map +1 -1
  219. package/dist/esm/clients/transports/custom.js +3 -0
  220. package/dist/esm/clients/transports/custom.js.map +1 -1
  221. package/dist/esm/clients/transports/fallback.js +11 -0
  222. package/dist/esm/clients/transports/fallback.js.map +1 -1
  223. package/dist/esm/clients/transports/http.js +6 -1
  224. package/dist/esm/clients/transports/http.js.map +1 -1
  225. package/dist/esm/clients/transports/webSocket.js +6 -1
  226. package/dist/esm/clients/transports/webSocket.js.map +1 -1
  227. package/dist/esm/constants/abis.js +6 -0
  228. package/dist/esm/constants/abis.js.map +1 -1
  229. package/dist/esm/constants/solidity.js +1 -0
  230. package/dist/esm/constants/solidity.js.map +1 -1
  231. package/dist/esm/contract.js +0 -1
  232. package/dist/esm/contract.js.map +1 -1
  233. package/dist/esm/errors/base.js +4 -11
  234. package/dist/esm/errors/base.js.map +1 -1
  235. package/dist/esm/errors/node.js +9 -0
  236. package/dist/esm/errors/node.js.map +1 -1
  237. package/dist/esm/errors/rpc.js +103 -0
  238. package/dist/esm/errors/rpc.js.map +1 -1
  239. package/dist/esm/errors/version.js +1 -1
  240. package/dist/esm/index.js +0 -52
  241. package/dist/esm/index.js.map +1 -1
  242. package/dist/esm/package.json +1 -1
  243. package/dist/esm/types/account.js +1 -1
  244. package/dist/esm/types/account.js.map +1 -1
  245. package/dist/esm/types/eip1193.js +2 -0
  246. package/dist/esm/types/eip1193.js.map +1 -1
  247. package/dist/esm/utils/abi/decodeAbiParameters.js +29 -0
  248. package/dist/esm/utils/abi/decodeAbiParameters.js.map +1 -1
  249. package/dist/esm/utils/abi/decodeEventLog.js +2 -0
  250. package/dist/esm/utils/abi/decodeEventLog.js.map +1 -1
  251. package/dist/esm/utils/abi/encodeAbiParameters.js +10 -1
  252. package/dist/esm/utils/abi/encodeAbiParameters.js.map +1 -1
  253. package/dist/esm/utils/abi/getAbiItem.js +7 -0
  254. package/dist/esm/utils/abi/getAbiItem.js.map +1 -1
  255. package/dist/esm/utils/accounts.js +3 -0
  256. package/dist/esm/utils/accounts.js.map +1 -1
  257. package/dist/esm/utils/buildRequest.js +2 -0
  258. package/dist/esm/utils/buildRequest.js.map +1 -1
  259. package/dist/esm/utils/data/size.js +6 -0
  260. package/dist/esm/utils/data/size.js.map +1 -1
  261. package/dist/esm/utils/data/slice.js +21 -0
  262. package/dist/esm/utils/data/slice.js.map +1 -1
  263. package/dist/esm/utils/encoding/fromBytes.js +79 -0
  264. package/dist/esm/utils/encoding/fromBytes.js.map +1 -1
  265. package/dist/esm/utils/encoding/fromHex.js +106 -0
  266. package/dist/esm/utils/encoding/fromHex.js.map +1 -1
  267. package/dist/esm/utils/encoding/toBytes.js +102 -1
  268. package/dist/esm/utils/encoding/toBytes.js.map +1 -1
  269. package/dist/esm/utils/encoding/toHex.js +108 -2
  270. package/dist/esm/utils/encoding/toHex.js.map +1 -1
  271. package/dist/esm/utils/ens/avatar/parseAvatarRecord.js +6 -2
  272. package/dist/esm/utils/ens/avatar/parseAvatarRecord.js.map +1 -1
  273. package/dist/esm/utils/ens/avatar/utils.js +10 -0
  274. package/dist/esm/utils/ens/avatar/utils.js.map +1 -1
  275. package/dist/esm/utils/ens/labelhash.js +9 -0
  276. package/dist/esm/utils/ens/labelhash.js.map +1 -1
  277. package/dist/esm/utils/ens/namehash.js +12 -0
  278. package/dist/esm/utils/ens/namehash.js.map +1 -1
  279. package/dist/esm/utils/ens/normalize.js +10 -0
  280. package/dist/esm/utils/ens/normalize.js.map +1 -1
  281. package/dist/esm/utils/ens/packetToBytes.js +6 -0
  282. package/dist/esm/utils/ens/packetToBytes.js.map +1 -1
  283. package/dist/esm/utils/filters/createFilterRequestScope.js +5 -0
  284. package/dist/esm/utils/filters/createFilterRequestScope.js.map +1 -1
  285. package/dist/esm/utils/formatters/block.js +4 -1
  286. package/dist/esm/utils/formatters/block.js.map +1 -1
  287. package/dist/esm/utils/formatters/extract.js +3 -0
  288. package/dist/esm/utils/formatters/extract.js.map +1 -1
  289. package/dist/esm/utils/formatters/format.js +3 -0
  290. package/dist/esm/utils/formatters/format.js.map +1 -1
  291. package/dist/esm/utils/formatters/transaction.js +3 -1
  292. package/dist/esm/utils/formatters/transaction.js.map +1 -1
  293. package/dist/esm/utils/formatters/transactionReceipt.js +1 -1
  294. package/dist/esm/utils/formatters/transactionReceipt.js.map +1 -1
  295. package/dist/esm/utils/formatters/transactionRequest.js +1 -1
  296. package/dist/esm/utils/formatters/transactionRequest.js.map +1 -1
  297. package/dist/esm/utils/observe.js +7 -2
  298. package/dist/esm/utils/observe.js.map +1 -1
  299. package/dist/esm/utils/poll.js +3 -0
  300. package/dist/esm/utils/poll.js.map +1 -1
  301. package/dist/esm/utils/promise/createBatchScheduler.js +1 -1
  302. package/dist/esm/utils/promise/createBatchScheduler.js.map +1 -1
  303. package/dist/esm/utils/promise/withCache.js +15 -2
  304. package/dist/esm/utils/promise/withCache.js.map +1 -1
  305. package/dist/esm/utils/regex.js +4 -0
  306. package/dist/esm/utils/regex.js.map +1 -1
  307. package/dist/esm/utils/rpc.js +14 -1
  308. package/dist/esm/utils/rpc.js.map +1 -1
  309. package/dist/esm/utils/signature/hashTypedData.js +3 -0
  310. package/dist/esm/utils/signature/hashTypedData.js.map +1 -1
  311. package/dist/esm/utils/signature/recoverPublicKey.js +2 -0
  312. package/dist/esm/utils/signature/recoverPublicKey.js.map +1 -1
  313. package/dist/esm/utils/signature/verifyMessage.js +12 -0
  314. package/dist/esm/utils/signature/verifyMessage.js.map +1 -1
  315. package/dist/esm/utils/signature/verifyTypedData.js +12 -0
  316. package/dist/esm/utils/signature/verifyTypedData.js.map +1 -1
  317. package/dist/esm/utils/transaction/prepareRequest.js +5 -1
  318. package/dist/esm/utils/transaction/prepareRequest.js.map +1 -1
  319. package/dist/esm/utils/transaction/serializeTransaction.js +4 -2
  320. package/dist/esm/utils/transaction/serializeTransaction.js.map +1 -1
  321. package/dist/esm/utils/typedData.js +4 -0
  322. package/dist/esm/utils/typedData.js.map +1 -1
  323. package/dist/esm/utils/unit/parseUnits.js +3 -2
  324. package/dist/esm/utils/unit/parseUnits.js.map +1 -1
  325. package/dist/types/actions/public/getBlockNumber.d.ts +2 -2
  326. package/dist/types/actions/public/getBlockNumber.d.ts.map +1 -1
  327. package/dist/types/actions/test/sendUnsignedTransaction.d.ts +8 -2
  328. package/dist/types/actions/test/sendUnsignedTransaction.d.ts.map +1 -1
  329. package/dist/types/chains.d.ts.map +1 -1
  330. package/dist/types/clients/decorators/test.d.ts +1 -1
  331. package/dist/types/clients/decorators/test.d.ts.map +1 -1
  332. package/dist/types/contract.d.ts +1 -1
  333. package/dist/types/contract.d.ts.map +1 -1
  334. package/dist/types/errors/base.d.ts +0 -1
  335. package/dist/types/errors/base.d.ts.map +1 -1
  336. package/dist/types/errors/version.d.ts +1 -1
  337. package/dist/types/index.d.ts +52 -52
  338. package/dist/types/index.d.ts.map +1 -1
  339. package/dist/types/types/account.d.ts +1 -1
  340. package/dist/types/types/account.d.ts.map +1 -1
  341. package/dist/types/utils/formatters/block.d.ts.map +1 -1
  342. package/dist/types/utils/formatters/transaction.d.ts.map +1 -1
  343. package/dist/types/utils/observe.d.ts.map +1 -1
  344. package/dist/types/utils/promise/withCache.d.ts.map +1 -1
  345. package/dist/types/utils/unit/parseUnits.d.ts.map +1 -1
  346. package/package.json +1 -1
  347. package/src/actions/test/sendUnsignedTransaction.ts +54 -5
  348. package/src/chains.ts +120 -97
  349. package/src/clients/decorators/test.ts +4 -3
  350. package/src/contract.ts +3 -3
  351. package/src/errors/base.ts +6 -6
  352. package/src/errors/version.ts +1 -1
  353. package/src/index.ts +221 -221
  354. package/src/types/account.ts +9 -9
  355. package/src/utils/encoding/toBytes.ts +1 -1
  356. package/src/utils/encoding/toHex.ts +2 -2
  357. package/src/utils/formatters/block.ts +3 -1
  358. package/src/utils/formatters/transaction.ts +3 -1
  359. package/src/utils/formatters/transactionReceipt.ts +1 -1
  360. package/src/utils/formatters/transactionRequest.ts +1 -1
  361. package/src/utils/observe.ts +2 -2
  362. package/src/utils/promise/createBatchScheduler.ts +1 -1
  363. package/src/utils/promise/withCache.ts +2 -2
  364. package/src/utils/rpc.ts +1 -1
  365. package/src/utils/unit/parseUnits.ts +1 -5
@@ -1 +1 @@
1
- {"version":3,"file":"getEnsAddress.js","sourceRoot":"","sources":["../../../../src/actions/ens/getEnsAddress.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,8BAA8B,EAC9B,6BAA6B,GAC9B,MAAM,0BAA0B,CAAA;AAGjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAA;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAA;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAA;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAA;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAChE,OAAO,EAEL,YAAY,GACb,MAAM,2BAA2B,CAAA;AAyClC,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAuC,EACvC,EACE,WAAW,EACX,QAAQ,EACR,IAAI,EACJ,wBAAwB,EAAE,yBAAyB,GAC3B;IAE1B,IAAI,wBAAwB,GAAG,yBAAyB,CAAA;IACxD,IAAI,CAAC,wBAAwB,EAAE;QAC7B,IAAI,CAAC,MAAM,CAAC,KAAK;YACf,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAA;QAEH,wBAAwB,GAAG,uBAAuB,CAAC;YACjD,WAAW;YACX,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,sBAAsB;SACjC,CAAC,CAAA;KACH;IAED,IAAI;QACF,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE;YACrC,OAAO,EAAE,wBAAwB;YACjC,GAAG,EAAE,oBAAoB;YACzB,YAAY,EAAE,SAAS;YACvB,IAAI,EAAE;gBACJ,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;gBAC1B,kBAAkB,CAAC;oBACjB,GAAG,EAAE,wBAAwB;oBAC7B,YAAY,EAAE,MAAM;oBACpB,IAAI,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;iBACvB,CAAC;aACH;YACD,WAAW;YACX,QAAQ;SACT,CAAC,CAAA;QAEF,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;QAEhC,MAAM,OAAO,GAAG,oBAAoB,CAAC;YACnC,GAAG,EAAE,wBAAwB;YAC7B,YAAY,EAAE,MAAM;YACpB,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;SACb,CAAC,CAAA;QAEF,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAA;KACjD;IAAC,OAAO,GAAG,EAAE;QACZ,IAAI,GAAG,YAAY,8BAA8B,EAAE;YACjD,MAAM,MAAM,GAAI,GAAG,CAAC,KAAuC,EAAE,MAAM,CAAA;YACnE,IACE,MAAM,EAAE,QAAQ,CAAC,qDAAqD,CAAC;gBAEvE,OAAO,IAAI,CAAA;SACd;QACD,MAAM,GAAG,CAAA;KACV;AACH,CAAC"}
1
+ {"version":3,"file":"getEnsAddress.js","sourceRoot":"","sources":["../../../../src/actions/ens/getEnsAddress.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,8BAA8B,EAC9B,6BAA6B,GAC9B,MAAM,0BAA0B,CAAA;AAGjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAA;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAA;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAA;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAA;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAChE,OAAO,EAEL,YAAY,GACb,MAAM,2BAA2B,CAAA;AAalC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAuC,EACvC,EACE,WAAW,EACX,QAAQ,EACR,IAAI,EACJ,wBAAwB,EAAE,yBAAyB,GAC3B;IAE1B,IAAI,wBAAwB,GAAG,yBAAyB,CAAA;IACxD,IAAI,CAAC,wBAAwB,EAAE;QAC7B,IAAI,CAAC,MAAM,CAAC,KAAK;YACf,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAA;QAEH,wBAAwB,GAAG,uBAAuB,CAAC;YACjD,WAAW;YACX,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,sBAAsB;SACjC,CAAC,CAAA;KACH;IAED,IAAI;QACF,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE;YACrC,OAAO,EAAE,wBAAwB;YACjC,GAAG,EAAE,oBAAoB;YACzB,YAAY,EAAE,SAAS;YACvB,IAAI,EAAE;gBACJ,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;gBAC1B,kBAAkB,CAAC;oBACjB,GAAG,EAAE,wBAAwB;oBAC7B,YAAY,EAAE,MAAM;oBACpB,IAAI,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;iBACvB,CAAC;aACH;YACD,WAAW;YACX,QAAQ;SACT,CAAC,CAAA;QAEF,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;QAEhC,MAAM,OAAO,GAAG,oBAAoB,CAAC;YACnC,GAAG,EAAE,wBAAwB;YAC7B,YAAY,EAAE,MAAM;YACpB,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;SACb,CAAC,CAAA;QAEF,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAA;KACjD;IAAC,OAAO,GAAG,EAAE;QACZ,IAAI,GAAG,YAAY,8BAA8B,EAAE;YACjD,MAAM,MAAM,GAAI,GAAG,CAAC,KAAuC,EAAE,MAAM,CAAA;YACnE,IACE,MAAM,EAAE,QAAQ,CAAC,qDAAqD,CAAC;gBAEvE,OAAO,IAAI,CAAA;SACd;QACD,MAAM,GAAG,CAAA;KACV;AACH,CAAC"}
@@ -1,5 +1,33 @@
1
1
  import { parseAvatarRecord } from '../../utils/ens/avatar/parseAvatarRecord.js';
2
2
  import { getEnsText } from './getEnsText.js';
3
+ /**
4
+ * Gets the avatar of an ENS name.
5
+ *
6
+ * - Docs: https://viem.sh/docs/ens/actions/getEnsAvatar.html
7
+ * - Examples: https://stackblitz.com/github/wagmi-dev/viem/tree/main/examples/ens
8
+ *
9
+ * Calls [`getEnsText`](https://viem.sh/docs/ens/actions/getEnsText.html) with `key` set to `'avatar'`.
10
+ *
11
+ * Since ENS names prohibit certain forbidden characters (e.g. underscore) and have other validation rules, you likely want to [normalize ENS names](https://docs.ens.domains/contract-api-reference/name-processing#normalising-names) with [UTS-46 normalization](https://unicode.org/reports/tr46) before passing them to `getEnsAddress`. You can use the built-in [`normalize`](https://viem.sh/docs/ens/utilities/normalize.html) function for this.
12
+ *
13
+ * @param client - Client to use
14
+ * @param parameters - {@link GetEnsAvatarParameters}
15
+ * @returns Avatar URI or `null` if not found. {@link GetEnsAvatarReturnType}
16
+ *
17
+ * @example
18
+ * import { createPublicClient, http } from 'viem'
19
+ * import { mainnet } from 'viem/chains'
20
+ * import { getEnsAvatar, normalize } from 'viem/ens'
21
+ *
22
+ * const client = createPublicClient({
23
+ * chain: mainnet,
24
+ * transport: http(),
25
+ * })
26
+ * const ensAvatar = await getEnsAvatar(client, {
27
+ * name: normalize('wagmi-dev.eth'),
28
+ * })
29
+ * // 'https://ipfs.io/ipfs/Qma8mnp6xV3J2cRNf3mTth5C8nV11CAnceVinc3y8jSbio'
30
+ */
3
31
  export async function getEnsAvatar(client, { blockNumber, blockTag, gatewayUrls, name, universalResolverAddress, }) {
4
32
  const record = await getEnsText(client, {
5
33
  blockNumber,
@@ -1 +1 @@
1
- {"version":3,"file":"getEnsAvatar.js","sourceRoot":"","sources":["../../../../src/actions/ens/getEnsAvatar.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAA;AAE/E,OAAO,EAA6B,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAuCvE,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAuC,EACvC,EACE,WAAW,EACX,QAAQ,EACR,WAAW,EACX,IAAI,EACJ,wBAAwB,GACD;IAEzB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE;QACtC,WAAW;QACX,QAAQ;QACR,GAAG,EAAE,QAAQ;QACb,IAAI;QACJ,wBAAwB;KACzB,CAAC,CAAA;IACF,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IACxB,IAAI;QACF,OAAO,MAAM,iBAAiB,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAA;KAChE;IAAC,MAAM;QACN,OAAO,IAAI,CAAA;KACZ;AACH,CAAC"}
1
+ {"version":3,"file":"getEnsAvatar.js","sourceRoot":"","sources":["../../../../src/actions/ens/getEnsAvatar.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAA;AAE/E,OAAO,EAA6B,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAWvE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAuC,EACvC,EACE,WAAW,EACX,QAAQ,EACR,WAAW,EACX,IAAI,EACJ,wBAAwB,GACD;IAEzB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE;QACtC,WAAW;QACX,QAAQ;QACR,GAAG,EAAE,QAAQ;QACb,IAAI;QACJ,wBAAwB;KACzB,CAAC,CAAA;IACF,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IACxB,IAAI;QACF,OAAO,MAAM,iBAAiB,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAA;KAChE;IAAC,MAAM;QACN,OAAO,IAAI,CAAA;KACZ;AACH,CAAC"}
@@ -4,6 +4,32 @@ import { getChainContractAddress } from '../../utils/chain.js';
4
4
  import { toHex } from '../../utils/encoding/toHex.js';
5
5
  import { packetToBytes } from '../../utils/ens/packetToBytes.js';
6
6
  import { readContract, } from '../public/readContract.js';
7
+ /**
8
+ * Gets primary name for specified address.
9
+ *
10
+ * - Docs: https://viem.sh/docs/ens/actions/getEnsName.html
11
+ * - Examples: https://stackblitz.com/github/wagmi-dev/viem/tree/main/examples/ens
12
+ *
13
+ * Calls `reverse(bytes)` on ENS Universal Resolver Contract to "reverse resolve" the address to the primary ENS name.
14
+ *
15
+ * @param client - Client to use
16
+ * @param parameters - {@link GetEnsNameParameters}
17
+ * @returns Name or `null` if not found. {@link GetEnsNameReturnType}
18
+ *
19
+ * @example
20
+ * import { createPublicClient, http } from 'viem'
21
+ * import { mainnet } from 'viem/chains'
22
+ * import { getEnsName } from 'viem/ens'
23
+ *
24
+ * const client = createPublicClient({
25
+ * chain: mainnet,
26
+ * transport: http(),
27
+ * })
28
+ * const ensName = await getEnsName(client, {
29
+ * address: '0xd2135CfB216b74109775236E36d4b433F1DF507B',
30
+ * })
31
+ * // 'wagmi-dev.eth'
32
+ */
7
33
  export async function getEnsName(client, { address, blockNumber, blockTag, universalResolverAddress: universalResolverAddress_, }) {
8
34
  let universalResolverAddress = universalResolverAddress_;
9
35
  if (!universalResolverAddress) {
@@ -43,6 +69,7 @@ export async function getEnsName(client, { address, blockNumber, blockTag, unive
43
69
  catch (error) {
44
70
  if (error instanceof ContractFunctionExecutionError &&
45
71
  error.cause.reason === panicReasons[50])
72
+ // No primary name set for address.
46
73
  return null;
47
74
  throw error;
48
75
  }
@@ -1 +1 @@
1
- {"version":3,"file":"getEnsName.js","sourceRoot":"","sources":["../../../../src/actions/ens/getEnsName.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,EACL,8BAA8B,GAE/B,MAAM,0BAA0B,CAAA;AAGjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAChE,OAAO,EAEL,YAAY,GACb,MAAM,2BAA2B,CAAA;AAuClC,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAuC,EACvC,EACE,OAAO,EACP,WAAW,EACX,QAAQ,EACR,wBAAwB,EAAE,yBAAyB,GAC9B;IAEvB,IAAI,wBAAwB,GAAG,yBAAyB,CAAA;IACxD,IAAI,CAAC,wBAAwB,EAAE;QAC7B,IAAI,CAAC,MAAM,CAAC,KAAK;YACf,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAA;QAEH,wBAAwB,GAAG,uBAAuB,CAAC;YACjD,WAAW;YACX,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,sBAAsB;SACjC,CAAC,CAAA;KACH;IAED,MAAM,WAAW,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,CAAA;IACxE,IAAI;QACF,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE;YACrC,OAAO,EAAE,wBAAwB;YACjC,GAAG,EAAE;gBACH;oBACE,IAAI,EAAE,SAAS;oBACf,IAAI,EAAE,UAAU;oBAChB,eAAe,EAAE,MAAM;oBACvB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;oBAChD,OAAO,EAAE;wBACP,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE;wBACxC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,iBAAiB,EAAE;wBAC5C,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,iBAAiB,EAAE;wBAC5C,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE;qBACtC;iBACF;aACF;YACD,YAAY,EAAE,SAAS;YACvB,IAAI,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;YACzC,WAAW;YACX,QAAQ;SACT,CAAC,CAAA;QACF,OAAO,GAAG,CAAC,CAAC,CAAC,CAAA;KACd;IAAC,OAAO,KAAK,EAAE;QACd,IACE,KAAK,YAAY,8BAA8B;YAC9C,KAAK,CAAC,KAAuC,CAAC,MAAM,KAAK,YAAY,CAAC,EAAE,CAAC;YAG1E,OAAO,IAAI,CAAA;QACb,MAAM,KAAK,CAAA;KACZ;AACH,CAAC"}
1
+ {"version":3,"file":"getEnsName.js","sourceRoot":"","sources":["../../../../src/actions/ens/getEnsName.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,EACL,8BAA8B,GAE/B,MAAM,0BAA0B,CAAA;AAGjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAChE,OAAO,EAEL,YAAY,GACb,MAAM,2BAA2B,CAAA;AAalC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAuC,EACvC,EACE,OAAO,EACP,WAAW,EACX,QAAQ,EACR,wBAAwB,EAAE,yBAAyB,GAC9B;IAEvB,IAAI,wBAAwB,GAAG,yBAAyB,CAAA;IACxD,IAAI,CAAC,wBAAwB,EAAE;QAC7B,IAAI,CAAC,MAAM,CAAC,KAAK;YACf,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAA;QAEH,wBAAwB,GAAG,uBAAuB,CAAC;YACjD,WAAW;YACX,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,sBAAsB;SACjC,CAAC,CAAA;KACH;IAED,MAAM,WAAW,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,CAAA;IACxE,IAAI;QACF,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE;YACrC,OAAO,EAAE,wBAAwB;YACjC,GAAG,EAAE;gBACH;oBACE,IAAI,EAAE,SAAS;oBACf,IAAI,EAAE,UAAU;oBAChB,eAAe,EAAE,MAAM;oBACvB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;oBAChD,OAAO,EAAE;wBACP,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE;wBACxC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,iBAAiB,EAAE;wBAC5C,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,iBAAiB,EAAE;wBAC5C,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE;qBACtC;iBACF;aACF;YACD,YAAY,EAAE,SAAS;YACvB,IAAI,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;YACzC,WAAW;YACX,QAAQ;SACT,CAAC,CAAA;QACF,OAAO,GAAG,CAAC,CAAC,CAAC,CAAA;KACd;IAAC,OAAO,KAAK,EAAE;QACd,IACE,KAAK,YAAY,8BAA8B;YAC9C,KAAK,CAAC,KAAuC,CAAC,MAAM,KAAK,YAAY,CAAC,EAAE,CAAC;YAE1E,mCAAmC;YACnC,OAAO,IAAI,CAAA;QACb,MAAM,KAAK,CAAA;KACZ;AACH,CAAC"}
@@ -2,6 +2,34 @@ import { getChainContractAddress } from '../../utils/chain.js';
2
2
  import { toHex } from '../../utils/encoding/toHex.js';
3
3
  import { packetToBytes } from '../../utils/ens/packetToBytes.js';
4
4
  import { readContract, } from '../public/readContract.js';
5
+ /**
6
+ * Gets resolver for ENS name.
7
+ *
8
+ * - Docs: https://viem.sh/docs/ens/actions/getEnsResolver.html
9
+ * - Examples: https://stackblitz.com/github/wagmi-dev/viem/tree/main/examples/ens
10
+ *
11
+ * Calls `findResolver(bytes)` on ENS Universal Resolver Contract to retrieve the resolver of an ENS name.
12
+ *
13
+ * Since ENS names prohibit certain forbidden characters (e.g. underscore) and have other validation rules, you likely want to [normalize ENS names](https://docs.ens.domains/contract-api-reference/name-processing#normalising-names) with [UTS-46 normalization](https://unicode.org/reports/tr46) before passing them to `getEnsAddress`. You can use the built-in [`normalize`](https://viem.sh/docs/ens/utilities/normalize.html) function for this.
14
+ *
15
+ * @param client - Client to use
16
+ * @param parameters - {@link GetEnsResolverParameters}
17
+ * @returns Address for ENS resolver. {@link GetEnsResolverReturnType}
18
+ *
19
+ * @example
20
+ * import { createPublicClient, http } from 'viem'
21
+ * import { mainnet } from 'viem/chains'
22
+ * import { getEnsResolver, normalize } from 'viem/ens'
23
+ *
24
+ * const client = createPublicClient({
25
+ * chain: mainnet,
26
+ * transport: http(),
27
+ * })
28
+ * const resolverAddress = await getEnsResolver(client, {
29
+ * name: normalize('wagmi-dev.eth'),
30
+ * })
31
+ * // '0x4976fb03C32e5B8cfe2b6cCB31c09Ba78EBaBa41'
32
+ */
5
33
  export async function getEnsResolver(client, { blockNumber, blockTag, name, universalResolverAddress: universalResolverAddress_, }) {
6
34
  let universalResolverAddress = universalResolverAddress_;
7
35
  if (!universalResolverAddress) {
@@ -1 +1 @@
1
- {"version":3,"file":"getEnsResolver.js","sourceRoot":"","sources":["../../../../src/actions/ens/getEnsResolver.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAChE,OAAO,EAEL,YAAY,GACb,MAAM,2BAA2B,CAAA;AAyClC,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAuC,EACvC,EACE,WAAW,EACX,QAAQ,EACR,IAAI,EACJ,wBAAwB,EAAE,yBAAyB,GAC1B;IAE3B,IAAI,wBAAwB,GAAG,yBAAyB,CAAA;IACxD,IAAI,CAAC,wBAAwB,EAAE;QAC7B,IAAI,CAAC,MAAM,CAAC,KAAK;YACf,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAA;QAEH,wBAAwB,GAAG,uBAAuB,CAAC;YACjD,WAAW;YACX,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,sBAAsB;SACjC,CAAC,CAAA;KACH;IAED,MAAM,CAAC,eAAe,CAAC,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE;QACnD,OAAO,EAAE,wBAAwB;QACjC,GAAG,EAAE;YACH;gBACE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBAC3B,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;gBACnD,eAAe,EAAE,MAAM;gBACvB,IAAI,EAAE,UAAU;aACjB;SACF;QACD,YAAY,EAAE,cAAc;QAC5B,IAAI,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;QAClC,WAAW;QACX,QAAQ;KACT,CAAC,CAAA;IACF,OAAO,eAAe,CAAA;AACxB,CAAC"}
1
+ {"version":3,"file":"getEnsResolver.js","sourceRoot":"","sources":["../../../../src/actions/ens/getEnsResolver.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAChE,OAAO,EAEL,YAAY,GACb,MAAM,2BAA2B,CAAA;AAalC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAuC,EACvC,EACE,WAAW,EACX,QAAQ,EACR,IAAI,EACJ,wBAAwB,EAAE,yBAAyB,GAC1B;IAE3B,IAAI,wBAAwB,GAAG,yBAAyB,CAAA;IACxD,IAAI,CAAC,wBAAwB,EAAE;QAC7B,IAAI,CAAC,MAAM,CAAC,KAAK;YACf,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAA;QAEH,wBAAwB,GAAG,uBAAuB,CAAC;YACjD,WAAW;YACX,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,sBAAsB;SACjC,CAAC,CAAA;KACH;IAED,MAAM,CAAC,eAAe,CAAC,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE;QACnD,OAAO,EAAE,wBAAwB;QACjC,GAAG,EAAE;YACH;gBACE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBAC3B,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;gBACnD,eAAe,EAAE,MAAM;gBACvB,IAAI,EAAE,UAAU;aACjB;SACF;QACD,YAAY,EAAE,cAAc;QAC5B,IAAI,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;QAClC,WAAW;QACX,QAAQ;KACT,CAAC,CAAA;IACF,OAAO,eAAe,CAAA;AACxB,CAAC"}
@@ -6,6 +6,35 @@ import { toHex } from '../../utils/encoding/toHex.js';
6
6
  import { namehash } from '../../utils/ens/namehash.js';
7
7
  import { packetToBytes } from '../../utils/ens/packetToBytes.js';
8
8
  import { readContract, } from '../public/readContract.js';
9
+ /**
10
+ * Gets a text record for specified ENS name.
11
+ *
12
+ * - Docs: https://viem.sh/docs/ens/actions/getEnsResolver.html
13
+ * - Examples: https://stackblitz.com/github/wagmi-dev/viem/tree/main/examples/ens
14
+ *
15
+ * Calls `resolve(bytes, bytes)` on ENS Universal Resolver Contract.
16
+ *
17
+ * Since ENS names prohibit certain forbidden characters (e.g. underscore) and have other validation rules, you likely want to [normalize ENS names](https://docs.ens.domains/contract-api-reference/name-processing#normalising-names) with [UTS-46 normalization](https://unicode.org/reports/tr46) before passing them to `getEnsAddress`. You can use the built-in [`normalize`](https://viem.sh/docs/ens/utilities/normalize.html) function for this.
18
+ *
19
+ * @param client - Client to use
20
+ * @param parameters - {@link GetEnsTextParameters}
21
+ * @returns Address for ENS resolver. {@link GetEnsTextReturnType}
22
+ *
23
+ * @example
24
+ * import { createPublicClient, http } from 'viem'
25
+ * import { mainnet } from 'viem/chains'
26
+ * import { getEnsText, normalize } from 'viem/ens'
27
+ *
28
+ * const client = createPublicClient({
29
+ * chain: mainnet,
30
+ * transport: http(),
31
+ * })
32
+ * const twitterRecord = await getEnsText(client, {
33
+ * name: normalize('wagmi-dev.eth'),
34
+ * key: 'com.twitter',
35
+ * })
36
+ * // 'wagmi_sh'
37
+ */
9
38
  export async function getEnsText(client, { blockNumber, blockTag, name, key, universalResolverAddress: universalResolverAddress_, }) {
10
39
  let universalResolverAddress = universalResolverAddress_;
11
40
  if (!universalResolverAddress) {
@@ -1 +1 @@
1
- {"version":3,"file":"getEnsText.js","sourceRoot":"","sources":["../../../../src/actions/ens/getEnsText.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAG/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAA;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAA;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAA;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAChE,OAAO,EAEL,YAAY,GACb,MAAM,2BAA2B,CAAA;AA4ClC,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAuC,EACvC,EACE,WAAW,EACX,QAAQ,EACR,IAAI,EACJ,GAAG,EACH,wBAAwB,EAAE,yBAAyB,GAC9B;IAEvB,IAAI,wBAAwB,GAAG,yBAAyB,CAAA;IACxD,IAAI,CAAC,wBAAwB,EAAE;QAC7B,IAAI,CAAC,MAAM,CAAC,KAAK;YACf,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAA;QAEH,wBAAwB,GAAG,uBAAuB,CAAC;YACjD,WAAW;YACX,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,sBAAsB;SACjC,CAAC,CAAA;KACH;IAED,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE;QACrC,OAAO,EAAE,wBAAwB;QACjC,GAAG,EAAE,oBAAoB;QACzB,YAAY,EAAE,SAAS;QACvB,IAAI,EAAE;YACJ,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YAC1B,kBAAkB,CAAC;gBACjB,GAAG,EAAE,eAAe;gBACpB,YAAY,EAAE,MAAM;gBACpB,IAAI,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC;aAC5B,CAAC;SACH;QACD,WAAW;QACX,QAAQ;KACT,CAAC,CAAA;IAEF,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAEhC,MAAM,MAAM,GAAG,oBAAoB,CAAC;QAClC,GAAG,EAAE,eAAe;QACpB,YAAY,EAAE,MAAM;QACpB,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;KACb,CAAC,CAAA;IAEF,OAAO,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAA;AACtC,CAAC"}
1
+ {"version":3,"file":"getEnsText.js","sourceRoot":"","sources":["../../../../src/actions/ens/getEnsText.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAG/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAA;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAA;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAA;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAChE,OAAO,EAEL,YAAY,GACb,MAAM,2BAA2B,CAAA;AAelC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAuC,EACvC,EACE,WAAW,EACX,QAAQ,EACR,IAAI,EACJ,GAAG,EACH,wBAAwB,EAAE,yBAAyB,GAC9B;IAEvB,IAAI,wBAAwB,GAAG,yBAAyB,CAAA;IACxD,IAAI,CAAC,wBAAwB,EAAE;QAC7B,IAAI,CAAC,MAAM,CAAC,KAAK;YACf,MAAM,IAAI,KAAK,CACb,oEAAoE,CACrE,CAAA;QAEH,wBAAwB,GAAG,uBAAuB,CAAC;YACjD,WAAW;YACX,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,sBAAsB;SACjC,CAAC,CAAA;KACH;IAED,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE;QACrC,OAAO,EAAE,wBAAwB;QACjC,GAAG,EAAE,oBAAoB;QACzB,YAAY,EAAE,SAAS;QACvB,IAAI,EAAE;YACJ,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YAC1B,kBAAkB,CAAC;gBACjB,GAAG,EAAE,eAAe;gBACpB,YAAY,EAAE,MAAM;gBACpB,IAAI,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC;aAC5B,CAAC;SACH;QACD,WAAW;QACX,QAAQ;KACT,CAAC,CAAA;IAEF,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAEhC,MAAM,MAAM,GAAG,oBAAoB,CAAC;QAClC,GAAG,EAAE,eAAe;QACpB,YAAY,EAAE,MAAM;QACpB,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;KACb,CAAC,CAAA;IAEF,OAAO,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAA;AACtC,CAAC"}
@@ -4,6 +4,31 @@ import { readContract, } from './public/readContract.js';
4
4
  import { simulateContract, } from './public/simulateContract.js';
5
5
  import { watchContractEvent, } from './public/watchContractEvent.js';
6
6
  import { writeContract, } from './wallet/writeContract.js';
7
+ /**
8
+ * Gets type-safe interface for performing contract-related actions with a specific `abi` and `address`.
9
+ *
10
+ * - Docs https://viem.sh/docs/contract/getContract.html
11
+ *
12
+ * Using Contract Instances can make it easier to work with contracts if you don't want to pass the `abi` and `address` properites every time you perform contract actions, e.g. [`readContract`](https://viem.sh/docs/contract/readContract.html), [`writeContract`](https://viem.sh/docs/contract/writeContract.html), [`estimateContractGas`](https://viem.sh/docs/contract/estimateContractGas.html), etc.
13
+ *
14
+ * @example
15
+ * import { createPublicClient, getContract, http, parseAbi } from 'viem'
16
+ * import { mainnet } from 'viem/chains'
17
+ *
18
+ * const publicClient = createPublicClient({
19
+ * chain: mainnet,
20
+ * transport: http(),
21
+ * })
22
+ * const contract = getContract({
23
+ * address: '0xFBA3912Ca04dd458c843e2EE08967fC04f3579c2',
24
+ * abi: parseAbi([
25
+ * 'function balanceOf(address owner) view returns (uint256)',
26
+ * 'function ownerOf(uint256 tokenId) view returns (address)',
27
+ * 'function totalSupply() view returns (uint256)',
28
+ * ]),
29
+ * publicClient,
30
+ * })
31
+ */
7
32
  export function getContract({ abi, address, publicClient, walletClient, }) {
8
33
  const hasPublicClient = publicClient !== undefined && publicClient !== null;
9
34
  const hasWalletClient = walletClient !== undefined && walletClient !== null;
@@ -19,6 +44,7 @@ export function getContract({ abi, address, publicClient, walletClient, }) {
19
44
  hasWriteFunction = true;
20
45
  else if (item.type === 'event')
21
46
  hasEvent = true;
47
+ // Exit early if all flags are `true`
22
48
  if (hasReadFunction && hasWriteFunction && hasEvent)
23
49
  break;
24
50
  }
@@ -126,18 +152,28 @@ export function getContract({ abi, address, publicClient, walletClient, }) {
126
152
  contract.abi = abi;
127
153
  return contract;
128
154
  }
155
+ /**
156
+ * @internal exporting for testing only
157
+ */
129
158
  export function getFunctionParameters(values) {
130
159
  const hasArgs = values.length && Array.isArray(values[0]);
131
160
  const args = hasArgs ? values[0] : [];
132
161
  const options = (hasArgs ? values[1] : values[0]) ?? {};
133
162
  return { args, options };
134
163
  }
164
+ /**
165
+ * @internal exporting for testing only
166
+ */
135
167
  export function getEventParameters(values, abiEvent) {
136
168
  let hasArgs = false;
169
+ // If first item is array, must be `args`
137
170
  if (Array.isArray(values[0]))
138
171
  hasArgs = true;
172
+ // Check if first item is `args` or `options`
139
173
  else if (values.length === 1) {
174
+ // if event has indexed inputs, must have `args`
140
175
  hasArgs = abiEvent.inputs.some((x) => x.indexed);
176
+ // If there are two items in array, must have `args`
141
177
  }
142
178
  else if (values.length === 2) {
143
179
  hasArgs = true;
@@ -1 +1 @@
1
- {"version":3,"file":"getContract.js","sourceRoot":"","sources":["../../../src/actions/getContract.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"getContract.js","sourceRoot":"","sources":["../../../src/actions/getContract.ts"],"names":[],"mappings":"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"}
@@ -14,6 +14,31 @@ import { format } from '../../utils/formatters/format.js';
14
14
  import { formatTransactionRequest, } from '../../utils/formatters/transactionRequest.js';
15
15
  import { createBatchScheduler } from '../../utils/promise/createBatchScheduler.js';
16
16
  import { assertRequest } from '../../utils/transaction/assertRequest.js';
17
+ /**
18
+ * Executes a new message call immediately without submitting a transaction to the network.
19
+ *
20
+ * - Docs: https://viem.sh/docs/actions/public/call.html
21
+ * - JSON-RPC Methods: [`eth_call`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_call)
22
+ *
23
+ * @param client - Client to use
24
+ * @param parameters - {@link CallParameters}
25
+ * @returns The call data. {@link CallReturnType}
26
+ *
27
+ * @example
28
+ * import { createPublicClient, http } from 'viem'
29
+ * import { mainnet } from 'viem/chains'
30
+ * import { call } from 'viem/public'
31
+ *
32
+ * const client = createPublicClient({
33
+ * chain: mainnet,
34
+ * transport: http(),
35
+ * })
36
+ * const data = await call(client, {
37
+ * account: '0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266',
38
+ * data: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2',
39
+ * to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
40
+ * })
41
+ */
17
42
  export async function call(client, args) {
18
43
  const { account: account_, batch = Boolean(client.batch?.multicall), blockNumber, blockTag = 'latest', accessList, data, gas, gasPrice, maxFeePerGas, maxPriorityFeePerGas, nonce, to, value, ...rest } = args;
19
44
  const account = account_ ? parseAccount(account_) : undefined;
@@ -33,6 +58,7 @@ export async function call(client, args) {
33
58
  nonce,
34
59
  to,
35
60
  value,
61
+ // Pick out extra data that might exist on the chain's transaction request type.
36
62
  ...extract(rest, { formatter }),
37
63
  }, {
38
64
  formatter: formatter || formatTransactionRequest,
@@ -74,6 +100,11 @@ export async function call(client, args) {
74
100
  });
75
101
  }
76
102
  }
103
+ // We only want to perform a scheduled multicall if:
104
+ // - The request has calldata,
105
+ // - The request has a target address,
106
+ // - The target address is not already the aggregate3 signature,
107
+ // - The request has no other properties (`nonce`, `gas`, etc cannot be sent with a multicall).
77
108
  function shouldPerformMulticall({ request }) {
78
109
  const { data, to, ...request_ } = request;
79
110
  if (!data)
@@ -1 +1 @@
1
- {"version":3,"file":"call.js","sourceRoot":"","sources":["../../../../src/actions/public/call.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"call.js","sourceRoot":"","sources":["../../../../src/actions/public/call.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,25 @@
1
1
  import { createFilterRequestScope } from '../../utils/filters/createFilterRequestScope.js';
2
+ /**
3
+ * Creates a [`Filter`](https://viem.sh/docs/glossary/types.html#filter) to listen for new block hashes that can be used with [`getFilterChanges`](https://viem.sh/docs/actions/public/getFilterChanges.html).
4
+ *
5
+ * - Docs: https://viem.sh/docs/actions/public/createBlockFilter.html
6
+ * - JSON-RPC Methods: [`eth_newBlockFilter`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_newBlockFilter)
7
+ *
8
+ * @param client - Client to use
9
+ * @returns [`Filter`](https://viem.sh/docs/glossary/types.html#filter). {@link CreateBlockFilterReturnType}
10
+ *
11
+ * @example
12
+ * import { createPublicClient, http } from 'viem'
13
+ * import { mainnet } from 'viem/chains'
14
+ * import { createBlockFilter } from 'viem/public'
15
+ *
16
+ * const client = createPublicClient({
17
+ * chain: mainnet,
18
+ * transport: http(),
19
+ * })
20
+ * const filter = await createBlockFilter(client)
21
+ * // { id: "0x345a6572337856574a76364e457a4366", type: 'block' }
22
+ */
2
23
  export async function createBlockFilter(client) {
3
24
  const getRequest = createFilterRequestScope(client, {
4
25
  method: 'eth_newBlockFilter',
@@ -1 +1 @@
1
- {"version":3,"file":"createBlockFilter.js","sourceRoot":"","sources":["../../../../src/actions/public/createBlockFilter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAA;AAyB1F,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAuC;IAEvC,MAAM,UAAU,GAAG,wBAAwB,CAAC,MAAM,EAAE;QAClD,MAAM,EAAE,oBAAoB;KAC7B,CAAC,CAAA;IACF,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QAC9B,MAAM,EAAE,oBAAoB;KAC7B,CAAC,CAAA;IACF,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;AACvD,CAAC"}
1
+ {"version":3,"file":"createBlockFilter.js","sourceRoot":"","sources":["../../../../src/actions/public/createBlockFilter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAA;AAI1F;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAuC;IAEvC,MAAM,UAAU,GAAG,wBAAwB,CAAC,MAAM,EAAE;QAClD,MAAM,EAAE,oBAAoB;KAC7B,CAAC,CAAA;IACF,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QAC9B,MAAM,EAAE,oBAAoB;KAC7B,CAAC,CAAA;IACF,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;AACvD,CAAC"}
@@ -1,6 +1,28 @@
1
1
  import { encodeEventTopics, } from '../../utils/abi/encodeEventTopics.js';
2
2
  import { numberToHex } from '../../utils/encoding/toHex.js';
3
3
  import { createFilterRequestScope } from '../../utils/filters/createFilterRequestScope.js';
4
+ /**
5
+ * Creates a Filter to retrieve event logs that can be used with [`getFilterChanges`](https://viem.sh/docs/actions/public/getFilterChanges.html) or [`getFilterLogs`](https://viem.sh/docs/actions/public/getFilterLogs.html).
6
+ *
7
+ * - Docs: https://viem.sh/docs/contract/createContractEventFilter.html
8
+ *
9
+ * @param client - Client to use
10
+ * @param parameters - {@link CreateContractEventFilterParameters}
11
+ * @returns [`Filter`](https://viem.sh/docs/glossary/types.html#filter). {@link CreateContractEventFilterReturnType}
12
+ *
13
+ * @example
14
+ * import { createPublicClient, http, parseAbi } from 'viem'
15
+ * import { mainnet } from 'viem/chains'
16
+ * import { createContractEventFilter } from 'viem/contract'
17
+ *
18
+ * const client = createPublicClient({
19
+ * chain: mainnet,
20
+ * transport: http(),
21
+ * })
22
+ * const filter = await createContractEventFilter(client, {
23
+ * abi: parseAbi(['event Transfer(address indexed, address indexed, uint256)']),
24
+ * })
25
+ */
4
26
  export async function createContractEventFilter(client, { address, abi, args, eventName, fromBlock, strict, toBlock, }) {
5
27
  const getRequest = createFilterRequestScope(client, {
6
28
  method: 'eth_newFilter',
@@ -1 +1 @@
1
- {"version":3,"file":"createContractEventFilter.js","sourceRoot":"","sources":["../../../../src/actions/public/createContractEventFilter.ts"],"names":[],"mappings":"AAWA,OAAO,EAEL,iBAAiB,GAClB,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAA;AAkE1F,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAO7C,MAAuC,EACvC,EACE,OAAO,EACP,GAAG,EACH,IAAI,EACJ,SAAS,EACT,SAAS,EACT,MAAM,EACN,OAAO,GAC+D;IAIxE,MAAM,UAAU,GAAG,wBAAwB,CAAC,MAAM,EAAE;QAClD,MAAM,EAAE,eAAe;KACxB,CAAC,CAAA;IAEF,MAAM,MAAM,GAAG,SAAS;QACtB,CAAC,CAAC,iBAAiB,CAAC;YAChB,GAAG;YACH,IAAI;YACJ,SAAS;SACgC,CAAC;QAC9C,CAAC,CAAC,SAAS,CAAA;IACb,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QAC9B,MAAM,EAAE,eAAe;QACvB,MAAM,EAAE;YACN;gBACE,OAAO;gBACP,SAAS,EACP,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;gBACpE,OAAO,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO;gBACrE,MAAM;aACP;SACF;KACF,CAAC,CAAA;IAEF,OAAO;QACL,GAAG;QACH,IAAI;QACJ,SAAS;QACT,EAAE;QACF,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC;QACvB,MAAM;QACN,IAAI,EAAE,OAAO;KAMd,CAAA;AACH,CAAC"}
1
+ {"version":3,"file":"createContractEventFilter.js","sourceRoot":"","sources":["../../../../src/actions/public/createContractEventFilter.ts"],"names":[],"mappings":"AAWA,OAAO,EAEL,iBAAiB,GAClB,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAA;AA4C1F;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAO7C,MAAuC,EACvC,EACE,OAAO,EACP,GAAG,EACH,IAAI,EACJ,SAAS,EACT,SAAS,EACT,MAAM,EACN,OAAO,GAC+D;IAIxE,MAAM,UAAU,GAAG,wBAAwB,CAAC,MAAM,EAAE;QAClD,MAAM,EAAE,eAAe;KACxB,CAAC,CAAA;IAEF,MAAM,MAAM,GAAG,SAAS;QACtB,CAAC,CAAC,iBAAiB,CAAC;YAChB,GAAG;YACH,IAAI;YACJ,SAAS;SACgC,CAAC;QAC9C,CAAC,CAAC,SAAS,CAAA;IACb,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QAC9B,MAAM,EAAE,eAAe;QACvB,MAAM,EAAE;YACN;gBACE,OAAO;gBACP,SAAS,EACP,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;gBACpE,OAAO,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO;gBACrE,MAAM;aACP;SACF;KACF,CAAC,CAAA;IAEF,OAAO;QACL,GAAG;QACH,IAAI;QACJ,SAAS;QACT,EAAE;QACF,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC;QACvB,MAAM;QACN,IAAI,EAAE,OAAO;KAMd,CAAA;AACH,CAAC"}
@@ -1,6 +1,29 @@
1
1
  import { encodeEventTopics, } from '../../utils/abi/encodeEventTopics.js';
2
2
  import { numberToHex } from '../../utils/encoding/toHex.js';
3
3
  import { createFilterRequestScope } from '../../utils/filters/createFilterRequestScope.js';
4
+ /**
5
+ * Creates a [`Filter`](https://viem.sh/docs/glossary/types.html#filter) to listen for new events that can be used with [`getFilterChanges`](https://viem.sh/docs/actions/public/getFilterChanges.html).
6
+ *
7
+ * - Docs: https://viem.sh/docs/actions/public/createEventFilter.html
8
+ * - JSON-RPC Methods: [`eth_newFilter`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_newfilter)
9
+ *
10
+ * @param client - Client to use
11
+ * @param parameters - {@link CreateEventFilterParameters}
12
+ * @returns [`Filter`](https://viem.sh/docs/glossary/types.html#filter). {@link CreateEventFilterReturnType}
13
+ *
14
+ * @example
15
+ * import { createPublicClient, http } from 'viem'
16
+ * import { mainnet } from 'viem/chains'
17
+ * import { createEventFilter } from 'viem/public'
18
+ *
19
+ * const client = createPublicClient({
20
+ * chain: mainnet,
21
+ * transport: http(),
22
+ * })
23
+ * const filter = await createEventFilter(client, {
24
+ * address: '0xfba3912ca04dd458c843e2ee08967fc04f3579c2',
25
+ * })
26
+ */
4
27
  export async function createEventFilter(client, { address, args, event, fromBlock, strict, toBlock, } = {}) {
5
28
  const getRequest = createFilterRequestScope(client, {
6
29
  method: 'eth_newFilter',
@@ -1 +1 @@
1
- {"version":3,"file":"createEventFilter.js","sourceRoot":"","sources":["../../../../src/actions/public/createEventFilter.ts"],"names":[],"mappings":"AAaA,OAAO,EAEL,iBAAiB,GAClB,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAA;AAmF1F,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAUrC,MAAuC,EACvC,EACE,OAAO,EACP,IAAI,EACJ,KAAK,EACL,SAAS,EACT,MAAM,EACN,OAAO,MAOL,EAAS;IAIb,MAAM,UAAU,GAAG,wBAAwB,CAAC,MAAM,EAAE;QAClD,MAAM,EAAE,eAAe;KACxB,CAAC,CAAA;IAEF,IAAI,MAAM,GAAe,EAAE,CAAA;IAC3B,IAAI,KAAK;QACP,MAAM,GAAG,iBAAiB,CAAC;YACzB,GAAG,EAAE,CAAC,KAAK,CAAC;YACZ,SAAS,EAAG,KAAkB,CAAC,IAAI;YACnC,IAAI;SAC0B,CAAC,CAAA;IAEnC,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QAC9B,MAAM,EAAE,eAAe;QACvB,MAAM,EAAE;YACN;gBACE,OAAO;gBACP,SAAS,EACP,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;gBACpE,OAAO,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO;gBACrE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACrC;SACF;KACF,CAAC,CAAA;IAEF,OAAO;QACL,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;QAChC,IAAI;QACJ,SAAS,EAAE,KAAK,CAAC,CAAC,CAAE,KAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QACvD,EAAE;QACF,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC;QACvB,MAAM;QACN,IAAI,EAAE,OAAO;KAOd,CAAA;AACH,CAAC"}
1
+ {"version":3,"file":"createEventFilter.js","sourceRoot":"","sources":["../../../../src/actions/public/createEventFilter.ts"],"names":[],"mappings":"AAaA,OAAO,EAEL,iBAAiB,GAClB,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAA;AA4D1F;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAUrC,MAAuC,EACvC,EACE,OAAO,EACP,IAAI,EACJ,KAAK,EACL,SAAS,EACT,MAAM,EACN,OAAO,MAOL,EAAS;IAIb,MAAM,UAAU,GAAG,wBAAwB,CAAC,MAAM,EAAE;QAClD,MAAM,EAAE,eAAe;KACxB,CAAC,CAAA;IAEF,IAAI,MAAM,GAAe,EAAE,CAAA;IAC3B,IAAI,KAAK;QACP,MAAM,GAAG,iBAAiB,CAAC;YACzB,GAAG,EAAE,CAAC,KAAK,CAAC;YACZ,SAAS,EAAG,KAAkB,CAAC,IAAI;YACnC,IAAI;SAC0B,CAAC,CAAA;IAEnC,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QAC9B,MAAM,EAAE,eAAe;QACvB,MAAM,EAAE;YACN;gBACE,OAAO;gBACP,SAAS,EACP,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;gBACpE,OAAO,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO;gBACrE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACrC;SACF;KACF,CAAC,CAAA;IAEF,OAAO;QACL,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;QAChC,IAAI;QACJ,SAAS,EAAE,KAAK,CAAC,CAAC,CAAE,KAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QACvD,EAAE;QACF,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC;QACvB,MAAM;QACN,IAAI,EAAE,OAAO;KAOd,CAAA;AACH,CAAC"}
@@ -1,4 +1,25 @@
1
1
  import { createFilterRequestScope } from '../../utils/filters/createFilterRequestScope.js';
2
+ /**
3
+ * Creates a Filter to listen for new pending transaction hashes that can be used with [`getFilterChanges`](https://viem.sh/docs/actions/public/getFilterChanges.html).
4
+ *
5
+ * - Docs: https://viem.sh/docs/actions/public/createPendingTransactionFilter.html
6
+ * - JSON-RPC Methods: [`eth_newPendingTransactionFilter`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_newpendingtransactionfilter)
7
+ *
8
+ * @param client - Client to use
9
+ * @returns [`Filter`](https://viem.sh/docs/glossary/types.html#filter). {@link CreateBlockFilterReturnType}
10
+ *
11
+ * @example
12
+ * import { createPublicClient, http } from 'viem'
13
+ * import { mainnet } from 'viem/chains'
14
+ * import { createPendingTransactionFilter } from 'viem/public'
15
+ *
16
+ * const client = createPublicClient({
17
+ * chain: mainnet,
18
+ * transport: http(),
19
+ * })
20
+ * const filter = await createPendingTransactionFilter(client)
21
+ * // { id: "0x345a6572337856574a76364e457a4366", type: 'transaction' }
22
+ */
2
23
  export async function createPendingTransactionFilter(client) {
3
24
  const getRequest = createFilterRequestScope(client, {
4
25
  method: 'eth_newPendingTransactionFilter',
@@ -1 +1 @@
1
- {"version":3,"file":"createPendingTransactionFilter.js","sourceRoot":"","sources":["../../../../src/actions/public/createPendingTransactionFilter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAA;AAyB1F,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAIlD,MAAwC;IAExC,MAAM,UAAU,GAAG,wBAAwB,CAAC,MAAM,EAAE;QAClD,MAAM,EAAE,iCAAiC;KAC1C,CAAC,CAAA;IACF,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QAC9B,MAAM,EAAE,iCAAiC;KAC1C,CAAC,CAAA;IACF,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAA;AAC7D,CAAC"}
1
+ {"version":3,"file":"createPendingTransactionFilter.js","sourceRoot":"","sources":["../../../../src/actions/public/createPendingTransactionFilter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAA;AAI1F;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAIlD,MAAwC;IAExC,MAAM,UAAU,GAAG,wBAAwB,CAAC,MAAM,EAAE;QAClD,MAAM,EAAE,iCAAiC;KAC1C,CAAC,CAAA;IACF,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;QAC9B,MAAM,EAAE,iCAAiC;KAC1C,CAAC,CAAA;IACF,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAA;AAC7D,CAAC"}
@@ -2,6 +2,33 @@ import { parseAccount } from '../../accounts/utils/parseAccount.js';
2
2
  import { encodeFunctionData, } from '../../utils/abi/encodeFunctionData.js';
3
3
  import { getContractError } from '../../utils/errors/getContractError.js';
4
4
  import { estimateGas } from './estimateGas.js';
5
+ /**
6
+ * Estimates the gas required to successfully execute a contract write function call.
7
+ *
8
+ * - Docs: https://viem.sh/docs/contract/estimateContractGas.html
9
+ *
10
+ * Internally, uses a [Public Client](https://viem.sh/docs/clients/public.html) to call the [`estimateGas` action](https://viem.sh/docs/actions/public/estimateGas.html) with [ABI-encoded `data`](https://viem.sh/docs/contract/encodeFunctionData.html).
11
+ *
12
+ * @param client - Client to use
13
+ * @param parameters - {@link EstimateContractGasParameters}
14
+ * @returns The gas estimate (in wei). {@link EstimateContractGasReturnType}
15
+ *
16
+ * @example
17
+ * import { createPublicClient, http, parseAbi } from 'viem'
18
+ * import { mainnet } from 'viem/chains'
19
+ * import { estimateContractGas } from 'viem/contract'
20
+ *
21
+ * const client = createPublicClient({
22
+ * chain: mainnet,
23
+ * transport: http(),
24
+ * })
25
+ * const gas = await estimateContractGas(client, {
26
+ * address: '0xFBA3912Ca04dd458c843e2EE08967fC04f3579c2',
27
+ * abi: parseAbi(['function mint() public']),
28
+ * functionName: 'mint',
29
+ * account: '0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266',
30
+ * })
31
+ */
5
32
  export async function estimateContractGas(client, { abi, address, args, functionName, ...request }) {
6
33
  const data = encodeFunctionData({
7
34
  abi,
@@ -1 +1 @@
1
- {"version":3,"file":"estimateContractGas.js","sourceRoot":"","sources":["../../../../src/actions/public/estimateContractGas.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAA;AAMnE,OAAO,EAEL,kBAAkB,GACnB,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAA;AAGzE,OAAO,EAA8B,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAwC1E,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAMvC,MAE6C,EAC7C,EACE,GAAG,EACH,OAAO,EACP,IAAI,EACJ,YAAY,EACZ,GAAG,OAAO,EAC2D;IAEvE,MAAM,IAAI,GAAG,kBAAkB,CAAC;QAC9B,GAAG;QACH,IAAI;QACJ,YAAY;KACmD,CAAC,CAAA;IAClE,IAAI;QACF,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE;YACpC,IAAI;YACJ,EAAE,EAAE,OAAO;YACX,GAAG,OAAO;SACiC,CAAC,CAAA;QAC9C,OAAO,GAAG,CAAA;KACX;IAAC,OAAO,GAAG,EAAE;QACZ,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QAC3E,MAAM,gBAAgB,CAAC,GAAgB,EAAE;YACvC,GAAG,EAAE,GAAU;YACf,OAAO;YACP,IAAI;YACJ,QAAQ,EAAE,iCAAiC;YAC3C,YAAY;YACZ,MAAM,EAAE,OAAO,EAAE,OAAO;SACzB,CAAC,CAAA;KACH;AACH,CAAC"}
1
+ {"version":3,"file":"estimateContractGas.js","sourceRoot":"","sources":["../../../../src/actions/public/estimateContractGas.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAA;AAMnE,OAAO,EAEL,kBAAkB,GACnB,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAA;AAGzE,OAAO,EAA8B,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAa1E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAMvC,MAE6C,EAC7C,EACE,GAAG,EACH,OAAO,EACP,IAAI,EACJ,YAAY,EACZ,GAAG,OAAO,EAC2D;IAEvE,MAAM,IAAI,GAAG,kBAAkB,CAAC;QAC9B,GAAG;QACH,IAAI;QACJ,YAAY;KACmD,CAAC,CAAA;IAClE,IAAI;QACF,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE;YACpC,IAAI;YACJ,EAAE,EAAE,OAAO;YACX,GAAG,OAAO;SACiC,CAAC,CAAA;QAC9C,OAAO,GAAG,CAAA;KACX;IAAC,OAAO,GAAG,EAAE;QACZ,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QAC3E,MAAM,gBAAgB,CAAC,GAAgB,EAAE;YACvC,GAAG,EAAE,GAAU;YACf,OAAO;YACP,IAAI;YACJ,QAAQ,EAAE,iCAAiC;YAC3C,YAAY;YACZ,MAAM,EAAE,OAAO,EAAE,OAAO;SACzB,CAAC,CAAA;KACH;AACH,CAAC"}
@@ -7,6 +7,31 @@ import { format } from '../../utils/formatters/format.js';
7
7
  import { formatTransactionRequest, } from '../../utils/formatters/transactionRequest.js';
8
8
  import { assertRequest } from '../../utils/transaction/assertRequest.js';
9
9
  import { prepareRequest } from '../../utils/transaction/prepareRequest.js';
10
+ /**
11
+ * Estimates the gas necessary to complete a transaction without submitting it to the network.
12
+ *
13
+ * - Docs: https://viem.sh/docs/actions/public/estimateGas.html
14
+ * - JSON-RPC Methods: [`eth_estimateGas`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_estimategas)
15
+ *
16
+ * @param client - Client to use
17
+ * @param parameters - {@link EstimateGasParameters}
18
+ * @returns The gas estimate (in wei). {@link EstimateGasReturnType}
19
+ *
20
+ * @example
21
+ * import { createPublicClient, http, parseEther } from 'viem'
22
+ * import { mainnet } from 'viem/chains'
23
+ * import { estimateGas } from 'viem/public'
24
+ *
25
+ * const client = createPublicClient({
26
+ * chain: mainnet,
27
+ * transport: http(),
28
+ * })
29
+ * const gasEstimate = await estimateGas(client, {
30
+ * account: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
31
+ * to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
32
+ * value: parseEther('1'),
33
+ * })
34
+ */
10
35
  export async function estimateGas(client, args) {
11
36
  const account_ = args.account ?? client.account;
12
37
  if (!account_)
@@ -31,6 +56,7 @@ export async function estimateGas(client, args) {
31
56
  nonce,
32
57
  to,
33
58
  value,
59
+ // Pick out extra data that might exist on the chain's transaction request type.
34
60
  ...extract(rest, { formatter }),
35
61
  }, {
36
62
  formatter: formatter || formatTransactionRequest,
@@ -1 +1 @@
1
- {"version":3,"file":"estimateGas.js","sourceRoot":"","sources":["../../../../src/actions/public/estimateGas.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAA;AAInE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAQ9D,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAA;AAC/E,OAAO,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAA;AAC3D,OAAO,EAAkB,MAAM,EAAE,MAAM,kCAAkC,CAAA;AACzE,OAAO,EAEL,wBAAwB,GACzB,MAAM,8CAA8C,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAA;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAA;AAyD1E,MAAM,CAAC,KAAK,UAAU,WAAW,CAI/B,MAE6C,EAC7C,IAA6C;IAE7C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,IAAK,MAAuB,CAAC,OAAO,CAAA;IACjE,IAAI,CAAC,QAAQ;QACX,MAAM,IAAI,oBAAoB,CAAC;YAC7B,QAAQ,EAAE,kCAAkC;SAC7C,CAAC,CAAA;IACJ,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;IAEtC,IAAI;QACF,MAAM,EACJ,UAAU,EACV,WAAW,EACX,QAAQ,EACR,IAAI,EACJ,GAAG,EACH,QAAQ,EACR,YAAY,EACZ,oBAAoB,EACpB,KAAK,EACL,EAAE,EACF,KAAK,EACL,GAAG,IAAI,EACR,GAAG,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QAExE,MAAM,cAAc,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QACzE,MAAM,KAAK,GAAG,cAAc,IAAI,QAAQ,CAAA;QAExC,aAAa,CAAC,IAAI,CAAC,CAAA;QAEnB,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,kBAAkB,CAAA;QAC9D,MAAM,OAAO,GAAG,MAAM,CACpB;YACE,IAAI,EAAE,OAAO,CAAC,OAAO;YACrB,UAAU;YACV,IAAI;YACJ,GAAG;YACH,QAAQ;YACR,YAAY;YACZ,oBAAoB;YACpB,KAAK;YACL,EAAE;YACF,KAAK;YAEL,GAAG,OAAO,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC;SACV,EACvB;YACE,SAAS,EAAE,SAAS,IAAI,wBAAwB;SACjD,CACF,CAAA;QAED,MAAM,OAAO,GAAG,MAAO,MAAuB,CAAC,OAAO,CAAC;YACrD,MAAM,EAAE,iBAAiB;YACzB,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;SAC7C,CAAC,CAAA;QACF,OAAO,MAAM,CAAC,OAAO,CAAC,CAAA;KACvB;IAAC,OAAO,GAAG,EAAE;QACZ,MAAM,mBAAmB,CAAC,GAAgB,EAAE;YAC1C,GAAG,IAAI;YACP,OAAO;YACP,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC,CAAA;KACH;AACH,CAAC"}
1
+ {"version":3,"file":"estimateGas.js","sourceRoot":"","sources":["../../../../src/actions/public/estimateGas.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAA;AAInE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAQ9D,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAA;AAC/E,OAAO,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAA;AAC3D,OAAO,EAAkB,MAAM,EAAE,MAAM,kCAAkC,CAAA;AACzE,OAAO,EAEL,wBAAwB,GACzB,MAAM,8CAA8C,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAA;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAA;AAgC1E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAI/B,MAE6C,EAC7C,IAA6C;IAE7C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,IAAK,MAAuB,CAAC,OAAO,CAAA;IACjE,IAAI,CAAC,QAAQ;QACX,MAAM,IAAI,oBAAoB,CAAC;YAC7B,QAAQ,EAAE,kCAAkC;SAC7C,CAAC,CAAA;IACJ,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;IAEtC,IAAI;QACF,MAAM,EACJ,UAAU,EACV,WAAW,EACX,QAAQ,EACR,IAAI,EACJ,GAAG,EACH,QAAQ,EACR,YAAY,EACZ,oBAAoB,EACpB,KAAK,EACL,EAAE,EACF,KAAK,EACL,GAAG,IAAI,EACR,GAAG,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QAExE,MAAM,cAAc,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QACzE,MAAM,KAAK,GAAG,cAAc,IAAI,QAAQ,CAAA;QAExC,aAAa,CAAC,IAAI,CAAC,CAAA;QAEnB,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,kBAAkB,CAAA;QAC9D,MAAM,OAAO,GAAG,MAAM,CACpB;YACE,IAAI,EAAE,OAAO,CAAC,OAAO;YACrB,UAAU;YACV,IAAI;YACJ,GAAG;YACH,QAAQ;YACR,YAAY;YACZ,oBAAoB;YACpB,KAAK;YACL,EAAE;YACF,KAAK;YACL,gFAAgF;YAChF,GAAG,OAAO,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC;SACV,EACvB;YACE,SAAS,EAAE,SAAS,IAAI,wBAAwB;SACjD,CACF,CAAA;QAED,MAAM,OAAO,GAAG,MAAO,MAAuB,CAAC,OAAO,CAAC;YACrD,MAAM,EAAE,iBAAiB;YACzB,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;SAC7C,CAAC,CAAA;QACF,OAAO,MAAM,CAAC,OAAO,CAAC,CAAA;KACvB;IAAC,OAAO,GAAG,EAAE;QACZ,MAAM,mBAAmB,CAAC,GAAgB,EAAE;YAC1C,GAAG,IAAI;YACP,OAAO;YACP,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC,CAAA;KACH;AACH,CAAC"}