# 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
```