@multiplatform.one/web3 7.16.0 → 7.18.0

package/src/connectkit/openConnector/modal.spec.tsx

@@ -0,0 +1,330 @@
+// @vitest-environment happy-dom
+import React from "react";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { act, cleanup, fireEvent, render, screen, waitFor } from "@testing-library/react";
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { WagmiProvider, createConfig, createStorage, http, type CreateConnectorFn } from "wagmi";
+import { connect } from "wagmi/actions";
+import { mock } from "wagmi/connectors";
+import { mainnet } from "wagmi/chains";
+import { routes, useContext } from "@multiplatform.one/connectkit";
+import { GpgProvider } from "@multiplatform.one/gpg";
+
+import {
+  ConnectKitProvider,
+  DEFAULT_DESKTOP_OPEN_CONNECTOR_FALLBACK_MS,
+  useModal,
+  type Web3ConnectKitOptions,
+} from "..";
+import ConnectorList from "../components/Common/ConnectorList";
+
+const ANDROID_UA =
+  "Mozilla/5.0 (Linux; Android 16; Pixel 9) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/140.0.0.0 Mobile Safari/537.36";
+const DESKTOP_UA =
+  "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/140.0.0.0 Safari/537.36";
+
+function setUserAgent(ua: string) {
+  Object.defineProperty(window.navigator, "userAgent", { value: ua, configurable: true });
+}
+
+function memoryStorage() {
+  const map = new Map<string, string>();
+  return {
+    getItem: (key: string) => map.get(key) ?? null,
+    setItem: (key: string, value: string) => void map.set(key, value),
+    removeItem: (key: string) => void map.delete(key),
+  };
+}
+
+const ACCOUNT = "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045";
+
+// A second wallet: the mock connector under another id.
+const otherWallet: CreateConnectorFn = (config) => ({
+  ...mock({ accounts: [ACCOUNT], features: {} })(config),
+  id: "other",
+  name: "Other Wallet",
+});
+
+function makeConfig({ second = false }: { second?: boolean } = {}) {
+  return createConfig({
+    chains: [mainnet],
+    connectors: [mock({ accounts: [ACCOUNT], features: {} }), ...(second ? [otherWallet] : [])],
+    transports: { [mainnet.id]: http() },
+    storage: createStorage({ storage: memoryStorage() }),
+  });
+}
+
+/** A config whose first connector's connect never answers (no wallet app). */
+function makeUnansweredConfig(options?: { second?: boolean }) {
+  const config = makeConfig(options);
+  const connectSpy = vi
+    .spyOn(config.connectors[0], "connect")
+    .mockImplementation(() => new Promise(() => {}));
+  return { config, connectSpy };
+}
+
+type Probe = { route?: string; open?: boolean; connectorId?: string; routes: string[] };
+
+function Harness({
+  options,
+  gpg,
+  children,
+  probe,
+  config,
+}: {
+  options?: Web3ConnectKitOptions;
+  gpg?: boolean;
+  children?: React.ReactNode;
+  probe: Probe;
+  config?: ReturnType<typeof makeConfig>;
+}) {
+  const [cfg] = React.useState(() => config ?? makeConfig());
+  const [client] = React.useState(() => new QueryClient());
+  const tree = (
+    <ConnectKitProvider options={options}>
+      <ProbeRoute probe={probe} />
+      {children}
+    </ConnectKitProvider>
+  );
+  return (
+    <WagmiProvider config={cfg}>
+      <QueryClientProvider client={client}>
+        {gpg ? (
+          <GpgProvider getNonce={async () => "nonce"} onSign={() => true}>
+            {tree}
+          </GpgProvider>
+        ) : (
+          tree
+        )}
+      </QueryClientProvider>
+    </WagmiProvider>
+  );
+}
+
+function ProbeRoute({ probe }: { probe: Probe }) {
+  const context = useContext();
+  probe.route = context.route;
+  probe.open = context.open;
+  probe.connectorId = context.connector.id;
+  if (probe.routes[probe.routes.length - 1] !== context.route) probe.routes.push(context.route);
+  return null;
+}
+
+let modal: ReturnType<typeof useModal> | undefined;
+let ctx: ReturnType<typeof useContext> | undefined;
+function GrabModal() {
+  modal = useModal();
+  ctx = useContext();
+  return null;
+}
+
+const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));
+
+afterEach(() => {
+  vi.useRealTimers();
+  cleanup();
+  modal = undefined;
+  ctx = undefined;
+  setUserAgent(DESKTOP_UA);
+});
+
+describe("GPG in the wallet list", () => {
+  it("renders a GPG row next to the wallets when GPG sign-in is on, and it opens the GPG screen", async () => {
+    const probe: Probe = { routes: [] };
+    render(
+      <Harness gpg probe={probe}>
+        <ConnectorList />
+      </Harness>,
+    );
+
+    const row = await screen.findByText("GPG");
+    expect(screen.getByText("Mock Connector")).toBeTruthy();
+    const button = row.closest("button") as HTMLButtonElement;
+    expect(button.getAttribute("data-screen-entry")).toBe(routes.SIGNINWITHGPG);
+
+    fireEvent.click(button);
+    await waitFor(() => expect(probe.route).toBe(routes.SIGNINWITHGPG));
+  });
+
+  it("has no GPG row without a GpgProvider", async () => {
+    const probe: Probe = { routes: [] };
+    render(
+      <Harness probe={probe}>
+        <ConnectorList />
+      </Harness>,
+    );
+
+    await screen.findByText("Mock Connector");
+    expect(screen.queryByText("GPG")).toBeNull();
+  });
+});
+
+describe("mobile.preferredConnector", () => {
+  it("sends openSIWE() on a phone straight to the connector, with no list", async () => {
+    setUserAgent(ANDROID_UA);
+    const probe: Probe = { routes: [] };
+    render(
+      <Harness options={{ mobile: { preferredConnector: "mock" } }} probe={probe}>
+        <GrabModal />
+      </Harness>,
+    );
+    await waitFor(() => expect(modal).toBeDefined());
+
+    expect(probe.open).toBe(false);
+    probe.routes.length = 0;
+    act(() => modal!.openSIWE());
+
+    expect(probe.routes).toEqual([routes.CONNECT]);
+    expect(probe.route).toBe(routes.CONNECT);
+    expect(probe.connectorId).toBe("mock");
+    expect(probe.open).toBe(true);
+  });
+
+  it("keeps the wallet list on desktop", async () => {
+    setUserAgent(DESKTOP_UA);
+    const probe: Probe = { routes: [] };
+    render(
+      <Harness options={{ mobile: { preferredConnector: "mock" } }} probe={probe}>
+        <GrabModal />
+      </Harness>,
+    );
+    await waitFor(() => expect(modal).toBeDefined());
+
+    act(() => modal!.openSIWE());
+
+    expect(probe.route).toBe(routes.CONNECTORS);
+    expect(probe.open).toBe(true);
+    expect(modal!.pendingConnector).toBeNull();
+  });
+
+  it("openConnector connects the wallet from the connecting screen, never the list", async () => {
+    setUserAgent(ANDROID_UA);
+    const config = makeConfig();
+    const connectSpy = vi.spyOn(config.connectors[0], "connect");
+    const probe: Probe = { routes: [] };
+    render(
+      <Harness probe={probe} config={config}>
+        <GrabModal />
+      </Harness>,
+    );
+    await waitFor(() => expect(modal).toBeDefined());
+
+    probe.routes.length = 0;
+    act(() => modal!.openConnector("mock"));
+
+    expect(probe.route).toBe(routes.CONNECT);
+    expect(probe.connectorId).toBe("mock");
+    await waitFor(() => expect(config.state.status).toBe("connected"));
+    expect(connectSpy).toHaveBeenCalledTimes(1);
+    expect(probe.routes).toEqual([routes.CONNECT]);
+  });
+});
+
+describe("the openConnector session", () => {
+  async function renderUnanswered(options?: { second?: boolean }) {
+    setUserAgent(ANDROID_UA);
+    const { config, connectSpy } = makeUnansweredConfig(options);
+    const probe: Probe = { routes: [] };
+    render(
+      <Harness probe={probe} config={config}>
+        <GrabModal />
+      </Harness>,
+    );
+    await waitFor(() => expect(modal).toBeDefined());
+    return { config, connectSpy, probe };
+  }
+
+  it("a modal the user closed stays closed when the fallback would have fired", async () => {
+    const { probe } = await renderUnanswered();
+
+    act(() => modal!.openConnector("mock", { fallbackMs: 50 }));
+    expect(probe.open).toBe(true);
+    expect(modal!.pendingConnector).toBe("mock");
+
+    act(() => ctx!.setOpen(false));
+    expect(modal!.pendingConnector).toBeNull();
+
+    await act(() => sleep(150));
+    expect(probe.open).toBe(false);
+    expect(probe.route).toBe(routes.CONNECT);
+  });
+
+  it("a screen the user moved to keeps them when the fallback would have fired", async () => {
+    const { probe } = await renderUnanswered();
+
+    act(() => modal!.openConnector("mock", { fallbackMs: 50 }));
+    act(() => ctx!.setRoute(routes.ABOUT));
+    expect(modal!.pendingConnector).toBeNull();
+
+    await act(() => sleep(150));
+    expect(probe.route).toBe(routes.ABOUT);
+    expect(probe.open).toBe(true);
+  });
+
+  it("the user staying on the connecting screen still gets the list", async () => {
+    const { probe } = await renderUnanswered();
+
+    act(() => modal!.openConnector("mock", { fallbackMs: 50 }));
+    await act(() => sleep(150));
+
+    expect(probe.route).toBe(routes.CONNECTORS);
+    expect(probe.open).toBe(true);
+    expect(modal!.pendingConnector).toBeNull();
+  });
+
+  it("another wallet connecting ends the session the unanswered connect left", async () => {
+    const { config } = await renderUnanswered({ second: true });
+
+    act(() => modal!.openConnector("mock", { fallbackMs: 0 }));
+    expect(modal!.pendingConnector).toBe("mock");
+
+    await act(async () => {
+      await connect(config, { connector: config.connectors[1] });
+    });
+
+    await waitFor(() => expect(modal!.pendingConnector).toBeNull());
+    expect(config.state.current).toBe(config.connectors[1].uid);
+  });
+
+  it("reaches connector.connect with no macrotask between the call and the connect", async () => {
+    const { connectSpy } = await renderUnanswered();
+    let macrotaskRan = false;
+    let connectBeforeMacrotask: boolean | undefined;
+    connectSpy.mockImplementation(() => {
+      connectBeforeMacrotask = !macrotaskRan;
+      return new Promise(() => {});
+    });
+
+    await act(async () => {
+      setTimeout(() => {
+        macrotaskRan = true;
+      }, 0);
+      modal!.openConnector("mock");
+      await sleep(0);
+    });
+
+    expect(connectSpy).toHaveBeenCalledTimes(1);
+    expect(connectBeforeMacrotask).toBe(true);
+  });
+
+  it("an explicit call on desktop falls back after the desktop default", async () => {
+    const { config } = makeUnansweredConfig();
+    const probe: Probe = { routes: [] };
+    render(
+      <Harness probe={probe} config={config}>
+        <GrabModal />
+      </Harness>,
+    );
+    await waitFor(() => expect(modal).toBeDefined());
+    vi.useFakeTimers({ toFake: ["setTimeout", "clearTimeout"] });
+
+    act(() => modal!.openConnector("mock"));
+    expect(probe.route).toBe(routes.CONNECT);
+
+    act(() => vi.advanceTimersByTime(DEFAULT_DESKTOP_OPEN_CONNECTOR_FALLBACK_MS - 1));
+    expect(probe.route).toBe(routes.CONNECT);
+    act(() => vi.advanceTimersByTime(1));
+    expect(probe.route).toBe(routes.CONNECTORS);
+    expect(modal!.pendingConnector).toBeNull();
+  });
+});

package/src/connectkit/screens.tsx

@@ -18,7 +18,7 @@ import DownloadApp from "./components/Pages/DownloadApp";
 import Profile from "./components/Pages/Profile";
 import SwitchNetworks from "./components/Pages/SwitchNetworks";
 import SignInWithEthereum from "./components/Pages/SignInWithEthereum";
-import { SignInWithGpg } from "@multiplatform.one/gpg";
+import { gpgScreen } from "@multiplatform.one/gpg";
 
 // ─────────────────────────────────────────────────────────────────────────────
 // web3's screen catalogue — the wallet (+ the legacy GPG) screens contributed to
@@ -134,16 +134,7 @@ export const web3Screens: readonly ScreenDef[] = [
     availableWhen: (s) => !!s.connected,
     onBack: (api) => api.setRoute(routes.PROFILE),
   },
-  {
-    id: routes.SIGNINWITHGPG,
-    component: SignInWithGpg,
-    // Hardcoded (vs a locale key) to avoid touching every locale file for Phase 1.
-    heading: "Sign in with GPG",
-    // GPG has no connect step — valid in both connected and disconnected states.
-    availableWhen: () => true,
-    showBack: false,
-    showInfo: false,
-  },
+  gpgScreen,
 ];
 
 /**

package/src/connectkit/siwe/connectIntent.spec.ts

@@ -0,0 +1,90 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+
+import {
+  CONNECT_INTENT_TTL_MS,
+  clearConnectIntent,
+  consumeConnectIntent,
+  setConnectIntent,
+} from "./connectIntent";
+
+const KEY = "wallet:connect-intent";
+
+function memoryStorage() {
+  const map = new Map<string, string>();
+  return {
+    getItem: (k: string) => (map.has(k) ? (map.get(k) as string) : null),
+    setItem: (k: string, v: string) => void map.set(k, String(v)),
+    removeItem: (k: string) => void map.delete(k),
+  };
+}
+
+describe("connectIntent", () => {
+  let storage: ReturnType<typeof memoryStorage>;
+
+  beforeEach(() => {
+    storage = memoryStorage();
+    vi.stubGlobal("window", { sessionStorage: storage });
+  });
+  afterEach(() => {
+    vi.unstubAllGlobals();
+  });
+
+  it("defaults the TTL to 90 s", () => {
+    expect(CONNECT_INTENT_TTL_MS).toBe(90_000);
+  });
+
+  it("is honoured within the TTL", () => {
+    setConnectIntent(undefined, 1_000);
+    expect(consumeConnectIntent(1_000 + 89_999)).toBe(true);
+  });
+
+  it("expires after the TTL, so a cold load never fires an unsolicited signature", () => {
+    setConnectIntent(undefined, 1_000);
+    expect(consumeConnectIntent(1_000 + 90_000)).toBe(false);
+    expect(storage.getItem(KEY)).toBeNull();
+  });
+
+  it("is consumed once", () => {
+    setConnectIntent(undefined, 1_000);
+    expect(consumeConnectIntent(2_000)).toBe(true);
+    expect(consumeConnectIntent(2_000)).toBe(false);
+  });
+
+  it("takes a custom TTL", () => {
+    setConnectIntent(5_000, 1_000);
+    expect(consumeConnectIntent(5_999)).toBe(true);
+    setConnectIntent(5_000, 1_000);
+    expect(consumeConnectIntent(6_000)).toBe(false);
+  });
+
+  it("treats the old '1' flag as expired", () => {
+    storage.setItem(KEY, "1");
+    expect(consumeConnectIntent()).toBe(false);
+    expect(storage.getItem(KEY)).toBeNull();
+  });
+
+  it("is false with nothing stored and after a clear", () => {
+    expect(consumeConnectIntent()).toBe(false);
+    setConnectIntent();
+    clearConnectIntent();
+    expect(consumeConnectIntent()).toBe(false);
+  });
+
+  it("degrades to false when storage throws", () => {
+    vi.stubGlobal("window", {
+      sessionStorage: {
+        getItem: () => {
+          throw new Error("SecurityError");
+        },
+        setItem: () => {
+          throw new Error("SecurityError");
+        },
+        removeItem: () => {
+          throw new Error("SecurityError");
+        },
+      },
+    });
+    expect(() => setConnectIntent()).not.toThrow();
+    expect(consumeConnectIntent()).toBe(false);
+  });
+});

package/src/connectkit/siwe/connectIntent.ts

@@ -15,25 +15,38 @@
  * page load with a wallet already connected must NOT pop a modal the user never asked
  * for. Only a connect the user just initiated carries the intent, and it's consumed
  * once acted on.
+ *
+ * The stored value is the moment the intent expires. An abandoned connect (the user
+ * opened the wallet and never came back) would otherwise leave the flag set for the
+ * rest of the tab's life, and a later visit whose wallet auto-reconnects would pop a
+ * signature request nobody asked for.
  */
 const KEY = "wallet:connect-intent";
 
-export function setConnectIntent() {
+/** How long a connect intent stays good. Long enough for a wallet app round trip. */
+export const CONNECT_INTENT_TTL_MS = 90_000;
+
+export function setConnectIntent(ttlMs: number = CONNECT_INTENT_TTL_MS, now: number = Date.now()) {
   if (typeof window === "undefined") return;
   try {
-    window.sessionStorage.setItem(KEY, "1");
+    window.sessionStorage.setItem(KEY, String(now + ttlMs));
   } catch {
     // Private mode / storage disabled — degrade to the old behaviour, don't throw.
   }
 }
 
-/** Reads and clears the flag; true only for a connect the user just initiated. */
-export function consumeConnectIntent(): boolean {
+/**
+ * Reads and clears the flag; true only for a connect the user initiated within the
+ * TTL. A second call returns false.
+ */
+export function consumeConnectIntent(now: number = Date.now()): boolean {
   if (typeof window === "undefined") return false;
   try {
-    const had = window.sessionStorage.getItem(KEY) !== null;
+    const raw = window.sessionStorage.getItem(KEY);
+    if (raw === null) return false;
     window.sessionStorage.removeItem(KEY);
-    return had;
+    const expiresAt = Number(raw);
+    return Number.isFinite(expiresAt) && now < expiresAt;
   } catch {
     return false;
   }

package/src/connectkit/useWeb3Modal.ts

@@ -1,6 +1,7 @@
-import { routes, useModal } from "@multiplatform.one/connectkit";
+import { routes, useModal, useModalState } from "@multiplatform.one/connectkit";
 import { useSIWE } from "./siwe";
 import { useConnectCallback, useConnectCallbackProps } from "./hooks/useConnectCallback";
+import { useConnectorLauncher, type OpenConnectorOptions } from "./openConnector";
 
 type UseModalProps = {} & useConnectCallbackProps;
 
@@ -10,11 +11,31 @@ type UseModalProps = {} & useConnectCallbackProps;
 export const useWeb3Modal = ({ onConnect, onDisconnect }: UseModalProps = {}) => {
   const base = useModal();
   const { signIn } = useSIWE();
+  const launcher = useConnectorLauncher();
+  const isConnected = !!useModalState().connected;
 
   useConnectCallback({ onConnect, onDisconnect });
 
   return {
     ...base,
+    /**
+     * Connect one wallet straight from the caller's click, skipping the list.
+     * Call it synchronously inside the click handler. It starts wagmi's connect
+     * before it returns and before any UI change, and wagmi reaches the connector
+     * a few promise ticks later, still inside the click's task, so a phone's wallet
+     * deeplink keeps the tap's user activation. Shows the connecting screen, and
+     * the wallet list if the page stays in front for `fallbackMs` with the connect
+     * unanswered (no wallet app, or no answer after coming back from it) or the
+     * connect fails. Closing the modal or leaving the connecting screen stops that
+     * fallback. Calling it again while that connect is pending re-opens the
+     * pending request.
+     */
+    openConnector: (id: string, options?: OpenConnectorOptions) => {
+      if (launcher) launcher.openConnector(id, options);
+      else base.openScreen(routes.CONNECTORS);
+    },
+    /** Wallet id `openConnector` is connecting, or null. */
+    pendingConnector: launcher?.pendingConnector ?? null,
     // Disconnected routes
     openAbout: () => base.openScreen(routes.ABOUT),
     openOnboarding: () => base.openScreen(routes.ONBOARDING),
@@ -22,6 +43,9 @@ export const useWeb3Modal = ({ onConnect, onDisconnect }: UseModalProps = {}) =>
     openProfile: () => base.openScreen(routes.PROFILE),
     openSwitchNetworks: () => base.openScreen(routes.SWITCHNETWORKS),
     openSIWE: (triggerSIWE?: boolean) => {
+      // A phone with a preferred connector goes straight to it; the connect lands
+      // on the sign-in screen through the connect intent.
+      if (!isConnected && launcher?.openPreferredConnector()) return;
       base.openScreen(routes.SIGNINWITHETHEREUM);
       if (triggerSIWE) signIn();
     },

package/src/connectkit/web3Bridge.tsx

@@ -17,6 +17,7 @@ import { clearConnectIntent, consumeConnectIntent } from "./siwe/connectIntent";
 import { SIWEContext } from "./siwe/SIWEContext";
 import { GpgContext } from "@multiplatform.one/gpg";
 import { useWallet } from "./wallets/useWallets";
+import { ConnectorLauncherProvider } from "./openConnector";
 
 // ─────────────────────────────────────────────────────────────────────────────
 // The web3 ⇄ connectkit bridge: the ONE place that knows both wagmi and the
@@ -138,7 +139,9 @@ export const Web3ModalBridge: React.FC<Web3ModalBridgeProps> = ({
   return (
     <Web3ContextProvider enabled={context.open}>
       <Web3ScreenRegistrar />
-      <ModalStateProvider value={modalState}>{children}</ModalStateProvider>
+      <ModalStateProvider value={modalState}>
+        <ConnectorLauncherProvider>{children}</ConnectorLauncherProvider>
+      </ModalStateProvider>
     </Web3ContextProvider>
   );
 };

package/src/connectkit/web3Provider.tsx

@@ -1,8 +1,11 @@
 import React from "react";
 import { ConnectKitProvider as BaseProvider } from "@multiplatform.one/connectkit";
 import { Web3ModalBridge } from "./web3Bridge";
+import type { Web3ConnectKitOptions } from "./openConnector";
 
-type Props = React.ComponentProps<typeof BaseProvider>;
+type Props = Omit<React.ComponentProps<typeof BaseProvider>, "options"> & {
+  options?: Web3ConnectKitOptions;
+};
 
 // web3's ConnectKitProvider = connectkit's agnostic provider pre-wired with the wagmi
 // bridge. Consumers importing ConnectKitProvider from @multiplatform.one/web3 get the

package/types/connectkit/components/Common/ConnectorList/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/connectkit/components/Common/ConnectorList/index.tsx"],"names":[],"mappings":"AA6CA,QAAA,MAAM,aAAa,+CAwFlB,CAAC;AAEF,eAAe,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/connectkit/components/Common/ConnectorList/index.tsx"],"names":[],"mappings":"AAkDA,QAAA,MAAM,aAAa,+CA8FlB,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/types/connectkit/components/ConnectButton/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/connectkit/components/ConnectButton/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAOL,WAAW,EACX,IAAI,EACJ,KAAK,EAMN,MAAM,+BAA+B,CAAC;AAOvC,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AA+E7B,KAAK,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;AAE1B,KAAK,0BAA0B,GAAG;IAChC,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE;QACvB,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC;QAClB,KAAK,CAAC,EAAE,KAAK,GAAG;YACd,WAAW,CAAC,EAAE,OAAO,CAAC;SACvB,CAAC;QACF,WAAW,EAAE,OAAO,CAAC;QACrB,WAAW,EAAE,OAAO,CAAC;QACrB,YAAY,EAAE,OAAO,CAAC;QACtB,OAAO,CAAC,EAAE,IAAI,CAAC;QACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,KAAK,KAAK,CAAC,SAAS,CAAC;CACvB,CAAC;AA2LF,KAAK,qBAAqB,GAAG;IAE3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IAGrB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,WAAW,CAAC,EAAE,WAAW,CAAC;IAG1B,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CACtC,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,EAE/B,KAAK,EACL,WAAmB,EACnB,UAAiB,EAGjB,KAAK,EACL,IAAI,EACJ,WAAW,EAGX,OAAO,GACR,EAAE,qBAAqB,kDA6GvB;yBA1He,gBAAgB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/connectkit/components/ConnectButton/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAOL,WAAW,EACX,IAAI,EACJ,KAAK,EAMN,MAAM,+BAA+B,CAAC;AAOvC,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAgF7B,KAAK,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;AAE1B,KAAK,0BAA0B,GAAG;IAChC,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE;QACvB,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC;QAClB,KAAK,CAAC,EAAE,KAAK,GAAG;YACd,WAAW,CAAC,EAAE,OAAO,CAAC;SACvB,CAAC;QACF,WAAW,EAAE,OAAO,CAAC;QACrB,WAAW,EAAE,OAAO,CAAC;QACrB,YAAY,EAAE,OAAO,CAAC;QACtB,OAAO,CAAC,EAAE,IAAI,CAAC;QACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,KAAK,KAAK,CAAC,SAAS,CAAC;CACvB,CAAC;AA6LF,KAAK,qBAAqB,GAAG;IAE3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IAGrB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,WAAW,CAAC,EAAE,WAAW,CAAC;IAG1B,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CACtC,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,EAE/B,KAAK,EACL,WAAmB,EACnB,UAAiB,EAGjB,KAAK,EACL,IAAI,EACJ,WAAW,EAGX,OAAO,GACR,EAAE,qBAAqB,kDA+GvB;yBA5He,gBAAgB"}

package/types/connectkit/components/ConnectModal/ConnectWithInjector/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/connectkit/components/ConnectModal/ConnectWithInjector/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AA0CnD,eAAO,MAAM,MAAM;;;;;;;;CAQlB,CAAC;AA+BF,QAAA,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC;IAClC,mBAAmB,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,UAAU,CAAC,EAAE,OAAO,MAAM,CAAC;CAC5B,CA8eA,CAAC;AAEF,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/connectkit/components/ConnectModal/ConnectWithInjector/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AA2CnD,eAAO,MAAM,MAAM;;;;;;;;CAQlB,CAAC;AA+BF,QAAA,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC;IAClC,mBAAmB,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,UAAU,CAAC,EAAE,OAAO,MAAM,CAAC;CAC5B,CAkfA,CAAC;AAEF,eAAe,mBAAmB,CAAC"}

package/types/connectkit/index.d.ts

@@ -4,6 +4,8 @@ export { default as getDefaultConfig } from "./defaultConfig";
 export { default as getDefaultConnectors } from "./defaultConnectors";
 export { wallets } from "./wallets";
 export { useWeb3Modal as useModal } from "./useWeb3Modal";
+export { DEFAULT_DESKTOP_OPEN_CONNECTOR_FALLBACK_MS, DEFAULT_OPEN_CONNECTOR_FALLBACK_MS, type MobileConnectOptions, type OpenConnectorOptions, type Web3ConnectKitOptions, } from "./openConnector";
+export { CONNECT_INTENT_TTL_MS } from "./siwe/connectIntent";
 export { SIWEProvider, useSIWE, SIWE_NONCE_QUERY_KEY, SIWE_SESSION_QUERY_KEY } from "./siwe";
 export type { SIWESession, SIWEConfig } from "./siwe";
 export { GpgProvider, useGpg, GpgStatusState, GPG_NONCE_QUERY_KEY, SignInWithGpgButton, } from "@multiplatform.one/gpg";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connectkit/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAE1C,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAE,YAAY,IAAI,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,QAAQ,CAAC;AAC7F,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAItD,OAAO,EACL,WAAW,EACX,MAAM,EACN,cAAc,EACd,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAInE,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAGjE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAGlE,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAKhF,OAAO,EACL,eAAe,EACf,eAAe,EACf,aAAa,EACb,UAAU,EACV,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EACL,sBAAsB,EACtB,KAAK,oBAAoB,GAC1B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,eAAe,EACf,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,KAAK,SAAS,GACf,MAAM,+BAA+B,CAAC;AAIvC,OAAO,EACL,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,uBAAuB,GAC7B,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connectkit/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAE1C,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAE,YAAY,IAAI,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EACL,0CAA0C,EAC1C,kCAAkC,EAClC,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,QAAQ,CAAC;AAC7F,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAItD,OAAO,EACL,WAAW,EACX,MAAM,EACN,cAAc,EACd,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAInE,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAGjE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAGlE,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAKhF,OAAO,EACL,eAAe,EACf,eAAe,EACf,aAAa,EACb,UAAU,EACV,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EACL,sBAAsB,EACtB,KAAK,oBAAoB,GAC1B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,eAAe,EACf,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,KAAK,SAAS,GACf,MAAM,+BAA+B,CAAC;AAIvC,OAAO,EACL,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,uBAAuB,GAC7B,MAAM,kCAAkC,CAAC"}

package/types/connectkit/openConnector/context.d.ts

@@ -0,0 +1,48 @@
+import React from "react";
+import { type Connector } from "wagmi";
+import { type ConnectKitOptions } from "@multiplatform.one/connectkit";
+import { type WalletProps } from "../wallets/useWallets";
+import { type OpenConnectorOptions, type PendingConnect } from "./launcher";
+export type MobileConnectOptions = {
+    /**
+     * Connector id a phone connects straight to (e.g. `"metaMaskSDK"`): `openSIWE()`
+     * and the default ConnectKit button skip the wallet list for it. Desktop keeps
+     * the list. A phone here is what connectkit's `isMobile()` reads from the user
+     * agent, so iPadOS Safari and Android's "Desktop site", which both send a desktop
+     * one, keep the list too.
+     */
+    preferredConnector?: string;
+    /** Passed to `openConnector` for the preferred connector. */
+    fallbackMs?: number;
+};
+/** ConnectKit options as web3's ConnectKitProvider takes them. */
+export type Web3ConnectKitOptions = ConnectKitOptions & {
+    mobile?: MobileConnectOptions;
+};
+export type ConnectorLauncherValue = {
+    openConnector: (id: string, options?: OpenConnectorOptions) => void;
+    /**
+     * On a phone with `mobile.preferredConnector` set, open that connector and
+     * return true. Otherwise do nothing and return false.
+     */
+    openPreferredConnector: () => boolean;
+    /** Wallet id `openConnector` is connecting, or null. */
+    pendingConnector: string | null;
+    /** The pending connect's wallet deeplink, once the connector announced it. */
+    pendingDeeplink: string | null;
+    /** The pending connect, for screens that must not start a second one. */
+    pending: PendingConnect | null;
+};
+/** The launcher, or null outside web3's ConnectKitProvider. */
+export declare function useConnectorLauncher(): ConnectorLauncherValue | null;
+export declare function getMobileOptions(options?: ConnectKitOptions): MobileConnectOptions;
+/**
+ * Find the list wallet for a connector id. The list hides the MetaMask SDK row
+ * behind an injected MetaMask (EIP-6963 `io.metamask`), so an id that is not in
+ * the list resolves through its connector's rdns.
+ */
+export declare function resolveWallet(wallets: readonly WalletProps[], connectors: readonly Connector[], id: string): WalletProps | undefined;
+export declare const ConnectorLauncherProvider: React.FC<{
+    children: React.ReactNode;
+}>;
+//# sourceMappingURL=context.d.ts.map

package/types/connectkit/openConnector/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/connectkit/openConnector/context.tsx"],"names":[],"mappings":"AAAA,OAAO,KAQN,MAAM,OAAO,CAAC;AACf,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AAIvC,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGrE,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,kEAAkE;AAClE,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG;IACtD,MAAM,CAAC,EAAE,oBAAoB,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACpE;;;OAGG;IACH,sBAAsB,EAAE,MAAM,OAAO,CAAC;IACtC,wDAAwD;IACxD,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,8EAA8E;IAC9E,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,yEAAyE;IACzE,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;CAChC,CAAC;AAIF,+DAA+D;AAC/D,wBAAgB,oBAAoB,IAAI,sBAAsB,GAAG,IAAI,CAEpE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,oBAAoB,CAElF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,UAAU,EAAE,SAAS,SAAS,EAAE,EAChC,EAAE,EAAE,MAAM,GACT,WAAW,GAAG,SAAS,CAOzB;AAED,eAAO,MAAM,yBAAyB,EAAE,KAAK,CAAC,EAAE,CAAC;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,CAoF7E,CAAC"}