Run Hive Tests
Build Hive and run integration test simulations against Ethereum clients.
Arguments
- •
$0: Simulator to run (e.g.,ethereum/sync,ethereum/rpc) - •
--client: Client to test against (e.g.,core-geth,go-ethereum)
Hive Structure
- •Client definitions:
hive/clients/<name>/ - •Simulators:
hive/simulators/<category>/<name>/ - •Clients are Docker containers configured via
HIVE_*environment variables
Workflow
- •Navigate to the hive directory
- •Build hive if needed:
bash
go build .
- •Run the specified simulator:
bash
./hive --sim $0 --client <client>
- •Report the test results
Common Simulators
- •
ethereum/sync- Block synchronization tests - •
ethereum/rpc- JSON-RPC API tests - •
ethereum/consensus- Consensus mechanism tests
Example Usage
code
/hive-run ethereum/sync --client core-geth /hive-run ethereum/rpc --client go-ethereum
Troubleshooting
If tests fail:
- •Check Docker is running and accessible
- •Verify the client image builds successfully
- •Check hive logs in the workspace directory
- •Consult Hive Documentation