staker 0.1.0

Ethereum staking node orchestrator

Ethereum Staking Node

A complete Ethereum validator infrastructure running Geth (execution) + Prysm (consensus) + MEV-Boost on AWS ECS.

Architecture

┌─────────────────────────────────────────────────────────────┐
│                      staker.node                            │
│                  (Process Orchestrator)                     │
├──────────┬──────────┬──────────┬──────────┬────────────────┤
│   Geth   │  Beacon  │Validator │MEV-Boost │   VPN (opt)    │
│(Execution)│  Chain   │          │          │                │
└──────────┴──────────┴──────────┴──────────┴────────────────┘
                           │
                    ┌──────┴──────┐
                    │   AWS ECS   │
                    │  (EC2 Mode) │
                    └─────────────┘

Project Structure

src/staker/
├── config.py       # Configuration constants and relay lists
├── environment.py  # Runtime abstraction (AWS vs local)
├── mev.py          # MEV relay selection and health checking
├── node.py         # Main orchestrator - starts/monitors processes
├── snapshot.py     # EBS snapshot management for persistence
└── utils.py        # Utility functions (IP check, log coloring)

Prerequisites

• uv (Python package manager)
• Docker
• AWS CLI (configured with appropriate permissions)
• Python 3.11+

Configuration

Environment Variables

Variable	Description	Required
DEPLOY_ENV	dev (Holesky testnet) or prod (Mainnet)	✅
ETH_ADDR	Fee recipient address	✅
AWS	Set to true when running on AWS	❌
DOCKER	Set to true when running in container	❌
VPN	Set to true to enable VPN	❌

Network Ports

Port	Protocol	Purpose
30303	TCP/UDP	Geth P2P
13000	TCP	Prysm P2P
12000	UDP	Prysm P2P

Development

Install Dependencies

make install

Lint

make lint

Format

make format

Test

make test

Test with Coverage

make cov

Build Docker Image

make build

Run Docker Container

make run

Stop Container

make kill

Deploy to AWS

make deploy

MEV Relays

The node connects to multiple MEV relays for optimal block building:

Mainnet: Flashbots, Ultra Sound, bloXroute, Aestus, Agnostic, Eden, Manifold, Titan, Proof, Wenmerge

Holesky: Flashbots, Aestus, Ultra Sound, bloXroute

Relays are automatically tested on startup; unreliable ones are filtered out.

Backup Strategy

• Snapshots created every 30 days
• Maximum 3 snapshots retained (90 days)
• Automatic launch template updates with latest snapshot
• Graceful shutdown triggers snapshot on instance draining

Version Info

Component	Version
Geth	1.16.7
Prysm	v7.1.2
MEV-Boost	1.10.1
Base Image	Ubuntu 24.04

License

Private repository.