From 13c2603586e2b467d0971854b382130d81518cbe Mon Sep 17 00:00:00 2001 From: tequ Date: Tue, 3 Dec 2024 15:21:55 +0900 Subject: [PATCH 1/2] [JA] translate API v2 Updates --- .../payment-types/partial-payments.md | 2 + .../admin-api-methods/signing-methods/sign.md | 15 +- .../api-conventions/request-formatting.md | 38 - .../references/http-websocket-apis/index.md | 55 +- .../account-methods/account_info.md | 2 +- .../account-methods/account_tx.md | 530 +++++++------ .../account-methods/noripple_check.md | 14 +- .../public-api-methods/index.md | 10 +- .../subscription-methods/subscribe.md | 711 +++++++++++------- .../transaction-methods/submit.md | 94 ++- .../transaction-methods/transaction_entry.md | 477 +++++++++--- .../transaction-methods/tx.md | 438 +++++++---- .../protocol/transactions/types/payment.md | 45 +- .../subscription-methods/subscribe.md | 2 - 14 files changed, 1545 insertions(+), 888 deletions(-) diff --git a/@l10n/ja/docs/concepts/payment-types/partial-payments.md b/@l10n/ja/docs/concepts/payment-types/partial-payments.md index f4f3bdfb3c..334ae60f24 100644 --- a/@l10n/ja/docs/concepts/payment-types/partial-payments.md +++ b/@l10n/ja/docs/concepts/payment-types/partial-payments.md @@ -9,6 +9,8 @@ labels: --- # Partial Payment +{% admonition type="warning" name="警告" %}このページでは、`Payment`トランザクションおよび各種APIメソッドに表示される`Amount`フィールドの詳細について説明します。`Amount`とPartial Paymentに関するコンテキスト情報は依然として関連性がありますが、`rippled` [API v2](../../references/http-websocket-apis/api-versions.md)においてフィールド名が`DeliverMax`に変更されました。これは、フィールド名をその動作に特化させ、以下に説明する誤解や悪用を防ぐためです。{% /admonition %} + デフォルトのケースでは、XRP Ledgerの[Paymentトランザクション][]の`Amount`フィールドに、為替レートと[送金手数料](../tokens/transfer-fees.md)を差し引いた実際の送金額が指定されます。「Partial Payment」フラグ（[**tfPartialPayment**](../../references/protocol/transactions/types/payment.md#paymentのフラグ)）を使うと、送金額を増額する代わりに受取金額を減額して、支払を正常に実行できます。Partial Paymentは、追加コストなしで[支払を返金](bouncing-payments.md)したい場合に便利です。 [トランザクションコスト](../transactions/transaction-cost.md)に使用されるXRPの額は、トランザクションタイプに関わらず常に送金元のアカウントから差し引かれます。 diff --git a/@l10n/ja/docs/references/http-websocket-apis/admin-api-methods/signing-methods/sign.md b/@l10n/ja/docs/references/http-websocket-apis/admin-api-methods/signing-methods/sign.md index 29f4bd4483..e6d5cca56b 100644 --- a/@l10n/ja/docs/references/http-websocket-apis/admin-api-methods/signing-methods/sign.md +++ b/@l10n/ja/docs/references/http-websocket-apis/admin-api-methods/signing-methods/sign.md @@ -25,12 +25,13 @@ labels: ```json { "id": 2, + "api_version": 2, "command": "sign", "tx_json" : { "TransactionType" : "Payment", "Account" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", "Destination" : "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX", - "Amount" : { + "DeliverMax" : { "currency" : "USD", "value" : "1", "issuer" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn" @@ -50,10 +51,11 @@ labels: "params": [ { "offline": false, + "api_version": 2, "secret": "s████████████████████████████", "tx_json": { "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", - "Amount": { + "DeliverMax": { "currency": "USD", "issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", "value": "1" @@ -71,7 +73,7 @@ labels: {% tab label="コマンドライン" %} ```sh #Syntax: sign secret tx_json [offline] -rippled sign s████████████████████████████ '{"TransactionType": "Payment", "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", "Destination": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX", "Amount": { "currency": "USD", "value": "1", "issuer" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn" }, "Sequence": 360, "Fee": "10000"}' offline +rippled sign s████████████████████████████ '{"TransactionType": "Payment", "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", "Destination": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX", "DeliverMax": { "currency": "USD", "value": "1", "issuer" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn" }, "Sequence": 360, "Fee": "10000"}' offline ``` {% /tab %} @@ -119,13 +121,14 @@ rippled sign s██████████████████████ ```json { "id": 2, + "api_version": 2, "status": "success", "type": "response", "result": { "tx_blob": "1200002280000000240000016861D4838D7EA4C6800000000000000000000000000055534400000000004B4E9C06F24296074F7BC48F92A97916C6DC5EA9684000000000002710732103AB40A0490F9B7ED8DF29D246BF2D6269820A0EE7742ACDD457BEA7C7D0931EDB7446304402200E5C2DD81FDF0BE9AB2A8D797885ED49E804DBF28E806604D878756410CA98B102203349581946B0DDA06B36B35DBC20EDA27552C1F167BCF5C6ECFF49C6A46F858081144B4E9C06F24296074F7BC48F92A97916C6DC5EA983143E9D4A2B8AA0780F682D136F7A56D6724EF53754", "tx_json": { "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", - "Amount": { + "DeliverMax": { "currency": "USD", "issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", "value": "1" @@ -154,7 +157,7 @@ rippled sign s██████████████████████ "tx_blob": "1200002280000000240000016861D4838D7EA4C6800000000000000000000000000055534400000000004B4E9C06F24296074F7BC48F92A97916C6DC5EA9684000000000002710732103AB40A0490F9B7ED8DF29D246BF2D6269820A0EE7742ACDD457BEA7C7D0931EDB7446304402200E5C2DD81FDF0BE9AB2A8D797885ED49E804DBF28E806604D878756410CA98B102203349581946B0DDA06B36B35DBC20EDA27552C1F167BCF5C6ECFF49C6A46F858081144B4E9C06F24296074F7BC48F92A97916C6DC5EA983143E9D4A2B8AA0780F682D136F7A56D6724EF53754", "tx_json": { "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", - "Amount": { + "DeliverMax": { "currency": "USD", "issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", "value": "1" @@ -184,7 +187,7 @@ Connecting to 127.0.0.1:5005 "tx_blob" : "1200002280000000240000016861D4838D7EA4C6800000000000000000000000000055534400000000004B4E9C06F24296074F7BC48F92A97916C6DC5EA9684000000000002710732103AB40A0490F9B7ED8DF29D246BF2D6269820A0EE7742ACDD457BEA7C7D0931EDB7447304502210094D24C795CFFA8E46FE338AF63421DA5CE5E171ED56F8E4CE70FFABA15D3CFA2022063994C52BF0393C8157EBFFCDE6A7E7EDC7B16A462CA53214F64CC8FCBB5E54A81144B4E9C06F24296074F7BC48F92A97916C6DC5EA983143E9D4A2B8AA0780F682D136F7A56D6724EF53754", "tx_json" : { "Account" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", - "Amount" : { + "DeliverMax" : { "currency" : "USD", "issuer" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", "value" : "1" diff --git a/@l10n/ja/docs/references/http-websocket-apis/api-conventions/request-formatting.md b/@l10n/ja/docs/references/http-websocket-apis/api-conventions/request-formatting.md index aa84096b9d..ec21988976 100644 --- a/@l10n/ja/docs/references/http-websocket-apis/api-conventions/request-formatting.md +++ b/@l10n/ja/docs/references/http-websocket-apis/api-conventions/request-formatting.md @@ -99,42 +99,4 @@ APIのメソッド名は、通常の(ダッシュで始まる)コマンドライ {% admonition type="warning" name="注意" %}コマンドラインインターフェイスは管理目的でのみ使用することを意図しており、_サポートされているAPIではありません_です。新しいバージョンの`rippled`では、警告なしにコマンドラインAPIに破壊的な変更が導入される可能性があります！{% /admonition %} - -## APIのバージョン管理 - -`rippled`サーバは、使用するAPIバージョンを識別するために単一の整数を使用します。現在、`1`と`2`{% badge href="https://github.com/XRPLF/rippled/releases/tag/2.0.0" %}新規: rippled 2.0.0{% /badge %}の2つのAPIバージョンがあります。サーバは`version`APIメソッドでサポートされるAPIバージョンの範囲を報告します。 - -それぞれのAPIバージョンは、破壊的な変更が導入されるときに新しいAPIバージョン番号を導入します。プレリリースやベータ、開発バージョンでは、同じAPIバージョン番号で破壊的な変更を導入することがあり、`account_tx`リクエストを使用してAPIバージョン2を使用し、同じ接続でAPIバージョン1を使用して別の`account_tx`リクエストを行うことができます。 - -将来の`rippled`のバージョンで破壊的な変更が導入されると、新しいAPIバージョン3が導入されます。 - - -### 破壊的変更 - -次の種類の変更は**破壊的変更**です。 - -- リクエストやレスポンスのフィールドの削除や名前の変更 -- リクエストやレスポンスのフィールドの型の変更 -- リクエストやレスポンスのフィールドの意味の変更 -- リクエストやレスポンスのフィールドの位置の変更、または他のリクエストやレスポンスのフィールドの前への新しいフィールドの追加 -- APIメソッドの削除や名前の変更 -- 既存のクライアントから確認できるAPI関数の動作の変更 -- 次の種類の変更は、gRPC APIにのみ適用されます。 - - `proto`フィールド番号の変更 - - 列挙型または列挙型値の削除または名前の変更 - - `oneof`からのフィールドの追加または削除 - - `oneof`の分割または統合 - - メッセージフィールドが`optional`、`repeated`、または`required`であるかの変更 - - リクエストまたはレスポンスのストリーム値の変更 - - パッケージまたはサービスの削除または名前の変更 - -フルリリースで破壊的変更が加えられると、新しいAPIバージョン番号が導入されます。プレリリース版、ベータ版、開発版では、同じAPIバージョン番号に変更を加えることがあります。 - -### 非破壊的変更 - -次の種類の変更は**非破壊的変更**であり、APIバージョン番号の変更なしに発生する可能性があります。 - -- パラメータの位置の変更を含まない、新しいフィールドの追加 -- 新しいAPIメソッドの追加 - {% raw-partial file="/docs/_snippets/common-links.md" /%} diff --git a/@l10n/ja/docs/references/http-websocket-apis/index.md b/@l10n/ja/docs/references/http-websocket-apis/index.md index a087c89a73..18291bf32a 100644 --- a/@l10n/ja/docs/references/http-websocket-apis/index.md +++ b/@l10n/ja/docs/references/http-websocket-apis/index.md @@ -6,7 +6,60 @@ metadata: --- # HTTP / WebSocket API リファレンス -XRP Ledgerを管理するコアのピアツーピアサーバであるrippledと直接通信します。 +rippledサーバの公開APIを通じて、XRP Ledgerと通信することができます。 +現在、APIにはバージョン1とバージョン2の2種類があります{% badge href="https://github.com/XRPLF/rippled/releases/tag/2.0.0" %}新規: rippled 2.0.0{% /badge %}。 サーバは、[`version` APIメソッド](public-api-methods/server-info-methods/version.md)を通じてサポートされているAPIバージョンの範囲を通知します。APIリクエストで使用するバージョンを指定できます。 + +同じ持続的な接続で、異なるAPIリクエストで異なるAPIバージョンを使用できます。例えば、WebSocketを通じて、APIバージョン1と2をサポートするサーバに接続した場合、同じ接続からAPIバージョン2を使用して`account_tx`リクエストを行い、その後、APIバージョン1を使用してもう1つの`account_tx`リクエストを行うことができます。 + + +## デフォルトのAPIバージョン + +以下の表は、リクエストでAPIバージョンを指定しない場合に使用される`rippled` APIのバージョンを示しています。 + +| リクエスト方式 | APIバージョン | 追加の注意事項 | +|----------------|---------------|------------------| +| Websocket | 1 | | +| JSON-RPC | 1 | | +| Commandline | 2 | コマンドラインでは、最新のAPIバージョンのみが使用されます。 | +| [xrpl.js](https://github.com/XRPLF/xrpl.js) | 2 | v4.0.0以降では、[API v2][]がデフォルトで使用されます。 | +| [xrpl-py](https://github.com/XRPLF/xrpl-py) | 2 | v3.0.0以降では、[API v2][]がデフォルトで使用されます。 | + +{% admonition type="info" name="注記" %} +Clioは、[API v1][]をデフォルトで使用しますが、[API v2][]のリクエストもサポートしています。 +{% /admonition %} + +`rippled`の将来のバージョンでは、破壊的な変更を導入すると、APIバージョン3が導入されます。 + +### 破壊的な変更 + +以下のタイプの変更は、**破壊的な変更**です。 + +- リクエストまたはレスポンスのフィールドを削除または変更する。 +- リクエストまたはレスポンスのフィールドの型を変更する。 +- リクエストまたはレスポンスのフィールドの意味を変更する。 +- 位置パラメータの順序を変更する、または他の位置パラメータの前に新しいフィールドを追加する。 +- APIメソッドを削除または変更する。 +- 既存のクライアントからアクセス可能なAPI関数の動作を変更する。 +- 以下のタイプの破壊的な変更は、gRPC APIにのみ適用されます。 + - `proto`フィールド番号を変更する。 + - 列挙型または列挙型の値を削除または変更する。 + - `oneof`にフィールドを追加または削除する。 + - `oneof`を分割またはマージする。 + - メッセージフィールドが`optional`、`repeated`、または`required`であるかどうかを変更する。 + - リクエストまたはレスポンスのストリーム値を変更する。 + - パッケージまたはサービスを削除または変更する。 + +いずれかのリリースで破壊的な変更が導入されると、新しいAPIバージョン番号が導入されます。プレリリース、ベータ、開発バージョンは、同じAPIバージョン番号に対して破壊的な変更を導入する場合があります。 + +### 非破壊的な変更 + +以下のタイプの変更は、**非破壊的な変更**です。APIバージョン番号の変更なしに発生する可能性があります。 + +- リクエストまたはレスポンスに新しいフィールドを追加する（位置パラメータを除く）。 +- APIメソッドを追加する。 + +{% raw-partial file="/docs/_snippets/common-links.md" /%} + {% child-pages /%} diff --git a/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/account-methods/account_info.md b/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/account-methods/account_info.md index 8d354d2e31..14d2d63e33 100644 --- a/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/account-methods/account_info.md +++ b/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/account-methods/account_info.md @@ -253,7 +253,7 @@ rippled account_info rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn validated ## 考えられるエラー * いずれかの[汎用エラータイプ][]。 -* `invalidParams` - 1つ以上のフィールドの指定が正しくないか、1つ以上の必須フィールドが指定されていません。例えば、リクエストで`queue`を`true`と指定したが、現在開いているレジャーではない`ledger_index`を指定した場合です。 +* `invalidParams` - 1つ以上のフィールドの指定が正しくないか、1つ以上の必須フィールドが指定されていません。例えば、リクエストで`queue`を`true`と指定したが、現在開いているレジャーではない`ledger_index`を指定した場合です。[API v1]()では、`signer_lists`に非真偽値を指定した場合にこのエラーが発生します。 * `actNotFound` - リクエストの`account`フィールドに指定したアドレスが、レジャー内のアカウントに対応していません。 * `lgrNotFound` - `ledger_hash`または`ledger_index`で指定したレジャーが存在しないか、存在してはいるもののサーバが保有していません。 diff --git a/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/account-methods/account_tx.md b/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/account-methods/account_tx.md index a07f90161b..de49e9c907 100644 --- a/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/account-methods/account_tx.md +++ b/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/account-methods/account_tx.md @@ -28,7 +28,8 @@ labels: "ledger_index_max": -1, "binary": false, "limit": 2, - "forward": false + "forward": false, + "api_version": 2 } ``` {% /tab %} @@ -44,7 +45,8 @@ labels: "forward": false, "ledger_index_max": -1, "ledger_index_min": -1, - "limit": 2 + "limit": 2, + "api_version": 2 } ] } @@ -65,21 +67,21 @@ rippled -- account_tx rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w -1 -1 2 0 binary descen リクエストには以下のパラメーターが含まれます。 -| `Field` | 型 | 説明 | -|:-------------------|:-------------------------------------------|:-----------| -| `account` | 文字列 | アカウントの一意のIDであり、最も一般的なアカウントのアドレスが使用されます。 | -| `tx_type` | 文字列 | _(省略可)_ **Clioのみ** "Clawback"、"AccountSet"、"AccountDelete "など、特定のタイプのトランザクションのみを返します。 See [Transaction Types](../../../../references//protocol/transactions/types/index.md#transaction-types). [新規: Clio v2.0](https://github.com/XRPLF/clio/releases/tag/2.0.0 "BADGE_BLUE") [AMMのサポート: Clio v2.1.0](https://github.com/XRPLF/clio/releases/tag/2.1.0 "BADGE_GREEN") | -| `ledger_index_min` | 整数 | [API v1][]: _（省略可能）_ 含めるトランザクションのレジャーのうち最古のものを指定するのに使用します。`-1`の値は、使用可能な検証済みレジャーのうち最古のバージョンを使用するよう、サーバに指示します。
[API v2][]: v1と同じですが、サーバが持つレジャーの範囲を超えて値を指定すると`lgrIdxMalformed`エラーを返します。 | -| `ledger_index_max` | 整数 | _（省略可能）_ 含めるトランザクションのレジャーのうち最新のものを指定するのに使用します。`-1`の値は、使用可能な検証済みレジャーのうち最新のバージョンを使用するよう、サーバに指示します。
[API v2][]: v1と同じですが、サーバが持つレジャーの範囲を超えて値を指定すると`lgrIdxMalformed`エラーを返します。 | -| `ledger_hash` | 文字列 | [API v1][]: _（省略可能）_ 単一のレジャーからのみトランザクションを検索するのに使用します。（[レジャーの指定][]をご覧ください） | -| `ledger_index` | 文字列または符号なし整数 | _（省略可能）_ 単一のレジャーからのみトランザクションを検索するのに使用します。（[レジャーの指定][]をご覧ください） | -| `binary` | ブール値 | [API v1][]: _（省略可能）_ デフォルトは`false`です。`true`に設定すると、JSONの代わりに16進文字列でトランザクションが返されます。
[API v2][]: v1と同じですが、 真偽値以外の値を指定すると`invalidParams`エラーを返します。 | -| `forward` | ブール値 | [API v1][]: _（省略可能）_ デフォルトは`false`です。`true`に設定すると、最も古いレジャーを先頭としてインデックスが付けられた値が返されます。そうしない場合、最新のレジャーを先頭として結果にインデックスが付けられます。（結果を示した各ページの中身は順序よく整理されていない場合がありますが、ページ全体としては順序付けされています。）
[API v2][]: v1と同じですが、 真偽値以外の値を指定すると`invalidParams`エラーを返します。 | -| `limit` | 整数 | _（省略可能）_ デフォルトは変化します。取得するトランザクションの数を制限します。サーバはこの値を受け入れる必要はありません。 | -| `marker` | [マーカー][] | 以前にページネーションされたレスポンスの値。そのレスポンスを停止した箇所からデータの取得を再開します。サーバが使用できるレジャーの範囲に変更があっても、この値は変わりません。 | +| `Field` | 型 | 説明 | +| :----------------- | :----------------------- | ---- | +| `account` | 文字列 | アカウントの一意のIDであり、最も一般的なアカウントのアドレスが使用されます。 | +| `tx_type` | 文字列 | _(省略可)_ **Clioのみ** "Clawback"、"AccountSet"、"AccountDelete "など、特定のタイプのトランザクションのみを返します。 See [Transaction Types](../../../../references//protocol/transactions/types/index.md#transaction-types). [新規: Clio v2.0](https://github.com/XRPLF/clio/releases/tag/2.0.0 "BADGE_BLUE") [AMMのサポート: Clio v2.1.0](https://github.com/XRPLF/clio/releases/tag/2.1.0 "BADGE_GREEN") | +| `ledger_index_min` | 整数 | _（省略可能）_ 含めるトランザクションのレジャーのうち最古のものを指定するのに使用します。`-1`の値は、使用可能な検証済みレジャーのうち最古のバージョンを使用するよう、サーバに指示します。 | +| `ledger_index_max` | 整数 | _（省略可能）_ 含めるトランザクションのレジャーのうち最新のものを指定するのに使用します。`-1`の値は、使用可能な検証済みレジャーのうち最新のバージョンを使用するよう、サーバに指示します。 | +| `ledger_hash` | 文字列 | _（省略可能）_ 単一のレジャーからのみトランザクションを検索するのに使用します。（[レジャーの指定][]をご覧ください） | +| `ledger_index` | 文字列または符号なし整数 | _（省略可能）_ 単一のレジャーからのみトランザクションを検索するのに使用します。（[レジャーの指定][]をご覧ください） | +| `binary` | ブール値 | _（省略可能）_ デフォルトは`false`です。`true`に設定すると、JSONの代わりに16進文字列でトランザクションが返されます。 | +| `forward` | ブール値 | _（省略可能）_ デフォルトは`false`です。`true`に設定すると、最も古いレジャーを先頭としてインデックスが付けられた値が返されます。そうしない場合、最新のレジャーを先頭として結果にインデックスが付けられます。（結果を示した各ページの中身は順序よく整理されていない場合がありますが、ページ全体としては順序付けされています。） | +| `limit` | 整数 | _（省略可能）_ デフォルトは変化します。取得するトランザクションの数を制限します。サーバはこの値を受け入れる必要はありません。 | +| `marker` | [マーカー][] | 以前にページネーションされたレスポンスの値。そのレスポンスを停止した箇所からデータの取得を再開します。サーバが使用できるレジャーの範囲に変更があっても、この値は変わりません。 | - リクエスト内で次の各フィールドのうち1つ以上を使用する必要があります: `ledger_index`、`ledger_hash`、`ledger_index_min`、または`ledger_index_max`。 -- [API v2]： `ledger_index` と `ledger_hash` のどちらかを指定した場合、`ledger_index_min` と `ledger_index_max` を含めると `invalidParams` エラーが返ります。 +- [API v2]： `ledger_index`と`ledger_hash`のどちらかを指定した場合、`ledger_index_min`と`ledger_index_max`を含めると`invalidParams`エラーが返ります。 ### 照会されたデータの繰り返し @@ -97,16 +99,10 @@ rippled -- account_tx rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w -1 -1 2 0 binary descen {% tab label="WebSocket" %} ```json { - "id": 2, "result": { - "account": "rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w", - "ledger_index_max": 57111999, - "ledger_index_min": 55886305, - "limit": 2, - "marker": { - "ledger": 57111981, - "seq": 16 - }, + "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", + "ledger_index_min": 32570, + "ledger_index_max": 91824401, "transactions": [ { "meta": { @@ -114,130 +110,151 @@ rippled -- account_tx rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w -1 -1 2 0 binary descen { "ModifiedNode": { "FinalFields": { - "Account": "rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w", - "Balance": "3732969177079", - "Flags": 131072, - "OwnerCount": 0, - "Sequence": 702817 + "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", + "AccountTxnID": "932CC7E9BAC1F7B9FA5381679F293EEC0A646E5E7F2F6D14C85FEE2102F0E66C", + "Balance": "1086222646", + "Domain": "6D64756F31332E636F6D", + "EmailHash": "98B4375E1D753E5B91627516F6D70977", + "Flags": 9568256, + "MessageKey": "0000000000000000000000070000000300", + "OwnerCount": 17, + "RegularKey": "rD9iJmieYHn8jTtPjwwkW2Wm9sVDvPXLoJ", + "Sequence": 393, + "TicketCount": 5, + "TransferRate": 4294967295 }, "LedgerEntryType": "AccountRoot", - "LedgerIndex": "140FA03FE8C39540CA8189BC7A7956795C712BC0A542C6409C041150703C8574", + "LedgerIndex": "13F1A95D7AAB7108D5CE7EEAF504B2894B8C674E6D68499076441C4837282BF8", "PreviousFields": { - "Balance": "3713891690008" + "Balance": "1086222601" }, - "PreviousTxnID": "D58864C16344ADCC15995C7986CFC607CB693E88F84D2E019F0A35FB29749202", - "PreviousTxnLgrSeq": 57111994 + "PreviousTxnID": "7E50969CDEF8E12B1AD26E64B338935813624A4D1CDDC4C9457832524F0FF74C", + "PreviousTxnLgrSeq": 89353048 } }, { "ModifiedNode": { "FinalFields": { - "Account": "rw2ciyaNshpHe7bCHo4bRWq6pqqynnWKQg", - "Balance": "40010160", - "Flags": 131072, + "Account": "rPJARH5nLWQisdmvDAbvzwS7N32Z1kusTZ", + "Balance": "55022190", + "Flags": 0, "OwnerCount": 0, - "Sequence": 466334 + "Sequence": 89113341 }, "LedgerEntryType": "AccountRoot", - "LedgerIndex": "CC20FEBEA6D2AF969EC46F2BD92684D9FBABC3F238E841B5E056FE4EBF4379A9", + "LedgerIndex": "C0363F86E070B70E7DA129736C3B05E509261C8668F61A7E958C4C10F17EAB90", "PreviousFields": { - "Balance": "19117497271", - "Sequence": 466333 + "Balance": "55022245", + "Sequence": 89113340 }, - "PreviousTxnID": "F6B8274D3D419A95A59681E5F55578084C395FF9051924360CA3EA745F5581E8", - "PreviousTxnLgrSeq": 57111993 + "PreviousTxnID": "60D0FE881F9B1457FB1711011C6E490C22532B1D495557D6488BE3A634167CEE", + "PreviousTxnLgrSeq": 90136515 } } ], - "TransactionIndex": 25, + "TransactionIndex": 2, "TransactionResult": "tesSUCCESS", - "delivered_amount": "19077487071" + "delivered_amount": "45" }, - "tx": { - "Account": "rw2ciyaNshpHe7bCHo4bRWq6pqqynnWKQg", - "Amount": "19077487071", - "Destination": "rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w", - "DestinationTag": 1, - "Fee": "40", - "Flags": 2147483648, - "LastLedgerSequence": 57112020, - "Sequence": 466333, - "SigningPubKey": "0381575032E254BF4D699C3D8D6EFDB63B3A71F97475C6F6885BC7DAEEE55D9A01", + "tx_json": { + "Account": "rPJARH5nLWQisdmvDAbvzwS7N32Z1kusTZ", + "DeliverMax": "45", + "Destination": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", + "DestinationTag": 316562, + "Fee": "10", + "Sequence": 89113340, + "SigningPubKey": "EDE21591E615E1D77C8C8A7F95372D001B3DF090AB47B99729CFCBC1E4E07D35F4", "TransactionType": "Payment", - "TxnSignature": "3045022100CFC5FD057C7C685C690637AD1E639E2642BBC00EFD8E06E3F6C72FA924BC99D40220317D0708E814F69F874D641B6732E37A53B1220B493B2B8390D9EF51E8062515", - "date": 649200260, - "hash": "46BF0B576677B0DEA2D94591424A57A2DE8E3D89383631E16F40D09A513C656C", - "inLedger": 57111998, - "ledger_index": 57111998 + "TxnSignature": "D229FEB6ED82367102AC12DE5045BE6D548CBB52E0CB8F037A23171910A6158FA3377F5118B6CEAFDB07D6D43F76FE29CC26BE1ACBC7A86C9D86E14043C66104", + "ledger_index": 90136515, + "date": 777284672 }, + "ledger_index": 90136515, + "hash": "894541402AC968C98C329A88D097170B14BF4DEB8B2A7DF377EE89DDD332E018", + "ledger_hash": "14110F60753176E1F6A71AA084B6AD8663CBB46193CCFCDFAC02561626AA6B75", + "close_time_iso": "2024-08-18T08:24:32Z", "validated": true - }, + } { "meta": { "AffectedNodes": [ { "ModifiedNode": { "FinalFields": { - "Account": "rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w", - "Balance": "3713891690008", - "Flags": 131072, - "OwnerCount": 0, - "Sequence": 702817 + "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", + "AccountTxnID": "932CC7E9BAC1F7B9FA5381679F293EEC0A646E5E7F2F6D14C85FEE2102F0E66C", + "Balance": "1086222601", + "Domain": "6D64756F31332E636F6D", + "EmailHash": "98B4375E1D753E5B91627516F6D70977", + "Flags": 9568256, + "MessageKey": "0000000000000000000000070000000300", + "OwnerCount": 17, + "RegularKey": "rD9iJmieYHn8jTtPjwwkW2Wm9sVDvPXLoJ", + "Sequence": 393, + "TicketCount": 5, + "TransferRate": 4294967295 }, "LedgerEntryType": "AccountRoot", - "LedgerIndex": "140FA03FE8C39540CA8189BC7A7956795C712BC0A542C6409C041150703C8574", + "LedgerIndex": "13F1A95D7AAB7108D5CE7EEAF504B2894B8C674E6D68499076441C4837282BF8", "PreviousFields": { - "Balance": "3714441690048", - "Sequence": 702816 + "Balance": "1086222552" }, - "PreviousTxnID": "FDD5007913B39027BAF10B31144DBC1F7DC147528DF31FF048A06DC5D3108BD6", - "PreviousTxnLgrSeq": 57111981 + "PreviousTxnID": "EED9EB1880B951FAB3EE0DBBEB67B7ABEE3FA77F15782B6BD40342B3C23CFB75", + "PreviousTxnLgrSeq": 89343389 } }, { "ModifiedNode": { "FinalFields": { - "Account": "r9dU6Z7P2i7MrDi1VUZ7uyq6J77eg86YtB", - "Balance": "2629998983", + "Account": "rPSDqHdMPsnkmyUX4BvBkY8rycQYwrhUqw", + "Balance": "52611432", "Flags": 0, "OwnerCount": 0, - "Sequence": 10 + "Sequence": 89196186 }, "LedgerEntryType": "AccountRoot", - "LedgerIndex": "27B96FE681B33825CC95DA197358B30D3A1721F2125F2D76022D46B2418ABA0A", + "LedgerIndex": "20761D2C37004C70318F7A3C5A1C35817A90A0AE56485F6E3281FB2B3F05B0C9", "PreviousFields": { - "Balance": "2079998983" + "Balance": "52611491", + "Sequence": 89196185 }, - "PreviousTxnID": "44A47AC04C0C7237C32BE9A532B578D07641705D3A59DB9B3C5B6225001E39B7", - "PreviousTxnLgrSeq": 56613857 + "PreviousTxnID": "BAF86C2776C08407E0FAF42D374874E10430CB8C23AD464D9D9097EA326ABE92", + "PreviousTxnLgrSeq": 89353024 } } ], - "TransactionIndex": 16, + "TransactionIndex": 4, "TransactionResult": "tesSUCCESS", - "delivered_amount": "550000000" + "delivered_amount": "49" }, - "tx": { - "Account": "rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w", - "Amount": "550000000", - "Destination": "r9dU6Z7P2i7MrDi1VUZ7uyq6J77eg86YtB", - "Fee": "40", - "Flags": 2147483648, - "LastLedgerSequence": 57112016, - "Sequence": 702816, - "SigningPubKey": "020A46D8D02AC780C59853ACA309EAA92E7D8E02DD72A0B6AC315A7D18A6C3276A", + "tx_json": { + "Account": "rPSDqHdMPsnkmyUX4BvBkY8rycQYwrhUqw", + "DeliverMax": "49", + "Destination": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", + "DestinationTag": 342662134, + "Fee": "10", + "Sequence": 89196185, + "SigningPubKey": "ED7E4A2970ADFCCE93D59D469322745E98CBEB3D7D5388728B3BB2268E71F30B0F", "TransactionType": "Payment", - "TxnSignature": "3045022100D589029EF63F9E528F6100C7A36D26AFFF84085EC9AC16DA8E30E11F390D4E87022011466E0FE4A90B89142EE47E535545EEA4A2D65E0BD234DFB447721218B59C9B", - "date": 649200241, - "hash": "D58864C16344ADCC15995C7986CFC607CB693E88F84D2E019F0A35FB29749202", - "inLedger": 57111994, - "ledger_index": 57111994 + "TxnSignature": "8CE14FD18BD186694DED8C204C3FCC2A527CC24AD51C2E0B2B792D035C85D662BC1A1450A8DF04BBEC66821B362056311127C627056AC7779B385517FD3A9202", + "ledger_index": 89353048, + "date": 774249571 }, + "ledger_index": 89353048, + "hash": "7E50969CDEF8E12B1AD26E64B338935813624A4D1CDDC4C9457832524F0FF74C", + "ledger_hash": "ED54DA98F3E495C36C2B0D9A511565E04454A1F4503B9DEE3FD39301D7625865", + "close_time_iso": "2024-07-14T05:19:31Z", "validated": true } ], - "validated": true + "validated": true, + "marker": { + "ledger": 89353048, + "seq": 4 + }, + "limit": 2 }, + "api_version": 2, "status": "success", "type": "response" } @@ -246,149 +263,130 @@ rippled -- account_tx rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w -1 -1 2 0 binary descen {% tab label="JSON-RPC" %} ```json -200 OK { "result": { "account": "rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w", - "ledger_index_max": 57112019, - "ledger_index_min": 56248229, - "limit": 2, - "marker": { - "ledger": 57112007, - "seq": 13 - }, - "status": "success", - "transactions": [ - { - "meta": { - "AffectedNodes": [ - { - "ModifiedNode": { - "FinalFields": { - "Account": "rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w", - "Balance": "3732290013101", - "Flags": 131072, - "OwnerCount": 0, - "Sequence": 702820 - }, - "LedgerEntryType": "AccountRoot", - "LedgerIndex": "140FA03FE8C39540CA8189BC7A7956795C712BC0A542C6409C041150703C8574", - "PreviousFields": { - "Balance": "3732745656171", - "Sequence": 702819 - }, - "PreviousTxnID": "7C031FD5B710E3C048EEF31254089BEEC505900BCC9A842257A0319453333998", - "PreviousTxnLgrSeq": 57112010 - } + "ledger_index_min": 32570, + "ledger_index_max": 91824423, + "transactions": [{ + "meta": { + "AffectedNodes": [{ + "ModifiedNode": { + "FinalFields": { + "Account": "rLJmawLfNAFNyyYHFbNErTfCrfsbmRzrTc", + "Balance": "77694521", + "Domain": "7872702D6C65646765722D746F6D6C2E68746D6C", + "EmailHash": "CE29D0E8928E95C3FF5BDD8CFE82F445", + "Flags": 8388608, + "MessageKey": "02000000000000000000000000A9E7611C8B9AFE2DEDA42039DBF09F3BFA185F76", + "OwnerCount": 26, + "RegularKey": "rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w", + "Sequence": 62418073 }, - { - "ModifiedNode": { - "FinalFields": { - "Account": "raLPjTYeGezfdb6crXZzcC8RkLBEwbBHJ5", - "Balance": "4231510602153", - "Flags": 0, - "OwnerCount": 0, - "Sequence": 96486 - }, - "LedgerEntryType": "AccountRoot", - "LedgerIndex": "39DC5D448DECEFC3CD20818788E3DA891CA943935E8D7B12FCB5B5871FCB1638", - "PreviousFields": { - "Balance": "4231054959123" - }, - "PreviousTxnID": "33D2014C832610293730028CA37857AC183BFCE3E42B9979C491FB8B82B3E9DC", - "PreviousTxnLgrSeq": 57112004 - } - } - ], - "TransactionIndex": 12, - "TransactionResult": "tesSUCCESS", - "delivered_amount": "455643030" - }, - "tx": { - "Account": "rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w", - "Amount": "455643030", - "Destination": "raLPjTYeGezfdb6crXZzcC8RkLBEwbBHJ5", - "DestinationTag": 18240312, - "Fee": "40", - "Flags": 2147483648, - "LastLedgerSequence": 57112037, - "Sequence": 702819, - "SigningPubKey": "020A46D8D02AC780C59853ACA309EAA92E7D8E02DD72A0B6AC315A7D18A6C3276A", - "TransactionType": "Payment", - "TxnSignature": "30450221008602B2E390C0C7B65182C6DBC86292052C1961B2BEFB79C2C8431722C0ADB911022024B74DCF910A4C8C95572CF662EB7F5FF67E1AC4D7B9B7BFE2A8EE851EC16576", - "date": 649200322, - "hash": "08EF5BDA2825D7A28099219621CDBECCDECB828FEA202DEB6C7ACD5222D36C2C", - "inLedger": 57112015, - "ledger_index": 57112015 - }, - "validated": true + "LedgerEntryType": "AccountRoot", + "LedgerIndex": "548E97B1F63273FC2F339CBEB8C202FBF9231C4C61BC1BA51A6239501A2F6FB9", + "PreviousFields": { + "Balance": "77694533", + "Sequence": 62418072 + }, + "PreviousTxnID": "5FDB0B2ECE005EEA87DC35B33204424D0766AB37B764F1618A6C69C06BDDD511", + "PreviousTxnLgrSeq": 87319056 + } + }], + "TransactionIndex": 24, + "TransactionResult": "tesSUCCESS" }, - { - "meta": { - "AffectedNodes": [ - { - "ModifiedNode": { - "FinalFields": { - "Account": "rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w", - "Balance": "3732745656171", - "Flags": 131072, - "OwnerCount": 0, - "Sequence": 702819 - }, - "LedgerEntryType": "AccountRoot", - "LedgerIndex": "140FA03FE8C39540CA8189BC7A7956795C712BC0A542C6409C041150703C8574", - "PreviousFields": { - "Balance": "3732246155784" - }, - "PreviousTxnID": "CCBCCB528F602007C937C496F0828C118E073DF180084CCD3646EC1E414844E4", - "PreviousTxnLgrSeq": 57112007 - } + "tx_json": { + "Account": "rLJmawLfNAFNyyYHFbNErTfCrfsbmRzrTc", + "Fee": "12", + "Flags": 131072, + "LastLedgerSequence": 88061884, + "LimitAmount": { + "currency": "QNT", + "issuer": "rGPsXnzAkdv1FYKkhC59GRp3M42axDhE1d", + "value": "500000000" + }, + "Sequence": 62418072, + "SigningPubKey": "023833AB55CD985EB4F7744DC2B02D34886A71ECC0177EE59749A0113ABEE8D64A", + "TransactionType": "TrustSet", + "TxnSignature": "304402201B00F6D2D9C3B290B8EB3CBAB15612C16C7C06E1D5D8A8B55528D4E1762EB7110220565D2A7369884D84F324FB3CA521BA4EDAFF8F2DDDE48AF8992CF99DF0EEB3F0", + "ledger_index": 88061876, + "date": 769309032 + }, + "ledger_index": 88061876, + "hash": "735E296F0F271382FF8FBBBD0058AC7330419B8A1C955388A7384E5E3D5B2FCB", + "ledger_hash": "95B2DA521829572779128884B145DF921B4239CC74057C08EB570DD31641A8F5", + "close_time_iso": "2024-05-18T00:57:12Z", + "validated": true + }, { + "meta": { + "AffectedNodes": [{ + "ModifiedNode": { + "FinalFields": { + "Account": "rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w", + "Balance": "8579705270", + "Flags": 131072, + "OwnerCount": 0, + "Sequence": 1152385 }, - { - "ModifiedNode": { - "FinalFields": { - "Account": "rw2ciyaNshpHe7bCHo4bRWq6pqqynnWKQg", - "Balance": "236476361", - "Flags": 131072, - "OwnerCount": 0, - "Sequence": 466335 - }, - "LedgerEntryType": "AccountRoot", - "LedgerIndex": "CC20FEBEA6D2AF969EC46F2BD92684D9FBABC3F238E841B5E056FE4EBF4379A9", - "PreviousFields": { - "Balance": "735976788", - "Sequence": 466334 - }, - "PreviousTxnID": "C528B32DD588EFAE2FE833E8AA92E6AE2DF2C8DB3DB8C6C4F334AD37B253D72A", - "PreviousTxnLgrSeq": 57112010 - } - } - ], - "TransactionIndex": 33, - "TransactionResult": "tesSUCCESS", - "delivered_amount": "499500387" - }, - "tx": { - "Account": "rw2ciyaNshpHe7bCHo4bRWq6pqqynnWKQg", - "Amount": "499500387", - "Destination": "rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w", - "DestinationTag": 1, - "Fee": "40", - "Flags": 2147483648, - "LastLedgerSequence": 57112032, - "Sequence": 466334, - "SigningPubKey": "0381575032E254BF4D699C3D8D6EFDB63B3A71F97475C6F6885BC7DAEEE55D9A01", - "TransactionType": "Payment", - "TxnSignature": "3045022100C7EA1701FE48C75508EEBADBC9864CD3FFEDCEB48AB99AEA960BFA360AE163ED0220453C9577502924C9E1A9A450D4B950A44016813BC70E1F16A65A402528D730B7", - "date": 649200302, - "hash": "7C031FD5B710E3C048EEF31254089BEEC505900BCC9A842257A0319453333998", - "inLedger": 57112010, - "ledger_index": 57112010 - }, - "validated": true - } - ], - "validated": true + "LedgerEntryType": "AccountRoot", + "LedgerIndex": "140FA03FE8C39540CA8189BC7A7956795C712BC0A542C6409C041150703C8574", + "PreviousFields": { + "Balance": "8554705270" + }, + "PreviousTxnID": "DB31B6D0A304777F125CAD069E2D2C60829475BC30A5DB63376C425C10B85752", + "PreviousTxnLgrSeq": 86879421 + } + }, { + "ModifiedNode": { + "FinalFields": { + "Account": "rpKoCafrEz7FxQZ9FfktocuBGNZZyrz4KH", + "Balance": "802086263", + "Flags": 0, + "OwnerCount": 0, + "Sequence": 60818358 + }, + "LedgerEntryType": "AccountRoot", + "LedgerIndex": "481C0CDDC838688B61B960A1EE721F657BD8E501F64141A51E9A905A1D87A2C9", + "PreviousFields": { + "Balance": "827086275", + "Sequence": 60818357 + }, + "PreviousTxnID": "7C1671C63D75EBDDD87672D1DE9D5A9EAEAF34C37BDB29D1359301B85ECEF776", + "PreviousTxnLgrSeq": 60818357 + } + }], + "TransactionIndex": 39, + "TransactionResult": "tesSUCCESS", + "delivered_amount": "25000000" + }, + "tx_json": { + "Account": "rpKoCafrEz7FxQZ9FfktocuBGNZZyrz4KH", + "DeliverMax": "25000000", + "Destination": "rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w", + "DestinationTag": 997786069, + "Fee": "12", + "LastLedgerSequence": 87598991, + "Sequence": 60818357, + "SigningPubKey": "0229DA128237D9A63FBA95666C5B8794F455875D843EDF39F6C02DF07FD5B4720D", + "TransactionType": "Payment", + "TxnSignature": "304402203B0048779085087566AABB4B878EF30EB41D3B29581937111F2708780EE4168702203E2D3B1B73F3F8B86EE009F818B226467E3BFC444B831AE851E0E0B0FB7F49C8", + "ledger_index": 87598983, + "date": 767543720 + }, + "ledger_index": 87598983, + "hash": "16DFB8551F5301E3B7D1BCEAA8DB92E9AF5D783E6DCA7C0E11FD143D988E904A", + "ledger_hash": "2B363FD30EA376E2662777CEBDDDE22C035A87DA3CD3EA0E6125CBBC9D8A7873", + "close_time_iso": "2024-04-27T14:35:20Z", + "validated": true + }], + "validated": true, + "marker": { + "ledger": 87598983, + "seq": 39 + }, + "limit": 2, + "status": "success" } } ``` @@ -431,34 +429,74 @@ rippled -- account_tx rLNaPoKeeBjZe2qs6x52yVPZpZ8td4dc6w -1 -1 2 0 binary descen このレスポンスは[標準フォーマット][]に従っており、正常に完了した場合は結果に次のフィールドが含まれます。 -| `Field` | 型 | 説明 | +{% tabs %} + +{% tab label="API v2" %} + +| `Field` | 型 | 説明 | |:-------------------|:---------------------------|:---------------------------| -| `account` | 文字列 | 関連するアカウントを識別する一意の[アドレス][]。 | +| `account` | 文字列 | 関連するアカウントを識別する一意の[アドレス][] | +| `ledger_index_min` | 数値 - [レジャーインデックス][] | 実際に検索された最小のレジャーのレジャーインデックス。 | +| `ledger_index_max` | 数値 - [レジャーインデックス][] | 実際に検索された最大のレジャーのレジャーインデックス。 | +| `limit` | 数値 | リクエストで使用された`limit`値。（サーバによって強制される実際の制限値とは異なる場合があります。） | +| `marker` | [マーカー][] | レスポンスがページネーションされていることを示す、サーバが定義した値。この値を次のコールに渡して、このコールで終わった箇所から再開します。 | +| `meta` | オブジェクト（JSON） | (JSONモード) トランザクション結果のメタデータのJSON。 | +| `meta_blob` | 文字列（バイナリ） | (バイナリモード) トランザクション結果のメタデータの16進文字列。 | +| `transactions` | 配列 | リクエストの基準を満たすトランザクションの配列。 | +| `validated` | 真偽値 | このフィールドが含まれていて`true`に設定されている場合、このレスポンス内の情報は検証済みのレジャーバージョンから取得されています。そうでない場合、情報は変更される場合があります。 | + +{% admonition type="info" name="注記" %}サーバから返される`ledger_index_min`および`ledger_index_max`の値がリクエストで指定したものとは異なる場合があります。(例えば、サーバに手元の指定したバージョンがない場合など){% /admonition %} + +各トランザクションのオブジェクトには以下のフィールドが含まれます。JSONまたはバイナリ（`"binary":true`）フォーマットのどちらでリクエストされたかによって異なります。 + +| `Field` | 型 | 説明 | +|:-----------------|:---------------------|:------------------| +| `close_time_iso` | 文字列 | ISO 8601形式で表されたレジャー閉鎖時間。 | +| `hash` | 文字列 | トランザクションの一意のハッシュ識別子。 | +| `ledger_hash` | 文字列 | このトランザクションを含むレジャーバージョンのハッシュの16進文字列。 | +| `ledger_index` | 整数 | このトランザクションを含むレジャーバージョンの[レジャーインデックス][]。 | +| `tx_json` | オブジェクト（JSON） | (JSONモード) JSONオブジェクトでトランザクションを定義します。 | +| `tx_blob` | 文字列（バイナリ） | (バイナリモード) トランザクションを定義する一意の16進文字列。 | +| `validated` | 真偽値 | このトランザクションが検証済みのレジャーに含まれるかどうか。検証済みのレジャーに含まれていないトランザクションはすべて、変更される場合があります。 | + +{% /tab %} + +{% tab label="API v1" %} + +| `Field` | 型 | 説明 | +| :----------------- | :------------------------------ | ---- | +| `account` | 文字列 | 関連するアカウントを識別する一意の[アドレス][]。 | | `ledger_index_min` | 整数 - [レジャーインデックス][] | トランザクションで実際に検索された最古のレジャーのレジャーインデックス。 | | `ledger_index_max` | 整数 - [レジャーインデックス][] | トランザクションで実際に検索された最新のレジャーのレジャーインデックス。 | -| `limit` | 整数 | リクエストで使用される`limit`値。（サーバによって強制される実際の制限値とは異なる場合があります。） | -| `marker` | [マーカー][] | レスポンスがページネーションされていることを示す、サーバが定義した値。この値を次のコールに渡して、このコールで終わった箇所から再開します。 | -| `transactions` | 配列 | 以降で説明する、リクエストの基準を満たすトランザクションの配列。 | -| `validated` | ブール値 | このフィールドが含まれていて`true`に設定されている場合、このレスポンス内の情報は検証済みのレジャーバージョンから取得されています。そうでない場合、情報は変更されることがあります。 | +| `limit` | 整数 | リクエストで使用される`limit`値。（サーバによって強制される実際の制限値とは異なる場合があります。） | +| `marker` | [マーカー][] | レスポンスがページネーションされていることを示す、サーバが定義した値。この値を次のコールに渡して、このコールで終わった箇所から再開します。 | +| `meta` | オブジェクト（JSON）または文字列（バイナリ） | `binary`が`true`の場合、これはトランザクション結果のメタデータの16進文字列です。そうでない場合、トランザクション結果のメタデータはJSONフォーマットとなります。 | +| `transactions` | 配列 | 以降で説明する、リクエストの基準を満たすトランザクションの配列。 | +| `validated` | ブール値 | このフィールドが含まれていて`true`に設定されている場合、このレスポンス内の情報は検証済みのレジャーバージョンから取得されています。そうでない場合、情報は変更されることがあります。 | {% admonition type="info" name="注記" %}サーバから返される`ledger_index_min`および`ledger_index_max`の値がリクエストで指定したものとは異なる場合があります。例えば、サーバに手元の指定したバージョンがない場合など。{% /admonition %} 各トランザクションのオブジェクトには以下のフィールドが含まれます。含まれるフィールドは、JSONまたは16進文字列（`"binary":true`）フォーマットのどちらでリクエストされたかによって異なります。 -| `Field` | 型 | 説明 | -|:---------------|:---------------------------------|:-------------------------| -| `ledger_index` | 整数 | このトランザクションを含むレジャーバージョンの[レジャーインデックス][]。 | -| `meta` | オブジェクト（JSON）または文字列（バイナリ） | `binary`がTrueの場合、これは16進文字列のトランザクションメタデータです。そうでない場合、トランザクションメタデータはJSONフォーマットになります。 | -| `tx` | オブジェクト | （JSONモードのみ）トランザクションを定義するJSONオブジェクト。 | -| `tx_blob` | 文字列 | （バイナリモードのみ）トランザクションを表す一意のハッシュ化された文字列。 | -| `validated` | ブール値 | トランザクションが検証済みのレジャーに含まれるかどうか。検証済みのレジャーに含まれていないトランザクションはすべて、変更される場合があります。 | +| `Field` | 型 | 説明 | +| :------------- | :----------- | ---- | +| `ledger_index` | 整数 | このトランザクションを含むレジャーバージョンの[レジャーインデックス][]。 | +| `tx` | オブジェクト | (JSONモード) トランザクションのJSON表現。 | +| `tx_blob` | 文字列 | (バイナリモード) トランザクションの16進文字列表現。 | +| `validated` | ブール値 | トランザクションが検証済みのレジャーに含まれるかどうか。検証済みのレジャーに含まれていないトランザクションはすべて、変更される場合があります。 | + +{% /tab %} + +{% /tabs %} ## 考えられるエラー * いずれかの[汎用エラータイプ][]。 -* `invalidParams` - 1つ以上のフィールドの指定が正しくないか、1つ以上の必須フィールドが指定されていません。 +* 1つ以上のフィールドが正しく指定されていないか、1つ以上の必須フィールドが欠落しています。[API v1][]では、以下のように指定することで、このエラーを回避できます。 + * `ledger_index_min`または`ledger_index_max`、または`ledger_index`または`ledger_hash`を指定します。 + * `binary`または`forward`フィールドに対して非ブール値を指定します。 * `actMalformed` - リクエストの`account`フィールドに指定した[アドレス][]が、正しいフォーマットではありません。 -* `lgrIdxMalformed` - `ledger_index_min`または`ledger_index_max`で指定したレジャーが存在しないか、存在してはいるもののサーバが保有していません。 +* `lgrIdxMalformed` - `ledger_index_min`または`ledger_index_max`で指定したレジャーが存在しないか、存在してはいるもののサーバが保有していません。[API v1][]では、`ledger_index_min`または`ledger_index_max`にサーバが保有していないレジャーの範囲を指定した場合にこのエラーが発生します。 * `lgrIdxsInvalid` - リクエストで`ledger_index_min`の前にある`ledger_index_max`を指定したか、[ネットワークと同期](../../../../infrastructure/troubleshooting/index.md)されていないためにサーバに検証済みレジャーの範囲が存在しません。 {% raw-partial file="/docs/_snippets/common-links.md" /%} diff --git a/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/account-methods/noripple_check.md b/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/account-methods/noripple_check.md index d99f80435e..ecb7308c74 100644 --- a/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/account-methods/noripple_check.md +++ b/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/account-methods/noripple_check.md @@ -53,14 +53,14 @@ labels: リクエストには以下のパラメーターが含まれます。 -| `Field` | 型 | 説明 | -|:---------------|:---------------------------|:-------------------------------| +| `Field` | 型 | 説明 | +|:---------------|:---------------------------|:-----| | `account` | 文字列 | アカウントの一意のIDであり、通常はアカウントのアドレスです。 | | `role` | 文字列 | アドレスが`gateway`と`user`のいずれを指しているか。推奨事項はアカウントの役割に応じて異なります。イシュアーのDefaultRippleを有効にし、すべてのトラストラインでNoRippleを無効にする必要があります。ユーザのDefaultRippleを無効にし、すべてのトラストラインでNoRippleを有効にする必要があります。 | -| `transactions` | ブール値 | _（省略可）_ `true`の場合、提案される[トランザクション](../../../protocol/transactions/index.md)（JSONオブジェクト）の配列を指定します。問題を修正するために、これらのトランザクションに署名して送信することができます。デフォルトではfalseです。 | -| `limit` | 符号なし整数 | _（省略可）_ 結果に含めることができるトラストライン問題の最大数。デフォルトでは300です。 | -| `ledger_hash` | 文字列 | _（省略可）_ 使用するレジャーバージョンの20バイトの16進数文字列。（[レジャーの指定][]をご覧ください。) | -| `ledger_index` | 文字列または符号なし整数 | _（省略可）_ 使用するレジャーのシーケンス番号、またはレジャーを自動的に選択するためのショートカット文字列。（[レジャーの指定][]をご覧ください。) | +| `transactions` | ブール値 | _（省略可）_ `true`の場合、提案される[トランザクション](../../../protocol/transactions/index.md)（JSONオブジェクト）の配列を指定します。問題を修正するために、これらのトランザクションに署名して送信することができます。デフォルトでは`false`です。 | +| `limit` | 符号なし整数 | _（省略可）_ 結果に含めることができるトラストライン問題の最大数。デフォルトでは300です。 | +| `ledger_hash` | 文字列 | _（省略可）_ 使用するレジャーバージョンの20バイトの16進数文字列。（[レジャーの指定][]をご覧ください。 | +| `ledger_index` | 文字列または符号なし整数 | _（省略可）_ 使用するレジャーのシーケンス番号、またはレジャーを自動的に選択するためのショートカット文字列。（[レジャーの指定][]をご覧ください。 | ## レスポンスのフォーマット @@ -184,7 +184,7 @@ labels: ## 考えられるエラー * [汎用エラータイプ][]のすべて。 -* `invalidParams` - 1つ以上のフィールドの指定が正しくないか、1つ以上の必須フィールドが指定されていません。 +* `invalidParams` - 1つ以上のフィールドの指定が正しくないか、1つ以上の必須フィールドが指定されていません。[API v1][]では、`transactions`フィールドに非ブール値を指定した場合にこのエラーが発生します。 * `actNotFound` - リクエストの`account`フィールドに指定されている[アドレス][]が、レジャーのアカウントに対応していません。 * `lgrNotFound` - `ledger_hash`または`ledger_index`に指定されているレジャーが存在しないか、存在しているがサーバにはありません。 diff --git a/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/index.md b/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/index.md index fba5c0dad7..6c68c9691d 100644 --- a/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/index.md +++ b/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/index.md @@ -49,7 +49,6 @@ XRP Ledgerのアカウントとは、XRPの保有者と取引の送信者を意 * **[`submit_multisigned`](transaction-methods/submit_multisigned.md)** - マルチ署名済みトランザクションをネットワークに送信します。 * **[`transaction_entry`](transaction-methods/transaction_entry.md)** - レジャーの特定のバージョンからトランザクションについての情報を取得します。 * **[`tx`](transaction-methods/tx.md)** - 手元にあるすべてのレジャーからトランザクションについての情報を取得します。 -* **[`tx_history`](transaction-methods/tx_history.md)** - 最新の全トランザクションについての情報を取得します。 ## [パスおよびオーダーブックのメソッド](path-and-order-book-methods/index.md) @@ -99,6 +98,11 @@ Payment Channel は、2名の当事者間での一方向の繰り返しの支払 * **[`random`](utility-methods/random.md)** - 乱数を生成します。 -## 廃止予定のメソッド +## 非推奨のメソッド -`owner_info`コマンドは廃止される予定です。代わりに[`account_objects`](account-methods/account_objects.md)を使用してください。 +以下の方法は廃止予定であり、すでに削除されているか、または予告なく削除される場合があります。 + +* **`owner_info`** - 代わりに[`account_objects`](account-methods/account_objects.md)を使用してください。 +* **[`tx_history`](transaction-methods/tx_history.md)** - 代わりに[`account_tx`](account-methods/account_tx.md)メソッド、または[`ledger`](ledger-methods/ledger.md)メソッドを使用し、`transactions`フィールドを`true`に設定してください。 + +{% raw-partial file="/docs/_snippets/common-links.md" /%} diff --git a/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/subscription-methods/subscribe.md b/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/subscription-methods/subscribe.md index fc6e5c1ade..03fe8bbb1c 100644 --- a/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/subscription-methods/subscribe.md +++ b/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/subscription-methods/subscribe.md @@ -66,37 +66,42 @@ labels: リクエストには以下のパラメーターが含まれます。 -| `Field` | 型 | 説明 | -|:--------------------|:-------|:----------------------------------------------| -| `streams` | 配列 | _（省略可）_ 以下に説明する、サブスクライブする汎用ストリームの文字列名の配列。 | -| `accounts` | 配列 | _（省略可）_ 検証済みトランザクションを監視するアカウントの一意のアドレスを持つ配列。これらのアドレスはXRP Ledgerの[base58][]フォーマットで記述されている必要があります。サーバは、1つ以上のアカウントに影響するすべてのトランザクションについて通知を送信します。 | -| `accounts_proposed` | 配列 | _（省略可）_ `accounts`と同様ですが、まだファイナライズされていないトランザクションを含みます。 | -| `books` | 配列 | _（省略可）_ 以下に説明するとおり、更新の監視のために[オーダーブック](http://www.investopedia.com/terms/o/order-book.asp)を定義するオブジェクトの配列。 | -| `url` | 文字列 | （Websocketでは省略可、それ以外では必須）サーバが各イベントのJSON-RPCコールバックを送信するURL。*管理者専用。* | -| `url_username` | 文字列 | _（省略可）_ コールバックURLで基本認証を行うためのユーザ名。 | -| `url_password` | 文字列 | _（省略可）_ コールバックURLで基本認証を行うためのパスワード。 | +| `Field` | 型 | 説明 | +| :------------------ | :----- | ---- | +| `streams` | 配列 | _（省略可）_ 以下に説明する、サブスクライブする汎用ストリームの文字列名の配列。 | +| `accounts` | 配列 | _（省略可）_ 検証済みトランザクションを監視するアカウントの一意のアドレスを持つ配列。これらのアドレスはXRP Ledgerの[base58][]フォーマットで記述されている必要があります。サーバは、1つ以上のアカウントに影響するすべてのトランザクションについて通知を送信します。 | +| `accounts_proposed` | 配列 | _（省略可）_ `accounts`と同様ですが、まだファイナライズされていないトランザクションを含みます。 | +| `books` | 配列 | _（省略可）_ 以下に説明するとおり、更新の監視のために[オーダーブック](http://www.investopedia.com/terms/o/order-book.asp)を定義するオブジェクトの配列。 | +| `url` | 文字列 | （Websocketでは省略可、それ以外では必須）サーバが各イベントのJSON-RPCコールバックを送信するURL。*管理者専用。* | +| `url_username` | 文字列 | _（省略可）_ コールバックURLで基本認証を行うためのユーザ名。 | +| `url_password` | 文字列 | _（省略可）_ コールバックURLで基本認証を行うためのパスワード。 | 以下のパラメーターは廃止予定で、今後予告なしに削除される可能性があります。`user`、`password`、`rt_accounts`。 `streams`パラメーターは、以下のデフォルトの情報ストリームへのアクセスを可能にします。 -* `server` - `rippled`サーバのステータス（ネットワーク接続など）が変更されるたびにメッセージを送信します。 -* `ledger` - コンセンサスプロセスで新しい検証済みレジャーが宣言されるたびにメッセージを送信します。 -* `transactions` - 決済済みレジャーにトランザクションが追加されるたびにメッセージを送信します。 -* `transactions_proposed` - 決済済みレジャーにトランザクションが追加される場合や、検証済みレジャーにまだ追加されておらず、今後も追加される見込みのない一部のトランザクションが決済済みレジャーに追加される場合に、メッセージを送信します。提案されたすべてのトランザクションが検証前に表示されるわけではありません。**注記:** 検証済みレジャーには[失敗したトランザクションも記録されます](../../../protocol/transactions/transaction-results/index.md)。これは、このようなトランザクションにはスパム対策のトランザクション手数料が課されるためです。 -* `validations` - サーバがバリデータを信頼しているか否かにかかわらず、サーバが検証メッセージを受信するたびに、メッセージを送信します。（個々の`rippled`は、サーバが少なくとも定数の信頼できるバリデータから検証メッセージを受信した時点で、レジャーが検証済みであると宣言します。） -* `consensus` - サーバがコンセンサスサイクルのフェーズ（open、establish、acceptedなど）を変更するたびにメッセージを送信します。 -* `peer_status` - **（管理者専用）** 接続しているピア`rippled`サーバに関する情報（特にコンセンサスプロセスに関する情報）。 +- `book_changes` - コンセンサスプロセスが新しい有効なレジャーを作成するたびに、オーダーブックの変更をメッセージで送信します。 +- `consensus` - サーバがコンセンサスサイクルのフェーズを変更するたびにメッセージを送信します。 +- `ledger` - コンセンサスプロセスで新しい検証済みレジャーが宣言されるたびにメッセージを送信します。 +- `manifests` - バリデータのephemeral署名鍵の更新を受け取るたびにメッセージを送信します。 +- `peer_status` - **（管理者専用）** 接続している`rippled`のピアサーバに関する情報（特にコンセンサスプロセスに関する情報）。 +- `transactions` - 閉鎖済みレジャーにトランザクションが追加されるたびにメッセージを送信します。 +- `transactions_proposed` - 閉鎖済みレジャーにトランザクションが追加される場合や、検証済みレジャーにまだ追加されておらず、今後も追加される見込みのない一部のトランザクションが検証済みレジャーに追加される場合に、メッセージを送信します。提案されたすべてのトランザクションが検証前に表示されるわけではありません。 + {% admonition type="info" name="注記" %}[成功しなかったトランザクション](../../../protocol/transactions/transaction-results/index.md) 成功しなかったトランザクションも、スパム対策取引手数料を取るため、検証済みレジャーに含まれます。{% /admonition %} +- `server` - `rippled`サーバのステータス（ネットワーク接続など）が変更されるたびにメッセージを送信します。 +- `validations` - サーバがバリデータを信頼しているか否かにかかわらず、サーバが検証メッセージを受信するたびに、メッセージを送信します。（個々の`rippled`は、サーバが少なくとも定数の信頼できるバリデータから検証メッセージを受信した時点で、レジャーが検証済みであると宣言します。） + +{% admonition type="info" name="注記" %}以下のストリームは Clioおよび[レポートモード][]の`rippled`サーバからは利用できません: `server`、`peer_status`、`consensus`。これらのストリームを要求すると、どちらも`reportingUnsupported`エラーを返します。 {% badge href="https://github.com/XRPLF/rippled/releases/tag/1.8.1" %}更新: rippled 1.8.1{% /badge %} {% badge href="https://github.com/XRPLF/clio/releases/tag/2.0.0" %}新規: Clio v2.0{% /badge %}{% /admonition %} `books`配列が指定されている場合、この配列の各要素は、以下のフィールドを持つオブジェクトです。 -| `Field` | 型 | 説明 | -|:-------------|:--------|:----------------------------------------------------| +| `Field` | 型 | 説明 | +| :----------- | :----------- | ---- | | `taker_gets` | オブジェクト | オファーを受諾するアカウントが受け取る通貨を[金額なしの通貨オブジェクト](../../../protocol/data-types/currency-formats.md#金額なしでの通貨の指定)として指定します。 | | `taker_pays` | オブジェクト | オファーを受諾するアカウントが支払う通貨を[金額なしの通貨オブジェクト](../../../protocol/data-types/currency-formats.md#金額なしでの通貨の指定)として指定します。 | -| `taker` | 文字列 | オファーを表示するパースペクティブとして使用する一意のアカウントアドレス（XRP Ledgerの[base58][]フォーマット）。（これはオファーの資金提供ステータスと手数料に影響します。） | -| `snapshot` | ブール値 | （省略可、デフォルトではfalse）trueの場合は、更新の送信前にサブスクライブした時点でオーダーブックの現在の状態を一度返します。 | -| `both` | ブール値 | （省略可、デフォルトではfalse）trueの場合は、オーダーブックの両サイドを返します。 | +| `taker` | 文字列 | オファーを表示するパースペクティブとして使用する一意のアカウントアドレス（XRP Ledgerの[base58][]フォーマット）。（これはオファーの資金提供ステータスと手数料に影響します。） | +| `snapshot` | ブール値 | （省略可）`true`の場合は、更新の送信前にサブスクライブした時点でオーダーブックの現在の状態を一度返します。デフォルトは`false` | +| `both` | ブール値 | （省略可）`true`の場合は、オーダーブックの両サイドを返します。デフォルトは`false` | ## レスポンスのフォーマット @@ -120,9 +125,9 @@ labels: レスポンスは[標準フォーマット][]に従っています。レスポンスに含まれるフィールドは、リクエストに指定されたサブスクリプションに応じて異なります。 * `accounts`および`accounts_proposed` - フィールドが返されません。 -* *Stream: server* - `load_base`（サーバの現在の読み込みレベル）、`random`（ランダムに生成された値）などのサーバのステータスに関する情報。これらの情報は変更される可能性があります。 -* *Stream: transactions*、*Stream: transactions_proposed*、*Stream: validations*、および*Stream: consensus* - フィールドは返されません。 -* *Stream: ledger* - 手元にあるレジャーと現在の手数料体系に関する情報。`fee_base`（XRP単位のトランザクションの現行基本手数料）、`fee_ref`（手数料単位のトランザクションの現行基本手数料）、`ledger_hash`（最新の検証済みレジャーのハッシュ）、`reserve_base`（アカウントの最低必要準備金）などがあります。 +* *Stream: `server`* - `load_base`（サーバの現在の読み込みレベル）、`random`（ランダムに生成された値）などのサーバのステータスに関する情報。これらの情報は変更される可能性があります。 +* *Stream: `transactions`*、*Stream: `transactions_proposed`*、*Stream: `validations`*、および*Stream: `consensus`* - フィールドは返されません。 +* *Stream: `ledger`* - 手元にあるレジャーと現在の料金に関する情報。これは、[ledgerストリームメッセージ](#レジャーストリーム)と同じフィールドを含みますが、`type`と`txn_count`フィールドは省略されています。 * `books` - フィールドはデフォルトで返されません。リクエストが`"snapshot": true`に設定されている場合、`offers`（オーダーブックを定義するオファー定義オブジェクトの配列）を返します。 ## 考えられるエラー @@ -162,24 +167,22 @@ labels: レジャーストリームメッセージのフィールドは次のとおりです。 -| `Field` | 型 | 説明 | -|:--------------------|:--------------------------|:---------------------------| -| `type` | 文字列 | `ledgerClosed`は、このメッセージがレジャーストリームからのものであることを示します。 | -| `fee_base` | 数値 | このレジャーバージョン時点の[Referenceトランザクションコスト](../../../../concepts/transactions/transaction-cost.md#referenceトランザクションコスト)（[XRPのdrop数][]）。このレジャーバージョンに[SetFee疑似トランザクション](../../../protocol/transactions/pseudo-transaction-types/setfee.md)が含まれている場合は、次のレジャーバージョンから新しいトランザクションコストが適用されます。 | -| `fee_ref` | 数値 | 「手数料単位」の[Referenceトランザクションコスト](../../../../concepts/transactions/transaction-cost.md#referenceトランザクションコスト)。 | -| `ledger_hash` | 文字列 - [ハッシュ][] | 決済されたレジャーバージョンの識別用ハッシュ。 | -| `ledger_index` | 数値 - [レジャーインデックス][] | 決済されたレジャーのレジャーインデックス。 | -| `ledger_time` | 数値 | レジャーが閉鎖された時刻（[Rippleエポック以降の経過秒数][]） | -| `reserve_base` | 数値 | アカウントの最低必要[準備金](../../../../concepts/accounts/reserves.md)（[XRPのdrop数][]）。このレジャーバージョンに[SetFee疑似トランザクション](../../../protocol/transactions/pseudo-transaction-types/setfee.md)が含まれる場合は、次のレジャーバージョンから新しい基本準備金が適用されます。 | -| `reserve_inc` | 数値 | アカウントがレジャーに所有しているオブジェクトごとの[所有者準備金](../../../../concepts/accounts/reserves.md#所有者準備金)（[XRPのdrop数][]）。レジャーに[SetFee疑似トランザクション](../../../protocol/transactions/pseudo-transaction-types/setfee.md)が記録されている場合、このレジャー以降は新しい所有者準備金が適用されます。 | -| `txn_count` | 数値 | このレジャーバージョンに含まれる新規トランザクションの数。 | -| `validated_ledgers` | 文字列 | _（省略される場合があります）_ サーバで使用可能なレジャーの範囲。これは連続的ではない可能性があります。サーバがネットワークに接続されていない場合や、サーバが接続されていてもネットワークからレジャーをまだ取得していない場合は、このフィールドは返されません。 | +| `Field` | 型 | 説明 | +| :------------------ | :------------------------------ | ---- | +| `type` | 文字列 | `ledgerClosed`は、このメッセージがレジャーストリームからのものであることを示します。 | +| `fee_base` | 数値 | このレジャーバージョン時点の[Referenceトランザクションコスト](../../../../concepts/transactions/transaction-cost.md#referenceトランザクションコスト)（[XRPのdrop数][]）。このレジャーバージョンに[SetFee疑似トランザクション](../../../protocol/transactions/pseudo-transaction-types/setfee.md)が含まれている場合は、次のレジャーバージョンから新しいトランザクションコストが適用されます。 | +| `fee_ref` | 数値 | (省略される場合があります)「手数料単位」の[Referenceトランザクションコスト](../../../../concepts/transactions/transaction-cost.md#referenceトランザクションコスト)。 _[XRPFees amendment][]_ が有効である場合, このフィールドは永久に省略されます。 | +| `ledger_hash` | 文字列 - [ハッシュ][] | 閉鎖されたレジャーバージョンの識別用ハッシュ。 | +| `ledger_index` | 数値 - [レジャーインデックス][] | 閉鎖されたレジャーのレジャーインデックス。 | +| `ledger_time` | 数値 | レジャーが閉鎖された時刻（[Rippleエポック以降の経過秒数][]） | +| `reserve_base` | 数値 | アカウントの最低必要[準備金](../../../../concepts/accounts/reserves.md)（[XRPのdrop数][]）。このレジャーバージョンに[SetFee疑似トランザクション](../../../protocol/transactions/pseudo-transaction-types/setfee.md)が含まれる場合は、次のレジャーバージョンから新しい基本準備金が適用されます。 | +| `reserve_inc` | 数値 | アカウントがレジャーに所有しているオブジェクトごとの[所有者準備金](../../../../concepts/accounts/reserves.md#所有者準備金)（[XRPのdrop数][]）。レジャーに[SetFee疑似トランザクション](../../../protocol/transactions/pseudo-transaction-types/setfee.md)が記録されている場合、このレジャー以降は新しい所有者準備金が適用されます。 | +| `txn_count` | 数値 | このレジャーバージョンに含まれる新規トランザクションの数。 | +| `validated_ledgers` | 文字列 | _（省略される場合があります）_ サーバが利用可能なレジャーの範囲。これは、`24900901-24900984,24901116-24901158`のような不連続なシーケンスである可能性があります。サーバがネットワークに接続されていない場合、または接続されているがまだネットワークからレジャーを取得していない場合は、このフィールドは返されません。 | ## 検証ストリーム -{% badge href="https://github.com/XRPLF/rippled/releases/tag/0.29.0" %}新規: rippled 0.29.0{% /badge %} - 検証ストリームは、検証メッセージ（検証投票とも呼ばれる）を受信するたびにメッセージを送信します。検証メッセージが信頼できるバリデータからのものであるかどうかは関係ありません。次のようなメッセージを送信します。 ```json @@ -209,22 +212,25 @@ labels: 検証ストリームメッセージのフィールドは次のとおりです。 -| `Field`　　　　　　　　　| 型　　　　　　　　| 説明　　　　 | -|:------------------------|:-----------------|:--------------------------------| -| `type` | 文字列 | 値`validationReceived`は、このメッセージが検証ストリームからであることを示します。 | -| `amendments` | 文字列の配列 | （省略される場合があります）このサーバがプロトコルへの追加を求める[Amendment](../../../../concepts/networks-and-servers/amendments.md)。{% badge href="https://github.com/XRPLF/rippled/releases/tag/0.32.0" %}新規: rippled 0.32.0{% /badge %} | -| `base_fee` | 整数 | （省略される場合があります）サーバが[手数料投票](../../../../concepts/consensus-protocol/fee-voting.md)による設定を希望するスケーリングされていないトランザクションコスト（`reference_fee`値）。{% badge href="https://github.com/XRPLF/rippled/releases/tag/0.32.0" %}新規: rippled 0.32.0{% /badge %} | -| `flags` | 数値 | この検証メッセージに追加されるフラグのビットマスク。フラグ0x80000000は、検証の署名が完全に正規であることを示します。フラグ0x00000001は、完全な検証であることを示します。それ以外の場合は部分検証です。部分検証とは、特定のレジャーに対する投票ではありません。部分検証は、バリデータがオンラインであるがコンセンサスにまだ同意していないことを示します。{% badge href="https://github.com/XRPLF/rippled/releases/tag/0.32.0" %}新規: rippled 0.32.0{% /badge %} | -| `full` | ブール値 | `true`の場合は、完全な検証です。それ以外の場合は部分検証です。部分検証とは、特定のレジャーに対する投票ではありません。部分検証は、バリデータがオンラインであるがコンセンサスにまだ同意していないことを示します。{% badge href="https://github.com/XRPLF/rippled/releases/tag/0.32.0" %}新規: rippled 0.32.0{% /badge %} | -| `ledger_hash` | 文字列 | 提案されたレジャーの識別ハッシュを検証中です。 | -| `ledger_index` | 文字列 - 整数 | 提案されたレジャーの[レジャーインデックス][]。{% badge href="https://github.com/XRPLF/rippled/releases/tag/0.31.0" %}新規: rippled 0.31.0{% /badge %} | -| `load_fee` | 整数 | （省略される場合があります）このバリデータにより現在施行されているローカルの負荷スケーリングされたトランザクションコスト（手数料単位）。{% badge href="https://github.com/XRPLF/rippled/releases/tag/0.32.0" %}新規: rippled 0.32.0{% /badge %} | -| `master_key` | 文字列 | _（省略される場合があります）_ バリデータのマスター公開鍵（バリデータがXRP Ledgerの[base58][]フォーマットのバリデータトークンを使用している場合）。（関連項目: [`rippled`サーバで検証を有効化](../../../../infrastructure/configuration/server-modes/run-rippled-as-a-validator.md#3-rippledサーバで検証を有効化)。）{% badge href="https://github.com/XRPLF/rippled/releases/tag/1.4.0" %}新規: rippled 1.4.0{% /badge %} | -| `reserve_base` | 整数 | （省略される場合があります）このバリデータが[手数料投票](../../../../concepts/consensus-protocol/fee-voting.md)による設定を希望する最低必要準備金（`account_reserve`値）。{% badge href="https://github.com/XRPLF/rippled/releases/tag/0.32.0" %}新規: rippled 0.32.0{% /badge %} | -| `reserve_inc` | 整数 | （省略される場合があります）このバリデータが[手数料投票](../../../../concepts/consensus-protocol/fee-voting.md)による設定を希望する必要準備金（`owner_reserve`値）の増分。{% badge href="https://github.com/XRPLF/rippled/releases/tag/0.32.0" %}新規: rippled 0.32.0{% /badge %} | -| `signature` | 文字列 | バリデータがこのレジャーへの投票に署名するときに使用する署名。 | -| `signing_time` | 数値 | この検証投票が署名された時刻（[Rippleエポック以降の経過秒数][]）。{% badge href="https://github.com/XRPLF/rippled/releases/tag/0.32.0" %}新規: rippled 0.32.0{% /badge %} | -| `validation_public_key` | 文字列 | バリデータがメッセージの署名に使用したキーペアの公開鍵（XRP Ledgerの[base58][]形式）。このフィールドは、メッセージを送信するバリデータを特定します。また`signature`の検証にも使用できます。バリデータがトークンを使用している場合は一時的な公開鍵です。 | +| `Field` | 型 | 説明 | +| :---------------------- | :------------ | ---- | +| `type` | 文字列 | 値`validationReceived`は、このメッセージが検証ストリームからであることを示します。 | +| `amendments` | 文字列の配列 | （省略される場合があります）このサーバがプロトコルへの追加を求める[Amendment](../../../../concepts/networks-and-servers/amendments.md)。 | +| `base_fee` | 整数 | （省略される場合があります）サーバが[手数料投票](../../../../concepts/consensus-protocol/fee-voting.md)による設定を希望するスケーリングされていないトランザクションコスト（`reference_fee`値）。 | +| `cookie` | 文字列 - 数値 | _（省略される場合があります）_ サーバが起動時に選択した任意の値。同じ検証キーペアで異なるクッキーを使用して同時に有効な検証を送信する場合、通常は複数のサーバが同じ検証キーペアを使用していることを示します。 {% badge href="https://github.com/XRPLF/rippled/releases/tag/1.8.1" %}新規: rippled 1.8.1{% /badge %} | +| `flags` | 数値 | この検証メッセージに追加されるフラグのビットマスク。フラグ`0x80000000`は、検証の署名が完全に正規であることを示します。フラグ`0x00000001`は、完全な検証であることを示します。それ以外の場合は部分検証です。部分検証とは、特定のレジャーに対する投票ではありません。部分検証は、バリデータがオンラインであるがコンセンサスにまだ同意していないことを示します。 | +| `full` | ブール値 | `true`の場合は、完全な検証です。それ以外の場合は部分検証です。部分検証とは、特定のレジャーに対する投票ではありません。部分検証は、バリデータがオンラインであるがコンセンサスにまだ同意していないことを示します。 | +| `ledger_hash` | 文字列 | 提案されたレジャーの識別ハッシュを検証中です。 | +| `ledger_index` | 文字列 - 整数 | 提案されたレジャーの[レジャーインデックス][]。 | +| `load_fee` | 整数 | （省略される場合があります）このバリデータにより現在施行されているローカルの負荷スケーリングされたトランザクションコスト（手数料単位）。 | +| `master_key` | 文字列 | _（省略される場合があります）_ バリデータのマスター公開鍵（バリデータがXRP Ledgerの[base58][]フォーマットのバリデータトークンを使用している場合）。（関連項目: [`rippled`サーバで検証を有効化](../../../../infrastructure/configuration/server-modes/run-rippled-as-a-validator.md#3-rippledサーバで検証を有効化)。） | +| `reserve_base` | 整数 | （省略される場合があります）このバリデータが[手数料投票](../../../../concepts/consensus-protocol/fee-voting.md)による設定を希望する最低必要準備金（`account_reserve`値）。 | +| `reserve_inc` | 整数 | （省略される場合があります）このバリデータが[手数料投票](../../../../concepts/consensus-protocol/fee-voting.md)による設定を希望する必要準備金（`owner_reserve`値）の増分。 | +| `server_version` | 文字列 - 数値 | _(省略される場合があります)_ バリデータサーバのバージョン番号を表す 64 ビットの整数。例えば`「1745990410175512576」`。256レジャーに一度だけ提供されます。 {% badge href="https://github.com/XRPLF/rippled/releases/tag/1.8.1" %}新規: rippled 1.8.1{% /badge %} | +| `signature` | 文字列 | バリデータがこのレジャーへの投票に署名するときに使用する署名。 | +| `signing_time` | 数値 | この検証投票が署名された時刻（[Rippleエポック以降の経過秒数][]）。 | +| `validated_hash` | 文字列 | この検証が適用される提案レジャーの一意のハッシュ。 {% badge href="https://github.com/XRPLF/rippled/releases/tag/1.8.1" %}新規: rippled 1.8.1{% /badge %} | +| `validation_public_key` | 文字列 | バリデータがメッセージの署名に使用したキーペアの公開鍵（XRP Ledgerの[base58][]形式）。このフィールドは、メッセージを送信するバリデータを特定します。また`signature`の検証にも使用できます。バリデータがトークンを使用している場合は一時的な公開鍵です。 | ## トランザクションストリーム @@ -251,119 +257,117 @@ labels: ```json { - "status": "closed", - "type": "transaction", + "close_time_iso": "2024-11-01T23:59:01Z", "engine_result": "tesSUCCESS", "engine_result_code": 0, - "engine_result_message": "The transaction was applied.", - "ledger_hash": "989AFBFD65D820C6BD85301B740F5D592F060668A90EEF5EC1815EBA27D58FE8", - "ledger_index": 7125442, + "engine_result_message": "The transaction was applied. Only final in a validated ledger.", + "hash": "6489E52A909208E371ACE82E19CAE59896C7F8BA40E7C36C5B8AA3C451914BED", + "ledger_hash": "0B6F44849E6D702D0CFB447FDBD7B603C269E9EEECE9176882EF376E0C9DFF6A", + "ledger_index": 1969852, "meta": { "AffectedNodes": [ { "ModifiedNode": { "FinalFields": { + "Account": "rH3PxjJPrrkvsATddBXkayjAyWR8xigaE8", + "Balance": "39999964", "Flags": 0, - "IndexPrevious": "0000000000000000", - "Owner": "rRh634Y6QtoqkwTTrGzX66UYoCAvgE6jL", - "RootIndex": "ABD8CE2D1205D0C062876E9E1F3CBDC902ED8EF4E8D3D071B962C7ED0E113E68" + "OwnerCount": 0, + "Sequence": 1969812 }, - "LedgerEntryType": "DirectoryNode", - "LedgerIndex": "0BBDEE7D0BE120F7BF27640B5245EBFE0C5FD5281988BA823C44477A70262A4D" - } - }, - { - "DeletedNode": { - "FinalFields": { - "Account": "rRh634Y6QtoqkwTTrGzX66UYoCAvgE6jL", - "BookDirectory": "892E892DC63D8F70DCF5C9ECF29394FF7DD3DC6F47DB8EB34A03920BFC5E99BE", - "BookNode": "0000000000000000", - "Flags": 0, - "OwnerNode": "000000000000006E", - "PreviousTxnID": "58A17D95770F8D07E08B81A85896F4032A328B6C2BDCDEC0A00F3EF3914DCF0A", - "PreviousTxnLgrSeq": 7125330, - "Sequence": 540691, - "TakerGets": "4401967683", - "TakerPays": { - "currency": "BTC", - "issuer": "rNPRNzBB92BVpAhhZr4iXDTveCgV5Pofm9", - "value": "0.04424" - } + "LedgerEntryType": "AccountRoot", + "LedgerIndex": "EDE60B24659BCC06CCE1EA2804A4A202F1C88155CEAED9C140833C0C39100617", + "PreviousFields": { + "Balance": "59999976", + "Sequence": 1969811 }, - "LedgerEntryType": "Offer", - "LedgerIndex": "386B7803A9210747941B0D079BB408F31ACB1CB98832184D0287A1CBF4FE6D00" - } - }, - { - "DeletedNode": { - "FinalFields": { - "ExchangeRate": "4A03920BFC5E99BE", - "Flags": 0, - "RootIndex": "892E892DC63D8F70DCF5C9ECF29394FF7DD3DC6F47DB8EB34A03920BFC5E99BE", - "TakerGetsCurrency": "0000000000000000000000000000000000000000", - "TakerGetsIssuer": "0000000000000000000000000000000000000000", - "TakerPaysCurrency": "0000000000000000000000004254430000000000", - "TakerPaysIssuer": "92D705968936C419CE614BF264B5EEB1CEA47FF4" - }, - "LedgerEntryType": "DirectoryNode", - "LedgerIndex": "892E892DC63D8F70DCF5C9ECF29394FF7DD3DC6F47DB8EB34A03920BFC5E99BE" + "PreviousTxnID": "1DBC93373D47794A684A5013178D0EBE10E6641D7C262BF20151B0E19156FF79", + "PreviousTxnLgrSeq": 1969843 } }, { "ModifiedNode": { "FinalFields": { - "Account": "rRh634Y6QtoqkwTTrGzX66UYoCAvgE6jL", - "Balance": "11133297300", + "Account": "rfdGuuVnq9juqWDV4W3LoLiNcW8g2hAXhN", + "Balance": "160000000", "Flags": 0, - "OwnerCount": 9, - "Sequence": 540706 + "OwnerCount": 0, + "Sequence": 1969810 }, "LedgerEntryType": "AccountRoot", - "LedgerIndex": "A6C2532E1008A513B3F822A92B8E5214BD0D413DC20AD3631C1A39AD6B36CD07", + "LedgerIndex": "F7D350FB54C5BBA734AE574EE6BF7A9294E11F9B75413972F98846AFC587C62C", "PreviousFields": { - "Balance": "11133297310", - "OwnerCount": 10, - "Sequence": 540705 + "Balance": "140000000" }, - "PreviousTxnID": "484D57DFC4E446DA83B4540305F0CE836D4E007361542EC12CC0FFB5F0A1BE3A", - "PreviousTxnLgrSeq": 7125358 + "PreviousTxnID": "1DBC93373D47794A684A5013178D0EBE10E6641D7C262BF20151B0E19156FF79", + "PreviousTxnLgrSeq": 1969843 } } ], - "TransactionIndex": 1, - "TransactionResult": "tesSUCCESS" + "TransactionIndex": 4, + "TransactionResult": "tesSUCCESS", + "delivered_amount": "20000000" }, - "transaction": { - "Account": "rRh634Y6QtoqkwTTrGzX66UYoCAvgE6jL", - "Fee": "10", - "Flags": 2147483648, - "OfferSequence": 540691, - "Sequence": 540705, - "SigningPubKey": "030BB49C591C9CD65C945D4B78332F27633D7771E6CF4D4B942D26BA40748BB8B4", - "TransactionType": "OfferCancel", - "TxnSignature": "30450221008223604A383F3AED25D53CE7C874700619893A6EEE4336508312217850A9722302205E0614366E174F2DFF78B879F310DB0B3F6DA1967E52A32F65E25DCEC622CD68", - "date": 455751680, - "hash": "94CF924C774DFDBE474A2A7E40AEA70E7E15D130C8CBEF8AF1D2BE97A8269F14" + "status": "closed", + "tx_json": { + "Account": "rH3PxjJPrrkvsATddBXkayjAyWR8xigaE8", + "DeliverMax": "20000000", + "Destination": "rfdGuuVnq9juqWDV4W3LoLiNcW8g2hAXhN", + "Fee": "12", + "Flags": 0, + "LastLedgerSequence": 1969870, + "Sequence": 1969811, + "SigningPubKey": "ED0761CDA5507784F6CEB445DE2343F861DD5EC7A869F75B08C7E8F29A947AD9FC", + "TransactionType": "Payment", + "TxnSignature": "20D5447ED7095BCCC3D42EA1955600D97D791811072E93D2A358AD9FB258C3A7F004974039D25708F5AE598C78F85B688DD586158F7E9C13AE0F30CC18E3390D", + "date": 783820741 }, + "type": "transaction", "validated": true } ``` トランザクションストリームメッセージには次のフィールドがあります。 -| `Field`　　　　　　　　　| 型　　　　　　　　　　　　　| 説明 　　　　　 | -|:------------------------|:--------------------------|:-----------------------| -| `type` | 文字列 | `transaction`は、トランザクションの通知であることを示します。この通知はさまざまなストリームから送信される可能性があります。 | -| `engine_result` | 文字列 | 文字列の[トランザクション結果コード](../../../protocol/transactions/transaction-results/index.md) | -| `engine_result_code` | 数値 | 数値の[トランザクションレスポンスコード](../../../protocol/transactions/transaction-results/index.md)（該当する場合） | -| `engine_result_message` | 文字列 | 人間が読み取れる形式のトランザクションレスポンスの説明 | -| `ledger_current_index` | 数値 - [レジャーインデックス][] | _（未検証のトランザクションのみ）_ このトランザクションが現在提案されている現在進行中の[レジャーバージョン](../../../../concepts/ledgers/index.md)のレジャーインデックス。 | -| `ledger_hash` | 文字列 - [ハッシュ][] | _（検証済みのトランザクションのみ）_ このトランザクションを含む レジャーバージョンの識別用ハッシュ。 | -| `ledger_index` | 数値 - [レジャーインデックス][] | _（検証済みのトランザクションのみ）_ このトランザクションを含むレジャーバージョンのレジャーインデックス。 | -| `meta` | オブジェクト | _（検証済みのトランザクションのみ）_ [トランザクションのメタデータ](../../../protocol/transactions/metadata.md)。トランザクションの正確な結果を詳細に表示します。 | -| `transaction` | オブジェクト | JSONフォーマットの[トランザクションの定義](../../../protocol/transactions/index.md)。 | -| `validated` | ブール値 | `true`の場合、このトランザクションは検証済みのレジャーに含まれており、最終的な結果であることを意味します。`transaction`ストリームからのレスポンスは常に検証される必要があります。 | +{% tabs %} +{% tab label="API v2" %} + +| `Field` | 型 | 説明 | +|:------------------------|:--------------------------|:-----| +| `close_time_iso` | 文字列 | レジャーの終了時刻をISO 8601の時刻形式で表します。 | +| `type` | 文字列 | `transaction`は、複数の可能なストリームからのトランザクションの通知であることを示します。 | +| `engine_result` | 文字列 | 文字列での[取引結果コード](../../../protocol/transactions/transaction-results/index.md) | +| `engine_result_code` | 数値 | 数値での[取引結果コード](../../../protocol/transactions/transaction-results/index.md) (該当する場合) | +| `engine_result_message` | 文字列 | 人間が読み取れる形式のトランザクションレスポンスの説明 | +| `hash` | 文字列 | トランザクションの一意のハッシュ識別子。 | +| `ledger_current_index` | 数値 - [レジャーインデックス][] | _(未検証のトランザクションのみ)_ このトランザクションが現在提案されている現在進行中の[レジャーバージョン](../../../../concepts/ledgers/index.md)のレジャーインデックス。 | +| `ledger_hash` | 文字列 - [ハッシュ][] | _(検証済みのトランザクションのみ)_ このトランザクションを含むレジャーバージョンの識別用ハッシュ。 | +| `ledger_index` | 数値 - [レジャーインデックス][] | _(検証済みのトランザクションのみ)_ このトランザクションを含むレジャーバージョンのレジャーインデックス。 | +| `meta` | オブジェクト | _(検証済みのトランザクションのみ)_ [トランザクションメタデータ](../../../protocol/transactions/metadata.md)。トランザクションの正確な結果を詳細に表示します。 | +| `tx_json` | オブジェクト | JSONフォーマットの[トランザクションの定義](../../../protocol/transactions/index.md)。 | +| `validated` | ブール値 | `true`の場合、このトランザクションは検証済みのレジャーに含まれており、その結果は最終的であることを意味します。`transaction`ストリームからのレスポンスは常に検証される必要があります。 | + +{% /tab %} + +{% tab label="API v1" %} + +| `Field` | 型 | 説明 | +| :---------------------- | :------------------------------ | ---- | +| `type` | 文字列 | `transaction`は、トランザクションの通知であることを示します。この通知はさまざまなストリームから送信される可能性があります。 | +| `engine_result` | 文字列 | 文字列の[トランザクション結果コード](../../../protocol/transactions/transaction-results/index.md) | +| `engine_result_code` | 数値 | 数値の[トランザクションレスポンスコード](../../../protocol/transactions/transaction-results/index.md)（該当する場合） | +| `engine_result_message` | 文字列 | 人間が読み取れる形式のトランザクションレスポンスの説明 | +| `ledger_current_index` | 数値 - [レジャーインデックス][] | _（未検証のトランザクションのみ）_ このトランザクションが現在提案されている現在進行中の[レジャーバージョン](../../../../concepts/ledgers/index.md)のレジャーインデックス。 | +| `ledger_hash` | 文字列 - [ハッシュ][] | _（検証済みのトランザクションのみ）_ このトランザクションを含む レジャーバージョンの識別用ハッシュ。 | +| `ledger_index` | 数値 - [レジャーインデックス][] | _（検証済みのトランザクションのみ）_ このトランザクションを含むレジャーバージョンのレジャーインデックス。 | +| `meta` | オブジェクト | _（検証済みのトランザクションのみ）_ [トランザクションのメタデータ](../../../protocol/transactions/metadata.md)。トランザクションの正確な結果を詳細に表示します。 | +| `transaction` | オブジェクト | JSONフォーマットの[トランザクションの定義](../../../protocol/transactions/index.md)。 | +| `validated` | ブール値 | `true`の場合、このトランザクションは検証済みのレジャーに含まれており、最終的な結果であることを意味します。`transaction`ストリームからのレスポンスは常に検証される必要があります。 | + +{% /tab %} + +{% /tabs %} ## ピアステータスストリーム @@ -383,28 +387,28 @@ labels: } ``` -ピアステータスストリームメッセージは、ピア`rippled`サーバのステータスが変化したイベントを表します。これらのメッセージは、次のフィールドを持つJSONオブジェクトです。 +ピアステータスストリームメッセージは、`rippled`ピアサーバのステータスが変化したイベントを表します。これらのメッセージは、次のフィールドを持つJSONオブジェクトです。 -| `Field`　　　　　　| 値　　　| 説明 　　　　 | -|:-------------------|:-------|:-----------------------------------------------| -| `type` | 文字列 | `peerStatusChange`は、ピアステータスストリームからのメッセージであることを示します。 | -| `action` | 文字列 | このメッセージが送信される原因となったイベントのタイプ。有効な値については、[ピアステータスイベント](#ピアステータスイベント)をご覧ください。 | -| `date` | 数値 | このイベントが発生した時刻（[Rippleエポック以降の経過秒数][]） | -| `ledger_hash` | 文字列 | （省略される場合があります）このメッセージに関連するレジャーバージョンの識別用[ハッシュ][]。 | -| `ledger_index` | 数値 | （省略される場合があります）このメッセージに関連するレジャーバージョンの[レジャーインデックス][]。 | -| `ledger_index_max` | 数値 | （省略される場合があります）ピアで現在使用可能な最大[レジャーインデックス][]。 | -| `ledger_index_min` | 数値 | （省略される場合があります）ピアで現在使用可能な最小[レジャーインデックス][]。 | +| `Field` | 値 | 説明 | +| :----------------- | :----- | ---- | +| `type` | 文字列 | `peerStatusChange`は、ピアステータスストリームからのメッセージであることを示します。 | +| `action` | 文字列 | このメッセージが送信される原因となったイベントのタイプ。有効な値については、[ピアステータスイベント](#ピアステータスイベント)をご覧ください。 | +| `date` | 数値 | このイベントが発生した時刻（[Rippleエポック以降の経過秒数][]） | +| `ledger_hash` | 文字列 | （省略される場合があります）このメッセージに関連するレジャーバージョンの識別用[ハッシュ][]。 | +| `ledger_index` | 数値 | （省略される場合があります）このメッセージに関連するレジャーバージョンの[レジャーインデックス][]。 | +| `ledger_index_max` | 数値 | （省略される場合があります）ピアで現在使用可能な最大[レジャーインデックス][]。 | +| `ledger_index_min` | 数値 | （省略される場合があります）ピアで現在使用可能な最小[レジャーインデックス][]。 | ### ピアステータスイベント ピアステータスストリームメッセージの`action`フィールドには次のいずれかの値が含まれます。 -| `Value`　　　　　　| 意味 　　　　 | -|:------------------|:---------------------------------------------------------| -| `CLOSING_LEDGER` | ピアがこの[レジャーインデックス][]のレジャーバージョンを閉鎖しました。 | +| `Value` | 意味 | +| :---------------- | ---- | +| `CLOSING_LEDGER` | ピアがこの[レジャーインデックス][]のレジャーバージョンを閉鎖しました。 | | `ACCEPTED_LEDGER` | ピアがコンセンサスラウンドの結果としてこのレジャーバージョンを作成しました。**注記:** このレジャーが不変的に検証済みになるかどうかはまだ確実ではありません。 | | `SWITCHED_LEDGER` | ピアは、ネットワークの他の部分に従っていないと結論付け、異なるレジャーバージョンに切り替えました。 | -| `LOST_SYNC` | ピアは検証済みのレジャーバージョンとコンセンサス処理中のレジャーバージョンの追跡でネットワークの他の部分に遅れをとりました。 | +| `LOST_SYNC` | ピアは検証済みのレジャーバージョンとコンセンサス処理中のレジャーバージョンの追跡でネットワークの他の部分に遅れをとりました。 | ## オーダーブックストリーム @@ -415,140 +419,293 @@ labels: ```json { - "engine_result": "tesSUCCESS", - "engine_result_code": 0, - "engine_result_message": "The transaction was applied. Only final in a validated ledger.", - "ledger_hash": "08547DD866F099CCB3666F113116B7AA2DF520FA2E3011DD1FF9C9C04A6C7C3E", - "ledger_index": 18852105, - "meta": { - "AffectedNodes": [{ - "ModifiedNode": { - "FinalFields": { - "Account": "rfCFLzNJYvvnoGHWQYACmJpTgkLUaugLEw", - "AccountTxnID": "D295E2BE50E3B78AED24790D7B9096996DAF43F095BF17DB83EEACC283D14050", - "Balance": "3070332374272", - "Flags": 0, - "OwnerCount": 23, - "RegularKey": "r9S56zu6QeJD5d8A7QMfLAeYavgB9dhaX4", - "Sequence": 12142921 - }, - "LedgerEntryType": "AccountRoot", - "LedgerIndex": "2880A9B4FB90A306B576C2D532BFE390AB3904642647DCF739492AA244EF46D1", - "PreviousFields": { - "AccountTxnID": "3CA3422B0E42D76A7A677B0BA0BE72DFCD93676E0C80F8D2EB27C04BD8457A0F", - "Balance": "3070332385272", - "Sequence": 12142920 - }, - "PreviousTxnID": "3CA3422B0E42D76A7A677B0BA0BE72DFCD93676E0C80F8D2EB27C04BD8457A0F", - "PreviousTxnLgrSeq": 18852102 - } - }, { - "ModifiedNode": { - "FinalFields": { - "Flags": 0, - "IndexPrevious": "00000000000022D2", - "Owner": "rfCFLzNJYvvnoGHWQYACmJpTgkLUaugLEw", - "RootIndex": "F435FBBEC9654204D7151A01E686BAA8CB325A472D7B61C7916EA58B59355767" - }, - "LedgerEntryType": "DirectoryNode", - "LedgerIndex": "29A543B6681AD7FC8AFBD1386DAE7385F02F9B8C4756A467DF6834AB54BBC9DB" - } - }, { - "ModifiedNode": { - "FinalFields": { - "ExchangeRate": "4C1BA999A513EF78", - "Flags": 0, - "RootIndex": "79C54A4EBD69AB2EADCE313042F36092BE432423CC6A4F784C1BA999A513EF78", - "TakerGetsCurrency": "0000000000000000000000000000000000000000", - "TakerGetsIssuer": "0000000000000000000000000000000000000000", - "TakerPaysCurrency": "0000000000000000000000005553440000000000", - "TakerPaysIssuer": "2ADB0B3959D60A6E6991F729E1918B7163925230" - }, - "LedgerEntryType": "DirectoryNode", - "LedgerIndex": "79C54A4EBD69AB2EADCE313042F36092BE432423CC6A4F784C1BA999A513EF78" - } - }, { - "CreatedNode": { - "LedgerEntryType": "Offer", - "LedgerIndex": "92E235EE80D2B28A89BEE2C905D4545C2A004FD5D4097679C8A3FB25507FD9EB", - "NewFields": { - "Account": "rfCFLzNJYvvnoGHWQYACmJpTgkLUaugLEw", - "BookDirectory": "79C54A4EBD69AB2EADCE313042F36092BE432423CC6A4F784C1BA999A513EF78", - "Expiration": 508543674, - "OwnerNode": "00000000000022F4", - "Sequence": 12142920, - "TakerGets": "6537121438", - "TakerPays": { - "currency": "USD", - "issuer": "rhub8VRN55s94qWKDv6jmDy1pUykJzF3wq", - "value": "50.9" - } - } - } - }, { - "DeletedNode": { - "FinalFields": { - "Account": "rfCFLzNJYvvnoGHWQYACmJpTgkLUaugLEw", - "BookDirectory": "79C54A4EBD69AB2EADCE313042F36092BE432423CC6A4F784C1BA999A513EF78", - "BookNode": "0000000000000000", - "Expiration": 508543133, - "Flags": 0, - "OwnerNode": "00000000000022F4", - "PreviousTxnID": "58B3279C2D56AAC3D9B06106E637C01E3D911E9D31E2FE4EA0D886AC9F4DEE1E", - "PreviousTxnLgrSeq": 18851945, - "Sequence": 12142889, - "TakerGets": "6537121438", - "TakerPays": { - "currency": "USD", - "issuer": "rhub8VRN55s94qWKDv6jmDy1pUykJzF3wq", - "value": "50.9" - } - }, - "LedgerEntryType": "Offer", - "LedgerIndex": "D3436CE21925E1CB12C5C444963B47D7EA0CD9A0E387926DC76B23FE5CD1C15F" - } - }], - "TransactionIndex": 26, - "TransactionResult": "tesSUCCESS" + "tx_json": { + "Account": "rBTwLga3i2gz3doX6Gva3MgEV8ZCD8jjah", + "Fee": "20", + "Flags": 0, + "LastLedgerSequence": 91826205, + "OfferSequence": 156917168, + "Sequence": 156917177, + "SigningPubKey": "0253C1DFDCF898FE85F16B71CCE80A5739F7223D54CC9EBA4749616593470298C5", + "TakerGets": "35992000000", + "TakerPays": { + "currency": "USD", + "issuer": "rhub8VRN55s94qWKDv6jmDy1pUykJzF3wq", + "value": "18570.025718376" }, - "status": "closed", - "transaction": { - "Account": "rfCFLzNJYvvnoGHWQYACmJpTgkLUaugLEw", - "Expiration": 508543674, - "Fee": "11000", - "Flags": 2147483648, - "LastLedgerSequence": 18852106, - "OfferSequence": 12142889, - "Sequence": 12142920, - "SigningPubKey": "034841BF24BD72C7CC371EBD87CCBF258D8ADB05C18DE207130364A97D8A3EA524", - "TakerGets": "6537121438", - "TakerPays": { - "currency": "USD", - "issuer": "rhub8VRN55s94qWKDv6jmDy1pUykJzF3wq", - "value": "50.9" - }, - "TransactionType": "OfferCreate", - "TxnSignature": "3045022100B9AD678A773FB61F8F9B565713C80CBF187A2F9EB8E9CE0DAC7B839CA6F4B04C02200613D173A0636CD9BE13F2E3EBD13A16932B5B7D8A96BB5F6D561CA5CDBC4AD3", - "date": 508543090, - "hash": "D295E2BE50E3B78AED24790D7B9096996DAF43F095BF17DB83EEACC283D14050", - "owner_funds": "3070197374272" - }, - "type": "transaction", - "validated": true + "TransactionType": "OfferCreate", + "TxnSignature": "30440220520439D8DDB6B6D0E4EA1504873D780ADE524E3961E02A5DD84B8B4C456BA3240220533CF99250737C13FD376C18F6D64149332BA1FE6EA04895442247BD29952193", + "date": 783819060, + "owner_funds": "36054185999" + }, + "meta": { + "AffectedNodes": [ + { + "ModifiedNode": { + "FinalFields": { + "Flags": 0, + "IndexNext": "0", + "IndexPrevious": "0", + "Owner": "rBTwLga3i2gz3doX6Gva3MgEV8ZCD8jjah", + "RootIndex": "0A2600D85F8309FE7F75A490C19613F1CE0C37483B856DB69B8140154C2335F3" + }, + "LedgerEntryType": "DirectoryNode", + "LedgerIndex": "0A2600D85F8309FE7F75A490C19613F1CE0C37483B856DB69B8140154C2335F3", + "PreviousTxnID": "73BBE254DDC97EAD6ECB2D9F7A7EB13DBA1A5B816C2727548FCFBC41B40604EF", + "PreviousTxnLgrSeq": 91826203 + } + }, + { + "ModifiedNode": { + "FinalFields": { + "Account": "rBTwLga3i2gz3doX6Gva3MgEV8ZCD8jjah", + "Balance": "36092186059", + "Flags": 0, + "OwnerCount": 14, + "Sequence": 156917178 + }, + "LedgerEntryType": "AccountRoot", + "LedgerIndex": "1ED8DDFD80F275CB1CE7F18BB9D906655DE8029805D8B95FB9020B30425821EB", + "PreviousFields": { + "Balance": "36092186079", + "Sequence": 156917177 + }, + "PreviousTxnID": "73BBE254DDC97EAD6ECB2D9F7A7EB13DBA1A5B816C2727548FCFBC41B40604EF", + "PreviousTxnLgrSeq": 91826203 + } + }, + { + "CreatedNode": { + "LedgerEntryType": "Offer", + "LedgerIndex": "3B4D42B185D1FE4EBED70F7E35A8E8AEA39028FB6B16DCDFC175363EA38DED28", + "NewFields": { + "Account": "rBTwLga3i2gz3doX6Gva3MgEV8ZCD8jjah", + "BookDirectory": "79C54A4EBD69AB2EADCE313042F36092BE432423CC6A4F784E125486AFA57980", + "Sequence": 156917177, + "TakerGets": "35992000000", + "TakerPays": { + "currency": "USD", + "issuer": "rhub8VRN55s94qWKDv6jmDy1pUykJzF3wq", + "value": "18570.025718376" + } + } + } + }, + { + "DeletedNode": { + "FinalFields": { + "ExchangeRate": "4e12547b29376a80", + "Flags": 0, + "PreviousTxnID": "D4CB92E19CBADB14F82B0E0703B3F157338253EE1DD46DB91F6C98C93D01DA9C", + "PreviousTxnLgrSeq": 91826201, + "RootIndex": "79C54A4EBD69AB2EADCE313042F36092BE432423CC6A4F784E12547B29376A80", + "TakerGetsCurrency": "0000000000000000000000000000000000000000", + "TakerGetsIssuer": "0000000000000000000000000000000000000000", + "TakerPaysCurrency": "0000000000000000000000005553440000000000", + "TakerPaysIssuer": "2ADB0B3959D60A6E6991F729E1918B7163925230" + }, + "LedgerEntryType": "DirectoryNode", + "LedgerIndex": "79C54A4EBD69AB2EADCE313042F36092BE432423CC6A4F784E12547B29376A80" + } + }, + { + "CreatedNode": { + "LedgerEntryType": "DirectoryNode", + "LedgerIndex": "79C54A4EBD69AB2EADCE313042F36092BE432423CC6A4F784E125486AFA57980", + "NewFields": { + "ExchangeRate": "4e125486afa57980", + "RootIndex": "79C54A4EBD69AB2EADCE313042F36092BE432423CC6A4F784E125486AFA57980", + "TakerPaysCurrency": "0000000000000000000000005553440000000000", + "TakerPaysIssuer": "2ADB0B3959D60A6E6991F729E1918B7163925230" + } + } + }, + { + "DeletedNode": { + "FinalFields": { + "Account": "rBTwLga3i2gz3doX6Gva3MgEV8ZCD8jjah", + "BookDirectory": "79C54A4EBD69AB2EADCE313042F36092BE432423CC6A4F784E12547B29376A80", + "BookNode": "0", + "Flags": 0, + "OwnerNode": "0", + "PreviousTxnID": "D4CB92E19CBADB14F82B0E0703B3F157338253EE1DD46DB91F6C98C93D01DA9C", + "PreviousTxnLgrSeq": 91826201, + "Sequence": 156917168, + "TakerGets": "35992000000", + "TakerPays": { + "currency": "USD", + "issuer": "rhub8VRN55s94qWKDv6jmDy1pUykJzF3wq", + "value": "18569.847557976" + } + }, + "LedgerEntryType": "Offer", + "LedgerIndex": "F72F9E5C9C81C6D2403C062365B34AA371D5D0BB13E1787622E936D0B8B4A499" + } + } + ], + "TransactionIndex": 23, + "TransactionResult": "tesSUCCESS" + }, + "type": "transaction", + "validated": true, + "status": "closed", + "close_time_iso": "2024-11-01T23:31:00Z", + "ledger_index": 91826203, + "ledger_hash": "746D115326E08B884D7EA5F0E379272774F1B41443C000044D5DF97781E0601D", + "hash": "2250BB2914AC7BC143AD62E7DD36F23A22F2BC50495FC29B36C6B0CA570BB4FA", + "engine_result_code": 0, + "engine_result": "tesSUCCESS", + "engine_result_message": "The transaction was applied. Only final in a validated ledger." } ``` オーダーブックストリームメッセージの形式は、[トランザクションストリームメッセージ](#トランザクションストリーム)と同様ですが、`OfferCreate`トランザクションに以下のフィールドも含まれている点が異なります。 -| `Field`　　　　　　　　　　| 値　　　| 説明 　　　　　 | -|:--------------------------|:-------|:----------------------------------------| -| `transaction.owner_funds` | 文字列 | このOfferCreateトランザクションを送信する`Account`が、このトランザクション実行後に有する`TakerGets`通貨の金額。この通貨額が[凍結](../../../../concepts/tokens/fungible-tokens/freezes.md)されているかどうかはチェックされません。 | +| `Field` | 値 | 説明 | +| :------------------------ | :----- | ---- | +| `transaction.owner_funds` | 文字列 | このOfferCreateトランザクションを送信する`Account`が、このトランザクション実行後に有する`TakerGets`通貨の金額。この通貨額が[凍結](../../../../concepts/tokens/fungible-tokens/freezes.md)されているかどうかはチェックされません。
[API v2][]では`tx_json.owner_funds`に変更されました。 | + + +## Book Changesストリーム + +`book_changes`ストリームは、新しいレジャーが検証されると`bookChanges`メッセージを送信します。このメッセージには、そのレジャーで分散型取引所で発生したすべてのオーダーブックの変更の概要が含まれています。 + +例 `bookChanges`メッセージ: + +```json +{ + "type": "bookChanges", + "ledger_index": 88530525, + "ledger_hash": "E2F24290E1714C842D34A1057E6D6B7327C7DDD310263AFBC67CA8EFED7A331B", + "ledger_time": 771099232, + "changes": [ + { + "currency_a": "XRP_drops", + "currency_b": "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y/USD", + "volume_a": "23020993", + "volume_b": "11.51049687275246", + "high": "1999999.935232603", + "low": "1999999.935232603", + "open": "1999999.935232603", + "close": "1999999.935232603" + }, + { + "currency_a": "XRP_drops", + "currency_b": "rRbiKwcueo6MchUpMFDce9XpDwHhRLPFo/43525950544F0000000000000000000000000000", + "volume_a": "28062", + "volume_b": "0.000643919229004", + "high": "43580000.00000882", + "low": "43580000.00000882", + "open": "43580000.00000882", + "close": "43580000.00000882" + }, + { + "currency_a": "XRP_drops", + "currency_b": "rcEGREd8NmkKRE8GE424sksyt1tJVFZwu/5553444300000000000000000000000000000000", + "volume_a": "147797392", + "volume_b": "70.41143840513008", + "high": "2099053.724049922", + "low": "2099053.724049922", + "open": "2099053.724049922", + "close": "2099053.724049922" + }, + { + "currency_a": "XRP_drops", + "currency_b": "rcRzGWq6Ng3jeYhqnmM4zcWcUh69hrQ8V/LTC", + "volume_a": "350547165", + "volume_b": "2.165759976556748", + "high": "162573356.3100158", + "low": "160134763.7403094", + "open": "162573356.3100158", + "close": "160134763.7403094" + }, + { + "currency_a": "XRP_drops", + "currency_b": "rchGBxcD1A1C2tdxF6papQYZ8kjRKMYcL/BTC", + "volume_a": "352373535", + "volume_b": "0.00249291478138912", + "high": "1413500174054660e-4", + "low": "1413499999999996e-4", + "open": "1413500174054660e-4", + "close": "1413499999999996e-4" + }, + { + "currency_a": "XRP_drops", + "currency_b": "rcvxE9PS9YBwxtGg1qNeewV6ZB3wGubZq/5553445400000000000000000000000000000000", + "volume_a": "8768045", + "volume_b": "4.193604075536", + "high": "2090813.734932601", + "low": "2090813.734932601", + "open": "2090813.734932601", + "close": "2090813.734932601" + }, + { + "currency_a": "XRP_drops", + "currency_b": "rhub8VRN55s94qWKDv6jmDy1pUykJzF3wq/USD", + "volume_a": "28113", + "volume_b": "0.013405652999", + "high": "2097100.380123005", + "low": "2097100.380123005", + "open": "2097100.380123005", + "close": "2097100.380123005" + }, + { + "currency_a": "r3dVizzUAS3U29WKaaSALqkieytA2LCoRe/58434F5245000000000000000000000000000000", + "currency_b": "rcoreNywaoz2ZCQ8Lg2EbSLnGuRBmun6D/434F524500000000000000000000000000000000", + "volume_a": "75.626516003375", + "volume_b": "63.022096669479", + "high": "1.200000000000003", + "low": "1.200000000000003", + "open": "1.200000000000003", + "close": "1.200000000000003" + }, + { + "currency_a": "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y/CNY", + "currency_b": "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y/USD", + "volume_a": "83.9115222024", + "volume_b": "11.51049687275", + "high": "7.290000000004561", + "low": "7.290000000004561", + "open": "7.290000000004561", + "close": "7.290000000004561" + }, + { + "currency_a": "rcRzGWq6Ng3jeYhqnmM4zcWcUh69hrQ8V/LTC", + "currency_b": "rchGBxcD1A1C2tdxF6papQYZ8kjRKMYcL/BTC", + "volume_a": "0.64167647147626", + "volume_b": "0.00073047551165797", + "high": "878.4366638381051", + "low": "878.4366638381051", + "open": "878.4366638381051", + "close": "878.4366638381051" + }, + { + "currency_a": "rhub8VRN55s94qWKDv6jmDy1pUykJzF3wq/USD", + "currency_b": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B/USD", + "volume_a": "0.013432464305", + "volume_b": "0.013566788948", + "high": "0.9900990099046391", + "low": "0.9900990099046391", + "open": "0.9900990099046391", + "close": "0.9900990099046391" + } + ] +} +``` + +[Book Changes]ストリームメッセージのフィールドは以下のとおりです: + +| Field | 値 | 説明 | +|:---------------|:-------------------------|:-----| +| `type` | 文字列 | 値`bookChanges`は、これがBook Changesストリームからのものであることを示します。 | +| `ledger_index` | [レジャーインデックス][] | これらの変更を含むレジャーのレジャーインデックス。 | +| `ledger_hash` | [ハッシュ][] | これらの変更を含むレジャーの識別用ハッシュ。 | +| `ledger_time` | 数値 | これらの変更を含むレジャーの公式的な閉鎖時刻。[リップルエポック](../../../../concepts/ledgers/index.md#ripple-epoch)からの秒数。 | +| `changes` | 配列 | [Book Update Objects](../path-and-order-book-methods/book_changes.md#book-update-objects)のリスト。このレジャーバージョンで更新された各オーダーブックに対して1つのエントリが含まれます。オーダーブックが更新されなかった場合、配列は空です。 | ## コンセンサスストリーム -{% badge href="https://github.com/XRPLF/rippled/releases/tag/1.4.0" %}新規: rippled 1.4.0{% /badge %} - `consensus`ストリームは、[コンセンサスプロセス](../../../../concepts/consensus-protocol/index.md)でフェーズが変更されると、`consensusPhase`メッセージを送信します。このメッセージには、サーバで実行されているコンセンサスの新しいフェーズが含まれます。 ```json @@ -560,9 +717,9 @@ labels: コンセンサスストリームメッセージのフィールドは次のとおりです。 -| `Field`　　　　　　　| 型　　　　　　　　　　　　　| 説明 　　　　　　 | -|:--------------------|:--------------------------|:---------------------------| -| `type` | 文字列 | `consensusPhase`は、このメッセージがコンセンサスストリームからのものであることを示します。 | -| `consensus` | 文字列 | サーバで実行されている新しいコンセンサスフェーズ。値には、open、establish、acceptedなどがあります。 | +| `Field` | 型 | 説明 | +| :---------- | :----- | ---- | +| `type` | 文字列 | `consensusPhase`は、このメッセージがコンセンサスストリームからのものであることを示します。 | +| `consensus` | 文字列 | サーバで実行されている新しいコンセンサスフェーズ。値には、`open`、`establish`、`accepted`などがあります。 | {% raw-partial file="/docs/_snippets/common-links.md" /%} diff --git a/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/transaction-methods/submit.md b/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/transaction-methods/submit.md index 1b43ab5070..81d7339c86 100644 --- a/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/transaction-methods/submit.md +++ b/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/transaction-methods/submit.md @@ -105,12 +105,13 @@ submit 1200002280000000240000000361D4838D7EA4C6800000000000000000000000000055534 ```json { "id": 2, + "api_version": 2, "command": "submit", "tx_json" : { "TransactionType" : "Payment", "Account" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", "Destination" : "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX", - "Amount" : { + "DeliverMax" : { "currency" : "USD", "value" : "1", "issuer" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn" @@ -130,10 +131,11 @@ submit 1200002280000000240000000361D4838D7EA4C6800000000000000000000000000055534 "params": [ { "offline": false, + "api_version": 2, "secret": "s████████████████████████████", "tx_json": { "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", - "Amount": { + "DeliverMax": { "currency": "USD", "issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", "value": "1" @@ -151,7 +153,7 @@ submit 1200002280000000240000000361D4838D7EA4C6800000000000000000000000000055534 {% tab label="コマンドライン" %} ```sh #Syntax: submit secret json [offline] -rippled submit s████████████████████████████ '{"Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", "Amount": { "currency": "USD", "issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", "value": "1" }, "Destination": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX", "TransactionType": "Payment", "Fee": "10000"}' +rippled submit s████████████████████████████ '{"Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", "DeliverMax": { "currency": "USD", "issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", "value": "1" }, "Destination": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX", "TransactionType": "Payment", "Fee": "10000"}' ``` {% /tab %} @@ -169,16 +171,25 @@ rippled submit s█████████████████████ ```json { "id": 1, + "api_version": 2, "status": "success", "type": "response", "result": { + "accepted" : true, + "account_sequence_available" : 362, + "account_sequence_next" : 362, + "applied" : true, + "broadcast" : true, "engine_result": "tesSUCCESS", "engine_result_code": 0, - "engine_result_message": "The transaction was applied.Only final in a validated ledger.", + "engine_result_message": "The transaction was applied. Only final in a validated ledger.", + "kept" : true, + "open_ledger_cost": "10", + "queued" : false, "tx_blob": "1200002280000000240000016861D4838D7EA4C6800000000000000000000000000055534400000000004B4E9C06F24296074F7BC48F92A97916C6DC5EA9684000000000002710732103AB40A0490F9B7ED8DF29D246BF2D6269820A0EE7742ACDD457BEA7C7D0931EDB7446304402200E5C2DD81FDF0BE9AB2A8D797885ED49E804DBF28E806604D878756410CA98B102203349581946B0DDA06B36B35DBC20EDA27552C1F167BCF5C6ECFF49C6A46F858081144B4E9C06F24296074F7BC48F92A97916C6DC5EA983143E9D4A2B8AA0780F682D136F7A56D6724EF53754", "tx_json": { "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", - "Amount": { + "DeliverMax": { "currency": "USD", "issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", "value": "1" @@ -191,7 +202,8 @@ rippled submit s█████████████████████ "TransactionType": "Payment", "TxnSignature": "304402200E5C2DD81FDF0BE9AB2A8D797885ED49E804DBF28E806604D878756410CA98B102203349581946B0DDA06B36B35DBC20EDA27552C1F167BCF5C6ECFF49C6A46F8580", "hash": "4D5D90890F8D49519E4151938601EF3D0B30B16CD6A519D9C99102C9FA77F7E0" - } + }, + "validated_ledger_index" : 21184416 } } ``` @@ -201,14 +213,22 @@ rippled submit s█████████████████████ ```json { "result": { + "accepted" : true, + "account_sequence_available" : 362, + "account_sequence_next" : 362, + "applied" : true, + "broadcast" : true, "engine_result": "tesSUCCESS", "engine_result_code": 0, - "engine_result_message": "The transaction was applied.Only final in a validated ledger.", + "engine_result_message": "The transaction was applied. Only final in a validated ledger.", "status": "success", + "kept" : true, + "open_ledger_cost": "10", + "queued" : false, "tx_blob": "1200002280000000240000016961D4838D7EA4C6800000000000000000000000000055534400000000004B4E9C06F24296074F7BC48F92A97916C6DC5EA9684000000000002710732103AB40A0490F9B7ED8DF29D246BF2D6269820A0EE7742ACDD457BEA7C7D0931EDB74473045022100A7CCD11455E47547FF617D5BFC15D120D9053DFD0536B044F10CA3631CD609E502203B61DEE4AC027C5743A1B56AF568D1E2B8E79BB9E9E14744AC87F38375C3C2F181144B4E9C06F24296074F7BC48F92A97916C6DC5EA983143E9D4A2B8AA0780F682D136F7A56D6724EF53754", "tx_json": { "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", - "Amount": { + "DeliverMax": { "currency": "USD", "issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", "value": "1" @@ -222,7 +242,8 @@ rippled submit s█████████████████████ "TxnSignature": "3045022100A7CCD11455E47547FF617D5BFC15D120D9053DFD0536B044F10CA3631CD609E502203B61DEE4AC027C5743A1B56AF568D1E2B8E79BB9E9E14744AC87F38375C3C2F1", "hash": "5B31A7518DC304D5327B4887CD1F7DC2C38D5F684170097020C7C9758B973847" } - } + }, + "validated_ledger_index" : 21184416 } ``` {% /tab %} @@ -233,29 +254,38 @@ Loading: "/etc/rippled.cfg" Connecting to 127.0.0.1:5005 { - "result" : { - "engine_result" : "tesSUCCESS", - "engine_result_code" : 0, - "engine_result_message" : "The transaction was applied.Only final in a validated ledger.", - "status" : "success", - "tx_blob" : "1200002280000000240000016A61D4838D7EA4C6800000000000000000000000000055534400000000004B4E9C06F24296074F7BC48F92A97916C6DC5EA9684000000000002710732103AB40A0490F9B7ED8DF29D246BF2D6269820A0EE7742ACDD457BEA7C7D0931EDB74473045022100FBBF74057359EC31C3647AD3B33D8954730E9879C35034374858A76B7CFA643102200EAA08C61071396E9CF0987FBEA16CF113CBD8068AA221214D165F151285EECD81144B4E9C06F24296074F7BC48F92A97916C6DC5EA983143E9D4A2B8AA0780F682D136F7A56D6724EF53754", - "tx_json" : { - "Account" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", - "Amount" : { - "currency" : "USD", - "issuer" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", - "value" : "1" - }, - "Destination" : "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX", - "Fee" : "10000", - "Flags" : 2147483648, - "Sequence" : 362, - "SigningPubKey" : "03AB40A0490F9B7ED8DF29D246BF2D6269820A0EE7742ACDD457BEA7C7D0931EDB", - "TransactionType" : "Payment", - "TxnSignature" : "3045022100FBBF74057359EC31C3647AD3B33D8954730E9879C35034374858A76B7CFA643102200EAA08C61071396E9CF0987FBEA16CF113CBD8068AA221214D165F151285EECD", - "hash" : "CB98A6FA1FAC47F9FCC6A233EB46F8F9AF59CC69BD69AE6D06F298F6FF52162A" - } - } + "result": { + "accepted" : true, + "account_sequence_available" : 362, + "account_sequence_next" : 362, + "applied" : true, + "broadcast" : true, + "engine_result": "tesSUCCESS", + "engine_result_code": 0, + "engine_result_message": "The transaction was applied. Only final in a validated ledger.", + "status": "success", + "kept" : true, + "open_ledger_cost": "10", + "queued" : false, + "tx_blob": "1200002280000000240000016961D4838D7EA4C6800000000000000000000000000055534400000000004B4E9C06F24296074F7BC48F92A97916C6DC5EA9684000000000002710732103AB40A0490F9B7ED8DF29D246BF2D6269820A0EE7742ACDD457BEA7C7D0931EDB74473045022100A7CCD11455E47547FF617D5BFC15D120D9053DFD0536B044F10CA3631CD609E502203B61DEE4AC027C5743A1B56AF568D1E2B8E79BB9E9E14744AC87F38375C3C2F181144B4E9C06F24296074F7BC48F92A97916C6DC5EA983143E9D4A2B8AA0780F682D136F7A56D6724EF53754", + "tx_json": { + "Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", + "DeliverMax": { + "currency": "USD", + "issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", + "value": "1" + }, + "Destination": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX", + "Fee": "10000", + "Flags": 2147483648, + "Sequence": 361, + "SigningPubKey": "03AB40A0490F9B7ED8DF29D246BF2D6269820A0EE7742ACDD457BEA7C7D0931EDB", + "TransactionType": "Payment", + "TxnSignature": "3045022100A7CCD11455E47547FF617D5BFC15D120D9053DFD0536B044F10CA3631CD609E502203B61DEE4AC027C5743A1B56AF568D1E2B8E79BB9E9E14744AC87F38375C3C2F1", + "hash": "5B31A7518DC304D5327B4887CD1F7DC2C38D5F684170097020C7C9758B973847" + } + }, + "validated_ledger_index" : 21184416 } ``` {% /tab %} diff --git a/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/transaction-methods/transaction_entry.md b/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/transaction-methods/transaction_entry.md index 7e6808fe0c..a426e1ad19 100644 --- a/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/transaction-methods/transaction_entry.md +++ b/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/transaction-methods/transaction_entry.md @@ -55,11 +55,11 @@ rippled transaction_entry E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDA リクエストには以下のパラメーターが含まれます。 -| `Field` | 型 | 説明 | -|:---------------|:---------------------------|:-------------------------------| -| `ledger_hash` | 文字列 | _（省略可）_ 使用するレジャーバージョンの20バイトの16進文字列。（[レジャーの指定][]をご覧ください） | +| `Field` | 型 | 説明 | +| :------------- | :----------------------- | ---- | +| `ledger_hash` | 文字列 | _（省略可）_ 使用するレジャーバージョンの20バイトの16進文字列。（[レジャーの指定][]をご覧ください） | | `ledger_index` | 文字列または符号なし整数 | _（省略可）_ 使用するレジャーの[レジャーインデックス][]、またはレジャーを自動的に選択するためのショートカット文字列。（[レジャーの指定][]をご覧ください） | -| `tx_hash` | 文字列 | 検索するトランザクションの一意のハッシュ | +| `tx_hash` | 文字列 | 検索するトランザクションの一意のハッシュ | {% admonition type="info" name="注記" %}このメソッドでは、現在進行中のレジャーから情報を取得する操作はサポートされていません。`ledger_index`または`ledger_hash`でレジャーバージョンを指定する必要があります。{% /admonition %} @@ -72,129 +72,371 @@ rippled transaction_entry E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDA {% tab label="WebSocket" %} ```json { - "id": 4, + "id": 4, + "result": { + "ledger_hash": "793E56131D8D4ABFB27FA383BFC44F2978B046E023FF46C588D7E0C874C2472A", + "ledger_index": 56865245, + "meta": { + "AffectedNodes": [ + { + "ModifiedNode": { + "FinalFields": { + "ExchangeRate": "4F04C66806CF7400", + "Flags": 0, + "RootIndex": "02BAAC1E67C1CE0E96F0FA2E8061020536CEDD043FEB0FF54F04C66806CF7400", + "TakerGetsCurrency": "0000000000000000000000000000000000000000", + "TakerGetsIssuer": "0000000000000000000000000000000000000000", + "TakerPaysCurrency": "000000000000000000000000434E590000000000", + "TakerPaysIssuer": "CED6E99370D5C00EF4EBF72567DA99F5661BFB3A" + }, + "LedgerEntryType": "DirectoryNode", + "LedgerIndex": "02BAAC1E67C1CE0E96F0FA2E8061020536CEDD043FEB0FF54F04C66806CF7400" + } + }, + { + "ModifiedNode": { + "FinalFields": { + "Account": "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", + "Balance": "10404767991", + "Flags": 0, + "OwnerCount": 3, + "Sequence": 5037711 + }, + "LedgerEntryType": "AccountRoot", + "LedgerIndex": "1DECD9844E95FFBA273F1B94BA0BF2564DDF69F2804497A6D7837B52050174A2", + "PreviousFields": { + "Balance": "10404768003", + "Sequence": 5037710 + }, + "PreviousTxnID": "4DC47B246B5EB9CCE92ABA8C482479E3BF1F946CABBEF74CA4DE36521D5F9008", + "PreviousTxnLgrSeq": 56865244 + } + }, + { + "DeletedNode": { + "FinalFields": { + "Account": "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", + "BookDirectory": "02BAAC1E67C1CE0E96F0FA2E8061020536CEDD043FEB0FF54F04C66806CF7400", + "BookNode": "0000000000000000", + "Flags": 0, + "OwnerNode": "0000000000000000", + "PreviousTxnID": "8F5FF57B404827F12BDA7561876A13C3E3B3095CBF75334DBFB5F227391A660C", + "PreviousTxnLgrSeq": 56865244, + "Sequence": 5037708, + "TakerGets": "15000000000", + "TakerPays": { + "currency": "CNY", + "issuer": "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y", + "value": "20160.75" + } + }, + "LedgerEntryType": "Offer", + "LedgerIndex": "26AAE6CA8D29E28A47C92ADF22D5D96A0216F0551E16936856DDC8CB1AAEE93B" + } + }, + { + "ModifiedNode": { + "FinalFields": { + "Flags": 0, + "IndexNext": "0000000000000000", + "IndexPrevious": "0000000000000000", + "Owner": "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", + "RootIndex": "47FAF5D102D8CE655574F440CDB97AC67C5A11068BB3759E87C2B9745EE94548" + }, + "LedgerEntryType": "DirectoryNode", + "LedgerIndex": "47FAF5D102D8CE655574F440CDB97AC67C5A11068BB3759E87C2B9745EE94548" + } + }, + { + "CreatedNode": { + "LedgerEntryType": "Offer", + "LedgerIndex": "8BAEE3C7DE04A568E96007420FA11ABD0BC9AE44D35932BB5640E9C3FB46BC9B", + "NewFields": { + "Account": "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", + "BookDirectory": "02BAAC1E67C1CE0E96F0FA2E8061020536CEDD043FEB0FF54F04C66806CF7400", + "Sequence": 5037710, + "TakerGets": "15000000000", + "TakerPays": { + "currency": "CNY", + "issuer": "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y", + "value": "20160.75" + } + } + } + } + ], + "TransactionIndex": 0, + "TransactionResult": "tesSUCCESS" + }, + "tx_json": { + "Account": "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", + "Fee": "12", + "Flags": 0, + "LastLedgerSequence": 56865248, + "OfferSequence": 5037708, + "Sequence": 5037710, + "SigningPubKey": "03B51A3EDF70E4098DA7FB053A01C5A6A0A163A30ED1445F14F87C7C3295FCB3BE", + "TakerGets": "15000000000", + "TakerPays": { + "currency": "CNY", + "issuer": "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y", + "value": "20160.75" + }, + "TransactionType": "OfferCreate", + "TxnSignature": "3045022100A5023A0E64923616FCDB6D664F569644C7C9D1895772F986CD6B981B515B02A00220530C973E9A8395BC6FE2484948D2751F6B030FC7FB8575D1BFB406368AD554D9", + "hash": "C53ECF838647FA5A4C780377025FEC7999AB4182590510CA461444B207AB74A9" + }, + "validated": true + }, + "status": "success", + "type": "response" +} +``` +{% /tab %} + + +{% tab label="JSON-RPC" %} +```json +{ "result": { - "ledger_index": 348734, - "metadata": { + "ledger_hash": "793E56131D8D4ABFB27FA383BFC44F2978B046E023FF46C588D7E0C874C2472A", + "ledger_index": 56865245, + "meta": { "AffectedNodes": [ { "ModifiedNode": { "FinalFields": { - "Account": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH", - "Balance": "59328999119", + "ExchangeRate": "4F04C66806CF7400", "Flags": 0, - "OwnerCount": 11, - "Sequence": 89 + "RootIndex": "02BAAC1E67C1CE0E96F0FA2E8061020536CEDD043FEB0FF54F04C66806CF7400", + "TakerGetsCurrency": "0000000000000000000000000000000000000000", + "TakerGetsIssuer": "0000000000000000000000000000000000000000", + "TakerPaysCurrency": "000000000000000000000000434E590000000000", + "TakerPaysIssuer": "CED6E99370D5C00EF4EBF72567DA99F5661BFB3A" }, - "LedgerEntryType": "AccountRoot", - "LedgerIndex": "E0D7BDE68B468FF0B8D948FD865576517DA987569833A05374ADB9A72E870A06", - "PreviousFields": { - "Balance": "59328999129", - "Sequence": 88 - }, - "PreviousTxnID": "C26AA6B4F7C3B9F55E17CD0D11F12032A1C7AD2757229FFD277C9447A8815E6E", - "PreviousTxnLgrSeq": 348700 + "LedgerEntryType": "DirectoryNode", + "LedgerIndex": "02BAAC1E67C1CE0E96F0FA2E8061020536CEDD043FEB0FF54F04C66806CF7400" } }, { "ModifiedNode": { "FinalFields": { - "Balance": { - "currency": "USD", - "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji", - "value": "-1" - }, - "Flags": 131072, - "HighLimit": { - "currency": "USD", - "issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", - "value": "100" - }, - "HighNode": "0000000000000000", - "LowLimit": { - "currency": "USD", - "issuer": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH", - "value": "0" - }, - "LowNode": "0000000000000000" + "Account": "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", + "Balance": "10404767991", + "Flags": 0, + "OwnerCount": 3, + "Sequence": 5037711 }, - "LedgerEntryType": "RippleState", - "LedgerIndex": "EA4BF03B4700123CDFFB6EB09DC1D6E28D5CEB7F680FB00FC24BC1C3BB2DB959", + "LedgerEntryType": "AccountRoot", + "LedgerIndex": "1DECD9844E95FFBA273F1B94BA0BF2564DDF69F2804497A6D7837B52050174A2", "PreviousFields": { - "Balance": { - "currency": "USD", - "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji", - "value": "0" + "Balance": "10404768003", + "Sequence": 5037710 + }, + "PreviousTxnID": "4DC47B246B5EB9CCE92ABA8C482479E3BF1F946CABBEF74CA4DE36521D5F9008", + "PreviousTxnLgrSeq": 56865244 + } + }, + { + "DeletedNode": { + "FinalFields": { + "Account": "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", + "BookDirectory": "02BAAC1E67C1CE0E96F0FA2E8061020536CEDD043FEB0FF54F04C66806CF7400", + "BookNode": "0000000000000000", + "Flags": 0, + "OwnerNode": "0000000000000000", + "PreviousTxnID": "8F5FF57B404827F12BDA7561876A13C3E3B3095CBF75334DBFB5F227391A660C", + "PreviousTxnLgrSeq": 56865244, + "Sequence": 5037708, + "TakerGets": "15000000000", + "TakerPays": { + "currency": "CNY", + "issuer": "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y", + "value": "20160.75" } }, - "PreviousTxnID": "53354D84BAE8FDFC3F4DA879D984D24B929E7FEB9100D2AD9EFCD2E126BCCDC8", - "PreviousTxnLgrSeq": 343570 + "LedgerEntryType": "Offer", + "LedgerIndex": "26AAE6CA8D29E28A47C92ADF22D5D96A0216F0551E16936856DDC8CB1AAEE93B" + } + }, + { + "ModifiedNode": { + "FinalFields": { + "Flags": 0, + "IndexNext": "0000000000000000", + "IndexPrevious": "0000000000000000", + "Owner": "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", + "RootIndex": "47FAF5D102D8CE655574F440CDB97AC67C5A11068BB3759E87C2B9745EE94548" + }, + "LedgerEntryType": "DirectoryNode", + "LedgerIndex": "47FAF5D102D8CE655574F440CDB97AC67C5A11068BB3759E87C2B9745EE94548" + } + }, + { + "CreatedNode": { + "LedgerEntryType": "Offer", + "LedgerIndex": "8BAEE3C7DE04A568E96007420FA11ABD0BC9AE44D35932BB5640E9C3FB46BC9B", + "NewFields": { + "Account": "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", + "BookDirectory": "02BAAC1E67C1CE0E96F0FA2E8061020536CEDD043FEB0FF54F04C66806CF7400", + "Sequence": 5037710, + "TakerGets": "15000000000", + "TakerPays": { + "currency": "CNY", + "issuer": "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y", + "value": "20160.75" + } + } } } ], "TransactionIndex": 0, "TransactionResult": "tesSUCCESS" }, + "status": "success", "tx_json": { - "Account": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH", - "Amount": { - "currency": "USD", - "issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", - "value": "1" - }, - "Destination": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", - "Fee": "10", + "Account": "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", + "Fee": "12", "Flags": 0, - "Paths": [ - [ - { - "account": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV", - "currency": "USD", - "issuer": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV", - "type": 49, - "type_hex": "0000000000000031" - } - ], - [ - { - "account": "rD1jovjQeEpvaDwn9wKaYokkXXrqo4D23x", - "currency": "USD", - "issuer": "rD1jovjQeEpvaDwn9wKaYokkXXrqo4D23x", - "type": 49, - "type_hex": "0000000000000031" - }, - { - "account": "rB5TihdPbKgMrkFqrqUC3yLdE8hhv4BdeY", - "currency": "USD", - "issuer": "rB5TihdPbKgMrkFqrqUC3yLdE8hhv4BdeY", - "type": 49, - "type_hex": "0000000000000031" - }, - { - "account": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV", - "currency": "USD", - "issuer": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV", - "type": 49, - "type_hex": "0000000000000031" - } - ] - ], - "SendMax": { - "currency": "USD", - "issuer": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH", - "value": "1.01" + "LastLedgerSequence": 56865248, + "OfferSequence": 5037708, + "Sequence": 5037710, + "SigningPubKey": "03B51A3EDF70E4098DA7FB053A01C5A6A0A163A30ED1445F14F87C7C3295FCB3BE", + "TakerGets": "15000000000", + "TakerPays": { + "currency": "CNY", + "issuer": "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y", + "value": "20160.75" }, - "Sequence": 88, - "SigningPubKey": "02EAE5DAB54DD8E1C49641D848D5B97D1B29149106174322EDF98A1B2CCE5D7F8E", - "TransactionType": "Payment", - "TxnSignature": "30440220791B6A3E036ECEFFE99E8D4957564E8C84D1548C8C3E80A87ED1AA646ECCFB16022037C5CAC97E34E3021EBB426479F2ACF3ACA75DB91DCC48D1BCFB4CF547CFEAA0", - "hash": "E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7", - "inLedger": 348734, - "ledger_index": 348734 - } - }, - "status": "success", - "type": "response" + "TransactionType": "OfferCreate", + "TxnSignature": "3045022100A5023A0E64923616FCDB6D664F569644C7C9D1895772F986CD6B981B515B02A00220530C973E9A8395BC6FE2484948D2751F6B030FC7FB8575D1BFB406368AD554D9", + "hash": "C53ECF838647FA5A4C780377025FEC7999AB4182590510CA461444B207AB74A9" + }, + "validated": true + } +} +``` +{% /tab %} + +{% tab label="Commandline" %} +```json +{ + "result" : { + "ledger_hash" : "793E56131D8D4ABFB27FA383BFC44F2978B046E023FF46C588D7E0C874C2472A", + "ledger_index" : 56865245, + "meta" : { + "AffectedNodes" : [ + { + "ModifiedNode" : { + "FinalFields" : { + "ExchangeRate" : "4F04C66806CF7400", + "Flags" : 0, + "RootIndex" : "02BAAC1E67C1CE0E96F0FA2E8061020536CEDD043FEB0FF54F04C66806CF7400", + "TakerGetsCurrency" : "0000000000000000000000000000000000000000", + "TakerGetsIssuer" : "0000000000000000000000000000000000000000", + "TakerPaysCurrency" : "000000000000000000000000434E590000000000", + "TakerPaysIssuer" : "CED6E99370D5C00EF4EBF72567DA99F5661BFB3A" + }, + "LedgerEntryType" : "DirectoryNode", + "LedgerIndex" : "02BAAC1E67C1CE0E96F0FA2E8061020536CEDD043FEB0FF54F04C66806CF7400" + } + }, + { + "ModifiedNode" : { + "FinalFields" : { + "Account" : "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", + "Balance" : "10404767991", + "Flags" : 0, + "OwnerCount" : 3, + "Sequence" : 5037711 + }, + "LedgerEntryType" : "AccountRoot", + "LedgerIndex" : "1DECD9844E95FFBA273F1B94BA0BF2564DDF69F2804497A6D7837B52050174A2", + "PreviousFields" : { + "Balance" : "10404768003", + "Sequence" : 5037710 + }, + "PreviousTxnID" : "4DC47B246B5EB9CCE92ABA8C482479E3BF1F946CABBEF74CA4DE36521D5F9008", + "PreviousTxnLgrSeq" : 56865244 + } + }, + { + "DeletedNode" : { + "FinalFields" : { + "Account" : "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", + "BookDirectory" : "02BAAC1E67C1CE0E96F0FA2E8061020536CEDD043FEB0FF54F04C66806CF7400", + "BookNode" : "0000000000000000", + "Flags" : 0, + "OwnerNode" : "0000000000000000", + "PreviousTxnID" : "8F5FF57B404827F12BDA7561876A13C3E3B3095CBF75334DBFB5F227391A660C", + "PreviousTxnLgrSeq" : 56865244, + "Sequence" : 5037708, + "TakerGets" : "15000000000", + "TakerPays" : { + "currency" : "CNY", + "issuer" : "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y", + "value" : "20160.75" + } + }, + "LedgerEntryType" : "Offer", + "LedgerIndex" : "26AAE6CA8D29E28A47C92ADF22D5D96A0216F0551E16936856DDC8CB1AAEE93B" + } + }, + { + "ModifiedNode" : { + "FinalFields" : { + "Flags" : 0, + "IndexNext" : "0000000000000000", + "IndexPrevious" : "0000000000000000", + "Owner" : "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", + "RootIndex" : "47FAF5D102D8CE655574F440CDB97AC67C5A11068BB3759E87C2B9745EE94548" + }, + "LedgerEntryType" : "DirectoryNode", + "LedgerIndex" : "47FAF5D102D8CE655574F440CDB97AC67C5A11068BB3759E87C2B9745EE94548" + } + }, + { + "CreatedNode" : { + "LedgerEntryType" : "Offer", + "LedgerIndex" : "8BAEE3C7DE04A568E96007420FA11ABD0BC9AE44D35932BB5640E9C3FB46BC9B", + "NewFields" : { + "Account" : "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", + "BookDirectory" : "02BAAC1E67C1CE0E96F0FA2E8061020536CEDD043FEB0FF54F04C66806CF7400", + "Sequence" : 5037710, + "TakerGets" : "15000000000", + "TakerPays" : { + "currency" : "CNY", + "issuer" : "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y", + "value" : "20160.75" + } + } + } + } + ], + "TransactionIndex" : 0, + "TransactionResult" : "tesSUCCESS" + }, + "status" : "success", + "tx_json" : { + "Account" : "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", + "Fee" : "12", + "Flags" : 0, + "LastLedgerSequence" : 56865248, + "OfferSequence" : 5037708, + "Sequence" : 5037710, + "SigningPubKey" : "03B51A3EDF70E4098DA7FB053A01C5A6A0A163A30ED1445F14F87C7C3295FCB3BE", + "TakerGets" : "15000000000", + "TakerPays" : { + "currency" : "CNY", + "issuer" : "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y", + "value" : "20160.75" + }, + "TransactionType" : "OfferCreate", + "TxnSignature" : "3045022100A5023A0E64923616FCDB6D664F569644C7C9D1895772F986CD6B981B515B02A00220530C973E9A8395BC6FE2484948D2751F6B030FC7FB8575D1BFB406368AD554D9", + "hash" : "C53ECF838647FA5A4C780377025FEC7999AB4182590510CA461444B207AB74A9" + }, + "validated" : true + } } ``` {% /tab %} @@ -203,12 +445,33 @@ rippled transaction_entry E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDA このレスポンスは[標準フォーマット][]に従っており、正常に完了した場合は結果に次のフィールドが含まれます。 -| `Field` | 型 | 説明 | -|:---------------|:--------------------------|:--------------------------------| +{% tabs %} + +{% tab label="API v2" %} + +| `Field` | 型 | 説明 | +|:-----------------|:--------------------------------|:-----| +| `close_time_iso` | 文字列 | レジャーの閉鎖時刻をISO 8601の時刻形式で表します。 | +| `hash` | 文字列 | トランザクションの一意なハッシュ識別子。 | +| `ledger_index` | 数値 - [レジャーインデックス][] | トランザクションが存在するレジャーバージョンのレジャーインデックス。 | +| `ledger_hash` | 文字列 - [ハッシュ][] | _(省略される場合があります)_ トランザクションが存在するレジャーバージョンの識別用ハッシュ。 | +| `meta` | オブジェクト | [トランザクションのメタデータ](../../../protocol/transactions/metadata.md)。トランザクションの正確な結果を詳細に表示します。 | +| `tx_json` | オブジェクト | [Transactionオブジェクト](../../../protocol/transactions/index.md)のJSON表現。 | + +{% /tab %} + +{% tab label="API v1" %} + +| `Field` | 型 | 説明 | +| :------------- | :------------------------------ | ---- | | `ledger_index` | 数値 - [レジャーインデックス][] | トランザクションが検出されたレジャーバージョンのレジャーインデックス。これはリクエストのレジャーインデックスと同じです。 | -| `ledger_hash` | 文字列 - [ハッシュ][] | _（省略される場合があります）_ トランザクションが検出されたレジャーバージョンの識別用ハッシュ。これはリクエストのハッシュと同じです。 | -| `metadata` | オブジェクト | [トランザクションのメタデータ](../../../protocol/transactions/metadata.md)。トランザクションの正確な結果を詳細に表示します。 | -| `tx_json` | オブジェクト | [Transactionオブジェクト](../../../protocol/transactions/index.md)のJSON表現。 | +| `ledger_hash` | 文字列 - [ハッシュ][] | _（省略される場合があります）_ トランザクションが検出されたレジャーバージョンの識別用ハッシュ。これはリクエストのハッシュと同じです。 | +| `metadata` | オブジェクト | [トランザクションのメタデータ](../../../protocol/transactions/metadata.md)。トランザクションの正確な結果を詳細に表示します。 | +| `tx_json` | オブジェクト | [Transactionオブジェクト](../../../protocol/transactions/index.md)のJSON表現。 | + +{% /tab %} + +{% /tabs %} サーバがトランザクションの検出に失敗する原因として、次のようなものが考えられます。 diff --git a/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/transaction-methods/tx.md b/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/transaction-methods/tx.md index 1b5eb93690..f1d4b3612c 100644 --- a/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/transaction-methods/tx.md +++ b/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/transaction-methods/tx.md @@ -8,6 +8,7 @@ labels: - 支払い --- # tx + [[ソース]](https://github.com/XRPLF/rippled/blob/master/src/ripple/rpc/handlers/Tx.cpp "Source") `tx`メソッドは1つのトランザクションに関する情報を取得します。 @@ -18,35 +19,64 @@ labels: {% tabs %} -{% tab label="WebSocket" %} +{% tab label="WebSocket (Hash)" %} ```json { - "id": 1, - "command": "tx", - "transaction": "E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7", - "binary": false + "id": 1, + "command": "tx", + "transaction": "C53ECF838647FA5A4C780377025FEC7999AB4182590510CA461444B207AB74A9", + "binary": false, + "api_version": 2 } ``` {% /tab %} -{% tab label="JSON-RPC" %} +{% tab label="WebSocket (CTID)" %} ```json { - "method": "tx", - "params": [ - { - "transaction": "E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7", - "binary": false - } - ] + "id": "CTID example", + "command": "tx", + "ctid": "C005523E00000000", + "binary": false, + "api_version": 2 } ``` {% /tab %} -{% tab label="コマンドライン" %} +{% tab label="JSON-RPC (Hash)" %} +```json +{ + "method": "tx", + "params": [ + { + "transaction": "C53ECF838647FA5A4C780377025FEC7999AB4182590510CA461444B207AB74A9", + "binary": false, + "api_version": 2 + } + ] +} +``` +{% /tab %} + +{% tab label="JSON-RPC (CTID)" %} +```json +{ + "method": "tx", + "params": [ + { + "ctid": "C005523E00000000", + "binary": false, + "api_version": 2 + } + ] +} +``` +{% /tab %} + +{% tab label="Commandline" %} ```sh #Syntax: tx transaction [binary] -rippled tx E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7 false +rippled tx C53ECF838647FA5A4C780377025FEC7999AB4182590510CA461444B207AB74A9 false ``` {% /tab %} @@ -56,10 +86,17 @@ rippled tx E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7 fals リクエストには以下のパラメーターが含まれます。 -| `Field` | 型 | 説明 | -|:--------------|:--------|:---------------------------------------------------| -| `transaction` | 文字列 | トランザクションの256ビットハッシュ（16進数）。 | -| `binary` | ブール値 | （省略可、デフォルトではfalseです）trueの場合、トランザクションデータとメタデータがJSONではなく16進文字列として返されます。 | +| フィールド | 型 | 必須? | 説明 | +| :------------ | :----- | :----- | --- | +| `ctid` | 文字列 | いいえ | 検索するトランザクションの[コンパクトトランザクション識別子](../../api-conventions/ctid.md)。大文字の16進数のみを使用する必要があります。 {% badge href="https://github.com/XRPLF/rippled/releases/tag/1.12.0" %}新規: rippled 1.12.0{% /badge %} _(Clio v2.0以前では対応していません)_ | +| `transaction` | 文字列 | いいえ | 検索するトランザクションの16進数の256ビットハッシュ | +| `binary` | 真偽値 | いいえ | `true` の場合、トランザクションデータとメタデータを16進数文字列へのバイナリ[シリアライズ](../../../protocol/binary-format.md)として返します。`false` の場合、トランザクションデータとメタデータを JSON で返します。デフォルトは `false` 。 | +| `min_ledger` | 数値 | いいえ | `max_ledger`と一緒に使うことで、このレジャーを起点として最大1000件までの[レジャーインデックス][ledger index]の範囲を指定することができます(自身を含む)。サーバーが[トランザクションを見つけられない](#not-foundレスポンス)場合、この範囲内のいずれのレジャーにも存在しないことになります。 | +| `max_ledger` | 数値 | いいえ | `min_ledger`と一緒に使うと、このレジャーで終わる最大1000個の[レジャーインデックス][ledger index]の範囲を指定できます(自身を含む)。サーバーが[トランザクションを見つけられない](#not-foundレスポンス)場合、この範囲内のいずれのレジャーにも存在しないことになります。 | + +`ctid`または`transaction`のいずれか一方のみを提供する必要があります。 + +{% admonition type="warning" name="注意" %}このコマンドは、トランザクションが`min_ledger`から`max_ledger`の範囲外のレジャーに含まれている場合でも、トランザクションを見つけることができる場合があります。{% /admonition %} ## レスポンスのフォーマット @@ -67,151 +104,260 @@ rippled tx E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7 fals {% tabs %} -{% tab label="WebSocket" %} +{% tab label="WebSocket (Hash)" %} +{% code-snippet file="/_api-examples/tx/ws-response-hash.json" language="json" /%} +{% /tab %} + +{% tab label="WebSocket (CTID)" %} +{% code-snippet file="/_api-examples/tx/ws-response-ctid.json" language="json" /%} +{% /tab %} + +{% tab label="JSON-RPC (Hash)" %} +{% code-snippet file="/_api-examples/tx/jsonrpc-response-hash.json" language="json" /%} +{% /tab %} + +{% tab label="JSON-RPC (CTID)" %} +{% code-snippet file="/_api-examples/tx/jsonrpc-response-ctid.json" language="json" /%} +{% /tab %} + +{% tab label="Commandline" %} ```json { - "id": 1, - "result": { - "Account": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH", - "Amount": { - "currency": "USD", - "issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", - "value": "1" - }, - "Destination": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", - "Fee": "10", - "Flags": 0, - "Paths": [ - [ - { - "account": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV", - "currency": "USD", - "issuer": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV", - "type": 49, - "type_hex": "0000000000000031" + "result" : { + "Account" : "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", + "Fee" : "12", + "Flags" : 0, + "LastLedgerSequence" : 56865248, + "OfferSequence" : 5037708, + "Sequence" : 5037710, + "SigningPubKey" : "03B51A3EDF70E4098DA7FB053A01C5A6A0A163A30ED1445F14F87C7C3295FCB3BE", + "TakerGets" : "15000000000", + "TakerPays" : { + "currency" : "CNY", + "issuer" : "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y", + "value" : "20160.75" + }, + "TransactionType" : "OfferCreate", + "TxnSignature" : "3045022100A5023A0E64923616FCDB6D664F569644C7C9D1895772F986CD6B981B515B02A00220530C973E9A8395BC6FE2484948D2751F6B030FC7FB8575D1BFB406368AD554D9", + "date" : 648248020, + "hash" : "C53ECF838647FA5A4C780377025FEC7999AB4182590510CA461444B207AB74A9", + "inLedger" : 56865245, + "ledger_index" : 56865245, + "meta" : { + "AffectedNodes" : [ + { + "ModifiedNode" : { + "FinalFields" : { + "ExchangeRate" : "4F04C66806CF7400", + "Flags" : 0, + "RootIndex" : "02BAAC1E67C1CE0E96F0FA2E8061020536CEDD043FEB0FF54F04C66806CF7400", + "TakerGetsCurrency" : "0000000000000000000000000000000000000000", + "TakerGetsIssuer" : "0000000000000000000000000000000000000000", + "TakerPaysCurrency" : "000000000000000000000000434E590000000000", + "TakerPaysIssuer" : "CED6E99370D5C00EF4EBF72567DA99F5661BFB3A" + }, + "LedgerEntryType" : "DirectoryNode", + "LedgerIndex" : "02BAAC1E67C1CE0E96F0FA2E8061020536CEDD043FEB0FF54F04C66806CF7400" } - ], - [ - { - "account": "rD1jovjQeEpvaDwn9wKaYokkXXrqo4D23x", - "currency": "USD", - "issuer": "rD1jovjQeEpvaDwn9wKaYokkXXrqo4D23x", - "type": 49, - "type_hex": "0000000000000031" - }, - { - "account": "rB5TihdPbKgMrkFqrqUC3yLdE8hhv4BdeY", - "currency": "USD", - "issuer": "rB5TihdPbKgMrkFqrqUC3yLdE8hhv4BdeY", - "type": 49, - "type_hex": "0000000000000031" - }, - { - "account": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV", - "currency": "USD", - "issuer": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV", - "type": 49, - "type_hex": "0000000000000031" + }, + { + "ModifiedNode" : { + "FinalFields" : { + "Account" : "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", + "Balance" : "10404767991", + "Flags" : 0, + "OwnerCount" : 3, + "Sequence" : 5037711 + }, + "LedgerEntryType" : "AccountRoot", + "LedgerIndex" : "1DECD9844E95FFBA273F1B94BA0BF2564DDF69F2804497A6D7837B52050174A2", + "PreviousFields" : { + "Balance" : "10404768003", + "Sequence" : 5037710 + }, + "PreviousTxnID" : "4DC47B246B5EB9CCE92ABA8C482479E3BF1F946CABBEF74CA4DE36521D5F9008", + "PreviousTxnLgrSeq" : 56865244 } - ] - ], - "SendMax": { - "currency": "USD", - "issuer": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH", - "value": "1.01" - }, - "Sequence": 88, - "SigningPubKey": "02EAE5DAB54DD8E1C49641D848D5B97D1B29149106174322EDF98A1B2CCE5D7F8E", - "TransactionType": "Payment", - "TxnSignature": "30440220791B6A3E036ECEFFE99E8D4957564E8C84D1548C8C3E80A87ED1AA646ECCFB16022037C5CAC97E34E3021EBB426479F2ACF3ACA75DB91DCC48D1BCFB4CF547CFEAA0", - "hash": "E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7", - "inLedger": 348734, - "ledger_index": 348734, - "meta": { - "AffectedNodes": [ - { - "ModifiedNode": { - "FinalFields": { - "Account": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH", - "Balance": "59328999119", - "Flags": 0, - "OwnerCount": 11, - "Sequence": 89 - }, - "LedgerEntryType": "AccountRoot", - "LedgerIndex": "E0D7BDE68B468FF0B8D948FD865576517DA987569833A05374ADB9A72E870A06", - "PreviousFields": { - "Balance": "59328999129", - "Sequence": 88 - }, - "PreviousTxnID": "C26AA6B4F7C3B9F55E17CD0D11F12032A1C7AD2757229FFD277C9447A8815E6E", - "PreviousTxnLgrSeq": 348700 - } - }, - { - "ModifiedNode": { - "FinalFields": { - "Balance": { - "currency": "USD", - "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji", - "value": "-1" - }, - "Flags": 131072, - "HighLimit": { - "currency": "USD", - "issuer": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59", - "value": "100" - }, - "HighNode": "0000000000000000", - "LowLimit": { - "currency": "USD", - "issuer": "r3PDtZSa5LiYp1Ysn1vMuMzB59RzV3W9QH", - "value": "0" - }, - "LowNode": "0000000000000000" - }, - "LedgerEntryType": "RippleState", - "LedgerIndex": "EA4BF03B4700123CDFFB6EB09DC1D6E28D5CEB7F680FB00FC24BC1C3BB2DB959", - "PreviousFields": { - "Balance": { - "currency": "USD", - "issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji", - "value": "0" - } - }, - "PreviousTxnID": "53354D84BAE8FDFC3F4DA879D984D24B929E7FEB9100D2AD9EFCD2E126BCCDC8", - "PreviousTxnLgrSeq": 343570 - } + }, + { + "DeletedNode" : { + "FinalFields" : { + "Account" : "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", + "BookDirectory" : "02BAAC1E67C1CE0E96F0FA2E8061020536CEDD043FEB0FF54F04C66806CF7400", + "BookNode" : "0000000000000000", + "Flags" : 0, + "OwnerNode" : "0000000000000000", + "PreviousTxnID" : "8F5FF57B404827F12BDA7561876A13C3E3B3095CBF75334DBFB5F227391A660C", + "PreviousTxnLgrSeq" : 56865244, + "Sequence" : 5037708, + "TakerGets" : "15000000000", + "TakerPays" : { + "currency" : "CNY", + "issuer" : "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y", + "value" : "20160.75" + } + }, + "LedgerEntryType" : "Offer", + "LedgerIndex" : "26AAE6CA8D29E28A47C92ADF22D5D96A0216F0551E16936856DDC8CB1AAEE93B" } - ], - "TransactionIndex": 0, - "TransactionResult": "tesSUCCESS" - }, - "validated": true - }, - "status": "success", - "type": "response" + }, + { + "ModifiedNode" : { + "FinalFields" : { + "Flags" : 0, + "IndexNext" : "0000000000000000", + "IndexPrevious" : "0000000000000000", + "Owner" : "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", + "RootIndex" : "47FAF5D102D8CE655574F440CDB97AC67C5A11068BB3759E87C2B9745EE94548" + }, + "LedgerEntryType" : "DirectoryNode", + "LedgerIndex" : "47FAF5D102D8CE655574F440CDB97AC67C5A11068BB3759E87C2B9745EE94548" + } + }, + { + "CreatedNode" : { + "LedgerEntryType" : "Offer", + "LedgerIndex" : "8BAEE3C7DE04A568E96007420FA11ABD0BC9AE44D35932BB5640E9C3FB46BC9B", + "NewFields" : { + "Account" : "rhhh49pFH96roGyuC4E5P4CHaNjS1k8gzM", + "BookDirectory" : "02BAAC1E67C1CE0E96F0FA2E8061020536CEDD043FEB0FF54F04C66806CF7400", + "Sequence" : 5037710, + "TakerGets" : "15000000000", + "TakerPays" : { + "currency" : "CNY", + "issuer" : "rKiCet8SdvWxPXnAgYarFUXMh1zCPz432Y", + "value" : "20160.75" + } + } + } + } + ], + "TransactionIndex" : 0, + "TransactionResult" : "tesSUCCESS" + }, + "status" : "success", + "validated" : true + } } ``` {% /tab %} {% /tabs %} +{% tabs %} + +{% tab label="API v2" %} + このレスポンスは[標準フォーマット][]に従っており、正常に完了した場合は結果に[Transactionオブジェクト](../../../protocol/transactions/index.md)フィールドと以下の追加のフィールドが含まれています。 -| `Field` | 型 | 説明 | -|:---------------|:-----------------|:-----------------------------------------| -| `hash` | 文字列 | トランザクションのSHA-512ハッシュ | -| `inLedger` | 符号なし整数 | （廃止予定）`ledger_index`のエイリアス。 | -| `ledger_index` | 符号なし整数 | このトランザクションが記録されているレジャーのシーケンス番号。 | -| `meta` | オブジェクト | トランザクションに関する各種メタデータ。 | -| `validated` | ブール値 | このデータが検証済みレジャーバージョンのデータである場合はtrue。省略されている場合またはfalseに設定されている場合は、このデータは最終データではありません。 | -| （各種） | （各種） | [Transactionオブジェクト](../../../protocol/transactions/index.md)のその他のフィールド | +| `Field` | 型 | 説明 | +| :------------- | :------------------ | ---- | +| `ctid` | 文字列 | 検索するトランザクションの[コンパクトトランザクション識別子](../../api-conventions/ctid.md)。大文字の16進数のみを使用する必要があります。 {% badge href="https://github.com/XRPLF/rippled/releases/tag/1.12.0" %}新規: rippled 1.12.0{% /badge %} _(Clio v2.0以前では対応していません)_ | +| `date` | 数値 | トランザクションが適用されたレジャーの[閉鎖時間](../../../../concepts/ledgers/ledger-close-times.md)。[Ripple Epoch][]からの秒数で表されます。 | +| `hash` | 文字列 | トランザクションの一意の[識別ハッシュ][] | +| `inLedger` | 数値 | _(非推奨)_ `ledger_index`の別名。 | +| `ledger_index` | 数値 | トランザクションが含まれるレジャーの[レジャーインデックス][]。 | +| `meta` | オブジェクト (JSON) | (JSONモード) [Transaction metadata](../../../protocol/transactions/metadata.md)。トランザクションの結果を詳細に表示します。 | +| `meta_blob` | 文字列 (バイナリ) | (バイナリモード) [Transaction metadata](../../../protocol/transactions/metadata.md)。トランザクションの結果を詳細に表示します。 | +| `tx_blob` | 文字列 (バイナリ) | (バイナリモード) トランザクションデータを16進数の文字列で表したもの。 | +| `tx_json` | オブジェクト (JSON) | (JSONモード) トランザクションデータをJSONで表したもの。 | +| `validated` | 真偽値 | `true`の場合、このデータは検証済みのレジャーバージョンからのものです。`false`の場合、このデータはまだ検証されていません。 | + +{% /tab %} + +{% tab label="API v1" %} + +このレスポンスは[標準フォーマット][]に従っており、正常に完了した場合は結果に[Transactionオブジェクト](../../../protocol/transactions/index.md)フィールドと以下の追加のフィールドが含まれています。 + +| `Field` | 型 | 説明 | +| :------------- | :--------------------------------------- | --- | +| `ctid` | 文字列 | 検索するトランザクションの[コンパクトトランザクション識別子](../../api-conventions/ctid.md)。大文字の16進数のみを使用する必要があります。 {% badge href="https://github.com/XRPLF/rippled/releases/tag/1.12.0" %}新規: rippled 1.12.0{% /badge %} _(Clio v2.0以前では対応していません)_ | +| `date` | 数値 | トランザクションが適用されたレジャーの[閉鎖時間](../../../../concepts/ledgers/ledger-close-times.md)。[Ripple Epoch][]からの秒数で表されます。 | +| `hash` | 文字列 | トランザクションの一意の[識別ハッシュ][] | +| `inLedger` | 数値 | _(非推奨)_ `ledger_index`の別名。 | +| `ledger_index` | 数値 | トランザクションが含まれるレジャーの[レジャーインデックス][]。 | +| `meta` | オブジェクト (JSON) or 文字列 (バイナリ) | [Transaction metadata](../../../protocol/transactions/metadata.md)。トランザクションの結果を詳細に表示します。 | +| `tx` | 文字列 (バイナリ) | (バイナリモード) トランザクションデータを16進数の文字列で表したもの。 | +| `tx_json` | オブジェクト (JSON) | (JSONモード) トランザクションデータをJSONで表したもの。 | +| `validated` | 真偽値 | `true`の場合、このデータは検証済みのレジャーバージョンからのものです。`false`の場合、このデータはまだ検証されていません。 | +| (その他) | (その他) | [Transactionオブジェクト](../../../protocol/transactions/index.md)のその他のフィールド | + +{% /tab %} + +{% /tabs %} + +### Not Foundレスポンス + +サーバがトランザクションを見つけられない場合、`txnNotFound`エラーを返します。これは2つのことを意味する可能性があります。 + +- トランザクションはどのレジャーバージョンにも含まれておらず、送信されていません。 +- トランザクションは、サーバが保持していないレジャーバージョンに含まれていました。 + +`txnNotFound`単体では、トランザクションの[最終的な結果](../../../../concepts/transactions/finality-of-results/index.md)を知るためには不十分です。 + +さらに可能性を絞り込むために、リクエストに`min_ledger`と`max_ledger`フィールドを指定してレジャーの範囲を指定することができます。リクエストに`min_ledger`と`max_ledger`フィールドを指定した場合、`txnNotFound`レスポンスには以下のフィールドが含まれます。 + +| フィールド | 型 | 説明 | +|:---------------|:----------|:-----------------------------------------| +| `searched_all` | 真偽値 | _(リクエストに`min_ledger`と`max_ledger`が指定されていない場合は省略)_ サーバが指定されたすべてのレジャーバージョンを検索できた場合は`true`。サーバが指定されたすべてのレジャーバージョンを持っていないため、トランザクションがそれらのいずれかに含まれているかどうかを確認できない場合は`false`。 | + +リクエストされたレジャー範囲を完全に検索した`txnNotFound`レスポンスの例: + +{% tabs %} + +{% tab label="WebSocket" %} +```json +{ + "error": "txnNotFound", + "error_code": 29, + "error_message": "Transaction not found.", + "id": 1, + "request": { + "binary": false, + "command": "tx", + "id": 1, + "max_ledger": 54368673, + "min_ledger": 54368573, + "transaction": "E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7" + }, + "searched_all": true, + "status": "error", + "type": "response" +} +``` +{% /tab %} + +{% tab label="JSON-RPC" %} +```json +200 OK + +{ + "result": { + "error": "txnNotFound", + "error_code": 29, + "error_message": "Transaction not found.", + "request": { + "binary": false, + "command": "tx", + "max_ledger": 54368673, + "min_ledger": 54368573, + "transaction": "E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7" + }, + "searched_all": true, + "status": "error" + } +} +``` +{% /tab %} + +{% /tabs %} ## 考えられるエラー * [汎用エラータイプ][]のすべて。 * `invalidParams` - 1つ以上のフィールドの指定が正しくないか、1つ以上の必須フィールドが指定されていません。 * `txnNotFound` - トランザクションが存在しないか、または`rippled`で使用できない古いレジャーバージョンのトランザクションです。 +* `excessiveLgrRange` - リクエストの`min_ledger`と`max_ledger`フィールドの差が1000を超えています。 +* `invalidLgrRange` - 指定された`min_ledger`が`max_ledger`より大きいか、それらのパラメータのいずれかが有効なレジャーインデックスではありません。 {% raw-partial file="/docs/_snippets/common-links.md" /%} diff --git a/@l10n/ja/docs/references/protocol/transactions/types/payment.md b/@l10n/ja/docs/references/protocol/transactions/types/payment.md index f84f838883..a1107b859d 100644 --- a/@l10n/ja/docs/references/protocol/transactions/types/payment.md +++ b/@l10n/ja/docs/references/protocol/transactions/types/payment.md @@ -23,7 +23,7 @@ Paymentは、[アカウントを作成](#アカウントの作成)する唯一 "TransactionType" : "Payment", "Account" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn", "Destination" : "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX", - "Amount" : { + "DeliverMax" : { "currency" : "USD", "value" : "1", "issuer" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn" @@ -40,28 +40,29 @@ Paymentは、[アカウントを作成](#アカウントの作成)する唯一 -| フィールド | JSONの型 | [内部の型][] | 説明 | -|:---------------|:--------------|:------------------|:-----------------| -| `Amount` | [通貨額][] | Amount | 送金する通貨額。XRP以外の金額の場合、入れ子フィールドの名前では、アルファベットの小文字のみ使用してください。[**tfPartialPayment**フラグ](#paymentのフラグ)が設定されている場合は、この金額を _上限_ とする金額を送金します。 | -| `Destination` | 文字列 | AccountID | 支払いを受取るアカウントの一意アドレス。 | -| `DestinationTag` | 数値 | UInt32 | _（省略可）_ 宛先（支払先となる、ホスティングされている受取人）への支払い理由を明確にするための任意のタグ。 | -| `InvoiceID` | 文字列 | Hash256 | _（省略可）_ この支払いの具体的な理由または識別子を表現する任意の256ビットハッシュ。 | -| `Paths` | パス配列の配列 | PathSet | （省略可。自動入力可能）このトランザクションに使用される[支払いパス](../../../../concepts/tokens/fungible-tokens/paths.md)の配列。XRP間のトランザクションでは省略する必要があります。 | -| `SendMax` | [通貨額][] | Amount | _（省略可）_ [送金手数料](../../../../concepts/tokens/transfer-fees.md)、為替レート、[スリッページ](http://en.wikipedia.org/wiki/Slippage_%28finance%29)を含め、このトランザクションに関して支払い元通貨での負担を許容する上限額。[トランザクションの送信コストとして消却されるXRP](../../../../concepts/transactions/transaction-cost.md)は含めないでください。XRP以外の金額の場合、入れ子フィールドの名前では、アルファベットの小文字のみ使用してください。クロスカレンシー支払いまたは複数のトークンを伴う支払いについては、このフィールドを入力する必要があります。XRP間の支払いでは省略する必要があります。 | -| `DeliverMin` | [通貨額][] | Amount | _（省略可）_ このトランザクションで送金する、宛先通貨での最少金額。[Partial Payments](../../../../concepts/payment-types/partial-payments.md)の場合のみ有効になります。XRP以外の金額の場合、入れ子フィールドの名前では、アルファベットの小文字のみ使用してください。 | +| フィールド | JSONの型 | [内部の型][] | 説明 | +| :--------------- | :------------------ | :----------- | ---- | +| `Amount` | [通貨額][] | Amount | `DeliverMax`のエイリアス | +| `DeliverMax` | [Currency Amount][] | Amount | [API v2][]: 送金する通貨額。XRP以外の金額の場合、入れ子フィールドの名前では、アルファベットの小文字のみ使用してください。[**tfPartialPayment**フラグ](#paymentのフラグ)が設定されている場合は、この金額を _上限_ とする金額を送金します。 {% badge href="https://github.com/XRPLF/rippled/releases/tag/2.0.0" %}新規: rippled 2.0.0{% /badge %} | +| `DeliverMin` | [通貨額][] | Amount | _（省略可）_ このトランザクションで送金する、宛先通貨での最少金額。[Partial Payments](../../../../concepts/payment-types/partial-payments.md)の場合のみ有効になります。XRP以外の金額の場合、入れ子フィールドの名前では、アルファベットの小文字のみ使用してください。 | +| `Destination` | 文字列 | AccountID | 支払いを受取るアカウントの一意アドレス。 | +| `DestinationTag` | 数値 | UInt32 | _（省略可）_ 宛先（支払先となる、ホスティングされている受取人）への支払い理由を明確にするための任意のタグ。 | +| `InvoiceID` | 文字列 | Hash256 | _（省略可）_ この支払いの具体的な理由または識別子を表現する任意の256ビットハッシュ。 | +| `Paths` | パス配列の配列 | PathSet | （省略可。自動入力可能）このトランザクションに使用される[支払いパス](../../../../concepts/tokens/fungible-tokens/paths.md)の配列。XRP間のトランザクションでは省略する必要があります。 | +| `SendMax` | [通貨額][] | Amount | _（省略可）_ [送金手数料](../../../../concepts/tokens/transfer-fees.md)、為替レート、[スリッページ](http://en.wikipedia.org/wiki/Slippage_%28finance%29)を含め、このトランザクションに関して支払い元通貨での負担を許容する上限額。[トランザクションの送信コストとしてバーンされるXRP](../../../../concepts/transactions/transaction-cost.md)は含めないでください。XRP以外の金額の場合、入れ子フィールドの名前では、アルファベットの小文字のみ使用してください。クロスカレンシー支払いまたは複数のトークンを伴う支払いについては、このフィールドを入力する必要があります。XRP間の支払いでは省略する必要があります。 | ## Paymentの種類 Paymentトランザクションタイプは、いくつかの異なるタイプの抽象的なアクションを表現することができる汎用ツールです。下の表で説明するように、トランザクションのフィールドに基づいてトランザクションタイプを識別することができます。 -| Paymentの種類 | `Amount` | `SendMax` | `Paths` | `Address` = `Destination`? | 説明 | -|:-------------|:----------|:-----------|:----------|:---------------------------|:--| -| [XRP同士の直接支払い][] | String (XRP) | 省略 | 省略 | いいえ | アカウント間でへ直接XRPを送金します。常に正確な金額を送信します。基本的な[取引コスト](../../../../concepts/transactions/transaction-cost.md)以外の手数料は適用されません。 | -| [発行通貨の作成・償還][] | Object | Object (任意) | 任意 | いいえ | XRP Ledgerに追跡されているXRP以外の通貨や資産の量を増減させます。[送金手数料](../../../../concepts/tokens/transfer-fees.md)と[凍結](../../../../concepts/tokens/fungible-tokens/freezes.md)は、直接送金・換金する際には適用されません。 | -| [クロスカレンシー（通貨間）決済][] | Object (non-XRP) / String (XRP) | Object (non-XRP) / String (XRP) | 通常は必須 | いいえ | 発行された通貨を保有者から別の保有者に送信します。`Amount`と`SendMax`の両方をXRPにすることはできません。これらの支払いは、発行者を介して[リップリング](../../../../concepts/tokens/fungible-tokens/rippling.md)し、トランザクションがパスセットを指定した場合、複数の仲介者を介してより長い[パス](../../../../concepts/tokens/fungible-tokens/paths.md)を取ることができます。トランザクション形式には、発行者が設定した[送金手数料](../../../../concepts/tokens/transfer-fees.md) が適用されます。これらのトランザクションは、異なる通貨間や、場合によっては同じ通貨コードで異なる発行者の通貨間を接続するために、[分散型取引所](../../../../concepts/tokens/decentralized-exchange/index.md)のオファーを利用します。 | -| [Partial payment][] | Object (non-XRP) / String (XRP) | Object (non-XRP) / String (XRP) | 通常は必須 | いいえ | 任意の通貨を特定の金額まで送ります。[`tfPartialPayment` フラグ](#paymentのフラグ)を使用します。トランザクションが成功するための最小値を指定する `DeliverMin` 値を含めることができます。トランザクションが `DeliverMin` を指定しない場合、_任意の正の値_ を指定して成功させることができる。 | -| 通貨変換 | Object (non-XRP) / String (XRP) | Object (non-XRP) / String (XRP) | 必須 | はい | [分散型取引所](../../../../concepts/tokens/decentralized-exchange/index.md)のオファーを消費して、ある通貨を別の通貨に交換し、[裁定取引](https://ja.wikipedia.org/wiki/%E8%A3%81%E5%AE%9A%E5%8F%96%E5%BC%95)の機会を得ることが出来ます。`Amount`と `SendMax` の両方を XRP にすることはできません。[Data API](../../../data-api.md) は、このタイプの取引を "payment" ではなく、"exchange" として追跡しています。 | +| Paymentの種類 | `Amount` | `SendMax` | `Paths` | `Address` = `Destination`? | 説明 | +| :--------------------------------- | :------------------------------ | :------------------------------ | :--------- | :------------------------- | ---- | +| [XRP同士の直接支払い][] | String (XRP) | 省略 | 省略 | いいえ | アカウント間でへ直接XRPを送金します。常に正確な金額を送信します。基本的な[取引コスト](../../../../concepts/transactions/transaction-cost.md)以外の手数料は適用されません。 | +| [発行通貨の作成・償還][] | Object | Object (任意) | 任意 | いいえ | XRP Ledgerに追跡されているXRP以外の通貨や資産の量を増減させます。[送金手数料](../../../../concepts/tokens/transfer-fees.md)と[凍結](../../../../concepts/tokens/fungible-tokens/freezes.md)は、直接送金・換金する際には適用されません。 | +| [クロスカレンシー（通貨間）決済][] | Object (non-XRP) / String (XRP) | Object (non-XRP) / String (XRP) | 通常は必須 | いいえ | 発行された通貨を保有者から別の保有者に送信します。`Amount`と`SendMax`の両方をXRPにすることはできません。これらの支払いは、発行者を介して[リップリング](../../../../concepts/tokens/fungible-tokens/rippling.md)し、トランザクションがパスセットを指定した場合、複数の仲介者を介してより長い[パス](../../../../concepts/tokens/fungible-tokens/paths.md)を取ることができます。トランザクション形式には、発行者が設定した[送金手数料](../../../../concepts/tokens/transfer-fees.md) が適用されます。これらのトランザクションは、異なる通貨間や、場合によっては同じ通貨コードで異なる発行者の通貨間を接続するために、[分散型取引所](../../../../concepts/tokens/decentralized-exchange/index.md)のオファーを利用します。 | +| [Partial payment][] | Object (non-XRP) / String (XRP) | Object (non-XRP) / String (XRP) | 通常は必須 | いいえ | 任意の通貨を特定の金額まで送ります。[`tfPartialPayment` フラグ](#paymentのフラグ)を使用します。トランザクションが成功するための最小値を指定する `DeliverMin` 値を含めることができます。トランザクションが `DeliverMin` を指定しない場合、_任意の正の値_ を指定して成功させることができる。 | +| 通貨変換 | Object (non-XRP) / String (XRP) | Object (non-XRP) / String (XRP) | 必須 | はい | [分散型取引所](../../../../concepts/tokens/decentralized-exchange/index.md)のオファーを消費して、ある通貨を別の通貨に交換し、[裁定取引](https://ja.wikipedia.org/wiki/%E8%A3%81%E5%AE%9A%E5%8F%96%E5%BC%95)の機会を得ることが出来ます。`Amount`と `SendMax` の両方を XRP にすることはできません。[Data API](../../../data-api.md) は、このタイプの取引を "payment" ではなく、"exchange" として追跡しています。 | [XRP同士の直接支払い]: ../../../../concepts/payment-types/direct-xrp-payments.md [発行通貨の作成・償還]: ../../../../concepts/tokens/index.md @@ -104,11 +105,11 @@ Payment型のトランザクションでは、資金供給のないアドレス Payment型のトランザクションについては、[`Flags`フィールド](../common-fields.md#flagsフィールド)で以下の値が追加でサポートされます。 -| フラグの名前 | 16進値 | 10進値 | 説明 | -|:-------------------|:-------------|:--------------|:-----------------------------| -| `tfNoRippleDirect` | `0x00010000` | 65536 | デフォルトパスを使用せず、`Paths`フィールドに含まれているパスのみ使用します。これによりトランザクションは強制的に裁定機会を活用することになります。ほとんどのクライアントでは、これは必要ありません。 | -| `tfPartialPayment` | `0x00020000` | 131072 | `SendMax`を超えていないのに指定された`Amount`を送金できない場合、即座に失敗とするのではなく、受取られる額を減額します。詳細は、[Partial Payments](../../../../concepts/payment-types/partial-payments.md)をご覧ください。 | -| `tfLimitQuality` | `0x00040000` | 262144 | すべての変換で、入力と出力との比率が`Amount`と`SendMax`との比率と同一であるか、さらに有利となるパスのみを採用します。詳細は、[クオリティの制限](#クオリティの制限)をご覧ください。 | +| フラグの名前 | 16進値 | 10進値 | 説明 | +| :----------------- | :----------- | :----- | ---- | +| `tfNoRippleDirect` | `0x00010000` | 65536 | デフォルトパスを使用せず、`Paths`フィールドに含まれているパスのみ使用します。これによりトランザクションは強制的に裁定機会を活用することになります。ほとんどのクライアントでは、これは必要ありません。 | +| `tfPartialPayment` | `0x00020000` | 131072 | `SendMax`を超えていないのに指定された`Amount`を送金できない場合、即座に失敗とするのではなく、受取られる額を減額します。詳細は、[Partial Payments](../../../../concepts/payment-types/partial-payments.md)をご覧ください。 | +| `tfLimitQuality` | `0x00040000` | 262144 | すべての変換で、入力と出力との比率が`Amount`と`SendMax`との比率と同一であるか、さらに有利となるパスのみを採用します。詳細は、[クオリティの制限](#クオリティの制限)をご覧ください。 | ## Partial Payments diff --git a/docs/references/http-websocket-apis/public-api-methods/subscription-methods/subscribe.md b/docs/references/http-websocket-apis/public-api-methods/subscription-methods/subscribe.md index e6dcf7b4ab..309df636a8 100644 --- a/docs/references/http-websocket-apis/public-api-methods/subscription-methods/subscribe.md +++ b/docs/references/http-websocket-apis/public-api-methods/subscription-methods/subscribe.md @@ -183,8 +183,6 @@ The fields from a ledger stream message are as follows: ## Validations Stream -{% badge href="https://github.com/XRPLF/rippled/releases/tag/0.29.0" %}New in: rippled 0.29.0{% /badge %} - The validations stream sends messages whenever it receives validation messages, also called validation votes, regardless of whether or not the validation message is from a trusted validator. The message looks like the following: ```json From d01754688152681af42154b67eb890efb92e5a10 Mon Sep 17 00:00:00 2001 From: tequ Date: Sun, 15 Dec 2024 17:45:38 +0900 Subject: [PATCH 2/2] Update @l10n/ja/docs/references/http-websocket-apis/public-api-methods/account-methods/account_info.md Co-authored-by: Rome Reginelli --- .../public-api-methods/account-methods/account_info.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/account-methods/account_info.md b/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/account-methods/account_info.md index 14d2d63e33..107e9ba446 100644 --- a/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/account-methods/account_info.md +++ b/@l10n/ja/docs/references/http-websocket-apis/public-api-methods/account-methods/account_info.md @@ -253,7 +253,7 @@ rippled account_info rG1QQv2nh2gr7RCZ1P8YYcBUKCCN633jCn validated ## 考えられるエラー * いずれかの[汎用エラータイプ][]。 -* `invalidParams` - 1つ以上のフィールドの指定が正しくないか、1つ以上の必須フィールドが指定されていません。例えば、リクエストで`queue`を`true`と指定したが、現在開いているレジャーではない`ledger_index`を指定した場合です。[API v1]()では、`signer_lists`に非真偽値を指定した場合にこのエラーが発生します。 +* `invalidParams` - 1つ以上のフィールドの指定が正しくないか、1つ以上の必須フィールドが指定されていません。例えば、リクエストで`queue`を`true`と指定したが、現在開いているレジャーではない`ledger_index`を指定した場合です。[API v1][]では、`signer_lists`に非真偽値を指定した場合にこのエラーが発生します。 * `actNotFound` - リクエストの`account`フィールドに指定したアドレスが、レジャー内のアカウントに対応していません。 * `lgrNotFound` - `ledger_hash`または`ledger_index`で指定したレジャーが存在しないか、存在してはいるもののサーバが保有していません。