@valve-tech/wallet-adapter 0.11.2 → 0.12.0

package/CHANGELOG.md

@@ -6,6 +6,26 @@ 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.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valve-tech/wallet-adapter",
-  "version": "0.11.2",
+  "version": "0.12.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",
@@ -49,7 +49,7 @@
     "prepare": "yarn build"
   },
   "dependencies": {
-    "@valve-tech/viem-errors": "^0.11.2"
+    "@valve-tech/viem-errors": "^0.12.0"
   },
   "peerDependencies": {
     "viem": "^2.0.0"