跳转到内容

Connector API

在应用根部初始化一次钱包连接器,即可在整个应用中复用,用于连接钱包、读取已授权账户以及监听状态变化。

前置条件: 已安装 @d9-network/dapp-connector@0.2.0 与 effect@4.0.5(参见 SDK 软件包)。

新建 src/connector.ts,为整个应用创建唯一实例的 Layer:

src/connector.ts
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);
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 返回用户已授权的账户列表。

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})`),
);
});

将 WalletConnect 配对 URI 与钱包 URL scheme 传入 /protocol 导出的 buildD9WalletConnectAppLink:

import { buildD9WalletConnectAppLink } from "@d9-network/dapp-connector/protocol";
const deepLink = buildD9WalletConnectAppLink(start.uri, d9Config.walletScheme);

完整实现请参阅 浏览器钱包连接。

在 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 入口仅包含纯数据工具与 Schema 定义,不会引入任何通道 SDK 依赖:

导出项 用途
serializeD9SiwxMessage 生成标准 CAIP-122 登录消息字符串
D9AuthenticateParamsSchema 解码并校验登录 Challenge(Effect Schema)
D9_WALLET_CONNECT_CHAIN_ID 常量 d9net:000000000000000000000000000000d9