Spawned Web3Auth Deploy Guide: Full Integration Tutorial
This guide walks developers through deploying Web3Auth for tokens launched on Spawned. We cover the integration process, fee considerations for creator revenue (0.30% per trade), and managing post-graduation authentication. Integrating Web3Auth provides a familiar login experience while maintaining the economic benefits of the Spawned platform.
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.
Should You Integrate Web3Auth with Spawned?
The final recommendation for developers considering this integration.
For gaming or community tokens targeting mainstream users, integrating Web3Auth with your Spawned launch is strongly recommended. The combination delivers a powerful user onboarding funnel: users sign in with familiar social accounts, receive a wallet, and can immediately interact with your token. This removes the largest barrier to entry—managing seed phrases—while you retain the full economic model of Spawned, including the 0.30% creator revenue on every trade and the 0.30% ongoing holder reward distribution. The 0.1 SOL launch fee and post-graduation 1% fee structure remain unchanged. For purely DeFi-native tokens where self-custody is a feature, standard wallet connections may suffice.
Step 1: Prerequisites & Initial Setup
Gather these four essential components before starting the integration.
Before writing any code, ensure you have the following ready. This preparation prevents common deployment errors.
- A Live Spawned Token: You must have a token already launched on Spawned. The token's mint address and associated Token-2022 program account are required for the integration. Learn about launching a gaming token on Solana.
- Web3Auth Account & Project: Create a project in the Web3Auth Dashboard. Select 'Solana Mainnet' as your network and note your generated Client ID.
- Development Environment: Have Node.js (v18+) installed and a code editor ready. You'll need your Spawned project's private key (for deployment) stored securely.
- Spawned API Key: Obtain your project API key from your Spawned dashboard, needed to link the authentication layer to your token's trade data.
Step 2: Configuration & Deployment Script
A detailed walkthrough of the code and transaction required to link the systems.
This is the core integration process. We'll modify your token's metadata to point to the Web3Auth service.
- Install Required Packages: Run
npm install @web3auth/solana-provider @solana/web3.js @spawned-fi/sdkin your project directory. - Configure Web3Auth Client: In your frontend code, initialize the Web3Auth provider with your Client ID and the 'sapphire_mainnet' network. Set the login methods to your preferred social logins (e.g., Google, Discord).
- Link to Spawned Token: Use the Spawned SDK to fetch your token's mint. You will then create a transaction that updates a metadata field (or a custom Token-2022 extension) to store the Web3Auth configuration hash.
- Deploy the Update: Sign and send the transaction using your deployment wallet. This one-time action links your token's on-chain identity to the Web3Auth service. The 0.1 SOL launch fee has already been paid; this step incurs only standard Solana transaction fees.
- Verify the Link: Query your token's metadata on-chain to confirm the Web3Auth config data is present and correct.
Fee Impact: With vs. Without Web3Auth
A clear breakdown showing that your economics remain intact.
Integrating Web3Auth does not alter Spawned's core fee model; it adds a layer for user access. Understanding the financial flow is crucial.
| Fee Component | Standard Spawned Token | Spawned Token + Web3Auth | Notes |
|---|---|---|---|
| Launch Fee | 0.1 SOL | 0.1 SOL | One-time cost paid to Spawned. |
| Creator Revenue | 0.30% per trade | 0.30% per trade | Unchanged. You earn this on all swaps. |
| Holder Rewards | 0.30% per trade | 0.30% per trade | Unchanged. Distributed to token holders. |
| Post-Grad Fee | 1% (Token-2022) | 1% (Token-2022) | Perpetual fee after graduation from launchpad. |
| Auth Service Cost | $0 | Web3Auth Tier | Free tier available; paid tiers for higher volume. |
| Website Hosting | $29-99/mo (saved) | $29-99/mo (saved) | Use Spawned's AI builder for your auth portal. |
The key takeaway: your revenue streams (0.30% + 0.30% + 1%) are preserved. The only potential new cost is if you exceed Web3Auth's free usage limits.
Post-Deployment: Management & Monitoring
After successful integration, focus on these ongoing tasks to ensure a smooth user experience and track performance.
- Monitor Auth Logs: Use the Web3Auth dashboard to track user sign-ups, success rates, and any error patterns. High failure rates may indicate configuration issues.
- Link to AI Website: Build a dedicated landing page for your token using Spawned's included AI website builder. This page should host your 'Connect Wallet' button, which now triggers the Web3Auth modal. This consolidates your brand and saves external hosting fees.
- Track Revenue: Your Spawned dashboard remains the source of truth for your 0.30% creator revenue and holder reward distributions. Verify that trading volume from Web3Auth-connected wallets is being counted correctly.
- Plan for Graduation: When your token meets the criteria to graduate from the launchpad, the 1% perpetual fee via Token-2022 activates automatically. Inform your community that the Web3Auth login method will continue to function without interruption.
- Community Support: Prepare documentation or a simple FAQ for your users explaining how to log in with their social account and where their token wallet is managed.
Troubleshooting Common Integration Issues
Quick fixes for the problems you're most likely to encounter.
Even with a correct guide, issues can arise. Here are solutions to frequent problems.
- Issue: 'Invalid Client ID' on login.
- Solution: Double-check the Client ID in your code matches the project in the Web3Auth dashboard. Ensure you are using the correct network ('sapphire_mainnet' for Solana mainnet).
- Issue: Transaction fails when updating token metadata.
- Solution: Confirm your deployment wallet has sufficient SOL for transaction fees and is the correct upgrade authority for the token. Verify you are interacting with the correct Token-2022 program address from your Spawned launch.
- Issue: Users logged in but cannot see token balance.
- Solution: The Web3Auth wallet is a new wallet. Users must acquire your token via a trade or an airdrop. Consider a small promotional airdrop for new sign-ups to create initial balance visibility. Learn about airdrops.
- Issue: Trading volume from auth users not appearing in Spawned dashboard.
- Solution: Trades are recorded on-chain via the token mint address. Volume should appear regardless of wallet type. If it doesn't, contact Spawned support with specific transaction IDs to investigate.
Ready to Deploy?
You now have a complete guide to integrate Web3Auth with your Spawned token, enhancing accessibility while keeping your 0.30% creator revenue, 0.30% holder rewards, and future 1% fee structure. The included AI website builder can host your login portal, eliminating a recurring cost.
Next Steps:
- Ensure your token is live on Spawned.
- Create your Web3Auth project and get your Client ID.
- Follow the configuration steps to link the systems.
- Use the AI builder to create a landing page for your authenticated community.
Launching on another chain? Check our guides for Ethereum or Base.
Related Topics
Frequently Asked Questions
No. The integration is a front-end authentication layer. Your token's Solana program (using Token-2022) and all associated Spawned fees remain identical. You continue to earn 0.30% creator revenue per trade, distribute 0.30% in holder rewards, and will owe a 1% perpetual fee post-graduation. The 0.1 SOL launch fee is a one-time cost paid earlier.
Yes. Integrating Web3Auth does not disable standard wallet connections. Your website or app can offer both login methods. A user with Phantom can connect it directly, while a new user can choose Google login via Web3Auth. Both will interact with the same on-chain token contract and generate the same revenue for you.
Web3Auth uses a non-custodial, distributed key management model. The private key is sharded between the user's device and Web3Auth's network. Neither Spawned nor you, the token creator, have control or access to these user wallets. This maintains decentralization while offering social recovery options for users.
Nothing changes for the user experience. The authentication layer is independent of the launchpad phase. After graduation, your token continues to operate on Solana with the Token-2022 standard, and the 1% perpetual fee is active. Users will still log in via Web3Auth as before. Your responsibility is to maintain your Web3Auth project subscription if you exceed free tier limits.
Absolutely. This guide is designed for post-launch integration. As long as you are the upgrade authority for your token (which you are from a Spawned launch), you can execute the transaction to update its metadata with the Web3Auth configuration at any time. Your existing holders and volume are unaffected.
The mechanism is unchanged and fully automatic. The 0.30% of every trade is distributed pro-rata to all token holders, recorded on-chain. Whether a holder uses a Web3Auth wallet, Phantom, or any other wallet, if they hold your token, they receive the rewards. The authentication method is irrelevant to the reward distribution smart contract.
Web3Auth is infrastructure, not a gatekeeper. They provide authentication services. Your token's availability and trading depend on the Solana blockchain and Spawned's/Token-2022's program rules. As with any third-party service, you should review Web3Auth's terms of service. To mitigate risk, you can inform users they can always export their private key from Web3Auth to a self-custody wallet.
Ready to get started?
Join thousands of users who are already building with Spawned. Start your project today - no credit card required.