Skip to content

Commit 9914b78

Browse files
mswilkisonclaude
andcommitted
docs(frost/roast): mark seed-vector regeneration as a protocol-change event
A regen run that produces different bytes means the normative Annex A derivation changed; it requires an annex update in the same change and a mixed-fleet rollout note. Both language suites passing after a dual regen is not evidence of compatibility with deployed engines. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
1 parent d44fa86 commit 9914b78

1 file changed

Lines changed: 7 additions & 0 deletions

File tree

pkg/frost/roast/coordinator_seed_vectors_test.go

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -184,6 +184,13 @@ func TestCoordinatorSeedDerivation_ConformanceVectors(t *testing.T) {
184184
// After regenerating, copy the file byte-identically to
185185
// pkg/tbtc/signer/testdata/coordinator_seed_vectors.json on the
186186
// signer branch.
187+
//
188+
// Regenerating is a protocol-change event, not a refresh: the file
189+
// pins the normative RFC-21 Annex A behaviour, so a run that produces
190+
// different bytes means the derivation changed and requires an
191+
// Annex A update in the same change plus a mixed-fleet rollout note.
192+
// Both language suites passing after a dual regen is NOT evidence of
193+
// compatibility with already-deployed engines.
187194
func TestRegenerateCoordinatorSeedVectors(t *testing.T) {
188195
if os.Getenv("ROAST_SEED_VECTORS_REGEN") != "1" {
189196
t.Skip("set ROAST_SEED_VECTORS_REGEN=1 to regenerate the vector file")

0 commit comments

Comments
 (0)