工作階段生命週期
讓應用程式介面始終與 D9 錢包狀態保持同步:即時顯示目前連線帳戶、在帳戶切換時中止過期操作,並於中斷連線時清理工作階段。
前置條件: 已在應用程式根層級初始化快速上手中的單例 walletRuntime。
1. 訂閱連線狀態
Section titled “1. 訂閱連線狀態”透過訂閱 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 |
連線異常時填入的錯誤資訊 |
2. 回應帳戶變更
Section titled “2. 回應帳戶變更”當使用者在錢包中切換帳戶或撤銷授權時,連接器會推送新快照(並觸發 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; }), );}4. 處理取消與中斷連線
Section titled “4. 處理取消與中斷連線”- 若使用者拒絕錢包彈窗,請直接回到閒置狀態,切勿重複彈窗要求。
- 點擊 登出 或 中斷連線 時呼叫
connector.disconnect,清除瀏覽器本機持久化工作階段並通知錢包端。 - 中斷連線僅阻止後續新簽署請求,無法撤回已廣播的鏈上交易;已發出的交易請繼續透過交易雜湊追蹤。
- 在 D9 錢包中切換帳戶,確認介面中的
accounts清單同步更新。 - 點擊 中斷連線,確認
status轉換為'disconnected'。
