[VEN-2138][VEN-2010]: add xvs-token-bridge and deployment scripts

.env.example

@@ -0,0 +1,16 @@
+# true or false
+FORK=false
+FORKED_NETWORK=bscmainnet
+#FORKED_NETWORK=bsctestnet
+#FORKED_NETWORK=sepolia
+#FORKED_NETWORK=ethereum
+
+MNEMONIC="here is where your twelve words mnemonic should be put my friend"
+DEPLOYER_PRIVATE_KEY=
+
+## Archive nodes
+#ARCHIVE_NODE_bsctestnet=https://bsc-testnet.nodereal.io/v1/API_KEY
+#ARCHIVE_NODE_bscmainnet=https://bsc-mainnet.nodereal.io/v1/API_KEY
+#ARCHIVE_NODE_bscmainnet=http://127.0.0.1:1248
+#ARCHIVE_NODE_sepolia=https://ethereum-sepolia.blockpi.network/v1/rpc/public
+#ARCHIVE_NODE_ethereum=https://eth-mainnet.nodereal.io/v1/API_KEY

.eslint-tsconfig

@@ -0,0 +1,12 @@
+{
+  "extends": "./tsconfig.json",
+  "include": [
+    "jest.config.js",
+    ".eslintrc.js",
+    "test",
+    "scenario",
+    "deploy",
+    "docgen-templates",
+    "commitlint.config.js"
+  ]
+}

.eslintignore

@@ -0,0 +1,6 @@
+node_modules
+artifacts
+cache
+coverage
+dist
+typechain

.eslintrc

@@ -0,0 +1,53 @@
+{
+  "env": {
+    "browser": false,
+    "es2021": true,
+    "mocha": true,
+    "node": true,
+  },
+  "plugins": ["@typescript-eslint"],
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/eslint-recommended",
+    "plugin:@typescript-eslint/recommended",
+    "prettier",
+  ],
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "ecmaVersion": 12,
+    "project": ".eslint-tsconfig",
+  },
+  "root": true,
+  "rules": {
+    "@typescript-eslint/no-floating-promises": [
+      "error",
+      {
+        "ignoreIIFE": true,
+        "ignoreVoid": true,
+      },
+    ],
+    "@typescript-eslint/no-inferrable-types": "off",
+    "@typescript-eslint/no-unused-vars": [
+      "error",
+      {
+        "argsIgnorePattern": "_",
+        "varsIgnorePattern": "_",
+      },
+    ],
+    "spaced-comment": [
+      "error",
+      "always",
+      {
+        "line": {
+          "exceptions": ["-", "+"],
+          "markers": ["=", "!", "/"],
+        },
+        "block": {
+          "exceptions": ["-", "+"],
+          "markers": ["=", "!", ":", "::"],
+          "balanced": true
+        }
+      }
+    ]
+  }
+}

.gitattributes

@@ -0,0 +1,3 @@
+* text eol=lf
+*.pdf binary
+*.sol linguist-language=Solidity

.github/pull_request_template.md

@@ -0,0 +1,17 @@
+## Description
+
+<!-- Describe your changes here -->
+
+Resolves #<!-- issue id -->
+
+## Checklist
+
+<!--
+  Any non-WIP PR should have all the checkmarks set.
+  If a checkmark is not applicable to your PR, mark it as done
+-->
+
+- [ ] I have updated the documentation to account for the changes in the code.
+- [ ] If I added new functionality, I added tests covering it.
+- [ ] If I fixed a bug, I added a test preventing this bug from silently reappearing again.
+- [ ] My contribution follows [Venus contribution guidelines](docs/CONTRIBUTING.md).

.github/workflows/cd.yaml

@@ -0,0 +1,38 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+      - develop
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+
+      - uses: actions/setup-node@v2
+        with:
+          cache: "yarn"
+
+      - name: Install dependencies
+        # Hack to get around failing "ethereumjs-abi The remote archive doesn't match the expected checksum" error
+        run: YARN_CHECKSUM_BEHAVIOR=update yarn
+
+      - name: Build
+        run: yarn build
+
+      - name: Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.VENUS_TOOLS_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+          GIT_AUTHOR_NAME: Venus Tools
+          GIT_AUTHOR_EMAIL: [email protected]
+          GIT_COMMITTER_NAME: Venus Tools
+          GIT_COMMITTER_EMAIL: [email protected]
+        run: yarn semantic-release

.github/workflows/ci.yaml

@@ -0,0 +1,126 @@
+name: CI
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+  workflow_dispatch:
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-22.04
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v2
+
+      - name: Setup Node.js environment
+        uses: actions/setup-node@v2
+        with:
+          node-version: 18
+          cache: "yarn"
+
+      - name: Install dependencies
+        # Hack to get around failing "ethereumjs-abi The remote archive doesn't match the expected checksum" error
+        run: YARN_CHECKSUM_BEHAVIOR=update yarn
+
+      - name: Check linting of solidity and typescript
+        run: yarn lint
+
+  test:
+    name: Test
+    runs-on: ubuntu-22.04
+    env:
+      NODE_OPTIONS: --max-old-space-size=4096
+    steps:
+      - uses: actions/checkout@v2
+
+      - uses: actions/setup-node@v2
+        with:
+          node-version: 18
+          cache: "yarn"
+
+      - name: Install deps
+        run: yarn
+
+      - name: Run hardhat compile and tests coverage
+        run: |
+          source .env.example
+          yarn hardhat:compile && yarn hardhat:coverage
+
+      - name: Code Coverage Report
+        uses: irongut/[email protected]
+        with:
+          filename: coverage/**/cobertura-coverage.xml
+          badge: true
+          fail_below_min: false
+          format: markdown
+          hide_branch_rate: false
+          hide_complexity: true
+          indicators: true
+          output: both
+          thresholds: "50 80"
+
+      - name: Add Coverage PR Comment
+        uses: marocchino/sticky-pull-request-comment@v2
+        if: github.event_name == 'pull_request'
+        with:
+          recreate: true
+          path: code-coverage-results.md
+
+  deploy:
+    name: Deploy
+    runs-on: ubuntu-22.04
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v2
+
+      - name: Setup Node.js environment
+        uses: actions/setup-node@v2
+        with:
+          node-version: 18
+          cache: "yarn"
+
+      - name: Install dependencies
+        # Hack to get around failing "ethereumjs-abi The remote archive doesn't match the expected checksum" error
+        run: YARN_CHECKSUM_BEHAVIOR=update yarn
+
+      - name: Build
+        run: yarn build
+
+      - name: Verify deployments work
+        run: yarn hardhat deploy
+
+  export-deployments:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v2
+        with:
+          ref: ${{ github.head_ref }}
+          token: ${{ secrets.VENUS_TOOLS_TOKEN }}
+
+      - name: Setup Node.js environment
+        uses: actions/setup-node@v2
+        with:
+          node-version: 18
+          cache: "yarn"
+
+      - name: Install dependencies
+        # Hack to get around failing "ethereumjs-abi The remote archive doesn't match the expected checksum" error
+        run: YARN_CHECKSUM_BEHAVIOR=update yarn
+
+      - name: Export deployments
+        run: |
+          yarn hardhat export --network bsctestnet --export ./deployments/bsctestnet.json
+          yarn hardhat export --network bscmainnet --export ./deployments/bscmainnet.json
+          yarn hardhat export --network sepolia --export ./deployments/sepolia.json
+          yarn hardhat export --network ethereum --export ./deployments/ethereum.json
+          yarn prettier
+
+      - uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "feat: updating deployment files"
+          file_pattern: "deployments/*.json"

.gitignore

@@ -0,0 +1,18 @@
+node_modules
+.env
+coverage
+coverage.json
+typechain
+typechain-types
+
+# Hardhat files
+cache
+artifacts
+
+# yarn
+.yarn/*
+!.yarn/patches
+!.yarn/releases
+!.yarn/plugins
+!.yarn/sdks
+!.yarn/versions

.npmignore

@@ -0,0 +1,3 @@
+hardhat.config.ts
+scripts
+test

.prettierignore

@@ -0,0 +1,8 @@
+node_modules
+artifacts
+cache
+coverage*
+gasReporterOutput.json
+dist
+typechain
+docs

.prettierrc

@@ -0,0 +1,14 @@
+{
+  "arrowParens": avoid,
+  "bracketSpacing": true,
+  "endOfLine": "auto",
+  "importOrder": ["module-alias/register", "<THIRD_PARTY_MODULES>", "^[./]"],
+  "importOrderParserPlugins": ["typescript"],
+  "importOrderSeparation": true,
+  "importOrderSortSpecifiers": true,
+  "printWidth": 120,
+  "singleQuote": false,
+  "tabWidth": 2,
+  "trailingComma": all,
+  "overrides": [{ "files": "*.sol", "options": { "tabWidth": 4 } }],
+}