@multiplatform.one/web3 6.0.3 → 6.1.0

package/dist/jsx/providers/walletConfig.spec.mjs

@@ -0,0 +1,45 @@
+import { describe, expect, it } from "vitest";
+import { hardhat, mainnet, sepolia } from "wagmi/chains";
+import { defaultChains, resolveChains } from "./walletConfig.mjs";
+const base = {
+  walletConnectProjectId: "",
+  appName: "test"
+};
+describe("resolveChains", () => {
+  it("filters testnets by default", () => {
+    const chains = resolveChains(base);
+    expect(chains.map(c => c.id)).not.toContain(sepolia.id);
+    expect(chains[0].id).toBe(mainnet.id);
+  });
+  it("keeps testnets when enableTestnets is on", () => {
+    const chains = resolveChains({
+      ...base,
+      enableTestnets: true
+    });
+    expect(chains.map(c => c.id)).toContain(sepolia.id);
+    expect(chains).toHaveLength(defaultChains.length);
+  });
+  it("prepends the hardhat dev chain as the default when localnet is on", () => {
+    const chains = resolveChains({
+      ...base,
+      localnet: true
+    });
+    expect(chains[0].id).toBe(hardhat.id);
+    expect(chains[0].rpcUrls.default.http[0]).toBe("http://127.0.0.1:8545");
+    expect(chains.filter(c => c.id === hardhat.id)).toHaveLength(1);
+    expect(chains.map(c => c.id)).toContain(mainnet.id);
+  });
+  it("honours a custom localnet RPC url (emulator host addresses)", () => {
+    const chains = resolveChains({
+      ...base,
+      localnet: true,
+      localnetRpcUrl: "http://10.0.2.2:8545"
+    });
+    expect(chains[0].id).toBe(hardhat.id);
+    expect(chains[0].rpcUrls.default.http[0]).toBe("http://10.0.2.2:8545");
+  });
+  it("does not add the dev chain when localnet is off", () => {
+    expect(resolveChains(base).map(c => c.id)).not.toContain(hardhat.id);
+  });
+});
+//# sourceMappingURL=walletConfig.spec.mjs.map

package/dist/jsx/providers/walletConfig.spec.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["describe","expect","it","hardhat","mainnet","sepolia","defaultChains","resolveChains","base","walletConnectProjectId","appName","chains","map","c","id","not","toContain","toBe","enableTestnets","toHaveLength","length","localnet","rpcUrls","default","http","filter","localnetRpcUrl"],"sources":["../../../src/providers/walletConfig.spec.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,QAAA,EAAUC,MAAA,EAAQC,EAAA,QAAU;AACrC,SAASC,OAAA,EAASC,OAAA,EAASC,OAAA,QAAe;AAC1C,SAASC,aAAA,EAAeC,aAAA,QAAsC;AAE9D,MAAMC,IAAA,GAAmB;EAAEC,sBAAA,EAAwB;EAAIC,OAAA,EAAS;AAAO;AAEvEV,QAAA,CAAS,iBAAiB,MAAM;EAC9BE,EAAA,CAAG,+BAA+B,MAAM;IACtC,MAAMS,MAAA,GAASJ,aAAA,CAAcC,IAAI;IACjCP,MAAA,CAAOU,MAAA,CAAOC,GAAA,CAAKC,CAAA,IAAMA,CAAA,CAAEC,EAAE,CAAC,EAAEC,GAAA,CAAIC,SAAA,CAAUX,OAAA,CAAQS,EAAE;IACxDb,MAAA,CAAOU,MAAA,CAAO,CAAC,EAAEG,EAAE,EAAEG,IAAA,CAAKb,OAAA,CAAQU,EAAE;EACtC,CAAC;EAEDZ,EAAA,CAAG,4CAA4C,MAAM;IACnD,MAAMS,MAAA,GAASJ,aAAA,CAAc;MAAE,GAAGC,IAAA;MAAMU,cAAA,EAAgB;IAAK,CAAC;IAC9DjB,MAAA,CAAOU,MAAA,CAAOC,GAAA,CAAKC,CAAA,IAAMA,CAAA,CAAEC,EAAE,CAAC,EAAEE,SAAA,CAAUX,OAAA,CAAQS,EAAE;IACpDb,MAAA,CAAOU,MAAM,EAAEQ,YAAA,CAAab,aAAA,CAAcc,MAAM;EAClD,CAAC;EAEDlB,EAAA,CAAG,qEAAqE,MAAM;IAC5E,MAAMS,MAAA,GAASJ,aAAA,CAAc;MAAE,GAAGC,IAAA;MAAMa,QAAA,EAAU;IAAK,CAAC;IACxDpB,MAAA,CAAOU,MAAA,CAAO,CAAC,EAAEG,EAAE,EAAEG,IAAA,CAAKd,OAAA,CAAQW,EAAE;IACpCb,MAAA,CAAOU,MAAA,CAAO,CAAC,EAAEW,OAAA,CAAQC,OAAA,CAAQC,IAAA,CAAK,CAAC,CAAC,EAAEP,IAAA,CAAK,uBAAuB;IAEtEhB,MAAA,CAAOU,MAAA,CAAOc,MAAA,CAAQZ,CAAA,IAAMA,CAAA,CAAEC,EAAA,KAAOX,OAAA,CAAQW,EAAE,CAAC,EAAEK,YAAA,CAAa,CAAC;IAChElB,MAAA,CAAOU,MAAA,CAAOC,GAAA,CAAKC,CAAA,IAAMA,CAAA,CAAEC,EAAE,CAAC,EAAEE,SAAA,CAAUZ,OAAA,CAAQU,EAAE;EACtD,CAAC;EAEDZ,EAAA,CAAG,+DAA+D,MAAM;IACtE,MAAMS,MAAA,GAASJ,aAAA,CAAc;MAC3B,GAAGC,IAAA;MACHa,QAAA,EAAU;MACVK,cAAA,EAAgB;IAClB,CAAC;IACDzB,MAAA,CAAOU,MAAA,CAAO,CAAC,EAAEG,EAAE,EAAEG,IAAA,CAAKd,OAAA,CAAQW,EAAE;IACpCb,MAAA,CAAOU,MAAA,CAAO,CAAC,EAAEW,OAAA,CAAQC,OAAA,CAAQC,IAAA,CAAK,CAAC,CAAC,EAAEP,IAAA,CAAK,sBAAsB;EACvE,CAAC;EAEDf,EAAA,CAAG,mDAAmD,MAAM;IAC1DD,MAAA,CAAOM,aAAA,CAAcC,IAAI,EAAEI,GAAA,CAAKC,CAAA,IAAMA,CAAA,CAAEC,EAAE,CAAC,EAAEC,GAAA,CAAIC,SAAA,CAAUb,OAAA,CAAQW,EAAE;EACvE,CAAC;AACH,CAAC","ignoreList":[]}

package/dist/jsx/providers/walletConfig.spec.native.js

@@ -0,0 +1,57 @@
+"use strict";
+
+var import_vitest = require("vitest");
+var import_chains = require("wagmi/chains");
+var import_walletConfig = require("./walletConfig.native.js");
+var base = {
+  walletConnectProjectId: "",
+  appName: "test"
+};
+(0, import_vitest.describe)("resolveChains", function () {
+  (0, import_vitest.it)("filters testnets by default", function () {
+    var chains = (0, import_walletConfig.resolveChains)(base);
+    (0, import_vitest.expect)(chains.map(function (c) {
+      return c.id;
+    })).not.toContain(import_chains.sepolia.id);
+    (0, import_vitest.expect)(chains[0].id).toBe(import_chains.mainnet.id);
+  });
+  (0, import_vitest.it)("keeps testnets when enableTestnets is on", function () {
+    var chains = (0, import_walletConfig.resolveChains)({
+      ...base,
+      enableTestnets: true
+    });
+    (0, import_vitest.expect)(chains.map(function (c) {
+      return c.id;
+    })).toContain(import_chains.sepolia.id);
+    (0, import_vitest.expect)(chains).toHaveLength(import_walletConfig.defaultChains.length);
+  });
+  (0, import_vitest.it)("prepends the hardhat dev chain as the default when localnet is on", function () {
+    var chains = (0, import_walletConfig.resolveChains)({
+      ...base,
+      localnet: true
+    });
+    (0, import_vitest.expect)(chains[0].id).toBe(import_chains.hardhat.id);
+    (0, import_vitest.expect)(chains[0].rpcUrls.default.http[0]).toBe("http://127.0.0.1:8545");
+    (0, import_vitest.expect)(chains.filter(function (c) {
+      return c.id === import_chains.hardhat.id;
+    })).toHaveLength(1);
+    (0, import_vitest.expect)(chains.map(function (c) {
+      return c.id;
+    })).toContain(import_chains.mainnet.id);
+  });
+  (0, import_vitest.it)("honours a custom localnet RPC url (emulator host addresses)", function () {
+    var chains = (0, import_walletConfig.resolveChains)({
+      ...base,
+      localnet: true,
+      localnetRpcUrl: "http://10.0.2.2:8545"
+    });
+    (0, import_vitest.expect)(chains[0].id).toBe(import_chains.hardhat.id);
+    (0, import_vitest.expect)(chains[0].rpcUrls.default.http[0]).toBe("http://10.0.2.2:8545");
+  });
+  (0, import_vitest.it)("does not add the dev chain when localnet is off", function () {
+    (0, import_vitest.expect)((0, import_walletConfig.resolveChains)(base).map(function (c) {
+      return c.id;
+    })).not.toContain(import_chains.hardhat.id);
+  });
+});
+//# sourceMappingURL=walletConfig.spec.native.js.map

package/dist/jsx/providers/walletConfig.spec.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["import_vitest","require","import_chains","import_walletConfig","base","walletConnectProjectId","appName","describe","it","chains","resolveChains","expect","map","c","id","not","toContain","sepolia","toBe","mainnet","enableTestnets","toHaveLength","defaultChains","length","localnet","hardhat","rpcUrls","default","http","filter"],"sources":["../../../src/providers/walletConfig.spec.ts"],"sourcesContent":[null],"mappings":"AAAA,YAAS;;AACT,IAAAA,aAAS,GAASC,OAAS;AAC3B,IAAAC,aAAS,GAAAD,OAAe;AAExB,IAAAE,mBAA2B,GAAAF,OAAA,2BAA4B;AAEvD,IAAAG,IAAA,GAAS;EACPC,sBAAG;EACDC,OAAA,EAAM;AACN;AACA,IAAAN,aAAO,CAAOO,QAAO,iBAAe;EACtC,CAAC,GAAAP,aAAA,CAAAQ,EAAA;IAED,IAAGC,MAAA,OAAAN,mBAAA,CAAAO,aAA4C,EAAMN,IAAA;IACnD,IAAAJ,aAAe,CAAAW,MAAA,EAAAF,MAAgB,CAAAG,GAAG,WAAMC,CAAA;MACxC,OAAOA,CAAA,CAAAC,EAAA;IACP,IAAAC,GAAO,CAAAC,SAAQ,CAAAd,aAAa,CAAAe,OAAA,CAAAH,EAAc;IAC3C,IAAAd,aAAA,CAAAW,MAAA,EAAAF,MAAA,IAAAK,EAAA,EAAAI,IAAA,CAAAhB,aAAA,CAAAiB,OAAA,CAAAL,EAAA;EAED;EACE,IAAAd,aAAe,CAAAQ,EAAA,4CAAyC;IACxD,IAAAC,MAAO,IAAO,CAAC,EAAEN,mBAAmB,CAAAO,aAAA;MACpC,GAAAN,IAAO;MAEPgB,cAAc;IACd;IACD,IAAApB,aAAA,CAAAW,MAAA,EAAAF,MAAA,CAAAG,GAAA,WAAAC,CAAA;MAEE,OAAAA,CAAA,CAAAC,EAAA;IACD,IAAAE,SAAM,CAAAd,aAAS,CAAAe,OAAc,CAAAH,EAAA;IAAA,EAC3B,EAAAd,aAAG,CAAAW,MAAA,EAAAF,MAAA,EAAAY,YAAA,CAAAlB,mBAAA,CAAAmB,aAAA,CAAAC,MAAA;EAAA;EACO,IACVvB,aAAA,CAAAQ,EAAgB;IAClB,IAACC,MAAA,OAAAN,mBAAA,CAAAO,aAAA;MACD,GAAAN,IAAO;MACPoB,QAAO;IACR;IAED,CAAG,GAAAxB,aAAA,CAAAW,MAAA,EAAAF,MAAA,IAAAK,EAAA,EAAAI,IAAA,CAAAhB,aAAyD,CAAAuB,OAAA,CAAAX,EAAA;IAC1D,IAAAd,aAAO,CAAAW,MAAc,EAAIF,MAAO,IAAAiB,OAAW,CAAAC,OAAM,CAAAC,IAAA,GAAU,EAAAV,IAAA,wBAAU;IACtE,IAAAlB,aAAA,CAAAW,MAAA,EAAAF,MAAA,CAAAoB,MAAA,WAAAhB,CAAA;MACF,OAAAA,CAAA,CAAAC,EAAA,KAAAZ,aAAA,CAAAuB,OAAA,CAAAX,EAAA","ignoreList":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multiplatform.one/web3",
-  "version": "6.0.3",
+  "version": "6.1.0",
   "description": "Web3 wallet integration for multiplatform.one ecosystem with ConnectKit and wagmi",
   "keywords": [
     "connectkit",
@@ -79,8 +79,8 @@
     "tamagui": "2.0.0-rc.41",
     "viem": "^2.48.7",
     "wagmi": "^3.6.9",
-    "@multiplatform.one/gpg": "6.0.3",
-    "@multiplatform.one/connectkit": "6.0.3"
+    "@multiplatform.one/connectkit": "6.1.0",
+    "@multiplatform.one/gpg": "6.1.0"
   },
   "devDependencies": {
     "@tamagui/build": "2.0.0-rc.41",
@@ -97,7 +97,7 @@
     "vite": "^8.0.10",
     "vite-plugin-singlefile": "^2.3.3",
     "vitest": "^4.1.5",
-    "@multiplatform.one/config": "6.0.3"
+    "@multiplatform.one/config": "6.1.0"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.62.0",

package/src/connectkit/web3Bridge.tsx

@@ -80,8 +80,14 @@ export const Web3ModalBridge: React.FC<Web3ModalBridgeProps> = ({
   useEffect(() => {
     if (isConnected) {
       // Skip the redirect/close when already on PROFILE or the SIWE screen
-      // (must be &&: with || the predicate was a tautology and always fired).
-      if (context.route !== routes.PROFILE && context.route !== routes.SIGNINWITHETHEREUM) {
+      // (must be &&: with || the predicate was a tautology and always fired),
+      // or on the GPG screen — wagmi's async auto-reconnect must not hijack
+      // (or close) an in-progress GPG sign-in.
+      if (
+        context.route !== routes.PROFILE &&
+        context.route !== routes.SIGNINWITHETHEREUM &&
+        context.route !== routes.SIGNINWITHGPG
+      ) {
         if (signInWithEthereum && !context.options?.disableSiweRedirect) {
           context.setRoute(routes.SIGNINWITHETHEREUM);
         } else {

package/src/providers/WalletProvider.native.tsx

@@ -1,7 +1,7 @@
 import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
 import type { PropsWithChildren } from "react";
 import { createContext, useContext, useEffect, useMemo, useReducer, useRef, useState } from "react";
-import { AppState, Linking, StyleSheet, View } from "react-native";
+import { AppState, Linking, Platform, StyleSheet, View } from "react-native";
 import { WebView, type WebViewMessageEvent, type WebViewProps } from "react-native-webview";
 import { http, WagmiProvider, createConfig } from "wagmi";
 import { BridgeClient } from "../bridge/BridgeClient";
@@ -11,7 +11,7 @@ import { createPostMessageTransport } from "../bridge/postMessageTransport";
 import { parseWalletReturn, shouldOpenExternally } from "./native/deepLink";
 import { buildConfigInjection, buildInjectScript } from "./native/inject";
 import { initialVisibility, nextVisibility } from "./native/visibility";
-import { type Web3Config, Web3ConfigContext, defaultChains } from "./walletConfig";
+import { type Web3Config, Web3ConfigContext, resolveChains } from "./walletConfig";
 
 type WebViewSource = NonNullable<WebViewProps["source"]>;
 
@@ -114,14 +114,25 @@ export function WalletProvider({
   }, [bridge]);
 
   const wagmiConfig = useMemo(() => {
-    const transports = Object.fromEntries(defaultChains.map((chain) => [chain.id, http()]));
+    // Same chain resolution as web (testnet filter + optional localnet dev
+    // chain) -- on native, pass localnetRpcUrl with the host address the
+    // device/emulator can reach (e.g. http://10.0.2.2:8545 on Android).
+    const chains = resolveChains(web3Config);
+    const transports = Object.fromEntries(chains.map((chain) => [chain.id, http()]));
     return createConfig({
-      chains: defaultChains,
+      chains,
       transports,
       connectors: [createBridgeConnector(bridge)],
       multiInjectedProviderDiscovery: false,
     });
-  }, [bridge]);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [
+    bridge,
+    web3Config.chains,
+    web3Config.enableTestnets,
+    web3Config.localnet,
+    web3Config.localnetRpcUrl,
+  ]);
 
   const solanaValue = useMemo<SolanaWalletContextValue>(
     () => ({ bridge: solana, publicKey, connected: publicKey !== null }),
@@ -131,13 +142,12 @@ export function WalletProvider({
   const onMessage = (event: WebViewMessageEvent) => transport.receive(event.nativeEvent.data);
 
   // No inline HTML fallback: the bundle is too large for WKWebView source={{html}}.
-  const resolvedSource =
-    webViewSource ?? (web3Config.webViewUrl ? { uri: web3Config.webViewUrl } : null);
-  if (!resolvedSource) {
-    throw new Error(
-      "WalletProvider (native): set config.webViewUrl (or pass webViewSource) to a served copy of @multiplatform.one/web3/assets/webview.html",
-    );
-  }
+  // Fall back to the documented dev setup (a static server on :8099 serving
+  // @multiplatform.one/web3/assets/webview.html; Android emulators reach the
+  // host at 10.0.2.2) instead of crashing the whole app shell when the config
+  // didn't carry a URL.
+  const defaultWebViewUrl = `http://${Platform.OS === "android" ? "10.0.2.2" : "localhost"}:8099/webview.html`;
+  const resolvedSource = webViewSource ?? { uri: web3Config.webViewUrl || defaultWebViewUrl };
 
   return (
     <Web3ConfigContext.Provider value={web3Config}>

package/src/providers/WalletProvider.tsx

@@ -6,7 +6,7 @@ import { useMemo } from "react";
 import type { Chain } from "viem";
 import { WagmiProvider, createConfig, http } from "wagmi";
 import { createMockConnector } from "./mockConnector";
-import { type Web3Config, Web3ConfigContext, defaultChains } from "./walletConfig";
+import { type Web3Config, Web3ConfigContext, resolveChains } from "./walletConfig";
 
 export interface WalletProviderProps extends PropsWithChildren {
   config: Web3Config;
@@ -34,21 +34,19 @@ export function WalletProvider({
     appDescription = "Connect your wallet",
     appUrl = isWeb && typeof window !== "undefined" ? window.location.origin : "",
     appIcon,
-    chains = defaultChains,
+    chains,
     enableTestnets = false,
+    localnet = false,
+    localnetRpcUrl,
     mockWallet = false,
   } = web3Config;
 
-  const activeChains = useMemo(() => {
-    if (enableTestnets) {
-      return chains;
-    }
-    const filtered = chains.filter((chain) => !chain.testnet);
-    if (filtered.length === 0) {
-      return chains;
-    }
-    return filtered as unknown as readonly [Chain, ...Chain[]];
-  }, [chains, enableTestnets]);
+  // Testnet filter + optional localnet dev chain (prepended -> default chain).
+  const activeChains = useMemo(
+    () => resolveChains(web3Config),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [chains, enableTestnets, localnet, localnetRpcUrl],
+  );
 
   const wagmiConfig = useMemo(() => {
     const chainIds = activeChains.map((chain) => chain.id).join(",");
@@ -59,6 +57,7 @@ export function WalletProvider({
       appIcon,
       walletConnectProjectId,
       chainIds,
+      localnetRpcUrl,
       mockWallet,
     });
     const cached = wagmiConfigCache.get(cacheKey);

package/src/providers/walletConfig.spec.ts

@@ -0,0 +1,42 @@
+import { describe, expect, it } from "vitest";
+import { hardhat, mainnet, sepolia } from "wagmi/chains";
+import { defaultChains, resolveChains, type Web3Config } from "./walletConfig";
+
+const base: Web3Config = { walletConnectProjectId: "", appName: "test" };
+
+describe("resolveChains", () => {
+  it("filters testnets by default", () => {
+    const chains = resolveChains(base);
+    expect(chains.map((c) => c.id)).not.toContain(sepolia.id);
+    expect(chains[0].id).toBe(mainnet.id);
+  });
+
+  it("keeps testnets when enableTestnets is on", () => {
+    const chains = resolveChains({ ...base, enableTestnets: true });
+    expect(chains.map((c) => c.id)).toContain(sepolia.id);
+    expect(chains).toHaveLength(defaultChains.length);
+  });
+
+  it("prepends the hardhat dev chain as the default when localnet is on", () => {
+    const chains = resolveChains({ ...base, localnet: true });
+    expect(chains[0].id).toBe(hardhat.id);
+    expect(chains[0].rpcUrls.default.http[0]).toBe("http://127.0.0.1:8545");
+    // still exactly one localnet entry ahead of the regular chains
+    expect(chains.filter((c) => c.id === hardhat.id)).toHaveLength(1);
+    expect(chains.map((c) => c.id)).toContain(mainnet.id);
+  });
+
+  it("honours a custom localnet RPC url (emulator host addresses)", () => {
+    const chains = resolveChains({
+      ...base,
+      localnet: true,
+      localnetRpcUrl: "http://10.0.2.2:8545",
+    });
+    expect(chains[0].id).toBe(hardhat.id);
+    expect(chains[0].rpcUrls.default.http[0]).toBe("http://10.0.2.2:8545");
+  });
+
+  it("does not add the dev chain when localnet is off", () => {
+    expect(resolveChains(base).map((c) => c.id)).not.toContain(hardhat.id);
+  });
+});

package/src/providers/walletConfig.ts

@@ -1,6 +1,6 @@
 import { createContext, useContext } from "react";
 import type { Chain } from "viem";
-import { arbitrum, base, mainnet, optimism, polygon, sepolia } from "wagmi/chains";
+import { arbitrum, base, hardhat, mainnet, optimism, polygon, sepolia } from "wagmi/chains";
 
 /**
  * Shared config seam for both platform variants of WalletProvider. Keeping the
@@ -25,14 +25,51 @@ export interface Web3Config {
   appIcon?: string;
   chains?: readonly [Chain, ...Chain[]];
   enableTestnets?: boolean;
+  /**
+   * Add the local dev chain (hardhat, chain 31337, `make localnet`) and make it
+   * the DEFAULT chain, so dev builds point at the local node out of the box.
+   */
+  localnet?: boolean;
+  /**
+   * Local EVM JSON-RPC endpoint when `localnet` is on. Defaults to hardhat's
+   * http://127.0.0.1:8545 -- emulators need the host address instead (e.g.
+   * http://10.0.2.2:8545 on Android).
+   */
+  localnetRpcUrl?: string;
   /** Solana JSON-RPC endpoint (native bridge + web). */
   solanaRpcUrl?: string;
+  /** Sui JSON-RPC endpoint (native bridge + web). */
+  suiRpcUrl?: string;
   /** E2E only (native): route connect through the in-WebView mock wallet. */
   mockWallet?: boolean;
   /** Native: URL serving the wallet WebView HTML (preferred over the inline string). */
   webViewUrl?: string;
 }
 
+/**
+ * Resolve the active chain list for a Web3Config: apply the testnet filter,
+ * then (when `localnet` is on) prepend the hardhat dev chain so it becomes
+ * wagmi's default chain. Shared by the web and native WalletProviders so both
+ * platforms point at the same networks.
+ */
+export function resolveChains(config: Web3Config): readonly [Chain, ...Chain[]] {
+  const {
+    chains = defaultChains,
+    enableTestnets = false,
+    localnet = false,
+    localnetRpcUrl,
+  } = config;
+  let active: Chain[] = enableTestnets ? [...chains] : chains.filter((chain) => !chain.testnet);
+  if (active.length === 0) active = [...chains];
+  if (localnet) {
+    const local: Chain = localnetRpcUrl
+      ? { ...hardhat, rpcUrls: { default: { http: [localnetRpcUrl] } } }
+      : hardhat;
+    active = [local, ...active.filter((chain) => chain.id !== hardhat.id)];
+  }
+  return active as unknown as readonly [Chain, ...Chain[]];
+}
+
 export const Web3ConfigContext = createContext<Web3Config | null>(null);
 
 export function useWeb3Config(): Web3Config {