Skip to content

Latest commit

 

History

History
161 lines (122 loc) · 4.62 KB

README.md

File metadata and controls

161 lines (122 loc) · 4.62 KB
Raw

hive - Ethereum end-to-end test harness

Hive is a system for running integration tests against Ethereum clients.

Ethereum Foundation maintains two public Hive instances to check for consensus, p2p and blockchain compatibility:

To read more about hive, please check [the documentation][doc].

Run hiveview

Open http://localhost:8080 on explorer, and then we can see all the test results.

./build/bin/hiveview --serve --logdir ./workspace/logs

Update contract transactions

  • Get the taiko-mono repo and turn to const_contracts branch
git clone [email protected]:taikoxyz/taiko-mono.git
git checkout const_contracts
  • Update contract txs list(all the txs in simulators/params/l1contract_txs.txt file)
git clone [email protected]:taikoxyz/hive.git
cd simulators/taiko
TAIKO_MONO_DIR=taiko-mono_path ./scripts/deploy_l1_contract.sh

Build binaries

git clone [email protected]:taikoxyz/hive.git
make hive
make hiveview

Run hive test cases

  • Run l2-full-sync test:
./build/bin/hive --docker.output --client anvil,taiko/taiko-geth,taiko/driver,taiko/proposer,taiko/prover,taiko/taiko-geth,taiko/driver,taiko/taiko-geth,taiko/driver --sim taiko --sim.limit "taiko-genesis/l2-full-sync"
  • Run l2-snap-sync test:
./build/bin/hive --docker.output --client anvil,taiko/taiko-geth,taiko/driver,taiko/proposer,taiko/prover,taiko/taiko-geth,taiko/driver,taiko/taiko-geth,taiko/driver --sim taiko --sim.limit "taiko-genesis/l2-snap-sync"
  • Run taiko-reorg test:
./build/bin/hive --docker.output --client anvil,taiko/taiko-geth,taiko/driver,taiko/proposer,taiko/prover --sim taiko --sim.limit "taiko-reorg/taiko-reorg"
  • Run blob-l1-beacon test:
./build/bin/hive --docker.output --client geth,prysm/prysm-bn,prysm/prysm-vc,taiko/taiko-geth,taiko/driver,taiko/proposer,taiko/prover --sim taiko --sim.limit "taiko-blob/blob-l1-beacon"
  • Run blob-server test:
./build/bin/hive --docker.output --client geth,prysm/prysm-bn,prysm/prysm-vc,taiko/taiko-geth,taiko/driver,taiko/proposer,taiko/prover,storage/redis,storage/postgres,blobscan/blobscan-api,blobscan/blobscan-indexer --sim taiko --sim.limit "taiko-blob/blob-server"

Hive framework

  • ./clients: contains multi-docker images these are used for testing.
  • ./simulators/taiko
    • binding: taiko contract SDK.
    • scripts: some shell scripts used to get txs and update envs and update SDK files.
    • docker: docker: docker-compose folder used to deploy taiko contracts and get txs.
    • common/clients: They are docker images that relate to clients.
    • common/config: Most of them are related to the configuration of the beacon geth node.
    • common/spoofing: Used to genesis l1 execution node.
    • common/testnet
    • suites: tests instances, new test case plz add in this folder.
      • base:
        • taiko-base/l2-full-sync
        • taiko-base/l2-snap-sync
      • blob:
        • taiko-blob/blob-l1-beacon
        • taiko-blob/blob-server
      • reorg:
        • taiko-reorg/taiko-reorg

add new test case

  • Create a new folder named client in simulators/taiko/suites

  • Add execution.go

type ClientTestSpec struct {
    suite_base.BaseTestSpec
}

func (r ClientTestSpec) Verify(ctx context.Context, t *hivesim.T, testnet *tn.Testnet) {
    panic("Plz add test content in this function.")
}
  • Add tests.go
var testSuite = hivesim.Suite{
    Name:        "taiko-blob",
    DisplayName: "driver blob client test",
    Location:    "suites/blob",
}

var Tests = make([]suites.TestSpec, 0)

func init() {
    Tests = append(Tests,
    BlobTestSpec{
        TestL1Beacon: true,
        BaseTestSpec: suite_base.BaseTestSpec{
            Name: "blob-l1-beacon",
        },
    },
    BlobTestSpec{
        TestBlobServer: true,
        BaseTestSpec: suite_base.BaseTestSpec{
            Name: "blob-server",
        },
    })
}

func Suite(clients clients.ClientGroups) hivesim.Suite {
    // Load params.yml
    beaconConfig, err := params.UnmarshalConfig(taparams.ConfigContent, nil)
    if err != nil {
        panic(err)
    }
    
    var genesis core.Genesis
    // Load genesis.json
    if err = json.Unmarshal(taparams.GenesisContent, &genesis); err != nil {
        panic(err)
    }
	
    suites.SuiteHydrate(&testSuite, clients, Tests, &execution_config.GenesisState{
    BeaconConfig:     beaconConfig,
    Genesis:          &genesis,
    })
	return testSuite
}