Ancient8 Documentation
  • ANCIENT8 CHAIN
    • Overview of Ancient8 Chain
      • What is Ancient8 Chain?
      • What makes Ancient8 Chain unique as a blockchain?
      • Ancient8 Ecosystem
      • Ancient8 Foundation
      • Tokenomics
      • Backers
    • Research
      • OP Stack
      • Celestia
    • Ancient8 Governance
    • Airdrop and Staking
  • Using Ancient8 Chain
    • Network Information
    • Adding network to Metamask
    • Contracts
    • Bridges
    • Block Explorers
    • Faucet
  • Building on Ancient8
    • Deploying Smart Contracts
      • Using Hardhat
      • Using Remix
      • Using thirdweb
    • Deploying DApps
      • Using thirdweb
  • Policies
    • USDC Bridging Compliance Policy
    • Terms of Service
    • Privacy Policy
Powered by GitBook
On this page
  • Using Hardhat
  • Objectives
  • Prerequisites
  • Creating a project
  • Configuring Hardhat with Ancient8
  • Compiling the smart contract
  • Deploying the smart contract
  1. Building on Ancient8
  2. Deploying Smart Contracts

Using Hardhat

PreviousDeploying Smart ContractsNextUsing Remix

Last updated 9 months ago

Hardhat is an Ethereum development environment for flexible, extensible, and fast smart contract development.

You can use Hardhat to edit, compile, debug, and deploy your smart contracts to Ancient8.

Using Hardhat

This section will guide you through deploying an NFT smart contract (ERC-721) on the Ancient8 test network using .

Objectives

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

  • Setup Hardhat for Ancient8 Testnet

  • Create an NFT smart contract for Ancient8 Testnet

  • Compile a smart contract for Ancient8 Testnet

  • Deploy a smart contract to Ancient8 Testnet

  • Interact with a smart contract deployed on Ancient8 Testnet

Prerequisites

Node v18+

This guide requires you have Node version 18+ installed.

Wallet funds?

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

Creating a project

Before you can begin deploying smart contracts to Ancient8 Testnet, you need to set up your development environment by creating a Node.js project.

To create a new Node.js project, run:

npm init --y

Next, you will need to install Hardhat and create a new Hardhat project

To install Hardhat, run:

npm install --save-dev hardhat

To create a new Hardhat project, run:

npx hardhat

Select Create a TypeScript project then press enter to confirm the project root.

Select y for both adding a .gitignore and loading the sample project. It will take a moment for the project setup process to complete.

Configuring Hardhat with Ancient8

In order to deploy smart contracts to the Ancient8 Testnet, you will need to configure your Hardhat project and add the Ancient8 Testnet.

To configure Hardhat to use Ancient8 Testnet, add Ancient8 Testnet as a network to your project's hardhat.config.ts file:

import { HardhatUserConfig } from 'hardhat/config';
import '@nomicfoundation/hardhat-toolbox';

require('dotenv').config();

const config: HardhatUserConfig = {
  solidity: {
    version: '0.8.17',
  },
  networks: {
    // for testnet
    'a8-testnet': {
      url: 'https://rpc-testnet.ancient8.gg',
      accounts: [process.env.WALLET_KEY as string],
      gasPrice: 1000000000,
    },
  },
  defaultNetwork: 'a8-testnet',
};

export default config;

The above configuration uses the @nomicfoundation/hardhat-toolbox plugin to bundle all the commonly used packages and Hardhat plugins recommended to start developing with Hardhat.

To install @nomicfoundation/hardhat-toolbox, run:

npm install --save-dev @nomicfoundation/hardhat-toolbox

Loading environment variables

To install dotenv, run:

npm install --save-dev dotenv

Once you have dotenv installed, you can create a .env file with the following content:

WALLET_KEY=<YOUR_PRIVATE_KEY>

Substituting <YOUR_PRIVATE_KEY> with the private key for your wallet.

CAUTION

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.17;

import "@openzeppelin/contracts/token/ERC721/ERC721.sol";
import "@openzeppelin/contracts/utils/Counters.sol";

contract NFT is ERC721 {
    using Counters for Counters.Counter;
    Counters.Counter private currentTokenId;

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

    function mint(address recipient)
        public
        returns (uint256)
    {
        currentTokenId.increment();
        uint256 tokenId = currentTokenId.current();
        _safeMint(recipient, tokenId);
        return tokenId;
    }
}

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

npm install --save @openzeppelin/contracts

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

To compile the contract using Hardhat, run:

npx hardhat compile

Deploying the smart contract

Once your contract has been successfully compiled, you can deploy the contract to the Ancient8 Testnet.

To deploy the contract to the Ancient8 Testnet, you'll need to modify the scripts/deploy.ts in your project:

import { ethers } from 'hardhat';

async function main() {
  const nft = await ethers.deployContract('NFT');

  await nft.waitForDeployment();

  console.log('NFT Contract Deployed at ' + nft.target);
}

// We recommend this pattern to be able to use async/await everywhere
// and properly handle errors.
main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});

Finally, run:

npx hardhat run scripts/deploy.ts 

INFO

If you'd like to deploy to mainnet, you'll modify the command like so:

npx hardhat run scripts/deploy.ts --network ancient8-mainnet

Install Hardhat toolbox

The above configuration also uses to load the WALLET_KEY environment variable from a .env file to process.env.WALLET_KEY. You should use a similar method to avoid hardcoding your private keys within your source code.

WALLET_KEY is the private key of the wallet to use when deploying a contract. For instructions on how to get your private key from Metamask, visit the . It is critical that you do NOT commit this to a public repo

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

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

The contract will be deployed on the Ancient8 Testnet. You can view the deployment status and contract by using a 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.

Hardhat
​
dotenv
Metamask documentation
OpenZeppelin Contracts library
block explorer
prerequisites