docs: align consensus references and guides with current behavior

Makefile

@@ -156,12 +156,12 @@ proto-check-breaking: check-proto-deps
 .PHONY: proto-check-breaking
 
 proto-doc:
-	@echo Generating Protobuf API specification: spec/abci++/api.md
+	@echo Generating Protobuf API specification: spec/abci/api.md
 	@protoc \
 		-I $(realpath .)/proto \
 		-I "$(GOGOPROTO_PATH)" \
 		--doc_opt=markdown,api.md \
-		--doc_out=spec/abci++ \
+		--doc_out=spec/abci \
 		tendermint/abci/types.proto
 
 ###############################################################################

UPGRADING.md

@@ -308,9 +308,9 @@ by Tendermint itself. Right now, we return a regular error when this happens.
 #### ABCI++
 
 For information on how ABCI++ works, see the
-[Specification](spec/abci%2B%2B/README.md).
+[Specification](spec/abci/README.md).
 In particular, the simplest way to upgrade your application is described
-[here](spec/abci%2B%2B/abci++_tmint_expected_behavior.md#adapting-existing-applications-that-use-abci).
+[here](spec/abci/expected-behavior.md#application-execution-requirements).
 
 #### Moving the `app_hash` parameter
 

abci/README.md

@@ -19,7 +19,7 @@ To get up and running quickly, see the [getting started guide](../docs/app-dev/g
 
 A detailed description of the ABCI methods and message types is contained in:
 
-- [The main spec](../spec/abci/abci.md)
+- [The main spec](../spec/abci/methods.md)
 - [A protobuf file](../proto/tendermint/abci/types.proto)
 - [A Go interface](./types/application.go)
 

book/SUMMARY.md

@@ -81,15 +81,15 @@
     - [Recovery and synchronisation](spec/consensus/consensus-recovery.md)
     - [Known issues and discrepancies](spec/consensus/consensus-known-issues.md)
 
-# ABCI++
+# ABCI
 
-- [ABCI++](spec/abci++/README.md)
-- [Application Requirements](spec/abci++/abci++_app_requirements.md)
-- [Overview and basic concepts](spec/abci++/abci++_basic_concepts.md)
-- [Client and Server](spec/abci++/abci++_client_server.md)
-- [Methods](spec/abci++/abci++_methods.md)
-- [Tenderdash's expected behavior](spec/abci++/abci++_tmint_expected_behavior.md)
-- [Protocol Documentation](spec/abci++/api.md)
+- [ABCI](spec/abci/README.md)
+- [Application Requirements](spec/abci/app-requirements.md)
+- [Overview and basic concepts](spec/abci/basic-concepts.md)
+- [Client and Server](spec/abci/client-server.md)
+- [Methods](spec/abci/methods.md)
+- [Tenderdash's expected behavior](spec/abci/expected-behavior.md)
+- [Protocol Documentation](spec/abci/api.md)
 
 # Core data structures and encoding
 
@@ -138,13 +138,6 @@
 
 - [RPC spec](spec/rpc/README.md)
 
-# Historical ABCI reference
-
-- [ABCI](spec/abci/README.md)
-- [Methods and Types](spec/abci/abci.md)
-- [Applications](spec/abci/apps.md)
-- [Client and Server](spec/abci/client-server.md)
-
 # Light-client research
 
 - [Light Client Specification](spec/light-client/README.md)
@@ -207,27 +200,10 @@
 - [RFC 019: Configuration File Versioning](docs/rfc/rfc-019-config-version.md)
 - [RFC 021: The Future of the Socket Protocol](docs/rfc/rfc-021-socket-protocol.md)
 
-# Roadmap
-
-- [Roadmap](docs/roadmap/README.md)
-- [Tenderdash Development](docs/roadmap/roadmap.md)
-
 # DoS observability
 
 - [Consensus DoS — observability](docs/dos-observability/README.md)
 
 # Engineering notes
 
-- [Consensus DoS Defense — Design Spec (v2)](docs/CONSENSUS_DOS_DEFENSE_SPEC.md)
-- [Consensus DoS — devnet test runbook](docs/CONSENSUS_DOS_DEVNET_RUNBOOK.md)
-- [Consensus DoS — Per-Message Matrix](docs/CONSENSUS_DOS_MESSAGE_MATRIX.md)
-- [Per-Message DoS Findings (research synthesis, for review)](docs/CONSENSUS_DOS_PER_MESSAGE_FINDINGS.md)
-- [Consensus DoS — Piece 10 spec: bound the evidence channel](docs/CONSENSUS_DOS_PIECE10_SPEC.md)
-- [Consensus DoS — Piece 2 spec: verification fairness](docs/CONSENSUS_DOS_PIECE2_SPEC.md)
-- [Consensus DoS — Piece 3b spec: honest connectivity](docs/CONSENSUS_DOS_PIECE3B_SPEC.md)
-- [Consensus DoS — Plan](docs/CONSENSUS_DOS_PLAN.md)
-- [Consensus DoS — rollout spec (devnet → testnet)](docs/CONSENSUS_DOS_ROLLOUT_SPEC.md)
-- [Consensus vote-flood DoS — hardening spec](docs/CONSENSUS_VOTE_FLOOD_SPEC.md)
-- [Devnet: custom Tenderdash DoS-hardened image + config-knob plumbing](docs/DEVNET_DOS_IMAGE_AND_TUNING.md)
 - [Building the documentation](docs/DOCS_README.md)
-- [Masternode vote gating — restrict consensus votes to evonodes](docs/MASTERNODE_VOTE_GATING_SPEC.md)

config/toml.go

@@ -553,10 +553,9 @@ wal-file = "{{ js .Consensus.WalPath }}"
 # can have security side-effects.
 wal-skip-rounds-to-last = "{{ .Consensus.WalSkipRoundsToLast }}"
 
-# How many blocks to look back to check existence of the node's consensus votes before joining consensus
-# When non-zero, the node will panic upon restart
-# if the same consensus key was used to sign {double-sign-check-height} last blocks.
-# So, validators should stop the state machine, wait for some blocks, and then restart the state machine to avoid panic.
+# Legacy compatibility setting; currently unused by consensus.
+# This does not provide double-sign protection. Preserve the signer's state
+# and never run two active signers with the same consensus identity.
 double-sign-check-height = {{ .Consensus.DoubleSignCheckHeight }}
 
 # EmptyBlocks mode and possible interval between empty blocks
@@ -616,7 +615,7 @@ peer-data-rate-limit = {{ .Consensus.PeerDataRateLimit }}
 
 # This field provides an unsafe override of the Vote timeout consensus parameter.
 # This field configures how long the consensus engine will wait after
-# receiving +2/3 votes in a round.
+# receiving the configured voting threshold in a round.
 # If this field is set to a value greater than 0, it will take effect.
 # unsafe-vote-timeout-override = {{ .Consensus.UnsafeVoteTimeoutOverride }}