Merge pull request #11360 from saubyk/scripts/keys-removal-policy
What changed, and why it matters
This commit only adds documentation explaining when and why old release signing keys are removed from the project. It does not change any code, verification logic, or cryptographic handling. There is no security vulnerability in the commit itself.
No security action required. Review as normal documentation update.
Security signals we found
No strong security signals were identified.
Evidence from the diff
The diff adds a ‘Removing keys’ section to scripts/keys/README.md. It states that keys are removed upon expiration or when the owner stops signing releases, notes that this can reduce recognized signatures on older releases below MIN_REQUIRED_SIGNATURES, and advises users to verify older releases using the script bundled with that release (e.g., from its Docker image). No executable code or configuration is modified.
Changed components
scripts/keys/README.mdInspect captured patch +15 / −0
### scripts/keys/README.md
@@ -13,3 +13,18 @@ details on how to create the signature.
In addition to adding the key file here as a `.asc` file the
`scripts/verify-install.sh` file must also be updated with the key ID and the
reference to the key file.
+
+## Removing keys
+
+A key is removed from this directory and from `scripts/verify-install.sh` when
+it expires or when its owner stops signing releases. Removing a key can drop
+the number of recognized signatures on an older release below
+`MIN_REQUIRED_SIGNATURES`. The current script is only expected to verify
+releases within the supported release lines (see
+[SECURITY.md](../../SECURITY.md)), where users are expected to run the latest
+patch release. To verify an older release, use the script that shipped with
+that release, for example from its Docker image:
+
+```shell
+$ docker run --rm --entrypoint="" lightninglabs/lnd:v0.20.1-beta /verify-install.sh v0.20.1-beta
+```Why this scored 20/100
Community notes
Notes can correct, qualify, or add evidence to the AI analysis. Every note shown here has been validated by a human moderator.
The AI analysis stands alone for now. Submit a note if you can add evidence or important context.