@earthworm/wallet-sdk 0.2.6 → 0.2.7

package/README.md

@@ -40,6 +40,44 @@ await disconnectWallet();
 
 `connectWallet()` binds the provider and registers event listeners internally. You do not need to call `setWalletEventProvider()` separately after connect.
 
+## Restore session on page load
+
+Some mobile wallets (e.g. TokenPocket App) **reload the page** when the user switches address. After reload, in-memory SDK state is lost even though the wallet still has an authorized session.
+
+Call `restoreWalletConnection()` during initialization. It uses `eth_accounts` (no authorization popup). If authorized accounts exist, it binds the provider, restores the signer, and optionally switches chain — same as `connectWallet()` but without `eth_requestAccounts`.
+
+```ts
+import {
+  initWalletSdk,
+  restoreWalletConnection,
+  isWalletConnected,
+  resolveTokenPocketInjectedProvider,
+} from "@earthworm/wallet-sdk";
+
+initWalletSdk({
+  usdt: { address: "0x55d398326f99059fF775485246999027B3197955" },
+});
+
+const provider = resolveTokenPocketInjectedProvider();
+if (provider) {
+  const session = await restoreWalletConnection(provider, { chainId: "0x38" });
+  if (session) {
+    console.log("Session restored:", session.address);
+  }
+}
+
+console.log("Connected:", isWalletConnected());
+```
+
+| API                         | RPC                   | Popup      | Use when                                        |
+| --------------------------- | --------------------- | ---------- | ----------------------------------------------- |
+| `connectWallet()`           | `eth_requestAccounts` | May prompt | User clicks Connect                             |
+| `restoreWalletConnection()` | `eth_accounts`        | No         | Page load / refresh with existing authorization |
+
+Returns `null` when no authorized accounts are found. Event listeners are registered the same way as `connectWallet()`.
+
+**Tip:** Persist which wallet the user selected (e.g. `localStorage`) so after reload you know which `resolve*InjectedProvider()` to pass in.
+
 ## Wallet detection
 
 ```ts
@@ -129,12 +167,3 @@ import { switchToConfiguredNetwork } from "@earthworm/wallet-sdk";
 
 await switchToConfiguredNetwork("0x38"); // BSC mainnet
 ```
-
-## Demo
-
-```bash
-pnpm run build
-pnpm run demo
-```
-
-Open http://localhost:5173 and test connect, disconnect, account switch, and the event log.

package/dist/{account-sync-GCHF7QJT.js → account-sync-IFXUYW65.js}

@@ -1,2 +1,2 @@
-export { applyTronLinkAccountResolution, applyVerifiedAccountResolution, applyWalletAccountsChangedEffect, applyWalletDisconnectEffect } from './chunk-M4PEE6H7.js';
-import './chunk-YFNGF2E3.js';
+export { applyTronLinkAccountResolution, applyVerifiedAccountResolution, applyWalletAccountsChangedEffect, applyWalletDisconnectEffect } from './chunk-54NIXGDN.js';
+import './chunk-X6TWVXK3.js';

package/dist/{chunk-M4PEE6H7.js → chunk-54NIXGDN.js}

@@ -1,4 +1,4 @@
-import { getSelectedWalletProvider, isWalletConnected, disconnectWallet, ensureWalletRuntimeProviderBound, syncConnectedWalletAccount, getWalletAccounts } from './chunk-YFNGF2E3.js';
+import { getSelectedWalletProvider, isWalletConnected, disconnectWallet, ensureWalletRuntimeProviderBound, syncConnectedWalletAccount, getWalletAccounts } from './chunk-X6TWVXK3.js';
 
 // src/wallet/account-sync.ts
 async function syncWalletAccount(address) {

package/dist/{chunk-TZWW7JTY.js → chunk-5CET43HT.js}

@@ -1,4 +1,4 @@
-import { getWalletEventProvider, resolveChainConfig, requestWallet, syncWalletRuntimeProvider, emitWalletEvent, getActiveWalletKey } from './chunk-YFNGF2E3.js';
+import { getWalletEventProvider, resolveChainConfig, requestWallet, syncWalletRuntimeProvider, emitWalletEvent, getActiveWalletKey } from './chunk-X6TWVXK3.js';
 
 // src/core/network.ts
 async function ensureTargetNetwork(options) {

package/dist/{chunk-YFNGF2E3.js → chunk-X6TWVXK3.js}

@@ -804,14 +804,14 @@ function collectTronLinkEventProviders(primary) {
   return providers;
 }
 async function ensureWalletEventBinding() {
-  const { getSelectedWalletProvider: getSelectedWalletProvider2 } = await import('./runtime-7KOICQLR.js');
+  const { getSelectedWalletProvider: getSelectedWalletProvider2 } = await import('./runtime-2TGIPXVJ.js');
   const selected = getSelectedWalletProvider2();
   if (selected && !walletEventProvider) {
     setWalletEventProvider(selected);
   }
 }
 async function handleVerifiedAccountEvent(wallet, nativeEvent) {
-  const { applyVerifiedAccountResolution } = await import('./account-sync-GCHF7QJT.js');
+  const { applyVerifiedAccountResolution } = await import('./account-sync-IFXUYW65.js');
   const result = await applyVerifiedAccountResolution(nativeEvent.payload);
   if (result.action === "synced" && result.address) {
     await ensureWalletEventBinding();
@@ -853,7 +853,7 @@ function unbindTronLinkLegacyMessages() {
   tronLinkMessageListener = null;
 }
 async function handleWalletDisconnect(wallet, nativeEvent) {
-  const { applyWalletDisconnectEffect } = await import('./account-sync-GCHF7QJT.js');
+  const { applyWalletDisconnectEffect } = await import('./account-sync-IFXUYW65.js');
   const result = await applyWalletDisconnectEffect();
   if (result.action === "disconnected") {
     dispatch("walletDisconnected", wallet, nativeEvent);
@@ -883,7 +883,7 @@ async function handleAccountsChanged(wallet, nativeEvent) {
     }
     return;
   }
-  const { applyWalletAccountsChangedEffect } = await import('./account-sync-GCHF7QJT.js');
+  const { applyWalletAccountsChangedEffect } = await import('./account-sync-IFXUYW65.js');
   const result = await applyWalletAccountsChangedEffect(wallet, nativeEvent.payload);
   if (result.action !== "synced" || !result.address) {
     return;
@@ -944,7 +944,7 @@ function syncTronLinkExtras(adapter, wallet) {
     unbindTronLinkAuxiliaryProviders();
     return;
   }
-  void import('./runtime-7KOICQLR.js').then(({ getSelectedWalletProvider: getSelectedWalletProvider2 }) => {
+  void import('./runtime-2TGIPXVJ.js').then(({ getSelectedWalletProvider: getSelectedWalletProvider2 }) => {
     const selected = getSelectedWalletProvider2();
     const selectedKey = selected ? resolveWalletKey(selected) : "unknown";
     const eventKey = walletEventProvider ? resolveWalletKey(walletEventProvider) : "unknown";
@@ -1155,7 +1155,39 @@ async function connectWallet(eip1193, options = {}) {
     }
   );
   if (options.chainId && isActiveConnectionSession(runtime, session)) {
-    const { switchToConfiguredNetwork } = await import('./network-72KB2UUH.js');
+    const { switchToConfiguredNetwork } = await import('./network-5HQK32UU.js');
+    await switchToConfiguredNetwork(options.chainId);
+  }
+  return result;
+}
+async function restoreWalletConnection(eip1193, options = {}) {
+  const accounts = normalizeWalletAccounts(await requestWallet(eip1193, "eth_accounts"));
+  if (!accounts.length) {
+    return null;
+  }
+  bindWalletProvider(eip1193);
+  const runtime = getRuntimeStore();
+  const session = runtime.connectionSession;
+  const result = await syncWalletAccountAddress(
+    () => {
+      const provider = getRuntimeStore().provider;
+      if (!provider) {
+        throw new Error("[wallet-sdk] Wallet provider is not bound");
+      }
+      return provider;
+    },
+    (signer) => {
+      if (!isActiveConnectionSession(runtime, session)) return;
+      runtime.signer = signer;
+    },
+    () => {
+      if (!isActiveConnectionSession(runtime, session)) return;
+      runtime.connected = true;
+    },
+    accounts[0]
+  );
+  if (options.chainId && isActiveConnectionSession(runtime, session)) {
+    const { switchToConfiguredNetwork } = await import('./network-5HQK32UU.js');
     await switchToConfiguredNetwork(options.chainId);
   }
   return result;
@@ -1288,4 +1320,4 @@ async function disconnectWallet(options) {
   return { revoked };
 }
 
-export { BSC_NETWORK, BSC_TESTNET_NETWORK, ERC20_ABI, ERC20_DECIMALS, ERC20_DECIMALS_ABI, SUPPORTED_BSC_CHAIN_IDS, USDT_CONFIG, WalletEvents, assertBrowser, bindBrowserProvider, bindWalletProvider, clearJsonRpcReadProviderCache, clearWalletRuntime, connectWallet, connectWalletAccount, createJsonRpcReadProvider, disconnectWallet, emitWalletEvent, ensureWalletRuntimeProviderBound, getActiveWalletKey, getConfiguredReadProvider, getConnectedAddress, getContractDecimals, getContractPrice, getReadProviderWithFallback, getSelectedWalletProvider, getSharedBrowserProvider, getWalletAccounts, getWalletBrowserProvider, getWalletEventProvider, getWalletSdkConfig, getWalletSigner, hasDeployedContract, initWalletSdk, isBrowser, isContractDeployed, isWalletConnected, isWalletSdkInitialized, normalizeSupportedBscChainId, readConfiguredUsdtDecimals, readErc20Balance, readErc20Decimals, readUsdtBalance, refreshWalletAccounts, refreshWalletReadProvider, requestWallet, resetWalletSdkConfig, resolveChainConfig, resolveWalletKey, setWalletEventProvider, setWalletReadProvider, switchWalletAccount, syncConnectedWalletAccount, syncWalletAccountAddress, syncWalletRuntimeProvider, toChainIdDecimal, walletEvents };
+export { BSC_NETWORK, BSC_TESTNET_NETWORK, ERC20_ABI, ERC20_DECIMALS, ERC20_DECIMALS_ABI, SUPPORTED_BSC_CHAIN_IDS, USDT_CONFIG, WalletEvents, assertBrowser, bindBrowserProvider, bindWalletProvider, clearJsonRpcReadProviderCache, clearWalletRuntime, connectWallet, connectWalletAccount, createJsonRpcReadProvider, disconnectWallet, emitWalletEvent, ensureWalletRuntimeProviderBound, getActiveWalletKey, getConfiguredReadProvider, getConnectedAddress, getContractDecimals, getContractPrice, getReadProviderWithFallback, getSelectedWalletProvider, getSharedBrowserProvider, getWalletAccounts, getWalletBrowserProvider, getWalletEventProvider, getWalletSdkConfig, getWalletSigner, hasDeployedContract, initWalletSdk, isBrowser, isContractDeployed, isWalletConnected, isWalletSdkInitialized, normalizeSupportedBscChainId, readConfiguredUsdtDecimals, readErc20Balance, readErc20Decimals, readUsdtBalance, refreshWalletAccounts, refreshWalletReadProvider, requestWallet, resetWalletSdkConfig, resolveChainConfig, resolveWalletKey, restoreWalletConnection, setWalletEventProvider, setWalletReadProvider, switchWalletAccount, syncConnectedWalletAccount, syncWalletAccountAddress, syncWalletRuntimeProvider, toChainIdDecimal, walletEvents };

package/dist/index.d.ts

@@ -489,6 +489,15 @@ declare function connectWallet(eip1193: WalletEventProvider, options?: ConnectWa
     address: string;
     signer: JsonRpcSigner;
 }>;
+/**
+ * @en Restore wallet connection from an existing authorized session (`eth_accounts`, no auth prompt).
+ * @zh 从已有授权会话恢复钱包连接（`eth_accounts`，不弹授权窗）。
+ * @returns @en `{ address, signer }` when a session exists; `null` when no authorized accounts. @zh 有授权账户时返回 `{ address, signer }`，否则 `null`。
+ */
+declare function restoreWalletConnection(eip1193: WalletEventProvider, options?: ConnectWalletOptions): Promise<{
+    address: string;
+    signer: JsonRpcSigner;
+} | null>;
 /**
  * @en Sync the connected wallet signer.
  * @zh 同步已连接钱包的 signer。
@@ -792,4 +801,4 @@ declare const ERC20_ABI: ({
     stateMutability?: undefined;
 })[];
 
-export { BSC_NETWORK, BSC_TESTNET_NETWORK, type ChainConfig, type ChainNativeCurrency, type ConnectWalletOptions, type DisconnectWalletOptions, type DisconnectWalletResult, ERC20_ABI, ERC20_DECIMALS, ERC20_DECIMALS_ABI, type Eip6963ProviderDetail, type Eip6963ProviderInfo, type Erc20BalanceResult, type EthereumRequestParams, type EvmReadProvider, type GetConfiguredReadProviderOptions, type GetContractReadOptions, type InjectedEthereumProvider, type MutableRef, type NetworkSwitchResult, SUPPORTED_BSC_CHAIN_IDS, type SupportedBscChainId, type SupportedWalletKey, USDT_CONFIG, type UsdtInitConfig, Wallet6963Name, Wallet6963Rdns, type WalletAccountsSyncResult, type WalletDisconnectPayload, type WalletEventProvider, WalletEvents, type WalletNativeEvent, type WalletScopedEventListener, type WalletSdkConfig, type WalletSdkEventMap, type WalletSdkEventName, type WalletSdkInitOptions, applyWalletAccountsChangedEffect, assertBrowser, bindBrowserProvider, bindWalletProvider, clearJsonRpcReadProviderCache, clearWalletRuntime, connectWallet, connectWalletAccount, createJsonRpcReadProvider, disconnectWallet, discoverWalletProviders, emitWalletEvent, ensureTargetNetwork, ensureWalletRuntimeProviderBound, findCoinbaseEip6963Provider, findDiscoveredProvider, findMetaMaskEip6963Provider, findTokenPocketEip6963Provider, findTronLinkEip6963Provider, getActiveWalletKey, getAggregatedInjectedProvider, getConfiguredReadProvider, getConnectedAddress, getContractDecimals, getContractPrice, getInjectedEthereumProviders, getReadProviderWithFallback, getSelectedWalletProvider, getSharedBrowserProvider, getWalletAccounts, getWalletBrowserProvider, getWalletEventProvider, getWalletSdkConfig, getWalletSigner, hasAggregatedInjectedProvider, hasCoinbaseEip6963Provider, hasCoinbaseInjectedProvider, hasDeployedContract, hasMetaMaskEip6963Provider, hasMetaMaskInjectedProvider, hasRecoverableAggregatorProvider, hasTokenPocketEip6963Provider, hasTokenPocketInjectedProvider, hasTronLinkEip6963Provider, hasTronLinkInjectedProvider, initWalletSdk, isBrowser, isCoinbaseProvider, isContractDeployed, isEthereumProvider, isInjectedProvider, isTokenPocketProvider, isTronLinkProvider, isWalletConnected, isWalletSdkInitialized, normalizeSupportedBscChainId, readConfiguredUsdtDecimals, readErc20Balance, readErc20Decimals, readUsdtBalance, refreshWalletAccounts, refreshWalletReadProvider, rememberAggregatorProvider, requestWallet, resetWalletSdkConfig, resolveChainConfig, resolveCoinbaseInjectedProvider, resolveMetaMaskInjectedProvider, resolveTokenPocketInjectedProvider, resolveTronLinkInjectedProvider, resolveWalletKey, setWalletEventProvider, setWalletReadProvider, switchToConfiguredNetwork, switchWalletAccount, syncConnectedWalletAccount, syncWalletAccountAddress, syncWalletRuntimeProvider, toChainIdDecimal, walletEvents };
+export { BSC_NETWORK, BSC_TESTNET_NETWORK, type ChainConfig, type ChainNativeCurrency, type ConnectWalletOptions, type DisconnectWalletOptions, type DisconnectWalletResult, ERC20_ABI, ERC20_DECIMALS, ERC20_DECIMALS_ABI, type Eip6963ProviderDetail, type Eip6963ProviderInfo, type Erc20BalanceResult, type EthereumRequestParams, type EvmReadProvider, type GetConfiguredReadProviderOptions, type GetContractReadOptions, type InjectedEthereumProvider, type MutableRef, type NetworkSwitchResult, SUPPORTED_BSC_CHAIN_IDS, type SupportedBscChainId, type SupportedWalletKey, USDT_CONFIG, type UsdtInitConfig, Wallet6963Name, Wallet6963Rdns, type WalletAccountsSyncResult, type WalletDisconnectPayload, type WalletEventProvider, WalletEvents, type WalletNativeEvent, type WalletScopedEventListener, type WalletSdkConfig, type WalletSdkEventMap, type WalletSdkEventName, type WalletSdkInitOptions, applyWalletAccountsChangedEffect, assertBrowser, bindBrowserProvider, bindWalletProvider, clearJsonRpcReadProviderCache, clearWalletRuntime, connectWallet, connectWalletAccount, createJsonRpcReadProvider, disconnectWallet, discoverWalletProviders, emitWalletEvent, ensureTargetNetwork, ensureWalletRuntimeProviderBound, findCoinbaseEip6963Provider, findDiscoveredProvider, findMetaMaskEip6963Provider, findTokenPocketEip6963Provider, findTronLinkEip6963Provider, getActiveWalletKey, getAggregatedInjectedProvider, getConfiguredReadProvider, getConnectedAddress, getContractDecimals, getContractPrice, getInjectedEthereumProviders, getReadProviderWithFallback, getSelectedWalletProvider, getSharedBrowserProvider, getWalletAccounts, getWalletBrowserProvider, getWalletEventProvider, getWalletSdkConfig, getWalletSigner, hasAggregatedInjectedProvider, hasCoinbaseEip6963Provider, hasCoinbaseInjectedProvider, hasDeployedContract, hasMetaMaskEip6963Provider, hasMetaMaskInjectedProvider, hasRecoverableAggregatorProvider, hasTokenPocketEip6963Provider, hasTokenPocketInjectedProvider, hasTronLinkEip6963Provider, hasTronLinkInjectedProvider, initWalletSdk, isBrowser, isCoinbaseProvider, isContractDeployed, isEthereumProvider, isInjectedProvider, isTokenPocketProvider, isTronLinkProvider, isWalletConnected, isWalletSdkInitialized, normalizeSupportedBscChainId, readConfiguredUsdtDecimals, readErc20Balance, readErc20Decimals, readUsdtBalance, refreshWalletAccounts, refreshWalletReadProvider, rememberAggregatorProvider, requestWallet, resetWalletSdkConfig, resolveChainConfig, resolveCoinbaseInjectedProvider, resolveMetaMaskInjectedProvider, resolveTokenPocketInjectedProvider, resolveTronLinkInjectedProvider, resolveWalletKey, restoreWalletConnection, setWalletEventProvider, setWalletReadProvider, switchToConfiguredNetwork, switchWalletAccount, syncConnectedWalletAccount, syncWalletAccountAddress, syncWalletRuntimeProvider, toChainIdDecimal, walletEvents };

package/dist/index.js

@@ -1,7 +1,7 @@
-export { applyWalletAccountsChangedEffect } from './chunk-M4PEE6H7.js';
-export { ensureTargetNetwork, switchToConfiguredNetwork } from './chunk-TZWW7JTY.js';
-import { isBrowser } from './chunk-YFNGF2E3.js';
-export { BSC_NETWORK, BSC_TESTNET_NETWORK, ERC20_ABI, ERC20_DECIMALS, ERC20_DECIMALS_ABI, SUPPORTED_BSC_CHAIN_IDS, USDT_CONFIG, WalletEvents, assertBrowser, bindBrowserProvider, bindWalletProvider, clearJsonRpcReadProviderCache, clearWalletRuntime, connectWallet, connectWalletAccount, createJsonRpcReadProvider, disconnectWallet, emitWalletEvent, ensureWalletRuntimeProviderBound, getActiveWalletKey, getConfiguredReadProvider, getConnectedAddress, getContractDecimals, getContractPrice, getReadProviderWithFallback, getSelectedWalletProvider, getSharedBrowserProvider, getWalletAccounts, getWalletBrowserProvider, getWalletEventProvider, getWalletSdkConfig, getWalletSigner, hasDeployedContract, initWalletSdk, isBrowser, isContractDeployed, isWalletConnected, isWalletSdkInitialized, normalizeSupportedBscChainId, readConfiguredUsdtDecimals, readErc20Balance, readErc20Decimals, readUsdtBalance, refreshWalletAccounts, refreshWalletReadProvider, requestWallet, resetWalletSdkConfig, resolveChainConfig, resolveWalletKey, setWalletEventProvider, setWalletReadProvider, switchWalletAccount, syncConnectedWalletAccount, syncWalletAccountAddress, syncWalletRuntimeProvider, toChainIdDecimal, walletEvents } from './chunk-YFNGF2E3.js';
+export { applyWalletAccountsChangedEffect } from './chunk-54NIXGDN.js';
+export { ensureTargetNetwork, switchToConfiguredNetwork } from './chunk-5CET43HT.js';
+import { isBrowser } from './chunk-X6TWVXK3.js';
+export { BSC_NETWORK, BSC_TESTNET_NETWORK, ERC20_ABI, ERC20_DECIMALS, ERC20_DECIMALS_ABI, SUPPORTED_BSC_CHAIN_IDS, USDT_CONFIG, WalletEvents, assertBrowser, bindBrowserProvider, bindWalletProvider, clearJsonRpcReadProviderCache, clearWalletRuntime, connectWallet, connectWalletAccount, createJsonRpcReadProvider, disconnectWallet, emitWalletEvent, ensureWalletRuntimeProviderBound, getActiveWalletKey, getConfiguredReadProvider, getConnectedAddress, getContractDecimals, getContractPrice, getReadProviderWithFallback, getSelectedWalletProvider, getSharedBrowserProvider, getWalletAccounts, getWalletBrowserProvider, getWalletEventProvider, getWalletSdkConfig, getWalletSigner, hasDeployedContract, initWalletSdk, isBrowser, isContractDeployed, isWalletConnected, isWalletSdkInitialized, normalizeSupportedBscChainId, readConfiguredUsdtDecimals, readErc20Balance, readErc20Decimals, readUsdtBalance, refreshWalletAccounts, refreshWalletReadProvider, requestWallet, resetWalletSdkConfig, resolveChainConfig, resolveWalletKey, restoreWalletConnection, setWalletEventProvider, setWalletReadProvider, switchWalletAccount, syncConnectedWalletAccount, syncWalletAccountAddress, syncWalletRuntimeProvider, toChainIdDecimal, walletEvents } from './chunk-X6TWVXK3.js';
 
 // src/wallet/eip6963.ts
 var EIP6963_ANNOUNCE = "eip6963:announceProvider";

package/dist/{network-72KB2UUH.js → network-5HQK32UU.js}

@@ -1,2 +1,2 @@
-export { ensureTargetNetwork, switchToConfiguredNetwork } from './chunk-TZWW7JTY.js';
-import './chunk-YFNGF2E3.js';
+export { ensureTargetNetwork, switchToConfiguredNetwork } from './chunk-5CET43HT.js';
+import './chunk-X6TWVXK3.js';

package/dist/{runtime-7KOICQLR.js → runtime-2TGIPXVJ.js}

@@ -1 +1 @@
-export { bindWalletProvider, connectWallet, disconnectWallet, ensureWalletRuntimeProviderBound, getConnectedAddress, getSelectedWalletProvider, getWalletAccounts, getWalletBrowserProvider, getWalletSigner, isWalletConnected, refreshWalletAccounts, switchWalletAccount, syncConnectedWalletAccount, syncWalletRuntimeProvider } from './chunk-YFNGF2E3.js';
+export { bindWalletProvider, connectWallet, disconnectWallet, ensureWalletRuntimeProviderBound, getConnectedAddress, getSelectedWalletProvider, getWalletAccounts, getWalletBrowserProvider, getWalletSigner, isWalletConnected, refreshWalletAccounts, restoreWalletConnection, switchWalletAccount, syncConnectedWalletAccount, syncWalletRuntimeProvider } from './chunk-X6TWVXK3.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@earthworm/wallet-sdk",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "EVM wallet utilities for browser DApps",
   "type": "module",
   "sideEffects": false,