@multiplatform.one/web3 6.0.4 → 6.3.0

package/src/connectkit/wallets/walletConfigs.tsx

@@ -210,9 +210,10 @@ export const walletConfigs: {
       brave: "https://chrome.google.com/webstore/detail/metamask/nkbihfbeogaeaoehlefnkodbefgpgknn",
       edge: "https://microsoftedge.microsoft.com/addons/detail/metamask/ejbalbakoplchlghecdalmeeeajnimhm",
     },
-    getWalletConnectDeeplink: (uri: string) => {
-      return isAndroid() ? uri : `https://metamask.app.link/wc?uri=${encodeURIComponent(uri)}`;
-    },
+    // NO getWalletConnectDeeplink: MetaMask must NEVER ride WalletConnect.
+    // The metaMaskSDK connector deep-links via its own transport in connect();
+    // every MetaMask-over-WC path keyed off this one config function
+    // (ConnectorItem's anchor, ConnectUsing's QR predicate, MobileConnectors).
   },
   "app.phantom": {
     name: "Phantom",

package/src/connectkit/web3Bridge.tsx

@@ -1,5 +1,5 @@
 import React, { useContext as useReactContext, useEffect, useMemo } from "react";
-import { useAccount, useConfig } from "wagmi";
+import { useAccount, useAccountEffect, useConfig } from "wagmi";
 
 import {
   ModalState,
@@ -13,6 +13,7 @@ import { Web3ScreenRegistrar } from "./screens";
 import { ensureSiwwConnectors } from "./connectors/ensureSiwwConnectors";
 import { useChainIsSupported } from "./hooks/useChainIsSupported";
 import { useConnectCallback, useConnectCallbackProps } from "./hooks/useConnectCallback";
+import { clearConnectIntent, consumeConnectIntent } from "./siwe/connectIntent";
 import { SIWEContext } from "./siwe/SIWEContext";
 import { GpgContext } from "@multiplatform.one/gpg";
 import { useWallet } from "./wallets/useWallets";
@@ -90,6 +91,14 @@ export const Web3ModalBridge: React.FC<Web3ModalBridgeProps> = ({
       ) {
         if (signInWithEthereum && !context.options?.disableSiweRedirect) {
           context.setRoute(routes.SIGNINWITHETHEREUM);
+          // Keep ONE modal open across connect → sign. On mobile the wallet deeplink
+          // remounts (often reloads) the page, so we come back with the modal closed;
+          // setting the route alone left the sign-in screen mounted behind a shut
+          // modal, and the user had to press connect a second time just to get the
+          // signature prompt. Reopen only when the user actually initiated this
+          // connect (consumeConnectIntent) — a cold load with a wallet already
+          // connected must not pop a modal nobody asked for.
+          if (consumeConnectIntent()) context.setOpen(true);
         } else {
           context.setOpen(false);
         }
@@ -100,6 +109,10 @@ export const Web3ModalBridge: React.FC<Web3ModalBridgeProps> = ({
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [isConnected]);
 
+  // A disconnect ends the flow — don't let a stale intent reopen the modal on the
+  // next reconnect.
+  useAccountEffect({ onDisconnect: () => clearConnectIntent() });
+
   const modalState = useMemo<ModalState>(
     () => ({
       connected: isConnected,

package/src/providers/WalletProvider.native.tsx

@@ -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,15 @@ 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}}.
+  // And no guessed-URL fallback either: mounting the WebView against an
+  // unreachable default (e.g. http://localhost:8099 on a physical device, where
+  // localhost is the phone) fires NSURLErrorDomain -1004 at app startup. When
+  // neither `webViewSource` nor `config.webViewUrl` resolves, skip the WebView
+  // entirely — providers still mount so wagmi/bridge consumers render; connect
+  // flows stay inert until WEB3_WEBVIEW_URL points at a served copy of
+  // @multiplatform.one/web3/assets/webview.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",
-    );
-  }
+    webViewSource ?? (web3Config.webViewUrl ? { uri: web3Config.webViewUrl } : undefined);
 
   return (
     <Web3ConfigContext.Provider value={web3Config}>
@@ -145,32 +158,34 @@ export function WalletProvider({
         <QueryClientProvider client={queryClient}>
           <SolanaWalletContext.Provider value={solanaValue}>
             {children}
-            <View
-              style={visibility.sheetOpen ? styles.visible : styles.hidden}
-              pointerEvents={visibility.sheetOpen ? "auto" : "none"}
-            >
-              <WebView
-                ref={webRef}
-                source={resolvedSource}
-                originWhitelist={["*"]}
-                javaScriptEnabled
-                domStorageEnabled
-                onMessage={onMessage}
-                onShouldStartLoadWithRequest={(req) => {
-                  // Hand wallet deep links to the OS; keep everything else in the WebView.
-                  if (shouldOpenExternally(req.url)) {
-                    void Linking.openURL(req.url).catch(() => undefined);
-                    return false;
-                  }
-                  return true;
-                }}
-                injectedJavaScriptBeforeContentLoaded={buildConfigInjection({
-                  ...web3Config,
-                  appUrl: web3Config.appUrl ?? "",
-                })}
-                style={styles.webview}
-              />
-            </View>
+            {resolvedSource && (
+              <View
+                style={visibility.sheetOpen ? styles.visible : styles.hidden}
+                pointerEvents={visibility.sheetOpen ? "auto" : "none"}
+              >
+                <WebView
+                  ref={webRef}
+                  source={resolvedSource}
+                  originWhitelist={["*"]}
+                  javaScriptEnabled
+                  domStorageEnabled
+                  onMessage={onMessage}
+                  onShouldStartLoadWithRequest={(req) => {
+                    // Hand wallet deep links to the OS; keep everything else in the WebView.
+                    if (shouldOpenExternally(req.url)) {
+                      void Linking.openURL(req.url).catch(() => undefined);
+                      return false;
+                    }
+                    return true;
+                  }}
+                  injectedJavaScriptBeforeContentLoaded={buildConfigInjection({
+                    ...web3Config,
+                    appUrl: web3Config.appUrl ?? "",
+                  })}
+                  style={styles.webview}
+                />
+              </View>
+            )}
           </SolanaWalletContext.Provider>
         </QueryClientProvider>
       </WagmiProvider>

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 {

package/types/bridge/BridgeClient.d.ts

@@ -0,0 +1,28 @@
+import { type Namespace } from "./protocol";
+import type { Transport } from "./transport";
+export interface RequestOptions {
+    /** Override the default timeout for this call. Sign/tx use a long value (user is in the wallet). */
+    timeoutMs?: number;
+    /** Reject the pending request when this fires (e.g. modal dismissed). */
+    signal?: AbortSignal;
+}
+export type EventHandler = (ns: Namespace, method: string, params: unknown) => void;
+export declare class BridgeClient {
+    private readonly transport;
+    private readonly opts;
+    private readonly pending;
+    private readonly listeners;
+    private readonly unsubscribe;
+    private disposed;
+    constructor(transport: Transport, opts?: {
+        timeoutMs?: number;
+    });
+    request(ns: Namespace, method: string, params?: unknown, options?: RequestOptions): Promise<unknown>;
+    /** Subscribe to webview->native push events. Returns an unsubscribe fn. */
+    on(handler: EventHandler): () => void;
+    /** Reject all in-flight requests — call on WebView reload/crash. */
+    dispose(): void;
+    private settle;
+    private readonly onMessage;
+}
+//# sourceMappingURL=BridgeClient.d.ts.map

package/types/bridge/BridgeClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BridgeClient.d.ts","sourceRoot":"","sources":["../../src/bridge/BridgeClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,cAAc;IAC7B,oGAAoG;IACpG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;AAUpF,qBAAa,YAAY;IAOrB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI;IAPvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2B;IACrD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAS;gBAGN,SAAS,EAAE,SAAS,EACpB,IAAI,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO;IAKpD,OAAO,CACL,EAAE,EAAE,SAAS,EACb,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,OAAO,EAChB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,OAAO,CAAC;IA6BnB,2EAA2E;IAC3E,EAAE,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,IAAI;IAOrC,oEAAoE;IACpE,OAAO,IAAI,IAAI;IAWf,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,QAAQ,CAAC,SAAS,CAiBxB;CACH"}

package/types/bridge/BridgeHost.d.ts

@@ -0,0 +1,29 @@
+import { type Namespace } from "./protocol";
+import type { Transport } from "./transport";
+/**
+ * A per-namespace request handler. It owns its method vocabulary — unknown
+ * methods should throw (mapped to an error response), which IS the per-channel
+ * allow-list. EVM's handler proxies to the wallet provider's EIP-1193 `request`;
+ * Solana's handler dispatches wallet-standard ops.
+ */
+export type RequestHandler = (method: string, params: unknown) => Promise<unknown> | unknown;
+/**
+ * The in-WebView side of the bridge. Receives `req` from native, routes to the
+ * handler registered for the message's namespace, and replies with `res`. Pushes
+ * `event`s (connection lifecycle, modal open/close) and signals `ready`.
+ */
+export declare class BridgeHost {
+    private readonly transport;
+    private readonly handlers;
+    private readonly unsubscribe;
+    constructor(transport: Transport);
+    register(ns: Namespace, handler: RequestHandler): void;
+    /** Push a webview->native event (no response expected). */
+    emit(ns: Namespace, method: string, params?: unknown): void;
+    /** Tell native the host is initialized. */
+    ready(): void;
+    dispose(): void;
+    private readonly onMessage;
+    private reply;
+}
+//# sourceMappingURL=BridgeHost.d.ts.map

package/types/bridge/BridgeHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BridgeHost.d.ts","sourceRoot":"","sources":["../../src/bridge/BridgeHost.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyD,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AACnG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAE7F;;;;GAIG;AACH,qBAAa,UAAU;IAIT,OAAO,CAAC,QAAQ,CAAC,SAAS;IAHtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IACjE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;gBAEZ,SAAS,EAAE,SAAS;IAIjD,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAItD,2DAA2D;IAC3D,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI;IAI3D,2CAA2C;IAC3C,KAAK,IAAI,IAAI;IAIb,OAAO,IAAI,IAAI;IAKf,OAAO,CAAC,QAAQ,CAAC,SAAS,CAaxB;IAEF,OAAO,CAAC,KAAK;CAGd"}

package/types/bridge/SolanaBridge.d.ts

@@ -0,0 +1,22 @@
+import type { BridgeClient } from "./BridgeClient";
+/**
+ * Native-side proxy for the WebView's Solana wallet (wallet-adapter / Wallet
+ * Standard). Mirrors the operations `@solana/wallet-adapter-react`'s `useWallet`
+ * exposes; bytes (messages/transactions) cross the bridge as base64. The React
+ * context that adapts this to wallet-adapter's hook shape is wired in the native
+ * WalletProvider (later plan); this class is the testable transport core.
+ */
+export declare class SolanaBridge {
+    private readonly bridge;
+    constructor(bridge: BridgeClient);
+    connect(): Promise<{
+        publicKey: string;
+    }>;
+    disconnect(): Promise<void>;
+    signMessage(message: Uint8Array): Promise<Uint8Array>;
+    signTransaction(transaction: Uint8Array): Promise<Uint8Array>;
+    signAllTransactions(transactions: Uint8Array[]): Promise<Uint8Array[]>;
+    /** Subscribe to solana lifecycle events (connect/disconnect/accountChanged). */
+    on(handler: (event: string, params: unknown) => void): () => void;
+}
+//# sourceMappingURL=SolanaBridge.d.ts.map

package/types/bridge/SolanaBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SolanaBridge.d.ts","sourceRoot":"","sources":["../../src/bridge/SolanaBridge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;;;;GAMG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,YAAY;IAE3C,OAAO,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAIzC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAOrD,eAAe,CAAC,WAAW,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAO7D,mBAAmB,CAAC,YAAY,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAO5E,gFAAgF;IAChF,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI;CAKlE"}

package/types/bridge/base64.d.ts

@@ -0,0 +1,3 @@
+export declare function bytesToBase64(bytes: Uint8Array): string;
+export declare function base64ToBytes(base64: string): Uint8Array;
+//# sourceMappingURL=base64.d.ts.map

package/types/bridge/base64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.d.ts","sourceRoot":"","sources":["../../src/bridge/base64.ts"],"names":[],"mappings":"AAQA,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAYvD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAiBxD"}

package/types/bridge/bridgeConnector.d.ts

@@ -0,0 +1,21 @@
+import { createConnector } from "wagmi";
+import type { BridgeClient } from "./BridgeClient";
+/**
+ * A wagmi connector whose provider is the bridge. Every wagmi hook
+ * (useAccount/useSignMessage/useSendTransaction/…) keeps working unchanged on
+ * native — wagmi only sees an ordinary EIP-1193 provider; the wallet lives in the
+ * WebView on the other side of the bridge.
+ */
+export declare function createBridgeConnector(bridge: BridgeClient): (config: {
+    chains: readonly [import("viem").Chain, ...import("viem").Chain[]];
+    emitter: import("@wagmi/core/internal").Emitter<import("wagmi").ConnectorEventMap>;
+    readonly providers: readonly import("mipd").EIP6963ProviderDetail[];
+    storage?: {
+        key: string;
+        getItem: <key_1 extends string, value extends (import("@wagmi/core").StorageItemMap & Record<string, unknown>)[key_1], defaultValue_1 extends value | null | undefined>(key: key_1, defaultValue?: defaultValue_1 | undefined) => (defaultValue_1 extends null ? value | null : value) | Promise<defaultValue_1 extends null ? value | null : value>;
+        setItem: <key_1 extends string, value_1 extends (import("@wagmi/core").StorageItemMap & Record<string, unknown>)[key_1] | null>(key: key_1, value: value_1) => void | Promise<void>;
+        removeItem: (key: string) => void | Promise<void>;
+    } | null | undefined;
+    transports?: Record<number, import("wagmi").Transport> | undefined;
+}) => ReturnType<Parameters<typeof createConnector>[0]>;
+//# sourceMappingURL=bridgeConnector.d.ts.map

package/types/bridge/bridgeConnector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridgeConnector.d.ts","sourceRoot":"","sources":["../../src/bridge/bridgeConnector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAExC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGnD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY;;;;;;;;;;;MAwEvB,UAAU,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAEnF"}

package/types/bridge/eip1193.d.ts

@@ -0,0 +1,19 @@
+import type { BridgeClient } from "./BridgeClient";
+export interface Eip1193RequestArgs {
+    method: string;
+    params?: unknown;
+}
+export type ProviderListener = (payload?: unknown) => void;
+/**
+ * Minimal EIP-1193 provider whose `request` is forwarded over the bridge to the
+ * WebView's real wallet provider, and whose events (`accountsChanged`,
+ * `chainChanged`, `connect`, `disconnect`) are fed from the bridge's `evm` events.
+ * This is the object the wagmi connector wraps — wagmi sees an ordinary provider.
+ */
+export interface BridgeProvider {
+    request(args: Eip1193RequestArgs): Promise<unknown>;
+    on(event: string, listener: ProviderListener): void;
+    removeListener(event: string, listener: ProviderListener): void;
+}
+export declare function createBridgeProvider(bridge: BridgeClient): BridgeProvider;
+//# sourceMappingURL=eip1193.d.ts.map

package/types/bridge/eip1193.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eip1193.d.ts","sourceRoot":"","sources":["../../src/bridge/eip1193.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACpD,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACjE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,CAwBzE"}

package/types/bridge/index.d.ts

@@ -0,0 +1,10 @@
+export * from "./protocol";
+export * from "./transport";
+export { createPostMessageTransport, type PostMessageTransport } from "./postMessageTransport";
+export { BridgeClient, type EventHandler, type RequestOptions } from "./BridgeClient";
+export { BridgeHost, type RequestHandler } from "./BridgeHost";
+export { createBridgeProvider, type BridgeProvider, type Eip1193RequestArgs } from "./eip1193";
+export { createBridgeConnector } from "./bridgeConnector";
+export { bytesToBase64, base64ToBytes } from "./base64";
+export { SolanaBridge } from "./SolanaBridge";
+//# sourceMappingURL=index.d.ts.map

package/types/bridge/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,0BAA0B,EAAE,KAAK,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC/F,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAAE,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,KAAK,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/F,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/types/bridge/postMessageTransport.d.ts

@@ -0,0 +1,17 @@
+import type { Transport } from "./transport";
+export interface PostMessageTransport extends Transport {
+    /** Feed an inbound raw string (a serialized BridgeMessage) into the bridge. */
+    receive(raw: string): void;
+}
+/**
+ * The single symmetric transport over react-native-webview's postMessage channel.
+ * `post()` serializes and hands the string to `send`; `receive()` parses, validates,
+ * and dispatches. Both sides differ only in how `send`/`receive` are wired:
+ *
+ *   Native:  send = (raw) => webViewRef.injectJavaScript(`window.__bridgeReceive(${JSON.stringify(raw)});true;`)
+ *            onMessage = (e) => transport.receive(e.nativeEvent.data)
+ *   WebView: send = (raw) => window.ReactNativeWebView.postMessage(raw)
+ *            window.__bridgeReceive = (raw) => transport.receive(raw)
+ */
+export declare function createPostMessageTransport(send: (raw: string) => void): PostMessageTransport;
+//# sourceMappingURL=postMessageTransport.d.ts.map

package/types/bridge/postMessageTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postMessageTransport.d.ts","sourceRoot":"","sources":["../../src/bridge/postMessageTransport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,oBAAqB,SAAQ,SAAS;IACrD,+EAA+E;IAC/E,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,oBAAoB,CAyB5F"}

package/types/bridge/protocol.d.ts

@@ -0,0 +1,21 @@
+export declare const NAMESPACES: readonly ["evm", "solana", "sys"];
+export type Namespace = (typeof NAMESPACES)[number];
+export declare const KINDS: readonly ["req", "res", "event"];
+export type Kind = (typeof KINDS)[number];
+export interface BridgeError {
+    code: number;
+    message: string;
+}
+export interface BridgeMessage {
+    /** present on req/res, absent on event */
+    id?: string;
+    ns: Namespace;
+    kind: Kind;
+    method?: string;
+    params?: unknown;
+    result?: unknown;
+    error?: BridgeError;
+}
+export declare function isBridgeMessage(value: unknown): value is BridgeMessage;
+export declare function newRequestId(): string;
+//# sourceMappingURL=protocol.d.ts.map

package/types/bridge/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/bridge/protocol.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,mCAAoC,CAAC;AAC5D,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpD,eAAO,MAAM,KAAK,kCAAmC,CAAC;AACtD,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,SAAS,CAAC;IACd,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAQtE;AAGD,wBAAgB,YAAY,IAAI,MAAM,CAIrC"}

package/types/bridge/transport.d.ts

@@ -0,0 +1,22 @@
+import type { BridgeMessage } from "./protocol";
+/**
+ * The single seam between the bridge and the world. On native, an adapter wraps
+ * react-native-webview's `postMessage` + `onMessage`; in the WebView, an adapter
+ * wraps `window.ReactNativeWebView.postMessage` + a `message` listener. Tests use
+ * the in-memory pair below. The bridge layer knows nothing else about platforms.
+ */
+export interface Transport {
+    post(message: BridgeMessage): void;
+    /** Returns an unsubscribe function. */
+    subscribe(handler: (message: BridgeMessage) => void): () => void;
+}
+/**
+ * Two linked in-memory transports: posting on `a` delivers to `b`'s subscribers
+ * and vice-versa, never to the sender's own subscribers. Models the
+ * native<->webview channel for unit tests.
+ */
+export declare function createMemoryTransportPair(): {
+    a: Transport;
+    b: Transport;
+};
+//# sourceMappingURL=transport.d.ts.map

package/types/bridge/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/bridge/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IACnC,uCAAuC;IACvC,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAClE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI;IAAE,CAAC,EAAE,SAAS,CAAC;IAAC,CAAC,EAAE,SAAS,CAAA;CAAE,CAmB1E"}

package/types/components/ConnectKitButton.d.ts

@@ -0,0 +1,2 @@
+export { ConnectKitButton } from "../connectkit";
+//# sourceMappingURL=ConnectKitButton.d.ts.map

package/types/components/ConnectKitButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectKitButton.d.ts","sourceRoot":"","sources":["../../src/components/ConnectKitButton.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/types/components/ConnectKitButton.native.d.ts

@@ -0,0 +1,29 @@
+import type { ReactNode } from "react";
+/**
+ * Native stand-in for ConnectKit's button. ConnectKit is web-only and lives in
+ * the WebView; on native, connecting goes through the bridge connector (the sole
+ * connector in the native wagmi config), which makes the WebView show the real
+ * ConnectKit modal. Mirrors the slice of ConnectKit's API the app uses
+ * (`<ConnectKitButton />` and `<ConnectKitButton.Custom>`).
+ */
+export interface ConnectKitButtonProps {
+    showBalance?: boolean;
+    showAvatar?: boolean;
+    label?: string;
+}
+export interface ConnectKitCustomRenderProps {
+    isConnected: boolean;
+    isConnecting: boolean;
+    show: () => void;
+    hide: () => void;
+    address?: string;
+    ensName?: string;
+    truncatedAddress?: string;
+}
+export declare function ConnectKitButton({ label }: ConnectKitButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace ConnectKitButton {
+    var Custom: ({ children, }: {
+        children: (props: ConnectKitCustomRenderProps) => ReactNode;
+    }) => import("react/jsx-runtime").JSX.Element;
+}
+//# sourceMappingURL=ConnectKitButton.native.d.ts.map

package/types/components/ConnectKitButton.native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectKitButton.native.d.ts","sourceRoot":"","sources":["../../src/components/ConnectKitButton.native.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAmBD,wBAAgB,gBAAgB,CAAC,EAAE,KAAwB,EAAE,EAAE,qBAAqB,2CASnF;yBATe,gBAAgB;gCAa7B;QACD,QAAQ,EAAE,CAAC,KAAK,EAAE,2BAA2B,KAAK,SAAS,CAAC;KAC7D"}

package/types/components/NetworkSwitcher.d.ts

@@ -0,0 +1,6 @@
+import { type ButtonProps } from "tamagui";
+export interface NetworkSwitcherProps extends Omit<ButtonProps, "children"> {
+    showTestnets?: boolean;
+}
+export declare function NetworkSwitcher({ showTestnets, ...buttonProps }: NetworkSwitcherProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=NetworkSwitcher.d.ts.map

package/types/components/NetworkSwitcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkSwitcher.d.ts","sourceRoot":"","sources":["../../src/components/NetworkSwitcher.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAyC,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAIlF,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC;IACzE,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,eAAe,CAAC,EAAE,YAAoB,EAAE,GAAG,WAAW,EAAE,EAAE,oBAAoB,kDAuD7F"}