docs: detail p2p weighted consensus

Expand validator and challenge docs with stake-weighted consensus flow.
Describe commit-reveal and epoch boundary aggregation details.

Author: echobt

docs/challenge-integration.md

@@ -26,6 +26,10 @@ Validators evaluate challenges locally and publish weight commitments over the P
 
 These aggregated weights are submitted to Bittensor as the subnet’s consensus output.
 
+### Weight Aggregation at Epoch Boundaries
+
+At the epoch boundary, validators aggregate the revealed weights with a stake-weighted sum to produce the canonical weight matrix and a deterministic state hash. Validators reject late or mismatched reveals to keep the final aggregation deterministic. The finalized aggregation is the only weight matrix submitted back to Bittensor for the epoch.
+
 ## Architecture
 
 ```text

docs/validator.md

@@ -27,13 +27,19 @@ Platform validators run as a fully peer-to-peer network with no centralized fall
 
 Consensus is driven by validator weights derived from challenge evaluations. The validator set is stake-weighted, meaning higher-stake hotkeys carry more voting power when aggregating challenge results.
 
-1. **Stake-weighted validator set**: Each validator’s voting power is proportional to its Bittensor stake in the metagraph.
+1. **Stake-weighted validator set**: Each validator’s voting power is proportional to its Bittensor stake in the metagraph. The active validator set is refreshed from the metagraph as epochs advance.
 2. **Challenge evaluation**: Validators execute the active challenges, producing raw scores for miners or submissions.
 3. **Commit-reveal weights**: Validators commit their weight vectors during the commit phase and reveal them in the reveal phase, preventing copycat behavior.
 4. **Epoch boundary aggregation**: At the end of each epoch, revealed weights are aggregated using stake weighting to compute the canonical weight matrix.
 5. **Consensus agreement**: Validators finalize the epoch by agreeing on the aggregated weights and resulting state hash over the P2P mesh.
 6. **Weight submission**: The finalized weight matrix is submitted back to Bittensor as the subnet consensus output.
 
+### Epoch Timeline
+
+- **Commit window**: Validators broadcast weight commitments over libp2p.
+- **Reveal window**: Validators reveal the committed weights to peers.
+- **Aggregation window**: Stake-weighted aggregation finalizes the epoch weights and state hash.
+
 ---
 
 ## Quick start for validators