TokenSmith User Guide

Complete guide for creating ERC-20 tokens on Hyperliquid with both Simple and Advanced distribution options

Table of Contents

  • Quick Start
  • Simple Mode
  • Advanced Mode
  • Troubleshooting

Quick Start

TokenSmith is a Web3 dApp for creating ERC-20 tokens on the Hyperliquid blockchain. Create custom tokens with both simple and advanced tokenomics features through a user-friendly interface for a flat 0.1 HYPE fee.

Prerequisites

  • A Web3 wallet (MetaMask, WalletConnect, etc.)
  • At least 0.1 HYPE for the creation fee [ now free]
  • Connection to Hyperliquid network (Chain ID: 999)

Simple Mode

Simple

Simple Mode allows you to create a standard ERC-20 token where 100% of the supply is minted directly to your wallet.

Step 1: Connect Your Wallet

  • 1. Open TokenSmith dApp
  • 2. Click "Connect Wallet" button
  • 3. Select your preferred wallet provider
  • 4. Approve the connection request

Step 2: Fill Basic Token Information

  • Token Name: Enter a descriptive name (e.g., "My Awesome Token")
  • Token Symbol: Enter a short symbol (e.g., "MAT") - automatically converted to uppercase
  • Supply: Enter the total token supply

Supply Quick Options:

1M10M1B

Use preset buttons for common supply amounts

Step 3: Choose Simple Mode

  • 1. Under "Token Distribution", select "Mint 100% to me"
  • 2. You'll see a "Simple" badge confirming your selection

Step 4: Review and Create

  • 1. Check your wallet balance (must have at least 0.1 HYPE)
  • 2. Review the fee information at the bottom
  • 3. Click "Create Token (0.1 HYPE)" button

Step 5: Confirm Transaction

  • 1. Your wallet will prompt you to sign the transaction
  • 2. Review the transaction details and gas fees
  • 3. Confirm the transaction

Step 6: Success!

After successful creation, you'll see a success modal with:

  • Token details (name, symbol, supply)
  • Contract address (clickable to copy)
  • Link to view on blockchain explorer

Advanced Mode

Pro

Advanced Mode allows you to create tokens with custom distribution options, including manual addresses, CSV uploads, and NFT holder snapshots.

Steps 1-2: Connect Wallet and Fill Basic Info

Follow the same steps as Simple Mode for connecting your wallet and filling in basic token information.

Step 3: Choose Advanced Mode

  • 1. Under "Token Distribution", select "Advanced Distribution Options"
  • 2. You'll see a "Pro" badge and the advanced options panel will appear

Step 4: Review Distribution Summary

The Distribution Summary shows:

  • Total Allocated: Current percentage allocated to distribution methods
  • Remaining: Percentage that will be minted to your wallet
  • Estimated Recipients: Total number of addresses that will receive tokens
  • Important Notice: Warning about enabling big blocks in wallet settings

Step 5: Add Distribution Methods

You can add multiple distribution methods. Each method has an allocation percentage that determines what portion of the total supply it will distribute.

👤

Method 1: Manual Addresses

  • 1. Click "Manual Addresses" button
  • 2. Enter a custom name for this distribution group
  • 3. Set the allocation percentage (e.g., 30% of total supply)
  • 4. Add recipient addresses and their percentage within this group

📄

Method 2: CSV Upload

  • 1. Click "CSV Upload" button
  • 2. Set allocation percentage for this distribution group
  • 3. Upload a CSV file with addresses and amounts

CSV Format Requirements:

address,amount 0x1234567890123456789012345678901234567890,1000 0x2345678901234567890123456789012345678901,2000

🖼️

Method 3: NFT Collection Snapshot

  • 1. Click "NFT Collection" button
  • 2. Enter the NFT contract address
  • 3. Configure snapshot parameters:
    • Filter Type: All holders, exact amount, minimum amount, range, or manual selection
    • Distribution Type: Equal distribution or weighted by NFT count

Step 6: Configure Batch Processing

For advanced distributions with many recipients, you'll see batch configuration options:

  • Batch Size: Number of addresses processed per transaction (default: 20)
  • Estimated Batches: Total number of transactions needed
  • Gas Optimization: Tips for reducing transaction costs

Step 7: Review Final Configuration

Before creating, review:

  • Total allocation doesn't exceed 100%
  • All distribution methods have valid data
  • Your wallet has sufficient HYPE balance
  • Batch configuration is optimal for your needs

Step 8: Create and Monitor Progress

  • 1. Click "Create & Distribute Token (0.1 HYPE)"
  • 2. Confirm the initial token creation transaction
  • 3. Monitor the batch distribution progress

The progress modal shows:

  • • Current stage (Token Creation, Batch Distribution)
  • • Batch completion status
  • • Individual batch transaction details
  • • Overall progress percentage

Step 9: Advanced Success Results

The success modal for advanced mode shows additional information:

  • • Number of recipients
  • • Completed vs total batches
  • • Total percentage distributed
  • • Percentage kept by creator

Troubleshooting

Common Issues

"Insufficient Balance" Error

Problem: You don't have enough HYPE to pay the 0.1 HYPE creation fee.

Solution:

  • 1. Check your balance in the dApp
  • 2. Acquire more HYPE tokens
  • 3. Ensure you're connected to the correct wallet

"Wrong Network" Issues

Problem: You're not connected to the Hyperliquid network.

Solution:

  • 1. The dApp will automatically prompt you to switch networks
  • 2. Approve the network switch in your wallet
  • 3. If manual setup is needed:
  • • Network Name: Hyperliquid
  • • Chain ID: 999
  • • RPC URL: https://rpc.hyperliquid.xyz/evm

"Transaction Failed" During Batch Distribution

Problem: Transactions fail during advanced distribution.

Solution:

  • 1. Enable big blocks in your wallet settings
  • 2. Reduce batch size to 10-15 addresses
  • 3. Increase gas limit manually if needed
  • 4. Wait for network congestion to reduce

Gas and Performance Tips

For Large Distributions (1000+ Recipients)

  • 1. Use smaller batch sizes (10-15 addresses)
  • 2. Enable big blocks in wallet settings
  • 3. Distribute during low network activity periods
  • 4. Consider multiple smaller distributions instead of one large one

Wallet Settings for Advanced Mode

MetaMask Users:

  • 1. Go to Settings → Advanced
  • 2. Enable "Advanced gas controls"
  • 3. Enable "Customize transaction nonce"
  • 4. Increase gas limit for batch transactions

Trust Wallet Users:

  • 1. Go to Settings → Preferences
  • 2. Enable "Advanced mode"
  • 3. Manually set higher gas limits when prompted

Getting Help

If you encounter issues not covered in this guide:

  • 1. Check the browser console for error messages
  • 2. Verify network connectivity to Hyperliquid
  • 3. Try a different wallet if connection issues persist
  • 4. Contact support through official TokenSmith channels

This guide covers the complete token creation process for both Simple and Advanced modes. Keep this documentation handy while using TokenSmith for the best experience.

Back to TokenSmith