Mint

This guide explains how to mint additional supply to an existing SPL token using the Toolther interface at https://toolther.app/mint_token. It covers prerequisites, step-by-step actions, authority requirements, fees, and common errors.


1. Prerequisites

  • Connected wallet: Phantom, Solflare, Backpack, or Ledger (via Solflare).

  • Network selected: Devnet or Mainnet. Ensure the wallet network matches the app network.

  • You are the token’s current Mint Authority. If it was revoked or transferred, you cannot mint.

  • Sufficient SOL for fees and rent-exempt adjustments if needed.


2. Page Layout Reference

  • Header: Connect Wallet button and navigation.

  • Main card: “Select Token to Mint” with a refresh button and token selector.

  • Helper notice: “No tokens found” with a suggestion to refresh.

  • Right sidebar (desktop): Quick actions (Mint Tokens, Revoke Mint Authority, How to use?).

  • Mobile menu: Create, Mint, Freeze, Update, Burn.


3. Step-by-Step Minting

  1. Connect your wallet

  • Click “Connect Wallet” in the header and approve connection.

  1. Choose network and explorer (optional)

  • Ensure the network in the app matches your wallet network. Explorer choice only affects links shown after confirmation.

  1. Load your tokens

  • Click the refresh button in the “Select Token to Mint” card.

  • If you see “Initializing network…”, wait a few seconds.

  1. Pick the token

  • Open the selector and choose the token where your connected wallet holds the Mint Authority.

  1. Enter mint parameters

  • Amount to mint: human-readable units (the app applies decimals automatically).

  • Recipient address: defaults to your wallet. You may paste another recipient address or a token account.

  • Optional: Create associated token account if the recipient does not have one.

  1. Review and confirm

  • Click “Mint” (or “Mint Tokens”).

  • Approve the transaction in your wallet popup.

  • Wait for confirmation; the page will show the signature and updated balance.


4. Field Details and Validation

  • Token selector: lists tokens where your wallet is mint authority (and possibly tokens discovered via RPC).

  • Amount: must be a positive number. The app converts to base units using the token’s decimals.

  • Recipient: a valid Solana address. If no associated token account exists, the app prompts to create one.


5. Authorities and Safety

  • Mint Authority is required to create new supply. If it is revoked or assigned to another key, minting fails.

  • Consider best practice: after minting final supply, revoke mint authority to prevent future inflation.

  • Freeze Authority (if present) does not affect minting, only account-level freezing.


6. Troubleshooting

  • No tokens found: Click refresh. Verify your wallet truly controls Mint Authority for the token. Confirm RPC/network.

  • Disabled selector: The app may still be initializing or your wallet is not connected.

  • Insufficient funds: Add SOL to cover fees, then retry.

  • Invalid recipient: Check the address format and network (devnet vs mainnet).

  • Mint failed after approval: Open the transaction in the explorer from the provided link to inspect logs.


7. Programmatic Equivalent (TypeScript)

Notes:

  • amount is in human units; conversion uses on-chain mint.decimals.

  • If your project uses Token-2022, ensure the correct program is targeted.


  • Revoke Mint Authority: see the action in the sidebar or the dedicated page.

  • SPL vs Token-2022: understand compatibility and features before minting.

  • Metadata updates: does not require mint authority; it uses update authority.


9. Best Practices Checklist

  • Verify you are on the correct network.

  • Double-check amount and recipient before approving.

  • Record the transaction signature for audit.

  • Revoke mint authority when total supply is finalized.

Last updated