# @0xtrails/adapter-wagmi 中文文档

规范地址：https://npmcn.com/package/%400xtrails/adapter-wagmi/

版本：0\.20\.0
npm 元数据更新时间：2026-10-22T15:27:29.831Z
中文译文更新时间：2026-11-06T08:11:11.035Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%400xtrails/adapter-wagmi
原文对照：https://npmcn.com/package/%400xtrails/adapter-wagmi/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：123 kB，21 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：viem ^2\.45\.0，react ^18\.0\.0 \|\| ^19\.0\.0，wagmi ^2\.19\.0 \|\| ^3\.2\.0，@tanstack/react-query ^5\.90\.20
- 首次发布：2026-05-08T15:52:58.774Z
- 最新版本发布：2026-10-22T15:27:29.592Z
- 近 30 天下载量：3965（2026-10-04 至 2026-11-02，npm 官方下载统计）
- 已发布版本数：17（近 12 个月 17 个）

## 中文简介

使用带有 wagmi 的拖车

## 安装

```sh
npm install @0xtrails/adapter-wagmi
```

也可以使用：`pnpm add @0xtrails/adapter-wagmi`、`yarn add @0xtrails/adapter-wagmi`、`bun add @0xtrails/adapter-wagmi`

## README

# @0xtrails/适应器-wagmi

使用有瓦克米的拖车.

这个适配器让Trails使用您的应用程序已经设置的wagmi. 当您的应用程序拥有时使用 `WagmiProvider`、链条、运输工具、连接器,你希望拖车部件或钩子能共享钱包状态。 主要融合目标为wagmi 3,而wagmi 2作为相容目标保留.

适配器自动检测周围 `WagmiProvider` 默认:

-   环绕 `WagmiProvider` 没有 `wagmiConfig` 选项 + 连接到主机拥有的 wagmi 运行时间
-   不变 `wagmiConfig` 实例 `WagmiProvider` \* 进入东道主拥有的wagmi运行时间的桥梁
-   不匹配周围 `WagmiProvider` (单位:千美元) `wagmiConfig` 选项 → 用提供的配置挂载适配器拥有的 wagmi 运行时间

对于一个真正独立的Trails拥有的运行时间,创建和通过一个单独的wagmi配置实例.

## 安装

```bash
npm install 0xtrails @0xtrails/adapter-wagmi wagmi viem @tanstack/react-query
```

支持的wagmi 版本 :

-   小学: `wagmi@^3.2.0`
-   兼容性 : `wagmi@^2.19.0`

软件包的对等范围仍然存在 `wagmi@^2.19.0 || ^3.2.0` 因此,现有的wagmi 2主机可以继续使用相同的适配器.

## 快速启动: 带有您的 wagmi 提供者的部件

```tsx
import { TrailsWidget } from '0xtrails'
import { wagmiAdapter } from '@0xtrails/adapter-wagmi'
import { WagmiProvider } from 'wagmi'

const apiKey = 'YOUR_TRAILS_API_KEY'

// Automatically uses the surrounding WagmiProvider.
const adapters = [wagmiAdapter()]

export function App() {
  return (
    <WagmiProvider config={wagmiConfig}>
      <TrailsWidget apiKey={apiKey} adapters={adapters} renderInline />
    </WagmiProvider>
  )
}
```

你只需要通过 `wagmiConfig` 当Trails能够搭载适配器拥有的 wagmi 运行时间倒计时.

## 有拖车的 App 级别设置

当拖车钩和部件共享同一适配器时使用此功能 .

```tsx
import { TrailsProvider, TrailsWidget } from '0xtrails'
import { wagmiAdapter } from '@0xtrails/adapter-wagmi'
import { WagmiProvider } from 'wagmi'

const apiKey = 'YOUR_TRAILS_API_KEY'
const adapters = [wagmiAdapter()]

export function App() {
  return (
    <WagmiProvider config={wagmiConfig}>
      <TrailsProvider config={{ trailsApiKey: apiKey, adapters }}>
        <TrailsWidget renderInline />
      </TrailsProvider>
    </WagmiProvider>
  )
}
```

## 运行时间所有权

`managedBy` 仅在您通过多个适配器作为包裹条目时才需要。 它控制有轨电车的钱包生命周期所有权,而不是控制 wagmi 适配器桥通向母供应商.

```tsx
const hostAdapter = wagmiAdapter({ wagmiConfig: hostWagmiConfig })
const trailsAdapter = wagmiAdapter({ wagmiConfig: trailsWagmiConfig })

const adapters = [
  { adapter: hostAdapter, managedBy: 'host' },
  { adapter: trailsAdapter, managedBy: 'trails' },
]
```

使用 `managedBy: 'host'` 当有轨电车可以使用钱包,但不应拥有其生命周期时,例如隐藏一个主机控制的钱包的断开动作. 使用 `managedBy: 'trails'` 用于拖车应当拥有的钱包选项.

## 可选: 自定义钱包标签

过 `wallets` 如果您想要控制主机钱包在轨迹中的出现. `name` 财务报告和审定财务报表 `icon` 替换目录中的标签和标志, 随处可见 Trails 显示钱包: 连接列表, 连接的芯片, 资助选择器和接收行 .

```tsx
const adapters = [
  wagmiAdapter({
    wagmiConfig,
    wallets: [
      {
        id: 'host-wallet',
        name: 'My Wallet',
        icon: 'https://my.app/wallet.png',
        flow: 'direct',
        placement: 'featured',
      },
    ],
  }),
]
```

### 将嵌入式钱包标为自己的

嵌入式钱包(Privy,Sequence)是主机-登录身份,因此Trails从不自行列出;一个主机选择一个带有有特色描述符的输入. 同样的描述是您重新命名的地方. 使用Privoy软件的用户应该看到该应用程序的钱包,而不是Privoy:

```tsx
wagmiAdapter({
  wagmiConfig: privyWagmiConfig,
  wallets: [
    {
      id: 'privy',
      name: 'XYZ Wallet',
      icon: 'https://xyz.app/wallet.png',
      flow: 'embedded',
      placement: 'featured',
      connect: connectPrivyEmbedded,
    },
  ],
})
```

轨迹解决任何 `@privy-io/wagmi` 与 id 连接器 `privy`,因此,描述符与连接匹配,无论用户是通过Trails连接还是已经签名。 枢密院自己的登录模式及其"由枢密院保护"脚印被配置在枢密院仪表板上,外有道道.

## 提示

-   打开适配器 `TrailsProvider config.adapters` 用于应用级设置.
-   打开适配器 `TrailsWidget adapters` 仅用于部件设置.
-   不要同时通过两个地方的适配器.
-   使用 `wagmiAdapter()` 当拖车自动检测 并共享您现有的 wagmi 运行时间.
-   传出同样的 `wagmiConfig` 例如,Trails应该分享运行时间,但仍有适配器的回落.
-   使用单独的 `wagmiConfig` 例如,拖车应安装单独的适配器自备运行时间.
-   `managedBy` 控制复合适配器列表中的生命周期所有性;它不覆盖wagmi运行时间匹配.

## 许可证

阿帕奇 - 2.0

## 常见问题

### @0xtrails/adapter-wagmi 是什么？

使用带有 wagmi 的拖车

### 如何安装 @0xtrails/adapter-wagmi？

在项目目录运行 npm install @0xtrails/adapter-wagmi，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：viem（^2\.45\.0）、react（^18\.0\.0 \|\| ^19\.0\.0）、wagmi（^2\.19\.0 \|\| ^3\.2\.0）、@tanstack/react-query（^5\.90\.20）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @0xtrails/adapter-wagmi 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @0xtrails/adapter-wagmi 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @0xtrails/adapter-wagmi 可以商用吗？

@0xtrails/adapter-wagmi 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @0xtrails/adapter-wagmi 的下载量有多少？

根据 npm 官方下载统计，@0xtrails/adapter-wagmi 在 2026/10/04 – 2026/11/02 这 30 天内被下载 3,965 次，日均约 132 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @0xtrails/adapter-wagmi 还在维护吗？

最新版本 0\.20\.0 发布于 2026/10/22（16 天前）；至今共发布 17 个版本，其中过去 12 个月发布了 17 个；首次发布于 2026/05/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。