ipld-eth-db-validator/test/README.md

Test Instructions

Setup

• For running integration tests:

  • Clone stack-orchestrator, go-ethereum and ipld-eth-db repositories.

  • Checkout v4 release in ipld-eth-db repo.

    # In ipld-eth-db repo.
    git checkout v4.2.0-alpha
    

  • Checkout v4 release in go-ethereum repo.

    # In go-ethereum repo.
    git checkout v1.10.19-statediff-4.1.0-alpha
    

  • Checkout working commit in stack-orchestrator repo.

    # In stack-orchestrator repo.
    git checkout f2fd766f5400fcb9eb47b50675d2e3b1f2753702
    

Run

• Run unit tests:

  # In ipld-eth-db-validator root directory.
  ./scripts/run_unit_test.sh
  

• Run integration tests:

  • In stack-orchestrator repo:

    • Create config file:

      cd helper-scripts
      
      ./create-config.sh
      

      A config.sh will be created in the root directory.

    • Update/Edit the config file config.sh:

      #!/bin/bash
      
      # Path to ipld-eth-server repo.
      vulcanize_ipld_eth_db=~/ipld-eth-db/
      
      # Path to go-ethereum repo.
      vulcanize_go_ethereum=~/go-ethereum
      
      # Path to contract folder.
      vulcanize_test_contract=~/ipld-eth-db-validator/test/contract
      
      genesis_file_path='start-up-files/go-ethereum/genesis.json'
      db_write=true
      

    • Run stack-orchestrator:

      # In stack-orchestrator root directory.
      cd helper-scripts
      
      ./wrapper.sh \
      -e docker \
      -d ../docker/local/docker-compose-db-sharding.yml \
      -d ../docker/local/docker-compose-go-ethereum.yml \
      -d ../docker/local/docker-compose-contract.yml \
      -v remove \
      -p ../config.sh
      

  • Run tests:

    # In ipld-eth-db-validator root directory.
    ./scripts/run_integration_test.sh