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.