Skip to content

Embedded LND: v0.21.8-beta-zeus - #5729

Merged
kaloudis merged 1 commit into
ZeusLN:masterfrom
kaloudis:chore/lnd-v0.21.8-beta-zeus
Nov 11, 2026
Merged

kaloudis merged 1 commit into
ZeusLN:masterfrom
kaloudis:chore/lnd-v0.21.8-beta-zeus

Conversation

@kaloudis

@kaloudis kaloudis commented Nov 11, 2026 •

Copy link
Copy Markdown
Contributor

Description

Upgrades embedded LND from v0.21.5-beta-zeus (#5474) to v0.21.8-beta-zeus. Zeus skipped v0.21.6 and v0.21.7.

Fork release: https://github.com/ZeusLN/lnd/releases/tag/v0.21.8-beta-zeus

  • The same 25 Zeus commits as v0.21.5-beta-zeus, rebased onto upstream lnd v0.21.8-beta (branch lnd-v0.21.8-beta-zeus). The only rebase conflicts were in go.sum.
  • Upstream v0.21.7 moved the btcwallet pin to 245ce39ba (btcd/Core transaction rejection classification), so the ZeusLN/btcwallet fork was rebased as well: v0.16.19-15-zeus carries the same 7 rescan commits on top of that commit. Its go.sum hash matches sum.golang.org.
  • Upstream changes since v0.21.5 include sweeper retry and budget fixes, on-chain claims for settled AMP HTLCs, htlcswitch replay fixes, rejecting force close on SCB-restored channels, bounded watchtower message decoding, and reestablishing pending channels on reconnect (peer: reestablish pending channels on reconnect lightningnetwork/lnd#11540, with its backport fix in v0.21.8).
  • v0.21.6 disables MPTCP listeners through a godebug line in lnd's go.mod (CVE-2026-98432). gomobile writes its own go.mod and does not carry that default into the mobile libraries. Embedded LND opens no TCP listeners (in-memory gRPC, --nolisten, norest=1), so Zeus is not exposed.
  • Fork checks: go build ./... and the mobile-tag build pass; go test passes for mobile, peer, lnrpc/walletrpc, lnrpc/invoicesrpc, lnwallet/btcwallet, sweep, chainntnfs and kvdb/sqlbase. All four Android ABIs and both iOS slices embed v0.21.8-beta-zeus.

Protos: no change. No .proto files changed upstream between v0.21.5 and v0.21.8.

No new sqldb or channeldb migrations (db_version stays 35), so the graph DB caps in LndMobileTools are unchanged.

Assets downloaded from the release match the SHA-256 values in fetch-libraries-versions.json.

This pull request is categorized as a:

  • New feature
  • Bug fix
  • Code refactor
  • Configuration change
  • Locales update
  • Quality assurance
  • Other

Checklist

  • I’ve run yarn run tsc and made sure my code compiles correctly
  • I’ve run yarn run lint and made sure my code didn’t contain any problematic patterns
  • I’ve run yarn run prettier and made sure my code is formatted correctly
  • I’ve run yarn run test and made sure all of the tests pass

Not run: the PR only changes fetch-libraries-versions.json and a version string in a skill doc.

Testing

If you modified or added testable logic, did you add new unit tests? For bug fixes, please include a test that would have caught the bug.

  • No, I’m a fool
  • Yes
  • N/A

This PR changes a native library version, with no JS logic to unit test.

I have tested this PR on the following platforms (please specify OS version and phone model/VM):

  • Android (API 35 emulator, arm64)
  • iOS (iPhone 17 simulator, iOS 26.5)

Results: #5729 (comment)

I have tested this PR with the following types of nodes (please specify node version and API version where appropriate):

On-device

  • LDK Node
  • Embedded LND (v0.21.8-beta-zeus, mainnet, upgrade from v0.21.5-beta-zeus and fresh wallet)

Remote

  • LND (REST)
  • LND (Lightning Node Connect)
  • Core Lightning (CLNRest)
  • Nostr Wallet Connect
  • LndHub

Locales

  • I’ve added new locale text that requires translations
  • I’m aware that new translations should be made on the ZEUS Transifex page and not directly to this repo

Third Party Dependencies and Packages

  • Contributors will need to run yarn after this PR is merged in
  • 3rd party dependencies have been modified:
    • verify that package.json and yarn.lock have been properly updated
    • verify that dependencies are installed for both iOS and Android platforms

Other

  • Changes were made that require an update to the README
  • Changes were made that require an update to onboarding

@athena-zeusln athena-zeusln Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Athena Review

Pinned commit: 399ae48

anthropic:claude-opus-5-5: completed openai:gpt-6-sol: completed

0 validated findings. This is a nonblocking COMMENT review, not an approval. No findings does not establish correctness.

Limitations:

  • The upstream ZeusLN/lnd v0.21.8-beta-zeus release notes and changelog were not provided. Compatibility of the Lndmobile API and RPC surface with v0.21.5 could not be verified.
  • The new androidSha256 and iosSha256 values could not be checked against the actual release artifacts.
  • No usage of the embedded LND bindings in the Zeus codebase was supplied to check for breaking API changes.
  • The new embedded LND artifacts and upstream release information were not supplied, so their checksums, API compatibility, and runtime behavior could not be verified.

@github-actions

Copy link
Copy Markdown

Test coverage

Metric Coverage Covered/Total vs master
Statements 52.23% 22266/42625 0.00%
Branches 43.65% 14062/32215 0.00%
Functions 39.35% 3711/9430 +0.01%
Lines 52.38% 21172/40419 0.00%
Coverage by folder

Change vs master in parentheses when nonzero.

Folder Files Statements Branches Functions Lines
(root) 3 43.9% 23.75% 41.17% 41.52%
backends 9 62.9% 42.27% 46.17% 65.62%
cashu-cdk 3 1.11% 0% 0% 1.11%
components 116 36.8% 32.51% 29.25% 37.44%
hooks 1 0% 0% 0% 0%
ldknode 2 31.03% 0% 0% 31.3%
lndmobile 12 58.26% 59.77% 39.7% 57.81%
models 32 63.55% 56.38% 55.25% 64.47%
storage 1 77.27% 62.5% 77.77% 78.57%
stores 31 70.34% (+0.01) 63.39% 63.27% (+0.05) 70.55% (+0.01)
utils 109 80.21% (-0.02) 77.55% (-0.02) 72.91% 82.12% (-0.01)
views 238 25.09% 25.24% 16.41% 25.11%

Commit: 399ae48 | Test run | Baseline: master@1f174a0db

@kaloudis

Copy link
Copy Markdown
Contributor Author

Device tested v0.21.8-beta-zeus on Android (API 35 emulator, arm64) and iOS (iPhone 17 simulator, iOS 26.5). Mainnet embedded LND, neutrino, bbolt backend, no funds. On both platforms this upgrades the wallets left from the #5474 test (v0.21.5-beta-zeus).

Builds. Debug builds of this branch. fetch-libraries.sh downloaded both assets from the release and passed the checksum checks. Every Android ABI and both iOS slices embed v0.21.8-beta-zeus.

Upgrade over v0.21.5-beta-zeus (PASS on both). Installed over the existing app without clearing data (adb install -r / simctl install).

  • lnd.log: version=0.21.8-beta commit=v0.21.8-beta-zeus, db_version=35, no migration.
  • Each platform has two wallets from Embedded LND: v0.21.5-beta-zeus #5474. The one shown in the Embedded LND: v0.21.5-beta-zeus #5474 screenshots unlocked with the same pubkey (Android 031d05b3…151653, iOS 035cc8df…b917b2). The second wallet on each also unlocked.
  • Headers caught up 6 to 9 s after the version line on Android and 11 s on iOS.
  • A new invoice and a new on-chain address worked on all four wallets. Node Info shows 0.21.8-beta commit=v0.21.8-beta-zeus, synced to chain.
  • Wallet switches were done by killing and relaunching the app, so each upgraded wallet above was opened from a cold launch. The fresh wallets also reopened after several kills and relaunches during the EGS runs (pubkey checked unchanged on Android).

Fresh wallet (PASS on both). Created from Wallets > Add (Embedded LND, Mainnet, Bolt). Invoice and address worked.

  • Chain backend is fully synced came 1m59s after the version line on Android (0.21.5 on the same AVD: 1m36s, rc1: 1m58s) and 2m02s on iOS. Neutrino is the same version in 0.21.5 and 0.21.8.

Express Graph Sync after a reset.

  • Android: 6.3 s and 7.4 s. iOS: 9.3 s, 9.6 s and 7.7 s.
  • Both platforms load 13656 nodes / 72598 channels (from lnd's Finished populating in-memory channel graph line). That is fewer than Embedded LND: v0.21.5-beta-zeus #5474 recorded (16148 / 86494), and iOS is slower than the 3.2 s recorded there, so I ran the 0.21.5 library against the same wallet the same day:
    • Android: this APK with only libgojni.so swapped back to 0.21.5 (the gomobile Java classes and manifest are byte-identical between the two aars). 6.8 s, 13656 / 72598.
    • iOS: this app relinked against the 0.21.5 xcframework. 8.6 s and 9.3 s, 13656 / 72598.
    • Both lnd versions load the same graph at the same speed, so the differences from Embedded LND: v0.21.5-beta-zeus #5474 come from the current egs.lnze.us snapshot and today's network, not from this bump.

Logs. No [CRT], panic, unlock or rescan exited errors, and no app crash, on either platform. The only migration activity is the gc_decayed_log optional migration on each new wallet's first start.

  • ChannelGraph shutting down errors appear while a wallet stops for another wallet's creation, as on 0.21.5.
  • ConnectPeer: server is still in the process of starting appears at startup, and onion peers fail to dial because Tor is off.
  • Shutting down the running wallet for the new one took 1.1 s on Android and 43 s on iOS. The 43 s was spent waiting for the peer bootstrapper (Attempting to bootstrap with: Authenticated Channel Graph), then shutdown completed in 0.1 s. Embedded LND: v0.21.5-beta-zeus #5474 recorded the same pattern on Android with 0.21.5 (40 s).
  • On Android, a red LogBox ChannelAcceptor stream error, will retry on next fetch appeared during the wallet switch. That comes from LSPStore.initChannelAcceptor handling lnd's server shutting down when the stream closes. The code is from a4fa6d7 and is not related to this bump.
  • On iOS, the header showed the neutrino peer warning: Zeus's ping check timed out for btcd1.lnolymp.us, btcd2.lnolymp.us and uswest.blixtwallet.com from the simulator. lnd synced through other peers.

Upstream v0.21.6 disables MPTCP listeners through a godebug line in lnd's go.mod. The desktop lnd build carries DefaultGODEBUG=multipathtcp=0, but the gomobile libraries do not. Embedded LND opens no TCP listeners (in-memory gRPC, --nolisten, norest=1), so this does not affect Zeus.

Not tested: SQLite backend, payments and channels, Tor, LSP-wrapped invoices.

Android after upgrade iOS after upgrade

@kaloudis
kaloudis merged commit 11ce720 into ZeusLN:master Nov 11, 2026
4 checks passed
@kaloudis
kaloudis deleted the chore/lnd-v0.21.8-beta-zeus branch November 11, 2026 20:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant