🧾 CCNext-smart-contracts 🧾

This repository hosts smart contract templates which integrate with the Creditcoin Universal Smart Contracts project, code named CCNext. Most important of these is the Universal Bridge Proxy contract, which can be used to interpret bridged data from foreign source chains (EX: Ethereum) on behalf of other Creditcoin EVM smart contracts.

External dependencies

To deploy your own contracts, you will first need to have the following dependencies available locally:

• yarn
• npm

Tip

This project provides a flake.nix you can use to download all the dependencies you will need for this tutorial inside of a sandboxed environment. Just keep in mind you will have to enable flakes for this to work. To start you development environment, simply run:

nix develop

Once you have all your dependencies setup, you will need to download some packages with yarn:

yarn install

Get some test funds on Creditcoin USC Testnet

Before you can deploy your own contracts, you will need to fund your account on the Creditcoin USC Testnet, otherwise contract deployment will fail due to lack of funds. Head over to the 🚰 creditcoin usc testnet discord faucet to request some test tokens there. Now that you have enough funds you can move on to deploying your contracts.

Deploying contracts

1. Configure your .env

Caution

The hardhat script for deploying smart contracts requires use of your wallet's private key in order to act on your wallet's behalf. Exposing a private key for any reason is dangerous, so make sure the wallet you use contains nothing of value. Ideally it should be a newly created address.

You will need to create a .env file at the root of this repository file tree with some configuration options for the contracts to use during deployment. Add the following contents:

OWNER_PRIVATE_KEY=your_creditcoin_account_private_key_here

2. Compile smart contracts

Next, you will need to compile the smart contracts using 👷🏻‍♀️ hardhat to prepare them for deployment. Run the following command:

npx hardhat compile

3. Run script to deploy contracts

Finally, you can deploy your contracts to the Creditcoin USC Testnet by running the following command:

npx hardhat deploy                                     \
    --network cc3_usc_testnet                           \
    --proceedsaccount <Your Creditcoin wallet address> \
    --erc20name Test                                   \
    --erc20symbol TEST                                 \
    --chainkey 102033                                  \
    --timeout 300                                      \
    --lockupduration 86400                             \
    --approvalthreshold 2                              \
    --maxinstantmint 100                               \
    --admin <Your Creditcoin wallet address>

Tip

Sometimes deploy.js can be flaky for various reasons. Try re-running it a few times in case it gets stuck or fails.