Skip to content

Commit 5d30328

Browse files
amarantha-kamarantha-k
authored
Merge pull request #3120 from t-ube/ja-simulate
[JA] translate Simulate documents
2 parents 6d90eb4 + 306e169 commit 5d30328

File tree

1 file changed

+192
-0
lines changed
  • @l10n/ja/docs/references/http-websocket-apis/public-api-methods/transaction-methods

1 file changed

+192
-0
lines changed

‎@l10n/ja/docs/references/http-websocket-apis/public-api-methods/transaction-methods/simulate.md

Lines changed: 192 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,192 @@
1+
---
2+
seo:
3+
description: あらゆる種類のトランザクションを仮実行して、結果とメタデータをプレビューします。
4+
labels:
5+
- トランザクション送信
6+
---
7+
# simulate
8+
[[ソース]](https://github.com/XRPLF/rippled/blob/master/src/xrpld/rpc/handlers/Simulate.cpp "ソース")
9+
10+
`simulate` メソッドは、あらゆる トランザクションを仮実行し、XRP Ledger に反映することなく、その結果やメタデータを事前に確認できます。このコマンドはネットワークにトランザクションを送信しないため、手数料は発生しません。
11+
12+
{% admonition type="warning" name="Caution" %}
13+
`simulate` メソッドの結果は、実際にトランザクションを送信したときと同じになるとは限りません。これは、トランザクションの処理に影響する台帳の状態が、シミュレーションと送信の間に変化する可能性があるためです。
14+
{% /admonition %}
15+
16+
17+
## リクエストのフォーマット
18+
19+
リクエストのフォーマットの例:
20+
21+
{% tabs %}
22+
23+
{% tab label="WebSocket" %}
24+
```json
25+
{
26+
"id": 2,
27+
"command": "simulate",
28+
"tx_json" : {
29+
"TransactionType" : "Payment",
30+
"Account" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
31+
"Destination" : "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
32+
"Amount" : {
33+
"currency" : "USD",
34+
"value" : "1",
35+
"issuer" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn"
36+
}
37+
}
38+
}
39+
```
40+
{% /tab %}
41+
42+
{% tab label="JSON-RPC" %}
43+
```json
44+
{
45+
"method": "simulate",
46+
"params": {
47+
"tx_json" : {
48+
"TransactionType" : "Payment",
49+
"Account" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
50+
"Destination" : "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
51+
"Amount" : {
52+
"currency" : "USD",
53+
"value" : "1",
54+
"issuer" : "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn"
55+
}
56+
}
57+
}
58+
}
59+
```
60+
{% /tab %}
61+
62+
{% /tabs %}
63+
64+
{% try-it method="simulate" /%}
65+
66+
リクエストには以下のパラメーターが含まれます。
67+
68+
| フィールド | 型 | 必須? | 説明 |
69+
| --------- | ------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
70+
| `tx_blob` | 文字列 | はい | シミュレーション対象のトランザクションを[バイナリフォーマット](https://xrpl.org/ja/docs/references/protocol/binary-format)で指定します。このフィールドを使用する場合、`tx_json`は同時に指定しないでください。 |
71+
| `tx_json` | オブジェクト | はい | シミュレーション対象のトランザクションをJSON形式で指定します。このフィールドを使用する場合は、`tx_blob`を同時に指定しないでください。 |
72+
| `binary` | ブール値 | いいえ | デフォルト値は`false`であり、この場合はデータとメタデータがJSON形式で返されます。`true`を指定すると、データとメタデータはバイナリフォーマットで返され、16進文字列としてシリアライズされます。 |
73+
74+
- シミュレーションで使用するトランザクションは、未署名でなければなりません。
75+
- `Fee`、`Sequence`、`SigningPubKey`、または`NetworkID`フィールドが指定されている場合、それらはトランザクションに使用されます。指定されていない場合は、サーバーが自動的に補完します。
76+
77+
## レスポンスのフォーマット
78+
79+
処理が成功したレスポンスの例:
80+
81+
```json
82+
{
83+
"id": 2,
84+
"result": {
85+
"applied": false,
86+
"engine_result": "tesSUCCESS",
87+
"engine_result_code": 0,
88+
"engine_result_message": "The simulated transaction would have been applied.",
89+
"ledger_index": 3,
90+
"meta": {
91+
"AffectedNodes": [
92+
{
93+
"ModifiedNode": {
94+
"FinalFields": {
95+
"Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
96+
"AccountTxnID": "4D5D90890F8D49519E4151938601EF3D0B30B16CD6A519D9C99102C9FA77F7E0",
97+
"Balance": "75159663",
98+
"Flags": 9043968,
99+
"OwnerCount": 5,
100+
"Sequence": 361,
101+
"TransferRate": 1004999999
102+
},
103+
"LedgerEntryType": "AccountRoot",
104+
"LedgerIndex": "13F1A95D7AAB7108D5CE7EEAF504B2894B8C674E6D68499076441C4837282BF8",
105+
"PreviousFields": {
106+
"AccountTxnID": "2B44EBE00728D04658E597A85EC4F71D20503B31ABBF556764AD8F7A80BA72F6",
107+
"Balance": "75169663",
108+
"Sequence": 360
109+
},
110+
"PreviousTxnID": "2B44EBE00728D04658E597A85EC4F71D20503B31ABBF556764AD8F7A80BA72F6",
111+
"PreviousTxnLgrSeq": 18555460
112+
}
113+
},
114+
{
115+
"ModifiedNode": {
116+
"FinalFields": {
117+
"Balance": {
118+
"currency": "USD",
119+
"issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
120+
"value": "12.0301"
121+
},
122+
"Flags": 65536,
123+
"HighLimit": {
124+
"currency": "USD",
125+
"issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
126+
"value": "0"
127+
},
128+
"HighNode": "0",
129+
"LowLimit": {
130+
"currency": "USD",
131+
"issuer": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
132+
"value": "100"
133+
},
134+
"LowNode": "0"
135+
},
136+
"LedgerEntryType": "RippleState",
137+
"LedgerIndex": "96D2F43BA7AE7193EC59E5E7DDB26A9D786AB1F7C580E030E7D2FF5233DA01E9",
138+
"PreviousFields": {
139+
"Balance": {
140+
"currency": "USD",
141+
"issuer": "rrrrrrrrrrrrrrrrrrrrBZbvji",
142+
"value": "11.0301"
143+
}
144+
},
145+
"PreviousTxnID": "7FFE02667225DFE39594663DEDC823FAF188AC5F036A9C2CA3259FB5379C82B4",
146+
"PreviousTxnLgrSeq": 9787698
147+
}
148+
}
149+
],
150+
"TransactionIndex": 0,
151+
"TransactionResult": "tesSUCCESS",
152+
"delivered_amount": {
153+
"currency": "USD",
154+
"issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
155+
"value": "1"
156+
}
157+
},
158+
"tx_json": {
159+
"Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
160+
"DeliverMax": {
161+
"currency": "USD",
162+
"issuer": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
163+
"value": "1"
164+
},
165+
"Destination": "ra5nK24KXen9AHvsdFTKHSANinZseWnPcX",
166+
"Fee": "10",
167+
"Sequence": 360,
168+
"TransactionType": "Payment"
169+
}
170+
},
171+
"status": "success",
172+
"type": "response"
173+
}
174+
```
175+
176+
レスポンスは[標準フォーマット][]に従っており、正常に完了した場合は結果に次のフィールドが含まれています。
177+
178+
| フィールド | 型 | 説明 |
179+
| -------------- | ------ | ----------- |
180+
| `tx_json` | オブジェクト | 自動補完された値を含む、シミュレーションされたトランザクション。`binary`が`false`の場合に含まれます。 |
181+
| `tx_blob` | 文字列 | 自動補完された値を含む、シリアライズされたシミュレーションされたトランザクション。`binary`が`true`の場合に含まれます。 |
182+
| `ledger_index` | [レジャーインデックス](https://xrpl.org/ja/docs/references/protocol/data-types/basic-data-types#レジャーインデックス) | このトランザクションが含まれていたであろうレジャーインデックス。 |
183+
| `meta` | オブジェクト | トランザクションの結果を示すメタデータ。台帳に含まれないことを意味するコード（たとえば TEC 以外のコード）でトランザクションが失敗した場合は含まれません。`binary`が`false`の場合に含まれます。 |
184+
| `meta_blob` | 文字列 | トランザクションの結果を示すメタデータ。台帳に含まれないことを意味するコード（たとえば TEC 以外のコード）でトランザクションが失敗した場合は含まれません。`binary`が`true`の場合に含まれます。 |
185+
186+
187+
## 考えられるエラー
188+
189+
* `invalidParams` - 1つ以上のフィールドの指定が正しくないか、1つ以上の必須フィールドが指定されていません。
190+
* `transactionSigned` - トランザクションが署名済みです。シミュレーションで使用するトランザクションは、未署名でなければなりません。
191+
192+
{% raw-partial file="/docs/_snippets/common-links.md" /%}

0 commit comments

Comments
 (0)