Connecting Hardhat to Caduceus

Forking a Hardhat Project

We recommend you create a clone a repository like https://github.com/OpenZeppelin/openzeppelin-contracts which already has Hardhat set up and working. It also comes with an extensive amount of expertly written smart contracts which can be used to bootstrap your development. So fork the repository and go through the readme to get you up and running

# clone the repository
git clone https://github.com/OpenZeppelin/openzeppelin-contracts.git
# enter into the directory
cd openzeppelin-contracts
# installs packages
yarn

alternatively you can also do this hardhat tutorial to initialise a new project: https://hardhat.org/hardhat-runner/docs/getting-started#quick-start

Changing the Config

Inside your hardhat.config.js there will be a networks object. this object is where you can define other networks for hardhat to deploy and test the smart contracts on. This means you can point hardhat to the Testnet.

module.exports = {
    networks: {
        hardhat: {
            blockGasLimit: 10000000,
            allowUnlimitedContractSize: !withOptimizations,
        },
    },
},

To add the caduceus network you have to add the RPC endpoint along with a test wallet that ideally has Test CMP tokens. As deploying and interacting with contracts will take up CMP for gas.

module.exports = {
    networks: {
        hardhat: {
            blockGasLimit: 10000000,
            allowUnlimitedContractSize: !withOptimizations,
        },
        caduceusTestnet: {
            url: 'https://galaxy.block.caduceus.foundation',
            accounts: {
                mnemonic: 'test test test test test test test test test test test test',
                path: "m/44'/60'/0'/0",
                initialIndex: 0,
                count: 20,
                passphrase: '',
            },
        },
    },
},

As you can see the url is set to our testnet RPC endpoint. Also there is an accounts object which includes the wallets Secret Recovery Phrase along with other path details. These path details are the default path details for HD wallets thus they might work for your wallet as well.

If you use MetaMask you can copy your mnemonic phrase from the app and paste it in here with this config and it should work.

Go to here to see how to get your mnemonic phrase from MetaMask - Create a Wallet

Click here to learn more about hardhat configuration and networks

Running tests

Now your hardhat configuration is set up you can execute tests by doing

npx hardhat test ./test/finance/VestingWallet.test.js --network caduceusTestnet

where the --network flag is the key of the of the network object in the config file. In our case we named it caduceusTestnet.