跳到內容

工作階段生命週期

讓應用程式介面始終與 D9 錢包狀態保持同步:即時顯示目前連線帳戶、在帳戶切換時中止過期操作,並於中斷連線時清理工作階段。

前置條件: 已在應用程式根層級初始化快速上手中的單例 walletRuntime。

透過訂閱 connector.changes 監聽狀態更新(也可使用 Connector API 中基於 Promise 的 /web 介面):

import { useEffect, useState } from "react";
import { Effect, Fiber, Stream } from "effect";
import { D9DAppConnector, type D9ConnectorSnapshot } from "@d9-network/dapp-connector";
import { walletRuntime } from "./wallet";
export function useD9Wallet() {
const [snapshot, setSnapshot] = useState<D9ConnectorSnapshot | null>(null);
useEffect(() => {
const fiber = walletRuntime.runFork(
Effect.gen(function* () {
const connector = yield* D9DAppConnector;
yield* Stream.runForEach(connector.changes, (next) =>
Effect.sync(() => setSnapshot(next)),
);
}),
);
return () => {
void walletRuntime.runPromise(Fiber.interrupt(fiber));
};
}, []);
return {
status: snapshot?.status ?? "disconnected",
transport: snapshot?.transport ?? null,
accounts: snapshot?.accounts ?? [],
selectedAccount: snapshot?.accounts[0] ?? null,
};
}

每次推送的快照包含以下欄位:

欄位 說明
status 'disconnected' | 'connecting' | 'connected' | 'error'
transport 'papi' | 'walletconnect' | null
accounts 已授權的 D9ConnectorAccount 唯讀陣列
session 活躍工作階段控制代碼(僅 WalletConnect 通道)
error 連線異常時填入的錯誤資訊

當使用者在錢包中切換帳戶或撤銷授權時,連接器會推送新快照(並觸發 accountsChanged 事件):

  • 立即捨棄所有尚未送出的交易草稿。
  • 切勿在目前啟用帳戶已切換為帳戶 B 時,廣播先前由帳戶 A 簽署的結果。

3. 在每次簽署彈窗後重新驗證授權

Section titled “3. 在每次簽署彈窗後重新驗證授權”

使用者在錢包確認視窗開啟期間仍可能切換帳戶,因此請在等待簽署前後各驗證一次帳戶授權狀態:

import { Effect } from "effect";
import { D9DAppConnector } from "@d9-network/dapp-connector";
import { walletRuntime } from "./wallet";
async function executeAuthorizedAction(selectedAddress: string) {
return walletRuntime.runPromise(
Effect.gen(function* () {
const connector = yield* D9DAppConnector;
const initialAccounts = yield* connector.getAccounts;
const account = initialAccounts.find((a) => a.address === selectedAddress);
if (!account) {
throw new Error("所選帳戶已不再獲得錢包授權");
}
const result = yield* connector.signMessage({
address: account.address,
message: "Confirm action",
});
// 確認期間帳戶可能已變更,簽署後須再次驗證
const activeAccounts = yield* connector.getAccounts;
if (!activeAccounts.some((a) => a.address === account.address)) {
throw new Error("等待簽署期間帳戶授權已變更");
}
return result;
}),
);
}
  • 若使用者拒絕錢包彈窗,請直接回到閒置狀態,切勿重複彈窗要求。
  • 點擊 登出 或 中斷連線 時呼叫 connector.disconnect,清除瀏覽器本機持久化工作階段並通知錢包端。
  • 中斷連線僅阻止後續新簽署請求,無法撤回已廣播的鏈上交易;已發出的交易請繼續透過交易雜湊追蹤。
  • 在 D9 錢包中切換帳戶,確認介面中的 accounts 清單同步更新。
  • 點擊 中斷連線,確認 status 轉換為 'disconnected'。