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

1.1 KiB

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

./jeannie blockchain-devnet status
./jeannie blockchain-devnet up
./jeannie blockchain-devnet logs
./jeannie blockchain-devnet down

The default RPC endpoint is:

http://127.0.0.1:8545

The lightweight local explorer is available at:

http://127.0.0.1:8089

From another LAN host, use the Debian host IP:

http://192.168.100.73:8545

Useful RPC Checks

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

BLOCKCHAIN_RPC_PORT=8545
BLOCKCHAIN_EXPLORER_PORT=8089
BLOCKCHAIN_CHAIN_ID=31337
BLOCKCHAIN_BLOCK_TIME=2