hardhat-example

hardhat-example provides a simple smart contract deployment framework using the Hardhat development kit on Quai Network.

This project demonstrates a basic Hardhat use case. It comes with a few sample contracts, and a script that deploys a contract.

Dependencies

• quai-hardhat development toolkit
• SolidityX
• nodejs
• @nomicfoundation/hardhat-toolbox
• quais and quais-polling
• dotenv
• child-process if you intend to use the deployAllChains.js script

Run and Deploy

Install Dependencies

1. Clone hardhat-example

git clone https://github.com/dominant-strategies/hardhat-example

2. Install package dependencies

npm i

Local SolidityX Compiler

Visit the SolidityX Repository for instructions on how to clone and build the SolidityX compiler for your specific operating system.

Once you've built the SolidityX compiler, you'll need to add path to your solc binary into the customCompilerPath variable in the hardhat.config.js file. The file already includes common paths for MacOS and Linux as comments.

Environment Config

• Copy .env.dist to .env.

cp .env.dist .env

• Define network variables inside of the .env file.
  • Private Keys
    • The sample environment file is configured with a placeholder private key for each chain.
    • Replace the placeholder private key for each chain with your own private key that corresponds to the address you want to deploy from.
    • You cannot use the same private key for each chain.
  • Chain ID
    • Depending on the network you're deploying to, you'll need to set the CHAINID variable to the correct chain ID.
      • Local: 1337
      • Testnet: 9000
      • Devnet: 12000
  • RPC Endpoints
    • RPC endpoints are default configured for a local node.
    • Local: HTTP ports for each chain's RPCURL can be found here.
    • Remote: hosted RPC endpoints for each chain can be found here.

Deploy

1. Configure the deploy.js script to specify the contract you'd like to deploy
   • Pass the name of the contract into the hardhat runtime contract definition
   • Pass relevant constructor arguments into the deploy command (i.e. the intial greeting for the greeter.sol contract)
2. Compile contracts using npx hardhat compile
3. Deploy contract to a single chain using npx hardhat run scripts/deploy.js
   • This will deploy to the defaultNetwork specified in your hardhat.config.js
   • You can specify a network other than the defaultNetwork by passing the --network networkName flag to the deploy command. Replace networkName with one of the options below.
   • Available networkName are:
     • cyprus1
     • cyprus2
     • cyprus3
     • paxos1
     • paxos2
     • paxos3
     • hydra1
     • hydra2
     • hydra3

Alternate Configurations

The deployAllChains.js script has been included as a simple method of automating deployments across all chains within Quai Network. It utilizes the child-process package to run the deploy.js script for each chain.

You can specify which chains you'd like to multi-deploy to by modifying the deployAllChains.js script. Contract and deployment specific configuration should be done in the deploy.js script.

You can run the multi-deploy script using:

npx hardhat run scripts/deployAllChains.js

Deploying QRC20 or QRC721

The deployQRC20.js and deployQRC721.js scripts have been included as a simple method of deploying QRC20 and QRC721 contracts to a single chain within Quai Network.

To specify token details (token name, ticker, supply, etc) for either the QRC20 or QRC721 contract, modify constructor args inside of the contracts before compiling.

The deployAllChains.js script can be configured to run either of the QRC scripts for each chain by changing scripts/deploy.js to scripts/deployQRC20.js or scripts/deployQRC721.js in this line:

const deployProcess = spawn('npx', ['hardhat', 'run', '--network', chain, 'scripts/deploy.js'])

Hardhat

Hardhat has a number of other useful CLI commands.

npx hardhat compile
npx hardhat clean
npx hardhat test
npx hardhat help

Authors

Juuddi