跳转到内容

浏览器钱包连接

在 Web 应用中连接 D9 钱包并渲染用户已授权的账户列表。

前置条件: 已安装 @d9-network/dapp-connector@0.2.0,并按 Connector API 配置好 connectorOptions。

<p id="status"></p>
<select id="accounts"></select>

2. 在 D9 钱包内置浏览器中连接(src/main.ts)

Section titled “2. 在 D9 钱包内置浏览器中连接(src/main.ts)”
import { createWebD9Connector } from "@d9-network/dapp-connector/web";
import { connectorOptions } from "./connector";
const connector = createWebD9Connector(connectorOptions);
const statusEl = document.getElementById("status");
const accountsEl = document.getElementById("accounts");
if (!(statusEl instanceof HTMLElement) || !(accountsEl instanceof HTMLSelectElement)) {
throw new Error("页面缺少 #status 或 select#accounts 元素");
}
// 每次连接状态变化时刷新界面
connector.subscribe((snapshot) => {
statusEl.textContent = `状态: ${snapshot.status} (${snapshot.transport ?? "none"})`;
accountsEl.innerHTML = "";
for (const account of snapshot.accounts) {
const opt = document.createElement("option");
opt.value = account.address;
opt.textContent = account.name ? `${account.name} (${account.address.slice(0, 8)}...)` : account.address;
accountsEl.appendChild(opt);
}
});
// 通过注入式提供者连接
export async function connectInjected() {
const isAvailable = await connector.papi.isAvailable();
if (!isAvailable) {
alert("当前浏览器未检测到 D9 钱包注入式提供者。");
return;
}
await connector.papi.connect();
}
export async function disconnect() {
await connector.disconnect();
}

将 connectInjected() 与 disconnect() 绑定到页面按钮的点击事件上。

3. 在其他浏览器中连接(Effect)

Section titled “3. 在其他浏览器中连接(Effect)”

注入式提供者仅存在于 D9 钱包内置浏览器中。在桌面浏览器或普通手机浏览器中,请使用 transport: "auto"。触发 WalletConnect 时,将 uri 渲染为二维码,并将 deepLink 作为 打开 D9 钱包 链接展示:

import { Effect } from "effect";
import { D9DAppConnector } from "@d9-network/dapp-connector";
import { buildD9WalletConnectAppLink } from "@d9-network/dapp-connector/protocol";
import { d9Config } from "./config";
import { walletRuntime } from "./wallet";
export async function connectNative(
onQrUri: (uri: string, deepLink: string) => void,
) {
return walletRuntime.runPromise(
Effect.gen(function* () {
const connector = yield* D9DAppConnector;
const start = yield* connector.connect({ transport: "auto" });
if (start.transport === "walletconnect") {
if (start.uri) {
const deepLink = buildD9WalletConnectAppLink(start.uri, d9Config.walletScheme);
onQrUri(start.uri, deepLink);
}
yield* start.approval;
}
return yield* connector.getAccounts;
}),
);
}

walletRuntime 的创建方式见快速上手。

  • 第 2 步: 用户在钱包批准后,#status 显示 connected,select#accounts 列出已授权账户。
  • 第 3 步: connectNative 返回已授权账户数组,不会直接修改 DOM。
报错信息 处理方式
页面缺少 #status 或 select#accounts 元素 按第 1 步在页面中补全对应 HTML 元素。
弹窗提示 当前浏览器未检测到 D9 钱包注入式提供者 请在 D9 钱包内置浏览器中打开页面,或改用第 3 步的 WalletConnect 流程。