Embedded Wallets

# Solana Embedded Wallets Integration Prompt

## Prerequisites Check
Before starting, verify the user has:
1. Existing Civic Auth integration in their React/Next.js project
2. A working Civic Auth Client ID
3. Basic authentication already functional

If any of these are missing, stop and direct them to set up basic Civic Auth first.

## Task
Add Solana embedded wallet functionality to an existing Civic Auth integration.

## Step 1: Fetch the Solana Documentation
Use curl to fetch the Solana embedded wallets documentation:

curl https://docs.civic.com/web3/solana.md

This documentation contains ALL the code examples and instructions needed for Solana wallet integration. Do NOT use web search or any other tools - only use curl to fetch this specific URL.

## Step 2: Gather Project Information
Ask the user for the following information if not provided:

**Required Information (gather ALL before starting):**
- ✅ Current framework (React, Next.js, etc.)
- ✅ Build tool (Vite, Create React App, Next.js, or other)
- ✅ Solana Wallet Adapter preference (Yes/No - whether to integrate with existing wallet adapters)
- ✅ Solana RPC endpoint preference (or if they need help choosing one)
- ✅ Which components need wallet functionality
- ✅ Existing Web3 libraries that might conflict

**DO NOT proceed with implementation until you have confirmed ALL of the above information.**

## Step 3: Analyze Current Setup
Before implementing:
1. Examine the existing Civic Auth setup
2. Identify where the CivicAuthProvider is configured
3. Check for any existing Web3 dependencies
4. Plan integration points for wallet functionality

## Step 4: Implement Solana Embedded Wallets
Using ONLY the documentation fetched via curl:

1. **Install Dependencies**: Add the required @civic/auth-web3 packages
2. **Update Provider**: Enhance the existing CivicAuthProvider setup for Web3
3. **Implement Wallet Creation**: Add wallet creation logic for new users
4. **Add Wallet Components**: Create components for wallet interaction (balance, transactions)
5. **Configure Solana Connection**: Set up RPC connection and network configuration
6. **Handle Wallet Adapter** (if requested): Integrate with Solana Wallet Adapter ecosystem

## Step 5: Add Wallet Functionality
Implement core wallet features:
- **Check if user has wallet**: Use userHasWallet type guard
- **Create wallet for new users**: Implement createWallet functionality  
- **Display wallet address**: Show the user's Solana public key
- **Check wallet balance**: Query and display SOL balance
- **Send transactions**: Basic transaction sending capability
- **Error handling**: Proper error states for wallet operations

## Important Notes
- Use ONLY curl to fetch the documentation - no web search tools
- The fetched documentation is the ONLY source of truth for this implementation
- All code examples, configuration options, and setup instructions are in that document
- Pay attention to Early Access warnings and API stability notes
- Ensure proper TypeScript types are used (ExistingWeb3UserContext vs NewWeb3UserContext)

## CRITICAL: Webpack Configuration for Next.js
If the project uses Next.js with webpack (versions < 15.3), ensure the next.config file includes:

createCivicAuthPlugin({
  clientId: 'YOUR_CLIENT_ID',
  enableSolanaWalletAdapter: true, // Required for Solana integration
})

## Testing Requirements
After implementation, ensure the following works:
1. Existing users can create wallets
2. Users with wallets can see their address and balance
3. Transaction sending works on testnet
4. Error states display properly
5. Wallet Adapter integration works (if enabled)