README.md

DKG EVM Module

This repository contains the smart contracts for OriginTrail V8, which serves as the core module for the Decentralized Knowledge Graph (DKG). The module handles various aspects, such as DKG Node profile management, Knowledge Assets ownership, consensus mechanisms, and others, in order to ensure the secure and efficient operation of the network. The contracts are written in Solidity and can be deployed on Ethereum and compatible networks.

Repository Structure

This repository contains the following main components:

• abi: Stores the generated ABI files for the smart contracts.
• contracts: Contains the Solidity source files for the smart contracts.
• deploy: Contains deployment scripts for all contracts with additional helpers for automatic deployment on OriginTrail Parachain.
• deployments: Contains JSON files with addresses of the latest deployed contracts.
• scripts: Includes Hardhat scripts that can be run using the Hardhat CLI for specific purposes, such as deploying contracts, generating accounts, or interacting with the blockchain.
• tasks: Contains Hardhat tasks that can be executed through the Hardhat CLI to automate various actions and processes related to the project. These tasks can be helpful for interacting with smart contracts, managing deployments, or running custom scripts as needed.
• test: Includes the test files for the smart contracts.
• utils: Includes utility functions and files used throughout the repository.

Prerequisites and Setup

Before running the commands, make sure you have the following prerequisites installed:

• Node.js (version 20.x or higher)
• npm
• slither (Optional, needed for static Solidity code analysis)

Clone the repository and install the dependencies:

git clone https://github.com/OriginTrail/dkg-evm-module.git

cd dkg-evm-module

npm install

NPM Scripts

This project utilizes a variety of NPM scripts to run various tasks and processes. The scripts are defined in the package.json file and are designed to be used with the Hardhat CLI, leveraging Hardhat plugins for additional functionality. Here's a brief description of the scripts:

• clean: Removes the cache and artifacts folders generated by Hardhat.
• compile:size: Compiles the smart contracts and analyzes the size of the compiled contracts using the hardhat-contract-sizer plugin.
• compile: Compiles the smart contracts with specific configuration using hardhat.node.config.ts.
• coverage: Generates a code coverage report for the smart contracts with specific network and coverage settings.
• deploy:gnosis_chiado_test, deploy:gnosis_mainnet, deploy:base_sepolia_test, deploy:base_mainnet, deploy:neuroweb_testnet, deploy:neuroweb_mainnet, deploy:localhost and deploy: Deploy smart contracts to various networks including Gnosis Chiado, Gnosis Mainnet, Base Sepolia Testnet, Base Mainnet, Neuroweb Testnet, Neuroweb Mainnet and Hardhat.
• dev: Run local development nodes with Hardhat.
• export-abi: Updates ABI files according to the current state of the smart contracts.
• format:fix: Automatically fixes code formatting issues for JSON, JavaScript, TypeScript, and Solidity files using Prettier.
• format: Checks code formatting for the same file types.
• generate-evm-account and generate-neuroweb-account: Generate new Ethereum and OriginTrail accounts, respectively.
• lint:fix, lint:sol:fix, lint:ts:fix, lint:sol, lint:ts, and lint: Provide various linting functionalities for Solidity and TypeScript files, including fixing issues.
• mint-test-tokens: Mints test tokens on the local development network.
• prepare: Sets up Husky Git hooks and generates TypeChain typings for the smart contracts.
• slither:reentrancy and slither: Run Slither static analysis with a focus on reentrancy vulnerabilities, and a general analysis, respectively.
• test:fulltrace, test:gas:fulltrace, test:gas:trace, test:gas, test:integration, test:trace, test:unit and test: A comprehensive suite of test scripts for different scenarios, including full trace, gas usage, integration, and unit tests.
• typechain: Generates TypeChain typings for the smart contracts.

These scripts can be run using the npm run <script-name> command. For example, to compile the smart contracts, you can run:

npm run compile

Additional Hardhat tasks

Hardhat has plenty of other useful commands, extended by the installed plugins. Here's a brief description of the most useful tasks:

• decode: Decodes encoded ABI data (e.g. input data of transaction).
• encode_selector: Calculates EVM function/event/error selector (sighash).
• encode_data: Encodes data needed for low-level contract calls.
• clear_sharding_table: Removes nodes from sharding table based on Node IDs from the given CSV file (example usage: npx hardhat clear_sharding_table --file-path ./peers.csv --network otp_testnet).

These tasks can be run using the npx hardhat <task-name> command. For example, to decode input data, you can run:

npx hardhat decode --data <bytes-data>

Usage example of encode_data task. Here we want to call ProofManagerV1 function called setReq, and this function can be called only through forwardCall in HubController and encoding arguments for this function can be done by using this task:

npx hardhat encode_data --contract-name ProofManagerV1 --function-name setReq 1 true

Alternatively, encoded data can be produced from Remix by copying prepared calldata from ProofManagerV1 setReq call.

Contracts deployment on parachains

Update environment use NEUROWEB_DEVNET/NEUROWEB_TESTNET/NEUROWEB_MAINNET

RPC_NEUROWEB_DEVNET='<https_endpoint>'
EVM_PRIVATE_KEY_NEUROWEB_DEVNET='<0x_ethereum_private_key>'
ACCOUNT_WITH_NEURO_URI_NEUROWEB_DEVNET='<substrate_account_uri>'

OriginTrail Parachain Devnet

npm run deploy:neuroweb_devnet

OriginTrail Parachain Testnet

npm run deploy:neuroweb_testnet

OriginTrail Parachain Mainnet

npm run deploy:neuroweb_mainnet

Gnosis Chiado Dev

npm run deploy:gnosis_chiado_dev

Gnosis Chiado Test

npm run deploy:gnosis_chiado_test

Gnosis Mainnet

npm run deploy:gnosis_mainnet

Redeploy contract

In order to redeploy desired contract, set deployed to false in deployments/<network>_contracts.json.