BlockchainEngineer
6af3f606a2
- Fix docker-compose.yml p2p port mappings (30304:30303, 30305:30303) - Fix typo BESUS_GENESIS_FILE -> BESU_GENESIS_FILE - Add missing volumes/environment to validator2 and validator3 services - Remove outdated package-lock.json to let CI regenerate cleanly - Validate genesis determinism and extraData alignment Co-Authored-By: Paperclip <noreply@paperclip.ing>
JCC Home-Grown Blockchain — Local Devnet & Infrastructure
Monorepo for JCC blockchain infrastructure, including validator devnet, CI/CD, monitoring, and treasury UI scaffolding.
Quick Start
# Start the 3-node IBFT 2.0 devnet
./scripts/devnet-up.sh
# Stop it
./scripts/devnet-down.sh
# Reset chain data
./scripts/devnet-reset.sh
Structure
| Directory | Purpose |
|---|---|
devnet/ |
Docker Compose, Besu config, genesis, validator keys |
contracts/ |
Solidity sources, Foundry/Forge config, tests |
monitoring/ |
Prometheus, Grafana dashboards, Loki config |
load-test/ |
(TBD) Chaos / load scripts |
rpc-gateway/ |
(TBD) API gateway / rate-limit proxy |
.github/workflows/ |
CI/CD definitions |
Devnet Spec
- Consensus: IBFT 2.0 (3 validators)
- Block time: ≤ 5 s
- Chain ID: 1337
- Genesis: reproducible, version-controlled in
devnet/besu-config/genesis.json - Metrics: Prometheus exporter on each validator, scraped by local Prometheus
Tooling Prerequisites
- Docker Engine ≥ 24.0
- Docker Compose ≥ 2.20
- Foundry (Forge + Cast + Anvil)
- Node.js ≥ 18 (for treasury UI)
Security Notes
- Validator node keys in this repo are devnet-only.
- Production keys live in HSM / AWS KMS / HashiCorp Vault (see infra runbooks).
- Never commit production credentials.
Next Actions
- See JCC-81 for Sprint 0 acceptance criteria.