How to Customize and Integrate Metamask for Spawned Tokens
This guide provides developers with a technical walkthrough for customizing Metamask to interact with tokens launched on Spawned. We cover Solana, Ethereum, and Base network configurations, focusing on practical setup steps and the specific benefits for token creators. Proper integration ensures your community can easily manage and trade your token.
Try It NowKey Benefits
The Problem
Traditional solutions are complex, time-consuming, and often require technical expertise.
The Solution
Spawned provides an AI-powered platform that makes building fast, simple, and accessible to everyone.
Why Customize Metamask for Spawned Tokens?
The verdict is clear: proper wallet integration directly impacts your token's success.
For tokens launched on Spawned, ensuring broad wallet compatibility is a direct factor in adoption and trading volume. While Metamask is the default for Ethereum and EVM chains like Base, Spawned’s core launchpad is built on Solana. Therefore, customization is not optional—it's essential for providing a complete user experience. A well-configured wallet setup helps capture the full value of Spawned's model: facilitating the 0.30% creator revenue per trade and enabling the 0.30% ongoing holder rewards by making the token easy to hold and trade. Neglecting this step can create friction that costs you volume and community trust.
For a broader context, see our guides on how to create a gaming token on Solana and how to launch a gaming token on Ethereum.
Step-by-Step: Adding Custom Networks to Metamask
Start by teaching your users how to add the correct networks.
Metamask needs to be told about the specific networks your token lives on. Follow these steps for each relevant chain.
For Ethereum (Mainnet):
- Open Metamask and click the network dropdown.
- Select "Add network" and then "Add a network manually."
- Enter the standard Ethereum Mainnet details (Chain ID: 1). This is often pre-loaded, but verify.
For Base Network:
- In the "Add network" flow, use these parameters:
- Network Name:
Base Mainnet - RPC URL:
https://mainnet.base.org - Chain ID:
8453 - Currency Symbol:
ETH - Block Explorer:
https://basescan.org
- Network Name:
Critical Note for Solana: Metamask does not natively support Solana. Users will primarily use wallets like Phantom. Your guide should instruct them to bridge assets (e.g., via Wormhole) or use a multi-wallet setup. For a pure Solana launch, direct users to Phantom. The integration work here is educational, not technical within Metamask.
How to Import Your Spawned Token Contract
Once the network is added, users must import the token to see their balance. This process is similar for Ethereum and Base.
- Locate Your Token Contract Address: After launching on Spawned, you receive a contract address. For Solana, this is a mint address. For EVM chains, it's a 0x... address.
- In Metamask (EVM Chains): On the correct network (Ethereum or Base), go to the 'Assets' tab and click 'Import tokens.'
- Paste the Address: The token symbol and decimals should auto-populate. Verify they match your token details (e.g., 18 decimals for Ethereum-standard tokens).
- For Solana Tokens (Phantom): In the Phantom wallet, click the '+' icon in the tokens list and paste your Solana mint address. This is the primary method for Solana-based Spawned launches.
- Verification: Send a small test amount to a new wallet address to confirm the token displays correctly.
Wallet Strategy: Metamask vs. Native Solana Wallets
Choose the right wallet for the right chain to minimize support requests.
Understanding the wallet landscape helps you guide your community effectively. Spawned’s multi-chain approach means you must consider both EVM and Solana ecosystems.
| Aspect | Metamask (for Ethereum/Base) | Phantom (for Solana) |
|---|---|---|
| Primary Use | Holding/trading EVM-based Spawned tokens. | Essential for Solana-based Spawned launches. |
| User Base | Very large, but needs network config. | Large within Solana, native support. |
| Spawned Fee Support | Supports 0.30% trade fee & holder rewards on EVM chains. | Directly supports all Solana launch fees and rewards. |
| Setup Complexity | Requires manual network add for Base. | Simple add of token mint address. |
| Our Recommendation | Use for EVM chains. Guide users through Base/Ethereum setup. | Required for Solana. This is the primary wallet for Solana launches. |
The best practice is to provide clear instructions for both. If your token is on Solana, prioritize Phantom guides but explain how EVM users can bridge. For more on chain choice, read how to create a gaming token on Base.
Advanced Configuration for Developers
As a developer, your responsibility extends beyond basic imports. To fully support the Spawned economic model, consider these advanced steps.
1. Custom RPC Endpoints: While public RPCs work, they can be slow. For a better user experience, especially during high-volume trading that generates the 0.30% creator fee, consider providing a dedicated RPC endpoint from a service like Alchemy or QuickNode for your EVM token. This can speed up transactions.
2. Token Lists (EVM): Get your token listed on community token lists like the Uniswap Labs list. This allows Metamask and other interfaces to automatically recognize your token, removing the need for manual import. This directly reduces friction for new buyers.
3. DApp Integration: If you build a website using Spawned's AI builder (saving $29-99/month), integrate wallet connection buttons for both Metamask (EVM) and Phantom (Solana). Use standard web3 libraries like ethers.js for EVM and @solana/web3.js for Solana. Test purchases and swaps to ensure the 0.30% fees are processed correctly.
4. Post-Graduation (Token-2022): For Solana tokens that graduate from Spawned's launchpad, the 1% perpetual fee uses the Token-2022 program. Ensure your documentation notes that holders must use a Token-2022 compatible wallet, which includes the latest versions of Phantom.
Troubleshooting Common Integration Issues
Anticipate and solve these frequent problems to support your community.
-
Problem: Token balance not showing after import.
- Solution: Confirm the user is on the correct network in Metamask (e.g., Base Mainnet, not Ethereum). Verify the contract address is correct. On Solana/Phantom, confirm the mint address is correct.
-
Problem: Transactions failing or pending.
- Solution: This is often an RPC issue. Guide the user to switch their RPC endpoint. In Metamask, go to Settings > Networks > [Network Name] > change the RPC URL. For Solana, users can change the RPC in Phantom settings.
-
Problem: User cannot find Base network in Metamask.
- Solution: They may need to enable "Show test networks" in Metamask settings, or simply use the "Add network" manual process outlined in the steps section.
-
Problem: Fees seem incorrect.
- Solution: Remind users of the Spawned fee structure: 0.30% creator fee per trade, 0.30% holder rewards, and the 1% fee post-graduation. These are protocol-level and should not be adjusted in the wallet.
Ready to Launch Your Token with Built-In Wallet Guides?
Customizing wallet integration is a key technical step after launching your token. By following this guide, you ensure your community can easily buy, hold, and trade your token, directly supporting its volume and the sustainable reward model.
Launching on Spawned provides the foundation: a 0.1 SOL (~$20) launch fee, an included AI website builder to host these very instructions, and a full economic model with creator and holder rewards. The easier you make it for people to use their preferred wallet, the more successful your launch will be.
Start your token launch on Spawned today. For specific launch steps, see our guide on how to launch a gaming token on Solana.
Related Topics
Frequently Asked Questions
Not directly. Metamask is built for EVM chains like Ethereum and Base. For a Solana token launched on Spawned, your holders must use a Solana-native wallet like Phantom. Your role is to provide clear instructions for Phantom setup and explain bridging options for users who want to move assets from EVM chains to Solana.
To add Base Mainnet manually: Network Name: `Base Mainnet`, RPC URL: `https://mainnet.base.org`, Chain ID: `8453`, Currency Symbol: `ETH`, Block Explorer URL: `https://basescan.org`. Using the correct RPC is vital for smooth transactions that generate the 0.30% creator revenue per trade.
The most common reason is being on the wrong network. If your token is on Base, ensure Metamask is switched to 'Base Mainnet,' not 'Ethereum Mainnet.' Double-check the token contract address you entered. For Solana tokens, remember they will only appear in a wallet like Phantom, not in Metamask.
The fees are protocol-level and enforced by the smart contract or token program on-chain. Proper wallet configuration (correct network, RPC) ensures transactions are broadcast successfully so these fees can be applied. The 0.30% creator fee and 0.30% holder rewards are taken automatically during trades; your wallet setup doesn't change them, it just enables the trades.
The core process is very similar—both are EVM chains. The key difference is the network configuration step. For Ethereum, the network is usually pre-loaded. For Base, users must add it manually. The token import process is identical once on the correct network. Review our specific guides for [Ethereum](/use-cases/token/how-to-create-gaming-token-on-ethereum) and [Base](/use-cases/token/how-to-create-gaming-token-on-base).
Token-2022 is an upgraded Solana token program that supports advanced features like transfer fees. When a Solana token graduates from the Spawned launchpad, it utilizes Token-2022 to enforce the 1% perpetual fee. Holders must ensure they are using a wallet that supports Token-2022, such as the latest version of Phantom.
Absolutely. The included AI website builder (saving $29-99/month) is the perfect place to publish this exact customization guide for your token. You can create a clear 'How to Buy' page with step-by-step instructions and screenshots for Metamask and Phantom, centralizing support and improving user onboarding.
Ready to get started?
Join thousands of users who are already building with Spawned. Start your project today - no credit card required.