sirdeggen · Oct 15, 2026 · Sep 21, 2026 · Oct 9, 2026 · Oct 9, 2026 · Oct 9, 2026
@@ -3,7 +3,7 @@ id: pkg-wallet-toolbox-client
 title: '@bsv/wallet-toolbox-client'
 kind: package
 domain: wallet
-version: '2.14.9'
+version: '2.14.10'
 last_updated: '2026-10-13'
 last_verified: '2026-10-13'
 review_cadence_days: 30

@@ -3,7 +3,7 @@ id: pkg-wallet-toolbox-mobile
 title: '@bsv/wallet-toolbox-mobile'
 kind: package
 domain: wallet
-version: '2.14.9'
+version: '2.14.10'
 last_updated: '2026-10-13'
 last_verified: '2026-10-13'
 review_cadence_days: 30

@@ -4,7 +4,7 @@ title: '@bsv/wallet-toolbox'
 kind: package
 domain: wallet
 npm: '@bsv/wallet-toolbox'
-version: '2.14.9'
+version: '2.14.10'
 last_updated: '2026-10-13'
 last_verified: '2026-10-13'
 review_cadence_days: 30

@@ -67,9 +67,9 @@ authorized release action.
 | wallet | `@bsv/btms-permission-module` | `1.2.2` | node-library | node-esm | node | `>=22` | [packages/wallet/btms-permission-module](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/wallet/btms-permission-module) |
 | wallet | `@bsv/ecpm-permission-module` | `0.1.2` | browser-library | browser-bundler, browser-esm, node-esm | browser, node | `>=22` | [packages/wallet/ecpm-permission-module](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/wallet/ecpm-permission-module) |
 | wallet | `@bsv/wallet-relay` | `0.5.2` | cli-library | browser-bundler, browser-esm, cli, node-cjs, node-esm | browser, node | `>=22` | [packages/wallet/ts-wallet-relay](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/wallet/ts-wallet-relay) |
-| wallet | `@bsv/wallet-toolbox` | `2.14.9` | node-library | node-cjs | node | `>=22` | [packages/wallet/wallet-toolbox](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/wallet/wallet-toolbox) |
-| wallet | `@bsv/wallet-toolbox-client` | `2.14.9` | browser-library | browser-bundler, browser-esm, node-cjs, node-esm | browser, node | `>=22` | [packages/wallet/wallet-toolbox/client](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/wallet/wallet-toolbox/client) |
-| wallet | `@bsv/wallet-toolbox-mobile` | `2.14.9` | react-native-library | react-native-metro | react-native | `>=22` | [packages/wallet/wallet-toolbox/mobile](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/wallet/wallet-toolbox/mobile) |
+| wallet | `@bsv/wallet-toolbox` | `2.14.10` | node-library | node-cjs | node | `>=22` | [packages/wallet/wallet-toolbox](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/wallet/wallet-toolbox) |
+| wallet | `@bsv/wallet-toolbox-client` | `2.14.10` | browser-library | browser-bundler, browser-esm, node-cjs, node-esm | browser, node | `>=22` | [packages/wallet/wallet-toolbox/client](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/wallet/wallet-toolbox/client) |
+| wallet | `@bsv/wallet-toolbox-mobile` | `2.14.10` | react-native-library | react-native-metro | react-native | `>=22` | [packages/wallet/wallet-toolbox/mobile](https://github.com/bsv-blockchain/ts-stack/tree/main/packages/wallet/wallet-toolbox/mobile) |
 
 ## Standalone infrastructure manifests
 

@@ -327,8 +327,8 @@
     "@bsv/btms-permission-module": "1.2.2",
     "@bsv/ecpm-permission-module": "0.1.2",
     "@bsv/wallet-relay": "0.5.2",
-    "@bsv/wallet-toolbox-client": "2.14.9",
-    "@bsv/wallet-toolbox-mobile": "2.14.9",
-    "@bsv/wallet-toolbox": "2.14.9"
+    "@bsv/wallet-toolbox-client": "2.14.10",
+    "@bsv/wallet-toolbox-mobile": "2.14.10",
+    "@bsv/wallet-toolbox": "2.14.10"
   }
 }
@@ -0,0 +1,81 @@
+# Wallet manual inventory review — 2026-10-09
+
+Owner: `ts-stack-maintainers`
+
+Review by: 2026-10-16
+
+Source: `f77d672263a2d5218c787fe64c085a75aa08af78` (current `main`; the reviewed
+manual-suite bytes are unchanged in this branch except as recorded below).
+
+This is a static inventory and disposition review of all 30 wallet
+`*.man.test.ts` and `*.live.test.ts` suites. The tracked/discovered set matches
+the exact case-insensitive inventory with no missing or duplicate paths. Every
+retained suite still has an explicit assertion oracle; the existing extraction
+destinations and retain-as-test decisions remain. No suite, assertion, skip,
+runtime input, required gate, or execution classification rule is removed.
+
+No manual, public-network, remote-state, or funded suite was executed for this
+review. This record does not establish runtime success, provider readiness,
+restored funds, complete #544 qualification, or permission to run those
+operations. Existing skipped manual cases remain unexecuted. The next review is
+bounded to seven days.
+
+## What changed since 2026-10-01
+
+Of the 30 source hashes recorded in
+[wallet-manual-review-2026-10-01.md](./wallet-manual-review-2026-10-01.md), 29
+still match. The remaining suite,
+`test/Wallet/action/internalizeAction.a.man.test.ts`, was already reviewed on
+2026-10-05: it now conditionally copies a PostgreSQL wallet in addition to MySQL
+and SQLite. Its real basket-insertion assertions and storage destruction remain,
+and its `funded-state` disposition is retained. Current SHA-256:
+`9dffe9d4d652993d53abd1c704b668df6648075a3c5e681a11ab81fb22c08e26`.
+
+The four funded-state description corrections from 2026-10-01 remain. No further
+side-effect or purpose edits are required.
+
+## Exact reviewed source inventory
+
+Paths are relative to `packages/wallet/wallet-toolbox/`. SHA-256 binds the
+reviewed bytes without copying credentials, transaction fixtures, or replay
+payloads.
+
+| Suite                                                                                   | Side effects       | SHA-256                                                            |
+| --------------------------------------------------------------------------------------- | ------------------ | ------------------------------------------------------------------ |
+| `src/services/__tests/ARC.man.test.ts`                                                  | `funded-state`     | `651ae1bf5c018cf136a421465df458ff078492e5ffa05fa4a6468bfecc9d60ba` |
+| `src/services/__tests/ARC.timeout.man.test.ts`                                          | `public-network`   | `6bb23b55eef1b44a3ec5cecc6e98271c9cd71d61d373a8ad2987a4c9001fc4f9` |
+| `src/services/__tests/ArcGorillaPool.man.test.ts`                                       | `funded-state`     | `389fb06ebc0d0e2988599903087f1a9b2ad678f37c6e0506a09861a105412a49` |
+| `src/services/__tests/Arcade.man.test.ts`                                               | `public-network`   | `53dabf49dc9b52f168ba9c75b79417d73a260f7ea67d8832d4d673fa8a88db0d` |
+| `src/services/__tests/ArcadeMainnet.man.test.ts`                                        | `funded-state`     | `2353db932b9141dbb5a14b9a1f52ab70fcddaef1684b7ad00983d2f3fc1ccea8` |
+| `src/services/__tests/ArcadeProof.man.test.ts`                                          | `public-network`   | `5060ad7c87b210b04b8607317d4c2020f40351753c989490608dbed5495f33ad` |
+| `src/services/__tests/StorageE2E.man.test.ts`                                           | `funded-state`     | `f91208b3847e89af15eb015892b38caccc07c8a71c72536c6fb143c80a8c7a4c` |
+| `src/services/__tests/postBeef.man.test.ts`                                             | `funded-state`     | `cb31d8c772003d0c456812b6a9a00ce842d3c99cdc7bfb61782b0a789dccf22e` |
+| `src/services/chaintracker/chaintracks/Ingest/__tests/WhatsOnChainServices.man.test.ts` | `public-network`   | `5bf9f5a89c9dd211cb5b7067cfe9cbdb21ce01171c36520f174836547cb30251` |
+| `src/services/chaintracker/chaintracks/__tests/Chaintracks.man.test.ts`                 | `public-network`   | `edd7ea29579208caedaaa485455e6c2950dd2b535c8f670769a656d90a0a7ed9` |
+| `src/services/chaintracker/chaintracks/util/__tests/ChaintracksFetch.man.test.ts`       | `public-network`   | `2678082fc38c5b50d18a610665d42d2701a1fdd71210df56416db732042ba985` |
+| `src/services/providers/__tests/WhatsOnChain.man.test.ts`                               | `public-network`   | `0ee5133324f2efb3ab8daeaf71b58b50fb50d90850e92432f7f9156c828913f6` |
+| `src/storage/__test/adminStats.man.test.ts`                                             | `read-only-remote` | `d3ad0c5a9848c6b149afa0c1622c8f669781e09a30d43e46803dec152f736eaa` |
+| `src/storage/remoting/__test/StorageClient.man.test.ts`                                 | `funded-state`     | `8a62b93ed38dc695cf823e43790e3f2f485338bf1b6e8dd5db4d8f6778916824` |
+| `src/wab-client/__tests/WABClient.man.test.ts`                                          | `funded-state`     | `147e0ff852c83e44279266f96f26031279ea89e1545c3cf74fc6518130099476` |
+| `test/Wallet/StorageClient/storageClient.man.test.ts`                                   | `remote-state`     | `b636029a0a70b4bf88e15a89dc45d95a378e1d7c2b7dc58ded77a742da2659a2` |
+| `test/wallet/action/createActionToGenerateBeefs.man.test.ts`                            | `funded-state`     | `8f5629079a37335fedd03303bc001d9d52e1ac6bca9b05ff16c0a449b0e775d3` |
+| `test/Wallet/action/internalizeAction.a.man.test.ts`                                    | `funded-state`     | `9dffe9d4d652993d53abd1c704b668df6648075a3c5e681a11ab81fb22c08e26` |
+| `test/Wallet/certificate/acquireCertificate.man.test.ts`                                | `remote-state`     | `ec07917964ec8d0c3b706f7b3ebe637d6d7874e41f70a94082dbbd4b8dc9a698` |
+| `test/Wallet/live/walletLive.man.test.ts`                                               | `funded-state`     | `16b13b9683460cd6eef44b1362778b5a91c155f6046e52bb6d8cd7f01f67eb1b` |
+| `test/Wallet/local/localWallet.man.test.ts`                                             | `funded-state`     | `c4562e5319edb63933d6dd3c86e9300eac6dd6f0e8f224c24e7f10cc4acc9090` |
+| `test/Wallet/local/localWallet2.man.test.ts`                                            | `funded-state`     | `a8dccb910a93c4f010655877f2b4d765cf9de663263fbdc9a7ecdd96af08ae83` |
+| `test/Wallet/signAction/mountaintop.man.test.ts`                                        | `funded-state`     | `caff05a77fce77ede7567e3e3949ffae7a2fab3ee74466cd048db1adfe4e13f4` |
+| `test/Wallet/specOps/specOps.man.test.ts`                                               | `remote-state`     | `fb132ce9e7e92904f67e33ff760e54dc1498846eff4923ccf083e65d87d7911a` |
+| `test/WalletClient/LocalKVStore.man.test.ts`                                            | `funded-state`     | `ab65d322ae9a2e32c6367116da38d3240f4f45ec9864299c5a471aaaeb44013b` |
+| `test/WalletClient/WERR.man.test.ts`                                                    | `remote-state`     | `d64e2164e87d0cdb1339dac516cf8d9c703b784e12e4364d0c69ec6e781512a4` |
+| `test/WalletClient/staging.auth.man.test.ts`                                            | `remote-state`     | `b86a0891ed7a6bd1fe3ce9805370bd5afea32f25a123530f3bd78d1ebc58cd2b` |
+| `test/examples/backup.man.test.ts`                                                      | `local-artifact`   | `273fdc5044979c1f0e56d311c9198b832ccafb7757c8e63d73055b7e84dc8583` |
+| `test/services/Services.man.test.ts`                                                    | `public-network`   | `5b01e9d638d4116ef7a5267d888a760a28592381dd814f5d0e1fb865edd78cbb` |
+| `src/services/chaintracker/chaintracks/__tests/GoChaintracksServiceClient.live.test.ts` | `public-network`   | `bf4b4582d8e8496e056aa8eaaf82ea9687f835341c1ca500ccd0e843cd5e1b49` |
+
+Review totals: 14 funded-state, 1 local-artifact, 9 public-network, 1
+read-only-remote, 5 remote-state.
+
+Real-date `node scripts/test-governance.mjs` now reports the same 30 exact
+wallet dispositions. This renewal does not authorize public-network, funded, or
+manual execution, merge, package publication, or deployment.
@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
-  "lastReviewed": "2026-10-01",
+  "lastReviewed": "2026-10-09",
   "owner": "ts-stack-maintainers",
-  "reviewBy": "2026-10-08",
+  "reviewBy": "2026-10-16",
   "suites": [
     {
       "path": "packages/wallet/wallet-toolbox/src/services/__tests/ARC.man.test.ts",

@@ -1,7 +1,7 @@
 # Wallet Toolbox manual-suite disposition
 
 Extraction reviewed: 2026-08-30
-Inventory reviewed: [2026-10-01](./wallet-manual-review-2026-10-01.md)
+Inventory reviewed: [2026-10-09](./wallet-manual-review-2026-10-09.md)
 Owner: `ts-stack-maintainers`
 
 This ledger records the manual-suite review that separates executable tests

@@ -4,6 +4,16 @@ This document captures the history of significant changes to the wallet-toolbox
 The git commit history contains the details but is unable to draw
 attention to changes that materially alter behavior or extend functionality.
 
+## wallet-toolbox 2.14.10
+
+- Live `syncToWriter` / `syncFromReader` compare reader and writer
+  `TableSettings.chain` before any chunk moves and throw `WERR_NETWORK_CHAIN`
+  on mismatch. The class remains a public sdk export with its deserializer and
+  JSON round-trip. Portable BRC-38 import still throws a generic `Error`.
+  Custom `processSyncChunk` writers may set `ProcessSyncChunkResult.error`;
+  both live-sync loops throw that error and stop. First-party providers still
+  throw. No API or schema migration is required.
+
 ## wallet-toolbox 2.14.9
 
 - Complete per-transaction broadcast results when the refreshed request is

@@ -1,6 +1,6 @@
 {
   "name": "@bsv/wallet-toolbox-client",
-  "version": "2.14.9",
+  "version": "2.14.10",
   "type": "module",
   "sideEffects": false,
   "engines": {

@@ -7080,6 +7080,18 @@ nextCheckpoint?: SyncCheckpoint
 ```
 See also: [SyncCheckpoint](./client.md#interface-synccheckpoint)
 
+###### Property error
+
+Optional non-throwing failure from a custom writer. First-party
+`StorageProvider` implementations throw instead of setting this field.
+`WalletStorageManager.syncToWriter` and `syncFromReader` throw `error`
+immediately and do not request another chunk.
+
+```ts
+error?: WalletError
+```
+See also: [WalletError](./client.md#class-walleterror)
+
 Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
 
 ---
@@ -19459,6 +19471,10 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 
 Configured network chain is invalid or does not match across services.
 
+Live `WalletStorageManager.syncToWriter` and `syncFromReader` throw this
+before any sync chunk moves when the reader and writer `TableSettings.chain`
+values differ.
+
 ```ts
 export class WERR_NETWORK_CHAIN extends WalletError {
     constructor(message?: string)

@@ -4975,6 +4975,18 @@ nextCheckpoint?: SyncCheckpoint
 ```
 See also: [SyncCheckpoint](./client.md#interface-synccheckpoint)
 
+###### Property error
+
+Optional non-throwing failure from a custom writer. First-party
+`StorageProvider` implementations throw instead of setting this field.
+`WalletStorageManager.syncToWriter` and `syncFromReader` throw `error`
+immediately and do not request another chunk.
+
+```ts
+error?: WalletError
+```
+See also: [WalletError](./client.md#class-walleterror)
+
 Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
 
 ---
@@ -12804,6 +12816,10 @@ Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](
 
 Configured network chain is invalid or does not match across services.
 
+Live `WalletStorageManager.syncToWriter` and `syncFromReader` throw this
+before any sync chunk moves when the reader and writer `TableSettings.chain`
+values differ.
+
 ```ts
 export class WERR_NETWORK_CHAIN extends WalletError {
     constructor(message?: string)

@@ -1,6 +1,6 @@
 {
   "name": "@bsv/wallet-toolbox-mobile",
-  "version": "2.14.9",
+  "version": "2.14.10",
   "type": "module",
   "sideEffects": false,
   "engines": {

@@ -1,6 +1,6 @@
 {
   "name": "@bsv/wallet-toolbox",
-  "version": "2.14.9",
+  "version": "2.14.10",
   "sideEffects": false,
   "type": "commonjs",
   "engines": {

@@ -170,6 +170,10 @@ export class WERR_BAD_REQUEST extends WalletError {
 
 /**
  * Configured network chain is invalid or does not match across services.
+ *
+ * Live `WalletStorageManager.syncToWriter` and `syncFromReader` throw this
+ * before any sync chunk moves when the reader and writer `TableSettings.chain`
+ * values differ.
  */
 export class WERR_NETWORK_CHAIN extends WalletError {
   constructor(message?: string) {

@@ -168,6 +168,11 @@ export interface WalletStorageSync extends WalletStorageWriter {
   setActive: (auth: AuthId, newActiveStorageIdentityKey: string) => Promise<number>
 
   getSyncChunk: (args: RequestSyncChunkArgs) => Promise<SyncChunk>
+  /**
+   * Apply one sync page. First-party providers throw on failure.
+   * A custom writer may instead set `ProcessSyncChunkResult.error`;
+   * `WalletStorageManager` live-sync loops throw that error and stop.
+   */
   processSyncChunk: (args: RequestSyncChunkArgs, chunk: SyncChunk) => Promise<ProcessSyncChunkResult>
 }
 
@@ -715,6 +720,12 @@ export interface ProcessSyncChunkResult {
   maxUpdated_at: Date | undefined
   updates: number
   inserts: number
+  /**
+   * Optional non-throwing failure from a custom writer. First-party
+   * `StorageProvider` implementations throw instead of setting this field.
+   * `WalletStorageManager.syncToWriter` and `syncFromReader` throw `error`
+   * immediately and do not request another chunk.
+   */
   error?: WalletError
 }
 

@@ -286,11 +286,13 @@ describe('WalletError tests', () => {
 
   test('6 - WERR_NETWORK_CHAIN test', async () => {
     const werr = new WERR_NETWORK_CHAIN('Chain mismatch')
+    expect(werr).toBeInstanceOf(WERR_NETWORK_CHAIN)
     expect(werr.name).toBe('WERR_NETWORK_CHAIN')
     expect(werr.message).toBe('Chain mismatch')
 
     const json = WalletError.unknownToJson(werr)
     const werr2 = WalletErrorFromJson(JSON.parse(json))
+    expect(werr2).toBeInstanceOf(WERR_NETWORK_CHAIN)
     expect(werr2.name).toBe('WERR_NETWORK_CHAIN')
     expect(werr2.message).toBe('Chain mismatch')
   })

@@ -9,6 +9,7 @@ import {
   validateRelinquishOutputArgs
 } from '@bsv/sdk/wallet/validationHelpers'
 import { SyncPageBudget } from './sync/SyncPageBudget'
+import { assertLiveSyncChainsMatch, throwIfProcessSyncChunkError } from './sync/liveSyncGuards'
 import { validateSyncCheckpoint } from './sync/syncCheckpoint'
 import {
   AbortActionArgs,
@@ -894,6 +895,7 @@ export class WalletStorageManager implements sdk.WalletStorage {
     log = await this.runAsSync(async sync => {
       const writer = sync
       const writerSettings = this.getSettings()
+      assertLiveSyncChainsMatch(readerSettings, writerSettings)
 
       log += `syncFromReader from ${readerSettings.storageName} to ${writerSettings.storageName}\n`
 
@@ -915,6 +917,7 @@ export class WalletStorageManager implements sdk.WalletStorage {
           chunk.user.activeStorage = ((this._active as ManagedStorage).user as TableUser).activeStorage
         }
         const r = await writer.processSyncChunk(pageArgs, chunk)
+        throwIfProcessSyncChunkError(r)
         budget.committed(chunk, Date.now() - startedAt)
         inserts += r.inserts
         updates += r.updates
@@ -949,6 +952,7 @@ export class WalletStorageManager implements sdk.WalletStorage {
     log = await this.runAsSync(async sync => {
       const reader = sync
       const readerSettings = reader.getSettings()
+      assertLiveSyncChainsMatch(readerSettings, writerSettings)
 
       log += progLog(`syncToWriter from ${readerSettings.storageName} to ${writerSettings.storageName}\n`)
 
@@ -967,6 +971,7 @@ export class WalletStorageManager implements sdk.WalletStorage {
         const chunk = await reader.getSyncChunk(pageArgs)
         log += EntitySyncState.syncChunkSummary(chunk)
         const r = await writer.processSyncChunk(pageArgs, chunk)
+        throwIfProcessSyncChunkError(r)
         budget.committed(chunk, Date.now() - startedAt)
         inserts += r.inserts
         updates += r.updates