跳转到内容

会话生命周期

让应用界面始终与 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'。