aboutsummaryrefslogtreecommitdiffstats
path: root/docs/guides/federation/building-on-the-api.md
diff options
context:
space:
mode:
authorslopulus <slop@lassul.us>2026-11-17 20:01:42 +0100
committertv <tv@krebsco.de>2026-11-17 21:09:40 +0100
commit2b9bb568603ee10d4f1f3106a687a8642c162df7 (patch)
treea25c18d9c10862cab917ada82769f6544fbbe6da /docs/guides/federation/building-on-the-api.md
parent45cdc3c64bedb6eefe4a3645afbde82e62f8112a (diff)
guides: keys in an ssh-agentecdsa
A party's key is `ssh-ed25519` or `ecdsa-sha2-nistp256`; the client signs with a private key file or through an ssh-agent holding the key, given its public key. Code of its own signing with ECDSA makes `s` low, which `ssh-keygen` does only half the time.
Diffstat (limited to 'docs/guides/federation/building-on-the-api.md')
-rw-r--r--docs/guides/federation/building-on-the-api.md8
1 files changed, 5 insertions, 3 deletions
diff --git a/docs/guides/federation/building-on-the-api.md b/docs/guides/federation/building-on-the-api.md
index 9f144be..4f37b91 100644
--- a/docs/guides/federation/building-on-the-api.md
+++ b/docs/guides/federation/building-on-the-api.md
@@ -41,11 +41,13 @@ sorts them:
* `deps`: the heads it read (`heads` in `GET /events`), each as 64 lower-case hex digits,
ascending, one at least.
-* `key`: the key it signs with, `ssh-ed25519`, a space, the base64 of its blob, no
- comment; one of the party's keys.
+* `key`: the key it signs with, its type (`ssh-ed25519` or `ecdsa-sha2-nistp256`), a
+ space, the base64 of its blob, no comment; one of the party's keys.
* `sig`: an SSH signature (`ssh-keygen -Y sign`, namespace `continuum-federation`, hashed
with `sha512`) over the JCS bytes of the object without `sig`: the SSHSIG blob, its
- reserved field empty, in base64, unarmored.
+ reserved field empty, in base64, unarmored. Of an ECDSA key, its `s` low, at most half
+ the curve's order: `ssh-keygen` makes a high one half the time, which no node takes;
+ sign again, or put the order less `s` in its place.
* The value is any JSON with integers only, from −2⁵³ to 2⁵³; the event up to 256 KiB.
Put its bytes as they are: