RTWO Consensus Engine

Phase 4 — Architecture Defined · Not Connected to Network · Not Connected to Validators

Consensus Structure ReadyReady for P2P Network Phasev1.0.0-phaseB4

Consensus Engine Status

Current operational state of the consensus engine and its integrations.

Source: Consensus Engine

Engine Status

Architecture Ready

Not Connected to Network

Current Phase

Idle

Waiting for Real Data

Active Validators

Waiting for Real Data

Source: Real Validator Node — Not Connected

Finalized Blocks

Waiting for Real Data

Source: Real Network — Not Connected

Domain Model Summary

Six strongly typed domain models defining the consensus architecture.

6 Models Defined

Consensus Lifecycle Diagram

The 8-phase consensus state machine from Idle to Finalized.

Source: Consensus Engine
Source: Consensus Engine — Architecture Defined, Not Connected to Network

Epoch Lifecycle Diagram

How consensus epochs progress from pending to finalized.

Source: Consensus Engine
1
Pending

Epoch is scheduled but has not yet started. Validator set is being prepared.

2
Active

Epoch is currently running. Validators are participating in consensus rounds.

3
Finalizing

Epoch end block has been reached. Final rewards and slashing are being calculated.

4
FinalizedTerminal

Epoch has been fully finalized. Rewards distributed and validator set updated.

5
FailedTerminal

Epoch failed to finalize due to consensus failure or critical error.

Source: Consensus Engine

Validator Registry Structure

Six validator lifecycle statuses managed by the consensus engine.

Source: Real Validator Node — Not Connected
Candidate

Validator has registered but has not yet been admitted to the active set.

✗ Cannot Propose✗ Cannot Vote
Active

Validator is in the active set and participates in consensus rounds.

✓ Can Propose✓ Can Vote
Inactive

Validator is registered but not currently participating in consensus.

✗ Cannot Propose✗ Cannot Vote
Jailed

Validator has been jailed due to downtime or protocol violations.

✗ Cannot Propose✗ Cannot Vote
Slashed

Validator has been penalized for double-signing or equivocation.

✗ Cannot Propose✗ Cannot Vote
Removed

Validator has been permanently removed from the validator registry.

✗ Cannot Propose✗ Cannot Vote
Source: Real Validator Node — Not Connected

Vote Processing Pipeline

7-step pipeline for validating and aggregating consensus votes.

Source: Consensus Engine
1Vote Received

Validator submits a prevote or precommit to the consensus engine.

Source: Real Validator Node — Not Connected
2Signature Verification

BLS/Ed25519 signature is verified against the validator public key.

Source: Consensus Engine
3Authorization Check

Validator is confirmed to be in the active set for this epoch.

Source: Consensus Engine
4Equivocation Detection

Vote is checked against existing votes to detect double-voting.

Source: R6 Security & Automation
5Vote Aggregation

Valid vote is added to the aggregation pool for the current round.

Source: Consensus Engine
6Quorum Evaluation

Total voting power is evaluated against the 2/3+ BFT threshold.

Source: Consensus Engine
7Finality Decision

If quorum is reached, block proceeds to finalization. Otherwise, next round begins.

Source: Consensus Engine

Note: Vote processing pipeline is architecturally defined. Live vote processing requires P2P Network (Phase 5) and real validator nodes.

Consensus Service Registry

10 services integrated across R3, R4, R6, and R7 execution layers.

10 Services
R3

Consensus State Management

R3 Core Orchestrator

Ready
R4

Epoch Management

R4 Blockchain Protocol Engine

Ready
R6

Validator Candidate Registry

R6 Security & Automation

Ready
R3

Proposer Selection

R3 Core Orchestrator

Ready
R6

Vote Validation

R6 Security & Automation

Ready
R4

Vote Aggregation

R4 Blockchain Protocol Engine

Ready
R7

Finality Calculation

R7 Enterprise Services

Ready
R6

Slashing Rule Evaluation

R6 Security & Automation

Ready
R3

Consensus Lifecycle Management

R3 Core Orchestrator

Ready
R7

Consensus Event Publishing

R7 Enterprise Services

Ready
Source: Consensus Engine

Slashing Framework Structure

6 slashing rules defined for validator misbehavior detection.

Source: R6 Security & Automation
criticalDouble Signingenabled

Validator signed two different blocks at the same height and round (equivocation).

Penalty: tombstone

mediumDowntime Violationenabled

Validator missed more than the allowed threshold of consensus rounds within an epoch.

Penalty: jail

highInvalid Vote Submissionenabled

Validator submitted a vote with an invalid or forged signature.

Penalty: stake reduction

highProposer Misbehaviorenabled

Proposer submitted an invalid or malformed block proposal.

Penalty: jail

criticalUnauthorized Validator Activityenabled

Validator participated in consensus without being in the active validator set.

Penalty: removal

highEpoch Finality Obstructiondraft

Validator deliberately withheld votes to prevent epoch finalization.

Penalty: stake reduction

Source: R6 Security & Automation

Finality Readiness Checklist

Prerequisites for live consensus finality. Architecture is complete; network connectivity is deferred to Phase 5.

Source: Consensus Engine

P2P Network Connected

Required for Phase 5

Live Validator Nodes

Required for Phase 5

Consensus State Machine

Architecture defined in Phase 4

Epoch Management

Architecture defined in Phase 4

Validator Registry

Architecture defined in Phase 4

Vote Validation Pipeline

Architecture defined in Phase 4

Slashing Framework

Architecture defined in Phase 4

Finality Calculation

Architecture defined in Phase 4

Core Engine Integration

R3, R4, R6, R7 integrated

Blockchain Protocol Engine

Phase 3 complete

Phase 4 Acceptance Checklist

All Phase 4 deliverables must be complete before proceeding to Phase 5.

Source: Consensus Engine

consensus-engine module created

src/lib/consensus-engine/ module exists

complete

RTWOConsensusState domain model defined

9 fields: height, round, epoch, phase, proposer, validatorSetHash, lockedBlockHash, finalizedBlockHash, status

complete

RTWOValidatorCandidate domain model defined

8 fields: validatorId, operatorAddress, publicKey, status, votingPower, stakeAmount, joinedAt, lastSeenAt

complete

RTWOConsensusVote domain model defined

9 fields: voteId, blockHash, validatorId, voteType, round, epoch, signature, timestamp, status

complete

RTWOEpoch domain model defined

7 fields: epochNumber, startBlock, endBlock, validatorSetHash, status, startedAt, finalizedAt

complete

RTWOFinalityRecord domain model defined

6 fields: blockNumber, blockHash, finalizedAt, validatorSetHash, voteCount, finalityStatus

complete

RTWOSlashingRule domain model defined

7 fields: ruleId, ruleName, severity, description, penaltyType, enabled, status

complete

Consensus phases defined (8 phases)

Idle → Proposer Selection → Block Proposal → Vote Collection → Vote Validation → Finality Check → Finalized → Failed

complete

Validator statuses defined (6 statuses)

Candidate, Active, Inactive, Jailed, Slashed, Removed

complete

Service interfaces defined

10 service interfaces with placeholder implementations

complete

Core Engine integration complete

Integrated with R3 Core Orchestrator, R4 Blockchain Protocol Engine, R6 Security & Automation, R7 Enterprise Services

complete

Consensus dashboard page created

/consensus-engine route with full architecture visualization

complete

No fake blockchain data shown

Truthful Data Policy enforced — all runtime values are null or empty states

complete

P2P runtime bridge activated

Consensus Engine connected to operational P2P provider — no fabricated network state

complete

Integration Status with Blockchain Protocol Engine

Phase 4 consensus engine integration points with existing execution layers.

Source: Core Engine
R3Core Orchestrator
  • Consensus State Management
  • Proposer Selection
  • Lifecycle Management
Integrated
R4Blockchain Protocol Engine
  • Epoch Management
  • Vote Aggregation
  • Block Finality
Integrated
R6Security & Automation
  • Validator Registry
  • Vote Validation
  • Slashing Evaluation
Integrated
R7Enterprise Services
  • Finality Calculation
  • Event Publishing
  • Audit Trail
Integrated
Not Connected to Validators Not Connected to Network Consensus Structure Ready Ready for P2P Network Phase
Source: Core Engine — Architecture Defined

Phase 4 Architecture Notice

This phase defines the RTWO Consensus Engine architecture and internal state machine only. RTWO Mainnet is not live. Validators are not running. Blocks are not being finalized. All consensus services are structurally defined with placeholder implementations. Live consensus operation requires Phase 5 (P2P Networking) and real validator node deployment.

Mainnet Not LiveValidators Not RunningBlocks Not FinalizedNetwork Not Connected