Quicknodeでは、RPCエンドポイントのエラーログを提供しています。ダッシュボードから直接詳細なエラー情報を確認することで、問題を簡単に特定し、解決することができます。

HTTPエラーコード

ここでは、よく遭遇するHTTPエラーの種類、その意味、そしてそれらを防ぐためにできることについて見ていきましょう。

400不正なリクエスト

Incorrect HTTP request type (e.g. using GET instead of POST) or invalid characters

401アクセス権限なし

One or more security requirements not met such as incorrect token auth, IP not in whitelist, invalid JWT, etc

403アクセス禁止

Endpoint disabled (one reason could be a past due payment)

403Forbidden — custom trace not found in allowed custom traces

Custom trace code not whitelisted; submit a ticket to go through the approval process

404見つかりません

Incorrect URL or incorrect method

413コンテンツが大きすぎます

リクエストの本文が大きすぎます

429リクエストが多すぎます

The requests per second (RPS) of your requests are higher than your plan allows; see support docs for details

500サーバー内部エラー

Submit a ticket for the support team to investigate as soon as possible

503サービス利用不可

Submit a ticket for the support team to investigate as soon as possible

HTTPエラーコードの例

{
  "jsonrpc": "2.0",
  "error": {
    "code": 429,
    "message": "The requests per second (RPS) of your requests are higher than your plan allows."
  },
  "id": 1
}

Solana RPC Error Codes

When working with Solana, understanding its API error codes is essential for effective troubleshooting and smooth application operation.

-32002Transaction simulation failed / preflight check error

The transaction being sent has errors; double check params, signatures, and message

-32002Blockhash not found

The blockhash sent is not known by the validator yet; implement a retry mechanism

-32003Transaction signature verification failure

One or more signatures are invalid; verify private/public keys and signatures

-32004Block not available for slot

Timeout or block not retrievable; use a retry mechanism

-32005Node is unhealthy / behind by slots

Node is behind the tip; retry with backoff or try another endpoint

-32007Slot was skipped or missing due to snapshot jump

Requested block does not exist; verify the slot in a block explorer

-32009Slot was skipped or missing in long-term storage

The requested slot is missing from long-term storage; see support FAQ for details

-32010Key excluded from account secondary indexes

Unexpected payload or incorrect data for the method; ensure request body matches validator expectations

-32013Transaction signature length mismatch

Signature length is not as expected; re-encode or rebuild the transaction

-32014Block status not yet available

Block is pending or not yet synced; retry later

-32015Transaction version not supported

Use "maxSupportedTransactionVersion": 0 or upgrade client to support versioned transactions

-32016Minimum context slot not reached

The required context slot is too far in the future; lower the minimum context slot or retry later

-32602Invalid params

Flags/params are invalid; double check method parameters against Solana docs

Solana RPC Error Code Example

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32602,
    "message": "Invalid param: Invalid"
  },
  "id": 1
}

エンドポイントログ

Quicknode では、問題の診断に役立つよう、RPC エンドポイントのログを提供しています。Quicknode ダッシュボードで以下のページにアクセスすると、ログを直接確認できます：

1. サイドバーのエンドポイント
2. エンドポイントの選択
3. [ログ] タブを開く

ログは、時間範囲、レスポンスの種類、メソッド、ネットワークごとにフィルタリングできます。

どのような情報が記録されるか

エンドポイントへのリクエスト
エンドポイントに対して行われたリクエスト。これには、HTTPステータス、リクエストメソッド、RPCメソッドまたはパス、およびタイムスタンプが含まれます。

エラーの詳細
利用可能な場合、失敗したリクエストには、RPCエラーコード、リクエストおよびレスポンスの本文、関連ドキュメントへのリンクなどのエラー詳細が含まれます。

伐採の制限

ログの可用性は、メソッド、レスポンスの種類、ネットワーク、およびプランによって異なる場合があります。エンドポイントのパフォーマンスを最適に維持するため、ログ記録は「ベストエフォート」方式で動作します。低遅延を維持するため、トラフィックが集中している時間帯には、一部のログが破棄される場合があります。

保存とアクセス

「Build」および「Scale」プランには、標準的なログ保存期間を備えたダッシュボードへのアクセスが含まれます。 「Enterprise」プランでは、保存期間が延長されるほか、ログ取得のためのプログラムによるAPIアクセスが提供されます。

その他のエラーコードが表示される場合は、チケットを送信してその旨をお知らせください。喜んでお手伝いさせていただきます。