@valve-tech/wallet-adapter 0.11.2 → 0.13.0

package/CHANGELOG.md

@@ -6,6 +6,36 @@ this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [0.13.0] — 2026-05-12
+
+### Notes
+
+- Synchronized release — no changes to this package. Republished at
+  0.13.0 alongside the rest of the toolkit; the substantive change
+  is in `@valve-tech/tx-tracker` (new `TrackOptions.probeMined`
+  consumer-supplied mined-detection probe). See
+  `@valve-tech/tx-tracker`'s CHANGELOG for details.
+
+## [0.12.0] — 2026-05-11
+
+### Added
+
+- Three more `examples/` covering wallet-plumbing classes the
+  original five didn't reach (now 8 total):
+
+  | Example | Covers | Helper |
+  |---|---|---|
+  | `06-ethers-adapter.ts` | ethers v6 `Signer` (`BrowserProvider.getSigner()` or `Wallet`). For dapps still on ethers or mid-migration to viem. | `walletAdapterFromEthersSigner(...)` |
+  | `07-privy-embedded.ts` | Privy embedded wallets via `@privy-io/react-auth`'s `useWallets()`. Handles CAIP-2 chain encoding (`eip155:<id>`) and lazy provider fetching across wallet swaps. | `walletAdapterFromPrivyWallet(...)` |
+  | `08-safe-multisig.ts` | Safe (Gnosis Safe) multisig via `@safe-global/protocol-kit` + `@safe-global/api-kit`. **Returns a safeTxHash, not an on-chain tx hash** — UIs have to fork to await the executed hash separately. File header documents the consumer-visible implications. | `walletAdapterFromSafe(...)` |
+
+  Each follows the existing example shape (inline SDK type-stubs +
+  no-network sanity check) so the files typecheck and run without
+  any wallet libraries installed.
+
+- README "Bridging a real wallet to `WalletAdapter`" table extended
+  from 5 to 8 rows.
+
 ## [0.11.2] — 2026-05-11
 
 ### Notes

package/README.md

@@ -218,6 +218,9 @@ thing:
 | [`03-server-relayer.ts`](./examples/03-server-relayer.ts) | Backend code: relayer signing from a private key (env var / KMS). No provider, no chain-switching, hard-fail on cross-chain. Right for sponsored-tx services, indexer write paths, integration tests. | `walletAdapterFromRelayer(...)` |
 | [`04-erc4337-smart-account.ts`](./examples/04-erc4337-smart-account.ts) | ERC-4337 smart accounts via permissionless.js or similar. `adapter.address` is the smart-account address (not the EOA signer). | `walletAdapterFromSmartAccount(...)` |
 | [`05-hardware-wallet-direct.ts`](./examples/05-hardware-wallet-direct.ts) | Hardware wallets attached **directly** via USB/HID (no wallet app in between) — `@ledgerhq/hw-app-eth` for Ledger; the same shape works for Trezor via `@trezor/connect`. For backend code, kiosk apps, dev tooling. | `walletAdapterFromLedger(...)` |
+| [`06-ethers-adapter.ts`](./examples/06-ethers-adapter.ts) | Dapps still on ethers v6 (or in mid-migration), bridging an `ethers.Signer` (`BrowserProvider.getSigner()` or `Wallet`) without re-wiring to viem. | `walletAdapterFromEthersSigner(...)` |
+| [`07-privy-embedded.ts`](./examples/07-privy-embedded.ts) | Privy embedded wallets via `@privy-io/react-auth`'s `useWallets()`. Handles CAIP-2 chain encoding and lazy provider fetching across wallet swaps. | `walletAdapterFromPrivyWallet(...)` |
+| [`08-safe-multisig.ts`](./examples/08-safe-multisig.ts) | Safe (Gnosis Safe) multisig via `@safe-global/protocol-kit` + `@safe-global/api-kit`. **Returns a safeTxHash, not an on-chain tx hash** — UIs need to fork to await the executed hash separately. | `walletAdapterFromSafe(...)` |
 
 Each example includes a no-network sanity check at the bottom so you
 can run it (`yarn tsx examples/0X-...ts`) without installing any of

package/dist/anvil-accounts.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Anvil's deterministic 10-account list — re-exported here as plain
+ * data so browser-mode test files can import it without pulling in
+ * the Node-only `createAnvilFixture` (which uses `node:child_process`
+ * and crashes the browser bundler).
+ *
+ * These are well-known throwaway keys baked into anvil's default
+ * mnemonic. Every account has 10_000 ETH on a fresh anvil instance.
+ * NEVER use these on any real chain.
+ */
+export declare const ANVIL_ACCOUNTS: {
+    readonly relayer: {
+        readonly address: "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266";
+        readonly privateKey: "0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80";
+    };
+    readonly recipient: {
+        readonly address: "0x70997970C51812dc3A010C7d01b50e0d17dc79C8";
+        readonly privateKey: "0x59c6995e998f97a5a0044966f0945389dc9e86dae88c7a8412f4603b6b78690d";
+    };
+    readonly cosigner: {
+        readonly address: "0x3C44CdDdB6a900fa2b585dd299e03d12FA4293BC";
+        readonly privateKey: "0x5de4111afa1a4b94908f83103eb1f1706367c2e68ca870fc3fb9a804cdab365a";
+    };
+};
+//# sourceMappingURL=anvil-accounts.d.ts.map

package/dist/anvil-accounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anvil-accounts.d.ts","sourceRoot":"","sources":["../src/anvil-accounts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;CAgBjB,CAAA"}

package/dist/anvil-accounts.js

@@ -0,0 +1,25 @@
+/**
+ * Anvil's deterministic 10-account list — re-exported here as plain
+ * data so browser-mode test files can import it without pulling in
+ * the Node-only `createAnvilFixture` (which uses `node:child_process`
+ * and crashes the browser bundler).
+ *
+ * These are well-known throwaway keys baked into anvil's default
+ * mnemonic. Every account has 10_000 ETH on a fresh anvil instance.
+ * NEVER use these on any real chain.
+ */
+export const ANVIL_ACCOUNTS = {
+    relayer: {
+        address: '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266',
+        privateKey: '0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80',
+    },
+    recipient: {
+        address: '0x70997970C51812dc3A010C7d01b50e0d17dc79C8',
+        privateKey: '0x59c6995e998f97a5a0044966f0945389dc9e86dae88c7a8412f4603b6b78690d',
+    },
+    cosigner: {
+        address: '0x3C44CdDdB6a900fa2b585dd299e03d12FA4293BC',
+        privateKey: '0x5de4111afa1a4b94908f83103eb1f1706367c2e68ca870fc3fb9a804cdab365a',
+    },
+};
+//# sourceMappingURL=anvil-accounts.js.map

package/dist/anvil-accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anvil-accounts.js","sourceRoot":"","sources":["../src/anvil-accounts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE;QACP,OAAO,EAAE,4CAAqD;QAC9D,UAAU,EACR,oEAA6E;KAChF;IACD,SAAS,EAAE;QACT,OAAO,EAAE,4CAAqD;QAC9D,UAAU,EACR,oEAA6E;KAChF;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,4CAAqD;QAC9D,UAAU,EACR,oEAA6E;KAChF;CACO,CAAA"}

package/dist/anvil-fixture.d.ts

@@ -0,0 +1,16 @@
+export { ANVIL_ACCOUNTS } from './anvil-accounts.js';
+export interface AnvilFixture {
+    url: string;
+    start: () => Promise<void>;
+    stop: () => Promise<void>;
+}
+/**
+ * Build an anvil fixture bound to a port. Tests should call
+ * `start()` in beforeAll and `stop()` in afterAll.
+ *
+ * Polls `eth_chainId` until anvil responds (anvil prints a banner
+ * but parsing stdout is racy across versions). Default poll window
+ * is 10 seconds — anvil typically starts in under 500ms locally.
+ */
+export declare const createAnvilFixture: (port?: number) => AnvilFixture;
+//# sourceMappingURL=anvil-fixture.d.ts.map

package/dist/anvil-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anvil-fixture.d.ts","sourceRoot":"","sources":["../src/anvil-fixture.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEpD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAAI,aAAW,KAAG,YAuDhD,CAAA"}

package/dist/anvil-fixture.js

@@ -0,0 +1,92 @@
+/**
+ * Shared anvil fixture for the wallet-adapter integration tests.
+ *
+ * Spawns a local anvil instance via child_process, polls its RPC
+ * until ready, exposes its URL and deterministic test-account list,
+ * and tears down on test exit. The fixture is Node-only — anvil is
+ * a native binary launched from outside the test process.
+ *
+ * Anvil's deterministic 10-account setup is what we lean on: every
+ * account has 10_000 ETH and a known private key. We use the first
+ * three slots:
+ * - account 0: relayer / signer
+ * - account 1: recipient
+ * - account 2: spare (Safe co-signer, etc.)
+ *
+ * Each test file pins its own port to avoid races when multiple
+ * integration files run in parallel (the integration config uses
+ * `singleFork: true` to serialize anyway, but per-file ports are
+ * extra defense).
+ */
+import { spawn } from 'node:child_process';
+// Re-export account fixtures so Node-side test files only need one
+// import. Browser-side files should import from `./anvil-accounts.js`
+// directly to avoid pulling in this file's Node-only machinery.
+export { ANVIL_ACCOUNTS } from './anvil-accounts.js';
+/**
+ * Build an anvil fixture bound to a port. Tests should call
+ * `start()` in beforeAll and `stop()` in afterAll.
+ *
+ * Polls `eth_chainId` until anvil responds (anvil prints a banner
+ * but parsing stdout is racy across versions). Default poll window
+ * is 10 seconds — anvil typically starts in under 500ms locally.
+ */
+export const createAnvilFixture = (port = 8645) => {
+    const url = `http://127.0.0.1:${port}`;
+    let proc = null;
+    const waitForReady = async (deadlineMs) => {
+        const start = Date.now();
+        while (Date.now() - start < deadlineMs) {
+            try {
+                const res = await fetch(url, {
+                    method: 'POST',
+                    headers: { 'content-type': 'application/json' },
+                    body: JSON.stringify({
+                        jsonrpc: '2.0',
+                        id: 1,
+                        method: 'eth_chainId',
+                        params: [],
+                    }),
+                });
+                if (res.ok) {
+                    const json = (await res.json());
+                    if (typeof json.result === 'string')
+                        return;
+                }
+            }
+            catch {
+                // anvil not listening yet — keep polling.
+            }
+            await new Promise((r) => setTimeout(r, 100));
+        }
+        throw new Error(`anvil did not respond on ${url} within ${deadlineMs}ms`);
+    };
+    return {
+        url,
+        start: async () => {
+            if (proc !== null)
+                return;
+            proc = spawn('anvil', ['--port', String(port), '--silent'], {
+                stdio: 'ignore',
+            });
+            proc.on('error', (err) => {
+                console.error(`anvil spawn failed: ${err.message}`);
+            });
+            await waitForReady(10000);
+        },
+        stop: async () => {
+            if (proc === null)
+                return;
+            const exited = new Promise((resolve) => {
+                proc?.once('exit', () => resolve());
+            });
+            proc.kill('SIGTERM');
+            await Promise.race([
+                exited,
+                new Promise((r) => setTimeout(r, 2000)),
+            ]);
+            proc = null;
+        },
+    };
+};
+//# sourceMappingURL=anvil-fixture.js.map

package/dist/anvil-fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anvil-fixture.js","sourceRoot":"","sources":["../src/anvil-fixture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAA;AAE7D,mEAAmE;AACnE,sEAAsE;AACtE,gEAAgE;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAQpD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAI,GAAG,IAAI,EAAgB,EAAE;IAC9D,MAAM,GAAG,GAAG,oBAAoB,IAAI,EAAE,CAAA;IACtC,IAAI,IAAI,GAAwB,IAAI,CAAA;IAEpC,MAAM,YAAY,GAAG,KAAK,EAAE,UAAkB,EAAiB,EAAE;QAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACxB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,UAAU,EAAE,CAAC;YACvC,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;oBAC3B,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;oBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,OAAO,EAAE,KAAK;wBACd,EAAE,EAAE,CAAC;wBACL,MAAM,EAAE,aAAa;wBACrB,MAAM,EAAE,EAAE;qBACX,CAAC;iBACH,CAAC,CAAA;gBACF,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;oBACX,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAwB,CAAA;oBACtD,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;wBAAE,OAAM;gBAC7C,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,0CAA0C;YAC5C,CAAC;YACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;QAC9C,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,WAAW,UAAU,IAAI,CAAC,CAAA;IAC3E,CAAC,CAAA;IAED,OAAO;QACL,GAAG;QACH,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,IAAI,IAAI,KAAK,IAAI;gBAAE,OAAM;YACzB,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,EAAE;gBAC1D,KAAK,EAAE,QAAQ;aAChB,CAAC,CAAA;YACF,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACvB,OAAO,CAAC,KAAK,CAAC,uBAAuB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAA;YACrD,CAAC,CAAC,CAAA;YACF,MAAM,YAAY,CAAC,KAAM,CAAC,CAAA;QAC5B,CAAC;QACD,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,IAAI,IAAI,KAAK,IAAI;gBAAE,OAAM;YACzB,MAAM,MAAM,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAC3C,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;YACrC,CAAC,CAAC,CAAA;YACF,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YACpB,MAAM,OAAO,CAAC,IAAI,CAAC;gBACjB,MAAM;gBACN,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAK,CAAC,CAAC;aACzC,CAAC,CAAA;YACF,IAAI,GAAG,IAAI,CAAA;QACb,CAAC;KACF,CAAA;AACH,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valve-tech/wallet-adapter",
-  "version": "0.11.2",
+  "version": "0.13.0",
   "description": "Framework-agnostic vocabulary + runtime helpers for EVM dapp wallet integration. WalletAdapter interface (sign + send), WriteHookParams full lifecycle with rich TxContext payloads (chainId + original request) on every event so consumers don't side-channel; six named hooks (onAwaitingSignature, onTransactionHash, onConfirmed, onFailed, onDropped, onReplaced) plus complementary onPhase(event) discriminated-union shape derived from the WritePhaseSteps phase-map; sendTransactionWithHooks + awaitReceiptWithHooks helpers that fire the hooks at real boundaries (with awaitReceiptWithHooks fetching the containing block once on behalf of all downstream consumers); typed WalletRejectedError + ContractRevertedError for instanceof-discriminated catch; plus TX_STATUS / TX_FLOW / TrackedTx for tx-state UI. Lets SDKs and dapps share one contract instead of each redefining it. Part of the valve-tech/evm-toolkit synchronized release line.",
   "license": "MIT",
   "homepage": "https://github.com/valve-tech/evm-toolkit/tree/main/packages/wallet-adapter#readme",
@@ -45,11 +45,13 @@
     "typecheck:examples": "tsc -p examples",
     "lint": "eslint src",
     "test": "vitest run",
+    "test:browser": "vitest run --config vitest.browser.config.ts",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
     "test:coverage": "vitest run --coverage",
     "prepare": "yarn build"
   },
   "dependencies": {
-    "@valve-tech/viem-errors": "^0.11.2"
+    "@valve-tech/viem-errors": "^0.13.0"
   },
   "peerDependencies": {
     "viem": "^2.0.0"