jv
/
my-homelab-configs
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
my-homelab-configs/infra/blockchain-devnet/README.md

1.4 KiB
Raw Blame History

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

The local RPC gateway is available at:

http://127.0.0.1:18545

Use the gateway when you want to practice RPC protection patterns such as method restriction, rate limiting, CORS headers, and request logging. Keep the raw Anvil RPC for direct local development.

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_RPC_GATEWAY_PORT=18545
BLOCKCHAIN_EXPLORER_PORT=8089
BLOCKCHAIN_CHAIN_ID=31337
BLOCKCHAIN_BLOCK_TIME=2