Skip to content

agents.md

Latest commit

 

History

History
66 lines (51 loc) · 1.77 KB

agents.md

File metadata and controls

66 lines (51 loc) · 1.77 KB

Caplin (Consensus Layer)

Caplin is Erigon's embedded Beacon Chain client implementing Ethereum's proof-of-stake consensus.

Directory Structure

Directory Purpose
beacon/ Beacon API HTTP handlers
phase1/forkchoice/ LMD-GHOST fork choice
phase1/execution_client/ Engine API bridge
phase1/core/state/ Beacon state machine
phase1/network/ Gossip handlers
cltypes/ Consensus types (blocks, attestations)
sentinel/ libp2p P2P networking
pool/ Operations pools (attestations, slashings)
validator/ Attestation producer

Key Components

Fork Choice (phase1/forkchoice/)

  • forkchoice.go - LMD-GHOST implementation
  • on_block.go - Block processing
  • on_attestation.go - Attestation handling
  • Tracks finality and justification checkpoints

Engine API (phase1/execution_client/)

Bridge to execution layer:

  • NewPayload - Receive blocks from consensus
  • ForkchoiceUpdated - Set canonical head
  • GetPayload - Request block for building

Beacon State (phase1/core/state/)

  • State machine with fork upgrades (Altair, Bellatrix, Capella, Deneb)
  • Validator registry management
  • Epoch processing

Sentinel (sentinel/)

  • libp2p-based P2P networking
  • GossipSub for block/attestation propagation
  • Peer scoring and discovery

Beacon API (beacon/handler/)

REST API endpoints:

  • Block production and validation
  • Validator duties
  • Chain state queries
  • Node status

Enable/Disable

# Caplin enabled by default (--internalcl)
./build/bin/erigon --datadir=./data

# Use external consensus client
./build/bin/erigon --externalcl --datadir=./data

Archive Mode

# Enable historical state/block storage
./build/bin/erigon --caplin.archive --datadir=./data