wehub-resource-sync
82 lines
1.8 KiB
Markdown
82 lines
1.8 KiB
Markdown
# cli-anything-eth2-quickstart
|
|
|
|
CLI harness for `eth2-quickstart` so agents can deploy and operate hardened Ethereum nodes
|
|
through a consistent command surface with JSON output.
|
|
|
|
## Prerequisites
|
|
|
|
- Python 3.10+
|
|
- A local checkout of `https://github.com/chimera-defi/eth2-quickstart`
|
|
- Ubuntu host for real installation workflows
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
cd eth2-quickstart/agent-harness
|
|
pip install -e .
|
|
cli-anything-eth2-quickstart --help
|
|
```
|
|
|
|
## Repo Discovery
|
|
|
|
The harness needs to know which `eth2-quickstart` checkout to operate on. It resolves the repo in
|
|
this order:
|
|
|
|
1. `--repo-root`
|
|
2. `ETH2QS_REPO_ROOT`
|
|
3. current working directory or one of its parents
|
|
|
|
```bash
|
|
export ETH2QS_REPO_ROOT=/srv/eth2-quickstart
|
|
cli-anything-eth2-quickstart --json health-check
|
|
```
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
# Interactive REPL
|
|
cli-anything-eth2-quickstart
|
|
|
|
# Inspect machine-readable health
|
|
cli-anything-eth2-quickstart --json health-check
|
|
|
|
# Install phase 2 clients
|
|
cli-anything-eth2-quickstart --json install-clients \
|
|
--network mainnet \
|
|
--execution-client geth \
|
|
--consensus-client lighthouse \
|
|
--mev mev-boost \
|
|
--confirm
|
|
|
|
# Configure validator metadata without touching secrets
|
|
cli-anything-eth2-quickstart --json configure-validator \
|
|
--consensus-client lighthouse \
|
|
--fee-recipient 0x1111111111111111111111111111111111111111 \
|
|
--graffiti "CLI-Anything"
|
|
|
|
# Install and start nginx-backed RPC exposure
|
|
cli-anything-eth2-quickstart --json start-rpc \
|
|
--web-stack nginx \
|
|
--server-name rpc.example.org \
|
|
--confirm
|
|
```
|
|
|
|
## Commands
|
|
|
|
- `setup-node`
|
|
- `install-clients`
|
|
- `start-rpc`
|
|
- `configure-validator`
|
|
- `status`
|
|
- `health-check`
|
|
|
|
All commands support `--json`.
|
|
|
|
## Tests
|
|
|
|
```bash
|
|
cd eth2-quickstart/agent-harness
|
|
python3 -m pytest cli_anything/eth2_quickstart/tests/test_core.py -v
|
|
python3 -m pytest cli_anything/eth2_quickstart/tests/test_full_e2e.py -v
|
|
```
|