瀏覽器錢包連線
在 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 渲染為 QR Code,並將 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 流程。 |
