Skip to content

Coordinate concurrent wallet receipts and complete broadcast results #1066

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ty-everett merged 4 commits into from
Oct 13, 2026
Merged

Coordinate concurrent wallet receipts and complete broadcast results #1066

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
2e93b25
fix(wallet-toolbox): complete results for advanced broadcast requests
BraydenLangley Oct 13, 2026
cbbbf4a
fix(wallet-toolbox): coordinate SQL payment receipts across instances
BraydenLangley Oct 13, 2026
f9fee50
fix(wallet-toolbox): preserve legacy rows with durable receipt keys
BraydenLangley Oct 13, 2026
0263a65
test(wallet-toolbox): cover receipt proof and claim fencing edges
BraydenLangley Oct 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 16 additions & 3 deletions docs/packages/wallet/wallet-toolbox-client.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,9 @@ id: pkg-wallet-toolbox-client
title: '@bsv/wallet-toolbox-client'
kind: package
domain: wallet
version: '2.14.8'
last_updated: '2026-10-12'
last_verified: '2026-10-12'
version: '2.14.9'
last_updated: '2026-10-13'
last_verified: '2026-10-13'
review_cadence_days: 30
npm: 'https://www.npmjs.com/package/@bsv/wallet-toolbox-client'
repo: 'https://github.com/bsv-blockchain/ts-stack/tree/main/packages/wallet/wallet-toolbox/client'
Expand Down Expand Up @@ -94,6 +94,19 @@ asynchronous header lookup. A missing or malformed header, or an invalid
proof, still rejects and leaves no proven transaction, transaction, or
requested output. Upgrade this client; no API, wire or schema migration is required.

Broadcast result completion in the 2.14.9 source candidate preserves an already
`unmined` or `completed` request while returning the actual provider outcome.
A successful first receipt without a mining proof therefore no longer fails
with an internal unknown-status error on shared storage or after concurrent
storage-worker progress. Negative provider outcomes still reject that receipt;
repeat successful receipt remains idempotent. Upgrade the implementation
performing broadcast/internalization after protected publication. No public
API or wire migration is required. Remote SQL storage adds a durable user/TXID
receipt claim while preserving historical rows; back up and preflight before
coordinating all serving storage instances in the
rollout. Browser IndexedDB does not use the SQL claim. This candidate does not
deploy hosted storage or repair older partial receipts automatically.

## Backup and recovery

Recover both key material and wallet records; a manager snapshot or device
Expand Down
19 changes: 16 additions & 3 deletions docs/packages/wallet/wallet-toolbox-mobile.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,9 @@ id: pkg-wallet-toolbox-mobile
title: '@bsv/wallet-toolbox-mobile'
kind: package
domain: wallet
version: '2.14.8'
last_updated: '2026-10-12'
last_verified: '2026-10-12'
version: '2.14.9'
last_updated: '2026-10-13'
last_verified: '2026-10-13'
review_cadence_days: 30
npm: 'https://www.npmjs.com/package/@bsv/wallet-toolbox-mobile'
repo: 'https://github.com/bsv-blockchain/ts-stack/tree/main/packages/wallet/wallet-toolbox/mobile'
Expand Down Expand Up @@ -89,6 +89,19 @@ A missing or malformed header, or an invalid proof, still rejects and leaves
no partial proven transaction, transaction, or output. Upgrade the active
storage implementation; no API, wire or schema migration is required.

Broadcast result completion in the 2.14.9 source candidate preserves an already
`unmined` or `completed` request while returning the actual provider outcome.
A successful first receipt without a mining proof therefore no longer fails
with an internal unknown-status error on shared storage or after concurrent
storage-worker progress. Negative provider outcomes still reject that receipt;
repeat successful receipt remains idempotent. Upgrade the implementation
performing broadcast/internalization after protected publication. No public
API or wire migration is required. Remote SQL storage adds a durable user/TXID
receipt claim while preserving historical rows; back up and preflight before
coordinating all serving storage instances in the
rollout. This candidate does not deploy hosted storage or repair older partial
receipts automatically.

## Backup and recovery

Recover both key material and wallet records; a manager snapshot or device
Expand Down
20 changes: 17 additions & 3 deletions docs/packages/wallet/wallet-toolbox.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@ title: '@bsv/wallet-toolbox'
kind: package
domain: wallet
npm: '@bsv/wallet-toolbox'
version: '2.14.8'
last_updated: '2026-10-12'
last_verified: '2026-10-12'
version: '2.14.9'
last_updated: '2026-10-13'
last_verified: '2026-10-13'
review_cadence_days: 30
status: stable
tags: ['wallet', 'brc100']
Expand Down Expand Up @@ -43,6 +43,20 @@ finishes. A missing or malformed header, or an invalid proof, still rejects
and leaves none of those records. Upgrade the active storage implementation,
including the browser client.

Broadcast result completion in the 2.14.9 source candidate preserves an already
`unmined` or `completed` request while returning the actual provider outcome.
A successful first receipt without a mining proof therefore no longer fails
with an internal unknown-status error on shared storage or after concurrent
storage-worker progress. Negative provider outcomes still reject that receipt;
repeat successful receipt remains idempotent. Upgrade the implementation
performing broadcast/internalization after protected publication. No public
API or wire migration is required. SQL storage adds a durable user/TXID receipt
claim table while preserving historical transaction and output rows. Back up
and preflight the database, then coordinate the rollout across every serving storage instance;
older instances do not honor the claim. Local IndexedDB does not use the SQL
claim. This candidate does not deploy hosted storage or repair older partial
receipts automatically.

## Optional registry descriptions

ProtoMap, BasketMap and CertMap supply descriptive metadata, not permission grants.
Expand Down
18 changes: 9 additions & 9 deletions docs/reference/package-api-migrations.md
View file
Open in desktop

Large diffs are not rendered by default.

6 changes: 3 additions & 3 deletions docs/reference/stack-facts.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.8` | 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.8` | 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.8` | 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.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) |

## Standalone infrastructure manifests

Expand Down
Loading
Loading