Skip to content

Conversation

@snario
Copy link
Contributor

@snario snario commented Jan 23, 2026

Adds a new Consensus and Finality documentation page under the Blockspace section.

Content

  • Simplex BFT Consensus: Overview of Commonware's Simplex implementation
  • Block Production: ~0.5s blocks, deterministic finality
  • Validator Set: Current testnet config, mainnet plans, permissionless roadmap
  • Fault Tolerance: BFT thresholds (tolerates <1/3 Byzantine)
  • Distributed Validation: No single sequencer, multiple validators
  • Degraded State Behavior: Graceful degradation under adverse conditions
  • Integrator Guidance: How to treat finalized blocks

This addresses documentation gaps identified when preparing RFP responses.

Add documentation for Tempo's consensus mechanism:
- Simplex BFT via Commonware
- Deterministic sub-second finality
- Validator fault tolerance (up to 1/3 Byzantine)
- Distributed validation vs single sequencer
- Degraded state behavior
- Integrator guidance for finality
@vercel
Copy link

vercel bot commented Jan 23, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Review Updated (UTC)
tempo-docs Ready Ready Preview, Comment Jan 23, 2026 5:16pm

Request Review


### Block Production

Blocks are produced approximately every 0.5 seconds under normal network conditions. Proposer selection follows a round-robin pattern among active validators. Once a block is finalized, it cannot be reverted.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Blocks are produced approximately every 0.5

0.5 is an absolute lower bound, which is not reachable in practice because we only interrupt our builder loop after 500ms - if you then add network latencies + block validation this number is pushed up. I think a more realistic number is 600ms, but we still have to benchmark this with validators that are not all running in the same datacenter.

round-robin

We use a VRF for leader selection, so this is random (and offers DoS protection/MEV games).

Copy link

@SuperFluffy SuperFluffy left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good except for the things I have mentioned.

Could add these links for folks who are interested in reading more:

Commonware simplex: https://docs.rs/commonware-consensus/0.0.65/commonware_consensus/simplex/

Section on simplex with bls12381 threshold scheme: https://docs.rs/commonware-consensus/0.0.65/commonware_consensus/simplex/index.html#schemebls12381_threshold

- Change block time from 0.5s to ~600ms (more realistic with network latency)
- Replace round-robin with VRF-based random leader selection
- Add Further Reading section with Commonware Simplex docs links
@snario snario merged commit bfdd03c into main Jan 23, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants