エラーのフォーマット

エラーが発生する可能性のある状況をすべて挙げることは不可能です。トランスポートレイヤーで発生する場合（ネットワーク接続が失われる場合など）には、使用しているクライアントとトランスポートに応じてその結果は異なります。ただし、rippledサーバがリクエストを正常に受信した場合、サーバは標準のエラー形式でのレスポンスを試みます。

注意: リクエストの結果がエラーになった場合、レスポンスの一部としてリクエスト全体がコピーされます。このため、エラーのデバッグに取り組むことができます。ただし、これにはリクエストで渡した機密情報がすべて含まれます。エラーメッセージを共有するときには、アカウントの重要な機密情報を他のユーザに誤って公開することがないように、十分に注意してください。

エラーの例:

{
  "id": 3,
  "status": "error",
  "type": "response",
  "error": "ledgerIndexMalformed",
  "request": {
    "account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
    "command": "account_info",
    "id": 3,
    "ledger_index": "-",
    "strict": true
  }
}

WebSocketフォーマット

JSON-RPCフォーマット

一部のJSON-RPCリクエストは、HTTPレイヤーでエラーコードでレスポンスします。この場合、レスポンスはレスポンス本文にプレーンテキストで記述されます。たとえばmethodパラメータでコマンドを指定し忘れた場合、レスポンスは次のようになります。

HTTP Status: 400 Bad Request
Null method

HTTPステータスコード200 OKが返されるその他のエラーの場合、レスポンスはJSONフォーマットで、以下のフィールドが使用されます。

汎用エラー

すべてのメソッドは、以下のいずれかの値のerrorコードを返す可能性があります。

• amendmentBlocked - サーバの状態がAmendmentブロックされたであるため、XRP Ledgerネットワークとの同期を維持するために最新バージョンに更新する必要があります。
• failedToForward - (レポートモードのサーバのみ)サーバはこのリクエストをP2Pモードサーバに転送しようとしましたが、接続に失敗しました。
• invalid_API_version - サーバはリクエストのAPIバージョン番号をサポートしていません。
• jsonInvalid -（WebSocketのみ）リクエストは適切なJSONオブジェクトではありません。
  • この場合JSON-RPCは、代わりに400 Bad Request HTTPエラーを返します。
• missingCommand -（WebSocketのみ）リクエストにcommandフィールドが指定されていませんでした。
  • この場合JSON-RPCは、代わりに400 Bad Request HTTPエラーを返します。
• noClosed - サーバに閉鎖済みレジャーがありません。通常、このエラーは起動が完了していないことが原因で発生します。
• noCurrent - 高い負荷、ネットワークの問題、バリデータ障害、誤った構成、またはその他の問題が原因で、サーバが現行のレジャーを認識できません。
• noNetwork - サーバとXRP Ledgerピアツーピアネットワークのその他の部分との接続で問題が発生しています（サーバがスタンドアロンモードで実行されていません）。
• unknownCmd - リクエストに、rippledサーバが認識するコマンドが含まれていません。
• tooBusy - サーバの負荷が高すぎるため、現在このコマンドを実行できません。管理者として接続している場合は、通常このエラーが返されることはありません。
• wsTextRequired -（WebSocketのみ）リクエストのopcodeがテキストではありません。