Spawned Wallet-Connect Integration Guide for Solana Token Developers
This guide provides a clear, step-by-step process for integrating Wallet-Connect with tokens launched on the Spawned platform. Proper integration allows token holders to connect their wallets securely, participate in trading, and access the platform's 0.30% holder rewards. We'll cover the technical setup, security considerations, and how this benefits your token's community.
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 Wallet-Connect Integration is Essential for Your Spawned Token
The direct link between your community's wallets and your token's economics.
Integrating Wallet-Connect is not optional for a successful token launch on Spawned; it's a core requirement for community access and revenue distribution. Without it, holders cannot connect their wallets to the token's project page, participate in secure swaps, or claim their share of the 0.30% ongoing rewards generated from every trade. This directly impacts holder retention and the project's long-term viability. We strongly recommend completing this integration during the initial launch setup on Spawned to avoid fragmentation and ensure all promised benefits are delivered from day one. Learn more about launching gaming tokens on Solana for additional context.
Step-by-Step Integration Process
A technical walkthrough to get Wallet-Connect live for your community.
Follow these steps to integrate Wallet-Connect for your token. Ensure you have launched your token on Spawned and have admin access to its project dashboard.
- Access Your Token Dashboard: After launching your token for 0.1 SOL, navigate to your project's dashboard on Spawned.com.
- Navigate to 'Connect' Settings: Find the 'Wallet Integration' or 'Connect Settings' section within your project's admin panel.
- Generate Connection URI: Use the platform's tool to generate a unique Wallet-Connect project ID and connection URI specific to your token.
- Configure Allowed Chains: Set the configuration to primarily support Solana Mainnet. You can optionally add devnet for testing.
- Embed the Connection Widget: Spawned provides a snippet of code or a widget to embed on your project's AI-built website. This is the interface users will see.
- Test the Connection: Before announcing, test the connection flow with a non-admin wallet (e.g., Phantom, Solflare) to ensure a smooth user experience.
- Verify Reward Tracking: Confirm in your dashboard that connected wallets are being tracked for the 0.30% holder reward distribution.
Wallet-Connect vs. Native Wallet Integration on Spawned
Choosing the right connection path for your audience.
Spawned supports multiple connection methods. Understanding the difference helps you communicate with your community.
| Feature | Wallet-Connect Integration | Native Wallet Extension (e.g., Phantom) |
|---|---|---|
| Primary Use Case | Mobile & cross-app connectivity. Users scan a QR code. | Desktop browsers with extensions installed. |
| User Friction | Low for mobile users; requires a QR scan. | Very low for desktop users with the extension. |
| Spawned Reward Eligibility | Yes. Connected wallets qualify for the 0.30% holder reward. | Yes. Also fully qualifies for rewards. |
| Security Model | Peer-to-peer encrypted pairing. No central servers hold keys. | Relies on the browser extension's security. |
| Best For | Reaching the broadest audience, including mobile-centric users. | Optimizing for the core Solana desktop community. |
Key Point: Implementing Wallet-Connect does not replace native extensions; it complements them. Spawned's system recognizes both, ensuring all holders can access rewards.
How Integration Activates Holder Rewards and Fees
Connecting wallets unlocks the revenue-sharing mechanics.
The Wallet-Connect integration is the technical bridge that activates Spawned's unique economic model for your token holders. Here’s the direct impact:
- 0.30% Holder Rewards: Every trade of your token on Spawned incurs a 0.30% fee. This fee is distributed proportionally to all token holders whose wallets are connected and verified through this integration. Without a proper connection, a holder's wallet is invisible to the reward distribution smart contract.
- Creator Revenue: As the creator, you simultaneously earn a separate 0.30% from every trade. This is independent of the holder rewards but relies on the same robust trading activity that integration fosters.
- Post-Graduation (Token-2022): When your token graduates from the initial launch phase, it transitions to Solana's Token-2022 program. A 1% perpetual fee on transfers is enabled. The Wallet-Connect integration ensures the community layer and project recognition persist, supporting long-term project governance or treasury functions.
In essence, the integration turns a static token into a participatory asset within the Spawned ecosystem.
Common Integration Issues and Solutions
Quick fixes for the most frequent technical snags.
Developers often encounter a few specific hurdles. Here’s how to resolve them.
- Issue: 'Connection Failed' or QR Code Not Working.
- Solution: Verify your Wallet-Connect project ID in the Spawned dashboard is correctly entered and the allowed blockchain list includes
solana:mainnet. Clear any cached project data in the dashboard and regenerate the connection URI.
- Solution: Verify your Wallet-Connect project ID in the Spawned dashboard is correctly entered and the allowed blockchain list includes
- Issue: Connected Wallet Not Showing in Holder List / Not Receiving Rewards.
- Solution: First, confirm the wallet holds a balance of your token. Then, check the dashboard's 'Connected Holders' section. There can be a 1-2 minute delay for new connections to appear in the reward calculation cycle. Ensure the wallet is connected via the project's official website (built with Spawned's AI builder), not a generic Wallet-Connect interface.
- Issue: Mobile Connection is Unstable.
- Solution: This is often app-specific. Guide users to ensure their mobile wallet app (like Phantom Mobile) is updated to the latest version. Recommend they try the connection in a stable network environment.
Security and Communication Best Practices
A secure integration builds trust. Follow these guidelines.
- Official Links Only: Always direct users to connect via your official Spawned AI-generated website. Never ask users to connect wallets via links in email or unofficial social media channels.
- Clear Instructions: Pin a simple guide in your project's Telegram or Discord: '1. Go to [YourProject].com 2. Click 'Connect Wallet' 3. Scan the QR code with your mobile wallet.'
- Verify Contract: Educate users that the first time they connect, they should see a prompt for your specific token name and Spawned platform. This verifies they are connecting to the correct, authentic site.
- Dashboard Security: Use strong, unique credentials for your Spawned project dashboard where the Wallet-Connect ID is configured. This is your control panel.
Ready to Connect Your Community?
Integrating Wallet-Connect is a definitive step toward building a sustainable token economy with engaged, rewarded holders. By following this guide, you enable the full suite of Spawned benefits: from the initial 0.30% creator revenue and holder rewards to the structured path toward the Token-2022 program with its 1% perpetual fee.
If you haven't launched your token yet, start the process on Spawned for 0.1 SOL and use the built-in AI website builder to create your project's home base—this is where your Wallet-Connect integration will live. Explore how to create a gaming token on Solana as your next step.
Launch, integrate, and build a token that rewards its holders.
Related Topics
Frequently Asked Questions
While you can technically launch a token without it, integration is strongly required to access Spawned's core features. Without it, holders cannot connect to claim their 0.30% share of trade fees, significantly reducing the token's value proposition. The integration is a standard part of the project setup process.
No. The Wallet-Connect integration is a feature included with your token launch on Spawned for the standard 0.1 SOL fee. There are no additional charges for configuring or using the integration to connect holder wallets and enable the reward distribution system.
The integration is designed to work seamlessly with the AI-built website provided by Spawned, which is included at no monthly cost ($29-99 value). While technically possible to implement elsewhere, it requires manual configuration of the Token-2022 program interfaces. We recommend using the included AI builder for a guaranteed, supported integration.
Rewards are accrued continuously and distributed on a per-trade basis. The mechanism is built into the trading function on Spawned. When a holder's connected wallet initiates a swap or trade, their proportional share of the 0.30% fee from that specific trade is automatically added to their transaction. There's no manual claiming process for standard trades.
The integration remains active and becomes even more important. Post-graduation, your token migrates to Solana's Token-2022 program, enabling a 1% perpetual fee on transfers. The existing Wallet-Connect setup ensures your project's community layer and website remain the central hub for holders, supporting governance or utility functions tied to the new token standard.
Wallet-Connect is an open-source protocol that establishes a secure, encrypted connection between a user's wallet and your project's website. It does not custody private keys. The primary security responsibility lies in ensuring you direct users to your authentic, official website (your Spawned AI-built site) to initiate the connection, not a phishing copy.
Yes, a single user can connect multiple wallets (e.g., a Phantom desktop wallet and a Solflare mobile wallet). Each wallet will need to connect individually via Wallet-Connect or a native extension. The 0.30% holder rewards are calculated and distributed per-wallet address based on the token balance in that specific connected wallet.
Ready to get started?
Join thousands of users who are already building with Spawned. Start your project today - no credit card required.