Connector API
在应用根部初始化一次钱包连接器,即可在整个应用中复用,用于连接钱包、读取已授权账户以及监听状态变化。
前置条件: 已安装 @d9-network/dapp-connector@0.2.0 与 effect@4.0.5(参见 SDK 软件包)。
1. 创建连接器
Section titled “1. 创建连接器”新建 src/connector.ts,为整个应用创建唯一实例的 Layer:
import { D9DAppConnector } from "@d9-network/dapp-connector";import { d9Config } from "./config";
export const connectorOptions = { dappName: "My D9 DApp", walletConnect: { projectId: d9Config.projectId, relayUrl: d9Config.relayUrl, metadata: { name: "My D9 DApp", description: "My decentralized application", url: window.location.origin, icons: [`${window.location.origin}/icon.png`], }, },};
export const connectorLayer = D9DAppConnector.layer(connectorOptions);2. 连接钱包并读取账户
Section titled “2. 连接钱包并读取账户”import { Effect } from "effect";import { D9DAppConnector } from "@d9-network/dapp-connector";
export const connectProgram = Effect.gen(function* () { const connector = yield* D9DAppConnector; const start = yield* connector.connect({ transport: "auto" });
if (start.transport === "walletconnect") { // 等待批准前,先将 start.uri 渲染为二维码或移动端深链接 yield* start.approval; }
return yield* connector.getAccounts;});start.approval、start.cancel、start.response、connector.snapshot 与 connector.getAccounts 均为 Effect 对象,请使用 yield* 而非 await。
使用基于 connectorLayer 构建的运行时(例如 快速上手 中的 walletRuntime)来执行第 2 步和第 3 步的程序。
验证: getAccounts 返回用户已授权的账户列表。
3. 监听连接状态变化
Section titled “3. 监听连接状态变化”connector.changes 是一个 Effect Stream,订阅后会立即推送当前快照:
import { Effect, Stream } from "effect";import { D9DAppConnector } from "@d9-network/dapp-connector";
export const watchConnectionProgram = Effect.gen(function* () { const connector = yield* D9DAppConnector; yield* Stream.runForEach(connector.changes, (snapshot) => Effect.logInfo(`钱包状态: ${snapshot.status} (${snapshot.transport})`), );});4. 在移动端唤起 D9 钱包
Section titled “4. 在移动端唤起 D9 钱包”将 WalletConnect 配对 URI 与钱包 URL scheme 传入 /protocol 导出的 buildD9WalletConnectAppLink:
import { buildD9WalletConnectAppLink } from "@d9-network/dapp-connector/protocol";
const deepLink = buildD9WalletConnectAppLink(start.uri, d9Config.walletScheme);完整实现请参阅 浏览器钱包连接。
不使用 Effect:/web 封装接口
Section titled “不使用 Effect:/web 封装接口”在 React、Vue 或原生 JavaScript/TypeScript 项目中,可直接调用基于 Promise 的 /web 接口,传入相同的 connectorOptions:
import { createWebD9Connector } from "@d9-network/dapp-connector/web";import { connectorOptions } from "./connector";
export const webConnector = createWebD9Connector(connectorOptions);
// 同步读取当前状态const accounts = webConnector.getAccounts();const snapshot = webConnector.getSnapshot();
// 订阅状态变化const unsubscribe = webConnector.subscribe((nextSnapshot) => { console.log("状态已更新:", nextSnapshot.status);});
// 断开当前会话,或永久关闭连接器await webConnector.disconnect();await webConnector.close();/protocol 导出项
Section titled “/protocol 导出项”/protocol 入口仅包含纯数据工具与 Schema 定义,不会引入任何通道 SDK 依赖:
| 导出项 | 用途 |
|---|---|
serializeD9SiwxMessage |
生成标准 CAIP-122 登录消息字符串 |
D9AuthenticateParamsSchema |
解码并校验登录 Challenge(Effect Schema) |
D9_WALLET_CONNECT_CHAIN_ID |
常量 d9net:000000000000000000000000000000d9 |
