feat: add mellow-vaults bot scaffold

.github/CODEOWNERS

@@ -13,7 +13,7 @@
 /ethereum-financial/ @lidofinance/lido-eth-protocol
 /arb-subgraph/ @lidofinance/lido-si
 /ethereum-governance/ @lidofinance/lido-dao-ops-team
-/ethereum-governance-v2/ @lidofinance/lido-dao-ops-team
+/mellow-vaults/ @lidofinance/lido-dao-ops-team
 /multisig-watcher/ @lidofinance/lido-dao-ops-team
 /voting-watcher/ @lidofinance/lido-dao-ops-team
 /ethereum-validators-set/ @lidofinance/lido-valset-tech

ethereum-governance/src/services/acl-changes/AclChanges.spec.ts

@@ -133,7 +133,7 @@ describe('AclChangesSrv', () => {
     jest.spyOn(ethProvider, 'getContractOwner').mockResolvedValue(E.left(new Error('Test error')))
     const finding = networkAlert(
       new Error('Test error'),
-      `Error in AclChangesSrv.handleOwnerChange (uid:790dc305)`,
+      `Error in AclChangesSrv.handleOwnerChange (uid:3197e652)`,
       `Could not call ethProvider.getOwner for address - ${dsAddress}`,
     )
 

ethereum-governance/src/services/acl-changes/AclChanges.srv.ts

@@ -176,7 +176,7 @@ export class AclChangesSrv {
         out.push(
           networkAlert(
             curOwner.left,
-            `Error in ${AclChangesSrv.name}.${this.handleOwnerChange.name} (uid:790dc305)`,
+            `Error in ${AclChangesSrv.name}.${this.handleOwnerChange.name} (uid:3197e652)`,
             `Could not call ethProvider.getOwner for address - ${address}`,
           ),
         )

ethereum-governance/tests/e2e/agent-acl-changes.spec.ts

@@ -5,7 +5,7 @@ import { roleByName } from '../../src/shared/string'
 import { App } from '../../src/app'
 import { createTransactionEvent } from './utils'
 import * as E from 'fp-ts/Either'
-import { ORACLE_DAEMON_CONFIG_ADDRESS } from 'constants/common'
+import { ORACLE_DAEMON_CONFIG_ADDRESS } from '../../src/shared/constants/common/mainnet'
 
 const TEST_TIMEOUT = 60_000 // ms
 

mellow-vaults/.dockerignore

@@ -0,0 +1,3 @@
+node_modules/
+dist/
+forta.config.json

mellow-vaults/.eslintrc.json

@@ -0,0 +1,14 @@
+{
+  "parser": "@typescript-eslint/parser",
+  "extends": ["eslint:recommended", "plugin:@typescript-eslint/recommended", "prettier"],
+  "plugins": ["@typescript-eslint", "prettier"],
+  "env": {
+    "node": true,
+    "es6": true
+  },
+  "rules": {
+    "prettier/prettier": "error",
+    "curly": "error",
+    "semi": "off"
+  }
+}

mellow-vaults/.gitignore

@@ -0,0 +1,10 @@
+node_modules
+dist
+forta.config.json
+.yarn/*
+!.yarn/releases/
+*.log
+version.json
+.DS_Store
+/coverage/
+/src/generated/

mellow-vaults/.nvmrc

@@ -0,0 +1 @@
+v20.10.0

mellow-vaults/.prettierrc.json

@@ -0,0 +1,7 @@
+{
+  "semi": false,
+  "trailingComma": "all",
+  "singleQuote": true,
+  "printWidth": 120,
+  "tabWidth": 2
+}

mellow-vaults/Dockerfile

@@ -0,0 +1,22 @@
+# Build stage: compile Typescript to Javascript
+FROM node:20.10.0-alpine3.18 AS builder
+
+WORKDIR /app
+
+COPY . .
+RUN yarn install --immutable && yarn run build
+# Build app
+RUN yarn run build
+
+# Final stage: copy compiled Javascript from previous stage and run the app
+FROM node:20.10.0-alpine3.18 as production
+LABEL "network.forta.settings.agent-logs.enable"="true"
+ENV NODE_ENV=production
+WORKDIR /app
+
+COPY package*.json yarn.lock ./
+COPY --from=builder /app/node_modules ./node_modules
+COPY --from=builder /app/dist ./src
+COPY version.json ./
+
+CMD ["yarn", "run", "start:prod"]

mellow-vaults/README.md

@@ -0,0 +1,69 @@
+# Lido x Mellow Detection Bot for Forta
+
+## Supported chains
+
+- Ethereum mainnet
+
+## Alerts
+
+1. Vault operations
+   1. HandleBlock
+      1. 🚨🚨🚨 Vault vaultTotalSupply and vaultUnderlyingTvl is not the same
+      2. 🚨🚨🚨 Vault totalSupply more than maximalTotalSupply
+      3. 🚨🚨🚨 Vault critical storage slot value changed
+      4. 🚨 Vault critical storage not loaded
+      5. ⚠️ Vault withdrawals haven’t been called for at least 48 hours
+      6. ⚠️ Vault totalSupply close to maximalTotalSupply (every 1800 blocks)
+      7. ⚠️ Vault totalSupply reached maximalTotalSupply (every 1800 blocks)
+   2. HandleTransaction
+      1. 🚨 Vault: Role Admin changed
+      2. 🚨 Vault: Role revoked
+      3. 🚨 Vault: Role granted
+      4. ⚠️ Vault: Symbiotic limit increased
+      5. ⚠️ Vault: Symbiotic limit reached
+      6. ⚠️ Vault: Withdrawals haven’t been called for at least 48 hours
+      7. ⚠️ Vault: Withdrawal partial
+      8. ℹ️ Vault: Withdrawal all
+2. Multisig
+   1. HandleTransaction
+      1. ⚠️ Gnosis Safe: Owner added
+      2. ⚠️ Gnosis Safe: Owner removed
+      3. ⚠️ Gnosis Safe: Fallback handler changed
+      4. ⚠️ Gnosis Safe: Guard changed
+      5. ⚠️ Gnosis Safe: Threshold changed
+      6. ⚠️ Gnosis Safe: Module disabled
+      7. ⚠️ Gnosis Safe: Module enabled
+      8. ℹ️ ❌ Gnosis Safe: TX Execution failed
+      9. ℹ️ ✅ Gnosis Safe: TX Executed
+      10. ℹ️ ❌ Gnosis Safe: Execution failed from module
+      11. ℹ️ ✅ Gnosis Safe: Execution success from module
+3. ACL
+   1. HandleBlock
+      1. 🚨🚨🚨 Vault Contract owner set to EOA 🚨🚨🚨
+      2. 🚨 Vault Contract owner set to address not in whitelist
+
+## Development
+
+Install deps:
+
+```
+yarn install
+```
+
+### Mainnet
+
+Edit `alerting-forta/<SUBMODULE>/forta.config.json` and set `jsonRpcUrl` to your Mainnet JSON-RPC provider.
+
+Running in a live mode:
+
+```
+yarn start:dev
+```
+
+Testing on a specific block/range/transaction:
+
+```
+yarn block 20061166
+yarn range '20061165..20061166'
+yarn tx 0xb8b96ee47cadb80ec41dafceba1fe5b10b1d50b75e7ad9114ee16180bda2d2b4
+```

mellow-vaults/jest.config.js

@@ -0,0 +1,10 @@
+/** @type {import("ts-jest").JestConfigWithTsJest} */
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  testPathIgnorePatterns: ['dist'],
+  moduleNameMapper: {
+    'constants/common': '<rootDir>/src/shared/constants/common/mainnet',
+    'constants/acl-changes': '<rootDir>/src/shared/constants/acl-changes/mainnet',
+  },
+}

mellow-vaults/package.json

@@ -0,0 +1,97 @@
+{
+  "name": "lido-mellow-vaults-forta-bot",
+  "version": "1.0.0",
+  "description": "Forta Bot for Mellow Vault",
+  "repository": {
+    "type": "git",
+    "directory": "https://github.com/lidofinance/alerting-forta/tree/main/mellow-vaults"
+  },
+  "license": "MIT",
+  "chainIds": [
+    1
+  ],
+  "chainSettings": {
+    "default": {
+      "shards": 1,
+      "target": 5
+    }
+  },
+  "husky": {
+    "hooks": {
+      "pre-commit": "yarn run lint"
+    }
+  },
+  "scripts": {
+    "update-version": "node ../utils/write-version.js",
+    "build": "tsc && tsc-alias && yarn run copy-version",
+    "copy-version": "cp version.json dist",
+    "start": "yarn run update-version && yarn run start:dev",
+    "start:dev": "nodemon --watch src --watch forta.config.json -e js,ts,json  --exec \"yarn run build && yarn run copy-version && forta-agent run\"",
+    "start:prod": "forta-agent run --prod",
+    "tx": "yarn run build && forta-agent run --tx",
+    "block": "yarn run build && forta-agent run --block",
+    "range": "yarn run build && forta-agent run --range",
+    "alert": "yarn run build && forta-agent run --alert",
+    "sequence": "yarn run build && forta-agent run --sequence",
+    "file": "yarn run build && forta-agent run --file",
+    "publish": "yarn run update-version && forta-agent publish",
+    "info": "forta-agent info",
+    "logs": "forta-agent logs",
+    "push": "yarn run update-version && forta-agent push",
+    "disable": "forta-agent disable",
+    "enable": "forta-agent enable",
+    "keyfile": "forta-agent keyfile",
+    "stake": "forta-agent stake",
+    "test": "jest",
+    "generate-types": "typechain --target=ethers-v5 --out-dir=./src/generated ./src/abi/*",
+    "eslint:lint": "eslint ./src",
+    "eslint:format": "eslint ./src --fix",
+    "prettier:check": "prettier --check ./src",
+    "prettier:format": "prettier --write ./src README.md",
+    "lint": "yarn run prettier:check && yarn run eslint:lint",
+    "format": "yarn run eslint:format && yarn run prettier:format",
+    "postinstall": "yarn generate-types"
+  },
+  "dependencies": {
+    "@ethersproject/abi": "^5.0.0",
+    "@ethersproject/providers": "^5.0.0",
+    "@types/lodash": "^4.14.202",
+    "async-mutex": "^0.4.0",
+    "bignumber.js": "^9.1.2",
+    "ethereum-multicall": "^2.24.0",
+    "ethers": "^5.5.1",
+    "forta-agent": "^0.1.48",
+    "fp-ts": "^2.16.1",
+    "knex": "^3.1.0",
+    "lodash": "^4.17.21",
+    "ts-retry": "^4.2.4",
+    "winston": "^3.11.0"
+  },
+  "devDependencies": {
+    "@faker-js/faker": "^8.3.1",
+    "@jest/globals": "^29.7.0",
+    "@tsconfig/node20": "^20.1.2",
+    "@typechain/ethers-v5": "^11.1.2",
+    "@types/jest": "^29.5.11",
+    "@types/nodemon": "^1.19.0",
+    "@types/ws": "^8.5.10",
+    "@typescript-eslint/eslint-plugin": "^6.12.0",
+    "@typescript-eslint/parser": "^6.12.0",
+    "eslint": "^8.54.0",
+    "eslint-config-prettier": "^9.0.0",
+    "eslint-plugin-jest": "^27.6.0",
+    "eslint-plugin-prettier": "^5.0.1",
+    "husky": "^8.0.3",
+    "jest": "^29.7.0",
+    "jest-resolve": "^29.7.0",
+    "nodemon": "^3.0.1",
+    "postinstall": "^0.8.0",
+    "prettier": "^3.1.0",
+    "ts-generator": "^0.1.1",
+    "ts-jest": "^29.1.2",
+    "tsc-alias": "^1.8.8",
+    "typechain": "^8.3.2",
+    "typescript": "^5.3.2"
+  },
+  "packageManager": "yarn@1.22.21"
+}