Extends the previously verify-only ed25519.c with ed25519_keygen() and ed25519_sign() per RFC 8032 5.1.5/5.1.6, reusing every point-arithmetic primitive verify already had -- only seed expansion/clamping and per-message nonce derivation are new. Signing is deterministic; only keygen ever touches entropy, via a caller-supplied seed (virtio_rng, Phase A) -- keygen still generates nothing itself. New scalar_muladd() (scalar25519.c) for signing's S = (k*a + r) mod L, the one scalar op verify never needed. Schoolbook multiply into a u128 wide accumulator with one final carry pass -- deliberately the same shape as fe25519.c's existing multiply, which has a documented history of a real bug from carrying mid-accumulation instead of in one pass. Verified against an independent implementation, not self-consistency: a throwaway host harness against Python's cryptography library (OpenSSL- backed) across 6 trials (5 random seed/message pairs + the empty-message case) produced byte-for-byte identical pubkeys and signatures every time. Clean compile on all three architectures and a full 3-arch QEMU acceptance boot, conservation intact, no panics or guest errors. Nothing calls the new functions from the live kernel path yet -- that's Phase C (the MINT word itself), still open, documented in FABRIC-3.md. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01U14ET9CWAtbQMbYqomKgXd
38 lines
1.7 KiB
C
38 lines
1.7 KiB
C
/* scalar25519.h -- arithmetic mod L (the Ed25519 base point's order),
|
|
* for reducing SHA-512 output to a valid scalar and checking a
|
|
* signature's S component for the RFC 8032 malleability requirement
|
|
* (S < L, not just S < 2^256).
|
|
*
|
|
* Deliberately NOT the intricate hand-tuned "sc_reduce" reduction most
|
|
* reference implementations use (a bespoke Barrett-style reduction with
|
|
* constants specific to L, notoriously easy to transcribe wrong) --
|
|
* this is a plain binary long-division reduction, one bit at a time.
|
|
* O(512) steps per reduction; this is a verify-only, non-hot-path
|
|
* library (one reduction per signature check), so the simpler,
|
|
* more obviously-correct approach is the right tradeoff here.
|
|
*/
|
|
#ifndef SCALAR25519_H
|
|
#define SCALAR25519_H
|
|
|
|
#include <stdint.h>
|
|
|
|
/* 32-byte little-endian scalars, reduced mod L where noted. */
|
|
|
|
/* Reduce a 64-byte little-endian value (e.g. raw SHA-512 output) mod L,
|
|
* producing a 32-byte little-endian result < L. */
|
|
void scalar_reduce512(uint8_t out[32], const uint8_t in[64]);
|
|
|
|
/* 1 if the 32-byte little-endian scalar is < L (a well-formed,
|
|
* non-malleable signature component per RFC 8032), else 0. */
|
|
int scalar_lt_L(const uint8_t s[32]);
|
|
|
|
/* out = (a*b + c) mod L, all 32-byte little-endian scalars (a, b, c need
|
|
* not already be reduced mod L, though every caller in this codebase
|
|
* passes already-reduced inputs). Needed for EdDSA signing's
|
|
* S = (k*a + r) mod L step -- verify never needed scalar multiplication,
|
|
* only reduction, so this didn't exist until signing did. */
|
|
void scalar_muladd(uint8_t out[32], const uint8_t a[32], const uint8_t b[32],
|
|
const uint8_t c[32]);
|
|
|
|
#endif /* SCALAR25519_H */
|