In this guide, you will learn how to deploy an ERC-20 token smart contract on AGUNG using Remix, a browser-based Solidity development environment. This guide uses a boilerplate ERC-20 contract, and you will customize key parameters such as:

  • Token Name
  • Symbol
  • Decimals
  • Total Supply

By the end, you’ll have your very own ERC-20 token deployed on our AGUNG testnet.

​
Prerequisites

  • Basic understanding of blockchain and ERC-20 tokens.
  • Installed MetaMask browser extension with AGUNG network set-up already.
  • Familiarity with Remix IDE (https://remix.ethereum.org/).
  • Using the OpenZeppelin library for the ERC-20 boilerplate.
  • A wallet with AGUNG network PEAQ for gas fees.

​
Instructions

​
1. Open Remix IDE

  • Visit Remix and create a new workspace.
  • Click on “File Explorers” and select “Create a New File”.
  • Name the file: MyERC20Token.sol.

​
2. ERC-20 Code

Copy and paste the following boilerplate ERC-20 smart contract code into your newly created file:

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

// Import OpenZeppelin's ERC-20 implementation
import "@openzeppelin/contracts/token/ERC20/ERC20.sol";

contract MyToken is ERC20 { // Here we are declaring the contract & inheriting ERC20
    constructor(uint256 initialSupply) ERC20("MyToken", "MTK") { 
        _mint(msg.sender, initialSupply * (10 ** uint256(decimals())));
    }
}

​
3. Modify Token Details

Update the following placeholders in the code:

  • Token Name: Replace "MyToken" with your token’s name (e.g., "ExampleToken").
  • Symbol: Replace "MTK" with a short symbol (e.g., "EXT").
  • Total Supply: The initialSupply (input during deployment) defines the number of tokens created.

Example: For a 1,000,000 total supply with 18 decimals, input 1,000,000 during contract deployment (Step 5).

​
4. Compile the Contract

In the Solidity Compile tab:

  • Select the Solidity version (e.g., 0.8.20+commit.a1b79de6).
  • Click Compile MyERC20Token.sol.
  • Ensure there are no errors.

​
5. Deploy the Contract

  • Go to the Deploy & Run Transactions tab in Remix.
  • Select Injected Web3 as the environment to connect MetaMask.
  • Choose your testnet wallet account in MetaMask.
  • In the constructor field, enter your desired Total Supply (e.g., 1000000 for 1 Million).
  • Click Transact under Deploy and confirm the transaction in MetaMask.

​
6. Verify Deployment

Remix IDE’s console logging a successful execution of the transaction to deploy the smart contract ExampleToken (MyERC20Token.sol) to AGUNG network.

  • After deployment, your contract will appear under Deployed Contracts in Remix.
  • Use the Read Functions (blue) to verify details like name(), symbol(), and totalSupply().
  • You can also check your token balance using the balanceOf() function by inputting your wallet address.

​
Summary

🎉 Congratulations! You have successfully deployed your first ERC-20 token on our AGUNG testnet. You can now view your contract on a block explorer (like Subscan) and interact with it through the interface in Remix. For further enhancements to your ERC-20 token, explore features like minting, burning, or transferring tokens.