Merge pull request #1302 from ethereum-optimism/annie/replica-healthcheck

feat: migrate and refactor replica-healthcheck from op-replica

.changeset/thick-peaches-learn.md

+---
+'@eth-optimism/replica-healthcheck': minor
+---
+
+Add replica-healthcheck to monorepo

.github/CODEOWNERS

@@ -15,4 +15,5 @@
 # packages/message-relayer/           @K-Ho
 # packages/batch-submitter/           @annieke @karlfloersch
 # packages/data-transport-layer/      @annieke
+# packages/replica-healthcheck/       @annieke
 # integration-tests/                  @tynes

README.md

@@ -32,6 +32,7 @@ Extensive documentation is available [here](http://community.optimism.io/docs/).
   * [`data-transport-layer`](./packages/data-transport-layer): Event indexer, allowing the `l2geth` node to access L1 data
   * [`batch-submitter`](./packages/batch-submitter): Daemon for submitting L2 transaction and state root batches to L1
   * [`message-relayer`](./packages/message-relayer): Service for relaying L2 messages to L1
+  * [`replica-healthcheck`](./packages/replica-healthcheck): Service to monitor the health of different replica deployments
 * [`l2geth`](./l2geth): Fork of [go-ethereum v1.9.10](https://github.com/ethereum/go-ethereum/tree/v1.9.10) implementing the [OVM](https://research.paradigm.xyz/optimism#optimistic-geth).
 * [`integration-tests`](./integration-tests): Integration tests between a L1 testnet, `l2geth`,
 * [`ops`](./ops): Contains Dockerfiles for containerizing each service involved in the protocol,

ops/docker/Dockerfile.monorepo

@@ -32,6 +32,7 @@ COPY packages/contracts/package.json ./packages/contracts/package.json
 COPY packages/data-transport-layer/package.json ./packages/data-transport-layer/package.json
 COPY packages/batch-submitter/package.json ./packages/batch-submitter/package.json
 COPY packages/message-relayer/package.json ./packages/message-relayer/package.json
+COPY packages/replica-healthcheck/package.json ./packages/replica-healthcheck/package.json
 COPY integration-tests/package.json ./integration-tests/package.json
 
 RUN yarn install --frozen-lockfile

packages/replica-healthcheck/.env.example

+REPLICA_HEALTHCHECK__ETH_NETWORK=mainnet
+REPLICA_HEALTHCHECK__ETH_NETWORK_RPC_PROVIDER=https://mainnet.optimism.io
+REPLICA_HEALTHCHECK__ETH_REPLICA_RPC_PROVIDER=http://localhost:9991
+REPLICA_HEALTHCHECK__L2GETH_IMAGE_TAG=0.4.7

packages/replica-healthcheck/.eslintrc.js

+module.exports = {
+  extends: '../../.eslintrc.js',
+}

packages/replica-healthcheck/.gitignore

+node_modules/
+build/
\ No newline at end of file

packages/replica-healthcheck/.lintstagedrc.yml

+"*.{ts,js}":
+  - eslint

packages/replica-healthcheck/.prettierrc.js

+module.exports = {
+  ...require('../../.prettierrc.js'),
+};
\ No newline at end of file

packages/replica-healthcheck/LICENSE

+(The MIT License)
+
+Copyright 2020-2021 Optimism
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

packages/replica-healthcheck/README.md

+# @eth-optimism/replica-healthcheck
+
+## What is this?
+
+`replica-healthcheck` is an express server to be run alongside a replica instance, to ensure that the replica is healthy. Currently, it exposes metrics on syncing stats and exits when the replica has a mismatched state root against the sequencer.
+
+## Getting started
+
+### Building and usage
+
+After cloning and switching to the repository, install dependencies:
+
+```bash
+$ yarn
+```
+
+Use the following commands to build, use, test, and lint:
+
+```bash
+$ yarn build
+$ yarn start
+$ yarn test
+$ yarn lint
+```
+
+### Configuration
+
+We're using `dotenv` for our configuration.
+To configure the project, clone this repository and copy the `env.example` file to `.env`.
+Here's a list of environment variables:
+
+| Variable                                        | Purpose                                                  | Default                                                                                  |
+| ----------------------------------------------- | -------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
+| REPLICA_HEALTHCHECK\_\_ETH_NETWORK              | Ethereum Layer1 and Layer2 network (mainnet,kovan)       | mainnet (change to `kovan` for the test network)                                         |
+| REPLICA_HEALTHCHECK\_\_ETH_NETWORK_RPC_PROVIDER | Layer2 source of truth endpoint, used for the sync check | https://mainnet.optimism.io (change to `https://kovan.optimism.io` for the test network) |
+| REPLICA_HEALTHCHECK\_\_ETH_REPLICA_RPC_PROVIDER | Layer2 local replica endpoint, used for the sync check   | http://localhost:9991                                                                    |
+| REPLICA_HEALTHCHECK\_\_L2GETH_IMAGE_TAG         | L2geth version                                           | 0.4.                                                                                     |

packages/replica-healthcheck/package.json

+{
+  "name": "@eth-optimism/replica-healthcheck",
+  "version": "0.1.0",
+  "private": true,
+  "main": "dist/index",
+  "files": [
+    "dist/index"
+  ],
+  "types": "dist/index",
+  "author": "Optimism PBC",
+  "license": "MIT",
+  "scripts": {
+    "clean": "rimraf ./dist ./tsconfig.build.tsbuildinfo",
+    "lint": "yarn run lint:fix && yarn run lint:check",
+    "lint:fix": "yarn lint:check --fix",
+    "lint:check": "eslint .",
+    "build": "tsc -p tsconfig.build.json",
+    "pre-commit": "lint-staged",
+    "test": "ts-mocha test/*.spec.ts",
+    "start": "ts-node ./src/exec/run-healthcheck-server.ts"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.12",
+    "@types/node": "^15.12.2",
+    "dotenv": "^10.0.0",
+    "supertest": "^6.1.4",
+    "ts-mocha": "^8.0.0",
+    "ts-node": "^10.0.0",
+    "typescript": "^4.3.2"
+  },
+  "dependencies": {
+    "@eth-optimism/common-ts": "0.1.5",
+    "@eth-optimism/core-utils": "^0.5.1",
+    "ethers": "^5.3.0",
+    "express": "^4.17.1",
+    "express-prom-bundle": "^6.3.6",
+    "prom-client": "^13.1.0"
+  }
+}

packages/replica-healthcheck/src/exec/run-healthcheck-server.ts

+import * as dotenv from 'dotenv'
+
+import { HealthcheckServer, readConfig } from '..'
+;(async () => {
+  dotenv.config()
+
+  const healthcheckServer = new HealthcheckServer(readConfig())
+
+  healthcheckServer.init()
+  await healthcheckServer.runSyncCheck()
+})().catch((err) => {
+  console.log(err)
+  process.exit(1)
+})

packages/replica-healthcheck/src/healthcheck-server.ts

+import express from 'express'
+import { Server } from 'net'
+import promBundle from 'express-prom-bundle'
+import { Gauge } from 'prom-client'
+import { providers } from 'ethers'
+import { Metrics, Logger } from '@eth-optimism/common-ts'
+import { injectL2Context, sleep } from '@eth-optimism/core-utils'
+
+import { binarySearchForMismatch } from './helpers'
+
+export interface HealthcheckServerOptions {
+  network: string
+  gethRelease: string
+  sequencerRpcProvider: string
+  replicaRpcProvider: string
+  logger: Logger
+}
+
+export interface ReplicaMetrics {
+  lastMatchingStateRootHeight: Gauge<string>
+  replicaHeight: Gauge<string>
+  sequencerHeight: Gauge<string>
+}
+
+export class HealthcheckServer {
+  protected options: HealthcheckServerOptions
+  protected app: express.Express
+  protected logger: Logger
+  protected metrics: ReplicaMetrics
+  server: Server
+
+  constructor(options: HealthcheckServerOptions) {
+    this.options = options
+    this.app = express()
+    this.logger = options.logger
+  }
+
+  init = () => {
+    this.metrics = this.initMetrics()
+    this.server = this.initServer()
+  }
+
+  initMetrics = (): ReplicaMetrics => {
+    const metrics = new Metrics({
+      labels: {
+        network: this.options.network,
+        gethRelease: this.options.gethRelease,
+      },
+    })
+    const metricsMiddleware = promBundle({
+      includeMethod: true,
+      includePath: true,
+    })
+    this.app.use(metricsMiddleware)
+
+    return {
+      lastMatchingStateRootHeight: new metrics.client.Gauge({
+        name: 'replica_health_last_matching_state_root_height',
+        help: 'Height of last matching state root of replica',
+        registers: [metrics.registry],
+      }),
+      replicaHeight: new metrics.client.Gauge({
+        name: 'replica_health_height',
+        help: 'Block number of the latest block from the replica',
+        registers: [metrics.registry],
+      }),
+      sequencerHeight: new metrics.client.Gauge({
+        name: 'replica_health_sequencer_height',
+        help: 'Block number of the latest block from the sequencer',
+        registers: [metrics.registry],
+      }),
+    }
+  }
+
+  initServer = (): Server => {
+    this.app.get('/', (req, res) => {
+      res.send(`
+        <head><title>Replica healthcheck</title></head>
+        <body>
+        <h1>Replica healthcheck</h1>
+        <p><a href="/metrics">Metrics</a></p>
+        </body>
+        </html>
+      `)
+    })
+
+    const server = this.app.listen(3000, () => {
+      this.logger.info('Listening on port 3000')
+    })
+
+    return server
+  }
+
+  runSyncCheck = async () => {
+    throw new Error('trial')
+    const sequencerProvider = injectL2Context(
+      new providers.JsonRpcProvider(this.options.sequencerRpcProvider)
+    )
+    const replicaProvider = injectL2Context(
+      new providers.JsonRpcBatchProvider(this.options.replicaRpcProvider)
+    )
+
+    // Continuously loop while replica runs
+    while (true) {
+      let replicaLatest = (await replicaProvider.getBlock('latest')) as any
+      const sequencerCorresponding = (await sequencerProvider.getBlock(
+        replicaLatest.number
+      )) as any
+
+      if (replicaLatest.stateRoot !== sequencerCorresponding.stateRoot) {
+        this.logger.error(
+          'Latest replica state root is mismatched from sequencer'
+        )
+        const firstMismatch = await binarySearchForMismatch(
+          sequencerProvider,
+          replicaProvider,
+          replicaLatest.number,
+          this.logger
+        )
+        this.logger.error('First state root mismatch found', {
+          blockNumber: firstMismatch,
+        })
+        this.metrics.lastMatchingStateRootHeight.set(firstMismatch)
+
+        throw new Error('Replica state root mismatched')
+      }
+
+      this.logger.info('State roots matching', {
+        blockNumber: replicaLatest.number,
+      })
+      this.metrics.lastMatchingStateRootHeight.set(replicaLatest.number)
+
+      replicaLatest = await replicaProvider.getBlock('latest')
+      const sequencerLatest = await sequencerProvider.getBlock('latest')
+      this.logger.info('Syncing from sequencer', {
+        sequencerHeight: sequencerLatest.number,
+        replicaHeight: replicaLatest.number,
+        heightDifference: sequencerLatest.number - replicaLatest.number,
+      })
+
+      this.metrics.replicaHeight.set(replicaLatest.number)
+      this.metrics.sequencerHeight.set(sequencerLatest.number)
+      // Fetch next block and sleep if not new
+      while (replicaLatest.number === sequencerCorresponding.number) {
+        this.logger.info(
+          'Replica caught up with sequencer, waiting for next block'
+        )
+        await sleep(1_000)
+        replicaLatest = await replicaProvider.getBlock('latest')
+      }
+    }
+  }
+}

packages/replica-healthcheck/src/helpers.ts

+import { providers } from 'ethers'
+import { Logger } from '@eth-optimism/common-ts'
+
+import { HealthcheckServerOptions } from './healthcheck-server'
+
+export const readEnvOrQuitProcess = (envName: string | undefined): string => {
+  if (!process.env[envName]) {
+    console.error(`Missing environment variable: ${envName}`)
+    process.exit(1)
+  }
+  return process.env[envName]
+}
+
+export const readConfig = (): HealthcheckServerOptions => {
+  const network = readEnvOrQuitProcess('REPLICA_HEALTHCHECK__ETH_NETWORK')
+  const gethRelease = readEnvOrQuitProcess(
+    'REPLICA_HEALTHCHECK__L2GETH_IMAGE_TAG'
+  )
+  const sequencerRpcProvider = readEnvOrQuitProcess(
+    'REPLICA_HEALTHCHECK__ETH_NETWORK_RPC_PROVIDER'
+  )
+  const replicaRpcProvider = readEnvOrQuitProcess(
+    'REPLICA_HEALTHCHECK__ETH_REPLICA_RPC_PROVIDER'
+  )
+
+  if (!['mainnet', 'kovan', 'goerli'].includes(network)) {
+    console.error(
+      'Invalid ETH_NETWORK specified. Must be one of mainnet, kovan, or goerli'
+    )
+    process.exit(1)
+  }
+
+  const logger = new Logger({ name: 'replica-healthcheck' })
+
+  return {
+    network,
+    gethRelease,
+    sequencerRpcProvider,
+    replicaRpcProvider,
+    logger,
+  }
+}
+
+export const binarySearchForMismatch = async (
+  sequencerProvider: providers.JsonRpcProvider,
+  replicaProvider: providers.JsonRpcProvider,
+  latest: number,
+  logger: Logger
+): Promise<number> => {
+  logger.info(
+    'Executing a binary search to determine the first mismatched block...'
+  )
+
+  let start = 0
+  let end = latest
+  while (start !== end) {
+    const middle = Math.floor((start + end) / 2)
+
+    logger.info('Checking block', { blockNumber: middle })
+    const [replicaBlock, sequencerBlock] = await Promise.all([
+      replicaProvider.getBlock(middle) as any,
+      sequencerProvider.getBlock(middle) as any,
+    ])
+
+    if (replicaBlock.stateRoot === sequencerBlock.stateRoot) {
+      logger.info('State roots still matching', { blockNumber: middle })
+      start = middle
+    } else {
+      logger.error('Found mismatched state roots', {
+        blockNumber: middle,
+        sequencerBlock,
+        replicaBlock,
+      })
+
+      end = middle
+    }
+  }
+
+  return end
+}

packages/replica-healthcheck/src/index.ts

+export * from './healthcheck-server'
+export * from './helpers'

packages/replica-healthcheck/test/healthcheck-server.spec.ts

+import request from 'supertest'
+// Setup
+import chai = require('chai')
+const expect = chai.expect
+import { Logger } from '@eth-optimism/common-ts'
+
+import { HealthcheckServer } from '../src/healthcheck-server'
+
+describe('HealthcheckServer', () => {
+  it('shoud serve correct metrics', async () => {
+    const logger = new Logger({ name: 'test_logger' })
+    const healthcheckServer = new HealthcheckServer({
+      network: 'kovan',
+      gethRelease: '0.4.20',
+      sequencerRpcProvider: 'http://sequencer.io',
+      replicaRpcProvider: 'http://replica.io',
+      logger,
+    })
+
+    try {
+      await healthcheckServer.init()
+      // Verify that the registered metrics are served at `/`
+      const response = await request(healthcheckServer.server)
+        .get('/metrics')
+        .send()
+      expect(response.status).eq(200)
+      expect(response.text).match(/replica_health_height gauge/)
+    } finally {
+      healthcheckServer.server.close()
+    }
+  })
+})

packages/replica-healthcheck/tsconfig.build.json

+{
+  "extends": "../../tsconfig.build.json",
+
+  "compilerOptions": {
+    "rootDir": "./src",
+    "outDir": "./dist"
+  },
+
+  "include": [
+    "src/**/*"
+  ]
+}

packages/replica-healthcheck/tsconfig.json

+{
+  "extends": "../../tsconfig.json"
+}

yarn.lock

@@ -749,6 +749,15 @@
     "@ethersproject/logger" "^5.4.0"
     bn.js "^4.11.9"
 
+"@ethersproject/bignumber@5.4.1":
+  version "5.4.1"
+  resolved "https://registry.yarnpkg.com/@ethersproject/bignumber/-/bignumber-5.4.1.tgz#64399d3b9ae80aa83d483e550ba57ea062c1042d"
+  integrity sha512-fJhdxqoQNuDOk6epfM7yD6J8Pol4NUCy1vkaGAkuujZm0+lNow//MKu1hLhRiYV4BsOHyBv5/lsTjF+7hWwhJg==
+  dependencies:
+    "@ethersproject/bytes" "^5.4.0"
+    "@ethersproject/logger" "^5.4.0"
+    bn.js "^4.11.9"
+
 "@ethersproject/bytes@5.4.0", "@ethersproject/bytes@>=5.0.0-beta.129", "@ethersproject/bytes@^5.0.0", "@ethersproject/bytes@^5.0.4", "@ethersproject/bytes@^5.4.0":
   version "5.4.0"
   resolved "https://registry.yarnpkg.com/@ethersproject/bytes/-/bytes-5.4.0.tgz#56fa32ce3bf67153756dbaefda921d1d4774404e"
@@ -862,6 +871,13 @@
   dependencies:
     "@ethersproject/logger" "^5.4.0"
 
+"@ethersproject/networks@5.4.1":
+  version "5.4.1"
+  resolved "https://registry.yarnpkg.com/@ethersproject/networks/-/networks-5.4.1.tgz#2ce83b8e42aa85216e5d277a7952d97b6ce8d852"
+  integrity sha512-8SvowCKz9Uf4xC5DTKI8+il8lWqOr78kmiqAVLYT9lzB8aSmJHQMD1GSuJI0CW4hMAnzocpGpZLgiMdzsNSPig==
+  dependencies:
+    "@ethersproject/logger" "^5.4.0"
+
 "@ethersproject/pbkdf2@5.4.0", "@ethersproject/pbkdf2@^5.0.0", "@ethersproject/pbkdf2@^5.4.0":
   version "5.4.0"
   resolved "https://registry.yarnpkg.com/@ethersproject/pbkdf2/-/pbkdf2-5.4.0.tgz#ed88782a67fda1594c22d60d0ca911a9d669641c"
@@ -902,6 +918,31 @@
     bech32 "1.1.4"
     ws "7.4.6"
 
+"@ethersproject/providers@5.4.2":
+  version "5.4.2"
+  resolved "https://registry.yarnpkg.com/@ethersproject/providers/-/providers-5.4.2.tgz#73df9767869a31bd88d9e27e78cff96364b8fbed"
+  integrity sha512-Qr8Am8hlj2gL9HwNymhFlYd52MQVVEBLoDwPxhv4ASeyNpaoRiUAQnNEuE6SnEQtiwYkpLrQtSALNLUSeyuvjA==
+  dependencies:
+    "@ethersproject/abstract-provider" "^5.4.0"
+    "@ethersproject/abstract-signer" "^5.4.0"
+    "@ethersproject/address" "^5.4.0"
+    "@ethersproject/basex" "^5.4.0"
+    "@ethersproject/bignumber" "^5.4.0"
+    "@ethersproject/bytes" "^5.4.0"
+    "@ethersproject/constants" "^5.4.0"
+    "@ethersproject/hash" "^5.4.0"
+    "@ethersproject/logger" "^5.4.0"
+    "@ethersproject/networks" "^5.4.0"
+    "@ethersproject/properties" "^5.4.0"
+    "@ethersproject/random" "^5.4.0"
+    "@ethersproject/rlp" "^5.4.0"
+    "@ethersproject/sha2" "^5.4.0"
+    "@ethersproject/strings" "^5.4.0"
+    "@ethersproject/transactions" "^5.4.0"
+    "@ethersproject/web" "^5.4.0"
+    bech32 "1.1.4"
+    ws "7.4.6"
+
 "@ethersproject/random@5.4.0", "@ethersproject/random@^5.0.0", "@ethersproject/random@^5.4.0":
   version "5.4.0"
   resolved "https://registry.yarnpkg.com/@ethersproject/random/-/random-5.4.0.tgz#9cdde60e160d024be39cc16f8de3b9ce39191e16"
@@ -2376,6 +2417,26 @@
     "@truffle/interface-adapter" "^0.5.1"
     web3 "1.3.6"
 
+"@tsconfig/node10@^1.0.7":
+  version "1.0.8"
+  resolved "https://registry.yarnpkg.com/@tsconfig/node10/-/node10-1.0.8.tgz#c1e4e80d6f964fbecb3359c43bd48b40f7cadad9"
+  integrity sha512-6XFfSQmMgq0CFLY1MslA/CPUfhIL919M1rMsa5lP2P097N2Wd1sSX0tx1u4olM16fLNhtHZpRhedZJphNJqmZg==
+
+"@tsconfig/node12@^1.0.7":
+  version "1.0.9"
+  resolved "https://registry.yarnpkg.com/@tsconfig/node12/-/node12-1.0.9.tgz#62c1f6dee2ebd9aead80dc3afa56810e58e1a04c"
+  integrity sha512-/yBMcem+fbvhSREH+s14YJi18sp7J9jpuhYByADT2rypfajMZZN4WQ6zBGgBKp53NKmqI36wFYDb3yaMPurITw==
+
+"@tsconfig/node14@^1.0.0":
+  version "1.0.1"
+  resolved "https://registry.yarnpkg.com/@tsconfig/node14/-/node14-1.0.1.tgz#95f2d167ffb9b8d2068b0b235302fafd4df711f2"
+  integrity sha512-509r2+yARFfHHE7T6Puu2jjkoycftovhXRqW328PDXTVGKihlb1P8Z9mMZH04ebyajfRY7dedfGynlrFHJUQCg==
+
+"@tsconfig/node16@^1.0.1":
+  version "1.0.2"
+  resolved "https://registry.yarnpkg.com/@tsconfig/node16/-/node16-1.0.2.tgz#423c77877d0569db20e1fc80885ac4118314010e"
+  integrity sha512-eZxlbI8GZscaGS7kkc/trHTT5xgrjH3/1n2JDwusC9iahPKWMRvRjJSAN5mCXviuTGQ/lHnhvv8Q1YTpnfz9gA==
+
 "@typechain/ethers-v5@1.0.0":
   version "1.0.0"
   resolved "https://registry.yarnpkg.com/@typechain/ethers-v5/-/ethers-v5-1.0.0.tgz#9156c9a2b078f9bb00a339631221e42c26b218df"
@@ -2494,6 +2555,16 @@
     "@types/qs" "*"
     "@types/serve-static" "*"
 
+"@types/express@^4.17.12":
+  version "4.17.13"
+  resolved "https://registry.yarnpkg.com/@types/express/-/express-4.17.13.tgz#a76e2995728999bab51a33fabce1d705a3709034"
+  integrity sha512-6bSZTPaTIACxn48l50SR+axgrqm6qXFIxrdAKaG6PaJk3+zuUr35hBlgT7vOmJcum+OEaIBLtHV/qloEAFITeA==
+  dependencies:
+    "@types/body-parser" "*"
+    "@types/express-serve-static-core" "^4.17.18"
+    "@types/qs" "*"
+    "@types/serve-static" "*"
+
 "@types/form-data@0.0.33":
   version "0.0.33"
   resolved "https://registry.yarnpkg.com/@types/form-data/-/form-data-0.0.33.tgz#c9ac85b2a5fd18435b8c85d9ecb50e6d6c893ff8"
@@ -2604,6 +2675,11 @@
   resolved "https://registry.yarnpkg.com/@types/node/-/node-12.20.15.tgz#10ee6a6a3f971966fddfa3f6e89ef7a73ec622df"
   integrity sha512-F6S4Chv4JicJmyrwlDkxUdGNSplsQdGwp1A0AJloEVDirWdZOAiRHhovDlsFkKUrquUXhz1imJhXHsf59auyAg==
 
+"@types/node@^15.12.2":
+  version "15.14.4"
+  resolved "https://registry.yarnpkg.com/@types/node/-/node-15.14.4.tgz#aaf18436ef67f24676d92b8bbe0f5f41b08db3e8"
+  integrity sha512-yblJrsfCxdxYDUa2fM5sP93ZLk5xL3/+3MJei+YtsNbIdY75ePy2AiCfpq+onepzax+8/Yv+OD/fLNleWpCzVg==
+
 "@types/node@^8.0.0":
   version "8.10.66"
   resolved "https://registry.yarnpkg.com/@types/node/-/node-8.10.66.tgz#dd035d409df322acc83dff62a602f12a5783bbb3"
@@ -6784,6 +6860,42 @@ ethers@^5.0.0, ethers@^5.0.1, ethers@^5.0.2, ethers@^5.0.26, ethers@^5.0.31, eth
     "@ethersproject/web" "5.4.0"
     "@ethersproject/wordlists" "5.4.0"
 
+ethers@^5.3.0:
+  version "5.4.2"
+  resolved "https://registry.yarnpkg.com/ethers/-/ethers-5.4.2.tgz#91368e4d9c39f1111157de1c2aa1d8c1616c0f7b"
+  integrity sha512-JcFcNWjULzhm4tMp5cZKnU45zqN/c7rqabIITiUiQzZuP7LcYSD4WAbADo4Ja6G2orU4d/PbhAWGHGtAKYrB4Q==
+  dependencies:
+    "@ethersproject/abi" "5.4.0"
+    "@ethersproject/abstract-provider" "5.4.0"
+    "@ethersproject/abstract-signer" "5.4.0"
+    "@ethersproject/address" "5.4.0"
+    "@ethersproject/base64" "5.4.0"
+    "@ethersproject/basex" "5.4.0"
+    "@ethersproject/bignumber" "5.4.1"
+    "@ethersproject/bytes" "5.4.0"
+    "@ethersproject/constants" "5.4.0"
+    "@ethersproject/contracts" "5.4.0"
+    "@ethersproject/hash" "5.4.0"
+    "@ethersproject/hdnode" "5.4.0"
+    "@ethersproject/json-wallets" "5.4.0"
+    "@ethersproject/keccak256" "5.4.0"
+    "@ethersproject/logger" "5.4.0"
+    "@ethersproject/networks" "5.4.1"
+    "@ethersproject/pbkdf2" "5.4.0"
+    "@ethersproject/properties" "5.4.0"
+    "@ethersproject/providers" "5.4.2"
+    "@ethersproject/random" "5.4.0"
+    "@ethersproject/rlp" "5.4.0"
+    "@ethersproject/sha2" "5.4.0"
+    "@ethersproject/signing-key" "5.4.0"
+    "@ethersproject/solidity" "5.4.0"
+    "@ethersproject/strings" "5.4.0"
+    "@ethersproject/transactions" "5.4.0"
+    "@ethersproject/units" "5.4.0"
+    "@ethersproject/wallet" "5.4.0"
+    "@ethersproject/web" "5.4.0"
+    "@ethersproject/wordlists" "5.4.0"
+
 ethjs-unit@0.1.6:
   version "0.1.6"
   resolved "https://registry.yarnpkg.com/ethjs-unit/-/ethjs-unit-0.1.6.tgz#c665921e476e87bce2a9d588a6fe0405b2c41699"
@@ -13670,6 +13782,14 @@ supertest@^6.1.3:
     methods "^1.1.2"
     superagent "^6.1.0"
 
+supertest@^6.1.4:
+  version "6.1.4"
+  resolved "https://registry.yarnpkg.com/supertest/-/supertest-6.1.4.tgz#ea8953343e0ca316e80e975b39340934f754eb06"
+  integrity sha512-giC9Zm+Bf1CZP09ciPdUyl+XlMAu6rbch79KYiYKOGcbK2R1wH8h+APul1i/3wN6RF1XfWOIF+8X1ga+7SBrug==
+  dependencies:
+    methods "^1.1.2"
+    superagent "^6.1.0"
+
 supports-color@6.0.0:
   version "6.0.0"
   resolved "https://registry.yarnpkg.com/supports-color/-/supports-color-6.0.0.tgz#76cfe742cf1f41bb9b1c29ad03068c05b4c0e40a"
@@ -14127,6 +14247,22 @@ ts-node@7.0.1:
     source-map-support "^0.5.6"
     yn "^2.0.0"
 
+ts-node@^10.0.0:
+  version "10.1.0"
+  resolved "https://registry.yarnpkg.com/ts-node/-/ts-node-10.1.0.tgz#e656d8ad3b61106938a867f69c39a8ba6efc966e"
+  integrity sha512-6szn3+J9WyG2hE+5W8e0ruZrzyk1uFLYye6IGMBadnOzDh8aP7t8CbFpsfCiEx2+wMixAhjFt7lOZC4+l+WbEA==
+  dependencies:
+    "@tsconfig/node10" "^1.0.7"
+    "@tsconfig/node12" "^1.0.7"
+    "@tsconfig/node14" "^1.0.0"
+    "@tsconfig/node16" "^1.0.1"
+    arg "^4.1.0"
+    create-require "^1.1.0"
+    diff "^4.0.1"
+    make-error "^1.1.1"
+    source-map-support "^0.5.17"
+    yn "3.1.1"
+
 ts-node@^8.0.2:
   version "8.10.2"
   resolved "https://registry.yarnpkg.com/ts-node/-/ts-node-8.10.2.tgz#eee03764633b1234ddd37f8db9ec10b75ec7fb8d"
@@ -14331,7 +14467,7 @@ typescript@^4.2.3, typescript@^4.3.4:
   resolved "https://registry.yarnpkg.com/typescript/-/typescript-4.3.4.tgz#3f85b986945bcf31071decdd96cf8bfa65f9dcbc"
   integrity sha512-uauPG7XZn9F/mo+7MrsRjyvbxFpzemRjKEZXS4AK83oP2KKOJPvb+9cO/gmnv8arWZvhnjVOXz7B49m1l0e9Ew==
 
-typescript@^4.3.5:
+typescript@^4.3.2, typescript@^4.3.5:
   version "4.3.5"
   resolved "https://registry.yarnpkg.com/typescript/-/typescript-4.3.5.tgz#4d1c37cc16e893973c45a06886b7113234f119f4"
   integrity sha512-DqQgihaQ9cUrskJo9kIyW/+g0Vxsk8cDtZ52a3NGh0YNTfpUSArXSohyUGnvbPazEPLu398C0UxmKSOrPumUzA==