会话生命周期
让应用界面始终与 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'。
