anza-ed25519-verified/verification/Proofs/SigApexSpec.lean
mrwulf 214a4cd3d6 THE SIGNATURE APEX on the anza fork: verify_accepts_iff, button-enforced
FOURTH AND FINAL PYRAMID CAPPED - the signature layer is complete on all
four ed25519 forks. anza's verify code lives in the same crate as the
curve (solana-ed25519), so the whole verify path joins the merged
CurveField extraction directly: one universe, no glue layer, no FQ-name
welding, and the Error enum plus the parse/filter helpers are all real
extracted code.

- extract.sh: verify_sha512 start-from joins the merged stanza;
  sha512_hash3 and the foreign ed25519 crate opaque; RUSTFLAGS
  --cfg curve25519_serial_only pins the serial backend so
  get_selected_backend extracts as the real constant Serial (the stale
  dispatch axiom is deleted from FunsExternal).
- gen/CurveField externals: real defs for the ?-operator plumbing
  (Try::branch, FromResidual) and faithful identity models for
  Choice::unwrap_u8 (transparent-u8 body: self.0) and the RangeFull
  get_unchecked[_mut] raw-pointer pair (Rust body returns the pointer
  unchanged) - the three would-be cone intruders, eliminated.
- Proofs/SigApexSpec.lean: verify_loop_full (standard three-axiom cone)
  and verify_accepts_iff - the verifier accepts IFF the recomputed
  compress([k](-A) + [s]B) equals the signature's R byte-for-byte, with
  the ZIP-215 legacy filters and the s < l parse conditioned by
  hypotheses, mirroring the siblings' hparse.
- check.sh Phase 3b enforces the apex cone to be EXACTLY
  [propext, Classical.choice, Quot.sound, ed25519.Signature,
   ed_sigs.sha512_hash3, ed25519.Signature.r_bytes,
   ed25519.Signature.s_bytes]
  - the tightest boundary of the four pyramids: the SHA-512 oracle plus
  the foreign wire-format type and its two byte accessors, nothing else.

check.sh (incl. Phase 3b) + check-scalar.sh both green.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-04 23:48:08 +02:00

207 lines
9.5 KiB
Text
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/- ──────────────────────────────────────────────────────────────────────────────
Proofs/SigApexSpec.lean — the signature-layer apex, phase 1:
the EdDSA verification equation, SHA-512 opaque.
`VerificationKey.verify_sha512 self sig msg` is the extracted
solana-ed25519 verifier (dalek-style canonical-R path, gen/CurveField —
anza's verify code lives in the SAME crate as the curve, so the whole
path shares one extraction universe): run the legacy filters, parse the
scalar `s`, recompute
R' = compress( [k]·(A) + [s]·B ) (k from the SHA-512 hash)
and accept iff R' equals the signature's R, byte-for-byte.
This file proves the verifier's control flow reduces EXACTLY to that
recompute-and-compare — the literal EdDSA check — over the PROVEN curve
model. SHA-512 stays an opaque oracle: the statement holds for whatever
bytes the hash produces, so the theorem is the honest
"accept ↔ the recomputed compressed point equals R".
The legacy filters (all-zero key, excluded R list) and the s < parse
are fixed by hypotheses, mirroring the sibling pyramids' `hparse`; the
apex boundary is the tightest of the four: the SHA-512 oracle plus the
foreign `ed25519::Signature` type with its two byte accessors — the
`Error` enum and the backend dispatch are real extracted code here.
Phase 2 (the point-level equation, needing `to_bytes` canonicity and
`decompress`) is deliberately deferred and documented — mirroring the
dsm layer's phase split.
────────────────────────────────────────────────────────────────────────────── -/
import Proofs.ScalarDenote
import Proofs.AddSpec
open Aeneas Aeneas.Std Result ControlFlow
open curve25519
set_option maxHeartbeats 4000000
set_option linter.unusedSimpArgs false
set_option maxRecDepth 8000
namespace CurveFieldProofs
open Aeneas.Std.WP
/-- Byte-equality of two 32-byte arrays over the tail `[n, 32)`. -/
def rangeEq (e r : Array Std.U8 32#usize) (n : ) : Prop :=
∀ j, n ≤ j → j < 32 → e.val[j]! = r.val[j]!
instance (e r : Array Std.U8 32#usize) (n : ) : Decidable (rangeEq e r n) := by
have : rangeEq e r n ↔ ∀ j, j < 32 → n ≤ j → e.val[j]! = r.val[j]! := by
unfold rangeEq; exact ⟨fun h j hj hn => h j hn hj, fun h j hn hj => h j hj hn⟩
exact decidable_of_iff _ this.symm
/-- **The comparison loop returns byte-equality.** From accumulator `b` at
index `i ≤ 32`, `verify_sha512_loop` returns `b ∧ (all bytes in [i,32)
agree)`. NOTE the extracted loop's parameter order is `(r, e, b, i)`
while the body compares `e[k] != r[k]`. -/
theorem verify_loop_spec (e r : Array Std.U8 32#usize) :
∀ (n : ) (b : Bool) (i : Usize), i.val = 32 - n → n ≤ 32 →
ed_sigs.verification_key.VerificationKey.verify_sha512_loop r e b i
⦃ res => res = (b && decide (rangeEq e r (32 - n))) ⦄ := by
intro n
induction n with
| zero =>
intro b i hi _
unfold ed_sigs.verification_key.VerificationKey.verify_sha512_loop
apply loop_step
simp only [ed_sigs.verification_key.VerificationKey.verify_sha512_loop.body]
have hge : ¬ (i < 32#usize) := by clear * - hi; scalar_tac
rw [if_neg hge]
try simp only [spec_ok]
have hemp : decide (rangeEq e r (32 - 0)) = true := by
simp only [decide_eq_true_eq]; intro j hj1 hj2; omega
rw [hemp, Bool.and_true]
| succ n ih =>
intro b i hi hle
unfold ed_sigs.verification_key.VerificationKey.verify_sha512_loop
apply loop_step
simp only [ed_sigs.verification_key.VerificationKey.verify_sha512_loop.body]
have hlt : i < 32#usize := by clear * - hi hle; scalar_tac
rw [if_pos hlt]
have hiv : i.val = 32 - (n + 1) := hi
have hb1 : i.val < (e.val).length := by clear * - hle hiv; scalar_tac
have hb2 : i.val < (r.val).length := by clear * - hle hiv; scalar_tac
-- e[i], r[i]
step as ⟨x, hx⟩
step as ⟨y, hy⟩
-- the accumulator update: reduce the `if` to a plain `ok`
have hite : (if (x != y) = true then (ok false : Result Bool) else ok b)
= ok (if (x != y) = true then false else b) := by
by_cases hc : (x != y) = true
· rw [if_pos hc, if_pos hc]
· rw [if_neg hc, if_neg hc]
rw [hite]
-- name the reduced accumulator, then reduce the trivial `ok` bind
generalize heq1 : (if (x != y) = true then false else b) = eq1
simp only [bind_tc_ok]
-- i + 1
step as ⟨i3, hi3⟩
have hnext : i3.val = 32 - n := by clear * - hi3 hiv hle; scalar_tac
try simp only [spec_ok]
-- close with the IH at (eq1, i3); rewrite the range split
apply spec_mono (ih eq1 i3 hnext (by omega))
intro res hres
rw [hres]
-- eq1 = (b && e[i]=r[i]); the [i,32) range = byte i ∧ [i+1,32)
have hxv : x = e.val[i.val]'hb1 := by rw [hx]
have hyv : y = r.val[i.val]'hb2 := by rw [hy]
have heq1v : eq1 = (b && decide (e.val[i.val]! = r.val[i.val]!)) := by
rw [← heq1, hxv, hyv]
rw [getElem!_pos e.val i.val hb1, getElem!_pos r.val i.val hb2]
by_cases h : e.val[i.val]'hb1 = r.val[i.val]'hb2
· have hb : ¬ ((e.val[i.val]'hb1 != r.val[i.val]'hb2) = true) := by
simp [bne_iff_ne, h]
rw [if_neg hb]; simp [h]
· have hb : (e.val[i.val]'hb1 != r.val[i.val]'hb2) = true := by
simp [bne_iff_ne, h]
rw [if_pos hb]; simp [h]
rw [heq1v, Bool.and_assoc]
congr 1
-- decide(byte i) && decide(tail [i+1,32)) = decide(rangeEq [i,32))
have hiff : rangeEq e r (32 - (n + 1)) ↔
(e.val[i.val]! = r.val[i.val]!) ∧ rangeEq e r (32 - n) := by
have h32 : i.val < 32 := by clear * - hlt; scalar_tac
constructor
· intro h
refine ⟨h i.val (by clear * - hiv; omega) h32, ?_⟩
intro j hj1 hj2; exact h j (by omega) hj2
· rintro ⟨hbyte, htail⟩ j hj1 hj2
rcases Nat.lt_or_ge j (32 - n) with hj | hj
· have hji : j = i.val := by clear * - hj1 hj hiv; omega
rw [hji]; exact hbyte
· exact htail j hj hj2
have hda : (decide (e.val[i.val]! = r.val[i.val]!) && decide (rangeEq e r (32 - n)))
= decide ((e.val[i.val]! = r.val[i.val]!) ∧ rangeEq e r (32 - n)) := by
by_cases hp : (e.val[i.val]! = r.val[i.val]!) <;>
by_cases hq : rangeEq e r (32 - n) <;> simp [hp, hq]
rw [hda, decide_eq_decide]
exact hiff.symm
/-- The comparison loop from the verifier's entry state (`b = true`,
`i = 0`): the result equals the full 32-byte equality. -/
theorem verify_loop_full (e r : Array Std.U8 32#usize) :
ed_sigs.verification_key.VerificationKey.verify_sha512_loop r e true 0#usize
⦃ res => res = decide (rangeEq e r 0) ⦄ := by
have h := verify_loop_spec e r 32 true 0#usize (by scalar_tac) (le_refl _)
apply spec_mono h
intro res hres; rw [hres]; simp
/-! ### The apex: the EdDSA verification equation -/
open ed_sigs ed_sigs.verification_key in
/-- **The EdDSA verification equation, SHA-512 opaque.** For a signature
whose byte accessors are total (`hrb`, `hsb`), a key that passes the
all-zero filter (`hA`), an `R` outside the legacy-excluded list
(`hleg`), a canonical scalar `s < ` (`hs`), and a total recomputation
(`hrec`, `he`), the extracted solana-ed25519 dalek-style verifier
accepts **iff** the recomputed compressed point equals the signature's
`R`, byte-for-byte:
verify_sha512 self sig msg = ok (Ok ()) ↔ e = R (all 32 bytes).
`er` (via `recompute_r_sha512`) is the PROVEN composition
`compress( [k]·(A) + [s]·B )` over the certified curve model; `k` is
the scalar the SHA-512 oracle produces — the hash stays opaque, so this
is exactly the honest EdDSA acceptance criterion (ZIP-215 legacy
filters conditioned out by hypothesis). -/
theorem verify_accepts_iff
(self : verification_key.VerificationKey)
(sig : ed25519.Signature) (msg : Slice Std.U8)
(rb sb : Array Std.U8 32#usize) (s : scalar.Scalar)
(er : edwards.CompressedEdwardsY) (e : Array Std.U8 32#usize)
(hrb : ed25519.Signature.r_bytes sig = ok rb)
(hsb : ed25519.Signature.s_bytes sig = ok sb)
(hA : VerificationKey.a_bytes_nonzero self = ok true)
(hleg : is_legacy_excluded_r rb = ok false)
(hs : check_scalar_canonical sb = ok (core.result.Result.Ok s))
(hrec : VerificationKey.recompute_r_sha512 self rb s msg = ok er)
(he : edwards.CompressedEdwardsY.as_bytes er = ok e) :
VerificationKey.verify_sha512 self sig msg = ok (core.result.Result.Ok ())
↔ rangeEq e rb 0 := by
unfold VerificationKey.verify_sha512
rw [hrb]
simp only [bind_tc_ok]
rw [hsb]
simp only [bind_tc_ok]
rw [hA]
simp only [bind_tc_ok, if_true]
rw [hleg]
simp only [bind_tc_ok, Bool.false_eq_true, if_false]
rw [hs]
simp only [bind_tc_ok]
simp only [core.result.Result.Insts.CoreOpsTry_traitTry.branch, bind_tc_ok]
rw [hrec]
simp only [bind_tc_ok]
rw [he]
simp only [bind_tc_ok]
have hloop := verify_loop_full e rb
obtain ⟨v, hv, hpost⟩ := spec_imp_exists hloop
rw [hv]
simp only [bind_tc_ok]
rw [hpost]
by_cases hb : rangeEq e rb 0
· rw [decide_eq_true hb, if_pos rfl]
simp only [hb, iff_true]
· rw [decide_eq_false hb, if_neg (by simp)]
constructor
· intro hcontra; simp_all
· intro hc; exact absurd hc hb
end CurveFieldProofs