viem 0.0.0-portable-types-20230518183529 → 0.0.0-portable-types-20230523145621

package/src/actions/public/waitForTransactionReceipt.ts

@@ -9,6 +9,8 @@ import type { Chain } from '../../types/chain.js'
 import type { Hash } from '../../types/misc.js'
 import type { Transaction } from '../../types/transaction.js'
 import { observe } from '../../utils/observe.js'
+import { withRetry } from '../../utils/promise/withRetry.js'
+import { stringify } from '../../utils/stringify.js'
 
 import { getBlock } from './getBlock.js'
 import {
@@ -106,16 +108,12 @@ export async function waitForTransactionReceipt<
     timeout,
   }: WaitForTransactionReceiptParameters<TChain>,
 ): Promise<WaitForTransactionReceiptReturnType<TChain>> {
-  const observerId = JSON.stringify([
-    'waitForTransactionReceipt',
-    client.uid,
-    hash,
-  ])
+  const observerId = stringify(['waitForTransactionReceipt', client.uid, hash])
 
   let transaction: GetTransactionReturnType<TChain> | undefined
   let replacedTransaction: GetTransactionReturnType<TChain> | undefined
   let receipt: GetTransactionReceiptReturnType<TChain>
-  let retries = 0
+  let retrying = false
 
   return new Promise((resolve, reject) => {
     if (timeout)
@@ -133,7 +131,11 @@ export async function waitForTransactionReceipt<
           emitOnBegin: true,
           poll: true,
           pollingInterval,
-          async onBlockNumber(blockNumber) {
+          async onBlockNumber(blockNumber_) {
+            if (retrying) return
+
+            let blockNumber = blockNumber_
+
             const done = async (fn: () => void) => {
               unwatch()
               fn()
@@ -152,13 +154,34 @@ export async function waitForTransactionReceipt<
               }
 
               // Get the transaction to check if it's been replaced.
-              transaction = await getTransaction(client, { hash })
+              // We need to retry as some RPC Providers may be slow to sync
+              // up mined transactions.
+              if (!transaction) {
+                retrying = true
+                await withRetry(
+                  async () => {
+                    transaction = await getTransaction(client, { hash })
+                    if (transaction.blockNumber)
+                      blockNumber = transaction.blockNumber
+                  },
+                  {
+                    // exponential backoff
+                    delay: ({ count }) => ~~(1 << count) * 200,
+                    retryCount: 6,
+                  },
+                )
+                retrying = false
+              }
 
               // Get the receipt to check if it's been processed.
               receipt = await getTransactionReceipt(client, { hash })
 
               // Check if we have enough confirmations. If not, continue polling.
-              if (blockNumber - receipt.blockNumber + 1n < confirmations) return
+              if (
+                confirmations > 0 &&
+                blockNumber - receipt.blockNumber + 1n < confirmations
+              )
+                return
 
               done(() => emit.resolve(receipt))
             } catch (err) {
@@ -220,8 +243,7 @@ export async function waitForTransactionReceipt<
                   emit.resolve(receipt)
                 })
               } else {
-                if (retries > 2) done(() => emit.reject(err))
-                retries++
+                done(() => emit.reject(err))
               }
             }
           },

package/src/actions/public/watchBlockNumber.ts

@@ -5,6 +5,7 @@ import type { GetTransportConfig } from '../../types/transport.js'
 import { hexToBigInt } from '../../utils/encoding/fromHex.js'
 import { observe } from '../../utils/observe.js'
 import { poll } from '../../utils/poll.js'
+import { stringify } from '../../utils/stringify.js'
 
 import {
   type GetBlockNumberReturnType,
@@ -92,7 +93,7 @@ export function watchBlockNumber<
   let prevBlockNumber: GetBlockNumberReturnType | undefined
 
   const pollBlockNumber = () => {
-    const observerId = JSON.stringify([
+    const observerId = stringify([
       'watchBlockNumber',
       client.uid,
       emitOnBegin,

package/src/actions/public/watchBlocks.ts

@@ -5,6 +5,7 @@ import type { Chain } from '../../types/chain.js'
 import type { GetTransportConfig } from '../../types/transport.js'
 import { observe } from '../../utils/observe.js'
 import { poll } from '../../utils/poll.js'
+import { stringify } from '../../utils/stringify.js'
 
 import { type GetBlockReturnType, getBlock } from './getBlock.js'
 
@@ -100,7 +101,7 @@ export function watchBlocks<
   let prevBlock: GetBlockReturnType<TChain> | undefined
 
   const pollBlocks = () => {
-    const observerId = JSON.stringify([
+    const observerId = stringify([
       'watchBlocks',
       client.uid,
       emitMissed,

package/src/actions/public/watchContractEvent.ts

@@ -12,6 +12,7 @@ import {
 } from '../../utils/abi/getAbiItem.js'
 import { observe } from '../../utils/observe.js'
 import { poll } from '../../utils/poll.js'
+import { stringify } from '../../utils/stringify.js'
 
 import {
   type CreateContractEventFilterParameters,
@@ -63,7 +64,7 @@ export type WatchContractEventReturnType = () => void
  *
  * 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.
+ * `watchContractEvent` will attempt to create an [Event Filter](https://viem.sh/docs/contract/createContractEventFilter.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 `watchContractEvent` will fall back to using [`getLogs`](https://viem.sh/docs/actions/public/getLogs) instead.
  *
  * @param client - Client to use
  * @param parameters - {@link WatchContractEventParameters}
@@ -103,7 +104,7 @@ export function watchContractEvent<
     pollingInterval = client.pollingInterval,
   }: WatchContractEventParameters<TAbi, TEventName>,
 ): WatchContractEventReturnType {
-  const observerId = JSON.stringify([
+  const observerId = stringify([
     'watchContractEvent',
     address,
     args,

package/src/actions/public/watchEvent.ts

@@ -11,6 +11,7 @@ import type { Filter } from '../../types/filter.js'
 import type { Log } from '../../types/log.js'
 import { observe } from '../../utils/observe.js'
 import { poll } from '../../utils/poll.js'
+import { stringify } from '../../utils/stringify.js'
 
 import {
   type CreateEventFilterParameters,
@@ -61,7 +62,7 @@ export type WatchEventParameters<
 export type WatchEventReturnType = () => void
 
 /**
- * Watches and returns emitted [Event Logs](https://viem.sh/docs/glossary/terms#event-log).
+ * Watches and returns emitted [Event Logs](https://viem.sh/docs/glossary/terms.html#event-log).
  *
  * - Docs: https://viem.sh/docs/actions/public/watchEvent.html
  * - JSON-RPC Methods:
@@ -73,7 +74,7 @@ export type WatchEventReturnType = () => void
  *
  * 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.
+ * `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.html) instead.
  *
  * @param client - Client to use
  * @param parameters - {@link WatchEventParameters}
@@ -108,7 +109,7 @@ export function watchEvent<
     pollingInterval = client.pollingInterval,
   }: WatchEventParameters<TAbiEvent>,
 ): WatchEventReturnType {
-  const observerId = JSON.stringify([
+  const observerId = stringify([
     'watchEvent',
     address,
     args,

package/src/actions/public/watchPendingTransactions.ts

@@ -6,6 +6,7 @@ import type { Hash } from '../../types/misc.js'
 import type { GetTransportConfig } from '../../types/transport.js'
 import { observe } from '../../utils/observe.js'
 import { poll } from '../../utils/poll.js'
+import { stringify } from '../../utils/stringify.js'
 
 import { createPendingTransactionFilter } from './createPendingTransactionFilter.js'
 import { getFilterChanges } from './getFilterChanges.js'
@@ -104,7 +105,7 @@ export function watchPendingTransactions<
     typeof poll_ !== 'undefined' ? poll_ : client.transport.type !== 'webSocket'
 
   const pollPendingTransactions = () => {
-    const observerId = JSON.stringify([
+    const observerId = stringify([
       'watchPendingTransactions',
       client.uid,
       batch,

package/src/actions/test/setBlockTimestampInterval.ts

@@ -11,7 +11,7 @@ export type SetBlockTimestampIntervalParameters = {
 }
 
 /**
- * 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`.
+ * 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`.
  *
  * - Docs: https://viem.sh/docs/actions/test/setBlockTimestampInterval.html
  *

package/src/actions/test/stopImpersonatingAccount.ts

@@ -13,7 +13,7 @@ export type StopImpersonatingAccountParameters = {
 }
 
 /**
- * Stop impersonating an account after having previously used [`impersonateAccount`](https://viem.sh/docs/actions/test/impersonateAccount).
+ * Stop impersonating an account after having previously used [`impersonateAccount`](https://viem.sh/docs/actions/test/impersonateAccount.html).
  *
  * - Docs: https://viem.sh/docs/actions/test/stopImpersonatingAccount.html
  *

package/src/actions/wallet/deployContract.ts

@@ -38,7 +38,7 @@ export type DeployContractReturnType = SendTransactionReturnType
  *
  * @param client - Client to use
  * @param parameters - {@link DeployContractParameters}
- * @returns The [Transaction](https://viem.sh/docs/glossary/terms#transaction) hash. {@link DeployContractReturnType}
+ * @returns The [Transaction](https://viem.sh/docs/glossary/terms.html#transaction) hash. {@link DeployContractReturnType}
  *
  * @example
  * import { createWalletClient, http } from 'viem'

package/src/actions/wallet/signMessage.ts

@@ -25,8 +25,8 @@ export type SignMessageReturnType = Hex
  *   - Local Accounts: Signs locally. No JSON-RPC request.
  *
  * With the calculated signature, you can:
- * - use [`verifyMessage`](https://viem.sh/docs/utilities/verifyMessage) to verify the signature,
- * - use [`recoverMessageAddress`](https://viem.sh/docs/utilities/recoverMessageAddress) to recover the signing address from a signature.
+ * - use [`verifyMessage`](https://viem.sh/docs/utilities/verifyMessage.html) to verify the signature,
+ * - use [`recoverMessageAddress`](https://viem.sh/docs/utilities/recoverMessageAddress.html) to recover the signing address from a signature.
  *
  * @param client - Client to use
  * @param parameters - {@link SignMessageParameters}

package/src/actions/wallet/writeContract.ts

@@ -42,15 +42,15 @@ export type WriteContractReturnType = SendTransactionReturnType
  * - Docs: https://viem.sh/docs/contract/writeContract.html
  * - Examples: https://stackblitz.com/github/wagmi-dev/viem/tree/main/examples/contracts/writing-to-contracts
  *
- * A "write" function on a Solidity contract modifies the state of the blockchain. These types of functions require gas to be executed, and hence a [Transaction](https://viem.sh/docs/glossary/terms) is needed to be broadcast in order to change the state.
+ * A "write" function on a Solidity contract modifies the state of the blockchain. These types of functions require gas to be executed, and hence a [Transaction](https://viem.sh/docs/glossary/terms.html) is needed to be broadcast in order to change the state.
  *
- * Internally, uses a [Wallet Client](https://viem.sh/docs/clients/wallet) to call the [`sendTransaction` action](https://viem.sh/docs/actions/wallet/sendTransaction) with [ABI-encoded `data`](https://viem.sh/docs/contract/encodeFunctionData).
+ * Internally, uses a [Wallet Client](https://viem.sh/docs/clients/wallet.html) to call the [`sendTransaction` action](https://viem.sh/docs/actions/wallet/sendTransaction.html) with [ABI-encoded `data`](https://viem.sh/docs/contract/encodeFunctionData.html).
  *
  * __Warning: The `write` internally sends a transaction – it does not validate if the contract write will succeed (the contract may throw an error). It is highly recommended to [simulate the contract write with `contract.simulate`](https://viem.sh/docs/contract/writeContract.html#usage) before you execute it.__
  *
  * @param client - Client to use
  * @param parameters - {@link WriteContractParameters}
- * @returns A [Transaction Hash](https://viem.sh/docs/glossary/terms#hash). {@link WriteContractReturnType}
+ * @returns A [Transaction Hash](https://viem.sh/docs/glossary/terms.html#hash). {@link WriteContractReturnType}
  *
  * @example
  * import { createWalletClient, custom, parseAbi } from 'viem'

package/src/clients/createPublicClient.ts

@@ -38,7 +38,7 @@ export type PublicClient<
 >
 
 /**
- * Creates a Public Client with a given [Transport](https://viem.sh/docs/clients/intro) configured for a [Chain](https://viem.sh/docs/clients/chains).
+ * Creates a Public Client with a given [Transport](https://viem.sh/docs/clients/intro.html) configured for a [Chain](https://viem.sh/docs/clients/chains.html).
  *
  * - Docs: https://viem.sh/docs/clients/public.html
  *

package/src/clients/createTestClient.ts

@@ -5,7 +5,7 @@ import { type Client, type ClientConfig, createClient } from './createClient.js'
 import { type TestActions, testActions } from './decorators/test.js'
 import type { Transport } from './transports/createTransport.js'
 
-export type TestClientMode = 'anvil' | 'hardhat'
+export type TestClientMode = 'anvil' | 'hardhat' | 'ganache'
 
 export type TestClientConfig<
   TMode extends TestClientMode = TestClientMode,
@@ -15,7 +15,7 @@ export type TestClientConfig<
   ClientConfig<TTransport, TChain>,
   'chain' | 'key' | 'name' | 'pollingInterval' | 'transport'
 > & {
-  /** Mode of the test client. Available: "anvil" | "hardhat" */
+  /** Mode of the test client. Available: "anvil" | "hardhat" | "ganache" */
   mode: TMode
 }
 
@@ -33,11 +33,11 @@ export type TestClient<
  * @description Creates a test client with a given transport.
  */
 /**
- * Creates a Test Client with a given [Transport](https://viem.sh/docs/clients/intro) configured for a [Chain](https://viem.sh/docs/clients/chains).
+ * Creates a Test Client with a given [Transport](https://viem.sh/docs/clients/intro.html) configured for a [Chain](https://viem.sh/docs/clients/chains.html).
  *
  * - Docs: https://viem.sh/docs/clients/test.html
  *
- * A Test Client is an interface to "test" JSON-RPC API methods accessible through a local Ethereum test node such as [Anvil](https://book.getfoundry.sh/anvil/) or [Hardhat](https://hardhat.org/) such as mining blocks, impersonating accounts, setting fees, etc through [Test Actions](https://viem.sh/docs/actions/test/introduction).
+ * A Test Client is an interface to "test" JSON-RPC API methods accessible through a local Ethereum test node such as [Anvil](https://book.getfoundry.sh/anvil/) or [Hardhat](https://hardhat.org/) such as mining blocks, impersonating accounts, setting fees, etc through [Test Actions](https://viem.sh/docs/actions/test/introduction.html).
  *
  * @param config - {@link TestClientConfig}
  * @returns A Test Client. {@link TestClient}

package/src/clients/createWalletClient.ts

@@ -41,11 +41,11 @@ export type WalletClient<
 >
 
 /**
- * Creates a Wallet Client with a given [Transport](https://viem.sh/docs/clients/intro) configured for a [Chain](https://viem.sh/docs/clients/chains).
+ * Creates a Wallet Client with a given [Transport](https://viem.sh/docs/clients/intro.html) configured for a [Chain](https://viem.sh/docs/clients/chains.html).
  *
  * - Docs: https://viem.sh/docs/clients/wallet.html
  *
- * A Wallet Client is an interface to interact with [Ethereum Account(s)](https://ethereum.org/en/glossary/#account) and provides the ability to retrieve accounts, execute transactions, sign messages, etc. through [Wallet Actions](https://viem.sh/docs/actions/wallet/introduction).
+ * A Wallet Client is an interface to interact with [Ethereum Account(s)](https://ethereum.org/en/glossary/#account) and provides the ability to retrieve accounts, execute transactions, sign messages, etc. through [Wallet Actions](https://viem.sh/docs/actions/wallet/introduction.html).
  *
  * The Wallet Client supports signing over:
  * - [JSON-RPC Accounts](https://viem.sh/docs/clients/wallet.html#json-rpc-accounts) (e.g. Browser Extension Wallets, WalletConnect, etc).

package/src/clients/decorators/public.ts

@@ -234,7 +234,7 @@ export type PublicActions<
    */
   call: (parameters: CallParameters<TChain>) => Promise<CallReturnType>
   /**
-   * Creates a Filter to listen for new block hashes that can be used with [`getFilterChanges`](https://viem.sh/docs/actions/public/getFilterChanges).
+   * Creates a Filter to listen for new block hashes that can be used with [`getFilterChanges`](https://viem.sh/docs/actions/public/getFilterChanges.html).
    *
    * - Docs: https://viem.sh/docs/actions/public/createBlockFilter.html
    * - JSON-RPC Methods: [`eth_newBlockFilter`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_newBlockFilter)
@@ -254,7 +254,7 @@ export type PublicActions<
    */
   createBlockFilter: () => Promise<CreateBlockFilterReturnType>
   /**
-   * Creates a Filter to retrieve event logs that can be used with [`getFilterChanges`](https://viem.sh/docs/actions/public/getFilterChanges) or [`getFilterLogs`](https://viem.sh/docs/actions/public/getFilterLogs).
+   * 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).
    *
    * - Docs: https://viem.sh/docs/contract/createContractEventFilter.html
    *
@@ -281,7 +281,7 @@ export type PublicActions<
     args: CreateContractEventFilterParameters<TAbi, TEventName, TArgs>,
   ) => Promise<CreateContractEventFilterReturnType<TAbi, TEventName, TArgs>>
   /**
-   * 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).
+   * 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).
    *
    * - Docs: https://viem.sh/docs/actions/public/createEventFilter.html
    * - JSON-RPC Methods: [`eth_newFilter`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_newfilter)
@@ -310,7 +310,7 @@ export type PublicActions<
     args?: CreateEventFilterParameters<TAbiEvent, TAbi, TEventName, TArgs>,
   ) => Promise<CreateEventFilterReturnType<TAbiEvent, TAbi, TEventName, TArgs>>
   /**
-   * Creates a Filter to listen for new pending transaction hashes that can be used with [`getFilterChanges`](https://viem.sh/docs/actions/public/getFilterChanges).
+   * Creates a Filter to listen for new pending transaction hashes that can be used with [`getFilterChanges`](https://viem.sh/docs/actions/public/getFilterChanges.html).
    *
    * - Docs: https://viem.sh/docs/actions/public/createPendingTransactionFilter.html
    * - JSON-RPC Methods: [`eth_newPendingTransactionFilter`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_newpendingtransactionfilter)
@@ -335,7 +335,7 @@ export type PublicActions<
    * - 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).
+   * 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).
    *
    * @param args - {@link EstimateContractGasParameters}
    * @returns The gas estimate (in wei). {@link EstimateContractGasReturnType}
@@ -719,10 +719,10 @@ export type PublicActions<
    * @remarks
    * A Filter can be created from the following actions:
    *
-   * - [`createBlockFilter`](https://viem.sh/docs/actions/public/createBlockFilter)
-   * - [`createContractEventFilter`](https://viem.sh/docs/contract/createContractEventFilter)
-   * - [`createEventFilter`](https://viem.sh/docs/actions/public/createEventFilter)
-   * - [`createPendingTransactionFilter`](https://viem.sh/docs/actions/public/createPendingTransactionFilter)
+   * - [`createBlockFilter`](https://viem.sh/docs/actions/public/createBlockFilter.html)
+   * - [`createContractEventFilter`](https://viem.sh/docs/contract/createContractEventFilter.html)
+   * - [`createEventFilter`](https://viem.sh/docs/actions/public/createEventFilter.html)
+   * - [`createPendingTransactionFilter`](https://viem.sh/docs/actions/public/createPendingTransactionFilter.html)
    *
    * Depending on the type of filter, the return value will be different:
    *
@@ -896,7 +896,7 @@ export type PublicActions<
     args: GetStorageAtParameters,
   ) => Promise<GetStorageAtReturnType>
   /**
-   * Returns information about a [Transaction](https://viem.sh/docs/glossary/terms#transaction) given a hash or block identifier.
+   * Returns information about a [Transaction](https://viem.sh/docs/glossary/terms.html#transaction) given a hash or block identifier.
    *
    * - Docs: https://viem.sh/docs/actions/public/getTransaction.html
    * - Example: https://stackblitz.com/github/wagmi-dev/viem/tree/main/examples/transactions/fetching-transactions
@@ -946,7 +946,7 @@ export type PublicActions<
     args: GetTransactionConfirmationsParameters<TChain>,
   ) => Promise<GetTransactionConfirmationsReturnType>
   /**
-   * Returns the number of [Transactions](https://viem.sh/docs/glossary/terms#transaction) an Account has broadcast / sent.
+   * Returns the number of [Transactions](https://viem.sh/docs/glossary/terms.html#transaction) an Account has broadcast / sent.
    *
    * - Docs: https://viem.sh/docs/actions/public/getTransactionCount.html
    * - JSON-RPC Methods: [`eth_getTransactionCount`](https://ethereum.org/en/developers/docs/apis/json-rpc/#eth_gettransactioncount)
@@ -970,7 +970,7 @@ export type PublicActions<
     args: GetTransactionCountParameters,
   ) => Promise<GetTransactionCountReturnType>
   /**
-   * Returns the [Transaction Receipt](https://viem.sh/docs/glossary/terms#transaction-receipt) given a [Transaction](https://viem.sh/docs/glossary/terms#transaction) hash.
+   * Returns the [Transaction Receipt](https://viem.sh/docs/glossary/terms.html#transaction-receipt) given a [Transaction](https://viem.sh/docs/glossary/terms.html#transaction) hash.
    *
    * - Docs: https://viem.sh/docs/actions/public/getTransactionReceipt.html
    * - Example: https://stackblitz.com/github/wagmi-dev/viem/tree/main/examples/transactions/fetching-transactions
@@ -995,7 +995,7 @@ export type PublicActions<
     args: GetTransactionReceiptParameters,
   ) => Promise<GetTransactionReceiptReturnType<TChain>>
   /**
-   * Similar to [`readContract`](https://viem.sh/docs/contract/readContract), but batches up multiple functions on a contract in a single RPC call via the [`multicall3` contract](https://github.com/mds1/multicall).
+   * Similar to [`readContract`](https://viem.sh/docs/contract/readContract.html), but batches up multiple functions on a contract in a single RPC call via the [`multicall3` contract](https://github.com/mds1/multicall).
    *
    * - Docs: https://viem.sh/docs/contract/multicall.html
    *
@@ -1046,7 +1046,7 @@ export type PublicActions<
    * @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).
+   * Internally, uses a [Public Client](https://viem.sh/docs/clients/public.html) to call the [`call` action](https://viem.sh/docs/actions/public/call.html) with [ABI-encoded `data`](https://viem.sh/docs/contract/encodeFunctionData.html).
    *
    * @param args - {@link ReadContractParameters}
    * @returns The response from the contract. Type is inferred. {@link ReadContractReturnType}
@@ -1081,9 +1081,9 @@ export type PublicActions<
    * - 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.
+   * 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.html), 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).
+   * Internally, uses a [Public Client](https://viem.sh/docs/clients/public.html) to call the [`call` action](https://viem.sh/docs/actions/public/call.html) with [ABI-encoded `data`](https://viem.sh/docs/contract/encodeFunctionData.html).
    *
    * @param args - {@link SimulateContractParameters}
    * @returns The simulation result and write request. {@link SimulateContractReturnType}
@@ -1127,9 +1127,9 @@ export type PublicActions<
   /**
    * 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)
-   * - [`createPendingTransactionFilter`](https://viem.sh/docs/actions/public/createPendingTransactionFilter)
+   * - [`createBlockFilter`](https://viem.sh/docs/actions/public/createBlockFilter.html)
+   * - [`createEventFilter`](https://viem.sh/docs/actions/public/createEventFilter.html)
+   * - [`createPendingTransactionFilter`](https://viem.sh/docs/actions/public/createPendingTransactionFilter.html)
    *
    * - 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)
@@ -1252,7 +1252,7 @@ export type PublicActions<
    * @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.
+   * `watchContractEvent` will attempt to create an [Event Filter](https://viem.sh/docs/contract/createContractEventFilter.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 `watchContractEvent` will fall back to using [`getLogs`](https://viem.sh/docs/actions/public/getLogs.html) instead.
    *
    * @param args - {@link WatchContractEventParameters}
    * @returns A function that can be invoked to stop watching for new event logs. {@link WatchContractEventReturnType}
@@ -1280,7 +1280,7 @@ export type PublicActions<
     args: WatchContractEventParameters<TAbi, TEventName>,
   ) => WatchContractEventReturnType
   /**
-   * Watches and returns emitted [Event Logs](https://viem.sh/docs/glossary/terms#event-log).
+   * Watches and returns emitted [Event Logs](https://viem.sh/docs/glossary/terms.html#event-log).
    *
    * - Docs: https://viem.sh/docs/actions/public/watchEvent.html
    * - JSON-RPC Methods:
@@ -1293,7 +1293,7 @@ export type PublicActions<
    * @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.
+   * `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.html) instead.
    *
    * @param args - {@link WatchEventParameters}
    * @returns A function that can be invoked to stop watching for new Event Logs. {@link WatchEventReturnType}

package/src/clients/decorators/test.ts

@@ -390,7 +390,7 @@ export type TestActions = {
    */
   setBlockGasLimit: (args: SetBlockGasLimitParameters) => Promise<void>
   /**
-   * 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`.
+   * 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`.
    *
    * - Docs: https://viem.sh/docs/actions/test/setBlockTimestampInterval.html
    *
@@ -641,7 +641,7 @@ export type TestActions = {
    */
   snapshot: () => Promise<Quantity>
   /**
-   * Stop impersonating an account after having previously used [`impersonateAccount`](https://viem.sh/docs/actions/test/impersonateAccount).
+   * Stop impersonating an account after having previously used [`impersonateAccount`](https://viem.sh/docs/actions/test/impersonateAccount.html).
    *
    * - Docs: https://viem.sh/docs/actions/test/stopImpersonatingAccount.html
    *

package/src/clients/decorators/wallet.ts

@@ -93,7 +93,7 @@ export type WalletActions<
    * - Examples: https://stackblitz.com/github/wagmi-dev/viem/tree/main/examples/contracts/deploying-contracts
    *
    * @param args - {@link DeployContractParameters}
-   * @returns The [Transaction](https://viem.sh/docs/glossary/terms#transaction) hash. {@link DeployContractReturnType}
+   * @returns The [Transaction](https://viem.sh/docs/glossary/terms.html#transaction) hash. {@link DeployContractReturnType}
    *
    * @example
    * import { createWalletClient, http } from 'viem'
@@ -276,8 +276,8 @@ export type WalletActions<
    *   - Local Accounts: Signs locally. No JSON-RPC request.
    *
    * With the calculated signature, you can:
-   * - use [`verifyMessage`](https://viem.sh/docs/utilities/verifyMessage) to verify the signature,
-   * - use [`recoverMessageAddress`](https://viem.sh/docs/utilities/recoverMessageAddress) to recover the signing address from a signature.
+   * - use [`verifyMessage`](https://viem.sh/docs/utilities/verifyMessage.html) to verify the signature,
+   * - use [`recoverMessageAddress`](https://viem.sh/docs/utilities/recoverMessageAddress.html) to recover the signing address from a signature.
    *
    * @param args - {@link SignMessageParameters}
    * @returns The signed message. {@link SignMessageReturnType}
@@ -467,14 +467,14 @@ export type WalletActions<
    * - Docs: https://viem.sh/docs/contract/writeContract.html
    * - Examples: https://stackblitz.com/github/wagmi-dev/viem/tree/main/examples/contracts/writing-to-contracts
    *
-   * A "write" function on a Solidity contract modifies the state of the blockchain. These types of functions require gas to be executed, and hence a [Transaction](https://viem.sh/docs/glossary/terms) is needed to be broadcast in order to change the state.
+   * A "write" function on a Solidity contract modifies the state of the blockchain. These types of functions require gas to be executed, and hence a [Transaction](https://viem.sh/docs/glossary/terms.html) is needed to be broadcast in order to change the state.
    *
-   * Internally, uses a [Wallet Client](https://viem.sh/docs/clients/wallet) to call the [`sendTransaction` action](https://viem.sh/docs/actions/wallet/sendTransaction) with [ABI-encoded `data`](https://viem.sh/docs/contract/encodeFunctionData).
+   * Internally, uses a [Wallet Client](https://viem.sh/docs/clients/wallet.html) to call the [`sendTransaction` action](https://viem.sh/docs/actions/wallet/sendTransaction.html) with [ABI-encoded `data`](https://viem.sh/docs/contract/encodeFunctionData.html).
    *
    * __Warning: The `write` internally sends a transaction – it does not validate if the contract write will succeed (the contract may throw an error). It is highly recommended to [simulate the contract write with `contract.simulate`](https://viem.sh/docs/contract/writeContract.html#usage) before you execute it.__
    *
    * @param args - {@link WriteContractParameters}
-   * @returns A [Transaction Hash](https://viem.sh/docs/glossary/terms#hash). {@link WriteContractReturnType}
+   * @returns A [Transaction Hash](https://viem.sh/docs/glossary/terms.html#hash). {@link WriteContractReturnType}
    *
    * @example
    * import { createWalletClient, custom, parseAbi } from 'viem'

package/src/errors/abi.ts

@@ -293,8 +293,6 @@ export class DecodeLogDataMismatch extends BaseError {
       ].join('\n'),
       {
         metaMessages: [
-          'This error is usually caused if the ABI event has too many non-indexed event parameters for the emitted log.',
-          '',
           `Params: (${formatAbiParams(params, { includeName: true })})`,
           `Data:   ${data} (${size} bytes)`,
         ],

package/src/errors/ccip.ts

@@ -1,6 +1,7 @@
 import type { Address } from 'abitype'
 
 import type { Hex } from '../types/misc.js'
+import { stringify } from '../utils/stringify.js'
 
 import { BaseError } from './base.js'
 import { getUrl } from './utils.js'
@@ -53,7 +54,7 @@ export class OffchainLookupResponseMalformedError extends BaseError {
       {
         metaMessages: [
           `Gateway URL: ${getUrl(url)}`,
-          `Response: ${JSON.stringify(result)}`,
+          `Response: ${stringify(result)}`,
         ],
       },
     )

package/src/errors/data.ts

@@ -2,9 +2,15 @@ import { BaseError } from './base.js'
 
 export class SliceOffsetOutOfBoundsError extends BaseError {
   override name = 'SliceOffsetOutOfBoundsError'
-  constructor({ offset, size }: { offset: number; size: number }) {
+  constructor({
+    offset,
+    position,
+    size,
+  }: { offset: number; position: 'start' | 'end'; size: number }) {
     super(
-      `Slice starting at offset "${offset}" is out-of-bounds (size: ${size}).`,
+      `Slice ${
+        position === 'start' ? 'starting' : 'ending'
+      } at offset "${offset}" is out-of-bounds (size: ${size}).`,
     )
   }
 }