Release v3.0.2: Atomic data sync, API resilience, progress indicators & fiat currency fix by boldbitcoin · Pull Request #62 · BoldBitcoinWallet/BoldWallet

boldbitcoin · 2026-03-13T08:02:57Z

Summary

Merges all v3.0.1 work to main — full SQLite DB-first architecture with atomic sync operations, centralized API queue, rate-limit resilience, and multiple UX improvements.

Core Infrastructure

SQLite persistence layer — WAL-mode SQLite as single source of truth; repository pattern for all wallet data (balances, UTXOs, transactions, prices, sync cursors)
Central API Queue (ApiQueue) — serializes all logical API operations (balance, price, UTXOs, transactions); drives CacheIndicator status text and progress
Atomic sync operations — BalanceSyncer, UtxoSyncer, TransactionSyncer collect all data in memory; only write to DB when every address succeeds; typed error classes (BalanceSyncError, UtxoSyncError, TxSyncError)
429 rate-limit retry — automatic retry with backoff, Retry-After header parsing, inter-address throttling (300ms); shared rateLimitRetry module

UX Improvements

Progress indicators — CacheIndicator and RestoringIndexesModal show current/total (e.g. "Fetching balance… 3/5")
Descriptive failure toasts — specific messages per sync type ("Could not fetch balance", "Could not fetch UTXOs", etc.) with cached data fallback
Balance DB-first floor — prevents transient 0-balance display after device unlock
Pre-skeleton DB balance seed — balance visible before loading skeleton appears
UtxosScreen redesign — dedicated glassmorphism header, derivation path right-aligned, refresh via UtxoSyncer with 429 retry
LoadingScreen version:build — app version displayed at bottom center
Mempool Playground — new GET Historical Price endpoint

Bug Fixes

Fiat currency reset on cold start — EUR/GBP etc no longer overwritten to USD on restart
TransactionSyncer atomicity — break on !res.ok changed to throw to prevent partial DB writes
MobilesPairing modal close — navigates back to previous screen
Duplicate fetch race — focus guard checks both reinit and fetch-in-progress refs

Test plan - e2e ok

Cold start with EUR selected → verify EUR rate persists after restart
Pull-to-refresh on WalletHome → verify CacheIndicator shows operation labels and progress
Trigger 429 rate limit → verify retry with backoff and eventual success or descriptive toast
Restore wallet → verify RestoringIndexesModal shows progress (e.g. "Syncing balances… 3/5")
UtxosScreen → verify summary card styling, derivation path alignment, dark/light mode
LoadingScreen → verify version:build visible at bottom
MobilesPairing → sign tx, close modal → verify navigation back

…t/details) Made-with: Cursor

Made-with: Cursor

… doc)

Both MpcSendBTCWithUTXOs and NostrMpcSendBTCWithUTXOs were calling FetchUTXODetails (GET /tx/{txid}) twice per input inside the signing loop. A single API failure mid-session aborted the entire MPC round. Changes: - UTXOWithPath and utxoWithPathJSON now carry a scriptpubkey field (hex) - Both signing functions build prevOuts from inline scriptpubkey; FetchUTXODetails is called only as a fallback when scriptpubkey is empty (backward-compatible: old callers without scriptpubkey continue to work) - WalletService.enrichUtxosWithScriptpubkey() fetches /tx/{txid} per unique txid in TypeScript before MPC starts, with per-tx caching to avoid duplicate fetches for multi-input transactions - MobilesPairing and MobileNostrPairing call enrichUtxosWithScriptpubkey and include scriptpubkey in the JSON passed to the native bridge - NostrMpcSendBTCWithUTXOs and MpcSendBTCWithUTXOs now return errors on invalid amountSatoshi/estimatedFee strings instead of silently using 0 Made-with: Cursor

… UTXO summary card - Add MempoolClient: in-memory cache + in-flight dedup + per-endpoint TTL (30 s default, 5 min tx, 60 s fees/price) + universal 10 s timeout - Switch getWalletBalanceAggregate to /api/address/:address (chain_stats + mempool_stats); ~50x smaller responses; expose pendingSats in WalletBalance - WalletHome: shimmer replaces ActivityIndicator; displayFiat via useMemo (fixes 0 BTC / non-zero fiat mismatch); amber pending chip for unconfirmed sats - UtxosScreen: static balance summary card (Total / Confirmed / Pending with UTXO counts) pinned above scrollable list - Fix receive-flow address mismatch: getCurrentReceivePathInfo atomically returns {path, index, address}; eliminates QR flicker at index boundary - TransactionList: migrate axios → mempoolClient; remove manual timeout race - TransactionDetailsModal: tighten flow-item accent bar style - Update CHANGELOG.md with all v3.0.0 additions Made-with: Cursor

Made-with: Cursor

…ansport - pump.go: fix TOCTOU race in processEvent — move the processed-map check to AFTER assembly under a single lock acquisition; parallel initial-query goroutines can no longer double-dispatch the TSS handler for single-chunk messages (root cause of the reported signing failure with multiple relays) - pump.go: replace fixed 1s retryTicker with exponential backoff (0→500ms→1s) for subscription failures and channel-close reconnects; reduces blind-spot window for messages arriving during relay reconnection - session.go: parallelize AwaitPeers initial relay query using sync.WaitGroup; a slow/offline relay no longer blocks the others from being scanned within the timeout budget (previously sequential) - session.go: continue publishing ready/complete wraps to all peers even when one peer's publish fails; report first error only after all peers attempted - session.go: replace fixed 1s retryTicker with exponential backoff for AwaitPeers subscription setup and channel-close resubscription; eliminates duplicated nested retry loop - config.go: increase ConnectTimeout default from 20s to 45s to give more room for mobile networks during peer rendezvous Made-with: Cursor

Remove trailing newlines flagged by `gofmt -s -l .` in CI. Made-with: Cursor

… balance consistency fixes Made-with: Cursor

- Central ApiQueue serializing balance/price/UTXO/tx operations with progress reporting (current/total) to CacheIndicator and RestoringIndexesModal - Atomic sync: BalanceSyncer, UtxoSyncer, TransactionSyncer collect all data in memory and only write to DB when every address succeeds - 429 rate-limit retry with backoff, Retry-After header support, and inter-address throttling (rateLimitRetry module) - Descriptive failure toasts per sync type - Fix: fiat currency (EUR etc) overwritten to USD on every cold start - Fix: MobilesPairing modal close navigates back - UtxosScreen dedicated header style, derivation path right-aligned - LoadingScreen version:build display - Mempool Playground: GET Historical Price endpoint - Updated CHANGELOG.md for v3.0.1 Made-with: Cursor

…HANGELOG Made-with: Cursor

- TransactionSyncer: always fetch from /txs first (forward pass) to find newly confirmed transactions, then backfill from stored cursor. Fixes devices missing transactions confirmed after initial sync. - WalletService: overlay DB is_confirmed/block_height/block_time onto parsed rawJson so the UI reflects confirmed status even when rawJson is stale. Fixes "Consolidating" shown for already-confirmed txs. - SyncCoordinator: periodic HD index re-discovery (24h staleness) to converge address ranges across multi-device wallets. Notifies UI via onAddressesChanged when new addresses are found. - Bump build number to 53 (Android versionCode + iOS build). Made-with: Cursor

boldbitcoin · 2026-03-14T07:52:05Z

Superseded by v3.0.3 release PR.

bbtc and others added 30 commits March 3, 2026 11:03

checkpoint

be8e04f

checkpoint

e308ca0

checkpoint

3d3e61f

checkpoint

c18a02e

checkpoint

1d49c2d

checkpoint

adb04d6

checkpoint

556a77d

checkpoint

68a6617

checkpoint

2f84da1

checkpoint

27e094b

checkpoint

e20ff2d

changelog: add v3.0.0 (multi-path HD, UTXO spend, FIPS Docker, tx lis…

973f7c3

…t/details) Made-with: Cursor

chore: update .gitignore for unlinked/local files (.cursor, mcps)

5c7ba96

Made-with: Cursor

checkpoint

d238544

checkpoint

ac92ab5

ci(bbmtlib): use Go 1.25 to match go.mod, fix go mod tidy check

5443ed2

style(bbmtlib): gofmt mpc_nostr.go (blank line before NostrMpcSendBTC…

287740a

… doc)

checkpoint

ff93926

optimization-refactor

6c9bf5e

script-checks

48475ce

fix(fips-android): use #!/bin/bash so sudo doesn't fall back to /bin/sh

b87c92b

Made-with: Cursor

build-aar-fips

62538cf

script-checks

7934eb6

go-mod-checks

03d6f95

lib-update

a19ebe6

build-aar-fips

b8940eb

index-restoration-checks

dff0554

bbtc and others added 16 commits March 8, 2026 13:09

tx-on-demand-broadcast

ca7ad13

qr-shortcut-multipath

84172e4

v3.0.0-completion

272140f

build-aar-fips

2c7a031

fix: gofmt formatting in cancel.go and nostr_cancel.go

b45b6d3

Remove trailing newlines flagged by `gofmt -s -l .` in CI. Made-with: Cursor

db-switch-checkpoint

6ac6815

checkpoint-db-switch

6c6f118

checkpoint-db-switch

5c64e38

checkpoint-cleanups

77935f0

checkpoint-cleanups

d56f30e

hd-indexer-optimizations

84f89c6

changelog: add v3.0.1 — SQLite DB-first architecture, atomic reindex,…

473fe96

… balance consistency fixes Made-with: Cursor

wallet-home-cleanup

71d9dd3

checkpoint-cleanups

23ab819

bump version to 3.0.2 (build 52) across package.json, Android, iOS, C…

eb55fea

…HANGELOG Made-with: Cursor

boldbitcoin changed the title ~~Release v3.0.1: SQLite DB-first, atomic sync, API queue, 429 retry, UX improvements~~ Release v3.0.2: SQLite DB-first, atomic sync, API queue, 429 retry, UX improvements Mar 13, 2026

boldbitcoin changed the title ~~Release v3.0.2: SQLite DB-first, atomic sync, API queue, 429 retry, UX improvements~~ Release v3.0.2: Atomic data sync, API rate-limit resilience, progress indicators & fiat currency fix Mar 13, 2026

boldbitcoin changed the title ~~Release v3.0.2: Atomic data sync, API rate-limit resilience, progress indicators & fiat currency fix~~ Release v3.0.2: Atomic data sync, API resilience, progress indicators & fiat currency fix Mar 13, 2026

boldbitcoin requested review from HalFinneyIsMyHomeBoy, RaProceed and kar1timmins and removed request for RaProceed March 13, 2026 08:28

boldbitcoin assigned HalFinneyIsMyHomeBoy, kar1timmins and boldbitcoin Mar 13, 2026

boldbitcoin closed this Mar 14, 2026

boldbitcoin deleted the v3.0.2 branch March 14, 2026 07:58

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Release v3.0.2: Atomic data sync, API resilience, progress indicators & fiat currency fix#62

Release v3.0.2: Atomic data sync, API resilience, progress indicators & fiat currency fix#62
boldbitcoin wants to merge 53 commits intomainfrom
v3.0.2

boldbitcoin commented Mar 13, 2026 •

edited

Loading

Uh oh!

boldbitcoin commented Mar 14, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

boldbitcoin commented Mar 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Core Infrastructure

UX Improvements

Bug Fixes

Test plan - e2e ok

Uh oh!

boldbitcoin commented Mar 14, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

boldbitcoin commented Mar 13, 2026 •

edited

Loading