Skip to main content
几分钟即可上手 Widget Light。核心包除了 React 之外没有任何依赖 — 你只需为想要支持的区块链生态系统添加对等依赖。

核心包

生态系统依赖

为你想要支持的每个区块链生态系统安装对等依赖。你只需要安装应用实际用到的生态系统。

EVM(Ethereum)

Solana

Bitcoin

Sui

Tron

Tron 处理器与具体库无关 — 你需要显式传入钱包状态。使用该 API 只需要 @lifi/widget-light。如果你按照文档记录的方式使用 @tronweb3/tronwallet-adapter-react-hooks 进行集成,请将其与核心包一起安装:

所有生态系统

一次性安装所有内容:

快速入门 — 仅 EVM(wagmi)

这是使用 wagmi 面向 EVM 链的最小设置。它假设你的应用中已经配置了 wagmi provider。

1. 配置你的钱包 provider

像平常一样设置 wagmi。Widget Light 会从你现有的 wagmi 上下文中读取钱包状态。

2. 设置 provider 树

3. 渲染 widget

widget 在 iframe 内渲染,所有 EVM 交易都通过你的 wagmi 托管钱包进行签名。

完整的多生态系统设置

要在支持 EVM 的同时支持 Solana、Bitcoin、Sui 和 Tron,请安装额外的处理器对等依赖,并将所有处理器传递给 widget。
只包含你需要的处理器。如果你只支持 EVM 和 Solana,则传入 [ethHandler, solHandler]。未使用的生态系统包会被完全从你的 bundle 中 tree-shake 掉。

TypeScript 支持

Widget Light 使用 TypeScript 编写,并提供完整的类型定义。所有配置选项、事件 payload 和处理器接口都是完全类型化的: