@moon-x/react-sdk 0.8.1 → 0.9.0

package/README.md

@@ -25,8 +25,14 @@ export default function App() {
           accentColor: "#6366f1",
           backgroundColor: "#ffffff",
         },
-        defaultChain: mainnet,
-        supportedChains: [mainnet, sepolia],
+        // One unified list for EVM + Solana. A bare viem chain uses its
+        // built-in RPC; wrap a chain to override it; Solana entries carry an id.
+        chains: [
+          mainnet,
+          sepolia,
+          { id: "solana:mainnet", rpcUrl: "https://api.mainnet-beta.solana.com" },
+        ],
+        defaultChain: "eip155:1", // CAIP-2 | numeric (1) | name alias ("eth:sepolia")
       }}
     >
       <YourApp />
@@ -82,15 +88,14 @@ function SignDemo() {
 
 | Field | Type | Purpose |
 |---|---|---|
-| `appearance` | `AuthAppearance` | High-level theming — `accentColor`, `backgroundColor`, `displayMode` (`"light" \| "dark" \| "auto"`), `logo`, `loginHeaderTitle`, `borderRadius`, `fontFamily`. |
+| `appearance` | `AuthAppearance` | The single theming surface — branding (`accentColor`, `backgroundColor`, `displayMode`, `logo`, `loginHeaderTitle`, `fontFamily`) **and** all design tokens inline (`colors`, `borderRadius`, `typography`, `card`, `backdrop`, `components`, per-mode `light` / `dark`). See [Theming](#theming). |
 | `loginMethods` | `("email" \| "google" \| "apple" \| "wallet")[]` | Which auth methods to show in the modal. |
 | `walletChainType` | `"ethereum" \| "solana" \| "ethereum-or-solana"` | Which wallet type to create at signup. |
-| `defaultChain` / `supportedChains` | `Chain` / `Chain[]` | EVM chain config — top-level, **not nested under `ethereum`**. `Chain` is viem's type; common chains are re-exported by this package. |
-| `solana.rpcs` | `{ [cluster]: { rpc, rpcSubscriptions? } }` | Solana RPC endpoints per cluster. |
+| `chains` | `ChainConfigItem[]` | Unified RPC / chain config for **both** EVM and 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. Common viem chains are re-exported by this package. See `docs/rpc-configuration.md`. |
+| `defaultChain` | `string \| number` | Which configured chain is the default. Referenced by alias, CAIP-2 id, or numeric chainId — e.g. `"eth:base"`, `"eip155:8453"`, `8453`, `"solana:mainnet"`. Defaults to the first entry in `chains`. |
 | `walletConnect.projectId` | `string` | WalletConnect v2 project ID for external-wallet flows. |
 | `emailConfig`, `passkeyEnrollConfig`, `signMessageConfig`, `signTransactionConfig`, `sendTransactionConfig`, `exportKeyConfig` | various | Per-flow UI overrides — titles, button text, etc. |
 | `security` | `Record<string, never>` | Reserved for future per-app security knobs. The previously-configurable `assertionCacheTtlMs` was removed in Phase 4 of the presence-token gating work — every sensitive op now does a fresh WebAuthn ceremony and mints scope-bound single-use JWTs via the iframe's internal orchestrator, so there is no parent-side cache left to configure. See [Security](#security) below. |
-| `theme` | `MoonKeyThemeConfig` | Low-level token overrides — fine-grained color palette, full borderRadius scale. Most apps don't need this; `appearance` is the recommended surface. |
 
 ## Hooks
 
@@ -138,14 +143,15 @@ import { useSignMessage as useSignSolanaMessage } from "@moon-x/react-sdk/solana
 - `useSignTypedData` — EIP-712. Returns `{ signature: "0x..." }`.
 - `useSignHash` — Raw ECDSA digest sign (Privy parity — `secp256k1_sign`).
 - `useSign7702Authorization` — EIP-7702 delegation auth.
-- `useSendTransaction` — Sign + broadcast via the configured RPC.
-- `useGetBalance` — Native token balance.
+- `useSendTransaction` — Sign + broadcast. Accepts a per-call `chain` selector and an inline `rpcUrl` override (both fall back to provider config).
+- `useGetBalance` — Native token balance. Same per-call `chain` / `rpcUrl` options.
 
 **Solana hooks:**
 - `useSignMessage` — Ed25519 signature.
 - `useSignTransaction` — Signs a serialized base58 tx. Returns `{ signedTransaction: Uint8Array }`.
-- `useSendTransaction` — Sign + broadcast.
-- `useGetBalance` — Lamport balance.
+- `useSendTransaction` — Sign + broadcast. Accepts a per-call `chain` selector and an inline `rpcUrl` override.
+- `useGetBalance` — Lamport balance. Same per-call `chain` / `rpcUrl` options.
+- `useGetTokenAccounts` — SPL token accounts by owner. Same per-call `chain` / `rpcUrl` options.
 
 Every signing hook accepts `options.uiOptions.showWalletUI` to toggle modal vs headless mode. With UI, the user sees the message/transaction in a modal and the biometric prompt fires only on the Sign tap. Headless skips the modal entirely.
 
@@ -166,31 +172,99 @@ The previously-configurable `security.assertionCacheTtlMs` and per-call `require
 
 ### Theming
 
-The simplest path is `appearance`:
+All theming flows through a single `appearance` object. Set a few high-level
+branding fields (`accentColor`, `backgroundColor`, `displayMode`, `logo`,
+`loginHeaderTitle`, `fontFamily`) — the SDK derives a full palette from
+`accentColor` / `backgroundColor` — and reach for the inline design tokens
+(`colors`, `borderRadius`, `typography`, `card`, `backdrop`, `components`,
+per-mode `light` / `dark`) when you want finer control.
 
 ```tsx
 <MoonKeyProvider
   config={{
     appearance: {
+      // Branding
       accentColor: "#6366f1",
       backgroundColor: "#0f172a",
-      displayMode: "dark",
-      borderRadius: "md",            // "none" | "sm" | "md" | "lg" — or { sm, md, lg }
+      displayMode: "dark",            // "light" | "dark" | "auto"
       fontFamily: "Inter, sans-serif",
-      logo: "https://example.com/logo.svg",
+      logo: { src: "/logo.svg", srcDark: "/logo-dark.svg", height: 32 },
+
+      // Design tokens (all inline on appearance)
+      colors: { warning: "#f59e0b", info: "#3b82f6", link: "#6366f1", ring: "#6366f1" },
+      borderRadius: { button: "9999px", card: "1rem", input: "0.5rem" }, // or "none" | "sm" | "md" | "lg"
+      typography: {
+        fontFamilyHeading: "Poppins, sans-serif",
+        fontUrl: "https://fonts.googleapis.com/css2?family=Poppins&display=swap",
+        letterSpacing: "0.01em",
+        fontSize: { sm: "0.8125rem", lg: "1.0625rem", xl: "1.375rem" },
+      },
+      card: { shadow: "0 10px 25px -5px rgb(0 0 0 / 0.2)", padding: "1.5rem", maxWidth: "26rem" },
+      backdrop: { color: "rgb(0 0 0 / 0.5)", blur: "8px" },
+
+      // Per-mode overrides (merged on top of the base tokens for the resolved mode)
+      dark: { colors: { background: "#0b0b0f" } },
     },
   }}
 >
 ```
 
-You can dynamically update appearance at runtime — useful for light/dark mode toggles:
+Update appearance at runtime — handy for a light/dark toggle:
 
 ```tsx
 const { setAppearance } = useMoonKey();
 setAppearance({ displayMode: colorScheme });
 ```
 
-For finer control (overriding derived tokens like `accentDark`, `background2`, etc.), pass a `theme: MoonKeyThemeConfig`. The merge order is: base theme → `appearance` derivations → explicit `theme` overrides.
+**Merge order** (low → high): base light/dark theme → `accentColor` /
+`backgroundColor` derivations → `appearance` tokens (`colors`, `borderRadius`, …)
+→ per-mode `appearance.light` / `appearance.dark`. So an explicit `appearance`
+token always wins over the high-level derivations.
+
+#### Token reference
+
+The original palette/radius/font emit `--moonkey-*` CSS variables; the newer tokens
+emit `--moonx-*` (each with a `--moonkey-*` fallback, so defaults are unchanged until set).
+
+| Group | Tokens | CSS variables |
+|---|---|---|
+| `colors` | `accent`, `accentForeground`, `background`, `background2/3`, `foreground`, `foreground2–4`, `border`, `success`, `error`, … | `--moonkey-color-*` |
+| `colors` | `warning`, `info`, `link`, `ring` (focus) | `--moonx-color-*` |
+| `borderRadius` | `sm`, `md`, `lg`, `full` | `--moonkey-border-radius-*` |
+| `borderRadius` | `button`, `card`, `input` | `--moonx-radius-*` |
+| `typography` | `fontFamilyHeading`, `letterSpacing`, `fontSize.{sm,lg,xl}`, `fontWeight.{medium,bold}` | `--moonx-font-*`, `--moonx-letter-spacing` |
+| `typography` | `fontUrl` | injected `<link rel="stylesheet">` |
+| `card` | `padding`, `shadow`, `borderWidth`, `maxWidth` | `--moonx-card-*` |
+| `backdrop` | `color`, `blur` | `--moonx-backdrop-*` |
+
+#### Per-component overrides
+
+For finer control, `appearance.components` styles individual surfaces — `card`,
+`button`, `input` — independently of the global tokens. `button` and `input`
+accept `background`, `text`, `border` (color), `borderWidth`, and `radius`;
+`card` accepts the same minus `background` (the card surface **is** the global
+`backgroundColor`). Anything you omit falls through to the global tokens /
+`--moonkey-*` defaults. The header is styled via the typography tokens instead
+(`appearance.typography.colorHeading`, `fontFamilyHeading`, …).
+
+```tsx
+<MoonKeyProvider
+  config={{
+    appearance: {
+      components: {
+        card:   { border: "#23233a", radius: "1rem" },
+        button: { background: "#a78bfa", text: "#0b0b14", radius: "9999px" },
+        input:  { background: "#15151f", border: "#23233a", borderWidth: "1px" },
+      },
+    },
+  }}
+>
+```
+
+Each field maps to a `--moonx-<component>-*` CSS variable (e.g. `--moonx-card-bg`,
+`--moonx-button-border-color`); `radius` reuses `--moonx-radius-<component>`.
+Overrides layer **on top of** the global tokens, so you can restyle just the card
+while everything else follows the theme.
 
 ## EVM chain helpers
 
@@ -204,15 +278,20 @@ import {
   estimateEvmGas,
   estimateEvmGasReserve,
   getRpcUrl,
-  setChainRpcUrl,
   getChainById,
-  getDefaultChain,
   isChainSupported,
   validateChainConfig,
+  // Unified-config resolution (also used internally by the hooks):
+  resolveChainEntry,
+  resolveRpcUrl,
+  resolveWsUrl,
+  normalizeChainKey,
+  buildChainIndex,
+  isEvmEntry,
 } from "@moon-x/react-sdk";
 ```
 
-Useful when you need a pre-flight gas reserve estimate, want to override an RPC URL at runtime, or are building a custom chain-picker.
+Useful when you need a pre-flight gas reserve estimate, want to resolve a configured chain's RPC yourself, or are building a custom chain-picker.
 
 ## React Native
 

package/dist/{chunk-Y6HSLN2H.mjs → chunk-7XFCJAFG.mjs}

@@ -319,15 +319,15 @@ __export(ethereum_exports, {
 import { useSignMessage as useSharedEthSignMessage, useSignTransaction as useSharedEthSignTransaction, useSignTypedData as useSharedEthSignTypedData, useSignHash as useSharedEthSignHash, useSign7702Authorization as useSharedEthSign7702Authorization, useSendTransaction as useSharedEthSendTransaction, useGetBalance as useSharedEthGetBalance } from "@moon-x/core/react/ethereum";
 import { useWallets as useSharedWallets, useCreateWallet as useSharedCreateWallet, useImportKey as useSharedImportKey } from "@moon-x/core/react";
 import { useCallback } from "react";
-import { getChainById as getChainById2, getRpcUrl as getRpcUrl2, prepareEvmSendTransaction, prepareEvmSignTransaction } from "@moon-x/core/lib";
+import { prepareEvmSendTransaction, prepareEvmSignTransaction, resolveEvmChainEntry as resolveEvmChainEntry2, resolveRpcUrl as resolveRpcUrl2 } from "@moon-x/core/lib";
 // src/wallets/ethereum-provider.ts
-import { getChainById, getRpcUrl } from "@moon-x/core/lib";
+import { resolveEvmChainEntry, resolveRpcUrl } from "@moon-x/core/lib";
 var useEthereumProvider = function useEthereumProvider(wallet) {
     var coreSDK = useAuthSDK();
     var currentChainId = wallet.chainId || 1;
     var request = function request(args) {
         return _async_to_generator(function() {
-            var method, _args_params, params, message, messageText, response, _coreSDK_config_ethereum, _coreSDK_config, _params, transaction, defaultChain, sendRpcUrl, sendResponse, _params1, txToSign, signResponse, _params2, typedData, accountAddr, typedDataResponse, _params3, typedDataV4, accountAddrV4, typedDataV4Response, _params4, hash, secp256k1Response, _coreSDK_config_ethereum1, _coreSDK_config1, supportedChains, rpcUrl, chain, _coreSDK_config_ethereum2, _coreSDK_config2, fallbackChain, response2, data, error;
+            var method, _args_params, params, message, messageText, response, _coreSDK_config, _coreSDK_config1, _params, transaction, requestedSendChainId, sendEntry, sendRpcUrl, sendResponse, _params1, txToSign, signResponse, _params2, typedData, accountAddr, typedDataResponse, _params3, typedDataV4, accountAddrV4, typedDataV4Response, _params4, hash, secp256k1Response, _coreSDK_config2, _coreSDK_config3, defaultEntry, rpcUrl, response2, data, error;
             return _ts_generator(this, function(_state) {
                 switch(_state.label){
                     case 0:
@@ -436,14 +436,17 @@ var useEthereumProvider = function useEthereumProvider(wallet) {
                             throw new Error("eth_sendTransaction requires transaction parameter");
                         }
                         _params = _sliced_to_array(params, 1), transaction = _params[0];
-                        defaultChain = (_coreSDK_config = coreSDK.config) === null || _coreSDK_config === void 0 ? void 0 : (_coreSDK_config_ethereum = _coreSDK_config.ethereum) === null || _coreSDK_config_ethereum === void 0 ? void 0 : _coreSDK_config_ethereum.defaultChain;
-                        if (!defaultChain) {
-                            throw new Error("No defaultChain configured. Please set ethereum.defaultChain in MoonKeyProvider config.");
-                        }
-                        sendRpcUrl = getRpcUrl(defaultChain);
-                        if (!sendRpcUrl) {
-                            throw new Error("No RPC URL found for chain ".concat(defaultChain.name));
+                        requestedSendChainId = (transaction === null || transaction === void 0 ? void 0 : transaction.chainId) != null && Number.isFinite(Number(transaction.chainId)) ? Number(transaction.chainId) : void 0;
+                        sendEntry = resolveEvmChainEntry({
+                            chains: (_coreSDK_config = coreSDK.config) === null || _coreSDK_config === void 0 ? void 0 : _coreSDK_config.chains,
+                            requestedChainId: requestedSendChainId,
+                            walletChainId: currentChainId,
+                            defaultSelector: (_coreSDK_config1 = coreSDK.config) === null || _coreSDK_config1 === void 0 ? void 0 : _coreSDK_config1.defaultChain
+                        });
+                        if (!sendEntry) {
+                            throw new Error(requestedSendChainId != null ? "Transaction targets chainId ".concat(requestedSendChainId, ", which is not in the configured chains.") : "No chain configured. Please set `chains` (and optionally `defaultChain`) in MoonKeyProvider config.");
                         }
+                        sendRpcUrl = resolveRpcUrl(sendEntry);
                         return [
                             4,
                             coreSDK.sendEthereumTransactionHeadless({
@@ -542,22 +545,14 @@ var useEthereumProvider = function useEthereumProvider(wallet) {
                             secp256k1Response.signature
                         ];
                     case 16:
-                        supportedChains = (_coreSDK_config1 = coreSDK.config) === null || _coreSDK_config1 === void 0 ? void 0 : (_coreSDK_config_ethereum1 = _coreSDK_config1.ethereum) === null || _coreSDK_config_ethereum1 === void 0 ? void 0 : _coreSDK_config_ethereum1.supportedChains;
-                        if (supportedChains && supportedChains.length > 0) {
-                            chain = getChainById(supportedChains, currentChainId);
-                            if (chain) {
-                                rpcUrl = getRpcUrl(chain);
-                            }
-                        }
+                        defaultEntry = resolveEvmChainEntry({
+                            chains: (_coreSDK_config2 = coreSDK.config) === null || _coreSDK_config2 === void 0 ? void 0 : _coreSDK_config2.chains,
+                            walletChainId: currentChainId,
+                            defaultSelector: (_coreSDK_config3 = coreSDK.config) === null || _coreSDK_config3 === void 0 ? void 0 : _coreSDK_config3.defaultChain
+                        });
+                        rpcUrl = defaultEntry ? resolveRpcUrl(defaultEntry) : void 0;
                         if (!rpcUrl) {
-                            ;
-                            fallbackChain = (_coreSDK_config2 = coreSDK.config) === null || _coreSDK_config2 === void 0 ? void 0 : (_coreSDK_config_ethereum2 = _coreSDK_config2.ethereum) === null || _coreSDK_config_ethereum2 === void 0 ? void 0 : _coreSDK_config_ethereum2.defaultChain;
-                            if (fallbackChain) {
-                                rpcUrl = getRpcUrl(fallbackChain);
-                            }
-                        }
-                        if (!rpcUrl) {
-                            throw new Error("Unsupported method: ".concat(method, ". No RPC configured for chain ID ").concat(currentChainId, ". Please configure 'defaultChain' and 'supportedChains' in MoonKeyProvider."));
+                            throw new Error("Unsupported method: ".concat(method, ". No RPC configured for chain ID ").concat(currentChainId, ". Please configure 'chains' (and optionally 'defaultChain') in MoonKeyProvider."));
                         }
                         _state.label = 17;
                     case 17:
@@ -679,7 +674,7 @@ var createEthereumProvider = function createEthereumProvider(wallet, coreSDK) {
     var currentChainId = wallet.chainId || 1;
     var request = function request(args) {
         return _async_to_generator(function() {
-            var method, _args_params, params, message, messageText, response, _coreSDK_config_ethereum, _coreSDK_config, _params, transaction, defaultChain, sendTxRpcUrl, txResponse, _params1, txToSign, signResponse, _params2, typedData, typedDataResponse, _coreSDK_config_ethereum1, _coreSDK_config1, supportedChains, chain, rpcUrl, _coreSDK_config_ethereum2, _coreSDK_config2, defaultChain2, rpcResponse, rpcResult;
+            var method, _args_params, params, message, messageText, response, _coreSDK_config, _coreSDK_config1, _params, transaction, requestedSendChainId, sendEntry, sendTxRpcUrl, txResponse, _params1, txToSign, signResponse, _params2, typedData, typedDataResponse, _coreSDK_config2, _coreSDK_config3, defaultEntry, rpcUrl, rpcResponse, rpcResult;
             return _ts_generator(this, function(_state) {
                 switch(_state.label){
                     case 0:
@@ -783,11 +778,17 @@ var createEthereumProvider = function createEthereumProvider(wallet, coreSDK) {
                             throw new Error("eth_sendTransaction requires transaction parameter");
                         }
                         _params = _sliced_to_array(params, 1), transaction = _params[0];
-                        defaultChain = (_coreSDK_config = coreSDK.config) === null || _coreSDK_config === void 0 ? void 0 : (_coreSDK_config_ethereum = _coreSDK_config.ethereum) === null || _coreSDK_config_ethereum === void 0 ? void 0 : _coreSDK_config_ethereum.defaultChain;
-                        if (!defaultChain) {
-                            throw new Error("No default chain configured");
+                        requestedSendChainId = (transaction === null || transaction === void 0 ? void 0 : transaction.chainId) != null && Number.isFinite(Number(transaction.chainId)) ? Number(transaction.chainId) : void 0;
+                        sendEntry = resolveEvmChainEntry({
+                            chains: (_coreSDK_config = coreSDK.config) === null || _coreSDK_config === void 0 ? void 0 : _coreSDK_config.chains,
+                            requestedChainId: requestedSendChainId,
+                            walletChainId: currentChainId,
+                            defaultSelector: (_coreSDK_config1 = coreSDK.config) === null || _coreSDK_config1 === void 0 ? void 0 : _coreSDK_config1.defaultChain
+                        });
+                        if (!sendEntry) {
+                            throw new Error(requestedSendChainId != null ? "Transaction targets chainId ".concat(requestedSendChainId, ", which is not in the configured chains.") : "No default chain configured");
                         }
-                        sendTxRpcUrl = getRpcUrl(defaultChain);
+                        sendTxRpcUrl = resolveRpcUrl(sendEntry);
                         return [
                             4,
                             coreSDK.sendEthereumTransactionHeadless({
@@ -842,16 +843,12 @@ var createEthereumProvider = function createEthereumProvider(wallet, coreSDK) {
                             typedDataResponse.signature
                         ];
                     case 12:
-                        supportedChains = ((_coreSDK_config1 = coreSDK.config) === null || _coreSDK_config1 === void 0 ? void 0 : (_coreSDK_config_ethereum1 = _coreSDK_config1.ethereum) === null || _coreSDK_config_ethereum1 === void 0 ? void 0 : _coreSDK_config_ethereum1.supportedChains) || [];
-                        chain = getChainById(supportedChains, currentChainId);
-                        rpcUrl = chain ? getRpcUrl(chain) : void 0;
-                        if (!rpcUrl) {
-                            ;
-                            defaultChain2 = (_coreSDK_config2 = coreSDK.config) === null || _coreSDK_config2 === void 0 ? void 0 : (_coreSDK_config_ethereum2 = _coreSDK_config2.ethereum) === null || _coreSDK_config_ethereum2 === void 0 ? void 0 : _coreSDK_config_ethereum2.defaultChain;
-                            if (defaultChain2) {
-                                rpcUrl = getRpcUrl(defaultChain2);
-                            }
-                        }
+                        defaultEntry = resolveEvmChainEntry({
+                            chains: (_coreSDK_config2 = coreSDK.config) === null || _coreSDK_config2 === void 0 ? void 0 : _coreSDK_config2.chains,
+                            walletChainId: currentChainId,
+                            defaultSelector: (_coreSDK_config3 = coreSDK.config) === null || _coreSDK_config3 === void 0 ? void 0 : _coreSDK_config3.defaultChain
+                        });
+                        rpcUrl = defaultEntry ? resolveRpcUrl(defaultEntry) : void 0;
                         if (!rpcUrl) {
                             throw new Error("Unsupported method: ".concat(method, ". No RPC URL found for chain ").concat(currentChainId));
                         }
@@ -1032,9 +1029,12 @@ var useWallets = function useWallets() {
     var coreSDK = useAuthSDK();
     var shared = useSharedWallets("ethereum");
     var enhanceWallet = useCallback(function(wallet) {
-        var _coreSDK_config_ethereum_defaultChain, _coreSDK_config_ethereum, _coreSDK_config;
+        var _resolveEvmChainEntry2, _coreSDK_config, _coreSDK_config1;
         var ethereumWallet = _object_spread_props(_object_spread({}, wallet), {
-            chainId: wallet.chainId || ((_coreSDK_config = coreSDK.config) === null || _coreSDK_config === void 0 ? void 0 : (_coreSDK_config_ethereum = _coreSDK_config.ethereum) === null || _coreSDK_config_ethereum === void 0 ? void 0 : (_coreSDK_config_ethereum_defaultChain = _coreSDK_config_ethereum.defaultChain) === null || _coreSDK_config_ethereum_defaultChain === void 0 ? void 0 : _coreSDK_config_ethereum_defaultChain.id),
+            chainId: wallet.chainId || ((_resolveEvmChainEntry2 = resolveEvmChainEntry2({
+                chains: (_coreSDK_config = coreSDK.config) === null || _coreSDK_config === void 0 ? void 0 : _coreSDK_config.chains,
+                defaultSelector: (_coreSDK_config1 = coreSDK.config) === null || _coreSDK_config1 === void 0 ? void 0 : _coreSDK_config1.defaultChain
+            })) === null || _resolveEvmChainEntry2 === void 0 ? void 0 : _resolveEvmChainEntry2.chain.id),
             switchChain: function switchChain(chainId) {
                 return _async_to_generator(function() {
                     return _ts_generator(this, function(_state) {
@@ -1126,9 +1126,9 @@ var useSignTransaction = function useSignTransaction() {
     var shared = useSharedEthSignTransaction();
     return {
         signTransaction: function signTransaction(param) {
-            var transaction = param.transaction, wallet = param.wallet, options = param.options;
+            var transaction = param.transaction, wallet = param.wallet, chain = param.chain, options = param.options;
             return _async_to_generator(function() {
-                var _coreSDK_config_ethereum, _coreSDK_config, _coreSDK_config_ethereum1, _coreSDK_config1, _coreSDK_config_signTransactionConfig, _coreSDK_config2, serializedTransaction, showWalletUI, error;
+                var _coreSDK_config, _coreSDK_config1, _coreSDK_config_signTransactionConfig, _coreSDK_config2, serializedTransaction, showWalletUI, error;
                 return _ts_generator(this, function(_state) {
                     switch(_state.label){
                         case 0:
@@ -1146,8 +1146,9 @@ var useSignTransaction = function useSignTransaction() {
                                         public_address: wallet.public_address,
                                         chainId: wallet.chainId
                                     },
-                                    supportedChains: (_coreSDK_config = coreSDK.config) === null || _coreSDK_config === void 0 ? void 0 : (_coreSDK_config_ethereum = _coreSDK_config.ethereum) === null || _coreSDK_config_ethereum === void 0 ? void 0 : _coreSDK_config_ethereum.supportedChains,
-                                    defaultChain: (_coreSDK_config1 = coreSDK.config) === null || _coreSDK_config1 === void 0 ? void 0 : (_coreSDK_config_ethereum1 = _coreSDK_config1.ethereum) === null || _coreSDK_config_ethereum1 === void 0 ? void 0 : _coreSDK_config_ethereum1.defaultChain
+                                    chains: (_coreSDK_config = coreSDK.config) === null || _coreSDK_config === void 0 ? void 0 : _coreSDK_config.chains,
+                                    defaultChain: (_coreSDK_config1 = coreSDK.config) === null || _coreSDK_config1 === void 0 ? void 0 : _coreSDK_config1.defaultChain,
+                                    chainSelector: chain
                                 })
                             ];
                         case 1:
@@ -1285,24 +1286,23 @@ var useSign7702Authorization = function useSign7702Authorization() {
     var coreSDK = useAuthSDK();
     return {
         signAuthorization: function signAuthorization(param) {
-            var contractAddress = param.contractAddress, nonce = param.nonce, executor = param.executor, wallet = param.wallet, options = param.options;
+            var contractAddress = param.contractAddress, nonce = param.nonce, executor = param.executor, wallet = param.wallet, chain = param.chain, options = param.options;
             return _async_to_generator(function() {
-                var _coreSDK_config_ethereum, _coreSDK_config, walletChainId, targetChain, _coreSDK_config_ethereum1, _coreSDK_config1, derivedChainId, _coreSDK_config_signMessageConfig, _coreSDK_config2, showWalletUI, error;
+                var _coreSDK_config, _coreSDK_config1, walletChainId, targetEntry, derivedChainId, _coreSDK_config_signMessageConfig, _coreSDK_config2, showWalletUI, error;
                 return _ts_generator(this, function(_state) {
                     switch(_state.label){
                         case 0:
                             walletChainId = wallet.chainId;
-                            if (walletChainId && ((_coreSDK_config = coreSDK.config) === null || _coreSDK_config === void 0 ? void 0 : (_coreSDK_config_ethereum = _coreSDK_config.ethereum) === null || _coreSDK_config_ethereum === void 0 ? void 0 : _coreSDK_config_ethereum.supportedChains)) {
-                                targetChain = getChainById2(coreSDK.config.ethereum.supportedChains, walletChainId);
-                            }
-                            if (!targetChain) {
-                                ;
-                                targetChain = (_coreSDK_config1 = coreSDK.config) === null || _coreSDK_config1 === void 0 ? void 0 : (_coreSDK_config_ethereum1 = _coreSDK_config1.ethereum) === null || _coreSDK_config_ethereum1 === void 0 ? void 0 : _coreSDK_config_ethereum1.defaultChain;
+                            targetEntry = resolveEvmChainEntry2({
+                                chains: (_coreSDK_config = coreSDK.config) === null || _coreSDK_config === void 0 ? void 0 : _coreSDK_config.chains,
+                                selector: chain,
+                                walletChainId: walletChainId,
+                                defaultSelector: (_coreSDK_config1 = coreSDK.config) === null || _coreSDK_config1 === void 0 ? void 0 : _coreSDK_config1.defaultChain
+                            });
+                            if (!targetEntry) {
+                                throw new Error(chain != null ? 'chain "'.concat(chain, '" is not in the configured chains.') : "No chain configured. Please set `chains` (and optionally `defaultChain`) in MoonKeyProvider config.");
                             }
-                            if (!targetChain) {
-                                throw new Error("No chain configured. Please set ethereum.defaultChain in MoonKeyProvider config.");
-                            }
-                            derivedChainId = targetChain.id;
+                            derivedChainId = targetEntry.chain.id;
                             _state.label = 1;
                         case 1:
                             _state.trys.push([
@@ -1355,9 +1355,9 @@ var useSendTransaction = function useSendTransaction() {
     var shared = useSharedEthSendTransaction();
     return {
         sendTransaction: function sendTransaction(param) {
-            var transaction = param.transaction, wallet = param.wallet, options = param.options;
+            var transaction = param.transaction, wallet = param.wallet, chain = param.chain, rpcUrlOverride = param.rpcUrl, options = param.options;
             return _async_to_generator(function() {
-                var _coreSDK_config_ethereum, _coreSDK_config, _coreSDK_config_ethereum1, _coreSDK_config1, _coreSDK_config_signMessageConfig, _coreSDK_config2, _ref, preparedTx, rpcUrl, showWalletUI, response, error;
+                var _coreSDK_config, _coreSDK_config1, _coreSDK_config_signMessageConfig, _coreSDK_config2, _ref, preparedTx, rpcUrl, showWalletUI, response, error;
                 return _ts_generator(this, function(_state) {
                     switch(_state.label){
                         case 0:
@@ -1375,8 +1375,10 @@ var useSendTransaction = function useSendTransaction() {
                                         public_address: wallet.public_address,
                                         chainId: wallet.chainId
                                     },
-                                    supportedChains: (_coreSDK_config = coreSDK.config) === null || _coreSDK_config === void 0 ? void 0 : (_coreSDK_config_ethereum = _coreSDK_config.ethereum) === null || _coreSDK_config_ethereum === void 0 ? void 0 : _coreSDK_config_ethereum.supportedChains,
-                                    defaultChain: (_coreSDK_config1 = coreSDK.config) === null || _coreSDK_config1 === void 0 ? void 0 : (_coreSDK_config_ethereum1 = _coreSDK_config1.ethereum) === null || _coreSDK_config_ethereum1 === void 0 ? void 0 : _coreSDK_config_ethereum1.defaultChain
+                                    chains: (_coreSDK_config = coreSDK.config) === null || _coreSDK_config === void 0 ? void 0 : _coreSDK_config.chains,
+                                    defaultChain: (_coreSDK_config1 = coreSDK.config) === null || _coreSDK_config1 === void 0 ? void 0 : _coreSDK_config1.defaultChain,
+                                    chainSelector: chain,
+                                    rpcUrlOverride: rpcUrlOverride
                                 })
                             ];
                         case 1:
@@ -1427,7 +1429,7 @@ var useGetBalance = function useGetBalance() {
     return {
         getBalance: function getBalance(params) {
             return _async_to_generator(function() {
-                var _coreSDK_config_ethereum, _coreSDK_config, walletChainId, targetChain, _coreSDK_config_ethereum1, _coreSDK_config1, rpcUrl, error;
+                var _params_rpcUrl, _coreSDK_config, _coreSDK_config1, walletChainId, entry, rpcUrl, error;
                 return _ts_generator(this, function(_state) {
                     switch(_state.label){
                         case 0:
@@ -1438,19 +1440,18 @@ var useGetBalance = function useGetBalance() {
                                 3
                             ]);
                             walletChainId = params.wallet.chainId;
-                            if (walletChainId && ((_coreSDK_config = coreSDK.config) === null || _coreSDK_config === void 0 ? void 0 : (_coreSDK_config_ethereum = _coreSDK_config.ethereum) === null || _coreSDK_config_ethereum === void 0 ? void 0 : _coreSDK_config_ethereum.supportedChains)) {
-                                targetChain = getChainById2(coreSDK.config.ethereum.supportedChains, walletChainId);
-                            }
-                            if (!targetChain) {
-                                ;
-                                targetChain = (_coreSDK_config1 = coreSDK.config) === null || _coreSDK_config1 === void 0 ? void 0 : (_coreSDK_config_ethereum1 = _coreSDK_config1.ethereum) === null || _coreSDK_config_ethereum1 === void 0 ? void 0 : _coreSDK_config_ethereum1.defaultChain;
-                            }
-                            if (!targetChain) {
-                                throw new Error("No chain configured. Please set ethereum.defaultChain in MoonKeyProvider config.");
+                            entry = resolveEvmChainEntry2({
+                                chains: (_coreSDK_config = coreSDK.config) === null || _coreSDK_config === void 0 ? void 0 : _coreSDK_config.chains,
+                                selector: params.chain,
+                                walletChainId: walletChainId,
+                                defaultSelector: (_coreSDK_config1 = coreSDK.config) === null || _coreSDK_config1 === void 0 ? void 0 : _coreSDK_config1.defaultChain
+                            });
+                            if (params.chain != null && !entry && !params.rpcUrl) {
+                                throw new Error('chain "'.concat(params.chain, '" is not in the configured chains.'));
                             }
-                            rpcUrl = getRpcUrl2(targetChain);
+                            rpcUrl = (_params_rpcUrl = params.rpcUrl) !== null && _params_rpcUrl !== void 0 ? _params_rpcUrl : entry ? resolveRpcUrl2(entry) : void 0;
                             if (!rpcUrl) {
-                                throw new Error("No RPC URL found for chain ".concat(targetChain.name, ". Chain may be missing rpcUrls configuration."));
+                                throw new Error("No RPC URL \u2014 set `chains` (and optionally `defaultChain`) in MoonKeyProvider config, or pass an `rpcUrl`.");
                             }
                             return [
                                 4,