跳到內容

瀏覽器錢包連線

在 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 渲染為 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 流程。