Documentation
Learn how w3Swap enables secure token migration with instant liquidity on Solana
Overview
w3Swap is a secure token migration platform built on Solana that enables projects to migrate their tokens to new versions while providing instant liquidity through automated liquidity pool creation. Our platform ensures both security and immediate trading capability for migrated tokens.
Security First
Smart contracts enforce migration rules. SOL commitment from project admins ensures completion.
Instant Liquidity
Meteora DLMM pools are created automatically upon activation, enabling immediate trading.
Enhanced Trading
Post-migration, old tokens are sold and proceeds added to LP, creating deeper liquidity.
How It Works
1Project Creation
Project admins create a migration project by specifying:
- Old and new token mints
- Exchange ratio between old and new tokens
- Migration period (start and end times)
- Initial liquidity parameters for the LP
- SOL commitment amount (ensures project completion)
2Activation & LP Creation
When the project admin activates the migration:
- SOL commitment is locked in the smart contract
- New token is created (SPL Token or Token-2022)
- Meteora DLMM liquidity pool is automatically created
- Initial liquidity is provided based on configured parameters
- Migration becomes active and available to token holders
3Token Migration
Token holders can migrate their tokens:
- Connect wallet and browse active migration projects
- Select a project and enter the amount of old tokens to migrate
- Preview the exchange rate and amount of new tokens to receive
- Confirm and execute the migration transaction
- Receive new tokens immediately in your wallet
4Settlement & LP Enhancement
When the migration period ends:
- Old tokens collected during migration are automatically sold
- Proceeds from the sale are added to the liquidity pool
- This creates deeper liquidity for the new token
- LP tokens are locked for 90 days to ensure long-term stability
- SOL commitment is released (or forfeited if migration failed)
For Token Holders
Getting Started
To migrate your tokens:
- Connect your Solana wallet (Phantom, Solflare, etc.)
- Navigate to the Migrate page
- Browse active migration projects
- Select a project and review the exchange rate
- Enter the amount of old tokens to migrate
- Confirm the transaction in your wallet
- Receive your new tokens immediately
Safety & Protection
Your migration is protected by:
- Smart Contract Security: All migrations execute on-chain via verified contracts
- SOL Commitment: Project admins must lock SOL, ensuring project completion
- Instant Liquidity: LP is created immediately, so you can trade right away
- Transparent Exchange Rates: Rates are set upfront and visible before migration
- No Hidden Fees: All fees are disclosed before you confirm
For Project Admins
Creating a Migration Project
Step 1: Create New Token (Optional)
If you haven't created your new token yet, you can use the Token Creation tool to mint a new SPL Token or Token-2022 with custom extensions.
Step 2: Project Configuration
Fill out the project creation form with:
- Old token mint address
- New token mint address
- Exchange ratio (e.g., 1:1, 100:1, etc.)
- Migration start and end times
- SOL commitment amount
Step 3: Fund & Activate
Fund the project with the required SOL commitment and initial liquidity. Once funded, activate the project to create the LP and start accepting migrations.
LP Configuration
When activating your project, you'll configure the Meteora DLMM liquidity pool:
- Initial Price: Starting price for the new token in SOL
- Liquidity Amount: Initial SOL and new token amounts
- Trading Fees: Fee percentage for swaps (collected by LP)
- Price Range: Min/max price bounds for the pool
Project Management
Once your project is active, you can:
Monitor Progress
Track migrations, volume, and user count
Manage Timeline
View time remaining and migration status
LP Lock Period
90-day lock ensures long-term liquidity
Automatic Settlement
Old tokens sold and proceeds added to LP
Security & Safety
Smart Contract Security
- All migrations execute on-chain via verified Solana programs
- Immutable exchange rates set at project creation
- No single point of failure - decentralized execution
SOL Commitment Protection
- Project admins must lock SOL as commitment
- SOL is only released after successful migration completion
- Protects users from abandoned or incomplete projects
Instant Liquidity Guarantee
- LP created automatically upon activation
- No waiting period - trade immediately after migration
- Enhanced liquidity after settlement
Transparent Process
- All parameters visible before you migrate
- On-chain transaction history
- Real-time migration statistics
Supported Token Standards
SPL Token (Legacy)
The standard Solana Program Library token. Supports basic token functionality including transfers, minting, and burning.
Token-2022 (Token Extensions)
The next-generation token standard with advanced features including transfer hooks, metadata extensions, interest-bearing tokens, and more.
Frequently Asked Questions
How long does a migration take?
The migration transaction executes instantly on Solana. Once confirmed, your new tokens appear in your wallet immediately. The migration period (set by project admins) typically ranges from a few days to several weeks.
What happens to my old tokens?
Old tokens are collected during the migration process. When the migration period ends, these old tokens are automatically sold, and the proceeds are added to the liquidity pool for the new token, creating deeper liquidity.
Can I trade my new tokens immediately?
Yes! The Meteora DLMM liquidity pool is created automatically when the project is activated, so you can trade your new tokens immediately after migration. No waiting period required.
What if I miss the migration window?
Once the migration period ends, you won't be able to migrate through the platform. However, project admins may provide alternative migration methods. Check with the project team for details.
Are there any fees?
Standard Solana transaction fees apply (typically ~0.000005 SOL). Project admins may configure platform fees, which are disclosed before you confirm the migration. All fees are visible in the transaction preview.
Ready to Get Started?
Whether you're a token holder looking to migrate or a project admin creating a migration, w3Swap makes the process secure and straightforward.