Infrastructure Resources
Espresso Network - Official Resources
Official documentation, network endpoints, and tooling provided by the Espresso Systems team for node operators and validators. Resources are shared across Mainnet and Decaf Testnet where applicable.
Official guides and references published by the Espresso Systems team for running and registering nodes on Mainnet and Decaf Testnet.
Official Documentation
- docs.espressosys.com/network - Main documentation hub Mainnet & Decaf
- HackMD Technical Posts - In-depth technical articles by the team Mainnet & Decaf
- Research Forum - Protocol research and discussion Mainnet & Decaf
- Blog - Announcements and ecosystem updates
Mainnet Node Guides Mainnet
- Running a Mainnet Node - Step-by-step setup guide
- Staking CLI README - Validator registration guide (register, deregister, account commands)
Decaf Testnet Node Guides Decaf
- Running a Decaf Node - Step-by-step setup guide
- TCP Optimizations - Required network settings since release 20251106
Network endpoints required for node configuration. Use these values in your environment variables when setting up your sequencer node.
Mainnet Endpoints Mainnet
| Variable | Endpoint |
|---|---|
| Config Peers |
https://cache.mainnet.espresso.network
|
| State Peers |
https://query.mainnet.espresso.network
|
| State Relay |
https://state-relay.mainnet.espresso.network
|
| Stake Table | 0xCeF474D372B5b09dEfe2aF187bf17338Dc704451 |
Decaf Testnet Endpoints Decaf
| Variable | Endpoint |
|---|---|
| Config Peers |
https://cache.decaf.testnet.espresso.network
|
| State Peers |
https://query.decaf.testnet.espresso.network
|
| State Relay |
https://state-relay.decaf.testnet.espresso.network
|
| CDN (TCP) |
cdn.decaf.testnet.espresso.network:1737 / :1738
Outgoing TCP must be open on ports 1737 and 1738 |
Configuration Notes
- ESPRESSO_SEQUENCER_STATE_PEERS - Keep this list to a maximum of ~5 URLs and remove any unreachable ones.
-
Non-DA node command:
/bin/sequencer-postgres -- http -- catchup -- status -- config -
ESPRESSO_SEQUENCER_L1_RETRY_DELAY - Set to
20sfor mainnet nodes. - Both SQLite-backed and filesystem-backed (postgres binary) storage modes are supported. Choose whichever fits your setup.
Official repositories and tooling from the Espresso Systems team to help operators set up and manage their nodes.
GitHub Repositories
- EspressoSystems - Main GitHub organization
- espresso-network — Core protocol repository. Source for all node releases.
- espresso-for-dummies - Docker Compose examples for AWS ECS, K8S and other cloud deployments.
Latest Release
- 20260424 - Current release for both Mainnet and Decaf. No configuration changes required. Mainnet & Decaf
Community & Ecosystem
- espressosys.com — Official website
- espresso.foundation — Espresso Foundation
- @EspressoSys - Official X account
- Composable Podcast - Ecosystem podcast
- Jobs - Open positions at Espresso Systems