# path_find [[ソース]](https://github.com/XRPLF/rippled/blob/master/src/ripple/rpc/handlers/PathFind.cpp) *WebSocket APIのみ。*`path_find`メソッドは、トランザクションが実行される可能性のある[パス](/ja/docs/concepts/tokens/fungible-tokens/paths)を探索し、時間の経過とともにパスが変化する場合に更新を定期的に送信します。JSON-RPCでサポートされているシンプルなバージョンについては、[ripple_path_findメソッド](/ja/docs/references/http-websocket-apis/public-api-methods/path-and-order-book-methods/ripple_path_find)をご覧ください。完全にXRPで行われる支払いの場合、XRPはどのアカウントにも直接送金できるためパスを探索する必要はありません。 path_findコマンドには3種類のモード（サブコマンド）があります。使用するモードを`subcommand`パラメーターに指定します。 * `create` - Pathfinding情報の送信を開始します * `close` - Pathfinding情報の送信を停止します * `status` - 現在処理中のPathfindingリクエストに関する情報を取得します `rippled`サーバは支払いを行うにあたり最も安価なパスまたはパスの組み合わせを探索しますが、このメソッドで返されるパスが最良のパスであることは保証されません。サーバの負荷が原因で、Pathfindingで最良のパスを検出できないことがあります。また、信頼できないサーバからのPathfindingの結果には注意する必要があります。オペレーターの収益となるように、最良ではないパスを返すようにサーバが改ざんされる可能性があります。Pathfindingについて信頼できる独自サーバがない場合は、1つのサーバから不適切な結果が返されるリスクを最小限に抑えるため、異なる当事者が実行する複数のサーバからのPathfindingの結果を比較してください。（**注記:** サーバから最良ではない結果が返されても、必ずしも悪意のある振る舞いの証拠とはなりません。サーバの負荷が高い場合の症状である可能性もあります。） ## path_find create [[ソース]](https://github.com/XRPLF/rippled/blob/master/src/ripple/rpc/handlers/PathFind.cpp#L50-L56) `path_find`の`create`サブコマンドは、指定された特定アカウントから支払トランザクションを実行できるパスを探索する継続的なリクエストを作成し、別のアカウントが何らかの通貨で希望する額を受領できるようにします。初期レスポンスには2つのアドレス間で提案されるパスが含まれています。このパスにより、希望する額を受領できます。その後サーバは、`"type": "path_find"`で有効なパスの更新を含む追加メッセージを送信します。更新の頻度はサーバにより決定されますが、新しいレジャーバージョンがある場合には通常、数秒間に1回です。 クライアントは一度に1つのPathfindingリクエストのみ実行できます。同じ接続ですでに他のPathfindingリクエストが実行されている場合、古いリクエストが自動的にクローズされ、新しいリクエストに置き換えられます。 ### リクエストのフォーマット リクエストのフォーマットの例: WebSocket ```json { "id":8, "command":"path_find", "subcommand":"create", "source_account":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", "destination_account":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", "destination_amount":{ "value":"0.001", "currency":"USD", "issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B" } } ``` リクエストには以下のパラメーターが含まれます。 | フィールド | 型 | 必須? | 説明 | | --- | --- | --- | --- | | `subcommand` | 文字列 | はい | `"create"`を使用してcreateサブコマンドを送信します。 | | `source_account` | 文字列 - [アドレス](/ja/docs/references/protocol/data-types/basic-data-types#%E3%82%A2%E3%83%89%E3%83%AC%E3%82%B9) | はい | 検索するパスの送金元アカウントのドレス。（つまり、支払いを送金するアカウント） | | `destination_account` | 文字列 - [アドレス](/ja/docs/references/protocol/data-types/basic-data-types#%E3%82%A2%E3%83%89%E3%83%AC%E3%82%B9) | はい | 検索するパスの送金先アカウントのアドレス。（つまり、支払いを受領するアカウント） | | `destination_amount` | [通貨額](/ja/docs/references/protocol/data-types/basic-data-types#%E9%80%9A%E8%B2%A8%E9%A1%8D%E3%81%AE%E6%8C%87%E5%AE%9A) | はい | 送金先アカウントが受け取る金額。 **特殊ケース:** XRPの場合、`"-1"`を指定するか、トークンの場合、`value`フィールドの内容として-1を指定できます。これにより、`send_max`で指定された金額を超えない範囲で、可能な限り多くの送金先への送金を要求します。 | | `domain` | 文字列 - [ハッシュ](/ja/docs/references/protocol/data-types/basic-data-types#%E3%83%8F%E3%83%83%E3%82%B7%E3%83%A5) | いいえ | 許可型ドメインのレジャーエントリID。指定された場合、対応する[許可型DEX](/ja/docs/concepts/tokens/decentralized-exchange/permissioned-dexes)のみを使用するパスを返します。 *([PermissionedDEX amendment](/ja/resources/known-amendments#permissioneddex)が必要です。 )* | | `paths` | 配列 | いいえ | チェックする[支払いパス](/ja/docs/concepts/tokens/fungible-tokens/paths)を表すオブジェクトの配列。すでに判明している特定パスの変更内容を常に把握する場合や、特定パスに沿った支払いにかかる総コストを確認する場合にこのフィールドを使用できます。 | | `send_max` | [通貨額](/ja/docs/references/protocol/data-types/basic-data-types#%E9%80%9A%E8%B2%A8%E9%A1%8D%E3%81%AE%E6%8C%87%E5%AE%9A) | いいえ | トランザクションに使用する[通貨額](/ja/docs/references/protocol/data-types/basic-data-types#%E9%80%9A%E8%B2%A8%E9%A1%8D%E3%81%AE%E6%8C%87%E5%AE%9A)。`source_currencies`と同時に指定することはできません。 | サーバは`source_currencies`および`bridges`フィールドも認識しますが、これらのフィールドを使用した場合の結果は保証されません。これらのフィールドは将来のために予約されているものと考えてください。 ### レスポンスのフォーマット 処理が成功したレスポンスの例: WebSocket ```json { "id":1, "status":"success", "type":"response", "result":{ "alternatives":[ { "paths_computed":[ [ { "currency":"USD", "issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", "type":48, "type_hex":"0000000000000030" }, { "account":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", "type":1, "type_hex":"0000000000000001" } ], [ { "currency":"USD", "issuer":"rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q", "type":48, "type_hex":"0000000000000030" }, { "account":"rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q", "type":1, "type_hex":"0000000000000001" } ], [ { "currency":"USD", "issuer":"r9vbV3EHvXWjSkeQ6CAcYVPGeq7TuiXY2X", "type":48, "type_hex":"0000000000000030" }, { "account":"r9vbV3EHvXWjSkeQ6CAcYVPGeq7TuiXY2X", "type":1, "type_hex":"0000000000000001" } ], [ { "currency":"USD", "issuer":"rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun", "type":48, "type_hex":"0000000000000030" }, { "account":"rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun", "type":1, "type_hex":"0000000000000001" } ] ], "source_amount":"251686" }, { "paths_computed":[ [ { "account":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", "type":1, "type_hex":"0000000000000001" }, { "currency":"USD", "issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", "type":48, "type_hex":"0000000000000030" }, { "account":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", "type":1, "type_hex":"0000000000000001" } ], [ { "account":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", "type":1, "type_hex":"0000000000000001" }, { "currency":"USD", "issuer":"rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q", "type":48, "type_hex":"0000000000000030" }, { "account":"rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q", "type":1, "type_hex":"0000000000000001" } ], [ { "account":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", "type":1, "type_hex":"0000000000000001" }, { "currency":"USD", "issuer":"rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun", "type":48, "type_hex":"0000000000000030" }, { "account":"rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun", "type":1, "type_hex":"0000000000000001" } ] ], "source_amount":{ "currency":"BTC", "issuer":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", "value":"0.000001541291269274307" } }, { "paths_computed":[ [ { "account":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", "type":1, "type_hex":"0000000000000001" }, { "currency":"USD", "issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", "type":48, "type_hex":"0000000000000030" }, { "account":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", "type":1, "type_hex":"0000000000000001" } ] ], "source_amount":{ "currency":"CHF", "issuer":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", "value":"0.0009211546262510451" } }, { "paths_computed":[ [ { "account":"razqQKzJRdB4UxFPWf5NEpEG3WMkmwgcXA", "type":1, "type_hex":"0000000000000001" }, { "currency":"USD", "issuer":"rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q", "type":48, "type_hex":"0000000000000030" }, { "account":"rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q", "type":1, "type_hex":"0000000000000001" } ], [ { "account":"razqQKzJRdB4UxFPWf5NEpEG3WMkmwgcXA", "type":1, "type_hex":"0000000000000001" }, { "currency":"USD", "issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", "type":48, "type_hex":"0000000000000030" }, { "account":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", "type":1, "type_hex":"0000000000000001" } ] ], "source_amount":{ "currency":"CNY", "issuer":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", "value":"0.006293562" } }, { "paths_computed":[ [ { "account":"rGwUWgN5BEg3QGNY3RX2HfYowjUTZdid3E", "type":1, "type_hex":"0000000000000001" }, { "currency":"USD", "issuer":"rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun", "type":48, "type_hex":"0000000000000030" }, { "account":"rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun", "type":1, "type_hex":"0000000000000001" } ], [ { "account":"rGwUWgN5BEg3QGNY3RX2HfYowjUTZdid3E", "type":1, "type_hex":"0000000000000001" }, { "currency":"USD", "issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", "type":48, "type_hex":"0000000000000030" }, { "account":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", "type":1, "type_hex":"0000000000000001" } ], [ { "account":"rGwUWgN5BEg3QGNY3RX2HfYowjUTZdid3E", "type":1, "type_hex":"0000000000000001" }, { "currency":"USD", "issuer":"rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q", "type":48, "type_hex":"0000000000000030" }, { "account":"rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q", "type":1, "type_hex":"0000000000000001" } ] ], "source_amount":{ "currency":"DYM", "issuer":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", "value":"0.0007157142857142858" } }, { "paths_computed":[ [ { "account":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", "type":1, "type_hex":"0000000000000001" }, { "currency":"USD", "issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", "type":48, "type_hex":"0000000000000030" }, { "account":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", "type":1, "type_hex":"0000000000000001" } ], [ { "account":"rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun", "type":1, "type_hex":"0000000000000001" }, { "currency":"USD", "issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", "type":48, "type_hex":"0000000000000030" }, { "account":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", "type":1, "type_hex":"0000000000000001" } ], [ { "account":"rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun", "type":1, "type_hex":"0000000000000001" }, { "currency":"USD", "issuer":"rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun", "type":48, "type_hex":"0000000000000030" }, { "account":"rLEsXccBGNR3UPuPu2hUXPjziKC3qKSBun", "type":1, "type_hex":"0000000000000001" } ] ], "source_amount":{ "currency":"EUR", "issuer":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", "value":"0.0007409623616236163" } }, { "paths_computed":[ [ { "account":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", "type":1, "type_hex":"0000000000000001" }, { "currency":"USD", "issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", "type":48, "type_hex":"0000000000000030" }, { "account":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", "type":1, "type_hex":"0000000000000001" } ] ], "source_amount":{ "currency":"JPY", "issuer":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", "value":"0.103412412" } } ], "destination_account":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", "destination_amount":{ "currency":"USD", "issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", "value":"0.001" }, "id":1, "source_account":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", "full_reply": false } } ``` この初期レスポンスは[標準フォーマット](/ja/docs/references/http-websocket-apis/api-conventions/response-formatting)に従っており、正常に完了した場合は次のフィールドが含まれています。 | フィールド | 型 | 説明 | | --- | --- | --- | | `alternatives` | 配列 | 以下に説明する、提案される[パス](/ja/docs/concepts/tokens/fungible-tokens/paths)のオブジェクトの配列。空の場合、送金元アカウントと送金先アカウントを結ぶパスが見つかりませんでした。 | | `destination_account` | 文字列 | トランザクションを受信するアカウントの一意のアドレス。 | | `destination_amount` | 文字列またはオブジェクト | 送金先がトランザクションで受領する[通貨額](/ja/docs/references/protocol/data-types/basic-data-types#%E9%80%9A%E8%B2%A8%E9%A1%8D%E3%81%AE%E6%8C%87%E5%AE%9A)。 | | `id` | （各種） | （WebSocketのみ）WebSocketリクエストに指定されているIDが再びこのレベルで含まれます。 | | `source_account` | 文字列 | トランザクションを送信するアカウントの一意のアドレス。 | | `full_reply` | ブール値 | `false`の場合、これは不完全な検索の結果です。これ以降のレスポンスに、より適切なパスが含まれている可能性があります。`true`の場合、これは検出された最良のパスです。（理論上、これよりも優れたパスが存在している可能性がありますが`rippled`では検出されません。）Pathfindingリクエストをクローズするまで、`rippled`は引き続き、新しいレジャーが閉鎖されるたびに更新を送信します。新規: rippled 0.29.0 | `alternatives`配列の各要素は、1つの送金元通貨（開始アカウントが保有）から送金先アカウントへのパスと通貨を表すオブジェクトです。このオブジェクトのフィールドを次に示します。 | フィールド | 型 | 説明 | | --- | --- | --- | | `paths_computed` | 配列 | [ペイメントパス](/ja/docs/concepts/tokens/fungible-tokens/paths)を定義するオブジェクトの配列。 | | `source_amount` | 文字列またはオブジェクト | 送金先が必要な額を受領するために、送金元がこのパスで送金する必要がある[通貨額](/ja/docs/references/protocol/data-types/basic-data-types#%E9%80%9A%E8%B2%A8%E9%A1%8D%E3%81%AE%E6%8C%87%E5%AE%9A)。 | ### 考えられるエラー * [汎用エラータイプ](/ja/docs/references/http-websocket-apis/api-conventions/error-formatting#%E6%B1%8E%E7%94%A8%E3%82%A8%E3%83%A9%E3%83%BC)のすべて。 * `invalidParams` - 1つ以上のフィールドの指定が正しくないか、1つ以上の必須フィールドが指定されていません。 * `noEvents` - 非同期コールバックをサポートしていないプロトコル（JSON-RPCなど）を使用しています。（JSON-RPCと互換性が *ある* Pathfindingメソッドについては、[ripple_path_findメソッド](/ja/docs/references/http-websocket-apis/public-api-methods/path-and-order-book-methods/ripple_path_find)をご覧ください。） ### 非同期フォローアップ サーバからは初期レスポンスの他に、時間の経過にともなう[ペイメントパス](/ja/docs/concepts/tokens/fungible-tokens/paths)のステータスを更新するため類似したフォーマットでさらにメッセージが送信されます。これらのメッセージには、元のWebSocketリクエストの`id`が含まれているので、どのリクエストからメッセージが送信されたかを確認できます。また、最上位レベルの`"type": "path_find"`フィールドは、追加レスポンスであることを示します。その他のフィールドは、初期レスポンスと同じ方法で定義されます。 フォローアップに`"full_reply": true`が含まれている場合、これは現行レジャーの時点でrippledが検出できる最良のパスです。 path_find createリクエストからの非同期フォローアップの例を次に示します。 WebSocket ```json { "id":1, "type":"path_find", "alternatives":[ /* paths omitted from this example; same format as the initial response */ ], "destination_account":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", "destination_amount":{ "currency":"USD", "issuer":"rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", "value":"0.001" }, "source_account":"r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59" } ``` ## path_find close [[ソース]](https://github.com/XRPLF/rippled/blob/master/src/ripple/rpc/handlers/PathFind.cpp#L58-L67) `path_find`の`close`サブコマンドは、サーバに対して現在実行中のPathfindingリクエストに関する情報の送信を停止するように指示します。 ### リクエストのフォーマット リクエストのフォーマットの例: WebSocket ```json { "id":57, "command":"path_find", "subcommand":"close" } ``` リクエストには以下のパラメーターが含まれます。 | フィールド | 型 | 説明 | | --- | --- | --- | | `subcommand` | 文字列 | closeサブコマンドを送信するため`"close"`を使用します。 | ### レスポンスのフォーマット Pathfindingリクエストが正常にクローズされた場合、レスポンスは[`path_find create`](#path_find-create)に対する初期レスポンスと同じフォーマットであり、されに以下のフィールドが含まれます。 | フィールド | 型 | 説明 | | --- | --- | --- | | `closed` | ブール値 | 値が`true`の場合、これは`path_find close`コマンドに対するレスポンスです。 | 未処理のPathfindingリクエストがない場合はエラーが返されます。 ### 考えられるエラー * [汎用エラータイプ](/ja/docs/references/http-websocket-apis/api-conventions/error-formatting#%E6%B1%8E%E7%94%A8%E3%82%A8%E3%83%A9%E3%83%BC)のすべて。 * `invalidParams` - フィールドの指定が正しくないか、必須フィールドが指定されていません。 * `noEvents` - 非同期コールバックをサポートしていないプロトコル（JSON-RPCなど）でこのメソッドを使用しようとしました。（JSON-RPCと互換性が *ある* Pathfindingメソッドについては、[ripple_path_findメソッド](/ja/docs/references/http-websocket-apis/public-api-methods/path-and-order-book-methods/ripple_path_find)をご覧ください。） * `noPathRequest` - Pathfindingリクエストをクローズしようとしましたが、実行中のリクエストがありませんでした。 ## path_find status [[ソース]](https://github.com/XRPLF/rippled/blob/master/src/ripple/rpc/handlers/PathFind.cpp#L69-L77) `path_find`の`status`サブコマンドは、現在実行中のクライアントのPathfindingリクエストの即時更新をリクエストします。 ### リクエストのフォーマット リクエストのフォーマットの例: WebSocket ```json { "id":58, "command":"path_find", "subcommand":"status" } ``` リクエストには以下のパラメーターが含まれます。 | フィールド | 型 | 説明 | | --- | --- | --- | | `subcommand` | 文字列 | `"status"`を使用して、statusサブコマンドを送信します。 | ### レスポンスのフォーマット Pathfindingリクエストが実行中の場合、レスポンスは[`path_find create`](#path_find-create)に対する初期レスポンスと同じフォーマットであるのに加えて、以下のフィールドがあります。 | フィールド | 型 | 説明 | | --- | --- | --- | | `status` | ブール値 | 値が`true`の場合、これは`path_find status`コマンドに対するレスポンスです。 | 未処理のPathfindingリクエストがない場合はエラーが返されます。 ### 考えられるエラー * [汎用エラータイプ](/ja/docs/references/http-websocket-apis/api-conventions/error-formatting#%E6%B1%8E%E7%94%A8%E3%82%A8%E3%83%A9%E3%83%BC)のすべて。 * `invalidParams` - 1つ以上のフィールドの指定が正しくないか、1つ以上の必須フィールドが指定されていません。 * `noEvents` - 非同期コールバックをサポートしていないプロトコル（JSON-RPCなど）を使用しています。（JSON-RPCと互換性が *ある* Pathfindingメソッドについては、[ripple_path_findメソッド](/ja/docs/references/http-websocket-apis/public-api-methods/path-and-order-book-methods/ripple_path_find)をご覧ください。） * `noPathRequest` - Pathfindingリクエストのステータスを確認しようとしましたが、処理中のリクエストがありませんでした。