Wagmi 是一套面向以太坊的响应式开发原语，提供 React、Vue、Solid 的 hooks，以及可在原生 JavaScript 环境中使用的 Wagmi Core。它建立在 Viem 与 TanStack Query 之上，目标是将链上交互（连接钱包、读取链状态、发送交易、调用合约）封装为可组合、类型安全的接口。
用途 Wagmi 主要用于构建去中心化应用（dApp）的前端与全栈交互层。它将钱包连接、链切换、余额与区块查询、合约读写、消息签名、ENS 解析等操作统一为一组 hooks 或核心动作，并借助 TanStack Query 管理缓存、请求状态与响应式更新。
主要能力 据资料，Wagmi 的能力按主题组织：
- 配置与传输：createConfig 用于定义链、传输、连接器、存储与 Config API；Transports 支持 http、fallback、webSocket 与自定义方式，按链配置 RPC；Storage 提供 createStorage 自定义持久化（cookie、IndexedDB），并支持序列化/反序列化。
- Core Actions（原生用法）：getConnection、ENS、readContract、writeContract 等。
- 连接器：injected、WalletConnect、MetaMask、Coinbase、Safe、EIP-6963。
- React 集成：Setup（WagmiProvider、QueryClientProvider、config）；Connect Wallet（useConnect、useAccount、useDisconnect、useConnectors、useConnection）；Reconnect（useReconnect、reconnectOnMount）；Chain & Network（useChainId、useChains、useSwitchChain）；Block & Balance（useBlockNumber、useBalance）；Send Transaction（useSendTransaction、useWaitForTransactionReceipt，用于原始 ETH/交易）；Read/Write Contract（useReadContract、useWriteContract、useSimulateContract、useWaitForTransactionReceipt）；ENS（useEnsName、useEnsAddress、useEnsAvatar、useEnsResolver、useEnsText）；Sign Message（useSignMessage、useSignTypedData，支持 EIP-191 与 EIP-712）；TanStack Query（query/mutation options、缓存、SSR、Devtools）。
- 特性：create-wagmi CLI 可搭建 Next/Nuxt/Vite 的 React/Vue/Vanilla 项目；SSR 支持 ssr 标志、cookie 存储、cookieToInitialState、序列化/反序列化。
- 最佳实践：TypeScript（注册 config、链/ABI 推断、严格类型）；错误处理（类型化错误、BaseError、按 error.name 区分）。
使用方式 资料未提供具体安装命令或逐步使用代码，仅列出官方文档与 GitHub 仓库（Wagmi Docs、wevm/wagmi GitHub、Viem）作为外部链接。可通过 create-wagmi CLI 脚手架在 Next/Nuxt/Vite 等项目中初始化 React/Vue/Vanilla 工程，或在既有工程中引入 WagmiProvider、QueryClientProvider 与 config 后按主题调用相应 hooks 与 Core Actions。
适用场景 适合需要前端或全栈与以太坊交互的项目，例如钱包连接与网络切换、区块与余额展示、原生 ETH 转账、合约读写与模拟、消息签名（EIP-191/EIP-712）、ENS 解析，以及需要 SSR 支持与 TanStack Query 缓存的 dApp。
限制 资料未提供收费、价格、性能指标或效果承诺等信息。已知该技能基于 Wagmi v3.4.2 生成（2026-02-09），因此能力描述以该版本为准，其他版本差异暂未提供。资料未给出具体安装命令、代码示例与逐步操作细节，暂未提供。