JCC Home-Grown Blockchain — Local Devnet & Infrastructure
TL;DR — JC Capital blockchain infrastructure – Solidity, Besu genesis, devnet tooling, monitoring. This file explains how to stand it up and who to contact; the machinery detail stays lower under Details.
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.