@multiplatform.one/web3 7.31.1 → 7.33.0

package/src/connectkit/openConnector/launcher.ts

@@ -32,6 +32,13 @@ export type OpenConnectorOptions = {
    * to settle however long that takes.
    */
   fallbackMs?: number;
+  /**
+   * The chain to connect on. MetaMask asks the wallet for it first, so a page
+   * that knows its purchase chain connects there and needs no switch after.
+   * Must be one of the config's chains; a wallet that does not grant it
+   * connects on another, which the connect result reports.
+   */
+  chainId?: number;
 };
 
 export type PendingConnect = {
@@ -45,7 +52,7 @@ export type PendingConnect = {
 type Listener = (event: Event) => void;
 
 export type LauncherDeps = {
-  connect: (connector: Connector) => Promise<unknown>;
+  connect: (connector: Connector, chainId?: number) => Promise<unknown>;
   /** Show the connecting state for this wallet. */
   showConnecting: (walletId: string) => void;
   /** Show the wallet list. */
@@ -103,7 +110,7 @@ export function createConnectorLauncher(getDeps: () => LauncherDeps): ConnectorL
 
     const current = session;
     if (current && current.pending.connector.uid === connector.uid) {
-      deps.connect(connector).then(
+      deps.connect(connector, options.chainId).then(
         () => end(current),
         () => undefined,
       );
@@ -173,7 +180,7 @@ export function createConnectorLauncher(getDeps: () => LauncherDeps): ConnectorL
     };
 
     connector.emitter?.on?.("message", onMessage);
-    deps.connect(connector).then(
+    deps.connect(connector, options.chainId).then(
       () => end(s),
       (error: unknown) => fallBack(error ?? new Error("connect failed")),
     );

package/src/core/types.ts

@@ -29,6 +29,13 @@ export interface DriverState {
 export interface DriverConnectOptions {
   /** Called with a pairing URI when the connector hands off to another app or device. */
   onDisplayUri?: (uri: string) => void;
+  /**
+   * EVM: the chain to connect on, asked of the wallet first so no switch is
+   * needed after. A chain the config does not list rejects before the wallet
+   * is asked. Ignored by drivers without EVM chains, and by a connector the
+   * driver already holds open.
+   */
+  chainId?: number;
 }
 
 /** What the connection store's `connect` takes. */

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/src/wagmi/driver.spec.ts

@@ -71,6 +71,37 @@ function setup(options: { displayUri?: string } = {}) {
 describeConnectionDriver("wagmiDriver", setup);
 
 describe("wagmiDriver", () => {
+  it("connects on the chain the caller names", async () => {
+    const { driver, connector } = setup();
+    const spy = vi.spyOn(connector("wallet.one"), "connect");
+    const chainId = 8453;
+
+    await driver.connect("wallet.one", { chainId });
+
+    expect(spy).toHaveBeenCalledWith(expect.objectContaining({ chainId }));
+  });
+
+  it("refuses a chain the config does not list before asking the wallet", async () => {
+    const { driver, connector, wallets } = setup();
+    const spy = vi.spyOn(connector("wallet.one"), "connect");
+
+    await expect(driver.connect("wallet.one", { chainId: 999_999 })).rejects.toThrow(
+      /Chain not configured/,
+    );
+
+    expect(spy).not.toHaveBeenCalled();
+    expect(wallets.get("wallet.one").open).toBeFalsy();
+  });
+
+  it("connects as before when no chain is named", async () => {
+    const { driver, connector } = setup();
+    const spy = vi.spyOn(connector("wallet.one"), "connect");
+
+    await driver.connect("wallet.one");
+
+    expect(spy.mock.calls[0]![0]).not.toHaveProperty("chainId", expect.anything());
+  });
+
   it("hands a pairing URI to onDisplayUri while connecting, and stops after", async () => {
     const { driver, config, connector } = setup({ displayUri: "metamask://wc?uri=pair" });
     const onDisplayUri = vi.fn();

package/src/wagmi/driver.ts

@@ -1,6 +1,7 @@
-import type { Config, Connection, Connector } from "wagmi";
+import { ChainNotConfiguredError, type Config, type Connection, type Connector } from "wagmi";
 import {
   connect,
+  getAccount,
   getPublicClient,
   getWalletClient,
   switchConnection,
@@ -231,17 +232,22 @@ export function wagmiDriver(config: Config, options: WagmiDriverOptions = {}): C
     },
     async connect(connectorId, connectOptions: DriverConnectOptions = {}) {
       const connector = connectorFor(connectorId);
+      const { onDisplayUri, chainId } = connectOptions;
+      if (chainId !== undefined && !config.chains.some((chain) => chain.id === chainId))
+        throw new ChainNotConfiguredError();
       const open = await reuse(connector);
       if (open) return open;
       if (empty(connector)) forget(connector);
-      const { onDisplayUri } = connectOptions;
       const onMessage = ({ type, data }: { type: string; data?: unknown }) => {
         if (type === "display_uri" && typeof data === "string") onDisplayUri?.(data);
       };
       if (onDisplayUri) connector.emitter.on("message", onMessage);
       try {
-        const { accounts, chainId } = await connect(config, { connector });
-        return opened(connector, accounts, chainId);
+        const connection = await connect(
+          config,
+          chainId === undefined ? { connector } : { connector, chainId },
+        );
+        return opened(connector, connection.accounts, connection.chainId);
       } finally {
         if (onDisplayUri) connector.emitter.off("message", onMessage);
       }
@@ -296,6 +302,7 @@ export function wagmiDriver(config: Config, options: WagmiDriverOptions = {}): C
     return evmClient({
       walletClient: walletClient as unknown as EvmWalletClient,
       ...(publicClient ? { publicClient: publicClient as unknown as PublicClient } : {}),
+      current: () => getAccount(config),
     });
   }
 }

package/types/clients/evm.d.ts

@@ -1,4 +1,5 @@
 import { type Abi, type Account, type Address, type Chain, type ContractFunctionArgs, type ContractFunctionName, type EIP1193Provider, type Hash, type Hex, type PublicClient, type SendTransactionParameters, type TransactionReceipt, type Transport, type WalletClient, type WriteContractParameters } from "viem";
+import { type CurrentWalletState, type PreparedEvmSend } from "./preparedSend";
 import type { ChainClient } from "./types";
 /** A viem wallet client with its account and chain hoisted, the shape wagmi's getWalletClient returns. */
 export type EvmWalletClient = WalletClient<Transport, Chain, Account>;
@@ -158,6 +159,27 @@ export interface Erc20Actions {
         signal?: AbortSignal;
     }): Promise<Hash | null>;
 }
+/** What `prepareTransaction` takes: the transaction, and optionally its gas, nonce and lifetime. */
+export interface EvmPrepareTransactionParameters {
+    to: Address;
+    data?: Hex;
+    value?: bigint;
+    gas?: bigint;
+    nonce?: number;
+    /** How long the prepared send stays good. 60 s by default. */
+    maxAgeMs?: number;
+}
+/** What `prepareWriteContract` takes: viem's contract call, simulated before the tap. */
+export interface EvmPrepareWriteContractParameters<abi extends Abi | readonly unknown[] = Abi, functionName extends WritableFunctionName<abi> = WritableFunctionName<abi>> {
+    address: Address;
+    abi: abi;
+    functionName: functionName;
+    args?: ContractFunctionArgs<abi, "nonpayable" | "payable", functionName>;
+    value?: bigint;
+    gas?: bigint;
+    nonce?: number;
+    maxAgeMs?: number;
+}
 export interface EvmClient extends ChainClient<"evm"> {
     readonly address: Address;
     readonly chainId: number;
@@ -189,6 +211,14 @@ export interface EvmClient extends ChainClient<"evm"> {
     confirmTransaction(hash: Hash, options?: EvmWaitOptions): Promise<TransactionReceipt>;
     /** The chain explorer's page for `hash`, when the chain names an explorer. */
     explorerTxUrl(hash: Hash): string | undefined;
+    /**
+     * Does the network work for a send ahead of the user's tap (nonce, gas,
+     * fees), so the tap's handler calls `send()` with nothing awaited and the
+     * wallet app opens without "Continue to MetaMask?". See PreparedEvmSend.
+     */
+    prepareTransaction(parameters: EvmPrepareTransactionParameters): Promise<PreparedEvmSend>;
+    /** prepareTransaction for a contract call: simulates it, then encodes it. */
+    prepareWriteContract<const abi extends Abi | readonly unknown[], functionName extends WritableFunctionName<abi>>(parameters: EvmPrepareWriteContractParameters<abi, functionName>): Promise<PreparedEvmSend>;
     readonly erc20: Erc20Actions;
 }
 export type EvmClientConfig = ({
@@ -203,6 +233,8 @@ export type EvmClientConfig = ({
     /** Reads go here. Defaults to an http client on `rpcUrl`, else the chain's default RPC. */
     publicClient?: PublicClient;
     rpcUrl?: string;
+    /** The wallet's account and chain now, which a prepared send checks before it sends. */
+    current?: CurrentWalletState;
 };
 /** Bind a viem WalletClient and PublicClient into the mpo EVM client. */
 export declare function evmClient(config: EvmClientConfig): EvmClient;

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

@@ -1 +1 @@
-{"version":3,"file":"evm.d.ts","sourceRoot":"","sources":["../../src/clients/evm.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"evm.d.ts","sourceRoot":"","sources":["../../src/clients/evm.ts"],"names":[],"mappings":"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"}

package/types/clients/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/clients/hooks.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAE9D,OAAO,EAAa,KAAK,SAAS,EAAwB,MAAM,OAAO,CAAC;AACxE,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGlD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,UAAU,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,SAAS,GAAG,SAAS,CA2BzF;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,aAAa,GAAG,SAAS,CAkBjG;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,SAAS,GAAG,SAAS,CAYpD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,SAAS,CAY5D"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/clients/hooks.ts"],"names":[],"mappings":"AAKA,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAE9D,OAAO,EAAa,KAAK,SAAS,EAAwB,MAAM,OAAO,CAAC;AACxE,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGlD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,UAAU,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,SAAS,GAAG,SAAS,CA6BzF;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,aAAa,GAAG,SAAS,CAkBjG;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,SAAS,GAAG,SAAS,CAYpD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,SAAS,CAY5D"}

package/types/clients/index.d.ts

@@ -1,5 +1,6 @@
 export { ReadOnlyClientError, UnsupportedClientMethodError, type ChainClient, type ClientCapability, type ClientFamily, } from "./types";
-export { classifyTxError, evmClient, ReceiptPendingError, ReceiptWaitAbortedError, TransactionReplacedError, TransactionRevertedError, type Erc20Actions, type EvmClient, type EvmClientConfig, type EvmReplacementReason, type EvmSendTransactionParameters, type EvmWaitOptions, type EvmWalletClient, type EvmWriteContractParameters, type TxErrorKind, } from "./evm";
+export { classifyTxError, evmClient, ReceiptPendingError, ReceiptWaitAbortedError, TransactionReplacedError, TransactionRevertedError, type Erc20Actions, type EvmClient, type EvmClientConfig, type EvmPrepareTransactionParameters, type EvmPrepareWriteContractParameters, type EvmReplacementReason, type EvmSendTransactionParameters, type EvmWaitOptions, type EvmWalletClient, type EvmWriteContractParameters, type TxErrorKind, } from "./evm";
+export { DEFAULT_PREPARED_SEND_MAX_AGE_MS, prepareEvmSend, PreparedSendStaleError, type CurrentWalletState, type Eip1193Request, type PrepareEvmSendParameters, type PreparedEvmSend, type PreparedSendStaleReason, } from "./preparedSend";
 export { evmReadClient, evmReadClients, type Erc20ReadActions, type EvmReadClient, type EvmReadClientConfig, type EvmReadClients, } from "./evmRead";
 export type { Web3ChainConfig } from "../providers/walletConfig";
 export { suiClient, type SuiClient } from "./sui";