my-homelab-configs/infra/blockchain-devnet/README.md

49 lines
1.0 KiB
Markdown

# Blockchain Devnet
This stack runs a local Ethereum-compatible devnet for learning smart contracts,
wallets, JSON-RPC, block production, and defensive RPC operations.
It is intentionally local/dev-only. Do not use real wallets, seed phrases, or
mainnet private keys here.
## Commands
```bash
./jeannie blockchain-devnet status
./jeannie blockchain-devnet up
./jeannie blockchain-devnet logs
./jeannie blockchain-devnet down
```
The default RPC endpoint is:
```text
http://127.0.0.1:8545
```
From another LAN host, use the Debian host IP:
```text
http://192.168.100.73:8545
```
## Useful RPC Checks
```bash
curl -sS -X POST http://127.0.0.1:8545 \
-H 'content-type: application/json' \
--data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}'
curl -sS -X POST http://127.0.0.1:8545 \
-H 'content-type: application/json' \
--data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
```
## Environment
```bash
BLOCKCHAIN_RPC_PORT=8545
BLOCKCHAIN_CHAIN_ID=31337
BLOCKCHAIN_BLOCK_TIME=2
```