bee-factory

Local Ethereum Swarm development stack — 5 Bee nodes + Anvil blockchain, fully wired up in one command.

Requirements

• Node.js ≥ 18
• Docker

Install

npm install -g @ethersphere/bee-factory

Usage

bee-factory start           # Start the stack (uses bundled snapshot for fast boot)
bee-factory start --fresh   # Redeploy contracts from scratch, save new snapshot
bee-factory start --tag v2.5.0     # Build Bee from a specific git ref (default: master)

bee-factory stop            # Stop and remove all containers

Endpoints

Node	API	P2P
Queen	http://localhost:1633	http://localhost:1634
Worker 1	http://localhost:11633	http://localhost:11634
Worker 2	http://localhost:21633	http://localhost:21634
Worker 3	http://localhost:31633	http://localhost:31634
Worker 4	http://localhost:41633	http://localhost:41634

Anvil RPC: http://localhost:8545 (chain ID 1337)

Deployed contracts

Contract	Role
BzzToken	ERC-20 BZZ token
PostageStamp	Postage stamp management
PriceOracle	Postage pricing
StakeRegistry	Node staking
Redistribution	Stake redistribution
SimpleSwapFactory	Swap contract factory
SwapPriceOracle	Swap pricing oracle

Contract addresses are printed on startup.

Notes

• Each node is funded with 1 ETH and 100 BZZ.
• Node password: bee-factory
• Snapshots: --fresh redeploys contracts and saves a new snapshot; subsequent normal starts load from it instantly.
• Uses Foundry test keys — never use in production.