@moon-x/react-sdk 0.8.1 → 0.9.0

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

@@ -38,22 +38,30 @@ interface EthereumSignTransactionParams extends BaseSignTransactionParams {
         uiOptions?: BaseUIOptions;
     };
 }
-interface EthereumSendTransactionParams extends BaseSendTransactionParams {
+interface EthereumSendTransactionParams extends Omit<BaseSendTransactionParams, "rpcUrl"> {
     wallet: PublicWallet;
+    /** Per-call chain selector: alias | CAIP-2 id | numeric chainId. */
+    chain?: string | number;
+    /** Inline RPC override for this call; falls back to provider config. */
+    rpcUrl?: string;
     options?: {
         uiOptions?: BaseUIOptions;
         network?: string;
     };
 }
 interface EthereumGetBalanceParams extends BaseGetBalanceParams {
-    chain?: string;
+    /** Per-call chain selector: alias | CAIP-2 id | numeric chainId. */
+    chain?: string | number;
+    /** Inline RPC override for this call; falls back to provider config. */
+    rpcUrl?: string;
     options?: {
         commitment?: TransactionCommitment;
         minContextSlot?: number;
     };
 }
 interface EthereumGetTokenAccountsParams extends BaseGetTokenAccountsParams {
-    chain?: string;
+    chain?: string | number;
+    rpcUrl?: string;
     mint?: string;
     programId?: string;
     options?: {
@@ -165,9 +173,10 @@ declare const useSignMessage: () => {
     error: undefined;
 };
 declare const useSignTransaction: () => {
-    signTransaction: ({ transaction, wallet, options, }: {
+    signTransaction: ({ transaction, wallet, chain, options, }: {
         transaction: string | object;
         wallet: PublicWallet;
+        chain?: string | number;
         options?: {
             uiOptions?: SignTransactionUIOptions;
         };
@@ -209,11 +218,12 @@ declare const useSignTypedData: () => {
     error: undefined;
 };
 declare const useSign7702Authorization: () => {
-    signAuthorization: ({ contractAddress, nonce, executor, wallet, options, }: {
+    signAuthorization: ({ contractAddress, nonce, executor, wallet, chain, options, }: {
         contractAddress: `0x${string}`;
         nonce?: number;
         executor?: "self" | `0x${string}`;
         wallet: PublicWallet | PublicEthereumWallet;
+        chain?: string | number;
         options?: {
             uiOptions?: any;
         };
@@ -230,7 +240,7 @@ declare const useSign7702Authorization: () => {
     error: undefined;
 };
 declare const useSendTransaction: () => {
-    sendTransaction: ({ transaction, wallet, options, }: {
+    sendTransaction: ({ transaction, wallet, chain, rpcUrl: rpcUrlOverride, options, }: {
         transaction: {
             to?: string;
             value?: string | number | bigint;
@@ -244,6 +254,10 @@ declare const useSendTransaction: () => {
             maxFeePerGas?: string | number | bigint;
         };
         wallet: PublicWallet | PublicEthereumWallet;
+        /** Per-call chain selector: alias | CAIP-2 id | numeric chainId. */
+        chain?: string | number;
+        /** Inline RPC override; falls back to provider config when omitted. */
+        rpcUrl?: string;
         options?: {
             uiOptions?: any;
         };

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

@@ -38,22 +38,30 @@ interface EthereumSignTransactionParams extends BaseSignTransactionParams {
         uiOptions?: BaseUIOptions;
     };
 }
-interface EthereumSendTransactionParams extends BaseSendTransactionParams {
+interface EthereumSendTransactionParams extends Omit<BaseSendTransactionParams, "rpcUrl"> {
     wallet: PublicWallet;
+    /** Per-call chain selector: alias | CAIP-2 id | numeric chainId. */
+    chain?: string | number;
+    /** Inline RPC override for this call; falls back to provider config. */
+    rpcUrl?: string;
     options?: {
         uiOptions?: BaseUIOptions;
         network?: string;
     };
 }
 interface EthereumGetBalanceParams extends BaseGetBalanceParams {
-    chain?: string;
+    /** Per-call chain selector: alias | CAIP-2 id | numeric chainId. */
+    chain?: string | number;
+    /** Inline RPC override for this call; falls back to provider config. */
+    rpcUrl?: string;
     options?: {
         commitment?: TransactionCommitment;
         minContextSlot?: number;
     };
 }
 interface EthereumGetTokenAccountsParams extends BaseGetTokenAccountsParams {
-    chain?: string;
+    chain?: string | number;
+    rpcUrl?: string;
     mint?: string;
     programId?: string;
     options?: {
@@ -165,9 +173,10 @@ declare const useSignMessage: () => {
     error: undefined;
 };
 declare const useSignTransaction: () => {
-    signTransaction: ({ transaction, wallet, options, }: {
+    signTransaction: ({ transaction, wallet, chain, options, }: {
         transaction: string | object;
         wallet: PublicWallet;
+        chain?: string | number;
         options?: {
             uiOptions?: SignTransactionUIOptions;
         };
@@ -209,11 +218,12 @@ declare const useSignTypedData: () => {
     error: undefined;
 };
 declare const useSign7702Authorization: () => {
-    signAuthorization: ({ contractAddress, nonce, executor, wallet, options, }: {
+    signAuthorization: ({ contractAddress, nonce, executor, wallet, chain, options, }: {
         contractAddress: `0x${string}`;
         nonce?: number;
         executor?: "self" | `0x${string}`;
         wallet: PublicWallet | PublicEthereumWallet;
+        chain?: string | number;
         options?: {
             uiOptions?: any;
         };
@@ -230,7 +240,7 @@ declare const useSign7702Authorization: () => {
     error: undefined;
 };
 declare const useSendTransaction: () => {
-    sendTransaction: ({ transaction, wallet, options, }: {
+    sendTransaction: ({ transaction, wallet, chain, rpcUrl: rpcUrlOverride, options, }: {
         transaction: {
             to?: string;
             value?: string | number | bigint;
@@ -244,6 +254,10 @@ declare const useSendTransaction: () => {
             maxFeePerGas?: string | number | bigint;
         };
         wallet: PublicWallet | PublicEthereumWallet;
+        /** Per-call chain selector: alias | CAIP-2 id | numeric chainId. */
+        chain?: string | number;
+        /** Inline RPC override; falls back to provider config when omitted. */
+        rpcUrl?: string;
         options?: {
             uiOptions?: any;
         };

package/dist/index.d.mts

@@ -1,10 +1,10 @@
 export { LoginWithEmailState, PasskeyStatusEntry, RegisterPasskeyResult, UseAddPasskeyResult, UseEphemeralSignerResult, UseLoginWithEmailCallbacks, UsePasskeyStatusResult, UseRemovePasskeyResult, useAddPasskey, useEphemeralSigner, useLoginWithEmail, usePasskeyStatus, useRegisterPasskey, useRemovePasskey, useUser } from '@moon-x/core/react';
-import { WalletListEntry, AuthAppearance, PrefillConfig, WalletChainType, MoonKeyThemeConfig, PasskeyEnrollConfig, SignMessageConfig, ExportKeyConfig, SignTransactionConfig, SendTransactionConfig, Chain, LogoutResponse, EmailOtpFlowState, SendEmailOtpResponse, Wallet } from '@moon-x/core/types';
-export { Chain, EphemeralSigner, EphemeralSignerChain, EphemeralSignerScheme, EphemeralSignerWallet, Factor, IdpProvider, ListEphemeralSignersResult, Network, ProvisionEphemeralSignerParams, ProvisionEphemeralSignerResult, PublicEthereumWallet, PublicWallet, RevokeEphemeralSignerParams, WalletConnectConfig, WalletListEntry } 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-CGSlkQOw.mjs';
-export { s as solana } from './solana-Cr7r3wi8.mjs';
-export { estimateEvmGas, estimateEvmGasReserve, getChainById, getDefaultChain, getEvmGasPrice, getEvmMaxPriorityFeePerGas, getEvmNonce, getRpcUrl, isChainSupported, setChainRpcUrl, validateChainConfig } from '@moon-x/core/lib';
+export { e as ethereum } from './ethereum-lovLlqC2.mjs';
+export { s as solana } from './solana-BVrNImZ1.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 '@moon-x/core';
@@ -131,7 +131,6 @@ interface MoonKeyConfig {
     prefill?: PrefillConfig;
     walletChainType?: WalletChainType;
     isDark?: boolean;
-    theme?: MoonKeyThemeConfig;
     emailConfig?: {
         skipVerifiedSuccess?: boolean;
         verifiedDisplayTime?: number;
@@ -150,16 +149,18 @@ interface MoonKeyConfig {
     walletConnect?: {
         projectId: string;
     };
-    defaultChain?: Chain;
-    supportedChains?: Chain[];
-    solana?: {
-        rpcs: {
-            [key: string]: {
-                rpc: string;
-                rpcSubscriptions?: string;
-            };
-        };
-    };
+    /**
+     * Unified RPC / chain config — one list covering EVM + Solana. Each element
+     * is a bare viem `Chain` (use its built-in RPC), an `{ chain, rpcUrl?, wsUrl? }`
+     * EVM entry (to override the RPC), or a `{ id, rpcUrl, wsUrl? }` Solana entry.
+     */
+    chains?: ChainConfigItem[];
+    /**
+     * Which configured chain to use by default. Referenced by alias, CAIP-2 id,
+     * or numeric chainId — e.g. "eth:base" | "eip155:8453" | 8453 |
+     * "solana:mainnet". Defaults to the first configured chain when omitted.
+     */
+    defaultChain?: string | number;
 }
 interface MoonKeyProviderProps$1 {
     publishableKey: string;
@@ -294,6 +295,134 @@ interface MoonKeyProviderProps {
 }
 declare const MoonKeyProvider: React$1.FC<MoonKeyProviderProps>;
 
+/**
+ * MoonKey Theme - matches CSS variables from styles.css:66-95
+ * Only customizable properties are included (colors, border-radius, font-family)
+ */
+interface MoonKeyTheme {
+    colors: {
+        accent: string;
+        accentForeground: string;
+        accentDark: string;
+        accentDarkest: string;
+        accentLight: string;
+        accentLightest: string;
+        background: string;
+        background2: string;
+        background3: string;
+        foreground: string;
+        foreground2: string;
+        foreground3: string;
+        foreground4: string;
+        foregroundAccent: string;
+        success: string;
+        successForeground: string;
+        error: string;
+        errorForeground: string;
+        errorLight: string;
+        border: string;
+    };
+    borderRadius: {
+        sm: string;
+        md: string;
+        lg: string;
+        full: string;
+    };
+    fontFamily: string;
+}
+declare const lightTheme: MoonKeyTheme;
+declare const darkTheme: MoonKeyTheme;
+/**
+ * Converts MoonKeyTheme to CSS custom properties
+ * Maps ONLY to the 25 variables defined in styles.css:66-95
+ */
+declare function themeToCSS(theme: MoonKeyTheme): React.CSSProperties;
+
+/**
+ * Decide whether a CSS color reads as "dark" from its perceived luminance.
+ *
+ * Handles hex (`#RGB`, `#RGBA`, `#RRGGBB`, `#RRGGBBAA` — the alpha byte is
+ * ignored) and `rgb()` / `rgba()` (comma- or space-separated, with `%` or 0–255
+ * channels). Returns `undefined` for any other syntax (`hsl()`, named colors,
+ * CSS vars) so callers can fall back to the resolved display mode instead of
+ * silently assuming "light".
+ */
+declare function isColorDark(color: string): boolean | undefined;
+/**
+ * Determines if dark mode should be used based on theme configuration.
+ *
+ * Resolution order:
+ *  - `displayMode: "dark"` / `"light"` — explicit override, always wins.
+ *  - `displayMode: "auto"` — follows the OS `prefers-color-scheme` (when available).
+ *  - 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 isDarkAppearance(appearance: AuthAppearance | undefined): boolean;
+/** Return a shallow copy of `src` containing only defined, non-empty values. */
+declare function definedOnly<T extends object>(src: T | undefined): Partial<T>;
+/**
+ * Resolve the deep design tokens set inline on an {@link AuthAppearance} into a
+ * single flat {@link AppearanceModeTokens}. Priority (low → high): the base
+ * token groups on `appearance` → per-mode (`appearance.light` when light /
+ * `appearance.dark` when dark). `appearance.borderRadius` is only folded here
+ * when given as an object (the preset string is expanded in appearanceToTheme).
+ */
+declare function resolveAppearanceTokens(appearance: AuthAppearance | undefined, isDark: boolean): AppearanceModeTokens;
+/**
+ * Resolve `appearance.logo` (string or object) into a concrete src plus
+ * optional sizing/alignment, picking the dark-mode variant when applicable.
+ */
+declare function resolveLogo(logo: AuthAppearance["logo"], isDark: boolean): {
+    src: string;
+    height?: number;
+    align?: "left" | "center";
+} | undefined;
+/**
+ * Derives the `--moonkey-*` palette (colors / radius / font) from an
+ * AuthAppearance. Used by ScopedContainer so the SDK owns its own derivation.
+ *
+ * Merge priority (lowest → highest): accent/background derivations →
+ * `appearance.colors` + per-mode (`appearance.light` / `dark`).
+ */
+declare function appearanceToTheme(appearance: AuthAppearance | undefined, isDark?: boolean): Partial<MoonKeyTheme>;
+/**
+ * Derives the newer `--moonx-*` CSS variables (warning/info/link/ring colors,
+ * granular radii, typography scale, card and backdrop tokens) from an
+ * {@link AuthAppearance}. Only explicitly-set tokens are emitted, so components
+ * fall back to their `--moonkey-*` defaults via CSS `var(..., fallback)` when
+ * unset.
+ */
+declare function appearanceToMoonxVars(appearance: AuthAppearance | undefined, isDark: boolean): Record<string, string>;
+/**
+ * Derives per-component override CSS variables (`--moonx-<component>-*`) from
+ * `appearance.components`. Lets a host style the card / button / input
+ * independently; unset fields fall through to the global tokens.
+ */
+declare function appearanceToComponentVars(appearance: AuthAppearance | undefined): Record<string, string>;
+/**
+ * Collect the font URLs referenced by an appearance's typography tokens (base +
+ * per-mode) so the SDK can inject the corresponding <link rel="stylesheet">
+ * elements.
+ */
+declare function resolveFontUrls(appearance: AuthAppearance | undefined): string[];
+/**
+ * Resolve an {@link AuthAppearance} into the full flat CSS-variable map for
+ * surfaces that paint the appearance onto their own root (e.g. the demo applying
+ * it to `<html>`): the base light/dark `--moonkey-*` palette merged with the
+ * appearance derivations, plus the granular `--moonx-*` tokens and per-component
+ * overrides.
+ *
+ * Shares {@link appearanceToTheme} / {@link appearanceToMoonxVars} /
+ * {@link appearanceToComponentVars} with the SDK's {@link ScopedContainer} so
+ * the derivations stay aligned. Note this does NOT apply the resolved
+ * `customTheme` layer that ScopedContainer folds on top, so a host using
+ * AuthProvider's resolved theme is the source of truth for the embedded UI;
+ * this helper covers appearance-only surfaces.
+ */
+declare function appearanceToCssVars(appearance: AuthAppearance | undefined, isDark: boolean): Record<string, string>;
+
 declare class SessionExpiredError extends Error {
     walletType: string;
     walletAddress?: string;
@@ -312,4 +441,4 @@ declare const getReconnectionInfo: (error: any) => {
     walletAddress?: string;
 } | null;
 
-export { type AttachOAuthState, type BaseConnectedEthereumWallet, type BaseConnectedSolanaWallet, type ConnectWalletCallbacks, type ConnectWalletParams, type DetachOAuthResult, type DetachOAuthState, type MoonKeyConfig, type MoonKeyInstance, MoonKeyProvider, type MoonKeyProviderProps$1 as MoonKeyProviderProps, 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, getReconnectionInfo, requiresReconnection, useAttachOAuth, useConnectWallet, useDetachOAuth, useLoginWithOAuth, useMoonKey, useOAuthCompletion };
+export { type AttachOAuthState, type BaseConnectedEthereumWallet, type BaseConnectedSolanaWallet, type ConnectWalletCallbacks, type ConnectWalletParams, type DetachOAuthResult, type DetachOAuthState, type MoonKeyConfig, type MoonKeyInstance, MoonKeyProvider, type MoonKeyProviderProps$1 as MoonKeyProviderProps, type MoonKeyTheme, 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, useMoonKey, useOAuthCompletion };

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 export { LoginWithEmailState, PasskeyStatusEntry, RegisterPasskeyResult, UseAddPasskeyResult, UseEphemeralSignerResult, UseLoginWithEmailCallbacks, UsePasskeyStatusResult, UseRemovePasskeyResult, useAddPasskey, useEphemeralSigner, useLoginWithEmail, usePasskeyStatus, useRegisterPasskey, useRemovePasskey, useUser } from '@moon-x/core/react';
-import { WalletListEntry, AuthAppearance, PrefillConfig, WalletChainType, MoonKeyThemeConfig, PasskeyEnrollConfig, SignMessageConfig, ExportKeyConfig, SignTransactionConfig, SendTransactionConfig, Chain, LogoutResponse, EmailOtpFlowState, SendEmailOtpResponse, Wallet } from '@moon-x/core/types';
-export { Chain, EphemeralSigner, EphemeralSignerChain, EphemeralSignerScheme, EphemeralSignerWallet, Factor, IdpProvider, ListEphemeralSignersResult, Network, ProvisionEphemeralSignerParams, ProvisionEphemeralSignerResult, PublicEthereumWallet, PublicWallet, RevokeEphemeralSignerParams, WalletConnectConfig, WalletListEntry } 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-CWhbeptv.js';
-export { s as solana } from './solana-nUvZo4Zp.js';
-export { estimateEvmGas, estimateEvmGasReserve, getChainById, getDefaultChain, getEvmGasPrice, getEvmMaxPriorityFeePerGas, getEvmNonce, getRpcUrl, isChainSupported, setChainRpcUrl, validateChainConfig } from '@moon-x/core/lib';
+export { e as ethereum } from './ethereum-Eg3cJKce.js';
+export { s as solana } from './solana-C9rN8lxH.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 '@moon-x/core';
@@ -131,7 +131,6 @@ interface MoonKeyConfig {
     prefill?: PrefillConfig;
     walletChainType?: WalletChainType;
     isDark?: boolean;
-    theme?: MoonKeyThemeConfig;
     emailConfig?: {
         skipVerifiedSuccess?: boolean;
         verifiedDisplayTime?: number;
@@ -150,16 +149,18 @@ interface MoonKeyConfig {
     walletConnect?: {
         projectId: string;
     };
-    defaultChain?: Chain;
-    supportedChains?: Chain[];
-    solana?: {
-        rpcs: {
-            [key: string]: {
-                rpc: string;
-                rpcSubscriptions?: string;
-            };
-        };
-    };
+    /**
+     * Unified RPC / chain config — one list covering EVM + Solana. Each element
+     * is a bare viem `Chain` (use its built-in RPC), an `{ chain, rpcUrl?, wsUrl? }`
+     * EVM entry (to override the RPC), or a `{ id, rpcUrl, wsUrl? }` Solana entry.
+     */
+    chains?: ChainConfigItem[];
+    /**
+     * Which configured chain to use by default. Referenced by alias, CAIP-2 id,
+     * or numeric chainId — e.g. "eth:base" | "eip155:8453" | 8453 |
+     * "solana:mainnet". Defaults to the first configured chain when omitted.
+     */
+    defaultChain?: string | number;
 }
 interface MoonKeyProviderProps$1 {
     publishableKey: string;
@@ -294,6 +295,134 @@ interface MoonKeyProviderProps {
 }
 declare const MoonKeyProvider: React$1.FC<MoonKeyProviderProps>;
 
+/**
+ * MoonKey Theme - matches CSS variables from styles.css:66-95
+ * Only customizable properties are included (colors, border-radius, font-family)
+ */
+interface MoonKeyTheme {
+    colors: {
+        accent: string;
+        accentForeground: string;
+        accentDark: string;
+        accentDarkest: string;
+        accentLight: string;
+        accentLightest: string;
+        background: string;
+        background2: string;
+        background3: string;
+        foreground: string;
+        foreground2: string;
+        foreground3: string;
+        foreground4: string;
+        foregroundAccent: string;
+        success: string;
+        successForeground: string;
+        error: string;
+        errorForeground: string;
+        errorLight: string;
+        border: string;
+    };
+    borderRadius: {
+        sm: string;
+        md: string;
+        lg: string;
+        full: string;
+    };
+    fontFamily: string;
+}
+declare const lightTheme: MoonKeyTheme;
+declare const darkTheme: MoonKeyTheme;
+/**
+ * Converts MoonKeyTheme to CSS custom properties
+ * Maps ONLY to the 25 variables defined in styles.css:66-95
+ */
+declare function themeToCSS(theme: MoonKeyTheme): React.CSSProperties;
+
+/**
+ * Decide whether a CSS color reads as "dark" from its perceived luminance.
+ *
+ * Handles hex (`#RGB`, `#RGBA`, `#RRGGBB`, `#RRGGBBAA` — the alpha byte is
+ * ignored) and `rgb()` / `rgba()` (comma- or space-separated, with `%` or 0–255
+ * channels). Returns `undefined` for any other syntax (`hsl()`, named colors,
+ * CSS vars) so callers can fall back to the resolved display mode instead of
+ * silently assuming "light".
+ */
+declare function isColorDark(color: string): boolean | undefined;
+/**
+ * Determines if dark mode should be used based on theme configuration.
+ *
+ * Resolution order:
+ *  - `displayMode: "dark"` / `"light"` — explicit override, always wins.
+ *  - `displayMode: "auto"` — follows the OS `prefers-color-scheme` (when available).
+ *  - 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 isDarkAppearance(appearance: AuthAppearance | undefined): boolean;
+/** Return a shallow copy of `src` containing only defined, non-empty values. */
+declare function definedOnly<T extends object>(src: T | undefined): Partial<T>;
+/**
+ * Resolve the deep design tokens set inline on an {@link AuthAppearance} into a
+ * single flat {@link AppearanceModeTokens}. Priority (low → high): the base
+ * token groups on `appearance` → per-mode (`appearance.light` when light /
+ * `appearance.dark` when dark). `appearance.borderRadius` is only folded here
+ * when given as an object (the preset string is expanded in appearanceToTheme).
+ */
+declare function resolveAppearanceTokens(appearance: AuthAppearance | undefined, isDark: boolean): AppearanceModeTokens;
+/**
+ * Resolve `appearance.logo` (string or object) into a concrete src plus
+ * optional sizing/alignment, picking the dark-mode variant when applicable.
+ */
+declare function resolveLogo(logo: AuthAppearance["logo"], isDark: boolean): {
+    src: string;
+    height?: number;
+    align?: "left" | "center";
+} | undefined;
+/**
+ * Derives the `--moonkey-*` palette (colors / radius / font) from an
+ * AuthAppearance. Used by ScopedContainer so the SDK owns its own derivation.
+ *
+ * Merge priority (lowest → highest): accent/background derivations →
+ * `appearance.colors` + per-mode (`appearance.light` / `dark`).
+ */
+declare function appearanceToTheme(appearance: AuthAppearance | undefined, isDark?: boolean): Partial<MoonKeyTheme>;
+/**
+ * Derives the newer `--moonx-*` CSS variables (warning/info/link/ring colors,
+ * granular radii, typography scale, card and backdrop tokens) from an
+ * {@link AuthAppearance}. Only explicitly-set tokens are emitted, so components
+ * fall back to their `--moonkey-*` defaults via CSS `var(..., fallback)` when
+ * unset.
+ */
+declare function appearanceToMoonxVars(appearance: AuthAppearance | undefined, isDark: boolean): Record<string, string>;
+/**
+ * Derives per-component override CSS variables (`--moonx-<component>-*`) from
+ * `appearance.components`. Lets a host style the card / button / input
+ * independently; unset fields fall through to the global tokens.
+ */
+declare function appearanceToComponentVars(appearance: AuthAppearance | undefined): Record<string, string>;
+/**
+ * Collect the font URLs referenced by an appearance's typography tokens (base +
+ * per-mode) so the SDK can inject the corresponding <link rel="stylesheet">
+ * elements.
+ */
+declare function resolveFontUrls(appearance: AuthAppearance | undefined): string[];
+/**
+ * Resolve an {@link AuthAppearance} into the full flat CSS-variable map for
+ * surfaces that paint the appearance onto their own root (e.g. the demo applying
+ * it to `<html>`): the base light/dark `--moonkey-*` palette merged with the
+ * appearance derivations, plus the granular `--moonx-*` tokens and per-component
+ * overrides.
+ *
+ * Shares {@link appearanceToTheme} / {@link appearanceToMoonxVars} /
+ * {@link appearanceToComponentVars} with the SDK's {@link ScopedContainer} so
+ * the derivations stay aligned. Note this does NOT apply the resolved
+ * `customTheme` layer that ScopedContainer folds on top, so a host using
+ * AuthProvider's resolved theme is the source of truth for the embedded UI;
+ * this helper covers appearance-only surfaces.
+ */
+declare function appearanceToCssVars(appearance: AuthAppearance | undefined, isDark: boolean): Record<string, string>;
+
 declare class SessionExpiredError extends Error {
     walletType: string;
     walletAddress?: string;
@@ -312,4 +441,4 @@ declare const getReconnectionInfo: (error: any) => {
     walletAddress?: string;
 } | null;
 
-export { type AttachOAuthState, type BaseConnectedEthereumWallet, type BaseConnectedSolanaWallet, type ConnectWalletCallbacks, type ConnectWalletParams, type DetachOAuthResult, type DetachOAuthState, type MoonKeyConfig, type MoonKeyInstance, MoonKeyProvider, type MoonKeyProviderProps$1 as MoonKeyProviderProps, 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, getReconnectionInfo, requiresReconnection, useAttachOAuth, useConnectWallet, useDetachOAuth, useLoginWithOAuth, useMoonKey, useOAuthCompletion };
+export { type AttachOAuthState, type BaseConnectedEthereumWallet, type BaseConnectedSolanaWallet, type ConnectWalletCallbacks, type ConnectWalletParams, type DetachOAuthResult, type DetachOAuthState, type MoonKeyConfig, type MoonKeyInstance, MoonKeyProvider, type MoonKeyProviderProps$1 as MoonKeyProviderProps, type MoonKeyTheme, 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, useMoonKey, useOAuthCompletion };