BlockchainEngineer
3b228e2e33
- Add docker-compose.yml with 4 Besu IBFT 2.0 validators - Add Foundry project (Counter.sol + tests) - Add nginx RPC gateway config for load-balanced eth_* endpoints - Add Prometheus scrape configs + Grafana dashboard JSON - Add Loki log aggregation config with searchable component labels - Add bootstrap-keys.sh, generate-genesis.mjs, and devnet_simulator.py - Add rpc_gateway_mock.py (threaded HTTP mock for local smoke testing) - Add load_test.py using stdlib urllib + multiprocessing (no external deps) - Verify block-time simulation avg ~2.95s and RPC latency <10ms at 493 TPS 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.