feat(consensus): operate four-validator M1 devnet - #33
Merged
Conversation
Record the static full-mesh topology, independent replica lifecycle, compatibility constraints, and completion evidence for issue #32 before implementation.
Create or exact-validate four independent validator homes with one shared equal-power genesis, distinct retained keys, and a loopback full mesh. Reject partial, changed, or duplicate topology state for issue #32.
Add foreground lifecycle, complete topology health, exact transaction submission, clean-clone tooling, public synthetic fixtures, and a hosted four-replica restart integration for issue #32.
Validate the height-zero validator set from the exact shared genesis, bound operational inputs, add negative health tests, improve hosted failure diagnostics, split cohesive runtime modules, and document the tested lifecycle.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Linked work
Closes #32
Outcome
Deliver the complete M1 four-validator local CometBFT lifecycle: one foreground command initializes and supervises four independent C++/SQLite replicas, exact health and transaction operations observe the full topology, orderly stop preserves durable state, and restart continues from the retained ledgers.
Scope
Included: four equal-power validators, distinct retained validator/node keys, byte-identical common genesis, static loopback full mesh, twelve-child foreground supervision, short-lived Unix-socket isolation, converged non-catching-up health, exact raw transaction submission, public deterministic fixtures, operator documentation, and a real hosted transfer/stop/audit/restart integration.
Excluded: canonical ledger changes, validator updates, staking, state sync, public networking, containers, wallets, and production keys.
Protocol and compatibility impact
Adapter-only compatibility amendment recorded in ADR 0001 and
consensus-application-v1.md. CometBFT v0.39.4, ABCI 2.0.0, application protocol v1, ledger bytes, economics, state roots, and database format remain unchanged. Peer order, ports, sockets, timing, and validator metadata remain deployment state.Verification
Local lightweight checks:
git diff --check— passed.python3 -m py_compile tests/integration/cometbft_four_validator_test.py— passed.sh -n tools/devnet.sh tools/verify.sh— passed.Hosted exact evidence:
28d2404: Actions run 30450433782 passed GCC debug, GCC ASan/UBSan, Clang debug, and Clang ASan/UBSan. Debug jobs passed 26/26 CTest targets; Clang sanitizer passed 32/32 including fuzz smoke. Every job passed Go tests/vet, four cgo-free builds, the single-node integration, and the four-validator integration.9b45994: Actions run 30450907381 repeated all four jobs successfully.Risks and follow-up
This remains loopback-only research software. Generated validator keys are unencrypted development keys. The fixed four-node topology is an M1 operational default, not a production validator-admission or public-network design.
Checklist
current-state.mdare accurate.