@earthworm/wallet-sdk 0.2.0 → 0.2.2

package/README.md

@@ -1,6 +1,6 @@
 # @earthworm/wallet-sdk
 
-Browser EVM wallet SDK for DApps (MetaMask, Coinbase, TronLink, EIP-6963, contract reads).
+Browser EVM wallet SDK for DApps (MetaMask, Coinbase, TronLink, TokenPocket, contract reads).
 
 ## Install
 
@@ -11,14 +11,67 @@ pnpm add @earthworm/wallet-sdk ethers
 ## Usage
 
 ```ts
-import { initWalletSdk, getWalletSdkConfig, walletEvents } from "@earthworm/wallet-sdk";
+import {
+  initWalletSdk,
+  getWalletSdkConfig,
+  walletEvents,
+  setWalletEventProvider,
+  ensureTargetNetwork,
+  requestWallet,
+  resolveMetaMaskInjectedProvider,
+  isEthereumProvider,
+  isCoinbaseProvider,
+  isTokenPocketProvider,
+  isTronLinkProvider,
+} from "@earthworm/wallet-sdk";
 
 initWalletSdk({
-  isMainnet: true, //是否使用测试环境bsc
+  isMainnet: true, // Set to true for mainnet, false for testnet
   contract: { address: "0x...", abi: [] },
 });
 
+// Detect installed wallets
+if (isEthereumProvider()) {
+  console.log("MetaMask is available");
+}
+
+if (isCoinbaseProvider()) {
+  console.log("Coinbase Wallet is available");
+}
+
+if (isTokenPocketProvider()) {
+  console.log("TokenPocket is available");
+}
+
+if (isTronLinkProvider()) {
+  console.log("TronLink is available");
+}
+
+const provider = resolveMetaMaskInjectedProvider();
+setWalletEventProvider(provider ?? null);
+
 walletEvents.on("accountsChanged", (accounts) => {
   console.log(accounts);
 });
+
+walletEvents.on("chainChanged", (chainId) => {
+  console.log("Network changed:", chainId); // hex chainId, e.g. "0x38"
+});
+
+async function switchToConfiguredNetwork() {
+  const provider = resolveMetaMaskInjectedProvider();
+  if (!provider) return;
+
+  const { chainId, chain } = getWalletSdkConfig();
+
+  await ensureTargetNetwork({
+    targetChainId: chainId,
+    getCurrentChainId: () => requestWallet(provider, "eth_chainId") as Promise<string>,
+    switchChain: (chainId) =>
+      requestWallet(provider, "wallet_switchEthereumChain", [{ chainId }]),
+    addChain: (chainParams) =>
+      requestWallet(provider, "wallet_addEthereumChain", [chainParams]),
+    chainParams: chain,
+  });
+}
 ```

package/dist/index.d.ts

@@ -20,6 +20,7 @@ type WalletEventProvider = Eip1193Provider & {
 type InjectedEthereumProvider = WalletEventProvider & {
     isMetaMask?: boolean;
     isCoinbaseWallet?: boolean;
+    isTokenPocket?: boolean;
     isTronLink?: boolean;
     isTronLinkWallet?: boolean;
     providers?: InjectedEthereumProvider[];
@@ -98,6 +99,11 @@ declare function findMetaMaskEip6963Provider(): ethers.Eip1193Provider | undefin
  * @returns Coinbase EIP-1193 provider；未找到为 `undefined`。
  */
 declare function findCoinbaseEip6963Provider(): ethers.Eip1193Provider | undefined;
+/**
+ * 查找 TokenPocket 的 EIP-6963 provider。
+ * @returns TokenPocket EIP-1193 provider；未找到为 `undefined`。
+ */
+declare function findTokenPocketEip6963Provider(): ethers.Eip1193Provider | undefined;
 /**
  * 是否通过 EIP-6963 检测到 MetaMask。
  * @returns 检测到为 `true`，否则 `false`。
@@ -108,6 +114,11 @@ declare function hasMetaMaskEip6963Provider(): boolean;
  * @returns 检测到为 `true`，否则 `false`。
  */
 declare function hasCoinbaseEip6963Provider(): boolean;
+/**
+ * 是否通过 EIP-6963 检测到 TokenPocket。
+ * @returns 检测到为 `true`，否则 `false`。
+ */
+declare function hasTokenPocketEip6963Provider(): boolean;
 
 /**
  * 获取与 EIP-1193 provider 绑定的共享 BrowserProvider（同一实例复用）。
@@ -131,6 +142,11 @@ declare function resolveMetaMaskInjectedProvider(): WalletEventProvider | undefi
  * @returns Coinbase {@link WalletEventProvider}；未找到为 `undefined`。
  */
 declare function resolveCoinbaseInjectedProvider(): WalletEventProvider | undefined;
+/**
+ * 解析 TokenPocket injected provider（tokenpocket.ethereum → EIP-6963 → providers 数组 → 根 ethereum）。
+ * @returns TokenPocket {@link WalletEventProvider}；未找到为 `undefined`。
+ */
+declare function resolveTokenPocketInjectedProvider(): WalletEventProvider | undefined;
 /**
  * 是否检测到 MetaMask injected provider。
  * @returns 检测到为 `true`，否则 `false`。
@@ -141,6 +157,11 @@ declare function hasMetaMaskInjectedProvider(): boolean;
  * @returns 检测到为 `true`，否则 `false`。
  */
 declare function hasCoinbaseInjectedProvider(): boolean;
+/**
+ * 是否检测到 TokenPocket（扩展、tokenpocket.ethereum 或 injected）。
+ * @returns 检测到为 `true`，否则 `false`。
+ */
+declare function hasTokenPocketInjectedProvider(): boolean;
 /**
  * 缓存当前可用的多钱包聚合根 provider（`ethereum.providers.length > 1`）。
  * 非浏览器环境无操作。
@@ -379,6 +400,11 @@ declare function isEthereumProvider(): boolean;
  * @returns 浏览器中检测到 Coinbase 为 `true`；非浏览器或未检测到为 `false`。
  */
 declare function isCoinbaseProvider(): boolean;
+/**
+ * 是否检测到 TokenPocket（injected 或 EIP-6963）。
+ * @returns 浏览器中检测到 TokenPocket 为 `true`；非浏览器或未检测到为 `false`。
+ */
+declare function isTokenPocketProvider(): boolean;
 /**
  * 是否检测到通用 injected 以太坊钱包（含多钱包聚合器）。
  * @returns 浏览器中存在可用 injected provider 为 `true`；否则 `false`。
@@ -560,4 +586,4 @@ declare const ERC20_ABI: ({
     stateMutability?: undefined;
 })[];
 
-export { BSC_NETWORK, BSC_TESTNET_NETWORK, type ChainConfig, type ChainNativeCurrency, type ContractConfig, ERC20_ABI, ERC20_DECIMALS, ERC20_DECIMALS_ABI, type Eip6963ProviderDetail, type Eip6963ProviderInfo, type EthereumRequestParams, type EvmReadProvider, type GetContractReadOptions, type InjectedEthereumProvider, type MutableRef, USDT_CONFIG, USDT_CONTRACT_ADDRESSES, type WalletEventProvider, type WalletEvents, type WalletProviderEventListener, type WalletProviderEventMap, type WalletProviderEventName, type WalletSdkConfig, type WalletSdkInitOptions, assertBrowser, bindBrowserProvider, clearWalletRuntime, connectWalletAccount, createJsonRpcReadProvider, discoverWalletProviders, ensureTargetNetwork, findCoinbaseEip6963Provider, findDiscoveredProvider, findMetaMaskEip6963Provider, getAggregatedInjectedProvider, getConfiguredReadProvider, getContractDecimals, getContractPrice, getInjectedEthereumProviders, getReadProviderWithFallback, getSharedBrowserProvider, getWalletEventProvider, getWalletSdkConfig, hasAggregatedInjectedProvider, hasCoinbaseEip6963Provider, hasCoinbaseInjectedProvider, hasDeployedContract, hasMetaMaskEip6963Provider, hasMetaMaskInjectedProvider, hasRecoverableAggregatorProvider, initWalletSdk, isBrowser, isCoinbaseProvider, isContractDeployed, isEthereumProvider, isInjectedProvider, isTronLinkProvider, isWalletSdkInitialized, readErc20Decimals, rememberAggregatorProvider, requestWallet, resetWalletSdkConfig, resolveChainByMainnet, resolveChainConfig, resolveCoinbaseInjectedProvider, resolveMetaMaskInjectedProvider, resolveUsdtByMainnet, resolveUsdtContractAddress, setWalletEventProvider, setWalletReadProvider, syncWalletAccountAddress, toChainIdDecimal, walletEvents };
+export { BSC_NETWORK, BSC_TESTNET_NETWORK, type ChainConfig, type ChainNativeCurrency, type ContractConfig, ERC20_ABI, ERC20_DECIMALS, ERC20_DECIMALS_ABI, type Eip6963ProviderDetail, type Eip6963ProviderInfo, type EthereumRequestParams, type EvmReadProvider, type GetContractReadOptions, type InjectedEthereumProvider, type MutableRef, USDT_CONFIG, USDT_CONTRACT_ADDRESSES, type WalletEventProvider, type WalletEvents, type WalletProviderEventListener, type WalletProviderEventMap, type WalletProviderEventName, type WalletSdkConfig, type WalletSdkInitOptions, assertBrowser, bindBrowserProvider, clearWalletRuntime, connectWalletAccount, createJsonRpcReadProvider, discoverWalletProviders, ensureTargetNetwork, findCoinbaseEip6963Provider, findDiscoveredProvider, findMetaMaskEip6963Provider, findTokenPocketEip6963Provider, getAggregatedInjectedProvider, getConfiguredReadProvider, getContractDecimals, getContractPrice, getInjectedEthereumProviders, getReadProviderWithFallback, getSharedBrowserProvider, getWalletEventProvider, getWalletSdkConfig, hasAggregatedInjectedProvider, hasCoinbaseEip6963Provider, hasCoinbaseInjectedProvider, hasDeployedContract, hasMetaMaskEip6963Provider, hasMetaMaskInjectedProvider, hasRecoverableAggregatorProvider, hasTokenPocketEip6963Provider, hasTokenPocketInjectedProvider, initWalletSdk, isBrowser, isCoinbaseProvider, isContractDeployed, isEthereumProvider, isInjectedProvider, isTokenPocketProvider, isTronLinkProvider, isWalletSdkInitialized, readErc20Decimals, rememberAggregatorProvider, requestWallet, resetWalletSdkConfig, resolveChainByMainnet, resolveChainConfig, resolveCoinbaseInjectedProvider, resolveMetaMaskInjectedProvider, resolveTokenPocketInjectedProvider, resolveUsdtByMainnet, resolveUsdtContractAddress, setWalletEventProvider, setWalletReadProvider, syncWalletAccountAddress, toChainIdDecimal, walletEvents };

package/dist/index.js

@@ -19,6 +19,7 @@ function assertBrowser(apiName) {
 // src/wallet/eip6963.ts
 var METAMASK_RDNS = "io.metamask";
 var COINBASE_RDNS = "com.coinbase.wallet";
+var TOKENPOCKET_RDNS = "com.tokenpocket";
 var discoveredProviders = [];
 var discoveryPromise = null;
 function discoverWalletProviders(timeoutMs = 500) {
@@ -59,12 +60,20 @@ function findCoinbaseEip6963Provider() {
     (detail) => detail.info.rdns === COINBASE_RDNS || detail.info.name.toLowerCase().includes("coinbase")
   );
 }
+function findTokenPocketEip6963Provider() {
+  return findDiscoveredProvider(
+    (detail) => detail.info.rdns === TOKENPOCKET_RDNS || detail.info.name.toLowerCase().includes("tokenpocket")
+  );
+}
 function hasMetaMaskEip6963Provider() {
   return Boolean(findMetaMaskEip6963Provider());
 }
 function hasCoinbaseEip6963Provider() {
   return Boolean(findCoinbaseEip6963Provider());
 }
+function hasTokenPocketEip6963Provider() {
+  return Boolean(findTokenPocketEip6963Provider());
+}
 var providerCache = /* @__PURE__ */ new WeakMap();
 function getSharedBrowserProvider(ethereum) {
   const cached = providerCache.get(ethereum);
@@ -96,6 +105,9 @@ var isMetaMaskLikeProvider = (provider) => {
 var isCoinbaseLikeProvider = (provider) => {
   return Boolean(provider.isCoinbaseWallet && !provider.isTronLink && !provider.isTronLinkWallet);
 };
+var isTokenPocketLikeProvider = (provider) => {
+  return Boolean(provider.isTokenPocket && !provider.isTronLink && !provider.isTronLinkWallet);
+};
 var isTronLinkLikeProvider = (provider) => {
   return Boolean(provider.isTronLink || provider.isTronLinkWallet);
 };
@@ -163,6 +175,24 @@ function resolveCoinbaseInjectedProvider() {
   }
   return void 0;
 }
+function resolveTokenPocketInjectedProvider() {
+  if (isRequestableProvider(window.tokenpocket?.ethereum)) {
+    return window.tokenpocket.ethereum;
+  }
+  const fromEip6963 = findTokenPocketEip6963Provider();
+  if (fromEip6963 && isRequestableProvider(fromEip6963)) {
+    return fromEip6963;
+  }
+  const fromProviders = getInjectedEthereumProviders().find(isTokenPocketLikeProvider);
+  if (fromProviders) {
+    return fromProviders;
+  }
+  const ethereum = window.ethereum;
+  if (ethereum && isTokenPocketLikeProvider(ethereum)) {
+    return ethereum;
+  }
+  return void 0;
+}
 function hasMetaMaskInjectedProvider() {
   return Boolean(resolveMetaMaskInjectedProvider());
 }
@@ -171,6 +201,9 @@ function hasCoinbaseInjectedProvider() {
     window.coinbaseWalletExtension || window.coinbaseWalletRequestProvider || window.coinbaseSolana || resolveCoinbaseInjectedProvider()
   );
 }
+function hasTokenPocketInjectedProvider() {
+  return Boolean(resolveTokenPocketInjectedProvider());
+}
 var cachedAggregatorProvider;
 var cachedAggregatorProviderCount = 0;
 var isMultiWalletAggregator = (provider) => {
@@ -872,6 +905,10 @@ function isCoinbaseProvider() {
   if (!isBrowser) return false;
   return hasCoinbaseInjectedProvider();
 }
+function isTokenPocketProvider() {
+  if (!isBrowser) return false;
+  return hasTokenPocketInjectedProvider() || hasTokenPocketEip6963Provider();
+}
 function isInjectedProvider() {
   if (!isBrowser) return false;
   return hasAggregatedInjectedProvider();
@@ -881,4 +918,4 @@ function isTronLinkProvider() {
   return Boolean(window.tron?.request || window.tronLink);
 }
 
-export { BSC_NETWORK, BSC_TESTNET_NETWORK, ERC20_ABI, ERC20_DECIMALS, ERC20_DECIMALS_ABI, USDT_CONFIG, USDT_CONTRACT_ADDRESSES, assertBrowser, bindBrowserProvider, clearWalletRuntime, connectWalletAccount, createJsonRpcReadProvider, discoverWalletProviders, ensureTargetNetwork, findCoinbaseEip6963Provider, findDiscoveredProvider, findMetaMaskEip6963Provider, getAggregatedInjectedProvider, getConfiguredReadProvider, getContractDecimals, getContractPrice, getInjectedEthereumProviders, getReadProviderWithFallback, getSharedBrowserProvider, getWalletEventProvider, getWalletSdkConfig, hasAggregatedInjectedProvider, hasCoinbaseEip6963Provider, hasCoinbaseInjectedProvider, hasDeployedContract, hasMetaMaskEip6963Provider, hasMetaMaskInjectedProvider, hasRecoverableAggregatorProvider, initWalletSdk, isBrowser, isCoinbaseProvider, isContractDeployed, isEthereumProvider, isInjectedProvider, isTronLinkProvider, isWalletSdkInitialized, readErc20Decimals, rememberAggregatorProvider, requestWallet, resetWalletSdkConfig, resolveChainByMainnet, resolveChainConfig, resolveCoinbaseInjectedProvider, resolveMetaMaskInjectedProvider, resolveUsdtByMainnet, resolveUsdtContractAddress, setWalletEventProvider, setWalletReadProvider, syncWalletAccountAddress, toChainIdDecimal, walletEvents };
+export { BSC_NETWORK, BSC_TESTNET_NETWORK, ERC20_ABI, ERC20_DECIMALS, ERC20_DECIMALS_ABI, USDT_CONFIG, USDT_CONTRACT_ADDRESSES, assertBrowser, bindBrowserProvider, clearWalletRuntime, connectWalletAccount, createJsonRpcReadProvider, discoverWalletProviders, ensureTargetNetwork, findCoinbaseEip6963Provider, findDiscoveredProvider, findMetaMaskEip6963Provider, findTokenPocketEip6963Provider, getAggregatedInjectedProvider, getConfiguredReadProvider, getContractDecimals, getContractPrice, getInjectedEthereumProviders, getReadProviderWithFallback, getSharedBrowserProvider, getWalletEventProvider, getWalletSdkConfig, hasAggregatedInjectedProvider, hasCoinbaseEip6963Provider, hasCoinbaseInjectedProvider, hasDeployedContract, hasMetaMaskEip6963Provider, hasMetaMaskInjectedProvider, hasRecoverableAggregatorProvider, hasTokenPocketEip6963Provider, hasTokenPocketInjectedProvider, initWalletSdk, isBrowser, isCoinbaseProvider, isContractDeployed, isEthereumProvider, isInjectedProvider, isTokenPocketProvider, isTronLinkProvider, isWalletSdkInitialized, readErc20Decimals, rememberAggregatorProvider, requestWallet, resetWalletSdkConfig, resolveChainByMainnet, resolveChainConfig, resolveCoinbaseInjectedProvider, resolveMetaMaskInjectedProvider, resolveTokenPocketInjectedProvider, resolveUsdtByMainnet, resolveUsdtContractAddress, setWalletEventProvider, setWalletReadProvider, syncWalletAccountAddress, toChainIdDecimal, walletEvents };

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "@earthworm/wallet-sdk",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "EVM wallet utilities for browser DApps",
   "type": "module",
   "sideEffects": false,
+  "engines": {
+    "node": ">=20.0.0"
+  },
   "publishConfig": {
     "access": "public"
   },
@@ -21,10 +24,10 @@
   },
   "keywords": [
     "ethereum",
-    "wallet",
-    "eip6963",
     "ethers",
-    "dapp"
+    "dapp",
+    "wallets",
+    "bsc"
   ],
   "license": "MIT",
   "author": "Alex",