viem 1.0.2 → 1.0.3

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 (355) hide show
  1. package/dist/cjs/chains.js.map +1 -1
  2. package/dist/cjs/errors/base.js +4 -11
  3. package/dist/cjs/errors/base.js.map +1 -1
  4. package/dist/cjs/errors/version.js +1 -1
  5. package/dist/cjs/utils/encoding/toBytes.js.map +1 -1
  6. package/dist/cjs/utils/encoding/toHex.js.map +1 -1
  7. package/dist/cjs/utils/formatters/block.js +3 -1
  8. package/dist/cjs/utils/formatters/block.js.map +1 -1
  9. package/dist/cjs/utils/formatters/transaction.js +3 -1
  10. package/dist/cjs/utils/formatters/transaction.js.map +1 -1
  11. package/dist/cjs/utils/formatters/transactionReceipt.js.map +1 -1
  12. package/dist/cjs/utils/formatters/transactionRequest.js.map +1 -1
  13. package/dist/cjs/utils/observe.js.map +1 -1
  14. package/dist/cjs/utils/promise/createBatchScheduler.js.map +1 -1
  15. package/dist/cjs/utils/promise/withCache.js.map +1 -1
  16. package/dist/cjs/utils/rpc.js.map +1 -1
  17. package/dist/cjs/utils/unit/parseUnits.js +1 -2
  18. package/dist/cjs/utils/unit/parseUnits.js.map +1 -1
  19. package/dist/esm/accounts/generateMnemonic.js +7 -0
  20. package/dist/esm/accounts/generateMnemonic.js.map +1 -1
  21. package/dist/esm/accounts/generatePrivateKey.js +5 -0
  22. package/dist/esm/accounts/generatePrivateKey.js.map +1 -1
  23. package/dist/esm/accounts/hdKeyToAccount.js +5 -0
  24. package/dist/esm/accounts/hdKeyToAccount.js.map +1 -1
  25. package/dist/esm/accounts/mnemonicToAccount.js +5 -0
  26. package/dist/esm/accounts/mnemonicToAccount.js.map +1 -1
  27. package/dist/esm/accounts/privateKeyToAccount.js +5 -0
  28. package/dist/esm/accounts/privateKeyToAccount.js.map +1 -1
  29. package/dist/esm/accounts/toAccount.js +5 -0
  30. package/dist/esm/accounts/toAccount.js.map +1 -1
  31. package/dist/esm/accounts/utils/publicKeyToAddress.js +7 -0
  32. package/dist/esm/accounts/utils/publicKeyToAddress.js.map +1 -1
  33. package/dist/esm/accounts/utils/sign.js +8 -0
  34. package/dist/esm/accounts/utils/sign.js.map +1 -1
  35. package/dist/esm/accounts/utils/signMessage.js +6 -0
  36. package/dist/esm/accounts/utils/signMessage.js.map +1 -1
  37. package/dist/esm/accounts/utils/signTypedData.js +6 -0
  38. package/dist/esm/accounts/utils/signTypedData.js.map +1 -1
  39. package/dist/esm/actions/ens/getEnsAddress.js +28 -0
  40. package/dist/esm/actions/ens/getEnsAddress.js.map +1 -1
  41. package/dist/esm/actions/ens/getEnsAvatar.js +28 -0
  42. package/dist/esm/actions/ens/getEnsAvatar.js.map +1 -1
  43. package/dist/esm/actions/ens/getEnsName.js +27 -0
  44. package/dist/esm/actions/ens/getEnsName.js.map +1 -1
  45. package/dist/esm/actions/ens/getEnsResolver.js +28 -0
  46. package/dist/esm/actions/ens/getEnsResolver.js.map +1 -1
  47. package/dist/esm/actions/ens/getEnsText.js +29 -0
  48. package/dist/esm/actions/ens/getEnsText.js.map +1 -1
  49. package/dist/esm/actions/getContract.js +36 -0
  50. package/dist/esm/actions/getContract.js.map +1 -1
  51. package/dist/esm/actions/public/call.js +31 -0
  52. package/dist/esm/actions/public/call.js.map +1 -1
  53. package/dist/esm/actions/public/createBlockFilter.js +21 -0
  54. package/dist/esm/actions/public/createBlockFilter.js.map +1 -1
  55. package/dist/esm/actions/public/createContractEventFilter.js +22 -0
  56. package/dist/esm/actions/public/createContractEventFilter.js.map +1 -1
  57. package/dist/esm/actions/public/createEventFilter.js +23 -0
  58. package/dist/esm/actions/public/createEventFilter.js.map +1 -1
  59. package/dist/esm/actions/public/createPendingTransactionFilter.js +21 -0
  60. package/dist/esm/actions/public/createPendingTransactionFilter.js.map +1 -1
  61. package/dist/esm/actions/public/estimateContractGas.js +27 -0
  62. package/dist/esm/actions/public/estimateContractGas.js.map +1 -1
  63. package/dist/esm/actions/public/estimateGas.js +26 -0
  64. package/dist/esm/actions/public/estimateGas.js.map +1 -1
  65. package/dist/esm/actions/public/getBalance.js +35 -0
  66. package/dist/esm/actions/public/getBalance.js.map +1 -1
  67. package/dist/esm/actions/public/getBlock.js +24 -0
  68. package/dist/esm/actions/public/getBlock.js.map +1 -1
  69. package/dist/esm/actions/public/getBlockNumber.js +23 -0
  70. package/dist/esm/actions/public/getBlockNumber.js.map +1 -1
  71. package/dist/esm/actions/public/getBlockTransactionCount.js +23 -0
  72. package/dist/esm/actions/public/getBlockTransactionCount.js.map +1 -1
  73. package/dist/esm/actions/public/getBytecode.js +23 -0
  74. package/dist/esm/actions/public/getBytecode.js.map +1 -1
  75. package/dist/esm/actions/public/getChainId.js +21 -0
  76. package/dist/esm/actions/public/getChainId.js.map +1 -1
  77. package/dist/esm/actions/public/getFeeHistory.js +24 -0
  78. package/dist/esm/actions/public/getFeeHistory.js.map +1 -1
  79. package/dist/esm/actions/public/getFilterChanges.js +84 -0
  80. package/dist/esm/actions/public/getFilterChanges.js.map +1 -1
  81. package/dist/esm/actions/public/getFilterLogs.js +29 -0
  82. package/dist/esm/actions/public/getFilterLogs.js.map +1 -1
  83. package/dist/esm/actions/public/getGasPrice.js +20 -0
  84. package/dist/esm/actions/public/getGasPrice.js.map +1 -1
  85. package/dist/esm/actions/public/getLogs.js +24 -0
  86. package/dist/esm/actions/public/getLogs.js.map +1 -1
  87. package/dist/esm/actions/public/getStorageAt.js +24 -0
  88. package/dist/esm/actions/public/getStorageAt.js.map +1 -1
  89. package/dist/esm/actions/public/getTransaction.js +24 -0
  90. package/dist/esm/actions/public/getTransaction.js.map +1 -1
  91. package/dist/esm/actions/public/getTransactionConfirmations.js +24 -0
  92. package/dist/esm/actions/public/getTransactionConfirmations.js.map +1 -1
  93. package/dist/esm/actions/public/getTransactionCount.js +23 -0
  94. package/dist/esm/actions/public/getTransactionCount.js.map +1 -1
  95. package/dist/esm/actions/public/getTransactionReceipt.js +24 -0
  96. package/dist/esm/actions/public/getTransactionReceipt.js.map +1 -1
  97. package/dist/esm/actions/public/multicall.js +40 -0
  98. package/dist/esm/actions/public/multicall.js.map +1 -1
  99. package/dist/esm/actions/public/readContract.js +31 -0
  100. package/dist/esm/actions/public/readContract.js.map +1 -1
  101. package/dist/esm/actions/public/simulateContract.js +31 -0
  102. package/dist/esm/actions/public/simulateContract.js.map +1 -1
  103. package/dist/esm/actions/public/uninstallFilter.js +24 -0
  104. package/dist/esm/actions/public/uninstallFilter.js.map +1 -1
  105. package/dist/esm/actions/public/verifyHash.js +10 -0
  106. package/dist/esm/actions/public/verifyHash.js.map +1 -1
  107. package/dist/esm/actions/public/verifyMessage.js +11 -0
  108. package/dist/esm/actions/public/verifyMessage.js.map +1 -1
  109. package/dist/esm/actions/public/verifyTypedData.js +9 -0
  110. package/dist/esm/actions/public/verifyTypedData.js.map +1 -1
  111. package/dist/esm/actions/public/waitForTransactionReceipt.js +52 -0
  112. package/dist/esm/actions/public/waitForTransactionReceipt.js.map +1 -1
  113. package/dist/esm/actions/public/watchBlockNumber.js +31 -0
  114. package/dist/esm/actions/public/watchBlockNumber.js.map +1 -1
  115. package/dist/esm/actions/public/watchBlocks.js +35 -1
  116. package/dist/esm/actions/public/watchBlocks.js.map +1 -1
  117. package/dist/esm/actions/public/watchContractEvent.js +36 -0
  118. package/dist/esm/actions/public/watchContractEvent.js.map +1 -1
  119. package/dist/esm/actions/public/watchEvent.js +38 -0
  120. package/dist/esm/actions/public/watchEvent.js.map +1 -1
  121. package/dist/esm/actions/public/watchPendingTransactions.js +29 -0
  122. package/dist/esm/actions/public/watchPendingTransactions.js.map +1 -1
  123. package/dist/esm/actions/test/dropTransaction.js +22 -0
  124. package/dist/esm/actions/test/dropTransaction.js.map +1 -1
  125. package/dist/esm/actions/test/getAutomine.js +20 -0
  126. package/dist/esm/actions/test/getAutomine.js.map +1 -1
  127. package/dist/esm/actions/test/getTxpoolContent.js +20 -0
  128. package/dist/esm/actions/test/getTxpoolContent.js.map +1 -1
  129. package/dist/esm/actions/test/getTxpoolStatus.js +20 -0
  130. package/dist/esm/actions/test/getTxpoolStatus.js.map +1 -1
  131. package/dist/esm/actions/test/impersonateAccount.js +22 -0
  132. package/dist/esm/actions/test/impersonateAccount.js.map +1 -1
  133. package/dist/esm/actions/test/increaseTime.js +22 -0
  134. package/dist/esm/actions/test/increaseTime.js.map +1 -1
  135. package/dist/esm/actions/test/inspectTxpool.js +20 -0
  136. package/dist/esm/actions/test/inspectTxpool.js.map +1 -1
  137. package/dist/esm/actions/test/mine.js +20 -0
  138. package/dist/esm/actions/test/mine.js.map +1 -1
  139. package/dist/esm/actions/test/removeBlockTimestampInterval.js +19 -0
  140. package/dist/esm/actions/test/removeBlockTimestampInterval.js.map +1 -1
  141. package/dist/esm/actions/test/reset.js +20 -0
  142. package/dist/esm/actions/test/reset.js.map +1 -1
  143. package/dist/esm/actions/test/revert.js +20 -0
  144. package/dist/esm/actions/test/revert.js.map +1 -1
  145. package/dist/esm/actions/test/sendUnsignedTransaction.js +25 -0
  146. package/dist/esm/actions/test/sendUnsignedTransaction.js.map +1 -1
  147. package/dist/esm/actions/test/setAutomine.js +19 -0
  148. package/dist/esm/actions/test/setAutomine.js.map +1 -1
  149. package/dist/esm/actions/test/setBalance.js +23 -0
  150. package/dist/esm/actions/test/setBalance.js.map +1 -1
  151. package/dist/esm/actions/test/setBlockGasLimit.js +20 -0
  152. package/dist/esm/actions/test/setBlockGasLimit.js.map +1 -1
  153. package/dist/esm/actions/test/setBlockTimestampInterval.js +20 -0
  154. package/dist/esm/actions/test/setBlockTimestampInterval.js.map +1 -1
  155. package/dist/esm/actions/test/setCode.js +23 -0
  156. package/dist/esm/actions/test/setCode.js.map +1 -1
  157. package/dist/esm/actions/test/setCoinbase.js +22 -0
  158. package/dist/esm/actions/test/setCoinbase.js.map +1 -1
  159. package/dist/esm/actions/test/setIntervalMining.js +20 -0
  160. package/dist/esm/actions/test/setIntervalMining.js.map +1 -1
  161. package/dist/esm/actions/test/setLoggingEnabled.js +19 -0
  162. package/dist/esm/actions/test/setLoggingEnabled.js.map +1 -1
  163. package/dist/esm/actions/test/setMinGasPrice.js +24 -0
  164. package/dist/esm/actions/test/setMinGasPrice.js.map +1 -1
  165. package/dist/esm/actions/test/setNextBlockBaseFeePerGas.js +22 -0
  166. package/dist/esm/actions/test/setNextBlockBaseFeePerGas.js.map +1 -1
  167. package/dist/esm/actions/test/setNextBlockTimestamp.js +20 -0
  168. package/dist/esm/actions/test/setNextBlockTimestamp.js.map +1 -1
  169. package/dist/esm/actions/test/setNonce.js +23 -0
  170. package/dist/esm/actions/test/setNonce.js.map +1 -1
  171. package/dist/esm/actions/test/setRpcUrl.js +20 -0
  172. package/dist/esm/actions/test/setRpcUrl.js.map +1 -1
  173. package/dist/esm/actions/test/setStorageAt.js +24 -0
  174. package/dist/esm/actions/test/setStorageAt.js.map +1 -1
  175. package/dist/esm/actions/test/snapshot.js +19 -0
  176. package/dist/esm/actions/test/snapshot.js.map +1 -1
  177. package/dist/esm/actions/test/stopImpersonatingAccount.js +22 -0
  178. package/dist/esm/actions/test/stopImpersonatingAccount.js.map +1 -1
  179. package/dist/esm/actions/wallet/addChain.js +19 -0
  180. package/dist/esm/actions/wallet/addChain.js.map +1 -1
  181. package/dist/esm/actions/wallet/deployContract.js +27 -0
  182. package/dist/esm/actions/wallet/deployContract.js.map +1 -1
  183. package/dist/esm/actions/wallet/getAddresses.js +20 -0
  184. package/dist/esm/actions/wallet/getAddresses.js.map +1 -1
  185. package/dist/esm/actions/wallet/getPermissions.js +20 -0
  186. package/dist/esm/actions/wallet/getPermissions.js.map +1 -1
  187. package/dist/esm/actions/wallet/requestAddresses.js +24 -0
  188. package/dist/esm/actions/wallet/requestAddresses.js.map +1 -1
  189. package/dist/esm/actions/wallet/requestPermissions.js +23 -0
  190. package/dist/esm/actions/wallet/requestPermissions.js.map +1 -1
  191. package/dist/esm/actions/wallet/sendTransaction.js +47 -0
  192. package/dist/esm/actions/wallet/sendTransaction.js.map +1 -1
  193. package/dist/esm/actions/wallet/signMessage.js +46 -0
  194. package/dist/esm/actions/wallet/signMessage.js.map +1 -1
  195. package/dist/esm/actions/wallet/signTypedData.js +100 -0
  196. package/dist/esm/actions/wallet/signTypedData.js.map +1 -1
  197. package/dist/esm/actions/wallet/switchChain.js +20 -0
  198. package/dist/esm/actions/wallet/switchChain.js.map +1 -1
  199. package/dist/esm/actions/wallet/watchAsset.js +28 -0
  200. package/dist/esm/actions/wallet/watchAsset.js.map +1 -1
  201. package/dist/esm/actions/wallet/writeContract.js +50 -0
  202. package/dist/esm/actions/wallet/writeContract.js.map +1 -1
  203. package/dist/esm/chains.js +96 -96
  204. package/dist/esm/chains.js.map +1 -1
  205. package/dist/esm/clients/createClient.js +3 -0
  206. package/dist/esm/clients/createClient.js.map +1 -1
  207. package/dist/esm/clients/createPublicClient.js +19 -0
  208. package/dist/esm/clients/createPublicClient.js.map +1 -1
  209. package/dist/esm/clients/createTestClient.js +23 -0
  210. package/dist/esm/clients/createTestClient.js.map +1 -1
  211. package/dist/esm/clients/createWalletClient.js +36 -0
  212. package/dist/esm/clients/createWalletClient.js.map +1 -1
  213. package/dist/esm/clients/transports/createTransport.js +3 -0
  214. package/dist/esm/clients/transports/createTransport.js.map +1 -1
  215. package/dist/esm/clients/transports/custom.js +3 -0
  216. package/dist/esm/clients/transports/custom.js.map +1 -1
  217. package/dist/esm/clients/transports/fallback.js +11 -0
  218. package/dist/esm/clients/transports/fallback.js.map +1 -1
  219. package/dist/esm/clients/transports/http.js +6 -1
  220. package/dist/esm/clients/transports/http.js.map +1 -1
  221. package/dist/esm/clients/transports/webSocket.js +6 -1
  222. package/dist/esm/clients/transports/webSocket.js.map +1 -1
  223. package/dist/esm/constants/abis.js +6 -0
  224. package/dist/esm/constants/abis.js.map +1 -1
  225. package/dist/esm/constants/solidity.js +1 -0
  226. package/dist/esm/constants/solidity.js.map +1 -1
  227. package/dist/esm/contract.js +0 -1
  228. package/dist/esm/contract.js.map +1 -1
  229. package/dist/esm/errors/base.js +4 -11
  230. package/dist/esm/errors/base.js.map +1 -1
  231. package/dist/esm/errors/node.js +9 -0
  232. package/dist/esm/errors/node.js.map +1 -1
  233. package/dist/esm/errors/rpc.js +103 -0
  234. package/dist/esm/errors/rpc.js.map +1 -1
  235. package/dist/esm/errors/version.js +1 -1
  236. package/dist/esm/index.js +0 -52
  237. package/dist/esm/index.js.map +1 -1
  238. package/dist/esm/package.json +1 -1
  239. package/dist/esm/types/account.js +1 -1
  240. package/dist/esm/types/account.js.map +1 -1
  241. package/dist/esm/types/eip1193.js +2 -0
  242. package/dist/esm/types/eip1193.js.map +1 -1
  243. package/dist/esm/utils/abi/decodeAbiParameters.js +29 -0
  244. package/dist/esm/utils/abi/decodeAbiParameters.js.map +1 -1
  245. package/dist/esm/utils/abi/decodeEventLog.js +2 -0
  246. package/dist/esm/utils/abi/decodeEventLog.js.map +1 -1
  247. package/dist/esm/utils/abi/encodeAbiParameters.js +10 -1
  248. package/dist/esm/utils/abi/encodeAbiParameters.js.map +1 -1
  249. package/dist/esm/utils/abi/getAbiItem.js +7 -0
  250. package/dist/esm/utils/abi/getAbiItem.js.map +1 -1
  251. package/dist/esm/utils/accounts.js +3 -0
  252. package/dist/esm/utils/accounts.js.map +1 -1
  253. package/dist/esm/utils/buildRequest.js +2 -0
  254. package/dist/esm/utils/buildRequest.js.map +1 -1
  255. package/dist/esm/utils/data/size.js +6 -0
  256. package/dist/esm/utils/data/size.js.map +1 -1
  257. package/dist/esm/utils/data/slice.js +21 -0
  258. package/dist/esm/utils/data/slice.js.map +1 -1
  259. package/dist/esm/utils/encoding/fromBytes.js +79 -0
  260. package/dist/esm/utils/encoding/fromBytes.js.map +1 -1
  261. package/dist/esm/utils/encoding/fromHex.js +106 -0
  262. package/dist/esm/utils/encoding/fromHex.js.map +1 -1
  263. package/dist/esm/utils/encoding/toBytes.js +102 -1
  264. package/dist/esm/utils/encoding/toBytes.js.map +1 -1
  265. package/dist/esm/utils/encoding/toHex.js +108 -2
  266. package/dist/esm/utils/encoding/toHex.js.map +1 -1
  267. package/dist/esm/utils/ens/avatar/parseAvatarRecord.js +6 -2
  268. package/dist/esm/utils/ens/avatar/parseAvatarRecord.js.map +1 -1
  269. package/dist/esm/utils/ens/avatar/utils.js +10 -0
  270. package/dist/esm/utils/ens/avatar/utils.js.map +1 -1
  271. package/dist/esm/utils/ens/labelhash.js +9 -0
  272. package/dist/esm/utils/ens/labelhash.js.map +1 -1
  273. package/dist/esm/utils/ens/namehash.js +12 -0
  274. package/dist/esm/utils/ens/namehash.js.map +1 -1
  275. package/dist/esm/utils/ens/normalize.js +10 -0
  276. package/dist/esm/utils/ens/normalize.js.map +1 -1
  277. package/dist/esm/utils/ens/packetToBytes.js +6 -0
  278. package/dist/esm/utils/ens/packetToBytes.js.map +1 -1
  279. package/dist/esm/utils/filters/createFilterRequestScope.js +5 -0
  280. package/dist/esm/utils/filters/createFilterRequestScope.js.map +1 -1
  281. package/dist/esm/utils/formatters/block.js +4 -1
  282. package/dist/esm/utils/formatters/block.js.map +1 -1
  283. package/dist/esm/utils/formatters/extract.js +3 -0
  284. package/dist/esm/utils/formatters/extract.js.map +1 -1
  285. package/dist/esm/utils/formatters/format.js +3 -0
  286. package/dist/esm/utils/formatters/format.js.map +1 -1
  287. package/dist/esm/utils/formatters/transaction.js +3 -1
  288. package/dist/esm/utils/formatters/transaction.js.map +1 -1
  289. package/dist/esm/utils/formatters/transactionReceipt.js +1 -1
  290. package/dist/esm/utils/formatters/transactionReceipt.js.map +1 -1
  291. package/dist/esm/utils/formatters/transactionRequest.js +1 -1
  292. package/dist/esm/utils/formatters/transactionRequest.js.map +1 -1
  293. package/dist/esm/utils/observe.js +7 -2
  294. package/dist/esm/utils/observe.js.map +1 -1
  295. package/dist/esm/utils/poll.js +3 -0
  296. package/dist/esm/utils/poll.js.map +1 -1
  297. package/dist/esm/utils/promise/createBatchScheduler.js +1 -1
  298. package/dist/esm/utils/promise/createBatchScheduler.js.map +1 -1
  299. package/dist/esm/utils/promise/withCache.js +15 -2
  300. package/dist/esm/utils/promise/withCache.js.map +1 -1
  301. package/dist/esm/utils/regex.js +4 -0
  302. package/dist/esm/utils/regex.js.map +1 -1
  303. package/dist/esm/utils/rpc.js +14 -1
  304. package/dist/esm/utils/rpc.js.map +1 -1
  305. package/dist/esm/utils/signature/hashTypedData.js +3 -0
  306. package/dist/esm/utils/signature/hashTypedData.js.map +1 -1
  307. package/dist/esm/utils/signature/recoverPublicKey.js +2 -0
  308. package/dist/esm/utils/signature/recoverPublicKey.js.map +1 -1
  309. package/dist/esm/utils/signature/verifyMessage.js +12 -0
  310. package/dist/esm/utils/signature/verifyMessage.js.map +1 -1
  311. package/dist/esm/utils/signature/verifyTypedData.js +12 -0
  312. package/dist/esm/utils/signature/verifyTypedData.js.map +1 -1
  313. package/dist/esm/utils/transaction/prepareRequest.js +5 -1
  314. package/dist/esm/utils/transaction/prepareRequest.js.map +1 -1
  315. package/dist/esm/utils/transaction/serializeTransaction.js +4 -2
  316. package/dist/esm/utils/transaction/serializeTransaction.js.map +1 -1
  317. package/dist/esm/utils/typedData.js +4 -0
  318. package/dist/esm/utils/typedData.js.map +1 -1
  319. package/dist/esm/utils/unit/parseUnits.js +3 -2
  320. package/dist/esm/utils/unit/parseUnits.js.map +1 -1
  321. package/dist/types/actions/public/getBlockNumber.d.ts +2 -2
  322. package/dist/types/actions/public/getBlockNumber.d.ts.map +1 -1
  323. package/dist/types/chains.d.ts.map +1 -1
  324. package/dist/types/contract.d.ts +1 -1
  325. package/dist/types/contract.d.ts.map +1 -1
  326. package/dist/types/errors/base.d.ts +0 -1
  327. package/dist/types/errors/base.d.ts.map +1 -1
  328. package/dist/types/errors/version.d.ts +1 -1
  329. package/dist/types/index.d.ts +52 -52
  330. package/dist/types/index.d.ts.map +1 -1
  331. package/dist/types/types/account.d.ts +1 -1
  332. package/dist/types/types/account.d.ts.map +1 -1
  333. package/dist/types/utils/formatters/block.d.ts.map +1 -1
  334. package/dist/types/utils/formatters/transaction.d.ts.map +1 -1
  335. package/dist/types/utils/observe.d.ts.map +1 -1
  336. package/dist/types/utils/promise/withCache.d.ts.map +1 -1
  337. package/dist/types/utils/unit/parseUnits.d.ts.map +1 -1
  338. package/package.json +1 -1
  339. package/src/chains.ts +120 -97
  340. package/src/contract.ts +3 -3
  341. package/src/errors/base.ts +6 -6
  342. package/src/errors/version.ts +1 -1
  343. package/src/index.ts +221 -221
  344. package/src/types/account.ts +9 -9
  345. package/src/utils/encoding/toBytes.ts +1 -1
  346. package/src/utils/encoding/toHex.ts +2 -2
  347. package/src/utils/formatters/block.ts +3 -1
  348. package/src/utils/formatters/transaction.ts +3 -1
  349. package/src/utils/formatters/transactionReceipt.ts +1 -1
  350. package/src/utils/formatters/transactionRequest.ts +1 -1
  351. package/src/utils/observe.ts +2 -2
  352. package/src/utils/promise/createBatchScheduler.ts +1 -1
  353. package/src/utils/promise/withCache.ts +2 -2
  354. package/src/utils/rpc.ts +1 -1
  355. package/src/utils/unit/parseUnits.ts +1 -5
@@ -1,4 +1,24 @@
1
1
  import { numberToHex } from '../../utils/encoding/toHex.js';
2
+ /**
3
+ * Sets the block's gas limit.
4
+ *
5
+ * - Docs: https://viem.sh/docs/actions/test/setBlockGasLimit.html
6
+ *
7
+ * @param client - Client to use
8
+ * @param parameters – {@link SetBlockGasLimitParameters}
9
+ *
10
+ * @example
11
+ * import { createTestClient, http } from 'viem'
12
+ * import { foundry } from 'viem/chains'
13
+ * import { setBlockGasLimit } from 'viem/test'
14
+ *
15
+ * const client = createTestClient({
16
+ * mode: 'anvil',
17
+ * chain: 'foundry',
18
+ * transport: http(),
19
+ * })
20
+ * await setBlockGasLimit(client, { gasLimit: 420_000n })
21
+ */
2
22
  export async function setBlockGasLimit(client, { gasLimit }) {
3
23
  await client.request({
4
24
  method: 'evm_setBlockGasLimit',
@@ -1 +1 @@
1
- {"version":3,"file":"setBlockGasLimit.js","sourceRoot":"","sources":["../../../../src/actions/test/setBlockGasLimit.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AA2B3D,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAqD,EACrD,EAAE,QAAQ,EAA8B;IAExC,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,EAAE,sBAAsB;QAC9B,MAAM,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;KAChC,CAAC,CAAA;AACJ,CAAC"}
1
+ {"version":3,"file":"setBlockGasLimit.js","sourceRoot":"","sources":["../../../../src/actions/test/setBlockGasLimit.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAO3D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAqD,EACrD,EAAE,QAAQ,EAA8B;IAExC,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,EAAE,sBAAsB;QAC9B,MAAM,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;KAChC,CAAC,CAAA;AACJ,CAAC"}
@@ -1,3 +1,23 @@
1
+ /**
2
+ * Similar to [`increaseTime`](https://viem.sh/docs/actions/test/increaseTime.html), but sets a block timestamp `interval`. The timestamp of future blocks will be computed as `lastBlock_timestamp` + `interval`.
3
+ *
4
+ * - Docs: https://viem.sh/docs/actions/test/setBlockTimestampInterval.html
5
+ *
6
+ * @param client - Client to use
7
+ * @param parameters – {@link SetBlockTimestampIntervalParameters}
8
+ *
9
+ * @example
10
+ * import { createTestClient, http } from 'viem'
11
+ * import { foundry } from 'viem/chains'
12
+ * import { setBlockTimestampInterval } from 'viem/test'
13
+ *
14
+ * const client = createTestClient({
15
+ * mode: 'anvil',
16
+ * chain: 'foundry',
17
+ * transport: http(),
18
+ * })
19
+ * await setBlockTimestampInterval(client, { interval: 5 })
20
+ */
1
21
  export async function setBlockTimestampInterval(client, { interval }) {
2
22
  await client.request({
3
23
  method: `${client.mode}_setBlockTimestampInterval`,
@@ -1 +1 @@
1
- {"version":3,"file":"setBlockTimestampInterval.js","sourceRoot":"","sources":["../../../../src/actions/test/setBlockTimestampInterval.ts"],"names":[],"mappings":"AAgCA,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAG7C,MAAqD,EACrD,EAAE,QAAQ,EAAuC;IAEjD,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,4BAA4B;QAClD,MAAM,EAAE,CAAC,QAAQ,CAAC;KACnB,CAAC,CAAA;AACJ,CAAC"}
1
+ {"version":3,"file":"setBlockTimestampInterval.js","sourceRoot":"","sources":["../../../../src/actions/test/setBlockTimestampInterval.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAG7C,MAAqD,EACrD,EAAE,QAAQ,EAAuC;IAEjD,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,4BAA4B;QAClD,MAAM,EAAE,CAAC,QAAQ,CAAC;KACnB,CAAC,CAAA;AACJ,CAAC"}
@@ -1,3 +1,26 @@
1
+ /**
2
+ * Modifies the bytecode stored at an account's address.
3
+ *
4
+ * - Docs: https://viem.sh/docs/actions/test/setCode.html
5
+ *
6
+ * @param client - Client to use
7
+ * @param parameters – {@link SetCodeParameters}
8
+ *
9
+ * @example
10
+ * import { createTestClient, http } from 'viem'
11
+ * import { foundry } from 'viem/chains'
12
+ * import { setCode } from 'viem/test'
13
+ *
14
+ * const client = createTestClient({
15
+ * mode: 'anvil',
16
+ * chain: 'foundry',
17
+ * transport: http(),
18
+ * })
19
+ * await setCode(client, {
20
+ * address: '0xe846c6fcf817734ca4527b28ccb4aea2b6663c79',
21
+ * bytecode: '0x60806040526000600355600019600955600c80546001600160a01b031916737a250d5630b4cf539739df…',
22
+ * })
23
+ */
1
24
  export async function setCode(client, { address, bytecode }) {
2
25
  await client.request({
3
26
  method: `${client.mode}_setCode`,
@@ -1 +1 @@
1
- {"version":3,"file":"setCode.js","sourceRoot":"","sources":["../../../../src/actions/test/setCode.ts"],"names":[],"mappings":"AAwCA,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAqD,EACrD,EAAE,OAAO,EAAE,QAAQ,EAAqB;IAExC,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,UAAU;QAChC,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;KAC5B,CAAC,CAAA;AACJ,CAAC"}
1
+ {"version":3,"file":"setCode.js","sourceRoot":"","sources":["../../../../src/actions/test/setCode.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAqD,EACrD,EAAE,OAAO,EAAE,QAAQ,EAAqB;IAExC,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,UAAU;QAChC,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;KAC5B,CAAC,CAAA;AACJ,CAAC"}
@@ -1,3 +1,25 @@
1
+ /**
2
+ * Sets the coinbase address to be used in new blocks.
3
+ *
4
+ * - Docs: https://viem.sh/docs/actions/test/setCoinbase.html
5
+ *
6
+ * @param client - Client to use
7
+ * @param parameters – {@link SetCoinbaseParameters}
8
+ *
9
+ * @example
10
+ * import { createTestClient, http } from 'viem'
11
+ * import { foundry } from 'viem/chains'
12
+ * import { setCoinbase } from 'viem/test'
13
+ *
14
+ * const client = createTestClient({
15
+ * mode: 'anvil',
16
+ * chain: 'foundry',
17
+ * transport: http(),
18
+ * })
19
+ * await setCoinbase(client, {
20
+ * address: '0xe846c6fcf817734ca4527b28ccb4aea2b6663c79',
21
+ * })
22
+ */
1
23
  export async function setCoinbase(client, { address }) {
2
24
  await client.request({
3
25
  method: `${client.mode}_setCoinbase`,
@@ -1 +1 @@
1
- {"version":3,"file":"setCoinbase.js","sourceRoot":"","sources":["../../../../src/actions/test/setCoinbase.ts"],"names":[],"mappings":"AAoCA,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAqD,EACrD,EAAE,OAAO,EAAyB;IAElC,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,cAAc;QACpC,MAAM,EAAE,CAAC,OAAO,CAAC;KAClB,CAAC,CAAA;AACJ,CAAC"}
1
+ {"version":3,"file":"setCoinbase.js","sourceRoot":"","sources":["../../../../src/actions/test/setCoinbase.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAqD,EACrD,EAAE,OAAO,EAAyB;IAElC,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,cAAc;QACpC,MAAM,EAAE,CAAC,OAAO,CAAC;KAClB,CAAC,CAAA;AACJ,CAAC"}
@@ -1,3 +1,23 @@
1
+ /**
2
+ * Sets the automatic mining interval (in seconds) of blocks. Setting the interval to 0 will disable automatic mining.
3
+ *
4
+ * - Docs: https://viem.sh/docs/actions/test/setIntervalMining.html
5
+ *
6
+ * @param client - Client to use
7
+ * @param parameters – {@link SetIntervalMiningParameters}
8
+ *
9
+ * @example
10
+ * import { createTestClient, http } from 'viem'
11
+ * import { foundry } from 'viem/chains'
12
+ * import { setIntervalMining } from 'viem/test'
13
+ *
14
+ * const client = createTestClient({
15
+ * mode: 'anvil',
16
+ * chain: 'foundry',
17
+ * transport: http(),
18
+ * })
19
+ * await setIntervalMining(client, { interval: 5 })
20
+ */
1
21
  export async function setIntervalMining(client, { interval }) {
2
22
  await client.request({
3
23
  method: 'evm_setIntervalMining',
@@ -1 +1 @@
1
- {"version":3,"file":"setIntervalMining.js","sourceRoot":"","sources":["../../../../src/actions/test/setIntervalMining.ts"],"names":[],"mappings":"AAgCA,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAqD,EACrD,EAAE,QAAQ,EAA+B;IAEzC,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,EAAE,uBAAuB;QAC/B,MAAM,EAAE,CAAC,QAAQ,CAAC;KACnB,CAAC,CAAA;AACJ,CAAC"}
1
+ {"version":3,"file":"setIntervalMining.js","sourceRoot":"","sources":["../../../../src/actions/test/setIntervalMining.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAqD,EACrD,EAAE,QAAQ,EAA+B;IAEzC,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,EAAE,uBAAuB;QAC/B,MAAM,EAAE,CAAC,QAAQ,CAAC;KACnB,CAAC,CAAA;AACJ,CAAC"}
@@ -1,3 +1,22 @@
1
+ /**
2
+ * Enable or disable logging on the test node network.
3
+ *
4
+ * - Docs: https://viem.sh/docs/actions/test/setLoggingEnabled.html
5
+ *
6
+ * @param client - Client to use
7
+ *
8
+ * @example
9
+ * import { createTestClient, http } from 'viem'
10
+ * import { foundry } from 'viem/chains'
11
+ * import { setLoggingEnabled } from 'viem/test'
12
+ *
13
+ * const client = createTestClient({
14
+ * mode: 'anvil',
15
+ * chain: 'foundry',
16
+ * transport: http(),
17
+ * })
18
+ * await setLoggingEnabled(client)
19
+ */
1
20
  export async function setLoggingEnabled(client, enabled) {
2
21
  await client.request({
3
22
  method: `${client.mode}_setLoggingEnabled`,
@@ -1 +1 @@
1
- {"version":3,"file":"setLoggingEnabled.js","sourceRoot":"","sources":["../../../../src/actions/test/setLoggingEnabled.ts"],"names":[],"mappings":"AA0BA,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAqD,EACrD,OAAgB;IAEhB,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,oBAAoB;QAC1C,MAAM,EAAE,CAAC,OAAO,CAAC;KAClB,CAAC,CAAA;AACJ,CAAC"}
1
+ {"version":3,"file":"setLoggingEnabled.js","sourceRoot":"","sources":["../../../../src/actions/test/setLoggingEnabled.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAqD,EACrD,OAAgB;IAEhB,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,oBAAoB;QAC1C,MAAM,EAAE,CAAC,OAAO,CAAC;KAClB,CAAC,CAAA;AACJ,CAAC"}
@@ -1,4 +1,28 @@
1
1
  import { numberToHex } from '../../utils/encoding/toHex.js';
2
+ /**
3
+ * Change the minimum gas price accepted by the network (in wei).
4
+ *
5
+ * - Docs: https://viem.sh/docs/actions/test/setMinGasPrice.html
6
+ *
7
+ * Note: `setMinGasPrice` can only be used on clients that do not have EIP-1559 enabled.
8
+ *
9
+ * @param client - Client to use
10
+ * @param parameters – {@link SetBlockGasLimitParameters}
11
+ *
12
+ * @example
13
+ * import { createTestClient, http, parseGwei } from 'viem'
14
+ * import { foundry } from 'viem/chains'
15
+ * import { setMinGasPrice } from 'viem/test'
16
+ *
17
+ * const client = createTestClient({
18
+ * mode: 'anvil',
19
+ * chain: 'foundry',
20
+ * transport: http(),
21
+ * })
22
+ * await setMinGasPrice(client, {
23
+ * gasPrice: parseGwei('20'),
24
+ * })
25
+ */
2
26
  export async function setMinGasPrice(client, { gasPrice }) {
3
27
  await client.request({
4
28
  method: `${client.mode}_setMinGasPrice`,
@@ -1 +1 @@
1
- {"version":3,"file":"setMinGasPrice.js","sourceRoot":"","sources":["../../../../src/actions/test/setMinGasPrice.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AA+B3D,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAqD,EACrD,EAAE,QAAQ,EAA4B;IAEtC,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,iBAAiB;QACvC,MAAM,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;KAChC,CAAC,CAAA;AACJ,CAAC"}
1
+ {"version":3,"file":"setMinGasPrice.js","sourceRoot":"","sources":["../../../../src/actions/test/setMinGasPrice.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAO3D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAqD,EACrD,EAAE,QAAQ,EAA4B;IAEtC,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,iBAAiB;QACvC,MAAM,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;KAChC,CAAC,CAAA;AACJ,CAAC"}
@@ -1,4 +1,26 @@
1
1
  import { numberToHex } from '../../utils/encoding/toHex.js';
2
+ /**
3
+ * Sets the next block's base fee per gas.
4
+ *
5
+ * - Docs: https://viem.sh/docs/actions/test/setNextBlockBaseFeePerGas.html
6
+ *
7
+ * @param client - Client to use
8
+ * @param parameters – {@link SetNextBlockBaseFeePerGasParameters}
9
+ *
10
+ * @example
11
+ * import { createTestClient, http, parseGwei } from 'viem'
12
+ * import { foundry } from 'viem/chains'
13
+ * import { setNextBlockBaseFeePerGas } from 'viem/test'
14
+ *
15
+ * const client = createTestClient({
16
+ * mode: 'anvil',
17
+ * chain: 'foundry',
18
+ * transport: http(),
19
+ * })
20
+ * await setNextBlockBaseFeePerGas(client, {
21
+ * baseFeePerGas: parseGwei('20'),
22
+ * })
23
+ */
2
24
  export async function setNextBlockBaseFeePerGas(client, { baseFeePerGas }) {
3
25
  await client.request({
4
26
  method: `${client.mode}_setNextBlockBaseFeePerGas`,
@@ -1 +1 @@
1
- {"version":3,"file":"setNextBlockBaseFeePerGas.js","sourceRoot":"","sources":["../../../../src/actions/test/setNextBlockBaseFeePerGas.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AA6B3D,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAG7C,MAAqD,EACrD,EAAE,aAAa,EAAuC;IAEtD,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,4BAA4B;QAClD,MAAM,EAAE,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;KACrC,CAAC,CAAA;AACJ,CAAC"}
1
+ {"version":3,"file":"setNextBlockBaseFeePerGas.js","sourceRoot":"","sources":["../../../../src/actions/test/setNextBlockBaseFeePerGas.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAO3D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAG7C,MAAqD,EACrD,EAAE,aAAa,EAAuC;IAEtD,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,4BAA4B;QAClD,MAAM,EAAE,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;KACrC,CAAC,CAAA;AACJ,CAAC"}
@@ -1,4 +1,24 @@
1
1
  import { numberToHex } from '../../utils/encoding/toHex.js';
2
+ /**
3
+ * Sets the next block's timestamp.
4
+ *
5
+ * - Docs: https://viem.sh/docs/actions/test/setNextBlockTimestamp.html
6
+ *
7
+ * @param client - Client to use
8
+ * @param parameters – {@link SetNextBlockTimestampParameters}
9
+ *
10
+ * @example
11
+ * import { createTestClient, http } from 'viem'
12
+ * import { foundry } from 'viem/chains'
13
+ * import { setNextBlockTimestamp } from 'viem/test'
14
+ *
15
+ * const client = createTestClient({
16
+ * mode: 'anvil',
17
+ * chain: 'foundry',
18
+ * transport: http(),
19
+ * })
20
+ * await setNextBlockTimestamp(client, { timestamp: 1671744314n })
21
+ */
2
22
  export async function setNextBlockTimestamp(client, { timestamp }) {
3
23
  await client.request({
4
24
  method: 'evm_setNextBlockTimestamp',
@@ -1 +1 @@
1
- {"version":3,"file":"setNextBlockTimestamp.js","sourceRoot":"","sources":["../../../../src/actions/test/setNextBlockTimestamp.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AA2B3D,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAqD,EACrD,EAAE,SAAS,EAAmC;IAE9C,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,EAAE,2BAA2B;QACnC,MAAM,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;KACjC,CAAC,CAAA;AACJ,CAAC"}
1
+ {"version":3,"file":"setNextBlockTimestamp.js","sourceRoot":"","sources":["../../../../src/actions/test/setNextBlockTimestamp.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAO3D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAqD,EACrD,EAAE,SAAS,EAAmC;IAE9C,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,EAAE,2BAA2B;QACnC,MAAM,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;KACjC,CAAC,CAAA;AACJ,CAAC"}
@@ -1,4 +1,27 @@
1
1
  import { numberToHex } from '../../utils/encoding/toHex.js';
2
+ /**
3
+ * Modifies (overrides) the nonce of an account.
4
+ *
5
+ * - Docs: https://viem.sh/docs/actions/test/setNonce.html
6
+ *
7
+ * @param client - Client to use
8
+ * @param parameters – {@link SetNonceParameters}
9
+ *
10
+ * @example
11
+ * import { createTestClient, http } from 'viem'
12
+ * import { foundry } from 'viem/chains'
13
+ * import { setNonce } from 'viem/test'
14
+ *
15
+ * const client = createTestClient({
16
+ * mode: 'anvil',
17
+ * chain: 'foundry',
18
+ * transport: http(),
19
+ * })
20
+ * await setNonce(client, {
21
+ * address: '0xa5cc3c03994DB5b0d9A5eEdD10CabaB0813678AC',
22
+ * nonce: 420,
23
+ * })
24
+ */
2
25
  export async function setNonce(client, { address, nonce }) {
3
26
  await client.request({
4
27
  method: `${client.mode}_setNonce`,
@@ -1 +1 @@
1
- {"version":3,"file":"setNonce.js","sourceRoot":"","sources":["../../../../src/actions/test/setNonce.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAgC3D,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAqD,EACrD,EAAE,OAAO,EAAE,KAAK,EAAsB;IAEtC,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,WAAW;QACjC,MAAM,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC;KACtC,CAAC,CAAA;AACJ,CAAC"}
1
+ {"version":3,"file":"setNonce.js","sourceRoot":"","sources":["../../../../src/actions/test/setNonce.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAS3D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAqD,EACrD,EAAE,OAAO,EAAE,KAAK,EAAsB;IAEtC,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,WAAW;QACjC,MAAM,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC;KACtC,CAAC,CAAA;AACJ,CAAC"}
@@ -1,3 +1,23 @@
1
+ /**
2
+ * Sets the backend RPC URL.
3
+ *
4
+ * - Docs: https://viem.sh/docs/actions/test/setRpcUrl.html
5
+ *
6
+ * @param client - Client to use
7
+ * @param jsonRpcUrl – RPC URL
8
+ *
9
+ * @example
10
+ * import { createTestClient, http } from 'viem'
11
+ * import { foundry } from 'viem/chains'
12
+ * import { setRpcUrl } from 'viem/test'
13
+ *
14
+ * const client = createTestClient({
15
+ * mode: 'anvil',
16
+ * chain: 'foundry',
17
+ * transport: http(),
18
+ * })
19
+ * await setRpcUrl(client, 'https://eth-mainnet.g.alchemy.com/v2')
20
+ */
1
21
  export async function setRpcUrl(client, jsonRpcUrl) {
2
22
  await client.request({
3
23
  method: `${client.mode}_setRpcUrl`,
@@ -1 +1 @@
1
- {"version":3,"file":"setRpcUrl.js","sourceRoot":"","sources":["../../../../src/actions/test/setRpcUrl.ts"],"names":[],"mappings":"AA2BA,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAqD,EACrD,UAAkB;IAElB,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,YAAY;QAClC,MAAM,EAAE,CAAC,UAAU,CAAC;KACrB,CAAC,CAAA;AACJ,CAAC"}
1
+ {"version":3,"file":"setRpcUrl.js","sourceRoot":"","sources":["../../../../src/actions/test/setRpcUrl.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAqD,EACrD,UAAkB;IAElB,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,YAAY;QAClC,MAAM,EAAE,CAAC,UAAU,CAAC;KACrB,CAAC,CAAA;AACJ,CAAC"}
@@ -1,4 +1,28 @@
1
1
  import { numberToHex } from '../../utils/encoding/toHex.js';
2
+ /**
3
+ * Writes to a slot of an account's storage.
4
+ *
5
+ * - Docs: https://viem.sh/docs/actions/test/setStorageAt.html
6
+ *
7
+ * @param client - Client to use
8
+ * @param parameters – {@link SetStorageAtParameters}
9
+ *
10
+ * @example
11
+ * import { createTestClient, http } from 'viem'
12
+ * import { foundry } from 'viem/chains'
13
+ * import { setStorageAt } from 'viem/test'
14
+ *
15
+ * const client = createTestClient({
16
+ * mode: 'anvil',
17
+ * chain: 'foundry',
18
+ * transport: http(),
19
+ * })
20
+ * await setStorageAt(client, {
21
+ * address: '0xe846c6fcf817734ca4527b28ccb4aea2b6663c79',
22
+ * index: 2,
23
+ * value: '0x0000000000000000000000000000000000000000000000000000000000000069',
24
+ * })
25
+ */
2
26
  export async function setStorageAt(client, { address, index, value }) {
3
27
  await client.request({
4
28
  method: `${client.mode}_setStorageAt`,
@@ -1 +1 @@
1
- {"version":3,"file":"setStorageAt.js","sourceRoot":"","sources":["../../../../src/actions/test/setStorageAt.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAmC3D,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAqD,EACrD,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAA0B;IAEjD,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,eAAe;QACrC,MAAM,EAAE;YACN,OAAO;YACP,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK;YACtD,KAAK;SACN;KACF,CAAC,CAAA;AACJ,CAAC"}
1
+ {"version":3,"file":"setStorageAt.js","sourceRoot":"","sources":["../../../../src/actions/test/setStorageAt.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAW3D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAqD,EACrD,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAA0B;IAEjD,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,eAAe;QACrC,MAAM,EAAE;YACN,OAAO;YACP,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK;YACtD,KAAK;SACN;KACF,CAAC,CAAA;AACJ,CAAC"}
@@ -1,3 +1,22 @@
1
+ /**
2
+ * Snapshot the state of the blockchain at the current block.
3
+ *
4
+ * - Docs: https://viem.sh/docs/actions/test/snapshot.html
5
+ *
6
+ * @param client - Client to use
7
+ *
8
+ * @example
9
+ * import { createTestClient, http } from 'viem'
10
+ * import { foundry } from 'viem/chains'
11
+ * import { snapshot } from 'viem/test'
12
+ *
13
+ * const client = createTestClient({
14
+ * mode: 'anvil',
15
+ * chain: 'foundry',
16
+ * transport: http(),
17
+ * })
18
+ * await snapshot(client)
19
+ */
1
20
  export async function snapshot(client) {
2
21
  return await client.request({
3
22
  method: 'evm_snapshot',
@@ -1 +1 @@
1
- {"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../../../src/actions/test/snapshot.ts"],"names":[],"mappings":"AA0BA,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAqD;IAErD,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC;QAC1B,MAAM,EAAE,cAAc;KACvB,CAAC,CAAA;AACJ,CAAC"}
1
+ {"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../../../src/actions/test/snapshot.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAqD;IAErD,OAAO,MAAM,MAAM,CAAC,OAAO,CAAC;QAC1B,MAAM,EAAE,cAAc;KACvB,CAAC,CAAA;AACJ,CAAC"}
@@ -1,3 +1,25 @@
1
+ /**
2
+ * Stop impersonating an account after having previously used [`impersonateAccount`](https://viem.sh/docs/actions/test/impersonateAccount.html).
3
+ *
4
+ * - Docs: https://viem.sh/docs/actions/test/stopImpersonatingAccount.html
5
+ *
6
+ * @param client - Client to use
7
+ * @param parameters – {@link StopImpersonatingAccountParameters}
8
+ *
9
+ * @example
10
+ * import { createTestClient, http } from 'viem'
11
+ * import { foundry } from 'viem/chains'
12
+ * import { stopImpersonatingAccount } from 'viem/test'
13
+ *
14
+ * const client = createTestClient({
15
+ * mode: 'anvil',
16
+ * chain: 'foundry',
17
+ * transport: http(),
18
+ * })
19
+ * await stopImpersonatingAccount(client, {
20
+ * address: '0xa5cc3c03994DB5b0d9A5eEdD10CabaB0813678AC',
21
+ * })
22
+ */
1
23
  export async function stopImpersonatingAccount(client, { address }) {
2
24
  await client.request({
3
25
  method: `${client.mode}_stopImpersonatingAccount`,
@@ -1 +1 @@
1
- {"version":3,"file":"stopImpersonatingAccount.js","sourceRoot":"","sources":["../../../../src/actions/test/stopImpersonatingAccount.ts"],"names":[],"mappings":"AAoCA,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAG5C,MAAqD,EACrD,EAAE,OAAO,EAAsC;IAE/C,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,2BAA2B;QACjD,MAAM,EAAE,CAAC,OAAO,CAAC;KAClB,CAAC,CAAA;AACJ,CAAC"}
1
+ {"version":3,"file":"stopImpersonatingAccount.js","sourceRoot":"","sources":["../../../../src/actions/test/stopImpersonatingAccount.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAG5C,MAAqD,EACrD,EAAE,OAAO,EAAsC;IAE/C,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,2BAA2B;QACjD,MAAM,EAAE,CAAC,OAAO,CAAC;KAClB,CAAC,CAAA;AACJ,CAAC"}
@@ -1,4 +1,23 @@
1
1
  import { numberToHex } from '../../utils/encoding/toHex.js';
2
+ /**
3
+ * Adds an EVM chain to the wallet.
4
+ *
5
+ * - Docs: https://viem.sh/docs/actions/wallet/addChain.html
6
+ * - JSON-RPC Methods: [`eth_addEthereumChain`](https://eips.ethereum.org/EIPS/eip-3085)
7
+ *
8
+ * @param client - Client to use
9
+ * @param parameters - {@link AddChainParameters}
10
+ *
11
+ * @example
12
+ * import { createWalletClient, custom } from 'viem'
13
+ * import { optimism } from 'viem/chains'
14
+ * import { addChain } from 'viem/wallet'
15
+ *
16
+ * const client = createWalletClient({
17
+ * transport: custom(window.ethereum),
18
+ * })
19
+ * await addChain(client, { chain: optimism })
20
+ */
2
21
  export async function addChain(client, { chain }) {
3
22
  const { id, name, nativeCurrency, rpcUrls, blockExplorers } = chain;
4
23
  await client.request({
@@ -1 +1 @@
1
- {"version":3,"file":"addChain.js","sourceRoot":"","sources":["../../../../src/actions/wallet/addChain.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AA0B3D,MAAM,CAAC,KAAK,UAAU,QAAQ,CAI5B,MAAiD,EACjD,EAAE,KAAK,EAAsB;IAE7B,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,KAAK,CAAA;IACnE,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,EAAE,yBAAyB;QACjC,MAAM,EAAE;YACN;gBACE,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC;gBACxB,SAAS,EAAE,IAAI;gBACf,cAAc;gBACd,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI;gBAC7B,iBAAiB,EAAE,cAAc;oBAC/B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC;oBACrD,CAAC,CAAC,SAAS;aACd;SACF;KACF,CAAC,CAAA;AACJ,CAAC"}
1
+ {"version":3,"file":"addChain.js","sourceRoot":"","sources":["../../../../src/actions/wallet/addChain.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAO3D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAI5B,MAAiD,EACjD,EAAE,KAAK,EAAsB;IAE7B,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,KAAK,CAAA;IACnE,MAAM,MAAM,CAAC,OAAO,CAAC;QACnB,MAAM,EAAE,yBAAyB;QACjC,MAAM,EAAE;YACN;gBACE,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC;gBACxB,SAAS,EAAE,IAAI;gBACf,cAAc;gBACd,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI;gBAC7B,iBAAiB,EAAE,cAAc;oBAC/B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC;oBACrD,CAAC,CAAC,SAAS;aACd;SACF;KACF,CAAC,CAAA;AACJ,CAAC"}
@@ -1,5 +1,32 @@
1
1
  import { encodeDeployData } from '../../utils/abi/encodeDeployData.js';
2
2
  import { sendTransaction, } from './sendTransaction.js';
3
+ /**
4
+ * Deploys a contract to the network, given bytecode and constructor arguments.
5
+ *
6
+ * - Docs: https://viem.sh/docs/contract/deployContract.html
7
+ * - Examples: https://stackblitz.com/github/wagmi-dev/viem/tree/main/examples/contracts/deploying-contracts
8
+ *
9
+ * @param client - Client to use
10
+ * @param parameters - {@link DeployContractParameters}
11
+ * @returns The [Transaction](https://viem.sh/docs/glossary/terms.html#transaction) hash. {@link DeployContractReturnType}
12
+ *
13
+ * @example
14
+ * import { createWalletClient, http } from 'viem'
15
+ * import { privateKeyToAccount } from 'viem/accounts'
16
+ * import { mainnet } from 'viem/chains'
17
+ * import { deployContract } from 'viem/contract'
18
+ *
19
+ * const client = createWalletClient({
20
+ * account: privateKeyToAccount('0x…'),
21
+ * chain: mainnet,
22
+ * transport: http(),
23
+ * })
24
+ * const hash = await deployContract(client, {
25
+ * abi: [],
26
+ * account: '0x…,
27
+ * bytecode: '0x608060405260405161083e38038061083e833981016040819052610...',
28
+ * })
29
+ */
3
30
  export function deployContract(walletClient, { abi, args, bytecode, ...request }) {
4
31
  const calldata = encodeDeployData({
5
32
  abi,
@@ -1 +1 @@
1
- {"version":3,"file":"deployContract.js","sourceRoot":"","sources":["../../../../src/actions/wallet/deployContract.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAA;AAEtE,OAAO,EAGL,eAAe,GAChB,MAAM,sBAAsB,CAAA;AA6C7B,MAAM,UAAU,cAAc,CAM5B,YAAuD,EACvD,EACE,GAAG,EACH,IAAI,EACJ,QAAQ,EACR,GAAG,OAAO,EACuD;IAEnE,MAAM,QAAQ,GAAG,gBAAgB,CAAC;QAChC,GAAG;QACH,IAAI;QACJ,QAAQ;KAMT,CAAC,CAAA;IACF,OAAO,eAAe,CAAC,YAAY,EAAE;QACnC,GAAG,OAAO;QACV,IAAI,EAAE,QAAQ;KAC2D,CAAC,CAAA;AAC9E,CAAC"}
1
+ {"version":3,"file":"deployContract.js","sourceRoot":"","sources":["../../../../src/actions/wallet/deployContract.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAA;AAEtE,OAAO,EAGL,eAAe,GAChB,MAAM,sBAAsB,CAAA;AAkB7B;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,cAAc,CAM5B,YAAuD,EACvD,EACE,GAAG,EACH,IAAI,EACJ,QAAQ,EACR,GAAG,OAAO,EACuD;IAEnE,MAAM,QAAQ,GAAG,gBAAgB,CAAC;QAChC,GAAG;QACH,IAAI;QACJ,QAAQ;KAMT,CAAC,CAAA;IACF,OAAO,eAAe,CAAC,YAAY,EAAE;QACnC,GAAG,OAAO;QACV,IAAI,EAAE,QAAQ;KAC2D,CAAC,CAAA;AAC9E,CAAC"}
@@ -1,4 +1,24 @@
1
1
  import { checksumAddress } from '../../utils/address/getAddress.js';
2
+ /**
3
+ * Returns a list of account addresses owned by the wallet or client.
4
+ *
5
+ * - Docs: https://viem.sh/docs/actions/wallet/getAddresses.html
6
+ * - JSON-RPC Methods: [`eth_accounts`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_accounts)
7
+ *
8
+ * @param client - Client to use
9
+ * @returns List of account addresses owned by the wallet or client. {@link GetAddressesReturnType}
10
+ *
11
+ * @example
12
+ * import { createWalletClient, custom } from 'viem'
13
+ * import { mainnet } from 'viem/chains'
14
+ * import { getAddresses } from 'viem/wallet'
15
+ *
16
+ * const client = createWalletClient({
17
+ * chain: mainnet,
18
+ * transport: custom(window.ethereum),
19
+ * })
20
+ * const accounts = await getAddresses(client)
21
+ */
2
22
  export async function getAddresses(client) {
3
23
  const addresses = await client.request({ method: 'eth_accounts' });
4
24
  return addresses.map((address) => checksumAddress(address));
@@ -1 +1 @@
1
- {"version":3,"file":"getAddresses.js","sourceRoot":"","sources":["../../../../src/actions/wallet/getAddresses.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAA;AAwBnE,MAAM,CAAC,KAAK,UAAU,YAAY,CAIhC,MAAiD;IAEjD,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAA;IAClE,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAA;AAC7D,CAAC"}
1
+ {"version":3,"file":"getAddresses.js","sourceRoot":"","sources":["../../../../src/actions/wallet/getAddresses.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAA;AAInE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAIhC,MAAiD;IAEjD,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAA;IAClE,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAA;AAC7D,CAAC"}
@@ -1,3 +1,23 @@
1
+ /**
2
+ * Gets the wallets current permissions.
3
+ *
4
+ * - Docs: https://viem.sh/docs/actions/wallet/getPermissions.html
5
+ * - JSON-RPC Methods: [`wallet_getPermissions`](https://eips.ethereum.org/EIPS/eip-2255)
6
+ *
7
+ * @param client - Client to use
8
+ * @returns The wallet permissions. {@link GetPermissionsReturnType}
9
+ *
10
+ * @example
11
+ * import { createWalletClient, custom } from 'viem'
12
+ * import { mainnet } from 'viem/chains'
13
+ * import { getPermissions } from 'viem/wallet'
14
+ *
15
+ * const client = createWalletClient({
16
+ * chain: mainnet,
17
+ * transport: custom(window.ethereum),
18
+ * })
19
+ * const permissions = await getPermissions(client)
20
+ */
1
21
  export async function getPermissions(client) {
2
22
  const permissions = await client.request({ method: 'wallet_getPermissions' });
3
23
  return permissions;
@@ -1 +1 @@
1
- {"version":3,"file":"getPermissions.js","sourceRoot":"","sources":["../../../../src/actions/wallet/getPermissions.ts"],"names":[],"mappings":"AA4BA,MAAM,CAAC,KAAK,UAAU,cAAc,CAGlC,MAAiD;IACjD,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC,CAAA;IAC7E,OAAO,WAAW,CAAA;AACpB,CAAC"}
1
+ {"version":3,"file":"getPermissions.js","sourceRoot":"","sources":["../../../../src/actions/wallet/getPermissions.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAGlC,MAAiD;IACjD,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC,CAAA;IAC7E,OAAO,WAAW,CAAA;AACpB,CAAC"}
@@ -1,4 +1,28 @@
1
1
  import { getAddress } from '../../utils/address/getAddress.js';
2
+ /**
3
+ * Requests a list of accounts managed by a wallet.
4
+ *
5
+ * - Docs: https://viem.sh/docs/actions/wallet/requestAddresses.html
6
+ * - JSON-RPC Methods: [`eth_requestAccounts`](https://eips.ethereum.org/EIPS/eip-1102)
7
+ *
8
+ * Sends a request to the wallet, asking for permission to access the user's accounts. After the user accepts the request, it will return a list of accounts (addresses).
9
+ *
10
+ * This API can be useful for dapps that need to access the user's accounts in order to execute transactions or interact with smart contracts.
11
+ *
12
+ * @param client - Client to use
13
+ * @returns List of accounts managed by a wallet {@link RequestAddressesReturnType}
14
+ *
15
+ * @example
16
+ * import { createWalletClient, custom } from 'viem'
17
+ * import { mainnet } from 'viem/chains'
18
+ * import { requestAddresses } from 'viem/wallet'
19
+ *
20
+ * const client = createWalletClient({
21
+ * chain: mainnet,
22
+ * transport: custom(window.ethereum),
23
+ * })
24
+ * const accounts = await requestAddresses(client)
25
+ */
2
26
  export async function requestAddresses(client) {
3
27
  const addresses = await client.request({ method: 'eth_requestAccounts' });
4
28
  return addresses.map((address) => getAddress(address));
@@ -1 +1 @@
1
- {"version":3,"file":"requestAddresses.js","sourceRoot":"","sources":["../../../../src/actions/wallet/requestAddresses.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AA4B9D,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAIpC,MAAiD;IAEjD,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC,CAAA;IACzE,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAA;AACxD,CAAC"}
1
+ {"version":3,"file":"requestAddresses.js","sourceRoot":"","sources":["../../../../src/actions/wallet/requestAddresses.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AAI9D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAIpC,MAAiD;IAEjD,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC,CAAA;IACzE,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAA;AACxD,CAAC"}