56 lines
1.6 KiB
Markdown
56 lines
1.6 KiB
Markdown
# 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
|
||
|
||
```bash
|
||
# 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](/JCC/issues/JCC-81) for Sprint 0 acceptance criteria.
|