@b3dotfun/sdk 0.1.69-alpha.11 → 0.1.69-alpha.13

package/dist/esm/wallet/utils/createWalletConfig.js

@@ -0,0 +1,21 @@
+import { supportedChains } from "../../shared/constants/chains/supported.js";
+import { http } from "viem";
+import { createConfig } from "wagmi";
+import { coinbaseWallet, injected } from "wagmi/connectors";
+/** Default connectors: injected (MetaMask, Rabby, Brave, etc.) + Coinbase Wallet. */
+const DEFAULT_CONNECTORS = [injected(), coinbaseWallet({ appName: "B3" })];
+/**
+ * Creates a generic wagmi config with sensible defaults.
+ * No ecosystem wallet, no B3-specific concerns.
+ */
+export function createWalletConfig(options = {}) {
+    const { chains = supportedChains, connectors = DEFAULT_CONNECTORS, rpcUrls } = options;
+    if (chains.length === 0) {
+        throw new Error("createWalletConfig: at least one chain must be provided");
+    }
+    return createConfig({
+        chains: [chains[0], ...chains.slice(1)],
+        transports: Object.fromEntries(chains.map(chain => [chain.id, http(rpcUrls?.[chain.id])])),
+        connectors,
+    });
+}

package/dist/types/anyspend/react/components/checkout/AnySpendCheckout.d.ts

@@ -121,5 +121,7 @@ export interface AnySpendCheckoutProps {
     feeOnTop?: boolean;
     /** When true, identity verification (KYC) is required before card payment. Defaults to false. */
     kycEnabled?: boolean;
+    /** Extra metadata included under the 'callbackMetadata' key in the order's callbackMetadata (e.g. workflowId, orgId from checkout session) */
+    callbackMetadata?: Record<string, unknown>;
 }
-export declare function AnySpendCheckout({ mode, recipientAddress, destinationTokenAddress, destinationTokenChainId, items, totalAmount: totalAmountOverride, organizationName, organizationLogo, themeColor, buttonText, checkoutSessionId, onSuccess, onError, returnUrl, returnLabel, classes, footer, defaultPaymentMethod, senderAddress, slots, content, theme, showPoints, showOrderId, shipping: shippingProp, tax, discount: discountProp, summaryLines, formSchema, formComponent, onFormSubmit, shippingOptions, collectShippingAddress, onShippingChange: onShippingChangeProp, enableDiscountCode, onDiscountApplied: onDiscountAppliedProp, validateDiscount, variablePricing, feeOnTop, kycEnabled, }: AnySpendCheckoutProps): import("react/jsx-runtime").JSX.Element;
+export declare function AnySpendCheckout({ mode, recipientAddress, destinationTokenAddress, destinationTokenChainId, items, totalAmount: totalAmountOverride, organizationName, organizationLogo, themeColor, buttonText, checkoutSessionId, onSuccess, onError, returnUrl, returnLabel, classes, footer, defaultPaymentMethod, senderAddress, slots, content, theme, showPoints, showOrderId, shipping: shippingProp, tax, discount: discountProp, summaryLines, formSchema, formComponent, onFormSubmit, shippingOptions, collectShippingAddress, onShippingChange: onShippingChangeProp, enableDiscountCode, onDiscountApplied: onDiscountAppliedProp, validateDiscount, variablePricing, feeOnTop, kycEnabled, callbackMetadata: callbackMetadataProp, }: AnySpendCheckoutProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/global-account/react/components/B3Provider/B3Provider.d.ts

@@ -2,13 +2,14 @@ import { CreateOnrampOrderParams } from "@b3dotfun/sdk/anyspend/react/hooks/useA
 import { CreateOrderParams } from "@b3dotfun/sdk/anyspend/react/hooks/useAnyspendCreateOrder";
 import { PermissionsConfig } from "@b3dotfun/sdk/global-account/types/permissions";
 import "@relayprotocol/relay-kit-ui/styles.css";
+import { QueryClient } from "@tanstack/react-query";
 import { Account, EIP1193, Wallet } from "thirdweb/wallets";
 import { CreateConnectorFn } from "wagmi";
 import { ClientType } from "../../../client-manager";
 /**
  * Main B3Provider component
  */
-export declare function B3Provider({ theme, children, accountOverride, environment, automaticallySetFirstEoa, defaultEoaProvider, simDuneApiKey, toaster: _toaster, clientType, rpcUrls, partnerId, stripePublishableKey, onConnect, onLogout, connectors, overrideDefaultConnectors, createClientReferenceId, defaultPermissions, disableBSMNTAuthentication, }: {
+export declare function B3Provider({ theme, children, accountOverride, environment, automaticallySetFirstEoa, defaultEoaProvider, simDuneApiKey, toaster: _toaster, clientType, rpcUrls, partnerId, stripePublishableKey, onConnect, onLogout, connectors, overrideDefaultConnectors, createClientReferenceId, defaultPermissions, disableBSMNTAuthentication, queryClient, }: {
     theme: "light" | "dark";
     children: React.ReactNode;
     accountOverride?: Account;
@@ -33,4 +34,6 @@ export declare function B3Provider({ theme, children, accountOverride, environme
     createClientReferenceId?: (params: CreateOrderParams | CreateOnrampOrderParams) => Promise<string>;
     defaultPermissions?: PermissionsConfig;
     disableBSMNTAuthentication?: boolean;
+    /** Provide your own QueryClient for React Query. If omitted, WalletProvider creates one internally. */
+    queryClient?: QueryClient;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/types/global-account/react/utils/createWagmiConfig.d.ts

@@ -1,4 +1,4 @@
-import { type CreateConnectorFn } from "wagmi";
+import type { CreateConnectorFn } from "wagmi";
 export interface CreateWagmiConfigOptions {
     partnerId: string;
     rpcUrls?: Record<number, string>;
@@ -6,7 +6,8 @@ export interface CreateWagmiConfigOptions {
     overrideDefaultConnectors?: boolean;
 }
 /**
- * Creates a wagmi config with optional custom RPC URLs and connectors
+ * Creates a wagmi config with the B3 ecosystem wallet connector.
+ * Delegates to createWalletConfig and adds the ecosystem connector on top.
  * @param options.partnerId - Partner ID for the ecosystem wallet
  * @param options.rpcUrls - Optional mapping of chain IDs to RPC URLs
  * @param options.connectors - Additional connectors to include
@@ -14,14 +15,4 @@ export interface CreateWagmiConfigOptions {
  */
 export declare function createWagmiConfig(options: CreateWagmiConfigOptions): import("wagmi").Config<readonly [import("viem").Chain, ...import("viem").Chain[]], {
     [k: string]: import("viem").HttpTransport<undefined, false>;
-}, (CreateConnectorFn | CreateConnectorFn<import("thirdweb/dist/types/adapters/eip1193").EIP1193Provider | undefined, {
-    connect<withCapabilities extends boolean = false>(parameters?: import("@thirdweb-dev/wagmi-adapter").ConnectionOptions<withCapabilities> | undefined): Promise<{
-        accounts: withCapabilities extends true ? readonly {
-            address: `0x${string}`;
-            capabilities: Record<string, unknown>;
-        }[] : readonly `0x${string}`[];
-        chainId: number;
-    }>;
-}, {
-    "thirdweb:lastChainId": number;
-}>)[]>;
+}, CreateConnectorFn[]>;

package/dist/types/wallet/react/components/ConnectWallet.d.ts

@@ -0,0 +1,11 @@
+export interface ConnectWalletProps {
+    /** Theme for the modal and button. Defaults to "light". */
+    theme?: "light" | "dark";
+    /** Label for the connect button. Defaults to "Connect Wallet". */
+    buttonLabel?: string;
+}
+/**
+ * Drop-in wallet connection component styled to match the B3 design system.
+ * Uses inline styles — works in any app without tailwind configuration.
+ */
+export declare function ConnectWallet({ theme: themeProp, buttonLabel }: ConnectWalletProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/wallet/react/components/WalletProvider.d.ts

@@ -0,0 +1,35 @@
+import { QueryClient } from "@tanstack/react-query";
+import { type Config, type CreateConnectorFn } from "wagmi";
+import type { Chain } from "viem";
+export interface WalletProviderProps {
+    children: React.ReactNode;
+    /**
+     * Chains to support. Defaults to SDK's supportedChains.
+     * Must be memoized or defined outside the component — inline arrays cause the
+     * wagmi config to rebuild on every render, losing wallet connection state.
+     */
+    chains?: Chain[];
+    /**
+     * Wagmi connectors. Must be memoized or defined outside the component — inline
+     * arrays cause the wagmi config to rebuild on every render, losing wallet connection state.
+     */
+    connectors?: CreateConnectorFn[];
+    /**
+     * Optional RPC URL overrides per chain ID.
+     * Must be memoized or defined outside the component — inline objects cause the
+     * wagmi config to rebuild on every render, losing wallet connection state.
+     */
+    rpcUrls?: Record<number, string>;
+    /** Escape hatch: pass a fully custom wagmi config. Overrides chains/connectors/rpcUrls. */
+    wagmiConfig?: Config;
+    /** Provide your own QueryClient for React Query. Defaults to an internal instance. */
+    queryClient?: QueryClient;
+    /** Whether to auto-reconnect the last wallet on mount. Defaults to false. */
+    reconnectOnMount?: boolean;
+}
+/**
+ * Standalone wallet connection provider.
+ * Wraps ThirdwebProvider, WagmiProvider, and QueryClientProvider.
+ * Use wagmi hooks (useAccount, useConnect, useDisconnect) directly inside.
+ */
+export declare function WalletProvider({ children, chains, connectors, rpcUrls, wagmiConfig: wagmiConfigProp, queryClient: queryClientProp, reconnectOnMount, }: WalletProviderProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/wallet/react/hooks/useWalletDisconnect.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Disconnect the current wallet via wagmi.
+ * Consumers should use this instead of wagmi's useDisconnect directly
+ * to ensure a consistent disconnect API across the wallet module.
+ *
+ * Note: this only disconnects the wagmi layer. When used inside B3Provider,
+ * the thirdweb auth session is managed separately by B3Provider's own logout
+ * flow (useAuthentication). ConnectWallet is intended for standalone
+ * WalletProvider usage where thirdweb auth is not involved.
+ */
+export declare function useWalletDisconnect(): {
+    disconnect: () => void;
+};

package/dist/types/wallet/react/hooks/useWalletState.d.ts

@@ -0,0 +1,31 @@
+import type { Chain } from "viem";
+import type { Connector } from "wagmi";
+export interface WalletConnector {
+    /** Display name of the wallet */
+    name: string;
+    /** Unique identifier for this connector instance */
+    uid: string;
+    /** Whether the wallet extension/app is detected in the browser */
+    isInstalled: boolean;
+    /** Connect using this connector. Returns a promise that resolves on success or rejects on failure/rejection. */
+    connect: () => Promise<void>;
+    /** Raw wagmi connector for advanced use */
+    connector: Connector;
+}
+export interface WalletState {
+    /** Connected wallet address, or undefined if not connected */
+    address: string | undefined;
+    /** Whether a wallet is currently connected */
+    isConnected: boolean;
+    /** Current chain the wallet is connected to */
+    chain: Chain | undefined;
+    /** Whether a connection attempt is in progress */
+    isPending: boolean;
+    /** Available wallet connectors, deduplicated by name */
+    connectors: WalletConnector[];
+}
+/**
+ * Unified wallet state from both thirdweb and wagmi layers.
+ * Provides available connectors with install status and connect functions.
+ */
+export declare function useWalletState(): WalletState;

package/dist/types/wallet/react/index.d.ts

@@ -0,0 +1,5 @@
+export { WalletProvider, type WalletProviderProps } from "./components/WalletProvider";
+export { createWalletConfig, type CreateWalletConfigOptions } from "../utils/createWalletConfig";
+export { useWalletDisconnect } from "./hooks/useWalletDisconnect";
+export { useWalletState, type WalletConnector, type WalletState } from "./hooks/useWalletState";
+export { ConnectWallet, type ConnectWalletProps } from "./components/ConnectWallet";

package/dist/types/wallet/utils/createWalletConfig.d.ts

@@ -0,0 +1,21 @@
+import { type CreateConnectorFn } from "wagmi";
+import type { Chain } from "viem";
+export interface CreateWalletConfigOptions {
+    /** Chains to support. Defaults to SDK's supportedChains. Must be non-empty. */
+    chains?: Chain[];
+    /**
+     * Wagmi connectors. Defaults to injected + Coinbase Wallet.
+     * Must be memoized if passed to WalletProvider — inline arrays
+     * will cause the config to rebuild on every render, losing wallet connection state.
+     */
+    connectors?: CreateConnectorFn[];
+    /** Optional RPC URL overrides per chain ID. */
+    rpcUrls?: Record<number, string>;
+}
+/**
+ * Creates a generic wagmi config with sensible defaults.
+ * No ecosystem wallet, no B3-specific concerns.
+ */
+export declare function createWalletConfig(options?: CreateWalletConfigOptions): import("wagmi").Config<readonly [Chain, ...Chain[]], {
+    [k: string]: import("viem").HttpTransport<undefined, false>;
+}, CreateConnectorFn[]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@b3dotfun/sdk",
-  "version": "0.1.69-alpha.11",
+  "version": "0.1.69-alpha.13",
   "source": "src/index.ts",
   "main": "./dist/cjs/index.js",
   "react-native": "./dist/cjs/index.native.js",
@@ -205,6 +205,16 @@
       "import": "./dist/esm/notifications/types/index.js",
       "require": "./dist/cjs/notifications/types/index.js"
     },
+    "./wallet/react": {
+      "types": "./dist/types/wallet/react/index.d.ts",
+      "import": "./dist/esm/wallet/react/index.js",
+      "require": "./dist/cjs/wallet/react/index.js"
+    },
+    "./wallet/utils/*": {
+      "types": "./dist/types/wallet/utils/*.d.ts",
+      "import": "./dist/esm/wallet/utils/*.js",
+      "require": "./dist/cjs/wallet/utils/*.js"
+    },
     "./shared/utils": {
       "types": "./dist/types/shared/utils/index.d.ts",
       "import": "./dist/esm/shared/utils/index.js",
@@ -375,6 +385,7 @@
     "thirdweb": "5.116.1",
     "tsc-alias": "^1.8.16",
     "tsc-watch": "^7.1.1",
+    "vite-tsconfig-paths": "^6.1.1",
     "vitest": "^3.2.4"
   },
   "typesVersions": {

package/src/anyspend/react/components/checkout/AnySpendCheckout.tsx

@@ -138,6 +138,8 @@ export interface AnySpendCheckoutProps {
   feeOnTop?: boolean;
   /** When true, identity verification (KYC) is required before card payment. Defaults to false. */
   kycEnabled?: boolean;
+  /** Extra metadata included under the 'callbackMetadata' key in the order's callbackMetadata (e.g. workflowId, orgId from checkout session) */
+  callbackMetadata?: Record<string, unknown>;
 }
 
 const emptyAddress: AddressData = { street: "", city: "", state: "", zip: "", country: "" };
@@ -187,6 +189,7 @@ export function AnySpendCheckout({
   variablePricing,
   feeOnTop,
   kycEnabled = false,
+  callbackMetadata: callbackMetadataProp,
 }: AnySpendCheckoutProps) {
   // ===== Variable pricing state =====
   const [variablePricingAmount, setVariablePricingAmount] = useState<string>("0");
@@ -342,8 +345,11 @@ export function AnySpendCheckout({
     if (isVariablePricingActive && variablePricingAmount !== "0") {
       meta.variablePricingAmount = variablePricingAmount;
     }
+    // Namespace caller-supplied metadata to avoid collisions with internal keys
+    if (callbackMetadataProp) meta.callbackMetadata = callbackMetadataProp;
     return Object.keys(meta).length > 0 ? meta : undefined;
   }, [
+    callbackMetadataProp,
     formData,
     selectedShipping,
     shippingAddress,

package/src/global-account/react/components/B3Provider/B3Provider.native.tsx

@@ -1,20 +1,16 @@
 import { PermissionsConfig } from "@b3dotfun/sdk/global-account/types/permissions";
-import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { WalletProvider } from "@b3dotfun/sdk/wallet/react";
 import { ThirdwebProvider } from "thirdweb/react";
 import { Account, Wallet } from "thirdweb/wallets";
 
 import { ClientType } from "../../../client-manager";
 
 import { useMemo } from "react";
-import { WagmiProvider } from "wagmi";
 import { createWagmiConfig } from "../../utils/createWagmiConfig";
 import AuthenticationProvider from "./AuthenticationProvider";
 import { B3ConfigProvider } from "./B3ConfigProvider";
 import { LocalSDKProvider } from "./LocalSDKProvider";
 
-// Create queryClient instance
-const queryClient = new QueryClient();
-
 /**
  * Main B3Provider component
  */
@@ -86,20 +82,18 @@ export function InnerProvider({
   const wagmiConfig = useMemo(() => createWagmiConfig({ partnerId, rpcUrls }), [partnerId, rpcUrls]);
 
   return (
-    <WagmiProvider config={wagmiConfig}>
-      <QueryClientProvider client={queryClient}>
-        <B3ConfigProvider
-          accountOverride={accountOverride}
-          environment={environment}
-          automaticallySetFirstEoa={false}
-          theme={theme}
-          clientType={clientType}
-          partnerId={partnerId}
-          defaultPermissions={defaultPermissions}
-        >
-          {children}
-        </B3ConfigProvider>
-      </QueryClientProvider>
-    </WagmiProvider>
+    <WalletProvider wagmiConfig={wagmiConfig}>
+      <B3ConfigProvider
+        accountOverride={accountOverride}
+        environment={environment}
+        automaticallySetFirstEoa={false}
+        theme={theme}
+        clientType={clientType}
+        partnerId={partnerId}
+        defaultPermissions={defaultPermissions}
+      >
+        {children}
+      </B3ConfigProvider>
+    </WalletProvider>
   );
 }

package/src/global-account/react/components/B3Provider/B3Provider.tsx

@@ -4,12 +4,12 @@ import { RelayKitProviderWrapper, TooltipProvider } from "@b3dotfun/sdk/global-a
 import { createWagmiConfig } from "@b3dotfun/sdk/global-account/react/utils/createWagmiConfig";
 import { PermissionsConfig } from "@b3dotfun/sdk/global-account/types/permissions";
 import { loadGA4Script } from "@b3dotfun/sdk/global-account/utils/analytics";
+import { WalletProvider } from "@b3dotfun/sdk/wallet/react";
 import "@relayprotocol/relay-kit-ui/styles.css";
-import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { QueryClient } from "@tanstack/react-query";
 import { useEffect, useMemo } from "react";
-import { ThirdwebProvider } from "thirdweb/react";
 import { Account, EIP1193, Wallet } from "thirdweb/wallets";
-import { CreateConnectorFn, WagmiProvider } from "wagmi";
+import { CreateConnectorFn } from "wagmi";
 import { ClientType, setClientType } from "../../../client-manager";
 import { StyleRoot } from "../StyleRoot";
 import { setToastContext, ToastProvider, useToastContext } from "../Toast/index";
@@ -17,9 +17,6 @@ import AuthenticationProvider from "./AuthenticationProvider";
 import { B3ConfigProvider } from "./B3ConfigProvider";
 import { LocalSDKProvider } from "./LocalSDKProvider";
 
-// Create queryClient instance
-const queryClient = new QueryClient();
-
 /**
  * Main B3Provider component
  */
@@ -44,6 +41,7 @@ export function B3Provider({
   createClientReferenceId,
   defaultPermissions,
   disableBSMNTAuthentication = false,
+  queryClient,
 }: {
   theme: "light" | "dark";
   children: React.ReactNode;
@@ -69,6 +67,8 @@ export function B3Provider({
   createClientReferenceId?: (params: CreateOrderParams | CreateOnrampOrderParams) => Promise<string>;
   defaultPermissions?: PermissionsConfig;
   disableBSMNTAuthentication?: boolean;
+  /** Provide your own QueryClient for React Query. If omitted, WalletProvider creates one internally. */
+  queryClient?: QueryClient;
 }) {
   // Initialize Google Analytics on mount
   useEffect(() => {
@@ -86,45 +86,41 @@ export function B3Provider({
   );
 
   return (
-    <ThirdwebProvider>
-      <WagmiProvider config={wagmiConfig} reconnectOnMount={false}>
-        <QueryClientProvider client={queryClient}>
-          <TooltipProvider>
-            <ToastProvider>
-              <LocalSDKProvider
-                onConnectCallback={onConnect}
-                onLogoutCallback={onLogout}
-                disableBSMNTAuthentication={disableBSMNTAuthentication}
-              >
-                <B3ConfigProvider
-                  accountOverride={accountOverride}
-                  environment={environment}
-                  automaticallySetFirstEoa={!!automaticallySetFirstEoa}
-                  theme={theme}
-                  clientType={clientType}
-                  partnerId={partnerId}
-                  stripePublishableKey={stripePublishableKey}
-                  createClientReferenceId={createClientReferenceId}
-                  defaultPermissions={defaultPermissions}
-                >
-                  <ToastContextConnector />
-                  <RelayKitProviderWrapper simDuneApiKey={simDuneApiKey}>
-                    {children}
-                    {/* For the modal https://github.com/b3-fun/b3/blob/main/packages/sdk/src/global-account/react/components/ui/dialog.tsx#L46 */}
-                    <StyleRoot id="b3-root" />
-                  </RelayKitProviderWrapper>
-                  <AuthenticationProvider
-                    partnerId={partnerId}
-                    automaticallySetFirstEoa={!!automaticallySetFirstEoa}
-                    defaultEoaProvider={defaultEoaProvider}
-                  />
-                </B3ConfigProvider>
-              </LocalSDKProvider>
-            </ToastProvider>
-          </TooltipProvider>
-        </QueryClientProvider>
-      </WagmiProvider>
-    </ThirdwebProvider>
+    <WalletProvider wagmiConfig={wagmiConfig} queryClient={queryClient}>
+      <TooltipProvider>
+        <ToastProvider>
+          <LocalSDKProvider
+            onConnectCallback={onConnect}
+            onLogoutCallback={onLogout}
+            disableBSMNTAuthentication={disableBSMNTAuthentication}
+          >
+            <B3ConfigProvider
+              accountOverride={accountOverride}
+              environment={environment}
+              automaticallySetFirstEoa={!!automaticallySetFirstEoa}
+              theme={theme}
+              clientType={clientType}
+              partnerId={partnerId}
+              stripePublishableKey={stripePublishableKey}
+              createClientReferenceId={createClientReferenceId}
+              defaultPermissions={defaultPermissions}
+            >
+              <ToastContextConnector />
+              <RelayKitProviderWrapper simDuneApiKey={simDuneApiKey}>
+                {children}
+                {/* For the modal https://github.com/b3-fun/b3/blob/main/packages/sdk/src/global-account/react/components/ui/dialog.tsx#L46 */}
+                <StyleRoot id="b3-root" />
+              </RelayKitProviderWrapper>
+              <AuthenticationProvider
+                partnerId={partnerId}
+                automaticallySetFirstEoa={!!automaticallySetFirstEoa}
+                defaultEoaProvider={defaultEoaProvider}
+              />
+            </B3ConfigProvider>
+          </LocalSDKProvider>
+        </ToastProvider>
+      </TooltipProvider>
+    </WalletProvider>
   );
 }
 

package/src/global-account/react/utils/createWagmiConfig.tsx

@@ -1,9 +1,8 @@
+import { createWalletConfig } from "@b3dotfun/sdk/wallet/utils/createWalletConfig";
 import { ecosystemWalletId } from "@b3dotfun/sdk/shared/constants";
-import { supportedChains } from "@b3dotfun/sdk/shared/constants/chains/supported";
 import { client } from "@b3dotfun/sdk/shared/utils/thirdweb";
 import { inAppWalletConnector } from "@thirdweb-dev/wagmi-adapter";
-import { http } from "viem";
-import { createConfig, type CreateConnectorFn } from "wagmi";
+import type { CreateConnectorFn } from "wagmi";
 
 export interface CreateWagmiConfigOptions {
   partnerId: string;
@@ -13,7 +12,8 @@ export interface CreateWagmiConfigOptions {
 }
 
 /**
- * Creates a wagmi config with optional custom RPC URLs and connectors
+ * Creates a wagmi config with the B3 ecosystem wallet connector.
+ * Delegates to createWalletConfig and adds the ecosystem connector on top.
  * @param options.partnerId - Partner ID for the ecosystem wallet
  * @param options.rpcUrls - Optional mapping of chain IDs to RPC URLs
  * @param options.connectors - Additional connectors to include
@@ -32,9 +32,8 @@ export function createWagmiConfig(options: CreateWagmiConfigOptions) {
 
   const finalConnectors = overrideDefaultConnectors ? connectors : [...defaultConnectors, ...connectors];
 
-  return createConfig({
-    chains: [supportedChains[0], ...supportedChains.slice(1)],
-    transports: Object.fromEntries(supportedChains.map(chain => [chain.id, http(rpcUrls?.[chain.id])])),
+  return createWalletConfig({
     connectors: finalConnectors,
+    rpcUrls,
   });
 }

package/src/wallet/__tests__/createWalletConfig.test.ts

@@ -0,0 +1,39 @@
+import { describe, it, expect } from "vitest";
+import { createWalletConfig } from "../utils/createWalletConfig";
+import { base, optimism } from "viem/chains";
+
+describe("createWalletConfig", () => {
+  it("should create a config with default chains when no options provided", () => {
+    const config = createWalletConfig();
+    // Should not throw — uses supportedChains as default
+    expect(config).toBeDefined();
+    expect(config.chains).toBeDefined();
+    expect(config.chains.length).toBeGreaterThan(0);
+  });
+
+  it("should create a config with custom chains", () => {
+    const config = createWalletConfig({ chains: [base, optimism] });
+    expect(config.chains).toHaveLength(2);
+    expect(config.chains[0].id).toBe(base.id);
+    expect(config.chains[1].id).toBe(optimism.id);
+  });
+
+  it("should throw if chains array is empty", () => {
+    expect(() => createWalletConfig({ chains: [] })).toThrow("createWalletConfig: at least one chain must be provided");
+  });
+
+  it("should accept custom RPC URLs", () => {
+    const config = createWalletConfig({
+      chains: [base],
+      rpcUrls: { [base.id]: "https://custom-rpc.example.com" },
+    });
+    expect(config).toBeDefined();
+    // Config is created without error; transport internals are opaque
+  });
+
+  it("should accept connectors", () => {
+    // Pass an empty array (valid) — connector instantiation requires browser env
+    const config = createWalletConfig({ chains: [base], connectors: [] });
+    expect(config).toBeDefined();
+  });
+});