Skip to content

Commit 6b263f2

Browse files
committed
docs: fix stale MTC.md references (ECDSA removal, BuildCAName, subtree route)
MTC.md described a previous state of the repo in a few spots: - signer/ no longer supports ECDSA and has no //go:build go1.27 tags; it is ML-DSA-only with the whole module on go 1.27. - cert.BuildLogIDName is named cert.BuildCAName. - the read-path route is /subtree/<name>, not /subtree/<start>-<end>. - note signer.Signer also has Algorithm()/PublicKey().
1 parent feaf1ea commit 6b263f2

1 file changed

Lines changed: 10 additions & 8 deletions

File tree

MTC.md

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -142,7 +142,8 @@ that means the read-path (HTTP) serves files at:
142142
- `/tile/<L>/<NNN>[.p/<W>]` — Merkle hash tiles.
143143
- `/tile/entries/<NNN>[.p/<W>]` — entry blobs (the "data" tiles).
144144
- `/log/v1/entry/<index>` — fetch one entry by index.
145-
- `/subtree/<start>-<end>` — cached signed subtree blob.
145+
- `/subtree/<name>` — cached signed subtree blob (the name is the
146+
`start-end` storage key).
146147

147148
Cactus's `log/` and `tile/` packages own this. The log is a
148149
single-writer affair: one goroutine ticks every `flush_period_ms`,
@@ -187,13 +188,14 @@ MTC proofs always use `timestamp = 0`.
187188

188189
In cactus, the cosigner abstraction is in `signer/`:
189190

190-
- `signer.Signer` — a one-method interface (`Sign(rand, msg) → sig`).
191+
- `signer.Signer` — a small interface whose core method is
192+
`Sign(rand, msg) → sig` (plus `Algorithm()` and `PublicKey()`).
191193
- `signer.FromSeed(alg, seed)` — derives a key from a 32-byte seed
192-
via HKDF. ECDSA-P256 and ECDSA-P384 on any toolchain; ML-DSA-44/65/87
193-
on Go 1.27+, where Go's built-in `crypto/mldsa` (FIPS 204) is available.
194-
The ML-DSA files carry a `//go:build go1.27` constraint, so they compile
195-
in automatically — no build tag. Until Go 1.27 is released a `gotip`
196-
1.27-devel toolchain satisfies the constraint (`gotip build ./...`).
194+
via HKDF. cactus is ML-DSA-only: ML-DSA-44/65/87, using Go's
195+
built-in `crypto/mldsa` (FIPS 204). That package needs Go 1.27+, so
196+
the whole module is `go 1.27` in go.mod — no per-file build tags.
197+
Until Go 1.27 is released, a `gotip` 1.27-devel toolchain builds it
198+
(`gotip build ./...`).
197199

198200
## §6: Building the certificate
199201

@@ -239,7 +241,7 @@ The cert assembly code is in `cert/` and `ca/`:
239241

240242
- `cert.MTCProof` / `cert.MTCSubtree` / `cert.MTCSignature`
241243
TLS-presentation encoders.
242-
- `cert.BuildLogIDName` — the §5.2 issuer DN.
244+
- `cert.BuildCAName` — the §5.2 issuer DN.
243245
- `ca.Validator` / `ca.Issuer` — turn an ACME order + CSR into a
244246
TBSCertificateLogEntry, submit to the log, await the inclusion
245247
proof, assemble the X.509 cert.

0 commit comments

Comments
 (0)