ERC-20 Tokens

​

Two Ways to Create ERC-20 Tokens

​

Method 1: Deploy ERC-20 Contract in EVM

​

Steps

1. Write or use a standard ERC-20 contract
   • Use OpenZeppelin’s ERC20 contract
   • Or write your own ERC-20 implementation
2. Deploy using standard EVM tooling
   • Hardhat
   • Foundry
   • Remix
   • Or any EVM deployment tool
3. Optionally, create a mapping to the Bank module
   • This enables Cosmos SDK integration
   • Allows use in Cosmos-native applications

​

Use Cases

• Standard ERC-20 tokens: Simple token requirements
• External (non-MANTRA) developers: Recommended approach
• Quick deployment: Fastest way to deploy tokens
• Standard tooling: Use familiar EVM development tools

​

Example

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

import "@openzeppelin/contracts/token/ERC20/ERC20.sol";

contract MyToken is ERC20 {
    constructor() ERC20("MyToken", "MTK") {
        _mint(msg.sender, 1000000 * 10**decimals());
    }
}

​

Method 2: TokenFactory with ERC-20 Precompile

​

Steps

1. Create token using TokenFactory module
   • Use Cosmos SDK’s TokenFactory
   • Configure token parameters
2. Token automatically gets ERC-20 precompile address
   • No additional setup required
   • Precompile address is deterministic
3. Use token in EVM contracts seamlessly
   • Call precompile from Solidity
   • Transfer, approve, and query balances

​

Use Cases

• MANTRA internal tokens: Tokens created by MANTRA
• Tokens requiring compliance features: Access to Bank module compliance
• Tokens that need Bank module integration: Native Cosmos SDK support
• Regulatory compliance: Protocol-level compliance features

​

Benefits

• Compliance features: Bank module has access to the token for compliance features
• Seamless integration: Works in both EVM and Cosmos SDK
• Native protocol support: Built-in MANTRA Chain features
• No wrapping required: Direct EVM access via precompile

​

Recommendation

​

For External Developers

• Familiar development experience
• Standard tooling and libraries
• No special setup required
• Works identically to other EVM chains

​

For MANTRA

• Compliance features built inside the protocol (specifically in the Bank module) have access to the token
• Seamless integration with Cosmos ecosystem
• Native protocol support
• Protocol-level compliance features

​

TokenFactory ERC-20 Precompiles

• ERC-20 precompile address: Deterministic address based on token denom
• Balance control: Manage token balances from EVM
• Transfer functionality: Standard ERC-20 transfer operations
• EVM contract compatibility: Use in any EVM contract

​

Using TokenFactory Tokens in EVM

// Example: Using a TokenFactory token in EVM
// The precompile address is deterministic based on the token denom

interface ITokenFactoryERC20 {
    function transfer(address to, uint256 amount) external returns (bool);
    function balanceOf(address account) external view returns (uint256);
}

contract MyContract {
    // Precompile address for a specific TokenFactory token
    address constant TOKEN_PRECOMPILE = 0x0000000000000000000000000000000000000801;
    
    function transferToken(address to, uint256 amount) external {
        ITokenFactoryERC20(TOKEN_PRECOMPILE).transfer(to, amount);
    }
}

​

Comparison

​

Next Steps

• Learn about address derivation
• Understand transaction sequencing
• Get started with EVM development