@moon-x/react-sdk 0.10.0 → 0.12.0

package/dist/{ethereum-Eg3cJKce.d.ts → ethereum-B0bChy5v.d.ts}

@@ -1,5 +1,5 @@
 import { PublicWallet, BaseGetBalanceParams, TransactionCommitment, BaseGetTokenAccountsParams, TransactionEncoding, BaseSendTransactionParams, BaseUIOptions, BaseSignMessageParams, BaseSignTransactionParams, TransactionUIOptions, PublicEthereumWallet } from '@moon-x/core/types';
-import { B as BaseWalletHooks } from './base-wallet-CzJLpndu.js';
+import { B as BaseWalletHooks } from './base-wallet-SjY7osPg.js';
 import { EthereumFundingConfig } from '@moon-x/core';
 
 interface EthereumProvider {

package/dist/{ethereum-lovLlqC2.d.mts → ethereum-DIGoC1pP.d.mts}

@@ -1,5 +1,5 @@
 import { PublicWallet, BaseGetBalanceParams, TransactionCommitment, BaseGetTokenAccountsParams, TransactionEncoding, BaseSendTransactionParams, BaseUIOptions, BaseSignMessageParams, BaseSignTransactionParams, TransactionUIOptions, PublicEthereumWallet } from '@moon-x/core/types';
-import { B as BaseWalletHooks } from './base-wallet-CzJLpndu.mjs';
+import { B as BaseWalletHooks } from './base-wallet-SjY7osPg.mjs';
 import { EthereumFundingConfig } from '@moon-x/core';
 
 interface EthereumProvider {

package/dist/index.d.mts

@@ -1,12 +1,13 @@
 export { LoginWithEmailState, PasskeyStatusEntry, RegisterPasskeyResult, UseAddPasskeyResult, UseEphemeralSignerResult, UseLoginWithEmailCallbacks, UsePasskeyStatusResult, UseRemovePasskeyResult, useAddPasskey, useEphemeralSigner, useLoginWithEmail, usePasskeyStatus, useRegisterPasskey, useRemovePasskey, useUser } from '@moon-x/core/react';
-import { WalletListEntry, LogoutResponse, EmailOtpFlowState, AuthAppearance, SendEmailOtpResponse, PrefillConfig, WalletChainType, PasskeyEnrollConfig, SignMessageConfig, ExportKeyConfig, SignTransactionConfig, SendTransactionConfig, ChainConfigItem, Wallet, FlexibleTheme, DisplayMode, AppearanceModeTokens } from '@moon-x/core/types';
+import { WalletListEntry, AuthAppearance, PrefillConfig, WalletChainType, PasskeyEnrollConfig, SignMessageConfig, ExportKeyConfig, SignTransactionConfig, SendTransactionConfig, ChainConfigItem, LogoutResponse, EmailOtpFlowState, SendEmailOtpResponse, Wallet, FlexibleTheme, DisplayMode, AppearanceModeTokens } from '@moon-x/core/types';
 export { AppearanceBackdrop, AppearanceBorderRadius, AppearanceCard, AppearanceColors, AppearanceComponents, AppearanceLogo, AppearanceModeTokens, AppearanceTypography, AuthAppearance, Chain, ChainConfigItem, ChainEntry, ComponentStyle, DisplayMode, EphemeralSigner, EphemeralSignerChain, EphemeralSignerScheme, EphemeralSignerWallet, EvmChainEntry, Factor, IdpProvider, ListEphemeralSignersResult, Network, ProvisionEphemeralSignerParams, ProvisionEphemeralSignerResult, PublicEthereumWallet, PublicWallet, RevokeEphemeralSignerParams, SolanaChainEntry, WalletConnectConfig, WalletListEntry } from '@moon-x/core/types';
 import React$1, { ReactNode } from 'react';
-export { e as ethereum } from './ethereum-lovLlqC2.mjs';
-export { s as solana } from './solana-BVrNImZ1.mjs';
+export { e as ethereum } from './ethereum-DIGoC1pP.mjs';
+export { s as solana } from './solana-nqJKbWX0.mjs';
+export { t as tron } from './tron-KzJqr-zA.mjs';
 export { buildChainIndex, estimateEvmGas, estimateEvmGasReserve, getChainById, getEvmGasPrice, getEvmMaxPriorityFeePerGas, getEvmNonce, getRpcUrl, isChainSupported, isEvmEntry, normalizeChainKey, resolveChainEntry, resolveRpcUrl, resolveSolanaChainEntry, resolveWsUrl, validateChainConfig } from '@moon-x/core/lib';
 export { arbitrum, arbitrumSepolia, avalanche, avalancheFuji, base, baseSepolia, bsc, bscTestnet, goerli, holesky, mainnet, optimism, optimismSepolia, polygon, polygonAmoy, sepolia } from 'viem/chains';
-import './base-wallet-CzJLpndu.mjs';
+import './base-wallet-SjY7osPg.mjs';
 import '@moon-x/core';
 
 type OAuthProvider$1 = "google" | "apple";
@@ -42,17 +43,34 @@ interface BaseConnectedEthereumWallet {
     wallet_type: "ethereum";
     chain_id?: string;
     connector?: any;
+    /** Backend `wallet_client_type`, e.g. "metamask". */
+    walletClientType?: string;
+    /** Sign a message with the connected wallet (returns a hex signature). */
+    signMessage?: (message: string | Uint8Array) => Promise<string>;
+    /** Best-effort disconnect. */
+    disconnect?: () => Promise<void>;
 }
 interface BaseConnectedSolanaWallet {
     public_address: string;
     wallet_type: "solana";
     chain_id?: string;
+    /** Backend `wallet_client_type`, e.g. "phantom". */
+    walletClientType?: string;
+    /** Sign a message with the connected wallet (returns a base58 signature). */
+    signMessage?: (message: string | Uint8Array) => Promise<string>;
+    /** Best-effort disconnect. */
+    disconnect?: () => Promise<void>;
 }
 interface ConnectWalletParams {
     description?: string;
     walletList?: WalletListEntry[];
     walletChainType?: "ethereum" | "solana" | "ethereum-and-solana";
-    mode?: "signIn" | "link";
+    /**
+     * "connect" (default) connects an external wallet client-side and resolves
+     * with it. "signIn"/"link" are SIWE/SIWS authentication intents that aren't
+     * implemented yet — they reject rather than silently succeed.
+     */
+    mode?: "connect" | "signIn" | "link";
 }
 
 interface ConnectWalletCallbacks {
@@ -68,6 +86,96 @@ interface UseConnectWallet {
 }
 declare function useConnectWallet(callbacks?: ConnectWalletCallbacks): UseConnectWallet;
 
+/**
+ * Public types for the external-wallet connection layer.
+ *
+ * This layer is *connect-only*: it discovers installed external wallets
+ * (MetaMask/Phantom/etc.), connects one, and exposes the account plus a
+ * message-signing capability. It does NOT authenticate — SIWE/SIWS login is
+ * layered on top separately (see the external-wallet login work).
+ */
+type ExternalWalletChain = "ethereum" | "solana";
+interface ExternalWalletInfo {
+    /** Stable slug used to connect this wallet, e.g. "metamask", "phantom". */
+    id: string;
+    /** Human-readable display name. */
+    name: string;
+    /** Data/URI icon when the underlying adapter provides one. */
+    icon?: string;
+    chain: ExternalWalletChain;
+    /** Whether the wallet was detected as installed/available. */
+    installed: boolean;
+    /** How a connection is established for this wallet. */
+    connectVia: "injected" | "walletconnect" | "adapter";
+}
+interface ConnectedExternalWallet {
+    /** Connected account address (hex for EVM, base58 for Solana). */
+    address: string;
+    chain: ExternalWalletChain;
+    /** Backend `wallet_client_type` value, e.g. "metamask", "phantom". */
+    walletClientType: string;
+    /** CAIP-2 chain id, e.g. "eip155:1" (EVM) or "solana:mainnet". */
+    chainId?: string;
+    /**
+     * Request a signature from the connected wallet.
+     * Returns hex (EVM `personal_sign`) or base58 (Solana `signMessage`).
+     */
+    signMessage: (message: string | Uint8Array) => Promise<string>;
+    /** Best-effort disconnect (extensions may not support programmatic disconnect). */
+    disconnect: () => Promise<void>;
+    /** Underlying provider / adapter / WalletConnect session, for advanced use. */
+    raw: unknown;
+}
+
+type ExternalWalletStatus = "idle" | "connecting" | "connected" | "error";
+interface UseExternalWalletsOptions {
+    /** Which chains to list/connect. Defaults to "all". */
+    chain?: ExternalWalletChain | "all";
+    /** CAIP-2 network for Solana signatures (default "solana:mainnet"). */
+    solanaNetwork?: string;
+    /** CAIP-2 or numeric chain id for EVM (default Ethereum mainnet). */
+    ethereumChainId?: string;
+}
+interface UseExternalWallets {
+    /** Detected external wallets for the requested chain(s). */
+    wallets: ExternalWalletInfo[];
+    /**
+     * Connect a detected wallet by id; resolves with the connected wallet.
+     * Pass `chain` to disambiguate multi-chain wallets (e.g. Phantom exists on
+     * both Ethereum and Solana).
+     */
+    connect: (walletId: string, chain?: ExternalWalletChain) => Promise<ConnectedExternalWallet>;
+    /** Disconnect the currently connected wallet (best effort). */
+    disconnect: () => Promise<void>;
+    connected: ConnectedExternalWallet | null;
+    status: ExternalWalletStatus;
+    error: Error | null;
+    /** Re-run wallet detection (e.g. after the user installs an extension). */
+    refresh: () => void;
+}
+/**
+ * Headless external-wallet connection hook.
+ *
+ * Connect-only: discovers installed wallets, connects one, and exposes the
+ * account + a `signMessage` capability. No SIWE/SIWS, no session — build your
+ * own UI, or use the prebuilt modal via `useConnectWallet`.
+ *
+ * Covers injected EVM wallets (EIP-6963) and Solana Wallet Standard adapters.
+ * For WalletConnect (mobile / QR), use the prebuilt modal (`useConnectWallet`)
+ * or the standalone `connectWalletConnect()` helper.
+ */
+declare function useExternalWallets(options?: UseExternalWalletsOptions): UseExternalWallets;
+
+/**
+ * The external wallets currently connected in this session (via
+ * `useExternalWallets` or the prebuilt modal), shared app-wide. Use this to
+ * surface connected wallets in a picker/account switcher and to sign with the
+ * selected one (each carries `signMessage`).
+ */
+declare function useConnectedExternalWallets(): ConnectedExternalWallet[];
+/** Disconnect a connected external wallet and remove it from the shared store. */
+declare function disconnectExternalWallet(wallet: ConnectedExternalWallet): Promise<void>;
+
 interface DetachOAuthResult {
     success: boolean;
     message?: string;
@@ -168,7 +276,7 @@ interface MoonXProviderProps$1 {
     children: React.ReactNode;
     onClose?: () => void;
 }
-interface MoonKeyInstance {
+interface MoonXInstance {
     ready: boolean;
     isAuthenticated: boolean;
     user: any | null;
@@ -277,9 +385,9 @@ interface WalletConfig {
     network: "mainnet" | "testnet" | "devnet";
     rpcUrl?: string;
 }
-type WalletType = "solana" | "ethereum";
+type WalletType = "solana" | "ethereum" | "tron";
 
-declare const useMoonX: () => MoonKeyInstance;
+declare const useMoonX: () => MoonXInstance;
 
 interface UseOAuthCompletionOptions {
     onSuccess?: (data: any) => void;
@@ -296,10 +404,10 @@ interface MoonXProviderProps {
 declare const MoonXProvider: React$1.FC<MoonXProviderProps>;
 
 /**
- * MoonKey Theme - matches CSS variables from styles.css:66-95
+ * MoonX Theme - matches CSS variables from styles.css:66-95
  * Only customizable properties are included (colors, border-radius, font-family)
  */
-interface MoonKeyTheme {
+interface MoonXTheme {
     colors: {
         accent: string;
         accentForeground: string;
@@ -330,13 +438,13 @@ interface MoonKeyTheme {
     };
     fontFamily: string;
 }
-declare const lightTheme: MoonKeyTheme;
-declare const darkTheme: MoonKeyTheme;
+declare const lightTheme: MoonXTheme;
+declare const darkTheme: MoonXTheme;
 /**
- * Converts MoonKeyTheme to CSS custom properties
+ * Converts MoonXTheme to CSS custom properties
  * Maps ONLY to the 25 variables defined in styles.css:66-95
  */
-declare function themeToCSS(theme: MoonKeyTheme): React.CSSProperties;
+declare function themeToCSS(theme: MoonXTheme): React.CSSProperties;
 
 /**
  * Decide whether a CSS color reads as "dark" from its perceived luminance.
@@ -357,7 +465,7 @@ declare function isColorDark(color: string): boolean | undefined;
  *  - otherwise (omitted, or "auto" with no `matchMedia`) — inferred from the
  *    background color's luminance.
  */
-declare function isDarkMode(theme?: Partial<MoonKeyTheme> | FlexibleTheme, displayMode?: DisplayMode, backgroundColor?: string): boolean;
+declare function isDarkMode(theme?: Partial<MoonXTheme> | FlexibleTheme, displayMode?: DisplayMode, backgroundColor?: string): boolean;
 
 declare function isDarkAppearance(appearance: AuthAppearance | undefined): boolean;
 /** Return a shallow copy of `src` containing only defined, non-empty values. */
@@ -386,7 +494,7 @@ declare function resolveLogo(logo: AuthAppearance["logo"], isDark: boolean): {
  * Merge priority (lowest → highest): accent/background derivations →
  * `appearance.colors` + per-mode (`appearance.light` / `dark`).
  */
-declare function appearanceToTheme(appearance: AuthAppearance | undefined, isDark?: boolean): Partial<MoonKeyTheme>;
+declare function appearanceToTheme(appearance: AuthAppearance | undefined, isDark?: boolean): Partial<MoonXTheme>;
 /**
  * Derives the newer `--moonx-*` CSS variables (warning/info/link/ring colors,
  * granular radii, typography scale, card and backdrop tokens) from an
@@ -441,4 +549,61 @@ declare const getReconnectionInfo: (error: any) => {
     walletAddress?: string;
 } | null;
 
-export { type AttachOAuthState, type BaseConnectedEthereumWallet, type BaseConnectedSolanaWallet, type ConnectWalletCallbacks, type ConnectWalletParams, type DetachOAuthResult, type DetachOAuthState, type MoonKeyInstance, type MoonKeyTheme, type MoonXConfig, MoonXProvider, type MoonXProviderProps$1 as MoonXProviderProps, type OAuthAttachResult, type OAuthProvider, type OAuthState, type OAuthUser, SessionExpiredError, SessionNotFoundError, type UseAttachOAuth, type UseAttachOAuthCallbacks, type UseConnectWallet, type UseDetachOAuth, type UseDetachOAuthCallbacks, type UseLoginWithOAuth, type UseLoginWithOAuthCallbacks, type WalletConfig, type WalletInstance, type WalletType, appearanceToComponentVars, appearanceToCssVars, appearanceToMoonxVars, appearanceToTheme, darkTheme, definedOnly, getReconnectionInfo, isColorDark, isDarkAppearance, isDarkMode, lightTheme, requiresReconnection, resolveAppearanceTokens, resolveFontUrls, resolveLogo, themeToCSS, useAttachOAuth, useConnectWallet, useDetachOAuth, useLoginWithOAuth, useMoonX, useOAuthCompletion };
+interface ConnectEthereumOptions {
+    /** EIP-1193 provider (browser extension) or a WalletConnect client. */
+    provider: any;
+    /** Backend `wallet_client_type`, e.g. "metamask". */
+    walletClientType: string;
+    /** WalletConnect session (present for WalletConnect connections). */
+    session?: any;
+    /** CAIP-2 or numeric chain id; defaults to Ethereum mainnet. */
+    chainId?: string;
+}
+/**
+ * Connect an EVM wallet and return a chain-agnostic {@link ConnectedExternalWallet}.
+ * Pure connection primitive — no SIWE, no iframe, no session.
+ */
+declare function connectEthereumProvider({ provider, walletClientType, session, chainId, }: ConnectEthereumOptions): Promise<ConnectedExternalWallet>;
+
+interface ConnectSolanaOptions {
+    /** A `@solana/wallet-adapter` adapter instance (see `getWalletAdapter`). */
+    adapter: any;
+    /** CAIP-2 network for the returned `chainId`; defaults to "solana:mainnet". */
+    network?: string;
+}
+/**
+ * Connect a Solana wallet adapter and return a chain-agnostic
+ * {@link ConnectedExternalWallet}. Pure connection primitive — no SIWS,
+ * no iframe, no session.
+ */
+declare function connectSolanaAdapter({ adapter, network, }: ConnectSolanaOptions): Promise<ConnectedExternalWallet>;
+
+interface ConnectWalletConnectOptions {
+    /** An initialized WalletConnect v2 SignClient (from MoonXProvider). */
+    client: any;
+    /** CAIP-2 chains to request. Defaults to Ethereum mainnet. */
+    chains?: string[];
+    /** Backend `wallet_client_type`. */
+    walletClientType?: string;
+}
+/**
+ * Begin a WalletConnect v2 connection. Returns the pairing `uri` — render it as
+ * a QR code / deep link — plus `approval`, which resolves once the user
+ * approves in their wallet, yielding a chain-agnostic
+ * {@link ConnectedExternalWallet} (EVM). Connect-only; no SIWE. This is the
+ * path that covers mobile / non-injected wallets.
+ */
+declare function connectWalletConnect({ client, chains, walletClientType, }: ConnectWalletConnectOptions): Promise<{
+    uri: string;
+    approval: () => Promise<ConnectedExternalWallet>;
+}>;
+
+/** Resolve an injected EVM provider by wallet id. Null when not installed. */
+declare const getEthereumWalletProvider: (id: string) => {
+    provider: any;
+    walletClientType: string;
+} | null;
+/** List detectable external wallets for the requested chain(s). */
+declare const listExternalWallets: (chain?: ExternalWalletChain | "all") => Promise<ExternalWalletInfo[]>;
+
+export { type AttachOAuthState, type BaseConnectedEthereumWallet, type BaseConnectedSolanaWallet, type ConnectEthereumOptions, type ConnectSolanaOptions, type ConnectWalletCallbacks, type ConnectWalletConnectOptions, type ConnectWalletParams, type ConnectedExternalWallet, type DetachOAuthResult, type DetachOAuthState, type ExternalWalletChain, type ExternalWalletInfo, type ExternalWalletStatus, type MoonXConfig, type MoonXInstance, MoonXProvider, type MoonXProviderProps$1 as MoonXProviderProps, type MoonXTheme, type OAuthAttachResult, type OAuthProvider, type OAuthState, type OAuthUser, SessionExpiredError, SessionNotFoundError, type UseAttachOAuth, type UseAttachOAuthCallbacks, type UseConnectWallet, type UseDetachOAuth, type UseDetachOAuthCallbacks, type UseExternalWallets, type UseExternalWalletsOptions, type UseLoginWithOAuth, type UseLoginWithOAuthCallbacks, type WalletConfig, type WalletInstance, type WalletType, appearanceToComponentVars, appearanceToCssVars, appearanceToMoonxVars, appearanceToTheme, connectEthereumProvider, connectSolanaAdapter, connectWalletConnect, darkTheme, definedOnly, disconnectExternalWallet, getEthereumWalletProvider, getReconnectionInfo, isColorDark, isDarkAppearance, isDarkMode, lightTheme, listExternalWallets, requiresReconnection, resolveAppearanceTokens, resolveFontUrls, resolveLogo, themeToCSS, useAttachOAuth, useConnectWallet, useConnectedExternalWallets, useDetachOAuth, useExternalWallets, useLoginWithOAuth, useMoonX, useOAuthCompletion };

package/dist/index.d.ts

@@ -1,12 +1,13 @@
 export { LoginWithEmailState, PasskeyStatusEntry, RegisterPasskeyResult, UseAddPasskeyResult, UseEphemeralSignerResult, UseLoginWithEmailCallbacks, UsePasskeyStatusResult, UseRemovePasskeyResult, useAddPasskey, useEphemeralSigner, useLoginWithEmail, usePasskeyStatus, useRegisterPasskey, useRemovePasskey, useUser } from '@moon-x/core/react';
-import { WalletListEntry, LogoutResponse, EmailOtpFlowState, AuthAppearance, SendEmailOtpResponse, PrefillConfig, WalletChainType, PasskeyEnrollConfig, SignMessageConfig, ExportKeyConfig, SignTransactionConfig, SendTransactionConfig, ChainConfigItem, Wallet, FlexibleTheme, DisplayMode, AppearanceModeTokens } from '@moon-x/core/types';
+import { WalletListEntry, AuthAppearance, PrefillConfig, WalletChainType, PasskeyEnrollConfig, SignMessageConfig, ExportKeyConfig, SignTransactionConfig, SendTransactionConfig, ChainConfigItem, LogoutResponse, EmailOtpFlowState, SendEmailOtpResponse, Wallet, FlexibleTheme, DisplayMode, AppearanceModeTokens } from '@moon-x/core/types';
 export { AppearanceBackdrop, AppearanceBorderRadius, AppearanceCard, AppearanceColors, AppearanceComponents, AppearanceLogo, AppearanceModeTokens, AppearanceTypography, AuthAppearance, Chain, ChainConfigItem, ChainEntry, ComponentStyle, DisplayMode, EphemeralSigner, EphemeralSignerChain, EphemeralSignerScheme, EphemeralSignerWallet, EvmChainEntry, Factor, IdpProvider, ListEphemeralSignersResult, Network, ProvisionEphemeralSignerParams, ProvisionEphemeralSignerResult, PublicEthereumWallet, PublicWallet, RevokeEphemeralSignerParams, SolanaChainEntry, WalletConnectConfig, WalletListEntry } from '@moon-x/core/types';
 import React$1, { ReactNode } from 'react';
-export { e as ethereum } from './ethereum-Eg3cJKce.js';
-export { s as solana } from './solana-C9rN8lxH.js';
+export { e as ethereum } from './ethereum-B0bChy5v.js';
+export { s as solana } from './solana-D2QJgky5.js';
+export { t as tron } from './tron-KzJqr-zA.js';
 export { buildChainIndex, estimateEvmGas, estimateEvmGasReserve, getChainById, getEvmGasPrice, getEvmMaxPriorityFeePerGas, getEvmNonce, getRpcUrl, isChainSupported, isEvmEntry, normalizeChainKey, resolveChainEntry, resolveRpcUrl, resolveSolanaChainEntry, resolveWsUrl, validateChainConfig } from '@moon-x/core/lib';
 export { arbitrum, arbitrumSepolia, avalanche, avalancheFuji, base, baseSepolia, bsc, bscTestnet, goerli, holesky, mainnet, optimism, optimismSepolia, polygon, polygonAmoy, sepolia } from 'viem/chains';
-import './base-wallet-CzJLpndu.js';
+import './base-wallet-SjY7osPg.js';
 import '@moon-x/core';
 
 type OAuthProvider$1 = "google" | "apple";
@@ -42,17 +43,34 @@ interface BaseConnectedEthereumWallet {
     wallet_type: "ethereum";
     chain_id?: string;
     connector?: any;
+    /** Backend `wallet_client_type`, e.g. "metamask". */
+    walletClientType?: string;
+    /** Sign a message with the connected wallet (returns a hex signature). */
+    signMessage?: (message: string | Uint8Array) => Promise<string>;
+    /** Best-effort disconnect. */
+    disconnect?: () => Promise<void>;
 }
 interface BaseConnectedSolanaWallet {
     public_address: string;
     wallet_type: "solana";
     chain_id?: string;
+    /** Backend `wallet_client_type`, e.g. "phantom". */
+    walletClientType?: string;
+    /** Sign a message with the connected wallet (returns a base58 signature). */
+    signMessage?: (message: string | Uint8Array) => Promise<string>;
+    /** Best-effort disconnect. */
+    disconnect?: () => Promise<void>;
 }
 interface ConnectWalletParams {
     description?: string;
     walletList?: WalletListEntry[];
     walletChainType?: "ethereum" | "solana" | "ethereum-and-solana";
-    mode?: "signIn" | "link";
+    /**
+     * "connect" (default) connects an external wallet client-side and resolves
+     * with it. "signIn"/"link" are SIWE/SIWS authentication intents that aren't
+     * implemented yet — they reject rather than silently succeed.
+     */
+    mode?: "connect" | "signIn" | "link";
 }
 
 interface ConnectWalletCallbacks {
@@ -68,6 +86,96 @@ interface UseConnectWallet {
 }
 declare function useConnectWallet(callbacks?: ConnectWalletCallbacks): UseConnectWallet;
 
+/**
+ * Public types for the external-wallet connection layer.
+ *
+ * This layer is *connect-only*: it discovers installed external wallets
+ * (MetaMask/Phantom/etc.), connects one, and exposes the account plus a
+ * message-signing capability. It does NOT authenticate — SIWE/SIWS login is
+ * layered on top separately (see the external-wallet login work).
+ */
+type ExternalWalletChain = "ethereum" | "solana";
+interface ExternalWalletInfo {
+    /** Stable slug used to connect this wallet, e.g. "metamask", "phantom". */
+    id: string;
+    /** Human-readable display name. */
+    name: string;
+    /** Data/URI icon when the underlying adapter provides one. */
+    icon?: string;
+    chain: ExternalWalletChain;
+    /** Whether the wallet was detected as installed/available. */
+    installed: boolean;
+    /** How a connection is established for this wallet. */
+    connectVia: "injected" | "walletconnect" | "adapter";
+}
+interface ConnectedExternalWallet {
+    /** Connected account address (hex for EVM, base58 for Solana). */
+    address: string;
+    chain: ExternalWalletChain;
+    /** Backend `wallet_client_type` value, e.g. "metamask", "phantom". */
+    walletClientType: string;
+    /** CAIP-2 chain id, e.g. "eip155:1" (EVM) or "solana:mainnet". */
+    chainId?: string;
+    /**
+     * Request a signature from the connected wallet.
+     * Returns hex (EVM `personal_sign`) or base58 (Solana `signMessage`).
+     */
+    signMessage: (message: string | Uint8Array) => Promise<string>;
+    /** Best-effort disconnect (extensions may not support programmatic disconnect). */
+    disconnect: () => Promise<void>;
+    /** Underlying provider / adapter / WalletConnect session, for advanced use. */
+    raw: unknown;
+}
+
+type ExternalWalletStatus = "idle" | "connecting" | "connected" | "error";
+interface UseExternalWalletsOptions {
+    /** Which chains to list/connect. Defaults to "all". */
+    chain?: ExternalWalletChain | "all";
+    /** CAIP-2 network for Solana signatures (default "solana:mainnet"). */
+    solanaNetwork?: string;
+    /** CAIP-2 or numeric chain id for EVM (default Ethereum mainnet). */
+    ethereumChainId?: string;
+}
+interface UseExternalWallets {
+    /** Detected external wallets for the requested chain(s). */
+    wallets: ExternalWalletInfo[];
+    /**
+     * Connect a detected wallet by id; resolves with the connected wallet.
+     * Pass `chain` to disambiguate multi-chain wallets (e.g. Phantom exists on
+     * both Ethereum and Solana).
+     */
+    connect: (walletId: string, chain?: ExternalWalletChain) => Promise<ConnectedExternalWallet>;
+    /** Disconnect the currently connected wallet (best effort). */
+    disconnect: () => Promise<void>;
+    connected: ConnectedExternalWallet | null;
+    status: ExternalWalletStatus;
+    error: Error | null;
+    /** Re-run wallet detection (e.g. after the user installs an extension). */
+    refresh: () => void;
+}
+/**
+ * Headless external-wallet connection hook.
+ *
+ * Connect-only: discovers installed wallets, connects one, and exposes the
+ * account + a `signMessage` capability. No SIWE/SIWS, no session — build your
+ * own UI, or use the prebuilt modal via `useConnectWallet`.
+ *
+ * Covers injected EVM wallets (EIP-6963) and Solana Wallet Standard adapters.
+ * For WalletConnect (mobile / QR), use the prebuilt modal (`useConnectWallet`)
+ * or the standalone `connectWalletConnect()` helper.
+ */
+declare function useExternalWallets(options?: UseExternalWalletsOptions): UseExternalWallets;
+
+/**
+ * The external wallets currently connected in this session (via
+ * `useExternalWallets` or the prebuilt modal), shared app-wide. Use this to
+ * surface connected wallets in a picker/account switcher and to sign with the
+ * selected one (each carries `signMessage`).
+ */
+declare function useConnectedExternalWallets(): ConnectedExternalWallet[];
+/** Disconnect a connected external wallet and remove it from the shared store. */
+declare function disconnectExternalWallet(wallet: ConnectedExternalWallet): Promise<void>;
+
 interface DetachOAuthResult {
     success: boolean;
     message?: string;
@@ -168,7 +276,7 @@ interface MoonXProviderProps$1 {
     children: React.ReactNode;
     onClose?: () => void;
 }
-interface MoonKeyInstance {
+interface MoonXInstance {
     ready: boolean;
     isAuthenticated: boolean;
     user: any | null;
@@ -277,9 +385,9 @@ interface WalletConfig {
     network: "mainnet" | "testnet" | "devnet";
     rpcUrl?: string;
 }
-type WalletType = "solana" | "ethereum";
+type WalletType = "solana" | "ethereum" | "tron";
 
-declare const useMoonX: () => MoonKeyInstance;
+declare const useMoonX: () => MoonXInstance;
 
 interface UseOAuthCompletionOptions {
     onSuccess?: (data: any) => void;
@@ -296,10 +404,10 @@ interface MoonXProviderProps {
 declare const MoonXProvider: React$1.FC<MoonXProviderProps>;
 
 /**
- * MoonKey Theme - matches CSS variables from styles.css:66-95
+ * MoonX Theme - matches CSS variables from styles.css:66-95
  * Only customizable properties are included (colors, border-radius, font-family)
  */
-interface MoonKeyTheme {
+interface MoonXTheme {
     colors: {
         accent: string;
         accentForeground: string;
@@ -330,13 +438,13 @@ interface MoonKeyTheme {
     };
     fontFamily: string;
 }
-declare const lightTheme: MoonKeyTheme;
-declare const darkTheme: MoonKeyTheme;
+declare const lightTheme: MoonXTheme;
+declare const darkTheme: MoonXTheme;
 /**
- * Converts MoonKeyTheme to CSS custom properties
+ * Converts MoonXTheme to CSS custom properties
  * Maps ONLY to the 25 variables defined in styles.css:66-95
  */
-declare function themeToCSS(theme: MoonKeyTheme): React.CSSProperties;
+declare function themeToCSS(theme: MoonXTheme): React.CSSProperties;
 
 /**
  * Decide whether a CSS color reads as "dark" from its perceived luminance.
@@ -357,7 +465,7 @@ declare function isColorDark(color: string): boolean | undefined;
  *  - otherwise (omitted, or "auto" with no `matchMedia`) — inferred from the
  *    background color's luminance.
  */
-declare function isDarkMode(theme?: Partial<MoonKeyTheme> | FlexibleTheme, displayMode?: DisplayMode, backgroundColor?: string): boolean;
+declare function isDarkMode(theme?: Partial<MoonXTheme> | FlexibleTheme, displayMode?: DisplayMode, backgroundColor?: string): boolean;
 
 declare function isDarkAppearance(appearance: AuthAppearance | undefined): boolean;
 /** Return a shallow copy of `src` containing only defined, non-empty values. */
@@ -386,7 +494,7 @@ declare function resolveLogo(logo: AuthAppearance["logo"], isDark: boolean): {
  * Merge priority (lowest → highest): accent/background derivations →
  * `appearance.colors` + per-mode (`appearance.light` / `dark`).
  */
-declare function appearanceToTheme(appearance: AuthAppearance | undefined, isDark?: boolean): Partial<MoonKeyTheme>;
+declare function appearanceToTheme(appearance: AuthAppearance | undefined, isDark?: boolean): Partial<MoonXTheme>;
 /**
  * Derives the newer `--moonx-*` CSS variables (warning/info/link/ring colors,
  * granular radii, typography scale, card and backdrop tokens) from an
@@ -441,4 +549,61 @@ declare const getReconnectionInfo: (error: any) => {
     walletAddress?: string;
 } | null;
 
-export { type AttachOAuthState, type BaseConnectedEthereumWallet, type BaseConnectedSolanaWallet, type ConnectWalletCallbacks, type ConnectWalletParams, type DetachOAuthResult, type DetachOAuthState, type MoonKeyInstance, type MoonKeyTheme, type MoonXConfig, MoonXProvider, type MoonXProviderProps$1 as MoonXProviderProps, type OAuthAttachResult, type OAuthProvider, type OAuthState, type OAuthUser, SessionExpiredError, SessionNotFoundError, type UseAttachOAuth, type UseAttachOAuthCallbacks, type UseConnectWallet, type UseDetachOAuth, type UseDetachOAuthCallbacks, type UseLoginWithOAuth, type UseLoginWithOAuthCallbacks, type WalletConfig, type WalletInstance, type WalletType, appearanceToComponentVars, appearanceToCssVars, appearanceToMoonxVars, appearanceToTheme, darkTheme, definedOnly, getReconnectionInfo, isColorDark, isDarkAppearance, isDarkMode, lightTheme, requiresReconnection, resolveAppearanceTokens, resolveFontUrls, resolveLogo, themeToCSS, useAttachOAuth, useConnectWallet, useDetachOAuth, useLoginWithOAuth, useMoonX, useOAuthCompletion };
+interface ConnectEthereumOptions {
+    /** EIP-1193 provider (browser extension) or a WalletConnect client. */
+    provider: any;
+    /** Backend `wallet_client_type`, e.g. "metamask". */
+    walletClientType: string;
+    /** WalletConnect session (present for WalletConnect connections). */
+    session?: any;
+    /** CAIP-2 or numeric chain id; defaults to Ethereum mainnet. */
+    chainId?: string;
+}
+/**
+ * Connect an EVM wallet and return a chain-agnostic {@link ConnectedExternalWallet}.
+ * Pure connection primitive — no SIWE, no iframe, no session.
+ */
+declare function connectEthereumProvider({ provider, walletClientType, session, chainId, }: ConnectEthereumOptions): Promise<ConnectedExternalWallet>;
+
+interface ConnectSolanaOptions {
+    /** A `@solana/wallet-adapter` adapter instance (see `getWalletAdapter`). */
+    adapter: any;
+    /** CAIP-2 network for the returned `chainId`; defaults to "solana:mainnet". */
+    network?: string;
+}
+/**
+ * Connect a Solana wallet adapter and return a chain-agnostic
+ * {@link ConnectedExternalWallet}. Pure connection primitive — no SIWS,
+ * no iframe, no session.
+ */
+declare function connectSolanaAdapter({ adapter, network, }: ConnectSolanaOptions): Promise<ConnectedExternalWallet>;
+
+interface ConnectWalletConnectOptions {
+    /** An initialized WalletConnect v2 SignClient (from MoonXProvider). */
+    client: any;
+    /** CAIP-2 chains to request. Defaults to Ethereum mainnet. */
+    chains?: string[];
+    /** Backend `wallet_client_type`. */
+    walletClientType?: string;
+}
+/**
+ * Begin a WalletConnect v2 connection. Returns the pairing `uri` — render it as
+ * a QR code / deep link — plus `approval`, which resolves once the user
+ * approves in their wallet, yielding a chain-agnostic
+ * {@link ConnectedExternalWallet} (EVM). Connect-only; no SIWE. This is the
+ * path that covers mobile / non-injected wallets.
+ */
+declare function connectWalletConnect({ client, chains, walletClientType, }: ConnectWalletConnectOptions): Promise<{
+    uri: string;
+    approval: () => Promise<ConnectedExternalWallet>;
+}>;
+
+/** Resolve an injected EVM provider by wallet id. Null when not installed. */
+declare const getEthereumWalletProvider: (id: string) => {
+    provider: any;
+    walletClientType: string;
+} | null;
+/** List detectable external wallets for the requested chain(s). */
+declare const listExternalWallets: (chain?: ExternalWalletChain | "all") => Promise<ExternalWalletInfo[]>;
+
+export { type AttachOAuthState, type BaseConnectedEthereumWallet, type BaseConnectedSolanaWallet, type ConnectEthereumOptions, type ConnectSolanaOptions, type ConnectWalletCallbacks, type ConnectWalletConnectOptions, type ConnectWalletParams, type ConnectedExternalWallet, type DetachOAuthResult, type DetachOAuthState, type ExternalWalletChain, type ExternalWalletInfo, type ExternalWalletStatus, type MoonXConfig, type MoonXInstance, MoonXProvider, type MoonXProviderProps$1 as MoonXProviderProps, type MoonXTheme, type OAuthAttachResult, type OAuthProvider, type OAuthState, type OAuthUser, SessionExpiredError, SessionNotFoundError, type UseAttachOAuth, type UseAttachOAuthCallbacks, type UseConnectWallet, type UseDetachOAuth, type UseDetachOAuthCallbacks, type UseExternalWallets, type UseExternalWalletsOptions, type UseLoginWithOAuth, type UseLoginWithOAuthCallbacks, type WalletConfig, type WalletInstance, type WalletType, appearanceToComponentVars, appearanceToCssVars, appearanceToMoonxVars, appearanceToTheme, connectEthereumProvider, connectSolanaAdapter, connectWalletConnect, darkTheme, definedOnly, disconnectExternalWallet, getEthereumWalletProvider, getReconnectionInfo, isColorDark, isDarkAppearance, isDarkMode, lightTheme, listExternalWallets, requiresReconnection, resolveAppearanceTokens, resolveFontUrls, resolveLogo, themeToCSS, useAttachOAuth, useConnectWallet, useConnectedExternalWallets, useDetachOAuth, useExternalWallets, useLoginWithOAuth, useMoonX, useOAuthCompletion };