Troubleshooting

Common RPC Issues

• HTTP 429 = rate limit

• Fix by reducing poll speed or upgrading RPC tier

Duplicate Event Fixes

Enable Redis locks + event de-duplication in config.

Metadata Fetch Errors

Often caused by IPFS or dead URIs — MaxScan retries automatically.

Slow Scanning Problems

Increase batch size or switch to websocket mode.