> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shift.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# User Guide - Token Migrations

> Complete guide for token holders participating in migrations

## Token Migration User Guide

This guide will walk you through the complete process of participating in a token migration on Shift.fun. Whether you're a first-time user or an experienced participant, this guide covers everything you need to know.

## Getting Started

### What is a Token Migration?

A token migration allows you to move your tokens from one Solana launchpad to another while preserving your holdings and joining a new, enhanced platform. Your tokens maintain their value, and you get access to better features and trading opportunities.

<Note>
  **Key Benefits**: No value loss, community preservation, enhanced features, and platform freedom.
</Note>

## Prerequisites

### Before You Start

<Steps>
  <Step title="Solana Wallet">
    You'll need a Solana-compatible wallet:

    * **Phantom** (Recommended)
    * **Solflare**
    * **Backpack**
    * **Any Solana wallet**
  </Step>

  <Step title="Token Holdings">
    * Hold the token being migrated
    * Ensure you have enough SOL for transaction fees
    * Verify your wallet connection
  </Step>

  <Step title="Information Gathering">
    * Get the migration wallet address from the project team
    * Understand the migration timeline
    * Know the target platform (usually Meteora)
  </Step>
</Steps>

## Step-by-Step Migration Process

### Step 1: Discovery & Information

<Steps>
  <Step title="Learn About the Migration">
    * **Source**: Project team announcement
    * **Timeline**: Check migration countdown
    * **Requirements**: Understand participation rules
    * **Benefits**: Learn about the target platform
  </Step>

  <Step title="Verify Migration Details">
    * **Official Links**: Only use official migration links
    * **Wallet Address**: Verify the migration wallet address
    * **Project Team**: Confirm with the project's official channels
    * **Timeline**: Check the migration deadline
  </Step>
</Steps>

<Warning>
  **Security First**: Always verify migration details through official project channels. Never trust unofficial sources or suspicious links.
</Warning>

### Step 2: Connect Your Wallet

<Steps>
  <Step title="Visit Migration Page">
    * Go to the official migration page
    * Look for the "Connect Wallet" button
    * Ensure you're on the correct URL
  </Step>

  <Step title="Wallet Connection">
    * Click "Connect Wallet"
    * Select your wallet provider (Phantom, Solflare, etc.)
    * Approve the connection in your wallet
    * Wait for connection confirmation
  </Step>

  <Step title="Verify Connection">
    * Check that your wallet address is displayed
    * Confirm your token balance is visible
    * Ensure you can see the migration interface
  </Step>
</Steps>

### Step 3: Review Migration Details

<Steps>
  <Step title="Check Migration Information">
    * **Source Token**: Verify the token you're migrating
    * **Target Platform**: Confirm the destination (usually Meteora)
    * **Migration Ratio**: Should be 1:1 (no dilution)
    * **Timeline**: Check countdown timer and deadline
  </Step>

  <Step title="Review Terms">
    * **Migration Terms**: Read and understand the terms
    * **Platform Rules**: Review target platform rules
    * **Fee Structure**: Understand any applicable fees
    * **Risks**: Acknowledge any potential risks
  </Step>
</Steps>

### Step 4: Transfer Your Tokens

<Steps>
  <Step title="Enter Migration Amount">
    * **View Balance**: See your current token balance
    * **Enter Amount**: Specify how many tokens to migrate
    * **Review Amount**: Double-check the amount
    * **Confirm**: Proceed with the migration amount
  </Step>

  <Step title="Approve Transaction">
    * **Transaction Preview**: Review the transaction details
    * **Gas Fees**: Check estimated transaction costs
    * **Wallet Approval**: Approve the transaction in your wallet
    * **Wait for Confirmation**: Monitor transaction status
  </Step>

  <Step title="Send to Migration Wallet">
    * **Automatic Transfer**: Tokens are sent to migration wallet
    * **Transaction Hash**: Save your transaction hash
    * **Confirmation**: Wait for blockchain confirmation
    * **Status Update**: Check migration progress
  </Step>
</Steps>

### Step 5: Monitor Progress

<Steps>
  <Step title="Track Migration Status">
    * **Progress Bar**: Watch the collection progress
    * **Community Participation**: See how many others are participating
    * **Countdown Timer**: Monitor the remaining time
    * **Status Updates**: Check for any announcements
  </Step>

  <Step title="Wait for Completion">
    * **Migration Execution**: Admin executes the final migration
    * **New Token Creation**: New token is deployed on target platform
    * **Distribution Preparation**: System prepares token distribution
    * **Notification**: You'll be notified when ready to claim
  </Step>
</Steps>

### Step 6: Claim Your New Tokens

<Steps>
  <Step title="Return to Migration Page">
    * **Visit Again**: Go back to the migration page
    * **Check Status**: Verify migration is complete
    * **Claim Interface**: Look for the claim button
    * **Wallet Connection**: Ensure your wallet is still connected
  </Step>

  <Step title="Claim Your Tokens">
    * **View Claimable Amount**: See how many new tokens you can claim
    * **Review Details**: Check the new token information
    * **Approve Claim**: Approve the claim transaction
    * **Receive Tokens**: New tokens are sent to your wallet
  </Step>

  <Step title="Verify Receipt">
    * **Check Wallet**: Confirm new tokens in your wallet
    * **Token Information**: Verify token details and metadata
    * **Trading Access**: Check if tokens are tradeable on new platform
    * **Community Access**: Join the new platform's community
  </Step>
</Steps>

## User Experience Flows

### **Complete User Journey**

```mermaid theme={null}
flowchart TD
    A[Learn About Migration] --> B[Connect Wallet]
    B --> C[Review Migration Details]
    C --> D[Enter Migration Amount]
    D --> E[Approve Transaction]
    E --> F[Send Tokens to Migration Wallet]
    F --> G[Monitor Progress]
    G --> H[Wait for Migration Completion]
    H --> I[Return to Migration Page]
    I --> J[Claim New Tokens]
    J --> K[Verify Receipt]
    K --> L[Join New Platform Community]
```

### **Mobile Experience**

<Steps>
  <Step title="Mobile Wallet Connection">
    * **Wallet App**: Open your mobile wallet app
    * **QR Code**: Scan QR code if available
    * **Deep Link**: Use wallet deep links
    * **Connection**: Approve connection on mobile
  </Step>

  <Step title="Mobile Transaction">
    * **Touch Interface**: Use touch-friendly interface
    * **Transaction Approval**: Approve on mobile device
    * **Notifications**: Receive mobile notifications
    * **Status Updates**: Check progress on mobile
  </Step>
</Steps>

### **Desktop Experience**

<Steps>
  <Step title="Enhanced Interface">
    * **Full Dashboard**: Access complete migration dashboard
    * **Multiple Wallets**: Support for multiple wallet types
    * **Advanced Features**: Access to all migration features
    * **Real-time Updates**: Live progress tracking
  </Step>

  <Step title="Admin Features">
    * **Migration Management**: Full control over migration process
    * **Analytics**: Detailed migration analytics
    * **User Management**: Track user participation
    * **Status Control**: Manage migration status
  </Step>
</Steps>

## Technical Requirements

### **Wallet Compatibility**

<Columns cols={2}>
  <Card title="Supported Wallets" icon="wallet">
    * Phantom (Recommended)
    * Solflare
    * Backpack
    * Sollet
    * Any Solana wallet
  </Card>

  <Card title="Network Requirements" icon="network-wired">
    * Solana Mainnet
    * Sufficient SOL for fees
    * Stable internet connection
    * Updated wallet software
  </Card>
</Columns>

### **Transaction Requirements**

<Steps>
  <Step title="SOL Balance">
    * **Transaction Fees**: Need SOL for gas fees
    * **Estimated Cost**: Usually 0.001-0.01 SOL
    * **Fee Calculation**: Based on network congestion
    * **Balance Check**: Ensure sufficient SOL balance
  </Step>

  <Step title="Token Balance">
    * **Minimum Amount**: Check minimum migration amount
    * **Token Ownership**: Must own the token being migrated
    * **Balance Verification**: System verifies your holdings
    * **Transfer Approval**: Approve token transfer
  </Step>
</Steps>

## Security & Safety

### **Security Best Practices**

<Steps>
  <Step title="Verify Sources">
    * **Official Links**: Only use official project links
    * **Team Verification**: Confirm with project team
    * **Community Channels**: Check official community channels
    * **Website Verification**: Verify website authenticity
  </Step>

  <Step title="Wallet Security">
    * **Private Keys**: Never share private keys
    * **Phishing Protection**: Be aware of phishing attempts
    * **Official Apps**: Use official wallet applications
    * **Secure Connection**: Ensure HTTPS connections
  </Step>
</Steps>

### **Common Security Issues**

<AccordionGroup>
  <Accordion title="Phishing Attempts">
    * **Fake Websites**: Be cautious of lookalike websites
    * **Fake Links**: Verify all links before clicking
    * **Social Engineering**: Don't trust unsolicited messages
    * **Official Channels**: Only trust official project channels
  </Accordion>

  <Accordion title="Wallet Security">
    * **Private Key Safety**: Never share or store private keys insecurely
    * **Transaction Verification**: Always verify transaction details
    * **Network Security**: Use secure internet connections
    * **Device Security**: Keep your device and wallet updated
  </Accordion>

  <Accordion title="Transaction Safety">
    * **Amount Verification**: Double-check migration amounts
    * **Address Verification**: Verify migration wallet address
    * **Fee Verification**: Understand all transaction fees
    * **Status Monitoring**: Monitor transaction status closely
  </Accordion>
</AccordionGroup>

## Troubleshooting

### **Common Issues**

<Steps>
  <Step title="Wallet Connection Issues">
    * **Refresh Page**: Try refreshing the migration page
    * **Reconnect Wallet**: Disconnect and reconnect wallet
    * **Clear Cache**: Clear browser cache and cookies
    * **Try Different Browser**: Use a different web browser
  </Step>

  <Step title="Transaction Failures">
    * **Check SOL Balance**: Ensure sufficient SOL for fees
    * **Network Congestion**: Wait for network congestion to clear
    * **Retry Transaction**: Try the transaction again
    * **Contact Support**: Reach out to support if issues persist
  </Step>

  <Step title="Migration Problems">
    * **Check Status**: Verify migration status and timeline
    * **Contact Project Team**: Reach out to project team for updates
    * **Community Support**: Check community channels for help
    * **Technical Support**: Contact Shift.fun support if needed
  </Step>
</Steps>

### **Getting Help**

<Columns cols={2}>
  <Card title="Project Support" icon="headset">
    * Project team channels
    * Official community groups
    * Project documentation
    * Team announcements
  </Card>

  <Card title="Technical Support" icon="wrench">
    * Shift.fun support team
    * Technical documentation
    * Community forums
    * Help center
  </Card>
</Columns>

## Success Metrics

### **What to Expect**

<Steps>
  <Step title="Migration Success">
    * **100% Success Rate**: All migrations are designed to succeed
    * **No Value Loss**: Your tokens maintain their value
    * **Community Preservation**: All holders migrate together
    * **Enhanced Features**: Access to better platform features
  </Step>

  <Step title="Timeline Expectations">
    * **Collection Phase**: Usually 24-48 hours
    * **Migration Execution**: Admin-controlled timing
    * **Token Distribution**: Immediate after migration
    * **Platform Access**: Immediate access to new platform
  </Step>
</Steps>

## Post-Migration

### **After Successful Migration**

<Steps>
  <Step title="Verify New Tokens">
    * **Check Wallet**: Confirm new tokens in your wallet
    * **Token Details**: Verify token name, symbol, and metadata
    * **Trading Access**: Check if tokens are tradeable
    * **Platform Access**: Access the new platform features
  </Step>

  <Step title="Join New Community">
    * **Platform Community**: Join the new platform's community
    * **Trading Features**: Explore enhanced trading features
    * **Project Updates**: Stay updated with project news
    * **Future Migrations**: Be ready for future opportunities
  </Step>
</Steps>

<Note>
  **Need Help?** If you encounter any issues during the migration process, don't hesitate to reach out to the project team or Shift.fun support for assistance.
</Note>