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

# Troubleshooting

> Common issues and solutions for Moongate Adapter integration.

## 🔧 Installation Issues

### Package Not Found

**Problem**: `npm install @moongate/sdk` fails with "package not found"

**Solutions**:

* Verify you have internet connection
* Clear npm cache: `npm cache clean --force`
* Try with yarn: `yarn add @moongate/sdk`
* Check if you're behind a corporate firewall

```bash theme={null}
# Clear npm cache and retry
npm cache clean --force
rm -rf node_modules package-lock.json
npm install
```

### TypeScript Errors

**Problem**: TypeScript compilation errors with Moongate Adapter

**Solutions**:

* Ensure you're using TypeScript 4.0+
* Add type declarations if needed
* Check your `tsconfig.json` configuration

```json tsconfig.json theme={null}
{
  "compilerOptions": {
    "moduleResolution": "node",
    "allowSyntheticDefaultImports": true,
    "esModuleInterop": true,
    "jsx": "react-jsx"
  }
}
```

## 🔑 API Key Issues

### Invalid API Key

**Problem**: "Invalid API key" error when using the Adapter

**Solutions**:

* Verify your API key is correct (no extra spaces)
* Check if your account is approved in the partner dashboard
* Ensure you're using the right environment (dev/prod)

```tsx theme={null}
// Correct API key usage
<MoonGateProvider apiKey={process.env.NEXT_PUBLIC_MOONGATE_API_KEY}>
  {children}
</MoonGateProvider>
```

## 🆘 Need Help?

* 📧 Email: [amen@moongate.one](mailto:amen@moongate.one) or [praneet@moongate.one](mailto:praneet@moongate.one)
* 💬 Telegram: [@and\_its\_praneet](https://t.me/and_its_praneet)
* 📞 Schedule a call: [Book a call with Praneet](https://calendly.com/moongate-founders/30min)
* 🐛 Issues: Message us on [web.moongate.one](https://web.moongate.one)