Skip to content

Add local signer backup recovery flow#715

Open
ihordiachenko wants to merge 10 commits intomainfrom
feature/state_backup
Open

Add local signer backup recovery flow#715
ihordiachenko wants to merge 10 commits intomainfrom
feature/state_backup

Conversation

@ihordiachenko
Copy link
Copy Markdown
Collaborator

@ihordiachenko ihordiachenko commented May 1, 2026

Adds opt-in local VLS signer backups with CLI inspection/conversion tooling. There are two available backup strategies:

  • new-channels-only: default, low I/O, snapshots when a channel first becomes recoverable.
  • periodic: snapshots new recoverable channels and then refreshes after configured recoverable-channel updates, with more disk writes

Backups can be created through:

 glcli signer run --backup-path, inspected with inspect-backup

Backups can be converted to CLN recoverchannel input with:

glcli signer convert-backup --format cln --path <backup file>

Tradeoffs

  • Backups are best-effort during signer operation: write failures are logged and do not interrupt signing. The backup file is created only after a snapshot trigger, not immediately at startup.
  • Peer addresses are stored from Greenlight’s peerlist alongside VLS state to close the main recovery-data gap.
  • Only v1 channels supported for now

@ihordiachenko ihordiachenko requested a review from cdecker May 1, 2026 12:04
@ihordiachenko ihordiachenko force-pushed the feature/state_backup branch from bf8917e to c557661 Compare May 1, 2026 12:07
@ihordiachenko ihordiachenko marked this pull request as ready for review May 1, 2026 12:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant