XRP Ledger APIの使用開始

XRP Ledgerのコアサーバーソフトウェアはrippledです。XRP Ledgerでの開発に進むには、rippledサーバーのAPIにアクセスします。

APIにアクセスする最も簡単な方法は、WebSocket API Toolを使用するか、XRP Ledger Explorer を使用してレジャーの進行状況をその場で確認することです。

rippledの独自のインスタンスを実行したり、公開サーバーを使用したりすることもできます。

公開サーバー

Rippleは、XRP Ledgerコミュニティ向けにいくつかの公開サーバーを提供しています。

演算子 ネットワーク JSON-RPC URL WebSocket URL 注記
Ripple Mainnet https://s1.ripple.com:51234/ wss://s1.ripple.com/ 汎用サーバークラスター
Ripple Mainnet https://s2.ripple.com:51234/ wss://s2.ripple.com/ すべての履歴が記録されるサーバークラスター
Ripple Testnet https://s.altnet.rippletest.net:51234/ wss://s.altnet.rippletest.net/ Testnet公開サーバー
Ripple Devnet https://s.devnet.rippletest.net:51234/ wss://s.devnet.rippletest.net/ Devnet公開サーバー

これらの公開サーバーは継続的な使用やビジネスでの使用を想定したものではなく、いつでも使用不可となる可能性があります。日常的な使用については、独自のrippledサーバーを自社で運用するか、信頼できる事業者と運用委託契約を締結します。

管理者アクセス権限

rippledサーバーの管理メソッドを使用するには、次のように行います。この場合、サーバーのバインド用として設定したIPアドレスとポートを使用する必要があります（例えば127.0.0.1:54321）。また、管理機能にアクセスするには、構成ファイルで管理用としてマークされているポートおよびIPアドレスから接続しなければなりません。

構成ファイルの例 では、ローカルループバックネットワーク上（127.0.0.1）のポート5005でJSON-RPC（HTTP）、ポート6006でWebSocket（WS）の接続をリッスンし、接続されるすべてのクライアントを管理者として扱っています。

WebSocket API

いくつかのメソッドをXRP Ledgerで試すことを予定している場合は、独自のWebSocketコードを記述することなく、Ripple WebSocket APIツールでAPIをすぐに使用できます。後ほど、独自のrippledサーバーへの接続が必要となった時点で、ブラウザーまたはNode.jsで独自のクライアントをビルド することが可能です。

要求フォーマット

rippledサーバーへのWebSocketを開いた後、以下の属性を使用して、コマンドをJSON オブジェクトとして送信できます。

  • コマンド名を最上位の"command"フィールドに記述します。
  • コマンドのすべての関連パラメーターも最上位に記述します。
  • 任意の値を指定して"id"フィールドを記述します（省略可）。この要求への応答では、同一の"id"フィールドを使用します。そうすることで、応答が順不同で到達した場合も、どの要求によってどの応答を得られたのかがわかります。

応答はJSONオブジェクトとして返されます。

JSON-RPC

任意のHTTPクライアント（RESTED for Firefox 、Postman for Chrome 、Online HTTP client ExtendsClass など）を使用して、JSON-RPCでrippledサーバーを呼び出すことができます。ほとんどのプログラミング言語には、HTTP要求を組み込むためのライブラリーが用意されています。

要求フォーマット

JSON-RPC要求を作成するには、rippledサーバーがJSON-RPC接続をリッスンしているポートおよびIPアドレス上で、HTTP POST要求をルートパス（/）に送信します。HTTP/1.0またはHTTP/1.1を使用できます。HTTPSを使用する場合は、TLS v1.2を使用してください。セキュリティーの維持を理由として、rippledはSSL v3以前を サポートしていません 。

値をapplication/jsonとして、Content-Typeヘッダーを常に記述してください。

複数の要求を作成することを予定している場合は、要求ごとに接続を閉じて再び開くことなく済むよう、キープアライブ を使用します。

以下の属性を指定して、要求の本文をJSON オブジェクトとして送信します。

  • コマンドを最上位の"method"フィールドに記述します。
  • 最上位の"params"フィールドを記述します。このフィールドの内容は、コマンドのすべてのパラメーターが指定された1つの入れ子JSONオブジェクトのみを保持している1要素配列です。

応答もJSONオブジェクトになります。

コマンドライン

このコマンドラインインターフェイスは、JSON-RPCのものと同一のサービスに接続するため、公開サーバーおよびサーバー構成は同一です。コマンドラインクライアントとして、rippledがローカルインスタンスに接続します。例:

rippled --conf=/etc/rippled.cfg server_info

注記: コマンドラインインターフェイスは、管理の目的でのみ使用されることを想定しています。 サポートされるAPIではありません。

要求フォーマット

コマンドラインでは、通常の（先頭にダッシュが付いた）コマンドラインオプションに続けてコマンドを記述した後、一連の限定的なパラメーターを空白文字で区切って記述します。空白文字などの特殊な文字が含まれている可能性があるパラメーター値は、一重引用符で囲みます。

要求の例

{
  "id": 2,
  "command": "account_info",
  "account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
  "strict": true,
  "ledger_index": "validated"
}

POST http://s1.ripple.com:51234/
{
    "method": "account_info",
    "params": [
        {
           "account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
            "strict": true,
            "ledger_index": "validated"
        }
    ]
}

rippled account_info r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59 validated true

応答フォーマット

成功した場合の応答の例

{
   "id": 2,
  "status": "success",
  "type": "response",
  "result": {
    "account_data": {
      "Account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
      "Balance": "27389517749",
      "Flags": 0,
      "LedgerEntryType": "AccountRoot",
      "OwnerCount": 18,
      "PreviousTxnID": "B6B410172C0B65575D89E464AF5B99937CC568822929ABF87DA75CBD11911932",
      "PreviousTxnLgrSeq": 6592159,
      "Sequence": 1400,
      "index": "4F83A2CF7E70F77F79A307E6A472BFC2585B806A70833CCD1C26105BAE0D6E05"
    },
    "ledger_index": 6760970
  }
}

HTTP Status:200 OK
{
    "result": {
        "account_data": {
            "Account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
            "Balance": "27389517749",
            "Flags": 0,
            "LedgerEntryType": "AccountRoot",
            "OwnerCount": 18,
            "PreviousTxnID": "B6B410172C0B65575D89E464AF5B99937CC568822929ABF87DA75CBD11911932",
            "PreviousTxnLgrSeq": 6592159,
            "Sequence": 1400,
            "index": "4F83A2CF7E70F77F79A307E6A472BFC2585B806A70833CCD1C26105BAE0D6E05"
        },
         "ledger_index": 6761012,
         "status": "success"
    }
}

{
    "result": {
        "account_data": {
            "Account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
            "Balance": "27389517749",
            "Flags": 0,
            "LedgerEntryType": "AccountRoot",
            "OwnerCount": 18,
            "PreviousTxnID": "B6B410172C0B65575D89E464AF5B99937CC568822929ABF87DA75CBD11911932",
            "PreviousTxnLgrSeq": 6592159,
            "Sequence": 1400,
            "index": "4F83A2CF7E70F77F79A307E6A472BFC2585B806A70833CCD1C26105BAE0D6E05"
        },
        "ledger_index": 6761012,
        "status": "success"
    }
}

成功した場合の応答に含まれているフィールドは、以下のとおりです。

Field 型 説明
id （場合により異なる） （WebSocketのみ）この応答の要求元となった要求で提供されているID。
status 文字列 （WebSocketのみ）値がsuccessである場合、要求がサーバーによって正常に受信され、理解されたことを示します。
result.status 文字列 （JSON-RPCおよびコマンドライン）値がsuccessである場合、要求がサーバーによって正常に受信され、理解されたことを示します。
type 文字列 （WebSocketのみ）値がresponseである場合、コマンドに対する正常な応答であることを示します。非同期の通知では、ledgerClosedやtransactionなど異なる値が使用されます。
result オブジェクト クエリーの結果。内容はコマンドによって異なります。

コマンドライン

コマンドラインのメソッドはJSON-RPCと同一のインターフェイスを使用しているため、応答フォーマットはJSON-RPCの応答と同一です。

関連項目