​

Troubleshooting

​

Common Issues

​

Wallet Not Appearing in Modal

• Wallet not registered before WalletProvider initialization
• Incorrect wallet name used in select()
• Missing peer dependencies

1. Ensure proper registration order:
   Copy

   // ✅ Correct - Register before app initialization
   import { registerMoonGateWallet } from '@moongate/moongate-adapter';
   
   registerMoonGateWallet({
     authMode: 'Google',
     environment: 'production'
   });
   
   // Then initialize your app
   ReactDOM.render(<App />, document.getElementById('root'));
   
2. Check wallet names:
   Copy

   // ✅ Correct wallet names
   select('Sign in with Google');
   select('Sign in with Apple');
   select('Ethereum Wallet');
   select('Sign in with Twitter');
   
3. Verify peer dependencies:
   Copy

   npm list @solana/wallet-adapter-base @solana/wallet-adapter-react
   

​

Authentication Fails

• Incorrect environment configuration
• Missing API keys or configuration
• Network connectivity issues
• Browser compatibility issues

1. Check environment configuration:
   Copy

   // For development
   registerMoonGateWallet({
     authMode: 'Google',
     environment: 'development'
   });
   
   // For production
   registerMoonGateWallet({
     authMode: 'Google',
     environment: 'production'
   });
   
2. Verify browser compatibility:
   • Ensure you’re using a modern browser
   • Check if popup blockers are enabled
   • Verify third-party cookies are allowed
3. Check network connectivity:
   Copy

   // Test network connectivity
   fetch('https://api.moongate.one/health')
     .then(response => console.log('Network OK'))
     .catch(error => console.error('Network error:', error));
   

​

🆘 Need Help?

• 📧 Email: [email protected] or [email protected]
• 💬 Telegram: @and_its_praneet
• 📞 Schedule a call: Book a call with Praneet
• 🐛 Issues: Message us on web.moongate.one