Spawned Token Integration: A Complete Metamask Customization Guide
This guide provides developers with specific instructions for adding and customizing Spawned-launched Solana tokens within the Metamask wallet. We cover network setup for Solana, handling the Token-2022 standard, and ensuring proper display and functionality for your community. Proper integration is key for user adoption post-launch.
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.
The Developer Verdict: Custom Integration Is Non-Negotiable
Visibility drives adoption. Here's how to secure it.
For any token launched on Spawned, ensuring it appears correctly in popular wallets like Metamask is a fundamental step. While Spawned's AI builder creates your site and the launchpad handles the initial distribution, wallet visibility is a manual, post-launch task for creators. We strongly recommend completing this integration before major marketing pushes. Tokens that aren't easily viewable in wallets like Metamask face immediate friction, reducing potential holder growth and the benefits of your 0.30% creator revenue and 0.30% holder reward streams. This guide provides the exact, non-technical steps to solve this.
Step 1: Add the Solana Network to Metamask
The foundational step—without it, nothing else works.
Metamask does not natively support Solana. Your users must add it as a custom network. Provide these details in your project documentation or community guides.
Network Configuration Details:
- Network Name: Solana Mainnet
- New RPC URL:
https://api.mainnet-beta.solana.com(Consider suggesting public RPCs or dedicated services for reliability) - Chain ID:
101 - Currency Symbol:
SOL - Block Explorer URL:
https://explorer.solana.com
Important Note: Users must manually add this network. As a creator, you can simplify this by linking to a network addition guide or tool. Remind them that their SOL balance and Spawned tokens will appear under this network, not Ethereum.
Step 2: Find Your Spawned Token's Critical Information
To add a custom token, you need specific data from the Solana blockchain. All this information is available after your launch on Spawned.
You need to collect and share:
- Token Mint Address: This is the unique contract address on Solana. Find it on your Spawned project dashboard or on Solana explorers like Solscan.
- Token Symbol: The ticker (e.g.,
GAME,CREW). Ensure it matches exactly what was set during launch. - Token Decimals: For most new tokens, especially those aiming for accessibility, this is
9. Double-check your token's metadata. - Token Name: The full name of your project's token.
Step 3: The Custom Token Addition Process
The core action for making your token visible.
Once the Solana network is active in Metamask, guide your users through adding the token itself.
- In Metamask, ensure the 'Solana Mainnet' network is selected.
- Scroll to the bottom of the assets list and click 'Import tokens'.
- Switch to the 'Custom Token' tab.
- Paste your Token Mint Address into the 'Token Contract Address' field. Metamask should auto-populate the Symbol and Decimals.
- Verify the Symbol and Decimals (
9) are correct. - Click 'Add Custom Token' and then confirm the addition.
Result: The token should now appear in the user's asset list with their balance. If the balance shows zero, they may need to acquire the token first via a DEX or airdrop.
Understanding the Token-2022 Standard
Spawned utilizes Solana's Token-2022 program for launches. This is an upgraded standard with more features than the legacy Token program. Most importantly for this guide, some wallet interfaces, including older versions or certain configurations of Metamask via Snap, may require explicit support for Token-2022.
What this means for you:
- The addition process is identical, but the underlying program is different.
- If users encounter issues, the likely culprit is their wallet's support for the Token-2022 program ID.
- Direct them to check that their wallet provider (like the Solana Snap for Metamask) is updated to the latest version. The vast majority of public RPCs now support Token-2022.
This is a technical detail, but being aware of it allows you to provide better support. Your token's advanced features, like the perpetual 1% fee structure post-graduation, are enabled by this standard.
Solana vs. Ethereum/Base: Integration Differences
If you've launched tokens on other chains, note the key differences in integrating with Metamask.
| Aspect | Solana (via Spawned) | Ethereum / Base (via other methods) |
|---|---|---|
| Network Setup | Manual addition required. Users add Solana as a custom network. | Native. Ethereum and Base are pre-installed networks in Metamask. |
| Token Standard | Token-2022 program. More features, requires wallet support check. | ERC-20 standard. Universally recognized by Metamask. |
| Fee Model Context | Spawned's 0.30% creator/holder fees and 1% post-grad fee are native to Solana. | Typical Ethereum launches involve different fee structures on platforms like Uniswap. |
| Guide Relevance | This specific guide is necessary. | Guides like how to create a gaming token on Ethereum would focus on different steps. |
For creators considering multi-chain, see our guides for Ethereum and Base.
Next Steps After Successful Integration
Once your token is successfully viewable in Metamask, your work as a creator continues.
- Document & Share: Create a simple, pinned post in your community with the network details and token address. Use the guide format from this article.
- Verify Functionality: Test the entire flow yourself—add network, add token, receive a test transaction. Ensure your Spawned AI website has a clear 'How to Buy' section linking to this info.
- Monitor Rewards: Educate your holders that the 0.30% ongoing holder rewards will accrue and should be visible as increasing token balances over time within their Metamask wallet.
- Plan for Graduation: Remember, after moving from Spawned's launchpad to full independence, the 1% perpetual fee structure via Token-2022 remains active. Clear wallet integration ensures smooth operation post-graduation.
Ready to Launch Your Integrated Token?
Customizing Metamask for your token is a critical final step after launch. Spawned handles the complex parts—the token generation, the initial liquidity, the AI website builder (saving you $29-99/month), and the fee structure designed for creator and holder revenue.
Your next step is to launch a token that's ready for this integration from day one.
Launch your fully-prepared Solana token on Spawned for a 0.1 SOL fee (~$20) and build a project with sustainable rewards built in.
Related Topics
Frequently Asked Questions
Metamask's default token list is primarily for Ethereum-based ERC-20 tokens. Solana tokens, especially those from new launches on Spawned using the Token-2022 standard, are not on this list. They must be added manually using the token's mint address, which ensures you are adding the correct and verified asset.
A zero balance means the wallet address you are using does not hold any of that specific token. Verify that you or your user has actually acquired the token through a purchase on a DEX, an airdrop, or other distribution method. The custom token addition only makes a *placeholder* for the token visible; it does not create a balance.
The main risk is entering incorrect RPC URL information, which could lead to failed transactions or incorrect balance displays. Always use reputable, public RPC endpoints. Adding a custom token itself is low-risk, but ensure you have the correct contract address from an official source (like your Spawned project page) to avoid adding a fraudulent token with a similar name.
No. The 0.30% holder reward mechanism is built into the token's smart contract on the Solana blockchain. Rewards are distributed automatically to holding addresses. However, for holders to *see* their accumulating reward balance in their Metamask wallet, they need to have the token added correctly. The rewards functionality works regardless of wallet visibility.
Using 9 decimals (like SOL itself) is a Solana convention that allows for high precision while maintaining simple whole-number token supplies. It provides flexibility for micro-transactions and reward distributions. This is different from Ethereum's common 18 decimals. Always confirm your token's decimal setting from the blockchain data.
The core concept is similar, but the steps are simpler for Ethereum. Since Metamask natively supports Ethereum, you would only need to add the custom ERC-20 token using its contract address. For a detailed Ethereum-specific launch process, refer to our guide on [how to launch a gaming token on Ethereum](/use-cases/token/how-to-launch-gaming-token-on-ethereum).
Nothing changes from the user's wallet perspective. The token's mint address, network, and visibility remain identical. The key change is on the backend: your token begins accruing the 1% perpetual fee on transactions as per the Token-2022 program. Holders will continue to see their balances and rewards in Metamask as before.
Ready to get started?
Join thousands of users who are already building with Spawned. Start your project today - no credit card required.