Troubleshooting

Diagnose Corvus Solana RPC failures from the exact error string: weighted 429s, PPS stream closes, and aRPC filter validation.

Find the string your client actually printed and start from there. On Corvus it's the message prefix rather than the HTTP status that tells you what went wrong, so the entries below are keyed to what you'd see.

Connection and transport

Authentication and access

Rate limits

Streams

Transactions

What to send support

If none of that gets you there, open a ticket on Discord. What saves a round trip:

UTC timestamp range and region
Product and transport (JSON-RPC, WebSocket, Yellowstone gRPC, aRPC, Falcon, Shredstream)
HTTP status + JSON-RPC code + message prefix, or gRPC status + reason + detail prefix
The endpoint exactly as configured, including scheme and port, secrets redacted
The public egress IP of the failing process, observed from that host
The method name or subscription/filter shape involved
Client library and version
Minimal reproduction

Connection and transport

TLS handshake fails, or the client hangs on connect with https:// or wss://

Works from one host, fails from another

The region I want has no RPC endpoint

Authentication and access

401 with -32002 Unauthorized

403 with -32003 You have no access to this service

Rate limits

429 with -32001 RPS limit exceeded, but I am well under my request rate

429 with -32005 Scan request timed out waiting for concurrency slot

429 with -32005 Transaction rate limit exceeded

502 with -32000 Unable to process Batch Request, or 503 with -32099 Server is not available at the moment

Streams

gRPC PERMISSION_DENIED with detail PPS limit requirement not met, then the connection closes

I registered aRPC filters and never received a FilterValidationResult

The stream is connected but no data is arriving

gRPC RESOURCE_EXHAUSTED on a Yellowstone subscription

Shredstream: nothing arrives at my destination

Transactions

I got a signature back but the transaction never landed

Falcon rejects the transaction before it is ever submitted

What to send support

On this page