README.md

Mainnet Deployment

Setup

• Snap synced Geth node and synced Lighthouse node are required for running the services.

• Update CHAINDATA_DIR variable in .env file to point to Geth leveldb directory.

• Update LIGHTHOUSE_DIR variable in .env file to point to Lighthouse data directory.

• Create a jwtsecret file required by both Geth and Lighthouse clients:

  ./makejwt.sh

• Create a watcher.env file from watcher.env.sample with updated DB credentials:

  cp watcher.env.sample watcher.env
  

Run

• Start ipld-eth-db and watcher-db services:

  docker-compose up -d --build ipld-eth-db watcher-db

• Check that services ipld-eth-db and watcher-db are up and healthy:

  docker-compose ps

• Uncompress data dumps:

  tar -xzvf ../common/ipld-eth-db/mainnet-indexer-db.tar.gz -C ../common/ipld-eth-db/
  
  tar -xzvf ../common/watcher-ts/mobymask-watcher-db.tar.gz -C ../common/watcher-ts/

• Import statediff data for old blocks in indexer database:

  docker-compose exec ipld-eth-db psql -U vdbm indexer -c "SELECT timescaledb_pre_restore();"
  
  docker-compose exec -T ipld-eth-db psql -U vdbm indexer < ../common/ipld-eth-db/mainnet-indexer-db.sql
  
  docker-compose exec ipld-eth-db psql -U vdbm indexer -c "SELECT timescaledb_post_restore();"

• Import indexed data for old blocks in mobymask-watcher database:

  docker-compose exec -T watcher-db psql -U vdbm mobymask-watcher < ../common/watcher-ts/mobymask-watcher-db.sql

• Intialize and start core services:

  docker-compose up -d --build

• Optionally, to follow the container logs:

  docker-compose logs -f

• Check if new block at chain head has been indexed by Geth. Run the following query in ipld-eth-server GraphQL endpoint to get the latest block:

  query {
    block {
      hash
      number
    }
  }

  Confirm that a new block is returned i.e. it should be different from the previously indexed block for MobyMask contract:

  # Should not be equal to this result (block number 15234194)
  {
    "data": {
      "block": {
        "hash": "0x1f1f9ddf5435def50e966563a68afc302b1d43b1ead0c15a3b3397a17c452eb9",
        "number": "0xe87492"
      }
    }
  }

  NOTE: The new block returned is the block from which Geth has started indexing. Running the GQL queries below with blocks before the returned block number will not return results in the watcher.

• Run the watcher:

  docker-compose --profile watcher up -d --build

• The isMember and isPhisher maps should be indexed (including old mainnet blocks). Check the mobymask-watcher database tables is_phisher and is_member:

  docker-compose exec watcher-db psql -U vdbm mobymask-watcher -c "SELECT block_hash, block_number, contract_address, key0, value FROM is_member"

  docker-compose exec watcher-db psql -U vdbm mobymask-watcher -c "SELECT block_hash, block_number, contract_address, key0, value FROM is_phisher"

  NOTE: The GQL query below will also work with the block hashes returned above.

• Run the following GQL queries in GraphQL endpoint with the existing phisher and member names:

  query {
    isPhisher(
      blockHash: "LATEST_BLOCK_HASH"
      contractAddress: "0xB06E6DB9288324738f04fCAAc910f5A60102C1F8",
      key0: "PHISHER_NAME"
    ) {
      value
      proof {
        data
      }
    }
  
    isMember(
      blockHash: "LATEST_BLOCK_HASH"
      contractAddress: "0xB06E6DB9288324738f04fCAAc910f5A60102C1F8"
      key0: "MEMBER_NAME"
    ) {
      value
      proof {
        data
      }
    }
  }

  This query lazily fetches the contract data from ipld-eth-server.

Reset

• Reset databases:

  docker-compose down -v