@gnosis.pm/safe-apps-wagmi

中文文档
2.1.0发布于 2023/01/30MITTypeScriptCommonJS近 30 天下载 4629

安全应用的WAGMI连接器

中文使用文档
文档目录4 节
  1. 安装
  2. 一体化步骤
  3. 示例
  4. 更多设想

安全 Apps wagmi 连接器

npm

用于 wagmi 库的连接器

安装

yarn add @gnosis.pm/safe-apps-wagmi @wagmi/core

npm install @gnosis.pm/safe-apps-wagmi @wagmi/core

一体化步骤

  1. 配置 wagmi 客户端
import { SafeConnector } from '@gnosis.pm/safe-apps-wagmi';

const chains = ...

const client = createClient({
    connectors: [
        new SafeConnector({ chains }),
        new MetaMaskConnector({ chains }),
        new WalletConnectConnector({
            chains,
            options: {
                qrcode: true,
            },
        }),
        new InjectedConnector({
            chains,
            options: {
                name: 'Injected',
                shimDisconnect: true,
            },
        }),
    ],
    ...
});

确保省略 autoConnect 财产或设定为虚假。 Wagmi 库会自动连接到最后一个使用过的提供者,但如果应用程序在安全上下文中被加载,则我们希望自动连接到Safe. 自动连接逻辑可以通过单独的钩子执行.

  1. 创建自动连接钩
import { useConnect } from 'wagmi';
import { useEffect } from 'react';

const AUTOCONNECTED_CONNECTOR_IDS = ['safe'];

function useAutoConnect() {
  const { connect, connectors } = useConnect();

  useEffect(() => {
    AUTOCONNECTED_CONNECTOR_IDS.forEach((connector) => {
      const connectorInstance = connectors.find((c) => c.id === connector && c.ready);

      if (connectorInstance) {
        connect({ connector: connectorInstance });
      }
    });
  }, [connect, connectors]);
}

export { useAutoConnect };

这个钩子试图在应用程序负载上自动连接到安全钱包. 钩可以与其他使用类似iframe方法(如Ledger Live)的连接器相延伸. 如果连接到Safe没有成功,也可以以倒置逻辑来扩展,比如最后一个被使用的钱包.

示例

可以找到一个示例应用程序 这里

更多设想

关于SDK概览文件,请参见: 安全应用sdk 文档

版本与发布记录

@gnosis.pm/safe-apps-wagmi 共发布 8 个版本,首次发布于 2022/06/27;过去 12 个月发布了 0 个版本。

版本发布日期距今
2.1.0latest2023/01/303 年前
1.2.02022/11/303 年前
1.1.02022/10/264 年前
1.0.42022/10/114 年前
1.0.32022/08/254 年前
1.0.22022/07/284 年前

关于 @gnosis.pm/safe-apps-wagmi 的常见问题

@gnosis.pm/safe-apps-wagmi 是什么?

安全应用的WAGMI连接器

如何安装 @gnosis.pm/safe-apps-wagmi?

在项目目录运行 npm install @gnosis.pm/safe-apps-wagmi,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@wagmi/core(^0.8.3)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@gnosis.pm/safe-apps-wagmi 支持 TypeScript 吗?

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

@gnosis.pm/safe-apps-wagmi 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@gnosis.pm/safe-apps-wagmi 可以商用吗?

@gnosis.pm/safe-apps-wagmi 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@gnosis.pm/safe-apps-wagmi 的下载量有多少?

根据 npm 官方下载统计,@gnosis.pm/safe-apps-wagmi 在 2026/10/17 – 2026/11/15 这 30 天内被下载 4,629 次,日均约 154 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@gnosis.pm/safe-apps-wagmi 还在维护吗?

最新版本 2.1.0 发布于 2023/01/30(3 年前);至今共发布 8 个版本,其中过去 12 个月发布了 0 个;首次发布于 2022/06/27。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。