Skip to content

Conversation

@Edu92337
Copy link
Contributor

@Edu92337 Edu92337 commented Jan 8, 2026

Description and Notes

This PR adds a minimal SECURITY.md file following the style of Bitcoin Core, LND, and rust-lightning.

Closes #763

The document provides essential security information:

  • Vulnerability Reporting: Email contact (security@getfloresta.org) with PGP key fingerprint for encrypted communication
  • PGP Key Import: Command to import Davidson Souza's PGP key for secure disclosure

This follows the minimal security policy style used by major Bitcoin projects (bitcoin/bitcoin, lightningnetwork/lnd, lightningdevkit/rust-lightning), keeping only essential information without unnecessary details.

How to verify the changes you have done?

  1. Check formatting: View the rendered markdown on GitHub
   # Or locally with a markdown viewer
   grip SECURITY.md
  1. Verify the PGP key link: https://blog.dlsouza.lol/assets/gpg.asc

  2. Test GPG import command:

   gpg --recv-keys "2C8E 0F83 6FD7 DBBB B9E9 B2EF 8996 4EC3 AB22 B2E3"

Contributor Checklist

  • I've followed the contribution guidelines
  • I've verified one of the following:
    • Confirmed CI passed on my fork (documentation-only change)
  • I've linked any related issue(s) in the sections above (Missing SECURITY.md #763)
  • All commits are GPG-signed

Copy link
Collaborator

@moisesPompilio moisesPompilio left a comment

Choose a reason for hiding this comment

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

This SECURITY.md is too long and has too much unnecessary information. I think we need something like what bitcoin core does, here are some links to base it on: https://github.com/bitcoin/bitcoin?tab=security-ov-file#readme https://github.com/lightningdevkit/rust-lightning?tab=security-ov-fil https://github.com/lightningnetwork/lnd?tab=security-ov-file

@moisesPompilio moisesPompilio added the documentation Improvements or additions to documentation label Jan 8, 2026
@moisesPompilio
Copy link
Collaborator

Please squash the commits.

@qlrd
Copy link
Collaborator

qlrd commented Jan 9, 2026

IMO, the security information in Contributing section at README.md should be removed too.

@moisesPompilio
Copy link
Collaborator

IMO, the security information in Contributing section at README.md should be removed too.

I don't think we need to remove this information. Instead, we could change it to reference SECURITY.md. This would make it easier for users reading the README.md to know where to find the SECURITY.md file.

@luisschwab
Copy link
Member

This SECURITY.md is too long and has too much unnecessary information.

Yes, KISS.

Copy link
Member

@luisschwab luisschwab left a comment

Choose a reason for hiding this comment

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

Davidson-Souza
Davidson-Souza previously approved these changes Jan 10, 2026
Copy link
Member

@Davidson-Souza Davidson-Souza left a comment

Choose a reason for hiding this comment

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

ACK 767a932

@Davidson-Souza
Copy link
Member

Since the document was simplified, please update your PR description with the new approach

Copy link
Member

@JoseSK999 JoseSK999 left a comment

Choose a reason for hiding this comment

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

ACK 767a932

@JoseSK999
Copy link
Member

We would need to update the security mail at README.md/Community, CONTRIBUTING.md/Security and install.sh

@Davidson-Souza
Copy link
Member

We would need to update the security mail at README.md/Community, CONTRIBUTING.md/Security and install.sh

README.md/Community was changed by #764. But CONTRIBUTING needs to be changed as well. Should do that in another PR

luisschwab

This comment was marked as outdated.

@moisesPompilio
Copy link
Collaborator

The SECURITY. md text is good, however you just need to make a change to the project's README.md because it talks about how to report a vulnerability in the community section. The current part needs to redirect to this file here, to indicate that if someone finds a vulnerability they should read the SECURITY.md to know how to report it, so the email and public key part of the person to report to stays in one place.

@Davidson-Souza
Copy link
Member

@moisesPompilio

The SECURITY. md text is good, however you just need to make a change to the project's README.md because it talks about how to report a vulnerability in the community section. The current part needs to redirect to this file here, to indicate that if someone finds a vulnerability they should read the SECURITY.md to know how to report it, so the email and public key part of the person to report to stays in one place.

Agreed. But maybe we leave this as-is and push another PR fixing README and CONTRIBUTING?

@jaoleal
Copy link
Collaborator

jaoleal commented Jan 10, 2026

ACK 767a932

@moisesPompilio
Copy link
Collaborator

Agreed. But maybe we leave this as-is and push another PR fixing README and CONTRIBUTING?

Hmm, I think a fix afterwards would be strange. Better to do it in this PR, because all these changes would be in one commit which would make it easier to identify through the commit history why the lines were changed.

@Edu92337
Copy link
Contributor Author

Updated README.md to redirect to SECURITY.md. Now all vulnerability reporting details (email and PGP key) are in a single place as requested.

@Davidson-Souza
Copy link
Member

@Edu92337 could you also add this to CONTRIBUTING.md?

Add minimal security policy following Bitcoin Core style with:
- Vulnerability reporting contact
- PGP key fingerprint for secure communication

Closes getfloresta#763
Copy link
Member

@Davidson-Souza Davidson-Souza left a comment

Choose a reason for hiding this comment

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

re-ACK b2a661e

Copy link
Member

@luisschwab luisschwab left a comment

Choose a reason for hiding this comment

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

ACK b2a661e

@moisesPompilio
Copy link
Collaborator

ACK b2a661e

1 similar comment
@jaoleal
Copy link
Collaborator

jaoleal commented Jan 10, 2026

ACK b2a661e

@Davidson-Souza Davidson-Souza merged commit f9e0ebd into getfloresta:master Jan 10, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Missing SECURITY.md

7 participants