Deploying a smart contract

This article will provide an overview of the Foundry development toolchain, and show you how to deploy a contract to WowChain Mainnet.

Foundry is a powerful suite of tools to develop, test, and debug your smart contracts. It comprises several individual tools:

  • forge: the main workhorse of Foundry — for developing, testing, compiling, and deploying smart contracts

  • cast: a command-line tool for performing Ethereum RPC calls (e.g., interacting with contracts, sending transactions, and getting onchain data)

  • anvil: a local testnet node, for testing contract behavior from a frontend or over RPC

  • chisel: a Solidity REPL, for trying out Solidity snippets on a local or forked network

Foundry offers extremely fast feedback loops (due to the under-the-hood Rust implementation) and less context switching — because you'll be writing your contracts, tests, and deployment scripts All in Solidity!

Objectives​

By the end of this tutorial, you should be able to do the following:

  • Setup Foundry for WowChain

  • Create an NFT smart contract for WowChain

  • Compile a smart contract for WowChain (using forge)

  • Deploy a smart contract to WowChain (also with forge)

  • Interact with a smart contract deployed on WowChain (using cast)

Prerequisites​

Foundry​

This tutorial requires you have Foundry installed.

  • From the command-line (terminal), run: curl -L https://foundry.paradigm.xyz | bash

  • Then run foundryup, to install the latest (nightly) build of Foundry

For more information, see the Foundry Book installation guide.

Coinbase Wallet​

In order to deploy a smart contract, you will first need a web3 wallet. You can create a wallet by downloading the Coinbase Wallet browser extension.

Wallet funds​

Deploying contracts to the blockchain requires a gas fee. Therefore, you will need to fund your wallet with DOGE to cover those gas fees.

Creating a project​

Before you can begin deploying smart contracts to WowChain, you need to set up your development environment by creating a Foundry project.

To create a new Foundry project, first create a new directory:

mkdir myproject

Then run:

cd myproject
forge init

This will create a Foundry project, which has the following basic layout:

.
├── foundry.toml
├── script
 │   └── Counter.s.sol
├── src
 │   └── Counter.sol
└── test
    └── Counter.t.sol

Compiling the smart contract​

Below is a simple NFT smart contract (ERC-721) written in the Solidity programming language:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.23;

import "openzeppelin-contracts/contracts/token/ERC721/ERC721.sol";

contract NFT is ERC721 {
    uint256 public currentTokenId;

    constructor() ERC721("NFT Name", "NFT") {}

    function mint(address recipient) public payable returns (uint256) {
        uint256 newItemId = ++currentTokenId;
        _safeMint(recipient, newItemId);
        return newItemId;
    }
}

The Solidity code above defines a smart contract named NFT. The code uses the ERC721 interface provided by the OpenZeppelin Contracts library to create an NFT smart contract. OpenZeppelin allows developers to leverage battle-tested smart contract implementations that adhere to official ERC standards.

To add the OpenZeppelin Contracts library to your project, run:

forge install openzeppelin/openzeppelin-contracts

In your project, delete the src/Counter.sol contract that was generated with the project and add the above code in a new file called src/NFT.sol. (You can also delete the test/Counter.t.sol and script/Counter.s.sol files, but you should add your own tests ASAP!).

To compile our basic NFT contract using Foundry, run:

forge build

Configuring Foundry with WowChain​

Next, you will configure your Foundry project to deploy smart contracts to the WowChain network. First you'll store your private key in an encrypted keystore, then you'll add WowChain as a network.

Storing your private key​

The following command will import your private key to Foundry's secure keystore. You will be prompted to enter your private key, as well as a password for signing transactions:

cast wallet import deployer --interactive

Run this command to confirm that the 'deployer' account is setup in Foundry:

cast wallet list

Adding WowChain as a network

When verifying a contract with Explorer, you need an API key. You can get your Explorer API key from here after you sign up for an account.

Now create a .env file in the home directory of your project to add the WowChain network and an API key for verifying your contract on Explorer:

WOW_MAINNET_RPC="https://rpc.wowchain.io"
ETHERSCAN_API_KEY="<YOUR API KEY>"

Note that even though you're using Explorer as your block explorer, Foundry expects the API key to be defined as ETHERSCAN_API_KEY.

Loading environment variables

Now that you've created the above .env file, run the following command to load the environment variables in the current command line session:

source .env

Deploying the smart contract

With your contract compiled and your environment configured, you are ready to deploy to the WowChain Mainnet network!

Today, you'll use the forge create command, which is a straightforward way to deploy a single contract at a time. In the future, you may want to look into forge script, which enables scripting onchain transactions and deploying more complex smart contract projects.

You'll need DOGE in your wallet. See the prerequisites if you haven't done that yet. Otherwise, the deployment attempt will fail.

To deploy the contract to the WowChain Mainnet network, run the following command. You will be prompted to enter the password that you set earlier, when you imported your private key:

forge create ./src/NFT.sol:NFT --rpc-url $WOW_MAINNET_RPC --account deployer

The contract will be deployed on the WowChain Mainnet network. You can view the deployment status and contract by using a block explorer and searching for the address returned by your deploy script. If you've deployed an exact copy of the NFT contract above, it will already be verified and you'll be able to read and write to the contract using the web interface.

Regardless of the network you're deploying to, if you're deploying a new or modified contract, you'll need to verify it.

Verifying the Smart Contract

In web3, it's considered best practice to verify your contracts so that users and other developers can inspect the source code, and be sure that it matches the deployed bytecode on the blockchain.

Further, if you want to allow others to interact with your contract using the block explorer, it first needs to be verified. The above contract has already been verified, so you should be able to view your version on a block explorer already, but we'll still walk through how to verify a contract on WowChain Mainnet.

Grab the deployed address and run:

forge verify-contract <DEPLOYED_ADDRESS> ./src/NFT.sol:NFT --chain 203 --watch

You should see an output similar to:

Start verifying contract `0x71bfCe1172A66c1c25A50b49156FAe45EB56E009` deployed on WowChain

Submitting verification for [src/NFT.sol:NFT] 0x71bfCe1172A66c1c25A50b49156FAe45EB56E009.
Submitted contract for verification:
        Response: `OK`
        GUID: `3i9rmtmtyyzkqpfvy7pcxj1wtgqyuybvscnq8d7ywfuskss1s7`
        URL:
        https://explorer.wowchain.io/address/0x71bfce1172a66c1c25a50b49156fae45eb56e009
Contract verification status:
Response: `NOTOK`
Details: `Pending in queue`
Contract verification status:
Response: `OK`
Details: `Pass - Verified`
Contract successfully verified

Search for your contract on Explorer to confirm it is verified.

Interacting with the Smart Contract

If you verified on Explorer, you can use the Read Contract and Write Contract sections under the Contract tab to interact with the deployed contract. To use Write Contract, you'll need to connect your wallet first, by clicking the Connect to Web3 button (sometimes this can be a little finicky, and you'll need to click Connect twice before it shows your wallet is successfully connected).

To practice using the cast command-line tool which Foundry provides, you'll perform a call without publishing a transaction (a read), then sign and publish a transaction (a write).

Performing a call

A key component of the Foundry toolkit, cast enables us to interact with contracts, send transactions, and get onchain data using Ethereum RPC calls. First you will perform a call from your account, without publishing a transaction.

From the command-line, run:

cast call <DEPLOYED_ADDRESS> --rpc-url $WOW_MAINNET_RPC "balanceOf(address)" <YOUR_ADDRESS_HERE>

You should receive 0x0000000000000000000000000000000000000000000000000000000000000000 in response, which equals 0 in hexadecimal. And that makes sense — while you've deployed the NFT contract, no NFTs have been minted yet and therefore your account's balance is zero.

Signing and publishing a transaction

Now, sign and publish a transaction, calling the mint(address) function on the NFT contract you just deployed.

Run the following command:

cast send <DEPLOYED_ADDRESS> --rpc-url=$WOW_MAINNET_RPC "mint(address)" <YOUR_ADDRESS_HERE> --account deployer

If successful, Foundry will respond with information about the transaction, including the blockNumber, gasUsed, and transactionHash.

Finally, let's confirm that you did indeed mint yourself one NFT. If you run the first cast call command again, you should see that your balance increased from 0 to 1:

cast call <DEPLOYED_ADDRESS> --rpc-url $WOW_MAINNET_RPC "balanceOf(address)" <YOUR_ADDRESS_HERE>

And the response: 0x0000000000000000000000000000000000000000000000000000000000000001 (1 in hex) — congratulations, you deployed a contract and minted an NFT with Foundry!

Conclusion​

Phew, that was a lot! You learned how to setup a project, deploy to WowChain, and interact with our smart contract using Foundry.

For all things Foundry, check out the Foundry book, or head to the official Telegram dev chat or support chat.

PreviousSetting up FoundryNextTesting smart contracts

Last updated