浏览器钱包连接
在 Web 应用中连接 D9 钱包并渲染用户已授权的账户列表。
前置条件: 已安装 @d9-network/dapp-connector@0.2.0,并按 Connector API 配置好 connectorOptions。
1. 添加状态与账户元素
Section titled “1. 添加状态与账户元素”<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 流程。 |
