viem 0.4.0-main.20230412T220621 → 0.4.0-main.20230413T040554

package/src/actions/public/estimateContractGas.ts

@@ -31,7 +31,6 @@ export type EstimateContractGasReturnType = bigint
  *
  * - Docs: https://viem.sh/docs/contract/estimateContractGas.html
  *
- * @remarks
  * Internally, uses a [Public Client](https://viem.sh/docs/clients/public) to call the [`estimateGas` action](https://viem.sh/docs/actions/public/estimateGas) with [ABI-encoded `data`](https://viem.sh/docs/contract/encodeFunctionData).
  *
  * @param client - Client to use

package/src/actions/public/getBalance.ts

@@ -26,7 +26,6 @@ export type GetBalanceReturnType = bigint
  * - Docs: https://viem.sh/docs/actions/public/getBalance.html
  * - JSON-RPC Methods: [`eth_getBalance`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getbalance)
  *
- * @remarks
  * You can convert the balance to ether units with [`formatEther`](https://viem.sh/docs/utilities/formatEther.html).
  *
  * ```ts

package/src/actions/public/getFilterChanges.ts

@@ -36,7 +36,6 @@ export type GetFilterChangesReturnType<
  * - Docs: https://viem.sh/docs/actions/public/getFilterChanges.html
  * - JSON-RPC Methods: [`eth_getFilterChanges`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getfilterchanges)
  *
- * @remarks
  * A Filter can be created from the following actions:
  *
  * - [`createBlockFilter`](https://viem.sh/docs/actions/public/createBlockFilter)

package/src/actions/public/getFilterLogs.ts

@@ -29,7 +29,6 @@ export type GetFilterLogsReturnType<
  * - Docs: https://viem.sh/docs/actions/public/getFilterLogs.html
  * - JSON-RPC Methods: [`eth_getFilterLogs`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getfilterlogs)
  *
- * @remarks
  * `getFilterLogs` is only compatible with **event filters**.
  *
  * @param client - Client to use

package/src/actions/public/readContract.ts

@@ -36,7 +36,6 @@ export type ReadContractReturnType<
  * - Docs: https://viem.sh/docs/contract/readContract.html
  * - Examples: https://stackblitz.com/github/wagmi-dev/viem/tree/main/examples/contracts/reading-contracts
  *
- * @remarks
  * A "read-only" function (constant function) on a Solidity contract is denoted by a `view` or `pure` keyword. They can only read the state of the contract, and cannot make any changes to it. Since read-only methods do not change the state of the contract, they do not require any gas to be executed, and can be called by any user without the need to pay for gas.
  *
  * Internally, uses a [Public Client](https://viem.sh/docs/clients/public) to call the [`call` action](https://viem.sh/docs/actions/public/call) with [ABI-encoded `data`](https://viem.sh/docs/contract/encodeFunctionData).
@@ -46,7 +45,7 @@ export type ReadContractReturnType<
  * @returns The response from the contract. Type is inferred. {@link ReadContractReturnType}
  *
  * @example
- * import { createPublicClient, http } from 'viem'
+ * import { createPublicClient, http, parseAbi } from 'viem'
  * import { mainnet } from 'viem/chains'
  * import { readContract } from 'viem/contract'
  *
@@ -54,7 +53,7 @@ export type ReadContractReturnType<
  *   chain: mainnet,
  *   transport: http(),
  * })
- * const results = await readContract(client, {
+ * const result = await readContract(client, {
  *   address: '0xFBA3912Ca04dd458c843e2EE08967fC04f3579c2',
  *   abi: parseAbi(['function balanceOf(address) view returns (uint256)']),
  *   functionName: 'balanceOf',

package/src/actions/public/simulateContract.ts

@@ -63,7 +63,6 @@ export type SimulateContractReturnType<
  * - Docs: https://viem.sh/docs/contract/simulateContract.html
  * - Examples: https://stackblitz.com/github/wagmi-dev/viem/tree/main/examples/contracts/writing-to-contracts
  *
- * @remarks
  * This function does not require gas to execute and _**does not**_ change the state of the blockchain. It is almost identical to [`readContract`](https://viem.sh/docs/contract/readContract), but also supports contract write functions.
  *
  * Internally, uses a [Public Client](https://viem.sh/docs/clients/public) to call the [`call` action](https://viem.sh/docs/actions/public/call) with [ABI-encoded `data`](https://viem.sh/docs/contract/encodeFunctionData).
@@ -81,7 +80,7 @@ export type SimulateContractReturnType<
  *   chain: mainnet,
  *   transport: http(),
  * })
- * const results = await simulateContract(client, {
+ * const result = await simulateContract(client, {
  *   address: '0xFBA3912Ca04dd458c843e2EE08967fC04f3579c2',
  *   abi: parseAbi(['function mint(uint32) view returns (uint32)']),
  *   functionName: 'mint',

package/src/actions/public/uninstallFilter.ts

@@ -12,7 +12,6 @@ export type UninstallFilterReturnType = boolean
  * - Docs: https://viem.sh/docs/actions/public/uninstallFilter.html
  * - JSON-RPC Methods: [`eth_uninstallFilter`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_uninstallFilter)
  *
- * @remarks
  * Destroys a Filter that was created from one of the following Actions:
  * - [`createBlockFilter`](https://viem.sh/docs/actions/public/createBlockFilter)
  * - [`createEventFilter`](https://viem.sh/docs/actions/public/createEventFilter)

package/src/actions/public/waitForTransactionReceipt.ts

@@ -60,7 +60,6 @@ export type WaitForTransactionReceiptParameters<
  *     - Checks if one of the Transactions is a replacement
  *     - If so, calls [`eth_getTransactionReceipt`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getTransactionReceipt).
  *
- * @remarks
  * The `waitForTransactionReceipt` action additionally supports Replacement detection (e.g. sped up Transactions).
  *
  * Transactions can be replaced when a user modifies their transaction in their wallet (to speed up or cancel). Transactions are replaced when they are sent from the same nonce.

package/src/actions/public/watchContractEvent.ts

@@ -59,7 +59,6 @@ export type WatchContractEventReturnType = () => void
  *
  * - Docs: https://viem.sh/docs/contract/watchContractEvent.html
  *
- * @remarks
  * This Action will batch up all the event logs found within the [`pollingInterval`](https://viem.sh/docs/contract/watchContractEvent.html#pollinginterval-optional), and invoke them via [`onLogs`](https://viem.sh/docs/contract/watchContractEvent.html#onLogs).
  *
  * `watchContractEvent` will attempt to create an [Event Filter](https://viem.sh/docs/contract/createContractEventFilter) and listen to changes to the Filter per polling interval, however, if the RPC Provider does not support Filters (e.g. `eth_newFilter`), then `watchContractEvent` will fall back to using [`getLogs`](https://viem.sh/docs/actions/public/getLogs) instead.

package/src/actions/public/watchEvent.ts

@@ -67,7 +67,6 @@ export type WatchEventReturnType = () => void
  *   - **RPC Provider does not support `eth_newFilter`:**
  *     - Calls [`eth_getLogs`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getlogs) for each block between the polling interval.
  *
- * @remarks
  * This Action will batch up all the Event Logs found within the [`pollingInterval`](https://viem.sh/docs/actions/public/watchEvent.html#pollinginterval-optional), and invoke them via [`onLogs`](https://viem.sh/docs/actions/public/watchEvent.html#onLogs).
  *
  * `watchEvent` will attempt to create an [Event Filter](https://viem.sh/docs/actions/public/createEventFilter.html) and listen to changes to the Filter per polling interval, however, if the RPC Provider does not support Filters (e.g. `eth_newFilter`), then `watchEvent` will fall back to using [`getLogs`](https://viem.sh/docs/actions/public/getLogs) instead.

package/src/actions/public/watchPendingTransactions.ts

@@ -68,7 +68,6 @@ export type WatchPendingTransactionsReturnType = () => void
  *     - Calls [`eth_getFilterChanges`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_getFilterChanges) on a polling interval.
  *   - When `poll: false` & WebSocket Transport, uses a WebSocket subscription via [`eth_subscribe`](https://docs.alchemy.com/reference/eth-subscribe-polygon) and the `"newPendingTransactions"` event.
  *
- * @remarks
  * This Action will batch up all the pending transactions found within the [`pollingInterval`](https://viem.sh/docs/actions/public/watchPendingTransactions.html#pollinginterval-optional), and invoke them via [`onTransactions`](https://viem.sh/docs/actions/public/watchPendingTransactions.html#ontransactions).
  *
  * @param client - Client to use

package/src/actions/test/dropTransaction.ts

@@ -10,6 +10,28 @@ export type DropTransactionParameters = {
   hash: Hash
 }
 
+/**
+ * Removes a transaction from the mempool.
+ *
+ * - Docs: https://viem.sh/docs/actions/test/dropTransaction.html
+ *
+ * @param client - Client to use
+ * @param parameters - {@link DropTransactionParameters}
+ *
+ * @example
+ * import { createTestClient, http } from 'viem'
+ * import { foundry } from 'viem/chains'
+ * import { dropTransaction } from 'viem/test'
+ *
+ * const client = createTestClient({
+ *   mode: 'anvil',
+ *   chain: 'foundry',
+ *   transport: http(),
+ * })
+ * await dropTransaction(client, {
+ *   hash: '0xe58dceb6b20b03965bb678e27d141e151d7d4efc2334c2d6a49b9fac523f7364'
+ * })
+ */
 export async function dropTransaction<TChain extends Chain | undefined>(
   client: TestClient<TestClientMode, Transport, TChain>,
   { hash }: DropTransactionParameters,

package/src/actions/test/getAutomine.ts

@@ -7,6 +7,26 @@ import type { Chain } from '../../types/index.js'
 
 export type GetAutomineReturnType = boolean
 
+/**
+ * Returns the automatic mining status of the node.
+ *
+ * - Docs: https://viem.sh/docs/actions/test/getAutomine.html
+ *
+ * @param client - Client to use
+ * @returns Whether or not the node is auto mining. {@link GetAutomineReturnType}
+ *
+ * @example
+ * import { createTestClient, http } from 'viem'
+ * import { foundry } from 'viem/chains'
+ * import { getAutomine } from 'viem/test'
+ *
+ * const client = createTestClient({
+ *   mode: 'anvil',
+ *   chain: 'foundry',
+ *   transport: http(),
+ * })
+ * const isAutomining = await getAutomine(client)
+ */
 export async function getAutomine<TChain extends Chain | undefined>(
   client: TestClient<TestClientMode, Transport, TChain>,
 ): Promise<GetAutomineReturnType> {

package/src/actions/test/getTxpoolContent.ts

@@ -7,10 +7,32 @@ import type {
 import type { Chain, RpcTransaction } from '../../types/index.js'
 
 export type GetTxpoolContentReturnType = {
+  /** Pending transactions in the pool */
   pending: Record<Address, Record<string, RpcTransaction>>
+  /** Queued transactions in the pool */
   queued: Record<Address, Record<string, RpcTransaction>>
 }
 
+/**
+ * Returns the details of all transactions currently pending for inclusion in the next block(s), as well as the ones that are being scheduled for future execution only.
+ *
+ * - Docs: https://viem.sh/docs/actions/test/getTxpoolContent.html
+ *
+ * @param client - Client to use
+ * @returns Transaction pool content. {@link GetTxpoolContentReturnType}
+ *
+ * @example
+ * import { createTestClient, http } from 'viem'
+ * import { foundry } from 'viem/chains'
+ * import { getTxpoolContent } from 'viem/test'
+ *
+ * const client = createTestClient({
+ *   mode: 'anvil',
+ *   chain: 'foundry',
+ *   transport: http(),
+ * })
+ * const content = await getTxpoolContent(client)
+ */
 export async function getTxpoolContent<TChain extends Chain | undefined>(
   client: TestClient<TestClientMode, Transport, TChain>,
 ): Promise<GetTxpoolContentReturnType> {

package/src/actions/test/getTxpoolStatus.ts

@@ -11,6 +11,26 @@ export type GetTxpoolStatusReturnType = {
   queued: number
 }
 
+/**
+ * Returns a summary of all the transactions currently pending for inclusion in the next block(s), as well as the ones that are being scheduled for future execution only.
+ *
+ * - Docs: https://viem.sh/docs/actions/test/getTxpoolStatus.html
+ *
+ * @param client - Client to use
+ * @returns Transaction pool status. {@link GetTxpoolStatusReturnType}
+ *
+ * @example
+ * import { createTestClient, http } from 'viem'
+ * import { foundry } from 'viem/chains'
+ * import { getTxpoolStatus } from 'viem/test'
+ *
+ * const client = createTestClient({
+ *   mode: 'anvil',
+ *   chain: 'foundry',
+ *   transport: http(),
+ * })
+ * const status = await getTxpoolStatus(client)
+ */
 export async function getTxpoolStatus<TChain extends Chain | undefined>(
   client: TestClient<TestClientMode, Transport, TChain>,
 ): Promise<GetTxpoolStatusReturnType> {

package/src/actions/test/impersonateAccount.ts

@@ -10,6 +10,28 @@ export type ImpersonateAccountParameters = {
   address: Address
 }
 
+/**
+ * Impersonate an account or contract address. This lets you send transactions from that account even if you don't have access to its private key.
+ *
+ * - Docs: https://viem.sh/docs/actions/test/impersonateAccount.html
+ *
+ * @param client - Client to use
+ * @param parameters - {@link ImpersonateAccountParameters}
+ *
+ * @example
+ * import { createTestClient, http } from 'viem'
+ * import { foundry } from 'viem/chains'
+ * import { impersonateAccount } from 'viem/test'
+ *
+ * const client = createTestClient({
+ *   mode: 'anvil',
+ *   chain: 'foundry',
+ *   transport: http(),
+ * })
+ * const content = await impersonateAccount(client, {
+ *   address: '0xA0Cf798816D4b9b9866b5330EEa46a18382f251e',
+ * })
+ */
 export async function impersonateAccount<TChain extends Chain | undefined>(
   client: TestClient<TestClientMode, Transport, TChain>,
   { address }: ImpersonateAccountParameters,

package/src/actions/test/increaseTime.ts

@@ -11,6 +11,28 @@ export type IncreaseTimeParameters = {
   seconds: number
 }
 
+/**
+ * Jump forward in time by the given amount of time, in seconds.
+ *
+ * - Docs: https://viem.sh/docs/actions/test/increaseTime.html
+ *
+ * @param client - Client to use
+ * @param parameters – {@link IncreaseTimeParameters}
+ *
+ * @example
+ * import { createTestClient, http } from 'viem'
+ * import { foundry } from 'viem/chains'
+ * import { increaseTime } from 'viem/test'
+ *
+ * const client = createTestClient({
+ *   mode: 'anvil',
+ *   chain: 'foundry',
+ *   transport: http(),
+ * })
+ * await increaseTime(client, {
+ *   seconds: 420,
+ * })
+ */
 export async function increaseTime<TChain extends Chain | undefined>(
   client: TestClient<TestClientMode, Transport, TChain>,
   { seconds }: IncreaseTimeParameters,

package/src/actions/test/inspectTxpool.ts

@@ -10,6 +10,26 @@ export type InspectTxpoolReturnType = {
   queued: Record<Address, Record<string, string>>
 }
 
+/**
+ * Returns a summary of all the transactions currently pending for inclusion in the next block(s), as well as the ones that are being scheduled for future execution only.
+ *
+ * - Docs: https://viem.sh/docs/actions/test/inspectTxpool.html
+ *
+ * @param client - Client to use
+ * @returns Transaction pool inspection data. {@link InspectTxpoolReturnType}
+ *
+ * @example
+ * import { createTestClient, http } from 'viem'
+ * import { foundry } from 'viem/chains'
+ * import { inspectTxpool } from 'viem/test'
+ *
+ * const client = createTestClient({
+ *   mode: 'anvil',
+ *   chain: 'foundry',
+ *   transport: http(),
+ * })
+ * const data = await inspectTxpool(client)
+ */
 export async function inspectTxpool<TChain extends Chain | undefined>(
   client: TestClient<TestClientMode, Transport, TChain>,
 ): Promise<InspectTxpoolReturnType> {

package/src/actions/test/mine.ts

@@ -13,6 +13,26 @@ export type MineParameters = {
   interval?: number
 }
 
+/**
+ * Mine a specified number of blocks.
+ *
+ * - Docs: https://viem.sh/docs/actions/test/mine.html
+ *
+ * @param client - Client to use
+ * @param parameters – {@link MineParameters}
+ *
+ * @example
+ * import { createTestClient, http } from 'viem'
+ * import { foundry } from 'viem/chains'
+ * import { mine } from 'viem/test'
+ *
+ * const client = createTestClient({
+ *   mode: 'anvil',
+ *   chain: 'foundry',
+ *   transport: http(),
+ * })
+ * await mine(client, { blocks: 1 })
+ */
 export async function mine<TChain extends Chain | undefined>(
   client: TestClient<TestClientMode, Transport, TChain>,
   { blocks, interval }: MineParameters,

package/src/actions/test/removeBlockTimestampInterval.ts

@@ -5,6 +5,25 @@ import type {
   Transport,
 } from '../../clients/index.js'
 
+/**
+ * Removes [`setBlockTimestampInterval`](https://viem.sh/docs/actions/test/setBlockTimestampInterval.html) if it exists.
+ *
+ * - Docs: https://viem.sh/docs/actions/test/removeBlockTimestampInterval.html
+ *
+ * @param client - Client to use
+ *
+ * @example
+ * import { createTestClient, http } from 'viem'
+ * import { foundry } from 'viem/chains'
+ * import { removeBlockTimestampInterval } from 'viem/test'
+ *
+ * const client = createTestClient({
+ *   mode: 'anvil',
+ *   chain: 'foundry',
+ *   transport: http(),
+ * })
+ * await removeBlockTimestampInterval(client)
+ */
 export async function removeBlockTimestampInterval<
   TChain extends Chain | undefined,
 >(client: TestClient<TestClientMode, Transport, TChain>) {

package/src/actions/test/reset.ts

@@ -12,6 +12,26 @@ export type ResetParameters = {
   jsonRpcUrl?: string
 }
 
+/**
+ * Resets fork back to its original state.
+ *
+ * - Docs: https://viem.sh/docs/actions/test/reset.html
+ *
+ * @param client - Client to use
+ * @param parameters – {@link ResetParameters}
+ *
+ * @example
+ * import { createTestClient, http } from 'viem'
+ * import { foundry } from 'viem/chains'
+ * import { reset } from 'viem/test'
+ *
+ * const client = createTestClient({
+ *   mode: 'anvil',
+ *   chain: 'foundry',
+ *   transport: http(),
+ * })
+ * await reset(client, { blockNumber: 69420n })
+ */
 export async function reset<TChain extends Chain | undefined>(
   client: TestClient<TestClientMode, Transport, TChain>,
   { blockNumber, jsonRpcUrl }: ResetParameters = {},

package/src/actions/test/revert.ts

@@ -10,6 +10,26 @@ export type RevertParameters = {
   id: Quantity
 }
 
+/**
+ * Revert the state of the blockchain at the current block.
+ *
+ * - Docs: https://viem.sh/docs/actions/test/revert.html
+ *
+ * @param client - Client to use
+ * @param parameters – {@link RevertParameters}
+ *
+ * @example
+ * import { createTestClient, http } from 'viem'
+ * import { foundry } from 'viem/chains'
+ * import { revert } from 'viem/test'
+ *
+ * const client = createTestClient({
+ *   mode: 'anvil',
+ *   chain: 'foundry',
+ *   transport: http(),
+ * })
+ * await revert(client, { id: '0x…' })
+ */
 export async function revert<TChain extends Chain | undefined>(
   client: TestClient<TestClientMode, Transport, TChain>,
   { id }: RevertParameters,

package/src/actions/test/sendUnsignedTransaction.ts

@@ -10,6 +10,31 @@ export type SendUnsignedTransactionParameters = TransactionRequest
 
 export type SendUnsignedTransactionReturnType = Hash
 
+/**
+ * Returns the details of all transactions currently pending for inclusion in the next block(s), as well as the ones that are being scheduled for future execution only.
+ *
+ * - Docs: https://viem.sh/docs/actions/test/getTxpoolContent.html
+ *
+ * @param client - Client to use
+ * @param parameters – {@link SendUnsignedTransactionParameters}
+ * @returns The transaction hash. {@link SendUnsignedTransactionReturnType}
+ *
+ * @example
+ * import { createTestClient, http } from 'viem'
+ * import { foundry } from 'viem/chains'
+ * import { sendUnsignedTransaction } from 'viem/test'
+ *
+ * const client = createTestClient({
+ *   mode: 'anvil',
+ *   chain: 'foundry',
+ *   transport: http(),
+ * })
+ * const hash = await sendUnsignedTransaction(client, {
+ *   from: '0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266',
+ *   to: '0x70997970c51812dc3a010c7d01b50e0d17dc79c8',
+ *   value: 1000000000000000000n,
+ * })
+ */
 export async function sendUnsignedTransaction<
   TChain extends Chain | undefined,
 >(

package/src/actions/test/setAutomine.ts

@@ -5,6 +5,25 @@ import type {
 } from '../../clients/index.js'
 import type { Chain } from '../../types/index.js'
 
+/**
+ * Enables or disables the automatic mining of new blocks with each new transaction submitted to the network.
+ *
+ * - Docs: https://viem.sh/docs/actions/test/setAutomine.html
+ *
+ * @param client - Client to use
+ *
+ * @example
+ * import { createTestClient, http } from 'viem'
+ * import { foundry } from 'viem/chains'
+ * import { setAutomine } from 'viem/test'
+ *
+ * const client = createTestClient({
+ *   mode: 'anvil',
+ *   chain: 'foundry',
+ *   transport: http(),
+ * })
+ * await setAutomine(client)
+ */
 export async function setAutomine<TChain extends Chain | undefined>(
   client: TestClient<TestClientMode, Transport, TChain>,
   enabled: boolean,

package/src/actions/test/setBalance.ts

@@ -13,6 +13,29 @@ export type SetBalanceParameters = {
   value: bigint
 }
 
+/**
+ * Modifies the balance of an account.
+ *
+ * - Docs: https://viem.sh/docs/actions/test/setBalance.html
+ *
+ * @param client - Client to use
+ * @param parameters – {@link SetBalanceParameters}
+ *
+ * @example
+ * import { createTestClient, http, parseEther } from 'viem'
+ * import { foundry } from 'viem/chains'
+ * import { setBalance } from 'viem/test'
+ *
+ * const client = createTestClient({
+ *   mode: 'anvil',
+ *   chain: 'foundry',
+ *   transport: http(),
+ * })
+ * await setBalance(client, {
+ *   address: '0xa5cc3c03994DB5b0d9A5eEdD10CabaB0813678AC',
+ *   value: parseEther('1'),
+ * })
+ */
 export async function setBalance<TChain extends Chain | undefined>(
   client: TestClient<TestClientMode, Transport, TChain>,
   { address, value }: SetBalanceParameters,

package/src/actions/test/setBlockGasLimit.ts

@@ -11,6 +11,26 @@ export type SetBlockGasLimitParameters = {
   gasLimit: bigint
 }
 
+/**
+ * Sets the block's gas limit.
+ *
+ * - Docs: https://viem.sh/docs/actions/test/setBlockGasLimit.html
+ *
+ * @param client - Client to use
+ * @param parameters – {@link SetBlockGasLimitParameters}
+ *
+ * @example
+ * import { createTestClient, http } from 'viem'
+ * import { foundry } from 'viem/chains'
+ * import { setBlockGasLimit } from 'viem/test'
+ *
+ * const client = createTestClient({
+ *   mode: 'anvil',
+ *   chain: 'foundry',
+ *   transport: http(),
+ * })
+ * await setBlockGasLimit(client, { gasLimit: 420_000n })
+ */
 export async function setBlockGasLimit<TChain extends Chain | undefined>(
   client: TestClient<TestClientMode, Transport, TChain>,
   { gasLimit }: SetBlockGasLimitParameters,

package/src/actions/test/setBlockTimestampInterval.ts

@@ -10,6 +10,26 @@ export type SetBlockTimestampIntervalParameters = {
   interval: number
 }
 
+/**
+ * Similar to [`increaseTime`](https://viem.sh/docs/actions/test/increaseTime), but sets a block timestamp `interval`. The timestamp of future blocks will be computed as `lastBlock_timestamp` + `interval`.
+ *
+ * - Docs: https://viem.sh/docs/actions/test/setBlockTimestampInterval.html
+ *
+ * @param client - Client to use
+ * @param parameters – {@link SetBlockTimestampIntervalParameters}
+ *
+ * @example
+ * import { createTestClient, http } from 'viem'
+ * import { foundry } from 'viem/chains'
+ * import { setBlockTimestampInterval } from 'viem/test'
+ *
+ * const client = createTestClient({
+ *   mode: 'anvil',
+ *   chain: 'foundry',
+ *   transport: http(),
+ * })
+ * await setBlockTimestampInterval(client, { interval: 5 })
+ */
 export async function setBlockTimestampInterval<
   TChain extends Chain | undefined,
 >(

package/src/actions/test/setCode.ts

@@ -12,6 +12,29 @@ export type SetCodeParameters = {
   bytecode: Hex
 }
 
+/**
+ * Modifies the bytecode stored at an account's address.
+ *
+ * - Docs: https://viem.sh/docs/actions/test/setCode.html
+ *
+ * @param client - Client to use
+ * @param parameters – {@link SetCodeParameters}
+ *
+ * @example
+ * import { createTestClient, http } from 'viem'
+ * import { foundry } from 'viem/chains'
+ * import { setCode } from 'viem/test'
+ *
+ * const client = createTestClient({
+ *   mode: 'anvil',
+ *   chain: 'foundry',
+ *   transport: http(),
+ * })
+ * await setCode(client, {
+ *   address: '0xe846c6fcf817734ca4527b28ccb4aea2b6663c79',
+ *   bytecode: '0x60806040526000600355600019600955600c80546001600160a01b031916737a250d5630b4cf539739df…',
+ * })
+ */
 export async function setCode<TChain extends Chain | undefined>(
   client: TestClient<TestClientMode, Transport, TChain>,
   { address, bytecode }: SetCodeParameters,

package/src/actions/test/setCoinbase.ts

@@ -10,6 +10,28 @@ export type SetCoinbaseParameters = {
   address: Address
 }
 
+/**
+ * Sets the coinbase address to be used in new blocks.
+ *
+ * - Docs: https://viem.sh/docs/actions/test/setCoinbase.html
+ *
+ * @param client - Client to use
+ * @param parameters – {@link SetCoinbaseParameters}
+ *
+ * @example
+ * import { createTestClient, http } from 'viem'
+ * import { foundry } from 'viem/chains'
+ * import { setCoinbase } from 'viem/test'
+ *
+ * const client = createTestClient({
+ *   mode: 'anvil',
+ *   chain: 'foundry',
+ *   transport: http(),
+ * })
+ * await setCoinbase(client, {
+ *   address: '0xe846c6fcf817734ca4527b28ccb4aea2b6663c79',
+ * })
+ */
 export async function setCoinbase<TChain extends Chain | undefined>(
   client: TestClient<TestClientMode, Transport, TChain>,
   { address }: SetCoinbaseParameters,