WalletConnect Setup Guide

Get Your WalletConnect Project ID

1. Go to: https://cloud.walletconnect.com
2. Sign in or create an account
3. Create a new project (or use existing)
4. Copy your Project ID
5. Add it to packages/dapp/.env.local:

NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=your_project_id_here

Why You Need This

WalletConnect Project ID is required for:

• MetaMask connection
• WalletConnect protocol
• RainbowKit wallet connections

Free Tier

WalletConnect offers a free tier with:

• Up to 1M requests/month
• Sufficient for development and testing

After Adding Project ID

1. Save .env.local file
2. Restart the dev server:

   # Stop current server (Ctrl+C)
   npm run dapp:dev

3. Try connecting wallet again

Troubleshooting

Error: "Invalid project ID"

• Make sure Project ID is correct (no extra spaces)
• Verify it's from https://cloud.walletconnect.com
• Restart dev server after adding

Error: "Failed to connect"

• Check browser console for errors
• Make sure MetaMask or other wallet is installed
• Try a different wallet