@multiplatform.one/web3 7.17.0 → 7.19.0

package/README.md

@@ -24,6 +24,66 @@ Peers: `react`, `@tanstack/react-query`.
   `WalletStatus`, `NetworkSwitcher`
 - **Subpaths** — `./native` (WebView wallet bridge), `./connectkit`
 
+## Per-chain clients
+
+Apps talk to a chain through a client, never through wagmi, `window.ethereum`
+or a provider's `request`. Every client shares
+`{ family, address, chainId?, capabilities, signMessage(message) }`, and
+`signMessage` returns the family's native signature, the one the Keycloak
+verifiers take: EVM 0x hex, Solana base58, Sui base64, Bitcoin base64 BIP-322,
+GPG the armored signature plus the armored public key.
+
+| Hook / factory                                                                    | What it adds                                                                                                                                                                                                                                                                |
+| --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `useEvmClient()` / `evmClient({ walletClient } \| { provider, account, chain })`  | viem `walletClient` + `publicClient`, `sendTransaction`, `writeContract`, `waitForTransactionReceipt`, `erc20.{transfer, approve, ensureAllowance, balanceOf, allowance, decimals}`, safe for tokens like USDT that return nothing or refuse a non-zero to non-zero approve |
+| `useSolanaClient()` / `solanaClient({ signer, rpcUrl?, chain? })` from `./solana` | web only: `@solana/kit` `rpc`, `signTransaction`, `signAndSendTransaction`, `sendTransaction`, `confirmTransaction`, `getBalance`, `transferSol`                                                                                                                            |
+| `useGpgSigner()` / `createGpgSigner()`                                            | the copy/paste GPG signer: `signMessage` parks a request with its terminal `command`; `submit(pasted, request)` resolves it only while `request` is still the pending one and the pasted signature covers its message                                                       |
+| `useSuiClient()`, `useBitcoinClient()`                                            | message signing only; `signTransaction` / `signPsbt` reject with `UnsupportedClientMethodError` until transactions land                                                                                                                                                     |
+
+```tsx
+import { useEvmClient } from "@multiplatform.one/web3";
+import { useSolanaClient } from "@multiplatform.one/web3/solana";
+
+const evm = useEvmClient();
+await evm?.erc20.ensureAllowance({ token: qcc, spender: store, amount });
+await evm?.writeContract({ address: store, abi, functionName: "buy", args: [packageId] });
+
+const sol = useSolanaClient();
+const sent = await sol?.transferSol({ to, lamports: 1_000_000n });
+await sol?.confirmTransaction(sent!);
+```
+
+`transferSol` returns the signature with the blockhash's `lastValidBlockHeight`,
+and `confirmTransaction` waits until the chain passes that height before it
+gives up. Its `SolanaConfirmationError` has `mayStillLand`: `false` means the
+transaction failed or expired and a retry is safe; `true` (only when there was
+no `lastValidBlockHeight` to judge by) means resending can pay twice.
+
+A Solana client runs over a byte-level `SolanaSigner`: `standardSolanaSigner`
+(Wallet Standard: Phantom, Solflare, Backpack), `injectedSolanaSigner` (what the
+modal connected), or `connectSolanaWallet()` without the modal. RPC defaults to
+`Web3Config.solanaRpcUrl`.
+
+The Solana client is the web-only `@multiplatform.one/web3/solana` subpath, with
+no `react-native` condition. The root is also the native entry, and a native app
+signs Solana through the WebView bridge, so the root never imports
+`@solana/kit`. Sign-in does not need it either: `SIWEProvider` signs Solana
+through `solanaMessageClient`, so a login page carries no kit.
+`tests/clients/importGraph.spec.ts` holds both lines, for native and web.
+
+### Solana on mobile (follow-up)
+
+The web path is done. A native app cannot reach Phantom through the WebView
+bridge alone: the WebView has no injected Phantom, and a dapp opened inside
+Phantom's in-app browser can never hand control back to the calling app. The
+chosen direction is Phantom's deeplink protocol (Solflare speaks the same one),
+bridged to the WebView like every other native signer and never a native module: an X25519 keypair per session, `connect`,
+`signMessage`, `signTransaction` and `signAndSendTransaction` sent to
+`https://phantom.app/ul/v1/<method>` with a `redirect_link` back into the app,
+payloads sealed with NaCl box, and the session token kept for later calls. The
+native host owns `Linking`; the client, the modal and login stay unchanged.
+Android can later add Solana Mobile Wallet Adapter as a second signer.
+
 ## What it must not do
 
 - No modal shell — the modal UI lives in `@multiplatform.one/connectkit`;

package/dist/cjs/clients/adapter.cjs

@@ -0,0 +1,33 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all) __defProp(target, name, {
+    get: all[name],
+    enumerable: true
+  });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+  }
+  return to;
+};
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: true
+}), mod);
+var adapter_exports = {};
+__export(adapter_exports, {
+  connectorAdapter: () => connectorAdapter
+});
+module.exports = __toCommonJS(adapter_exports);
+function connectorAdapter(connector, ecosystem) {
+  const c = connector;
+  if (!c?.adapter || !c.ecosystem || c.ecosystem === "evm") return null;
+  if (ecosystem && c.ecosystem !== ecosystem) return null;
+  return c.adapter;
+}

package/dist/cjs/clients/adapter.native.js

@@ -0,0 +1,36 @@
+"use strict";
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all) __defProp(target, name, {
+    get: all[name],
+    enumerable: true
+  });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+  }
+  return to;
+};
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: true
+}), mod);
+var adapter_exports = {};
+__export(adapter_exports, {
+  connectorAdapter: () => connectorAdapter
+});
+module.exports = __toCommonJS(adapter_exports);
+function connectorAdapter(connector, ecosystem) {
+  var c = connector;
+  if (!(c === null || c === void 0 ? void 0 : c.adapter) || !c.ecosystem || c.ecosystem === "evm") return null;
+  if (ecosystem && c.ecosystem !== ecosystem) return null;
+  return c.adapter;
+}
+//# sourceMappingURL=adapter.native.js.map

package/dist/cjs/clients/adapter.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["__toCommonJS","mod","__copyProps","__defProp","value","adapter_exports","__export","connectorAdapter","module","exports","connector","ecosystem","c","adapter"],"sources":["../../../src/clients/adapter.ts"],"sourcesContent":[null],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,YAAA,GAAAC,GAAA,IAAAC,WAAA,CAAAC,SAAA;EAAAC,KAAA;AAAA,IAAAH,GAAA;AAAA,IAAAI,eAAA;AAAAC,QAAA,CAAAD,eAAA;EAAAE,gBAAA,EAAAA,CAAA,KAAAA;AAAA;AAIOC,MAAA,CAAAC,OAAS,GAAAT,YACd,CAAAK,eACA;AAEA,SAAME,gBAAIA,CAAAG,SAAA,EAAAC,SAAA;EACV,IAAIC,CAAC,GAAGF,SAAA;EACR,IAAI,EAAAE,CAAA,aAAeA,CAAA,cAAc,SAAWA,CAAA,CAAAC,OAAO,MAAAD,CAAA,CAAAD,SAAA,IAAAC,CAAA,CAAAD,SAAA;EACnD,IAAAA,SAAS,IAAAC,CAAA,CAAAD,SAAA,KAAAA,SAAA;EACX,OAAAC,CAAA,CAAAC,OAAA","ignoreList":[]}

package/dist/cjs/clients/bitcoin.cjs

@@ -0,0 +1,46 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all) __defProp(target, name, {
+    get: all[name],
+    enumerable: true
+  });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+  }
+  return to;
+};
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: true
+}), mod);
+var bitcoin_exports = {};
+__export(bitcoin_exports, {
+  bitcoinClient: () => bitcoinClient
+});
+module.exports = __toCommonJS(bitcoin_exports);
+var import_types = require("./types.cjs");
+const txTodo = "needs PSBT signing through the wallet (Unisat/OKX signPsbt, Phantom's bitcoin signPSBT) and a broadcast endpoint";
+const capabilities = ["signMessage"];
+function bitcoinClient(adapter) {
+  if (!adapter.address) throw new Error("bitcoinClient: connect a Bitcoin wallet first");
+  return {
+    family: "bitcoin",
+    address: adapter.address,
+    chainId: "bitcoin",
+    capabilities,
+    signMessage: message => adapter.signMessage(message),
+    signPsbt: async () => {
+      throw new import_types.UnsupportedClientMethodError("bitcoin", "signPsbt", txTodo);
+    },
+    sendBitcoin: async () => {
+      throw new import_types.UnsupportedClientMethodError("bitcoin", "sendBitcoin", txTodo);
+    }
+  };
+}

package/dist/cjs/clients/bitcoin.native.js

@@ -0,0 +1,51 @@
+"use strict";
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all) __defProp(target, name, {
+    get: all[name],
+    enumerable: true
+  });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+  }
+  return to;
+};
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: true
+}), mod);
+var bitcoin_exports = {};
+__export(bitcoin_exports, {
+  bitcoinClient: () => bitcoinClient
+});
+module.exports = __toCommonJS(bitcoin_exports);
+var import_types = require("./types.native.js");
+var txTodo = "needs PSBT signing through the wallet (Unisat/OKX signPsbt, Phantom's bitcoin signPSBT) and a broadcast endpoint";
+var capabilities = ["signMessage"];
+function bitcoinClient(adapter) {
+  if (!adapter.address) throw new Error("bitcoinClient: connect a Bitcoin wallet first");
+  return {
+    family: "bitcoin",
+    address: adapter.address,
+    chainId: "bitcoin",
+    capabilities,
+    signMessage: function signMessage(message) {
+      return adapter.signMessage(message);
+    },
+    signPsbt: async function signPsbt() {
+      throw new import_types.UnsupportedClientMethodError("bitcoin", "signPsbt", txTodo);
+    },
+    sendBitcoin: async function sendBitcoin() {
+      throw new import_types.UnsupportedClientMethodError("bitcoin", "sendBitcoin", txTodo);
+    }
+  };
+}
+//# sourceMappingURL=bitcoin.native.js.map

package/dist/cjs/clients/bitcoin.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["__toCommonJS","mod","__copyProps","__defProp","value","bitcoin_exports","__export","bitcoinClient","module","exports","import_types","require","txTodo","capabilities","adapter","address","Error","family","chainId","signMessage","message","signPsbt","UnsupportedClientMethodError"],"sources":["../../../src/clients/bitcoin.ts"],"sourcesContent":[null],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,YAAA,GAAAC,GAAA,IAAAC,WAAA,CAAAC,SAAA;EAAAC,KAAA;AAAA,IAAAH,GAAA;AAAA,IAAAI,eAAA;AAAAC,QAAA,CAAAD,eAAA;EAAAE,aAAA,EAAAA,CAAA,KAAAA;AAAA;AACAC,MAAA,CAAAC,OAAA,GAAAT,YAAsF,CAAAK,eAAA;AAItF,IAAAK,YACE,GAAAC,OAAA;AAkBF,IAAAC,MAAM,qHAA0D;AAEzD,IAAAC,YAAS,IACd,aAAa,CACb;AAAO,SACLN,aAAQA,CAAAO,OAAA;EAAA,IACR,CAAAA,OAAS,CAAAC,OAAQ,YAAAC,KAAA;EAAA,OACjB;IACAC,MAAA;IACAF,OAAA,EAAAD,OAAc,CAAAC,OAAA;IACdG,OAAA,WAAU;IACRL,YAAU;IACZM,WAAA,WAAAA,YAAAC,OAAA;MACA,OAAAN,OAAa,CAAAK,WAAY,CAAAC,OAAA;IACvB;IACFC,QAAA,iBAAAA,SAAA;MACF,UAAAX,YAAA,CAAAY,4BAAA,wBAAAV,MAAA;IACF","ignoreList":[]}

package/dist/cjs/clients/connector.cjs

@@ -0,0 +1,45 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all) __defProp(target, name, {
+    get: all[name],
+    enumerable: true
+  });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+  }
+  return to;
+};
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: true
+}), mod);
+var connector_exports = {};
+__export(connector_exports, {
+  clientForConnector: () => clientForConnector
+});
+module.exports = __toCommonJS(connector_exports);
+var import_adapter = require("./adapter.cjs");
+var import_bitcoin = require("./bitcoin.cjs");
+var import_solanaMessage = require("./solanaMessage.cjs");
+var import_sui = require("./sui.cjs");
+function clientForConnector(connector, options = {}) {
+  const adapter = (0, import_adapter.connectorAdapter)(connector);
+  if (!adapter?.address) return null;
+  switch (connector.ecosystem) {
+    case "solana":
+      return (0, import_solanaMessage.solanaMessageClient)(adapter, options.solanaChain);
+    case "sui":
+      return (0, import_sui.suiClient)(adapter);
+    case "bitcoin":
+      return (0, import_bitcoin.bitcoinClient)(adapter);
+    default:
+      return null;
+  }
+}

package/dist/cjs/clients/connector.native.js

@@ -0,0 +1,49 @@
+"use strict";
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all) __defProp(target, name, {
+    get: all[name],
+    enumerable: true
+  });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+  }
+  return to;
+};
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: true
+}), mod);
+var connector_exports = {};
+__export(connector_exports, {
+  clientForConnector: () => clientForConnector
+});
+module.exports = __toCommonJS(connector_exports);
+var import_adapter = require("./adapter.native.js");
+var import_bitcoin = require("./bitcoin.native.js");
+var import_solanaMessage = require("./solanaMessage.native.js");
+var import_sui = require("./sui.native.js");
+function clientForConnector(connector) {
+  var options = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
+  var adapter = (0, import_adapter.connectorAdapter)(connector);
+  if (!(adapter === null || adapter === void 0 ? void 0 : adapter.address)) return null;
+  switch (connector.ecosystem) {
+    case "solana":
+      return (0, import_solanaMessage.solanaMessageClient)(adapter, options.solanaChain);
+    case "sui":
+      return (0, import_sui.suiClient)(adapter);
+    case "bitcoin":
+      return (0, import_bitcoin.bitcoinClient)(adapter);
+    default:
+      return null;
+  }
+}
+//# sourceMappingURL=connector.native.js.map

package/dist/cjs/clients/connector.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["__toCommonJS","mod","__copyProps","__defProp","value","connector_exports","__export","clientForConnector","module","exports","import_adapter","require","import_bitcoin","import_solanaMessage","import_sui","connector","options","arguments","length","adapter","connectorAdapter","address","ecosystem","solanaMessageClient","solanaChain","suiClient","bitcoinClient"],"sources":["../../../src/clients/connector.ts"],"sourcesContent":[null],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,YAAA,GAAAC,GAAA,IAAAC,WAAA,CAAAC,SAAA;EAAAC,KAAA;AAAA,IAAAH,GAAA;AAAA,IAAAI,iBAAA;AAAAC,QAAA,CAAAD,iBAAA;EAAAE,kBAAA,EAAAA,CAAA,KAAAA;AAAA;AACAC,MAAA,CAAAC,OAAA,GAAAT,YAAiC,CAAAK,iBAAA;AACjC,IAAAK,cAAA,GAAkDC,OAAA;AAClD,IAAAC,cAAA,GAAAD,OAAgF;AAChF,IAAAE,oBAA0C,GAAAF,OAAA;AAenC,IAAAG,UAAS,GAAAH,OAAA,kBACd;AAGA,SAAMJ,kBAAUA,CAAAQ,SAAA;EAChB,IAAIC,OAAC,GAASC,SAAS,CAAAC,MAAO,QAAAD,SAAA,iBAAAA,SAAA;EAC9B,IAAAE,OAAS,OAAoCT,cAAW,CAAAU,gBAAA,EAAAL,SAAA;EAAA,IACtD,EAAAI,OAAK,aAAAA,OAAA,uBAAAA,OAAA,CAAAE,OAAA;EACH,QAAAN,SAAO,CAAAO,SAAA;IACT,KAAK;MACH,WAAOT,oBAAA,CAAAU,mBAAiB,EAAAJ,OAAA,EAAAH,OAAA,CAAAQ,WAAA;IAC1B,KAAK;MACH,WAAOV,UAAA,CAAAW,SAAA,EAAAN,OAAA,CAAc;IACvB;MACE,OAAO,IAAAP,cAAA,CAAAc,aAAA,EAAAP,OAAA;IACX;MACF","ignoreList":[]}

package/dist/cjs/clients/evm.cjs

@@ -0,0 +1,171 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all) __defProp(target, name, {
+    get: all[name],
+    enumerable: true
+  });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+  }
+  return to;
+};
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: true
+}), mod);
+var evm_exports = {};
+__export(evm_exports, {
+  evmClient: () => evmClient
+});
+module.exports = __toCommonJS(evm_exports);
+var import_viem = require("viem");
+const erc20WriteAbi = [{
+  type: "function",
+  name: "transfer",
+  stateMutability: "nonpayable",
+  inputs: [{
+    name: "to",
+    type: "address"
+  }, {
+    name: "amount",
+    type: "uint256"
+  }],
+  outputs: []
+}, {
+  type: "function",
+  name: "approve",
+  stateMutability: "nonpayable",
+  inputs: [{
+    name: "spender",
+    type: "address"
+  }, {
+    name: "amount",
+    type: "uint256"
+  }],
+  outputs: []
+}];
+const capabilities = ["signMessage", "sendTransaction", "writeContract"];
+function evmClient(config) {
+  const walletClient = "walletClient" in config ? config.walletClient : (0, import_viem.createWalletClient)({
+    account: config.account,
+    chain: config.chain,
+    transport: (0, import_viem.custom)(config.provider)
+  });
+  const chain = walletClient.chain;
+  if (!chain) throw new Error("evmClient: the wallet client has no chain");
+  const publicClient = config.publicClient ?? (0, import_viem.createPublicClient)({
+    chain,
+    transport: (0, import_viem.http)(config.rpcUrl)
+  });
+  const account = walletClient.account;
+  const writeContract = parameters => walletClient.writeContract({
+    account,
+    chain,
+    ...parameters
+  });
+  const simulateAndWrite = async parameters => {
+    const {
+      request
+    } = await publicClient.simulateContract({
+      account,
+      address: parameters.address,
+      abi: erc20WriteAbi,
+      functionName: parameters.functionName,
+      args: parameters.args
+    });
+    return walletClient.writeContract({
+      ...request,
+      account,
+      chain
+    });
+  };
+  const approveAndWait = async (token, spender, amount) => {
+    const hash = await erc20.approve({
+      token,
+      spender,
+      amount
+    });
+    const receipt = await publicClient.waitForTransactionReceipt({
+      hash
+    });
+    if (receipt.status !== "success") throw new Error(`approve ${hash} reverted`);
+    return hash;
+  };
+  const erc20 = {
+    balanceOf: (token, owner = account.address) => publicClient.readContract({
+      address: token,
+      abi: import_viem.erc20Abi,
+      functionName: "balanceOf",
+      args: [owner]
+    }),
+    allowance: (token, spender, owner = account.address) => publicClient.readContract({
+      address: token,
+      abi: import_viem.erc20Abi,
+      functionName: "allowance",
+      args: [owner, spender]
+    }),
+    decimals: token => publicClient.readContract({
+      address: token,
+      abi: import_viem.erc20Abi,
+      functionName: "decimals"
+    }),
+    transfer: ({
+      token,
+      to,
+      amount
+    }) => simulateAndWrite({
+      address: token,
+      functionName: "transfer",
+      args: [to, amount]
+    }),
+    approve: ({
+      token,
+      spender,
+      amount
+    }) => simulateAndWrite({
+      address: token,
+      functionName: "approve",
+      args: [spender, amount]
+    }),
+    async ensureAllowance({
+      token,
+      spender,
+      amount
+    }) {
+      const current = await erc20.allowance(token, spender);
+      if (current >= amount) return null;
+      if (current > 0n) await approveAndWait(token, spender, 0n);
+      return approveAndWait(token, spender, amount);
+    }
+  };
+  return {
+    family: "evm",
+    address: account.address,
+    chainId: chain.id,
+    chain,
+    capabilities,
+    walletClient,
+    publicClient,
+    signMessage: message => walletClient.signMessage({
+      account,
+      message
+    }),
+    sendTransaction: parameters => walletClient.sendTransaction({
+      account,
+      chain,
+      ...parameters
+    }),
+    writeContract,
+    waitForTransactionReceipt: hash => publicClient.waitForTransactionReceipt({
+      hash
+    }),
+    erc20
+  };
+}