@multiplatform.one/web3 7.32.0 → 7.33.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multiplatform.one/web3",
-  "version": "7.32.0",
+  "version": "7.33.1",
   "description": "Web3 wallet integration for multiplatform.one ecosystem with ConnectKit and wagmi",
   "keywords": [
     "connectkit",
@@ -105,6 +105,12 @@
       "import": "./dist/esm/solana.mjs",
       "require": "./dist/cjs/solana.cjs"
     },
+    "./phantom": {
+      "source": "./src/phantom/index.ts",
+      "types": "./types/phantom/index.d.ts",
+      "import": "./dist/esm/phantom/index.mjs",
+      "require": "./dist/cjs/phantom/index.cjs"
+    },
     "./keycloak/login.iife.js": "./dist/keycloak/login.iife.js"
   },
   "publishConfig": {
@@ -114,10 +120,10 @@
     "@aave/account": "^0.2.0",
     "@coinbase/wallet-sdk": "^4.3.6",
     "@metamask/connect-evm": "^2.1.1",
-    "@multiplatform.one/connectkit": "7.32.0",
-    "@multiplatform.one/gpg": "7.32.0",
-    "@multiplatform.one/platform": "7.32.0",
-    "@multiplatform.one/theme": "7.32.0",
+    "@multiplatform.one/connectkit": "7.33.1",
+    "@multiplatform.one/gpg": "7.33.1",
+    "@multiplatform.one/platform": "7.33.1",
+    "@multiplatform.one/theme": "7.33.1",
     "@noble/curves": "^1.9.7",
     "@solana/kit": "^8.3.0",
     "@solana/wallet-adapter-base": "^0.9.27",
@@ -139,7 +145,7 @@
     "wagmi": "^3.7.1"
   },
   "devDependencies": {
-    "@multiplatform.one/config": "7.32.0",
+    "@multiplatform.one/config": "7.33.1",
     "@tamagui/build": "2.7.6",
     "@tanstack/react-query": "^5.100.7",
     "@testing-library/jest-dom": "^6.9.1",

package/src/connectkit/connectors/metaMaskConnectConnector.spec.ts

@@ -339,6 +339,50 @@ describe("metaMaskConnect under wagmi", () => {
     expect(request.mock.calls.map(([call]) => call.method)).toContain("personal_sign");
   });
 
+  it("signs under mainnet's scope when the desktop extension sits on a chain the app does not list", async () => {
+    // As @metamask/connect-evm's EIP1193Provider: the scope comes from
+    // selectedChainId before the first await, and a chain outside
+    // supportedNetworks is refused there.
+    const scopes: string[] = [];
+    const provider = {
+      selectedChainId: "0x2105" as string | undefined,
+      request: vi.fn(({ method }: { method: string }) => {
+        const chainId = provider.selectedChainId!;
+        const { api } = createEVMClient.mock.calls[0]![0] as {
+          api: { supportedNetworks: Record<string, string> };
+        };
+        if (!api.supportedNetworks[chainId])
+          return Promise.reject(
+            new Error(`Chain eip155:${Number(chainId)} is not configured in supportedNetworks`),
+          );
+        scopes.push(`eip155:${Number(chainId)}`);
+        return Promise.resolve(method === "personal_sign" ? "0x5167" : "0xabc");
+      }),
+    };
+    client.getChainId.mockImplementation(() => provider.selectedChainId!);
+    client.getProvider.mockReturnValue(provider as never);
+    client.connect.mockImplementationOnce(async () => ({ accounts: [first], chainId: "0x1" }));
+    const config = createConfig({
+      chains: [polygon, mainnet],
+      connectors: [metaMaskConnect({ dapp: { name: "test", url: "https://example.test" } })],
+      transports: { [polygon.id]: http(), [mainnet.id]: http() },
+      multiInjectedProviderDiscovery: false,
+      storage: null,
+    });
+    await connect(config, { connector: config.connectors[0]! });
+    (await clientEvents()).chainChanged("0x2105");
+
+    const signature = await signMessage(config, { message: "prove it" });
+
+    expect(signature).toBe("0x5167");
+    expect(scopes).toEqual(["eip155:1"]);
+    expect(provider.selectedChainId).toBe("0x2105");
+    await expect(sendTransaction(config, { to: second, value: 1n, gas: 21000n })).rejects.toThrow();
+    expect(provider.request.mock.calls.map(([call]) => call.method)).not.toContain(
+      "eth_sendTransaction",
+    );
+  });
+
   it("sends no transaction or typed signature on mainnet for an app that does not list it", async () => {
     const request = vi.fn(async ({ method }: { method: string }) =>
       method === "eth_chainId" ? "0x1" : "0xabc",

package/src/connectkit/connectors/metaMaskConnectConnector.ts

@@ -115,20 +115,45 @@ const offListMethods = new Set([
   "wallet_registerOnboarding",
 ]);
 
+/**
+ * MetaMask Connect scopes a request to the provider's selected chain and refuses
+ * one outside supportedNetworks. The desktop extension moves that chain to
+ * wherever the user's MetaMask sits, Base say, so personal_sign there never
+ * reached the wallet (MPO-494). It goes under mainnet's scope instead, which
+ * MetaMask Connect adds to every session. The provider reads the scope before
+ * its first await, so the selected chain is put back before anything else runs.
+ */
+function signUnderMainnet(
+  provider: EIP1193Provider,
+  args: { method: string; params?: unknown },
+): Promise<unknown> {
+  const selected = provider.selectedChainId;
+  provider.selectedChainId = numberToHex(mainnet.id);
+  try {
+    return provider.request(args as never);
+  } finally {
+    provider.selectedChainId = selected;
+  }
+}
+
 function listedChainsOnly(
   provider: EIP1193Provider,
   mm: MetamaskConnectEVM,
   networks: Record<Hex, string>,
+  supportedNetworks: Record<Hex, string>,
 ): EIP1193Provider {
   const request = (async (args: { method: string; params?: unknown }) => {
     const chainId = mm.getChainId();
-    if (chainId && !networks[numberToHex(Number(chainId))] && !offListMethods.has(args.method))
+    const current = chainId ? numberToHex(Number(chainId)) : undefined;
+    if (current && !networks[current] && !offListMethods.has(args.method))
       throw Object.assign(
         new Error(
           `MetaMask is on chain ${Number(chainId)}, which this app does not list, so ${args.method} was not sent`,
         ),
         { code: 4901 },
       );
+    if (current && !supportedNetworks[current] && args.method === "personal_sign")
+      return signUnderMainnet(provider, args);
     return provider.request(args as never);
   }) as EIP1193Provider["request"];
   return new Proxy(provider, {
@@ -383,7 +408,10 @@ export function metaMaskConnect(parameters: MetaMaskConnectParameters) {
         const mm = await claim();
         const provider = mm.getProvider();
         if (guarded?.provider !== provider)
-          guarded = { provider, wrapped: listedChainsOnly(provider, mm, networks) };
+          guarded = {
+            provider,
+            wrapped: listedChainsOnly(provider, mm, networks, supportedNetworks),
+          };
         return guarded.wrapped;
       },
       async isAuthorized() {

package/src/phantom/evm.spec.ts

@@ -0,0 +1,195 @@
+import { baseSepolia } from "viem/chains";
+import { describe, expect, it, vi } from "vitest";
+import {
+  connectPhantomEvm,
+  discoverPhantomEthereumProvider,
+  openInPhantom,
+  phantomEthereumProvider,
+  phantomEvmRoute,
+  PhantomNotInjectedError,
+  type PhantomEthereumProvider,
+} from "./evm";
+
+const account = "0x1111111111111111111111111111111111111111";
+
+function fakeProvider(chainId: number, opts: { unknownChain?: boolean } = {}) {
+  let current = chainId;
+  let known = !opts.unknownChain;
+  const calls: { method: string; params?: unknown }[] = [];
+  const request = vi.fn(async ({ method, params }: { method: string; params?: unknown }) => {
+    calls.push({ method, params });
+    switch (method) {
+      case "eth_requestAccounts":
+      case "eth_accounts":
+        return [account];
+      case "eth_chainId":
+        return `0x${current.toString(16)}`;
+      case "wallet_switchEthereumChain": {
+        if (!known) throw Object.assign(new Error("Unrecognized chain"), { code: 4902 });
+        current = Number((params as [{ chainId: string }])[0].chainId);
+        return null;
+      }
+      case "wallet_addEthereumChain":
+        known = true;
+        return null;
+      default:
+        throw new Error(`unexpected ${method}`);
+    }
+  });
+  const provider = { isPhantom: true, request, on: vi.fn(), removeListener: vi.fn() };
+  return { provider: provider as unknown as PhantomEthereumProvider, calls };
+}
+
+describe("phantom evm", () => {
+  it("finds window.phantom.ethereum, then a Phantom window.ethereum, and nothing else", () => {
+    const own = { isPhantom: true } as unknown as PhantomEthereumProvider;
+    const other = { isMetaMask: true } as unknown as PhantomEthereumProvider;
+    expect(phantomEthereumProvider({ phantom: { ethereum: own }, ethereum: other })).toBe(own);
+    expect(phantomEthereumProvider({ ethereum: own })).toBe(own);
+    expect(phantomEthereumProvider({ ethereum: other })).toBeUndefined();
+    expect(phantomEvmRoute({ ethereum: other })).toBe("browse");
+    expect(phantomEvmRoute({ phantom: { ethereum: own } })).toBe("injected");
+  });
+
+  it("takes Phantom's EIP-6963 announcement", async () => {
+    const provider = { isPhantom: true } as unknown as PhantomEthereumProvider;
+    const target = new EventTarget();
+    target.addEventListener("eip6963:requestProvider", () => {
+      target.dispatchEvent(
+        Object.assign(new Event("eip6963:announceProvider"), {
+          detail: { info: { rdns: "io.metamask" }, provider: {} },
+        }),
+      );
+      target.dispatchEvent(
+        Object.assign(new Event("eip6963:announceProvider"), {
+          detail: { info: { rdns: "app.phantom" }, provider },
+        }),
+      );
+    });
+    const win = {
+      addEventListener: target.addEventListener.bind(target),
+      removeEventListener: target.removeEventListener.bind(target),
+      dispatchEvent: target.dispatchEvent.bind(target),
+    };
+    await expect(discoverPhantomEthereumProvider({ window: win as never })).resolves.toBe(provider);
+  });
+
+  it("resolves undefined when nothing announces", async () => {
+    const target = new EventTarget();
+    const win = {
+      addEventListener: target.addEventListener.bind(target),
+      removeEventListener: target.removeEventListener.bind(target),
+      dispatchEvent: target.dispatchEvent.bind(target),
+    };
+    await expect(
+      discoverPhantomEthereumProvider({ window: win as never, timeout: 5 }),
+    ).resolves.toBeUndefined();
+  });
+
+  it("opens this page in Phantom's browser synchronously", () => {
+    const assign = vi.fn();
+    const link = openInPhantom({
+      window: {
+        location: {
+          href: "https://dev.promanager.vip/u/buy?mobile=1",
+          origin: "https://dev.promanager.vip",
+          assign,
+        },
+      },
+    });
+    expect(link).toBe(
+      "https://phantom.com/ul/browse/https%3A%2F%2Fdev.promanager.vip%2Fu%2Fbuy%3Fmobile%3D1?ref=https%3A%2F%2Fdev.promanager.vip",
+    );
+    expect(assign).toHaveBeenCalledWith(link);
+  });
+
+  it("connects, switches to Base Sepolia, and returns a client on it", async () => {
+    const { provider, calls } = fakeProvider(1);
+    const client = await connectPhantomEvm({ chain: baseSepolia, provider });
+    expect(client.address.toLowerCase()).toBe(account);
+    expect(client.chainId).toBe(84532);
+    expect(calls.map((c) => c.method)).toEqual([
+      "eth_requestAccounts",
+      "eth_chainId",
+      "wallet_switchEthereumChain",
+    ]);
+    expect(calls[2].params).toEqual([{ chainId: "0x14a34" }]);
+  });
+
+  it("adds the chain when Phantom does not know it", async () => {
+    const { provider, calls } = fakeProvider(1, { unknownChain: true });
+    await connectPhantomEvm({ chain: baseSepolia, provider });
+    expect(calls.map((c) => c.method)).toEqual([
+      "eth_requestAccounts",
+      "eth_chainId",
+      "wallet_switchEthereumChain",
+      "wallet_addEthereumChain",
+      "wallet_switchEthereumChain",
+    ]);
+    expect((calls[3].params as [{ chainId: string; rpcUrls: string[] }])[0]).toMatchObject({
+      chainId: "0x14a34",
+      rpcUrls: [...baseSepolia.rpcUrls.default.http],
+    });
+  });
+
+  it("skips the switch when already on the chain", async () => {
+    const { provider, calls } = fakeProvider(84532);
+    await connectPhantomEvm({ chain: baseSepolia, provider });
+    expect(calls.map((c) => c.method)).toEqual(["eth_requestAccounts", "eth_chainId"]);
+  });
+
+  it("sends an ERC-20 transfer to Phantom as eth_sendTransaction", async () => {
+    const { provider } = fakeProvider(84532);
+    const sent: unknown[] = [];
+    const request = provider.request as unknown as ReturnType<typeof vi.fn>;
+    const base = request.getMockImplementation() as (a: {
+      method: string;
+      params?: unknown;
+    }) => Promise<unknown>;
+    request.mockImplementation(async (args: { method: string; params?: unknown }) => {
+      if (args.method === "eth_sendTransaction") {
+        sent.push(args.params);
+        return `0x${"ab".repeat(32)}`;
+      }
+      return base(args);
+    });
+    const client = await connectPhantomEvm({ chain: baseSepolia, provider });
+    const hash = await client.walletClient.writeContract({
+      address: "0xc6fe3521644e0f5439fe345f64d372cd6ed37491",
+      abi: [
+        {
+          type: "function",
+          name: "transfer",
+          stateMutability: "nonpayable",
+          inputs: [
+            { name: "to", type: "address" },
+            { name: "amount", type: "uint256" },
+          ],
+          outputs: [{ type: "bool" }],
+        },
+      ],
+      functionName: "transfer",
+      args: ["0x2222222222222222222222222222222222222222", 10n ** 18n],
+      gas: 100000n,
+    });
+    expect(hash).toBe(`0x${"ab".repeat(32)}`);
+    expect(sent[0]).toEqual([
+      expect.objectContaining({
+        from: account,
+        to: "0xc6fe3521644e0f5439fe345f64d372cd6ed37491",
+        data: expect.stringMatching(/^0xa9059cbb0{24}2{40}/),
+      }),
+    ]);
+  });
+
+  it("says to reopen in Phantom when nothing is injected", async () => {
+    vi.stubGlobal("phantom", undefined);
+    try {
+      await expect(connectPhantomEvm({ chain: baseSepolia })).rejects.toBeInstanceOf(
+        PhantomNotInjectedError,
+      );
+    } finally {
+      vi.unstubAllGlobals();
+    }
+  });
+});

package/src/phantom/evm.ts

@@ -0,0 +1,163 @@
+import { numberToHex, type Chain, type EIP1193Provider, type PublicClient } from "viem";
+import { evmClient, type EvmClient } from "../clients/evm";
+import { phantomBrowseUrl } from "./urls";
+
+export type PhantomEthereumProvider = EIP1193Provider & { isPhantom?: boolean };
+
+interface PhantomWindow {
+  phantom?: { ethereum?: PhantomEthereumProvider };
+  ethereum?: PhantomEthereumProvider;
+  location?: { href: string; origin: string; assign(url: string): void };
+  addEventListener?: (type: string, listener: (event: Event) => void) => void;
+  removeEventListener?: (type: string, listener: (event: Event) => void) => void;
+  dispatchEvent?: (event: Event) => boolean;
+}
+
+const phantomRdns = "app.phantom";
+
+/**
+ * Phantom's injected EVM provider: `window.phantom.ethereum`, else a
+ * `window.ethereum` that says it is Phantom. Present in Phantom's desktop
+ * extension and its in-app browser, never in Chrome or Safari on a phone.
+ */
+export function phantomEthereumProvider(
+  win: PhantomWindow = globalThis as PhantomWindow,
+): PhantomEthereumProvider | undefined {
+  const own = win.phantom?.ethereum;
+  if (own?.isPhantom) return own;
+  if (win.ethereum?.isPhantom) return win.ethereum;
+  return undefined;
+}
+
+/**
+ * phantomEthereumProvider, or Phantom's EIP-6963 announcement (rdns
+ * `app.phantom`) when the provider is not on `window` yet. Resolves undefined
+ * after `timeout` ms.
+ */
+export function discoverPhantomEthereumProvider(
+  options: { timeout?: number; window?: PhantomWindow } = {},
+): Promise<PhantomEthereumProvider | undefined> {
+  const win = options.window ?? (globalThis as PhantomWindow);
+  const found = phantomEthereumProvider(win);
+  if (found || !win.addEventListener || !win.dispatchEvent) return Promise.resolve(found);
+  return new Promise((resolve) => {
+    const onAnnounce = (event: Event) => {
+      const detail = (
+        event as CustomEvent<{ info?: { rdns?: string }; provider?: PhantomEthereumProvider }>
+      ).detail;
+      if (detail?.info?.rdns !== phantomRdns || !detail.provider) return;
+      done(detail.provider);
+    };
+    const timer = setTimeout(() => done(phantomEthereumProvider(win)), options.timeout ?? 500);
+    const done = (provider: PhantomEthereumProvider | undefined) => {
+      clearTimeout(timer);
+      win.removeEventListener?.("eip6963:announceProvider", onAnnounce);
+      resolve(provider);
+    };
+    win.addEventListener?.("eip6963:announceProvider", onAnnounce);
+    win.dispatchEvent?.(new Event("eip6963:requestProvider"));
+  });
+}
+
+/**
+ * How this page reaches Phantom's EVM wallet: `injected` when Phantom's
+ * provider is here (extension or Phantom's browser), `browse` when the page
+ * must first reopen inside Phantom with openInPhantom.
+ */
+export function phantomEvmRoute(win: PhantomWindow = globalThis as PhantomWindow) {
+  return phantomEthereumProvider(win) ? ("injected" as const) : ("browse" as const);
+}
+
+export interface OpenInPhantomOptions {
+  /** The page to open in Phantom's browser. Defaults to this page. */
+  url?: string;
+  /** The requesting app. Defaults to this page's origin. */
+  ref?: string;
+  /** Defaults to `location.assign`. */
+  navigate?: (url: string) => void;
+  base?: string;
+  window?: PhantomWindow;
+}
+
+/**
+ * Reopens the page inside Phantom's in-app browser. Call it straight from the
+ * tap handler with nothing awaited first: mobile browsers only follow a link
+ * into another app without a prompt inside the tap's user activation.
+ * Returns the link, for an `<a href>` instead.
+ */
+export function openInPhantom(options: OpenInPhantomOptions = {}): string {
+  const win = options.window ?? (globalThis as PhantomWindow);
+  const url = options.url ?? win.location?.href;
+  const ref = options.ref ?? win.location?.origin ?? url;
+  if (!url || !ref) throw new Error("openInPhantom: no page URL here; pass `url` and `ref`");
+  const link = phantomBrowseUrl(url, ref, { base: options.base });
+  (options.navigate ?? ((target: string) => win.location?.assign(target)))(link);
+  return link;
+}
+
+export interface ConnectPhantomEvmOptions {
+  chain: Chain;
+  /** Defaults to phantomEthereumProvider(). */
+  provider?: PhantomEthereumProvider;
+  publicClient?: PublicClient;
+  rpcUrl?: string;
+}
+
+export class PhantomNotInjectedError extends Error {
+  constructor() {
+    super(
+      "Phantom's EVM provider is not on this page: on a phone, reopen it in Phantom with openInPhantom()",
+    );
+    this.name = "PhantomNotInjectedError";
+  }
+}
+
+const errorCode = (error: unknown) =>
+  (error as { code?: unknown; cause?: { code?: unknown } } | undefined)?.code ??
+  (error as { cause?: { code?: unknown } } | undefined)?.cause?.code;
+
+async function ensureChain(provider: PhantomEthereumProvider, chain: Chain) {
+  const current = await provider.request({ method: "eth_chainId" });
+  if (Number(current) === chain.id) return;
+  const chainId = numberToHex(chain.id);
+  try {
+    await provider.request({ method: "wallet_switchEthereumChain", params: [{ chainId }] });
+  } catch (error) {
+    if (errorCode(error) !== 4902) throw error;
+    await provider.request({
+      method: "wallet_addEthereumChain",
+      params: [
+        {
+          chainId,
+          chainName: chain.name,
+          nativeCurrency: chain.nativeCurrency,
+          rpcUrls: [...chain.rpcUrls.default.http],
+          blockExplorerUrls: chain.blockExplorers ? [chain.blockExplorers.default.url] : undefined,
+        },
+      ],
+    });
+    await provider.request({ method: "wallet_switchEthereumChain", params: [{ chainId }] });
+  }
+}
+
+/**
+ * Connects Phantom's injected EVM wallet, moves it to `chain`, and returns
+ * the mpo EVM client on it, so `erc20.transfer` and `writeContract` go to
+ * Phantom for approval. Testnets such as Base Sepolia need Phantom's Testnet
+ * Mode on.
+ */
+export async function connectPhantomEvm(options: ConnectPhantomEvmOptions): Promise<EvmClient> {
+  const provider = options.provider ?? phantomEthereumProvider();
+  if (!provider) throw new PhantomNotInjectedError();
+  const accounts = await provider.request({ method: "eth_requestAccounts" });
+  const account = accounts[0];
+  if (!account) throw new Error("Phantom returned no EVM account");
+  await ensureChain(provider, options.chain);
+  return evmClient({
+    provider,
+    account,
+    chain: options.chain,
+    publicClient: options.publicClient,
+    rpcUrl: options.rpcUrl,
+  });
+}

package/src/phantom/index.ts

@@ -0,0 +1,16 @@
+// `@multiplatform.one/web3/phantom`: Phantom's EVM wallet from a phone's own
+// browser. Phantom's deeplinks carry no EVM methods, so the page reopens in
+// Phantom's in-app browser (openInPhantom) and connects the provider Phantom
+// injects there (connectPhantomEvm).
+export {
+  connectPhantomEvm,
+  discoverPhantomEthereumProvider,
+  openInPhantom,
+  phantomEthereumProvider,
+  phantomEvmRoute,
+  PhantomNotInjectedError,
+  type ConnectPhantomEvmOptions,
+  type OpenInPhantomOptions,
+  type PhantomEthereumProvider,
+} from "./evm";
+export { phantomBrowseUrl, phantomUniversalLinkBase } from "./urls";

package/src/phantom/urls.spec.ts

@@ -0,0 +1,29 @@
+import { describe, expect, it } from "vitest";
+import { phantomBrowseUrl } from "./urls";
+
+describe("phantomBrowseUrl", () => {
+  it("builds the browse link Phantom documents", () => {
+    expect(
+      phantomBrowseUrl(
+        "https://magiceden.io/item-details/8yjN8iRuoiYiKW487cnW9vn6mLBR5E8aCNKsBRmTP9vN",
+        "https://magiceden.io",
+      ),
+    ).toBe(
+      "https://phantom.com/ul/browse/https%3A%2F%2Fmagiceden.io%2Fitem-details%2F8yjN8iRuoiYiKW487cnW9vn6mLBR5E8aCNKsBRmTP9vN?ref=https%3A%2F%2Fmagiceden.io",
+    );
+  });
+
+  it("keeps a page's own query inside the browse link", () => {
+    expect(
+      phantomBrowseUrl(
+        "https://dev.promanager.vip/u/buy?mobile=1&x=a b",
+        "https://dev.promanager.vip",
+        {
+          base: "https://phantom.app/ul/",
+        },
+      ),
+    ).toBe(
+      "https://phantom.app/ul/browse/https%3A%2F%2Fdev.promanager.vip%2Fu%2Fbuy%3Fmobile%3D1%26x%3Da%20b?ref=https%3A%2F%2Fdev.promanager.vip",
+    );
+  });
+});

package/src/phantom/urls.ts

@@ -0,0 +1,16 @@
+/** Phantom's universal-link host. `https://phantom.app/ul` still answers; Phantom asks new code to use this one. */
+export const phantomUniversalLinkBase = "https://phantom.com/ul";
+
+/**
+ * Opens `url` inside Phantom's in-app browser, where Phantom injects
+ * `window.phantom.ethereum`. Phantom's deeplinks carry no EVM methods, so
+ * this is how a phone's browser reaches its EVM wallet.
+ */
+export function phantomBrowseUrl(
+  url: string,
+  ref: string,
+  options: { base?: string } = {},
+): string {
+  const base = (options.base ?? phantomUniversalLinkBase).replace(/\/+$/, "");
+  return `${base}/browse/${encodeURIComponent(url)}?ref=${encodeURIComponent(ref)}`;
+}

package/types/connectkit/connectors/metaMaskConnectConnector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metaMaskConnectConnector.d.ts","sourceRoot":"","sources":["../../../src/connectkit/connectors/metaMaskConnectConnector.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAsB,MAAM,uBAAuB,CAAC;AAEjF,OAAO,EAA2B,KAAK,iBAAiB,EAAmB,MAAM,OAAO,CAAC;AACzF,OAAO,EAEL,KAAK,KAAK,EAEV,KAAK,GAAG,EAKT,MAAM,MAAM,CAAC;AAKd,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mFAAmF;IACnF,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,6EAA6E;IAC7E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;CAC3C,CAAC;AAEF,KAAK,eAAe,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;AAGxD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,KAAK,EAAE,EACxB,UAAU,CAAC,EAAE,eAAe,CAAC,YAAY,CAAC,GACzC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAQrB;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,EAC7B,UAAU,CAAC,EAAE,eAAe,CAAC,YAAY,CAAC,GACzC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAOrB;AA6ED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAE1D;AAOD,wGAAwG;AACxG,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,GAAG,EAAE,CAK9F;AAqBD;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAIxC;AAgFD,oFAAoF;AACpF,wBAAgB,0BAA0B,IAAI,IAAI,CAIjD;AAWD,wBAAgB,eAAe,CAAC,UAAU,EAAE,yBAAyB,wFAqJpE;yBArJe,eAAe"}
+{"version":3,"file":"metaMaskConnectConnector.d.ts","sourceRoot":"","sources":["../../../src/connectkit/connectors/metaMaskConnectConnector.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAsB,MAAM,uBAAuB,CAAC;AAEjF,OAAO,EAA2B,KAAK,iBAAiB,EAAmB,MAAM,OAAO,CAAC;AACzF,OAAO,EAEL,KAAK,KAAK,EAEV,KAAK,GAAG,EAKT,MAAM,MAAM,CAAC;AAKd,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mFAAmF;IACnF,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,6EAA6E;IAC7E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;CAC3C,CAAC;AAEF,KAAK,eAAe,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;AAGxD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,KAAK,EAAE,EACxB,UAAU,CAAC,EAAE,eAAe,CAAC,YAAY,CAAC,GACzC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAQrB;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,EAC7B,UAAU,CAAC,EAAE,eAAe,CAAC,YAAY,CAAC,GACzC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAOrB;AAsGD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAE1D;AAOD,wGAAwG;AACxG,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,GAAG,EAAE,CAK9F;AAqBD;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAIxC;AAgFD,oFAAoF;AACpF,wBAAgB,0BAA0B,IAAI,IAAI,CAIjD;AAWD,wBAAgB,eAAe,CAAC,UAAU,EAAE,yBAAyB,wFAwJpE;yBAxJe,eAAe"}

package/types/phantom/evm.d.ts

@@ -0,0 +1,76 @@
+import { type Chain, type EIP1193Provider, type PublicClient } from "viem";
+import { type EvmClient } from "../clients/evm";
+export type PhantomEthereumProvider = EIP1193Provider & {
+    isPhantom?: boolean;
+};
+interface PhantomWindow {
+    phantom?: {
+        ethereum?: PhantomEthereumProvider;
+    };
+    ethereum?: PhantomEthereumProvider;
+    location?: {
+        href: string;
+        origin: string;
+        assign(url: string): void;
+    };
+    addEventListener?: (type: string, listener: (event: Event) => void) => void;
+    removeEventListener?: (type: string, listener: (event: Event) => void) => void;
+    dispatchEvent?: (event: Event) => boolean;
+}
+/**
+ * Phantom's injected EVM provider: `window.phantom.ethereum`, else a
+ * `window.ethereum` that says it is Phantom. Present in Phantom's desktop
+ * extension and its in-app browser, never in Chrome or Safari on a phone.
+ */
+export declare function phantomEthereumProvider(win?: PhantomWindow): PhantomEthereumProvider | undefined;
+/**
+ * phantomEthereumProvider, or Phantom's EIP-6963 announcement (rdns
+ * `app.phantom`) when the provider is not on `window` yet. Resolves undefined
+ * after `timeout` ms.
+ */
+export declare function discoverPhantomEthereumProvider(options?: {
+    timeout?: number;
+    window?: PhantomWindow;
+}): Promise<PhantomEthereumProvider | undefined>;
+/**
+ * How this page reaches Phantom's EVM wallet: `injected` when Phantom's
+ * provider is here (extension or Phantom's browser), `browse` when the page
+ * must first reopen inside Phantom with openInPhantom.
+ */
+export declare function phantomEvmRoute(win?: PhantomWindow): "injected" | "browse";
+export interface OpenInPhantomOptions {
+    /** The page to open in Phantom's browser. Defaults to this page. */
+    url?: string;
+    /** The requesting app. Defaults to this page's origin. */
+    ref?: string;
+    /** Defaults to `location.assign`. */
+    navigate?: (url: string) => void;
+    base?: string;
+    window?: PhantomWindow;
+}
+/**
+ * Reopens the page inside Phantom's in-app browser. Call it straight from the
+ * tap handler with nothing awaited first: mobile browsers only follow a link
+ * into another app without a prompt inside the tap's user activation.
+ * Returns the link, for an `<a href>` instead.
+ */
+export declare function openInPhantom(options?: OpenInPhantomOptions): string;
+export interface ConnectPhantomEvmOptions {
+    chain: Chain;
+    /** Defaults to phantomEthereumProvider(). */
+    provider?: PhantomEthereumProvider;
+    publicClient?: PublicClient;
+    rpcUrl?: string;
+}
+export declare class PhantomNotInjectedError extends Error {
+    constructor();
+}
+/**
+ * Connects Phantom's injected EVM wallet, moves it to `chain`, and returns
+ * the mpo EVM client on it, so `erc20.transfer` and `writeContract` go to
+ * Phantom for approval. Testnets such as Base Sepolia need Phantom's Testnet
+ * Mode on.
+ */
+export declare function connectPhantomEvm(options: ConnectPhantomEvmOptions): Promise<EvmClient>;
+export {};
+//# sourceMappingURL=evm.d.ts.map

package/types/phantom/evm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evm.d.ts","sourceRoot":"","sources":["../../src/phantom/evm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,KAAK,EAAE,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,MAAM,CAAC;AACxF,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3D,MAAM,MAAM,uBAAuB,GAAG,eAAe,GAAG;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEhF,UAAU,aAAa;IACrB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,uBAAuB,CAAA;KAAE,CAAC;IACjD,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACvE,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,KAAK,IAAI,CAAC;IAC5E,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,KAAK,IAAI,CAAC;IAC/E,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;CAC3C;AAID;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,GAAE,aAA2C,GAC/C,uBAAuB,GAAG,SAAS,CAKrC;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,aAAa,CAAA;CAAO,GACzD,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC,CAqB9C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,GAAE,aAA2C,yBAE/E;AAED,MAAM,WAAW,oBAAoB;IACnC,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,MAAM,CAQxE;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,KAAK,CAAC;IACb,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,uBAAwB,SAAQ,KAAK;;CAOjD;AA8BD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,SAAS,CAAC,CAc7F"}

package/types/phantom/index.d.ts

@@ -0,0 +1,3 @@
+export { connectPhantomEvm, discoverPhantomEthereumProvider, openInPhantom, phantomEthereumProvider, phantomEvmRoute, PhantomNotInjectedError, type ConnectPhantomEvmOptions, type OpenInPhantomOptions, type PhantomEthereumProvider, } from "./evm";
+export { phantomBrowseUrl, phantomUniversalLinkBase } from "./urls";
+//# sourceMappingURL=index.d.ts.map