zec_wallet_ui 0.0.4

A drop-in shielded Zcash wallet for Flutter apps, built on zec_wallet: onboarding, backup, send, receive, history and swaps, themed by your app, in 16 languages.

Changelog

0.0.4

• Requires zec_wallet 0.0.5, which every app needs before the NU7 network upgrade activates on mainnet, at block 3,543,405 (about 2026-11-06 02:00 UTC). The working set is zec_wallet: ^0.0.5, zec_wallet_ui: ^0.0.4, zec_wallet_ui_platform: ^0.0.3 and zec_wallet_tor: ^0.0.4. The platform and Tor packages did not change in this release, so their own pub.dev pages still show older zec_wallet_ui and zec_wallet lines; use the working set above. zec_wallet's changelog has the full upgrade steps.
• A payment that a network upgrade cancelled reads "Cancelled by upgrade" in the activity list (or "Retrying" while the wallet sends it again), never "Pending" or "Expired". Its details say where it stands, as zec_wallet reports it: not final yet, so it must not be sent again; final, with the amount held until the payment's own expiry; or released, with the amount spendable again. Only a released payment is struck through and shows that the funds were kept.
• In the last 20 blocks (about 25 minutes) before a network upgrade, sending shows "The Zcash network upgrades in about N minutes. Sending is paused until then so your payment can't get stuck." and starts no payment. The shield sheet (under "Shielding is paused"), the move-to-public screen, a parked payment's "Send now", fund recovery, the one-time address reopen and the swap form for a swap out of ZEC show the same message. Automatic shielding waits quietly.
• When a network upgrade cancels a retry, the payment's details say so and tell the user the wallet will send it again by itself.
• Known limit: on a server that does not report its network, the "Sending still works for about N more hours" line can show up to three times the real time after NU7 (zec_wallet's changelog, Limits).
• New strings, in all 16 languages: walletActivityCancelledByUpgrade, walletTxExplainCancelledNotFinal, walletTxExplainCancelledHeld, walletTxExplainCancelledReleased, walletTxExplainRetryingCancelled, walletShieldPausedTitle and the pause message (walletSendFaultUpgradePaused).

0.0.3

• Requires zec_wallet 0.0.4, a security release (see its changelog). 0.0.1 accepted only zec_wallet 0.0.1, so it could not be used beside later releases.
• The UI strings read more plainly in all 16 languages; the meaning is the same. No string key was added or removed. If your app asserts on a wallet string's text, check it against the new wallet_en.arb.
• Four strings that were still in English in every other language are now translated: the three shown when a send's outcome is unknown (walletSendUnknownTitle, walletSendUnknownBody, walletSendUnknownQueuedBody) and walletTxExplainRetryingExpired.
• Version 0.0.2 was prepared with the string changes and never published.

0.0.1

Initial release. The reusable wallet UI for the zec_wallet SDK, embeddable in a host Flutter app with a page of glue (see the README).

• The wallet surfaces: onboarding (create, restore, watch-only), the balance card with "Spendable now" and "Arriving", activity and transaction details, send (payment URIs, memos, QR scan, the offline queue, a large-send confirm, an acknowledgement before a public payment), receive, shielding, swap, recovery-phrase backup, viewing-key export, settings, sync status and the sync-server picker, reached from the sync status or the menu's "Sync server". A custom server in the picker can carry an access key with the header it goes in; the key is shown while typed (Hide hides it) and can be pasted but never copied. The trust notice tells the user that the key identifies them to that server. The host's settings entry reads "Settings". The address scanner needs flutter_zxing 3.1 or later: with 2.3 an iOS profile or release build decoded nothing (hosts need Android compileSdk 36).
• Host seams, all exported from the barrel: walletOnboardingOverrides (with decorateProvisioner), the provisioner, onboarding-store and screen-security interfaces, the spend and reveal authorizers, walletRoutes() and WalletRoutes for a host GoRouter, walletSyncDriveProvider for sync from the moment the wallet opens, walletBalanceHiddenProvider, and the reference policy (buildWalletConfig, resolveWalletDbDir) a host may use verbatim or replace.
• Theming: buildTheme and the WalletColors tokens (light, dark and true-black presets), WalletShapes, WalletTypography and WalletIcons; a host's own theme styles every component. No bundled font.
• A screen never claims a screenshot block the OS did not acknowledge, a stale balance says so, and a send's result states only what the core reported.
• A busy or briefly unreadable wallet store reads "Sync paused on this device. Retrying." in amber, never the restore-from-recovery-phrase copy, which is kept for a corrupt store.
• A transaction that may already be saved is never offered a retry: send, shield, move-to-transparent and the parked "Send now" land on "check before trying again" (or "may already be sending it") when the answer was lost, and show what landed when it did, whatever the host's authorizer throws after running the spend.
• A swap's review shows the full foreign address: the refund address for a swap into ZEC, the payout address for one out of ZEC. Start stays off until the user confirms it. A host's spend prompt for a swap deposit gets the payout address too, shortened, in WalletSpendIntent.payoutAbbrev.
• 16 locales, each carrying every string, through walletLocalizationsFallbackDelegate.
• A test kit (package:zec_wallet_ui/testing.dart, no flutter_test dependency) that pumps every surface with no native library.
• A wallet runs on Android, iOS and macOS. Linux builds, but zec_wallet cannot hold a wallet there yet (no key store adapter). Windows is not yet built or run.