my-homelab-configs/labs/blockchain/README.md

Blockchain Contract Lab

This is the local smart contract workspace for the homelab. It uses Foundry because it is fast, test-oriented, and works well with a local Anvil devnet.

Never put real private keys, seed phrases, or funded wallet data in this repo.

Layout

labs/blockchain/
  foundry.toml
  src/
  test/
  script/

Test

./jeannie blockchain-test

The wrapper uses a local forge binary when available, otherwise it runs the Foundry Docker image with this directory mounted.

Deploy To The Local Devnet

Start the local devnet:

./jeannie blockchain-devnet up

Deploy using one of Anvil's generated dev private keys:

cd labs/blockchain
PRIVATE_KEY=0x... forge script script/DeployCounter.s.sol \
  --rpc-url http://127.0.0.1:8545 \
  --broadcast

Use only Anvil dev keys. Do not paste a real wallet key into a shell.