- Wagmi is participating in the Gitcoin Grants 20 round. Consider
supporting the project . Thank you. 🙏
+
-
diff --git a/site/.vitepress/theme/components/HomePage.vue b/site/.vitepress/theme/components/HomePage.vue
index 2a90368336..b6f7c8cee3 100644
--- a/site/.vitepress/theme/components/HomePage.vue
+++ b/site/.vitepress/theme/components/HomePage.vue
@@ -11,7 +11,8 @@ const teamMembers = [
name: 'awkweb',
links: [
{ icon: 'github', link: 'https://github.com/tmm' },
- { icon: 'twitter', link: 'https://twitter.com/awkweb' },
+ { icon: 'bluesky', link: 'https://bsky.app/profile/awkweb.com' },
+ { icon: 'x', link: 'https://twitter.com/awkweb' },
],
},
{
@@ -19,7 +20,8 @@ const teamMembers = [
name: 'jxom',
links: [
{ icon: 'github', link: 'https://github.com/jxom' },
- { icon: 'twitter', link: 'https://twitter.com/_jxom' },
+ { icon: 'bluesky', link: 'https://bsky.app/profile/jxom.dev' },
+ { icon: 'x', link: 'https://twitter.com/_jxom' },
],
},
] satisfies DefaultTheme.TeamMember[]
diff --git a/site/.vitepress/theme/composables/useSponsors.ts b/site/.vitepress/theme/composables/useSponsors.ts
index b45d3beeaa..38d77fc4a3 100644
--- a/site/.vitepress/theme/composables/useSponsors.ts
+++ b/site/.vitepress/theme/composables/useSponsors.ts
@@ -34,6 +34,11 @@ export function useSponsors() {
url: 'https://paradigm.xyz',
img: 'paradigm-light.svg',
},
+ {
+ name: 'Ithaca',
+ url: 'https://ithaca.xyz',
+ img: 'ithaca-light.svg',
+ },
],
gold: [
{
@@ -51,6 +56,11 @@ export function useSponsors() {
url: 'https://brave.com',
img: 'brave-light.svg',
},
+ {
+ name: 'Linea',
+ url: 'https://linea.build',
+ img: 'linea-light.svg',
+ },
],
silver: [
{
@@ -133,6 +143,26 @@ export function useSponsors() {
url: 'https://reservoir.tools',
img: 'reservoir-light.svg',
},
+ {
+ name: 'Uniswap',
+ url: 'https://uniswap.org',
+ img: 'uniswap-light.svg',
+ },
+ {
+ name: 'Biconomy',
+ url: 'https://biconomy.io',
+ img: 'biconomy-light.svg',
+ },
+ {
+ name: 'Thirdweb',
+ url: 'https://thirdweb.com',
+ img: 'thirdweb-light.svg',
+ },
+ {
+ name: 'Uxuy',
+ url: 'https://uxuy.com',
+ img: 'uxuy-light.svg',
+ },
],
}
diff --git a/site/.vitepress/theme/index.ts b/site/.vitepress/theme/index.ts
index a25eb10222..abcc802176 100644
--- a/site/.vitepress/theme/index.ts
+++ b/site/.vitepress/theme/index.ts
@@ -9,6 +9,7 @@ import 'uno.css'
import './style.css'
import AsideSponsors from './components/AsideSponsors.vue'
+// import Banner from './components/Banner.vue'
import HomeBanner from './components/HomeBanner.vue'
import HomePage from './components/HomePage.vue'
@@ -18,6 +19,7 @@ export default {
return h(DefaultTheme.Layout, null, {
// https://vitepress.dev/guide/extending-default-theme#layout-slots
'aside-ads-before': () => h(AsideSponsors),
+ // 'doc-before': () => h(Banner),
'home-features-after': () => h(HomePage),
'home-hero-before': () => h(HomeBanner),
})
diff --git a/site/.vitepress/theme/style.css b/site/.vitepress/theme/style.css
index 2849b07be9..4ec569cf05 100644
--- a/site/.vitepress/theme/style.css
+++ b/site/.vitepress/theme/style.css
@@ -8,7 +8,7 @@
*
* Each colors have exact same color scale system with 3 levels of solid
* colors with different brightness, and 1 soft color.
- *
+ *
* - `XXX-1`: The most solid color used mainly for colored text. It must
* satisfy the contrast ratio against when used on top of `XXX-soft`.
*
@@ -43,7 +43,7 @@
* in custom container, badges, etc.
* -------------------------------------------------------------------------- */
- :root {
+:root {
--vp-c-default-1: var(--vp-c-gray-1);
--vp-c-default-2: var(--vp-c-gray-2);
--vp-c-default-3: var(--vp-c-gray-3);
@@ -137,9 +137,12 @@
--docsearch-primary-color: var(--vp-c-brand-1) !important;
}
-
.vp-doc [class*="language-"] .has-focused-lines .line:not(.has-focus) {
filter: unset;
opacity: 0.3;
}
+.twoslash-error-line {
+ max-width: min-content;
+ white-space: wrap;
+}
diff --git a/site/cli/create-wagmi.md b/site/cli/create-wagmi.md
index 72d4795c5b..bdf8dda308 100644
--- a/site/cli/create-wagmi.md
+++ b/site/cli/create-wagmi.md
@@ -25,7 +25,7 @@ bun create wagmi
### `-t`, `--template`
-By default, `create-wagmi` scaffolds a basic Vite application with Wagmi. However, you can specify a custom [template](#templates) by passing the `--template`/`-t` flag:
+You can specify a custom [template](#templates) by passing the `--template`/`-t` flag:
::: code-group
```bash [pnpm]
@@ -60,6 +60,16 @@ Prints the CLI version.
- `next`: A Next.js Wagmi project.
- `nuxt`: A Nuxt Wagmi project.
-- `vite-react` (default): A Vite (React) Wagmi project.
+- `vite-react`: A Vite (React) Wagmi project.
- `vite-vanilla`: A Vite Wagmi Core project.
- `vite-vue`: A Vite (Vue) Wagmi project.
+
+If you do not specify the template on the command line, you will be prompted to select a framework and variant.
+
+- **React** : A React project.
+ - **Vite** : A React + Vite Wagmi project (`vite-react`).
+ - **Next** : A React + Next Wagmi project (`next`).
+- **Vue**: A Vue project.
+ - **Vite**: A Vue + Vite Wagmi project (`vite-vue`).
+ - **Nuxt**: A Vue + Nuxt Wagmi project (`nuxt`).
+- **Vanilla**: A Vite Wagmi project without React (`vite-vanilla`).
diff --git a/site/core/api/actions/call.md b/site/core/api/actions/call.md
index 28874490ea..52f202a570 100644
--- a/site/core/api/actions/call.md
+++ b/site/core/api/actions/call.md
@@ -58,7 +58,7 @@ await call(config, {
### data
-`0x${string} | undefined`
+`` `0x${string}` | undefined ``
A contract hashed method call with encoded args.
diff --git a/site/core/api/actions/signMessage.md b/site/core/api/actions/signMessage.md
index f4a1ac148c..23569146ac 100644
--- a/site/core/api/actions/signMessage.md
+++ b/site/core/api/actions/signMessage.md
@@ -1,7 +1,7 @@
# signMessage
diff --git a/site/core/api/actions/verifyMessage.md b/site/core/api/actions/verifyMessage.md
index 20f7a66874..93d46992b9 100644
--- a/site/core/api/actions/verifyMessage.md
+++ b/site/core/api/actions/verifyMessage.md
@@ -1,7 +1,7 @@
# verifyMessage
diff --git a/site/core/api/actions/watchAsset.md b/site/core/api/actions/watchAsset.md
new file mode 100644
index 0000000000..394dadd7ae
--- /dev/null
+++ b/site/core/api/actions/watchAsset.md
@@ -0,0 +1,134 @@
+
+
+# watchAsset
+
+Action for requesting user tracks the token in their wallet. Returns a boolean indicating if the token was successfully added.
+
+## Import
+
+```ts
+import { watchAsset } from '@wagmi/core'
+```
+
+## Usage
+
+::: code-group
+```ts [index.ts]
+import { watchAsset } from '@wagmi/core'
+import { config } from './config'
+
+await watchAsset(config, {
+ type: 'ERC20',
+ options: {
+ address: '0x0000000000000000000000000000000000000000',
+ symbol: 'WAGMI',
+ decimals: 18,
+ },
+})
+```
+<<< @/snippets/core/config.ts[config.ts]
+:::
+
+## Parameters
+
+```ts
+import { type WatchAssetParameters } from '@wagmi/core'
+```
+
+### connector
+
+`Connector | undefined`
+
+[Connector](/core/api/connectors) to sign message with.
+
+::: code-group
+```ts [index.ts]
+import { getAccount, watchAsset } from '@wagmi/core'
+import { config } from './config'
+
+const { connector } = getAccount(config)
+const result = await watchAsset(config, {
+ connector, // [!code focus]
+ options: {
+ address: '0x0000000000000000000000000000000000000000',
+ symbol: 'WAGMI',
+ decimals: 18,
+ },
+ type: 'ERC20',
+})
+```
+<<< @/snippets/core/config.ts[config.ts]
+:::
+
+### options
+
+`{ address: string; symbol: string; decimals: number; image?: string | undefined; }`
+
+Asset options.
+
+::: code-group
+```ts [index.ts]
+import { watchAsset } from '@wagmi/core'
+import { config } from './config'
+
+const result = await watchAsset(config, {
+ options: { // [!code focus]
+ address: '0x0000000000000000000000000000000000000000', // [!code focus]
+ symbol: 'WAGMI', // [!code focus]
+ decimals: 18, // [!code focus]
+ }, // [!code focus]
+ type: 'ERC20',
+})
+```
+<<< @/snippets/core/config.ts[config.ts]
+:::
+
+### type
+
+`'ERC20'`
+
+Type of asset.
+
+::: code-group
+```ts [index.ts]
+import { watchAsset } from '@wagmi/core'
+import { config } from './config'
+
+const result = await watchAsset(config, {
+ options: {
+ address: '0x0000000000000000000000000000000000000000',
+ symbol: 'WAGMI',
+ decimals: 18,
+ },
+ type: 'ERC20', // [!code focus]
+})
+```
+<<< @/snippets/core/config.ts[config.ts]
+:::
+
+## Return Type
+
+```ts
+import { type WatchAssetReturnType } from '@wagmi/core'
+```
+
+`boolean`
+
+Returns a boolean indicating if the token was successfully added.
+
+## Error
+
+```ts
+import { type WatchAssetErrorType } from '@wagmi/core'
+```
+
+
+
+## Viem
+
+- [`watchAsset`](https://viem.sh/docs/actions/wallet/watchAsset.html)
+
diff --git a/site/core/guides/chain-properties.md b/site/core/guides/chain-properties.md
index b28cd8ea03..7151b2b156 100644
--- a/site/core/guides/chain-properties.md
+++ b/site/core/guides/chain-properties.md
@@ -1,6 +1,6 @@
# Chain Properties
-Some chains support additional properties related to blocks and transactions. This is powered by Viem's [formatters](https://viem.sh/docs/clients/chains.html#formatters) and [serializers](https://viem.sh/docs/clients/chains.html#serializers). For example, Celo, ZkSync, OP Stack chains support all support additional properties. In order to use these properties in a type-safe way, there are a few things you should be aware of.
+Some chains support additional properties related to blocks and transactions. This is powered by Viem's [formatters](https://viem.sh/docs/clients/chains.html#formatters) and [serializers](https://viem.sh/docs/clients/chains.html#serializers). For example, Celo, ZkSync, OP Stack chains support all additional properties. In order to use these properties in a type-safe way, there are a few things you should be aware of.
## Narrowing Parameters
diff --git a/site/core/guides/framework-adapters.md b/site/core/guides/framework-adapters.md
index d1b852062a..1e45ba63ec 100644
--- a/site/core/guides/framework-adapters.md
+++ b/site/core/guides/framework-adapters.md
@@ -6,11 +6,11 @@ The short answer is — you already can! Wagmi Core is pure VanillaJS that you c
Someday, we would love to support additional frameworks, but unfortunately the core team doesn't have time to build and support them in a high-quality way at the moment. This could change in the future with additional [sponsors](https://github.com/sponsors/wevm), reshuffling of the roadmap, or if someone from the community wants to lead the effort.
-In the meantime, here are a some tips on how to create tighter bonds between Wagmi Core and other frameworks.
+In the meantime, here are some tips on how to create tighter bonds between Wagmi Core and other frameworks.
## Dependency Injection
-Once you create a Wagmi Config, you'll need to make sure your framework has access to it inside your higher-level functions (e.g. hooks for React, composables for Vue). For example, Wagmi uses [React Context](https://react.dev/learn/passing-data-deeply-with-context) to inject the Config into React Hooks and update it if it changes. This makes it so you users don't need to pass a Config object to every time they use a hook.
+Once you create a Wagmi Config, you'll need to make sure your framework has access to it inside your higher-level functions (e.g. hooks for React, composables for Vue). For example, Wagmi uses [React Context](https://react.dev/learn/passing-data-deeply-with-context) to inject the Config into React Hooks and update it if it changes. This makes it so your users don't need to pass a Config object every time they use a hook.
## Reactivity Layer
@@ -24,11 +24,11 @@ Wagmi uses [TanStack Query](https://tanstack.com/query) to enable caching, dedup
To get started with your framework, install and set up the related TanStack Query adapter. Next, import query keys/functions and mutation functions from the `'@wagmi/core/query'` entrypoint. You can plug these directly into your framework's TanStack Query adapter functions.
-If you are building a library, you'll also want to make sure you that you wire up generics correctly so type-inference and safety works correctly. The best way to make sure you are doing this correctly, is to see how we do this for React with Wagmi by checking out the [source code](https://github.com/wevm/wagmi/tree/main/packages/react/src/hooks).
+If you are building a library, you'll also want to make sure that you wire up generics correctly so type-inference and safety work correctly. The best way to make sure you are doing this correctly, is to see how we do this for React with Wagmi by checking out the [source code](https://github.com/wevm/wagmi/tree/main/packages/react/src/hooks).
## Testing
-If you are building a library, you'll want to write tests. Wagmi uses [React Testing Library](https://testing-library.com/docs/react-testing-library/intro) to test hooks. [Testing Library](https://testing-library.com) also supports other frameworks, like Svelte, Solid, and more. You can take a look on how the React tests work and do something similar for your code.
+If you are building a library, you'll want to write tests. Wagmi uses [React Testing Library](https://testing-library.com/docs/react-testing-library/intro) to test hooks. [Testing Library](https://testing-library.com) also supports other frameworks, like Svelte, Solid, and more. You can take a look at how the React tests work and do something similar for your code.
## Proxy Exports
diff --git a/site/core/guides/migrate-from-v1-to-v2.md b/site/core/guides/migrate-from-v1-to-v2.md
index 26a61b1062..6807ebafcd 100644
--- a/site/core/guides/migrate-from-v1-to-v2.md
+++ b/site/core/guides/migrate-from-v1-to-v2.md
@@ -289,7 +289,7 @@ In order to maximize type-safety and ease of creating connectors, the connector
### Removed individual entrypoints
-Previously, each connector had it's own entrypoint to optimize tree-shaking. Since all connectors now have [`package.json#sideEffects`](https://webpack.js.org/guides/tree-shaking/#mark-the-file-as-side-effect-free) enabled, this is no longer necessary and the entrypoint is unified. Use the `'@wagmi/connectors'` package instead.
+Previously, each connector had its own entrypoint to optimize tree-shaking. Since all connectors now have [`package.json#sideEffects`](https://webpack.js.org/guides/tree-shaking/#mark-the-file-as-side-effect-free) enabled, this is no longer necessary and the entrypoint is unified. Use the `'@wagmi/connectors'` package instead.
```ts
import { InjectedConnector } from '@wagmi/core/connectors/injected' // [!code --]
@@ -384,7 +384,7 @@ const result = await getEnsAddress(config, {
<<< @/snippets/core/config.ts[config.ts]
:::
-By inverting control, Wagmi let's you choose how much normalization to do. For example, maybe your project only allows ENS names that are numeric so no normalization is not needed. Check out the [ENS documentation](https://docs.ens.domains/contract-api-reference/name-processing#normalising-names) for more information on normalizing names.
+By inverting control, Wagmi lets you choose how much normalization to do. For example, maybe your project only allows ENS names that are numeric so no normalization is not needed. Check out the [ENS documentation](https://docs.ens.domains/contract-api-reference/name-processing#normalising-names) for more information on normalizing names.
### Removed `configureChains`
diff --git a/site/core/guides/viem.md b/site/core/guides/viem.md
index 7df3884090..275ed86949 100644
--- a/site/core/guides/viem.md
+++ b/site/core/guides/viem.md
@@ -192,6 +192,6 @@ const hash = await sendTransaction({
::: info
-Wagmi currently does not support hoisting Private Key & Mnemonic Accounts to the top-level Wagmi Config – meaning you have to explicitly pass through the account to every Action. If you feel like this is a feature that should be added, please [open an discussion](https://github.com/wevm/wagmi/discussions/new?category=ideas).
+Wagmi currently does not support hoisting Private Key & Mnemonic Accounts to the top-level Wagmi Config – meaning you have to explicitly pass through the account to every Action. If you feel like this is a feature that should be added, please [open a discussion](https://github.com/wevm/wagmi/discussions/new?category=ideas).
:::
diff --git a/site/core/why.md b/site/core/why.md
index 2fffdf1424..d7ed951f02 100644
--- a/site/core/why.md
+++ b/site/core/why.md
@@ -28,7 +28,7 @@ Data layer performance is also critical. Slow, unnecessary, and manual data fetc
## Feature Coverage
-Wagmi Core supports the most popular and commonly-used Ethereum features out of the box with 40+ VanillaJS Actions for accounts, wallets, contracts, transactions, signing, ENS, and more. Wagmi Core also supports just about any wallet out there through it's official [connectors](/core/api/connectors), [EIP-6963 support](/core/api/createConfig#multiinjectedproviderdiscovery), and [extensible API](/dev/creating-connectors).
+Wagmi Core supports the most popular and commonly-used Ethereum features out of the box with 40+ VanillaJS Actions for accounts, wallets, contracts, transactions, signing, ENS, and more. Wagmi Core also supports just about any wallet out there through its official [connectors](/core/api/connectors), [EIP-6963 support](/core/api/createConfig#multiinjectedproviderdiscovery), and [extensible API](/dev/creating-connectors).
If you need lower-level control, you can always drop down to [Viem](https://viem.sh), which Wagmi Core uses internally to perform blockchain operations. Wagmi Core also manages multi-chain support automatically so developers can focus on their applications instead of adding custom code.
diff --git a/site/dev/creating-connectors.md b/site/dev/creating-connectors.md
index 7081c2e3e3..0b98e834cf 100644
--- a/site/dev/creating-connectors.md
+++ b/site/dev/creating-connectors.md
@@ -54,6 +54,7 @@ The type error tells you what properties are missing from `createConnector`'s re
- `icon`: Optional icon URL for the connector.
- `id`: The ID for the connector. This should be camel-cased and as short as possible. Example: `fooBarBaz`.
- `name`: Human-readable name for the connector. Example: `'Foo Bar Baz'`.
+- `rdns`: Optional reverse DNS for the connector. This is used to filter out duplicate [EIP-6963](https://eips.ethereum.org/EIPS/eip-6963) injected providers when `createConfig#multiInjectedProviderDiscovery` is enabled.
- `supportsSimulation`: Whether the connector supports contract simulation. This should be disabled if a connector's wallet cannot accurately simulate contract writes or display contract revert messages. Defaults to `false`.
#### Methods
diff --git a/site/package.json b/site/package.json
index bd0d0aa773..f683675231 100644
--- a/site/package.json
+++ b/site/package.json
@@ -8,21 +8,21 @@
"preview": "vitepress preview"
},
"devDependencies": {
- "@shikijs/vitepress-twoslash": "^1.4.0",
- "@tanstack/query-core": ">=5.45.0",
- "@tanstack/react-query": ">=5.45.1",
- "@tanstack/vue-query": ">=5.45.0",
- "@types/react": ">=18.3.1",
+ "@shikijs/vitepress-twoslash": "1.22.2",
+ "@tanstack/query-core": "catalog:",
+ "@tanstack/react-query": "catalog:",
+ "@tanstack/vue-query": "catalog:",
+ "@types/react": "catalog:",
"@wagmi/connectors": "workspace:*",
"@wagmi/core": "workspace:*",
"@wagmi/vue": "workspace:*",
"abitype": "*",
"nuxt": "^3.11.2",
- "react": ">=18.3.1",
+ "react": "catalog:",
"unocss": "^0.59.4",
"viem": "2.*",
- "vitepress": "^1.1.4",
- "vue": ">=3.4.21",
+ "vitepress": "1.5.0",
+ "vue": "catalog:",
"wagmi": "workspace:*"
}
}
diff --git a/site/react/api/hooks/useAccount.md b/site/react/api/hooks/useAccount.md
index d005267879..d5b9e2964c 100644
--- a/site/react/api/hooks/useAccount.md
+++ b/site/react/api/hooks/useAccount.md
@@ -36,7 +36,7 @@ import { type UseAccountParameters } from 'wagmi'
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useAccountEffect.md b/site/react/api/hooks/useAccountEffect.md
index abfb870f46..6636f4bbaa 100644
--- a/site/react/api/hooks/useAccountEffect.md
+++ b/site/react/api/hooks/useAccountEffect.md
@@ -43,7 +43,7 @@ import { type UseAccountEffectParameters } from 'wagmi'
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useBalance.md b/site/react/api/hooks/useBalance.md
index 6aad175af1..deddbb720d 100644
--- a/site/react/api/hooks/useBalance.md
+++ b/site/react/api/hooks/useBalance.md
@@ -131,7 +131,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useBlock.md b/site/react/api/hooks/useBlock.md
index 131c10b623..f0962ee4c1 100644
--- a/site/react/api/hooks/useBlock.md
+++ b/site/react/api/hooks/useBlock.md
@@ -121,7 +121,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useBlockNumber.md b/site/react/api/hooks/useBlockNumber.md
index 53f56608a0..e0c6ff7242 100644
--- a/site/react/api/hooks/useBlockNumber.md
+++ b/site/react/api/hooks/useBlockNumber.md
@@ -83,7 +83,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useBlockTransactionCount.md b/site/react/api/hooks/useBlockTransactionCount.md
index fcc6a13e8b..80cb99de32 100644
--- a/site/react/api/hooks/useBlockTransactionCount.md
+++ b/site/react/api/hooks/useBlockTransactionCount.md
@@ -121,7 +121,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useBytecode.md b/site/react/api/hooks/useBytecode.md
index 8c75b29da5..573cee32c0 100644
--- a/site/react/api/hooks/useBytecode.md
+++ b/site/react/api/hooks/useBytecode.md
@@ -126,7 +126,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useCall.md b/site/react/api/hooks/useCall.md
index 407e349721..9bc2250cf2 100644
--- a/site/react/api/hooks/useCall.md
+++ b/site/react/api/hooks/useCall.md
@@ -338,7 +338,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useCallsStatus.md b/site/react/api/hooks/useCallsStatus.md
index eb9622c89d..94b333b7c7 100644
--- a/site/react/api/hooks/useCallsStatus.md
+++ b/site/react/api/hooks/useCallsStatus.md
@@ -50,7 +50,7 @@ import { type UseCallsStatusParameters } from 'wagmi/experimental'
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useCapabilities.md b/site/react/api/hooks/useCapabilities.md
index e478cf000a..c485c680f0 100644
--- a/site/react/api/hooks/useCapabilities.md
+++ b/site/react/api/hooks/useCapabilities.md
@@ -68,7 +68,7 @@ const status = await useCapabilities({
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useChainId.md b/site/react/api/hooks/useChainId.md
index 1339da3205..509f5a1e4c 100644
--- a/site/react/api/hooks/useChainId.md
+++ b/site/react/api/hooks/useChainId.md
@@ -36,7 +36,7 @@ import { type UseChainIdParameters } from 'wagmi'
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useChains.md b/site/react/api/hooks/useChains.md
index 20afe03450..286f794276 100644
--- a/site/react/api/hooks/useChains.md
+++ b/site/react/api/hooks/useChains.md
@@ -36,7 +36,7 @@ import { type UseChainsParameters } from 'wagmi'
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useClient.md b/site/react/api/hooks/useClient.md
index ae284e62ae..fc87a15e47 100644
--- a/site/react/api/hooks/useClient.md
+++ b/site/react/api/hooks/useClient.md
@@ -57,7 +57,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useConnect.md b/site/react/api/hooks/useConnect.md
index 90816a1433..ba52ee2aaf 100644
--- a/site/react/api/hooks/useConnect.md
+++ b/site/react/api/hooks/useConnect.md
@@ -53,7 +53,7 @@ import { type UseConnectParameters } from 'wagmi'
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useConnections.md b/site/react/api/hooks/useConnections.md
index 19f7e98d0a..f6f18b14fa 100644
--- a/site/react/api/hooks/useConnections.md
+++ b/site/react/api/hooks/useConnections.md
@@ -36,7 +36,7 @@ import { type UseConnectionsParameters } from 'wagmi'
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useConnectorClient.md b/site/react/api/hooks/useConnectorClient.md
index d20dcbf1ff..60aa74b77d 100644
--- a/site/react/api/hooks/useConnectorClient.md
+++ b/site/react/api/hooks/useConnectorClient.md
@@ -77,7 +77,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useDeployContract.md b/site/react/api/hooks/useDeployContract.md
index a97a11d15b..42b2e9ffe3 100644
--- a/site/react/api/hooks/useDeployContract.md
+++ b/site/react/api/hooks/useDeployContract.md
@@ -112,7 +112,7 @@ import { type useDeployContractParameters } from 'wagmi'
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useDisconnect.md b/site/react/api/hooks/useDisconnect.md
index 2c0da94981..587a443f20 100644
--- a/site/react/api/hooks/useDisconnect.md
+++ b/site/react/api/hooks/useDisconnect.md
@@ -52,7 +52,7 @@ import { type UseDisconnectParameters } from 'wagmi'
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useEnsAddress.md b/site/react/api/hooks/useEnsAddress.md
index 855433815c..b4807384f1 100644
--- a/site/react/api/hooks/useEnsAddress.md
+++ b/site/react/api/hooks/useEnsAddress.md
@@ -140,7 +140,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useEnsAvatar.md b/site/react/api/hooks/useEnsAvatar.md
index d5298bc1fb..ec09af5e31 100644
--- a/site/react/api/hooks/useEnsAvatar.md
+++ b/site/react/api/hooks/useEnsAvatar.md
@@ -143,7 +143,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useEnsName.md b/site/react/api/hooks/useEnsName.md
index f4102bf8c1..71d128b1bf 100644
--- a/site/react/api/hooks/useEnsName.md
+++ b/site/react/api/hooks/useEnsName.md
@@ -130,7 +130,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useEnsResolver.md b/site/react/api/hooks/useEnsResolver.md
index 36a405abfc..b66e17fa03 100644
--- a/site/react/api/hooks/useEnsResolver.md
+++ b/site/react/api/hooks/useEnsResolver.md
@@ -119,7 +119,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useEnsText.md b/site/react/api/hooks/useEnsText.md
index ff761cc8c1..769bae66ce 100644
--- a/site/react/api/hooks/useEnsText.md
+++ b/site/react/api/hooks/useEnsText.md
@@ -166,7 +166,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useEstimateFeesPerGas.md b/site/react/api/hooks/useEstimateFeesPerGas.md
index 564e82fbfe..29b8711673 100644
--- a/site/react/api/hooks/useEstimateFeesPerGas.md
+++ b/site/react/api/hooks/useEstimateFeesPerGas.md
@@ -64,7 +64,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useEstimateGas.md b/site/react/api/hooks/useEstimateGas.md
index b7ef9c2c9c..671322408a 100644
--- a/site/react/api/hooks/useEstimateGas.md
+++ b/site/react/api/hooks/useEstimateGas.md
@@ -30,7 +30,6 @@ import { useEstimateGas } from 'wagmi'
function App() {
const result = useEstimateGas()
}
-}
```
<<< @/snippets/react/config.ts[config.ts]
:::
diff --git a/site/react/api/hooks/useEstimateMaxPriorityFeePerGas.md b/site/react/api/hooks/useEstimateMaxPriorityFeePerGas.md
index e851fef943..affb165711 100644
--- a/site/react/api/hooks/useEstimateMaxPriorityFeePerGas.md
+++ b/site/react/api/hooks/useEstimateMaxPriorityFeePerGas.md
@@ -64,7 +64,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useFeeHistory.md b/site/react/api/hooks/useFeeHistory.md
index a9a293cd83..42bf60d89f 100644
--- a/site/react/api/hooks/useFeeHistory.md
+++ b/site/react/api/hooks/useFeeHistory.md
@@ -153,7 +153,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useGasPrice.md b/site/react/api/hooks/useGasPrice.md
index d702b2977a..2dfa13aa19 100644
--- a/site/react/api/hooks/useGasPrice.md
+++ b/site/react/api/hooks/useGasPrice.md
@@ -64,7 +64,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/usePrepareTransactionRequest.md b/site/react/api/hooks/usePrepareTransactionRequest.md
index 2e12bc0ea5..431fdda482 100644
--- a/site/react/api/hooks/usePrepareTransactionRequest.md
+++ b/site/react/api/hooks/usePrepareTransactionRequest.md
@@ -284,7 +284,7 @@ function App() {
`bigint | undefined`
-The transaction recipient or contract address.
+Value in wei sent with this transaction.
::: code-group
```tsx [index.tsx]
@@ -307,7 +307,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useProof.md b/site/react/api/hooks/useProof.md
index 3d428f48ca..76adcdca4d 100644
--- a/site/react/api/hooks/useProof.md
+++ b/site/react/api/hooks/useProof.md
@@ -163,7 +163,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/usePublicClient.md b/site/react/api/hooks/usePublicClient.md
index 030d2ea1e1..9f0411055b 100644
--- a/site/react/api/hooks/usePublicClient.md
+++ b/site/react/api/hooks/usePublicClient.md
@@ -61,7 +61,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useReadContract.md b/site/react/api/hooks/useReadContract.md
index b6bf372050..07be91e010 100644
--- a/site/react/api/hooks/useReadContract.md
+++ b/site/react/api/hooks/useReadContract.md
@@ -225,7 +225,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useReadContracts.md b/site/react/api/hooks/useReadContracts.md
index 853db7434c..48436c9362 100644
--- a/site/react/api/hooks/useReadContracts.md
+++ b/site/react/api/hooks/useReadContracts.md
@@ -326,7 +326,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useReconnect.md b/site/react/api/hooks/useReconnect.md
index 92616ebae8..7aff4945c9 100644
--- a/site/react/api/hooks/useReconnect.md
+++ b/site/react/api/hooks/useReconnect.md
@@ -55,7 +55,7 @@ import { type UseReconnectParameters } from 'wagmi'
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useSendCalls.md b/site/react/api/hooks/useSendCalls.md
index a85d13fea7..32b2f81afa 100644
--- a/site/react/api/hooks/useSendCalls.md
+++ b/site/react/api/hooks/useSendCalls.md
@@ -74,7 +74,7 @@ import { type UseSendCallsParameters } from 'wagmi/experimental'
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useSendTransaction.md b/site/react/api/hooks/useSendTransaction.md
index 437c98043f..c9d4bf441b 100644
--- a/site/react/api/hooks/useSendTransaction.md
+++ b/site/react/api/hooks/useSendTransaction.md
@@ -60,7 +60,7 @@ import { type UseSendTransactionParameters } from 'wagmi'
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useShowCallsStatus.md b/site/react/api/hooks/useShowCallsStatus.md
index ee45927e29..5ff5fbe958 100644
--- a/site/react/api/hooks/useShowCallsStatus.md
+++ b/site/react/api/hooks/useShowCallsStatus.md
@@ -65,7 +65,7 @@ import { type UseShowCallsStatusParameters } from 'wagmi/experimental'
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useSignMessage.md b/site/react/api/hooks/useSignMessage.md
index c36a9c1521..7b0ffb3a4a 100644
--- a/site/react/api/hooks/useSignMessage.md
+++ b/site/react/api/hooks/useSignMessage.md
@@ -52,7 +52,7 @@ import { type UseSignMessageParameters } from 'wagmi'
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useSignTypedData.md b/site/react/api/hooks/useSignTypedData.md
index fab508c85f..140b0e86a3 100644
--- a/site/react/api/hooks/useSignTypedData.md
+++ b/site/react/api/hooks/useSignTypedData.md
@@ -81,7 +81,7 @@ import { type UseSignTypedDataParameters } from 'wagmi'
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useSimulateContract.md b/site/react/api/hooks/useSimulateContract.md
index c32299617f..03872f53e5 100644
--- a/site/react/api/hooks/useSimulateContract.md
+++ b/site/react/api/hooks/useSimulateContract.md
@@ -296,7 +296,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useStorageAt.md b/site/react/api/hooks/useStorageAt.md
index 23ef818995..12c524ac1e 100644
--- a/site/react/api/hooks/useStorageAt.md
+++ b/site/react/api/hooks/useStorageAt.md
@@ -151,7 +151,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useSwitchAccount.md b/site/react/api/hooks/useSwitchAccount.md
index 9c98a2db71..8dc3395a70 100644
--- a/site/react/api/hooks/useSwitchAccount.md
+++ b/site/react/api/hooks/useSwitchAccount.md
@@ -56,7 +56,7 @@ import { type UseSwitchAccountParameters } from 'wagmi'
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useSwitchChain.md b/site/react/api/hooks/useSwitchChain.md
index 20b1b27075..3b139bd701 100644
--- a/site/react/api/hooks/useSwitchChain.md
+++ b/site/react/api/hooks/useSwitchChain.md
@@ -60,7 +60,7 @@ import { type UseSwitchChainParameters } from 'wagmi'
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useToken.md b/site/react/api/hooks/useToken.md
index 69ff36cd1d..cd4c6dbec2 100644
--- a/site/react/api/hooks/useToken.md
+++ b/site/react/api/hooks/useToken.md
@@ -87,7 +87,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useTransaction.md b/site/react/api/hooks/useTransaction.md
index 09d4f768c1..391f5bf802 100644
--- a/site/react/api/hooks/useTransaction.md
+++ b/site/react/api/hooks/useTransaction.md
@@ -117,7 +117,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useTransactionConfirmations.md b/site/react/api/hooks/useTransactionConfirmations.md
index db6766a165..6dec7c1319 100644
--- a/site/react/api/hooks/useTransactionConfirmations.md
+++ b/site/react/api/hooks/useTransactionConfirmations.md
@@ -98,7 +98,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useTransactionCount.md b/site/react/api/hooks/useTransactionCount.md
index 0b13dd2dec..142453af4b 100644
--- a/site/react/api/hooks/useTransactionCount.md
+++ b/site/react/api/hooks/useTransactionCount.md
@@ -131,7 +131,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useTransactionReceipt.md b/site/react/api/hooks/useTransactionReceipt.md
index 2a0a438f49..2f909ee891 100644
--- a/site/react/api/hooks/useTransactionReceipt.md
+++ b/site/react/api/hooks/useTransactionReceipt.md
@@ -87,7 +87,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useVerifyMessage.md b/site/react/api/hooks/useVerifyMessage.md
index 825f4b14cb..e7750d79f3 100644
--- a/site/react/api/hooks/useVerifyMessage.md
+++ b/site/react/api/hooks/useVerifyMessage.md
@@ -198,7 +198,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useVerifyTypedData.md b/site/react/api/hooks/useVerifyTypedData.md
index 6b47afd07f..4d9f8bc24e 100644
--- a/site/react/api/hooks/useVerifyTypedData.md
+++ b/site/react/api/hooks/useVerifyTypedData.md
@@ -590,7 +590,7 @@ export const types = {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useWaitForTransactionReceipt.md b/site/react/api/hooks/useWaitForTransactionReceipt.md
index 780f67bbf1..3f026c1bc9 100644
--- a/site/react/api/hooks/useWaitForTransactionReceipt.md
+++ b/site/react/api/hooks/useWaitForTransactionReceipt.md
@@ -70,7 +70,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useWalletClient.md b/site/react/api/hooks/useWalletClient.md
index fadbb24b01..e6ee792c25 100644
--- a/site/react/api/hooks/useWalletClient.md
+++ b/site/react/api/hooks/useWalletClient.md
@@ -81,7 +81,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useWatchAsset.md b/site/react/api/hooks/useWatchAsset.md
new file mode 100644
index 0000000000..03f756d569
--- /dev/null
+++ b/site/react/api/hooks/useWatchAsset.md
@@ -0,0 +1,94 @@
+---
+title: useWatchAsset
+description: Hook for requesting user tracks the token in their wallet. Returns a boolean indicating if the token was successfully added.
+---
+
+
+
+# useWatchAsset
+
+Hook for requesting user tracks the token in their wallet. Returns a boolean indicating if the token was successfully added.
+
+## Import
+
+```ts
+import { useWatchAsset } from 'wagmi'
+```
+
+## Usage
+
+::: code-group
+```tsx [index.tsx]
+import { useWatchAsset } from 'wagmi'
+
+function App() {
+ const { watchAsset } = useWatchAsset()
+
+ return (
+
watchAsset({
+ type: 'ERC20',
+ options: {
+ address: '0x0000000000000000000000000000000000000000',
+ symbol: 'WAGMI',
+ decimals: 18,
+ },
+ })}
+ >
+ Watch asset
+
+ )
+}
+```
+<<< @/snippets/react/config.ts[config.ts]
+:::
+
+## Parameters
+
+```ts
+import { type UseWatchAssetParameters } from 'wagmi'
+```
+
+### config
+
+`Config | undefined`
+
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
+
+::: code-group
+```tsx [index.tsx]
+import { useWatchAsset } from 'wagmi'
+import { config } from './config' // [!code focus]
+
+function App() {
+ const result = useWatchAsset({
+ config, // [!code focus]
+ })
+}
+```
+<<< @/snippets/react/config.ts[config.ts]
+:::
+
+
+
+## Return Type
+
+```ts
+import { type UseWatchAssetReturnType } from 'wagmi'
+```
+
+
+
+
+
+## Action
+
+- [`watchAsset`](/core/api/actions/watchAsset)
diff --git a/site/react/api/hooks/useWatchBlockNumber.md b/site/react/api/hooks/useWatchBlockNumber.md
index 203a46f450..925dddfc1a 100644
--- a/site/react/api/hooks/useWatchBlockNumber.md
+++ b/site/react/api/hooks/useWatchBlockNumber.md
@@ -62,7 +62,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```ts [index.ts]
diff --git a/site/react/api/hooks/useWatchBlocks.md b/site/react/api/hooks/useWatchBlocks.md
index 40160931e9..ec2b17326c 100644
--- a/site/react/api/hooks/useWatchBlocks.md
+++ b/site/react/api/hooks/useWatchBlocks.md
@@ -84,7 +84,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```ts [index.ts]
diff --git a/site/react/api/hooks/useWatchContractEvent.md b/site/react/api/hooks/useWatchContractEvent.md
index 91ccd530ea..1bdcfb2622 100644
--- a/site/react/api/hooks/useWatchContractEvent.md
+++ b/site/react/api/hooks/useWatchContractEvent.md
@@ -182,7 +182,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useWatchPendingTransactions.md b/site/react/api/hooks/useWatchPendingTransactions.md
index 82a11a9e84..0bfbb8136d 100644
--- a/site/react/api/hooks/useWatchPendingTransactions.md
+++ b/site/react/api/hooks/useWatchPendingTransactions.md
@@ -85,7 +85,7 @@ function App() {
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/api/hooks/useWriteContract.md b/site/react/api/hooks/useWriteContract.md
index 60ac14d9f8..bc575ce88b 100644
--- a/site/react/api/hooks/useWriteContract.md
+++ b/site/react/api/hooks/useWriteContract.md
@@ -75,7 +75,7 @@ import { type UseWriteContractParameters } from 'wagmi'
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
diff --git a/site/react/api/hooks/useWriteContracts.md b/site/react/api/hooks/useWriteContracts.md
index 21f79e3dad..8f1964b187 100644
--- a/site/react/api/hooks/useWriteContracts.md
+++ b/site/react/api/hooks/useWriteContracts.md
@@ -90,7 +90,7 @@ import { type UseWriteContractsParameters } from 'wagmi/experimental'
`Config | undefined`
-[`Config`](/react/api/createConfig#config) to use instead of retrieving from the from nearest [`WagmiProvider`](/react/api/WagmiProvider).
+[`Config`](/react/api/createConfig#config) to use instead of retrieving from the nearest [`WagmiProvider`](/react/api/WagmiProvider).
::: code-group
```tsx [index.tsx]
diff --git a/site/react/guides/connect-wallet.md b/site/react/guides/connect-wallet.md
index 9cd4a6018e..05e623d04c 100644
--- a/site/react/guides/connect-wallet.md
+++ b/site/react/guides/connect-wallet.md
@@ -9,7 +9,7 @@ Wagmi contains everything you need to get started with building a Connect Wallet
You can use a pre-built Connect Wallet module from a third-party library such as:
- [ConnectKit](https://docs.family.co/connectkit) - [Guide](https://docs.family.co/connectkit/getting-started)
-- [AppKit](https://walletconnect.com/appkit) - [Guide](https://docs.walletconnect.com/appkit/react/core/installation)
+- [AppKit](https://walletconnect.com/appkit) - [Guide](https://docs.walletconnect.com/appkit/next/core/installation)
- [RainbowKit](https://www.rainbowkit.com/) - [Guide](https://www.rainbowkit.com/docs/installation)
- [Dynamic](https://www.dynamic.xyz/) - [Guide](https://docs.dynamic.xyz/quickstart)
- [Privy](https://privy.io) - [Guide](https://docs.privy.io/guide/react/wallets/usage/wagmi)
diff --git a/site/react/guides/read-from-contract.md b/site/react/guides/read-from-contract.md
index c63ebf9f91..57f23667f0 100644
--- a/site/react/guides/read-from-contract.md
+++ b/site/react/guides/read-from-contract.md
@@ -5,7 +5,6 @@ The [`useReadContract` Hook](/react/api/hooks/useReadContract) allows you to rea
The component below shows how to retrieve the token balance of an address from the [Wagmi Example](https://etherscan.io/token/0xFBA3912Ca04dd458c843e2EE08967fC04f3579c2) contract
:::code-group
-
```tsx [read-contract.tsx]
import { useReadContract } from 'wagmi'
@@ -21,9 +20,21 @@ function ReadContract() {
)
}
```
-
:::
+If `useReadContract` depends on another value (`address` in the example below), you can use the [`query.enabled`](/react/api/hooks/useReadContract#enabled) option to prevent the query from running until the dependency is ready.
+
+```tsx
+const { data: balance } = useReadContract({
+ ...wagmiContractConfig,
+ functionName: 'balanceOf',
+ args: [address],
+ query: { // [!code focus]
+ enabled: !!address, // [!code focus]
+ }, // [!code focus]
+})
+```
+
## Loading & Error States
The [`useReadContract` Hook](/react/api/hooks/useReadContract) also returns loading & error states, which can be used to display a loading indicator while the data is being fetched, or an error message if contract execution reverts.
diff --git a/site/react/guides/tanstack-query.md b/site/react/guides/tanstack-query.md
index b8e354bb43..e491695d71 100644
--- a/site/react/guides/tanstack-query.md
+++ b/site/react/guides/tanstack-query.md
@@ -187,7 +187,7 @@ function App() {
Each Hook has a corresponding `get
QueryOptions` function that returns a query key. You would use this method when you want to utilize the query key outside of a React component in a Vanilla JS context, like in a utility function.
```ts
-import { getBlockQueryOptions } from 'wagmi' // [!code hl]
+import { getBlockQueryOptions } from 'wagmi/query' // [!code hl]
import { config } from './config'
function perform() {
diff --git a/site/react/guides/write-to-contract.md b/site/react/guides/write-to-contract.md
index 8e06da1929..65914ae981 100644
--- a/site/react/guides/write-to-contract.md
+++ b/site/react/guides/write-to-contract.md
@@ -95,8 +95,7 @@ export function MintNFT() {
return (
@@ -150,8 +149,7 @@ export function MintNFT() {
return (
- 
+
+ 
+ 
+ 
+ 
+ 
+ 
+