Skip to content

Commit b682dbc

Browse files
committed
README: add instructions for verifying GPG signatures
1 parent f79f46c commit b682dbc

File tree

1 file changed

+36
-0
lines changed

1 file changed

+36
-0
lines changed

README.md

+36
Original file line numberDiff line numberDiff line change
@@ -61,6 +61,42 @@ Implementation details
6161
* Optional runtime blinding which attempts to frustrate differential power analysis.
6262
* The precomputed tables add and eventually subtract points for which no known scalar (secret key) is known, preventing even an attacker with control over the secret key used to control the data internally.
6363

64+
Obtaining and verifying
65+
-----------------------
66+
67+
The git tag for each release (e.g. `v0.6.0`) is GPG-signed by one of the maintainers.
68+
For a fully verified build of this project, it is recommended to obtain this repository
69+
via git, obtain the GPG keys of the signing maintainer(s), and then verify the release
70+
tag's signature using git.
71+
72+
This can be done with the following steps:
73+
74+
1. Obtain the GPG keys listed in [SECURITY.md](./SECURITY.md).
75+
2. If possible, cross-reference these key IDs with another source controlled by its owner (e.g.
76+
social media, personal website). This is to mitigate the unlikely case that incorrect
77+
content is being presented by this repository.
78+
3. Clone the repository:
79+
```
80+
git clone https://github.com/bitcoin-core/secp256k1
81+
```
82+
4. Check out the latest release tag, e.g.
83+
```
84+
git checkout v0.6.0
85+
```
86+
5. Use git to verify the GPG signature:
87+
```
88+
% git tag -v v0.6.0 | grep -C 3 'Good signature'
89+
90+
gpg: Signature made Mon 04 Nov 2024 12:14:44 PM EST
91+
gpg: using RSA key 4BBB845A6F5A65A69DFAEC234861DBF262123605
92+
gpg: Good signature from "Jonas Nick <[email protected]>" [unknown]
93+
gpg: aka "Jonas Nick <[email protected]>" [unknown]
94+
gpg: WARNING: This key is not certified with a trusted signature!
95+
gpg: There is no indication that the signature belongs to the owner.
96+
Primary key fingerprint: 36C7 1A37 C9D9 88BD E825 08D9 B1A7 0E4F 8DCD 0366
97+
Subkey fingerprint: 4BBB 845A 6F5A 65A6 9DFA EC23 4861 DBF2 6212 3605
98+
```
99+
64100
Building with Autotools
65101
-----------------------
66102

0 commit comments

Comments
 (0)