@wangjinbao/wallet-connect 0.1.0

package/dist/esm/types/types/wallet.d.ts

@@ -0,0 +1,89 @@
+/**
+ * 基于 EIP-1193 的以太坊提供者接口
+ */
+export interface EthereumProvider {
+    request(args: RequestArguments): Promise<unknown>;
+    on(event: string, listener: (...args: unknown[]) => void): void;
+    removeListener(event: string, listener: (...args: unknown[]) => void): void;
+    isMetaMask?: boolean;
+    isOkxWallet?: boolean;
+    isCoinbaseWallet?: boolean;
+    isPhantom?: boolean;
+}
+/**
+ * JSON-RPC 调用请求参数
+ */
+export interface RequestArguments {
+    method: string;
+    params?: unknown[] | Record<string, unknown>;
+}
+/**
+ * 链配置
+ */
+export interface Chain {
+    chainId: string;
+    chainName: string;
+    nativeCurrency: {
+        name: string;
+        symbol: string;
+        decimals: number;
+    };
+    rpcUrls: string[];
+    blockExplorerUrls?: string[];
+    iconUrls?: string[];
+}
+/**
+ * 钱包信息
+ */
+export interface WalletInfo {
+    id: string;
+    name: string;
+    icon?: string;
+    downloadUrl?: string;
+}
+/**
+ * 钱包连接状态
+ */
+export interface WalletState {
+    isConnected: boolean;
+    account: string | null;
+    chainId: string | null;
+    balance: string | null;
+    wallet: WalletInfo | null;
+}
+/**
+ * 钱包事件类型
+ */
+export type WalletEventType = "accountsChanged" | "chainChanged" | "connect" | "disconnect";
+/**
+ * 事件监听器类型
+ */
+export type WalletEventListener = (data: unknown) => void;
+/**
+ * 钱包错误类型
+ */
+export declare class WalletError extends Error {
+    code: number;
+    data?: unknown;
+    constructor(message: string, code: number, data?: unknown);
+}
+/**
+ * 钱包提供者上下文值
+ */
+export interface WalletContextValue {
+    state: WalletState;
+    connect: (walletId: string) => Promise<void>;
+    disconnect: () => Promise<void>;
+    switchChain: (chainId: string) => Promise<void>;
+    availableWallets: WalletInfo[];
+    supportedChains: Chain[];
+}
+/**
+ * 钱包提供者配置
+ */
+export interface WalletProviderConfig {
+    chains: Chain[];
+    autoConnect?: boolean;
+    appName?: string;
+}
+//# sourceMappingURL=wallet.d.ts.map

package/dist/esm/types/types/wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../../src/types/wallet.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAChE,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAC5E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE;QACd,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,iBAAiB,GACjB,cAAc,GACd,SAAS,GACT,YAAY,CAAC;AAEjB;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;AAE1D;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;gBAEH,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;CAM1D;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,gBAAgB,EAAE,UAAU,EAAE,CAAC;IAC/B,eAAe,EAAE,KAAK,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/esm/types/utils/chains.d.ts

@@ -0,0 +1,26 @@
+import { Chain } from "../types";
+/**
+ * 以太坊主网
+ */
+export declare const mainnet: Chain;
+/**
+ * Sepolia 测试网
+ */
+export declare const sepolia: Chain;
+/**
+ * 默认链列表
+ */
+export declare const defaultChains: Chain[];
+/**
+ * 根据 chainId 获取链配置
+ */
+export declare function getChainById(chainId: string, chains: Chain[]): Chain | undefined;
+/**
+ * 将 chainId 格式化为十六进制字符串
+ */
+export declare function formatChainId(chainId: number | string): string;
+/**
+ * 将 chainId 解析为数字
+ */
+export declare function parseChainId(chainId: string): number;
+//# sourceMappingURL=chains.d.ts.map

package/dist/esm/types/utils/chains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../../../src/utils/chains.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEjC;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,KAUrB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,KAUrB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,KAAK,EAAuB,CAAC;AAEzD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,KAAK,EAAE,GACd,KAAK,GAAG,SAAS,CAInB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAQ9D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKpD"}

package/dist/esm/types/utils/errors.d.ts

@@ -0,0 +1,30 @@
+import { WalletError } from "../types";
+/**
+ * 基于 EIP-1193 的错误代码
+ */
+export declare const ErrorCode: {
+    readonly USER_REJECTED: 4001;
+    readonly UNAUTHORIZED: 4100;
+    readonly UNSUPPORTED_METHOD: 4200;
+    readonly DISCONNECTED: 4900;
+    readonly CHAIN_DISCONNECTED: 4901;
+    readonly UNRECOGNIZED_CHAIN: 4902;
+    readonly INVALID_PARAMS: -32602;
+    readonly INTERNAL_ERROR: -32603;
+    readonly PROVIDER_NOT_FOUND: -32000;
+    readonly WALLET_NOT_INSTALLED: -32001;
+    readonly ALREADY_CONNECTED: -32002;
+};
+/**
+ * 创建钱包错误
+ */
+export declare function createWalletError(message: string, code: number, data?: unknown): WalletError;
+/**
+ * 检查错误是否为用户拒绝
+ */
+export declare function isUserRejectedError(error: unknown): boolean;
+/**
+ * 解析提供者错误
+ */
+export declare function parseProviderError(error: unknown): WalletError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/esm/types/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;CAYZ,CAAC;AAEX;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,GACb,WAAW,CAEb;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQ3D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAwB9D"}

package/dist/esm/types/utils/format.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Format balance from hex/wei to formatted string
+ */
+export declare function formatBalance(rawBalance: string | undefined): string;
+/**
+ * Format address to short form 0x...1234
+ */
+export declare function formatAddress(address: string | null | undefined): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/esm/types/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/utils/format.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAwBpE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGxE"}

package/dist/esm/types/wallets/BaseWallet.d.ts

@@ -0,0 +1,86 @@
+import { EthereumProvider, RequestArguments, Chain, WalletInfo, WalletEventListener } from "../types";
+/**
+ * 钱包基类（抽象类）
+ * 所有钱包实现都应继承此类
+ */
+export declare abstract class BaseWallet {
+    protected provider: EthereumProvider | null;
+    protected eventListeners: Map<string, Set<WalletEventListener>>;
+    /**
+     * 获取钱包信息
+     */
+    abstract getInfo(): WalletInfo;
+    /**
+     * 检查钱包是否安装
+     */
+    abstract isInstalled(): boolean;
+    /**
+     * 获取提供者实例
+     */
+    abstract getProvider(): EthereumProvider | null;
+    /**
+     * 连接钱包
+     */
+    connect(): Promise<string[]>;
+    /**
+     * 断开钱包连接
+     */
+    disconnect(): Promise<void>;
+    /**
+     * 获取当前账户
+     */
+    getAccounts(): Promise<string[]>;
+    /**
+     * 获取当前账户余额
+     */
+    getBalance(address: string): Promise<string>;
+    /**
+     * 获取当前链 ID
+     */
+    getChainId(): Promise<string>;
+    /**
+     * 切换到指定链
+     */
+    switchChain(chain: Chain): Promise<void>;
+    /**
+     * 添加事件监听器
+     */
+    on(event: string, listener: WalletEventListener): void;
+    /**
+     * 移除事件监听器
+     */
+    off(event: string, listener: WalletEventListener): void;
+    /**
+     * 发起 JSON-RPC 请求
+     */
+    protected request<T = unknown>(args: RequestArguments): Promise<T>;
+    /**
+     * 设置提供者事件监听
+     */
+    protected setupEventListeners(): void;
+    /**
+     * 清理资源和监听器
+     */
+    protected cleanup(): void;
+    /**
+     * 处理账户变更事件
+     */
+    protected handleAccountsChanged: (accounts: unknown) => void;
+    /**
+     * 处理链变更事件
+     */
+    protected handleChainChanged: (chainId: unknown) => void;
+    /**
+     * 处理断开连接事件
+     */
+    protected handleDisconnect: () => void;
+    /**
+     * 向所有监听器触发事件
+     */
+    protected emit(event: string, data: unknown): void;
+    /**
+     * 检查错误是否为未知链错误
+     */
+    protected isUnrecognizedChainError(error: unknown): boolean;
+}
+//# sourceMappingURL=BaseWallet.d.ts.map

package/dist/esm/types/wallets/BaseWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseWallet.d.ts","sourceRoot":"","sources":["../../../src/wallets/BaseWallet.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,EACL,UAAU,EACV,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAOlB;;;GAGG;AACH,8BAAsB,UAAU;IAC9B,SAAS,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IACnD,SAAS,CAAC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAa;IAE5E;;OAEG;IACH,QAAQ,CAAC,OAAO,IAAI,UAAU;IAE9B;;OAEG;IACH,QAAQ,CAAC,WAAW,IAAI,OAAO;IAE/B;;OAEG;IACH,QAAQ,CAAC,WAAW,IAAI,gBAAgB,GAAG,IAAI;IAE/C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAgClC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAgBtC;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBlD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAenC;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAqC9C;;OAEG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAOtD;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAOvD;;OAEG;cACa,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,CAAC,CAAC;IAaxE;;OAEG;IACH,SAAS,CAAC,mBAAmB,IAAI,IAAI;IAQrC;;OAEG;IACH,SAAS,CAAC,OAAO,IAAI,IAAI;IAazB;;OAEG;IACH,SAAS,CAAC,qBAAqB,aAAc,OAAO,KAAG,IAAI,CAEzD;IAEF;;OAEG;IACH,SAAS,CAAC,kBAAkB,YAAa,OAAO,KAAG,IAAI,CAErD;IAEF;;OAEG;IACH,SAAS,CAAC,gBAAgB,QAAO,IAAI,CAGnC;IAEF;;OAEG;IACH,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAalD;;OAEG;IACH,SAAS,CAAC,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;CAM5D"}

package/dist/esm/types/wallets/CoinbaseWallet.d.ts

@@ -0,0 +1,16 @@
+import { BaseWallet } from "./BaseWallet";
+import { EthereumProvider, WalletInfo } from "../types";
+declare global {
+    interface Window {
+        coinbaseWalletExtension?: EthereumProvider;
+    }
+}
+/**
+ * Coinbase 钱包实现
+ */
+export declare class CoinbaseWallet extends BaseWallet {
+    getInfo(): WalletInfo;
+    isInstalled(): boolean;
+    getProvider(): EthereumProvider | null;
+}
+//# sourceMappingURL=CoinbaseWallet.d.ts.map

package/dist/esm/types/wallets/CoinbaseWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoinbaseWallet.d.ts","sourceRoot":"","sources":["../../../src/wallets/CoinbaseWallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAExD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,uBAAuB,CAAC,EAAE,gBAAgB,CAAC;KAC5C;CACF;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAC5C,OAAO,IAAI,UAAU;IAQrB,WAAW,IAAI,OAAO;IAKtB,WAAW,IAAI,gBAAgB,GAAG,IAAI;CAIvC"}

package/dist/esm/types/wallets/MetaMaskWallet.d.ts

@@ -0,0 +1,16 @@
+import { BaseWallet } from "./BaseWallet";
+import { EthereumProvider, WalletInfo } from "../types";
+declare global {
+    interface Window {
+        ethereum?: EthereumProvider;
+    }
+}
+/**
+ * MetaMask 钱包实现
+ */
+export declare class MetaMaskWallet extends BaseWallet {
+    getInfo(): WalletInfo;
+    isInstalled(): boolean;
+    getProvider(): EthereumProvider | null;
+}
+//# sourceMappingURL=MetaMaskWallet.d.ts.map

package/dist/esm/types/wallets/MetaMaskWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetaMaskWallet.d.ts","sourceRoot":"","sources":["../../../src/wallets/MetaMaskWallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAExD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,QAAQ,CAAC,EAAE,gBAAgB,CAAC;KAC7B;CACF;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAC5C,OAAO,IAAI,UAAU;IAQrB,WAAW,IAAI,OAAO;IAKtB,WAAW,IAAI,gBAAgB,GAAG,IAAI;CAWvC"}

package/dist/esm/types/wallets/OKXWallet.d.ts

@@ -0,0 +1,16 @@
+import { BaseWallet } from "./BaseWallet";
+import { EthereumProvider, WalletInfo } from "../types";
+declare global {
+    interface Window {
+        okxwallet?: EthereumProvider;
+    }
+}
+/**
+ * OKX 钱包实现
+ */
+export declare class OKXWallet extends BaseWallet {
+    getInfo(): WalletInfo;
+    isInstalled(): boolean;
+    getProvider(): EthereumProvider | null;
+}
+//# sourceMappingURL=OKXWallet.d.ts.map

package/dist/esm/types/wallets/OKXWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OKXWallet.d.ts","sourceRoot":"","sources":["../../../src/wallets/OKXWallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAExD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,SAAS,CAAC,EAAE,gBAAgB,CAAC;KAC9B;CACF;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,UAAU;IACvC,OAAO,IAAI,UAAU;IAQrB,WAAW,IAAI,OAAO;IAKtB,WAAW,IAAI,gBAAgB,GAAG,IAAI;CAIvC"}

package/dist/esm/types/wallets/PhantomWallet.d.ts

@@ -0,0 +1,20 @@
+import { BaseWallet } from "./BaseWallet";
+import { EthereumProvider, WalletInfo } from "../types";
+declare global {
+    interface Window {
+        phantom?: {
+            ethereum?: EthereumProvider;
+        };
+    }
+}
+/**
+ * Phantom 钱包实现
+ * Phantom 支持 Solana 和 Ethereum
+ * 我们使用 ethereum 属性以兼容 EVM
+ */
+export declare class PhantomWallet extends BaseWallet {
+    getInfo(): WalletInfo;
+    isInstalled(): boolean;
+    getProvider(): EthereumProvider | null;
+}
+//# sourceMappingURL=PhantomWallet.d.ts.map

package/dist/esm/types/wallets/PhantomWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhantomWallet.d.ts","sourceRoot":"","sources":["../../../src/wallets/PhantomWallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAExD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,OAAO,CAAC,EAAE;YACR,QAAQ,CAAC,EAAE,gBAAgB,CAAC;SAC7B,CAAC;KACH;CACF;AAED;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,UAAU;IAC3C,OAAO,IAAI,UAAU;IAQrB,WAAW,IAAI,OAAO;IAKtB,WAAW,IAAI,gBAAgB,GAAG,IAAI;CAIvC"}

package/dist/esm/types/wallets/index.d.ts

@@ -0,0 +1,15 @@
+export { BaseWallet } from "./BaseWallet";
+export { MetaMaskWallet } from "./MetaMaskWallet";
+export { OKXWallet } from "./OKXWallet";
+export { PhantomWallet } from "./PhantomWallet";
+export { CoinbaseWallet } from "./CoinbaseWallet";
+import { BaseWallet } from "./BaseWallet";
+/**
+ * 所有可用钱包的注册表
+ */
+export declare const walletRegistry: BaseWallet[];
+/**
+ * 根据 ID 获取钱包
+ */
+export declare function getWalletById(id: string): BaseWallet | undefined;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/types/wallets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/wallets/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMlD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,UAAU,EAKtC,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAEhE"}

package/dist/types/index.d.ts

@@ -0,0 +1,273 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React from 'react';
+
+/**
+ * 基于 EIP-1193 的以太坊提供者接口
+ */
+interface EthereumProvider {
+    request(args: RequestArguments): Promise<unknown>;
+    on(event: string, listener: (...args: unknown[]) => void): void;
+    removeListener(event: string, listener: (...args: unknown[]) => void): void;
+    isMetaMask?: boolean;
+    isOkxWallet?: boolean;
+    isCoinbaseWallet?: boolean;
+    isPhantom?: boolean;
+}
+/**
+ * JSON-RPC 调用请求参数
+ */
+interface RequestArguments {
+    method: string;
+    params?: unknown[] | Record<string, unknown>;
+}
+/**
+ * 链配置
+ */
+interface Chain {
+    chainId: string;
+    chainName: string;
+    nativeCurrency: {
+        name: string;
+        symbol: string;
+        decimals: number;
+    };
+    rpcUrls: string[];
+    blockExplorerUrls?: string[];
+    iconUrls?: string[];
+}
+/**
+ * 钱包信息
+ */
+interface WalletInfo {
+    id: string;
+    name: string;
+    icon?: string;
+    downloadUrl?: string;
+}
+/**
+ * 钱包连接状态
+ */
+interface WalletState {
+    isConnected: boolean;
+    account: string | null;
+    chainId: string | null;
+    balance: string | null;
+    wallet: WalletInfo | null;
+}
+/**
+ * 事件监听器类型
+ */
+type WalletEventListener = (data: unknown) => void;
+/**
+ * 钱包提供者上下文值
+ */
+interface WalletContextValue {
+    state: WalletState;
+    connect: (walletId: string) => Promise<void>;
+    disconnect: () => Promise<void>;
+    switchChain: (chainId: string) => Promise<void>;
+    availableWallets: WalletInfo[];
+    supportedChains: Chain[];
+}
+/**
+ * 钱包提供者配置
+ */
+interface WalletProviderConfig {
+    chains: Chain[];
+    autoConnect?: boolean;
+    appName?: string;
+}
+
+interface WalletProviderProps {
+    children: React.ReactNode;
+    config: WalletProviderConfig;
+}
+/**
+ * 钱包提供者组件
+ * 管理钱包连接状态并向子组件提供钱包上下文
+ */
+declare function WalletProvider({ children, config }: WalletProviderProps): react_jsx_runtime.JSX.Element;
+
+declare function ConnectButton(): react_jsx_runtime.JSX.Element;
+
+/**
+ * 访问钱包上下文的 Hook
+ */
+declare function useWallet(): WalletContextValue;
+
+/**
+ * 钱包基类（抽象类）
+ * 所有钱包实现都应继承此类
+ */
+declare abstract class BaseWallet {
+    protected provider: EthereumProvider | null;
+    protected eventListeners: Map<string, Set<WalletEventListener>>;
+    /**
+     * 获取钱包信息
+     */
+    abstract getInfo(): WalletInfo;
+    /**
+     * 检查钱包是否安装
+     */
+    abstract isInstalled(): boolean;
+    /**
+     * 获取提供者实例
+     */
+    abstract getProvider(): EthereumProvider | null;
+    /**
+     * 连接钱包
+     */
+    connect(): Promise<string[]>;
+    /**
+     * 断开钱包连接
+     */
+    disconnect(): Promise<void>;
+    /**
+     * 获取当前账户
+     */
+    getAccounts(): Promise<string[]>;
+    /**
+     * 获取当前账户余额
+     */
+    getBalance(address: string): Promise<string>;
+    /**
+     * 获取当前链 ID
+     */
+    getChainId(): Promise<string>;
+    /**
+     * 切换到指定链
+     */
+    switchChain(chain: Chain): Promise<void>;
+    /**
+     * 添加事件监听器
+     */
+    on(event: string, listener: WalletEventListener): void;
+    /**
+     * 移除事件监听器
+     */
+    off(event: string, listener: WalletEventListener): void;
+    /**
+     * 发起 JSON-RPC 请求
+     */
+    protected request<T = unknown>(args: RequestArguments): Promise<T>;
+    /**
+     * 设置提供者事件监听
+     */
+    protected setupEventListeners(): void;
+    /**
+     * 清理资源和监听器
+     */
+    protected cleanup(): void;
+    /**
+     * 处理账户变更事件
+     */
+    protected handleAccountsChanged: (accounts: unknown) => void;
+    /**
+     * 处理链变更事件
+     */
+    protected handleChainChanged: (chainId: unknown) => void;
+    /**
+     * 处理断开连接事件
+     */
+    protected handleDisconnect: () => void;
+    /**
+     * 向所有监听器触发事件
+     */
+    protected emit(event: string, data: unknown): void;
+    /**
+     * 检查错误是否为未知链错误
+     */
+    protected isUnrecognizedChainError(error: unknown): boolean;
+}
+
+declare global {
+    interface Window {
+        ethereum?: EthereumProvider;
+    }
+}
+/**
+ * MetaMask 钱包实现
+ */
+declare class MetaMaskWallet extends BaseWallet {
+    getInfo(): WalletInfo;
+    isInstalled(): boolean;
+    getProvider(): EthereumProvider | null;
+}
+
+declare global {
+    interface Window {
+        okxwallet?: EthereumProvider;
+    }
+}
+/**
+ * OKX 钱包实现
+ */
+declare class OKXWallet extends BaseWallet {
+    getInfo(): WalletInfo;
+    isInstalled(): boolean;
+    getProvider(): EthereumProvider | null;
+}
+
+declare global {
+    interface Window {
+        phantom?: {
+            ethereum?: EthereumProvider;
+        };
+    }
+}
+/**
+ * Phantom 钱包实现
+ * Phantom 支持 Solana 和 Ethereum
+ * 我们使用 ethereum 属性以兼容 EVM
+ */
+declare class PhantomWallet extends BaseWallet {
+    getInfo(): WalletInfo;
+    isInstalled(): boolean;
+    getProvider(): EthereumProvider | null;
+}
+
+declare global {
+    interface Window {
+        coinbaseWalletExtension?: EthereumProvider;
+    }
+}
+/**
+ * Coinbase 钱包实现
+ */
+declare class CoinbaseWallet extends BaseWallet {
+    getInfo(): WalletInfo;
+    isInstalled(): boolean;
+    getProvider(): EthereumProvider | null;
+}
+
+/**
+ * 以太坊主网
+ */
+declare const mainnet: Chain;
+/**
+ * Sepolia 测试网
+ */
+declare const sepolia: Chain;
+/**
+ * 默认链列表
+ */
+declare const defaultChains: Chain[];
+
+/**
+ * 基于 EIP-1193 的错误代码
+ */
+declare const ErrorCode: {
+    readonly USER_REJECTED: 4001;
+    readonly UNAUTHORIZED: 4100;
+    readonly UNSUPPORTED_METHOD: 4200;
+    readonly DISCONNECTED: 4900;
+    readonly CHAIN_DISCONNECTED: 4901;
+    readonly UNRECOGNIZED_CHAIN: 4902;
+    readonly INVALID_PARAMS: -32602;
+    readonly INTERNAL_ERROR: -32603;
+    readonly PROVIDER_NOT_FOUND: -32000;
+    readonly WALLET_NOT_INSTALLED: -32001;
+    readonly ALREADY_CONNECTED: -32002;
+};
+
+export { BaseWallet, type Chain, CoinbaseWallet, ConnectButton, ErrorCode, type EthereumProvider, MetaMaskWallet, OKXWallet, PhantomWallet, type WalletContextValue, type WalletInfo, WalletProvider, type WalletProviderConfig, type WalletState, defaultChains, mainnet, sepolia, useWallet };