mirror of
https://github.com/XRPLF/xrpl-dev-portal.git
synced 2025-12-06 17:27:57 +00:00
Merge remote-tracking branch 'upstream/master' into ja-credentials
This commit is contained in:
@@ -25,6 +25,7 @@ label:
|
||||
| `binary` | ブール値 | _(省略可)_ `true`の場合、リクエストしたレジャーエントリの内容がXRP Ledgerの[バイナリ形式](../../../protocol/binary-format.md)の16進数の文字列として返されます。それ以外の場合はデータがJSONフォーマットで返されます。デフォルトは`false`です。{% badge href="https://github.com/XRPLF/rippled/releases/tag/1.2.0" %}更新: rippled 1.2.0{% /badge %} |
|
||||
| `ledger_hash` | 文字列 | _(省略可)_ 使用するレジャーバージョンの20バイトの16進数の文字列。([レジャーの指定][]をご覧ください。 |
|
||||
| `ledger_index` | 文字列 または 符号なし整数 | _(省略可)_ 使用するレジャーの[レジャーインデックス][]、またはレジャーを自動的に選択するためのショートカット文字列("validated"や"closed"、"current"など)。([レジャーの指定][]をご覧ください。 |
|
||||
| `include_deleted` | 真偽値 | _(省略可, Clioサーバのみ)_ クエリされたオブジェクトが削除されている場合、その完全なデータを削除前の状態で返します。`false`または提供されていない場合、クエリされたオブジェクトが削除されている場合は`objectNotFound`を返します。 |
|
||||
|
||||
`generator`と`ledger`パラメータは非推奨であり、予告なく削除される可能性があります。
|
||||
|
||||
@@ -40,6 +41,7 @@ label:
|
||||
- [Credentialエントリを取得する](#credentialエントリを取得する)
|
||||
- [Directorynodeエントリを取得する](#directorynodeエントリを取得する)
|
||||
- [Offerエントリを取得する](#offerエントリを取得する)
|
||||
- [Oracleエントリを取得する](#oracleエントリを取得する)
|
||||
- [RippleStateエントリを取得する](#ripplestateエントリを取得する)
|
||||
- [Checkエントリを取得する](#checkエントリを取得する)
|
||||
- [Escrowエントリを取得する](#escrowエントリを取得する)
|
||||
@@ -47,6 +49,8 @@ label:
|
||||
- [DepositPreauthエントリを取得する](#depositpreauthエントリを取得する)
|
||||
- [Ticketエントリを取得する](#ticketエントリを取得する)
|
||||
- [Nft Pageを取得する](#nft-pageを取得する)
|
||||
- [MPT Issuanceオブジェクトを取得する](#mpt-issuanceオブジェクトを取得する)
|
||||
- [MPTokenオブジェクトを取得する](#mptokenオブジェクトを取得する)
|
||||
- [レスポンスのフォーマット](#レスポンスのフォーマット)
|
||||
- [考えられるエラー](#考えられるエラー)
|
||||
|
||||
@@ -459,6 +463,60 @@ rippled json ledger_entry '{ "offer": { "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJY
|
||||
|
||||
{% try-it method="ledger_entry-offer" /%}
|
||||
|
||||
### Oracleエントリを取得する
|
||||
|
||||
_([PriceOracle amendment][]が必要です)_
|
||||
|
||||
[Oracleエントリ](../../../protocol/ledger-data/ledger-entry-types/oracle.md)を取得します。これは、トークン価格を保存できる単一の価格オラクルを表します。
|
||||
|
||||
| フィールド | 型 | 必須? | 説明 |
|
||||
|-----------------------------|----------------------|-------|------|
|
||||
| `oracle` | Object | はい | オラクルの識別子。 |
|
||||
| `oracle.account` | String - [Address][] | はい | `Oracle`オブジェクトを制御するアカウント。 |
|
||||
| `oracle.oracle_document_id` | Number | はい | `Account`のオラクルの一意の識別子。 |
|
||||
|
||||
{% tabs %}
|
||||
|
||||
{% tab label="WebSocket" %}
|
||||
```json
|
||||
{
|
||||
"id": "example_get_oracle",
|
||||
"command": "ledger_entry",
|
||||
"oracle" : {
|
||||
"account": "rNZ9m6AP9K7z3EVg6GhPMx36V4QmZKeWds",
|
||||
"oracle_document_id": 34
|
||||
},
|
||||
"ledger_index": "validated"
|
||||
}
|
||||
```
|
||||
{% /tab %}
|
||||
|
||||
{% tab label="JSON-RPC" %}
|
||||
```json
|
||||
{
|
||||
"method": "ledger_entry",
|
||||
"params" : [
|
||||
{
|
||||
"oracle" : {
|
||||
"account": "rNZ9m6AP9K7z3EVg6GhPMx36V4QmZKeWds",
|
||||
"oracle_document_id": 34
|
||||
},
|
||||
"ledger_index": "validated"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
{% /tab %}
|
||||
|
||||
{% tab label="Commandline" %}
|
||||
```sh
|
||||
rippled json ledger_entry '{ "oracle": { "account": "rNZ9m6AP9K7z3EVg6GhPMx36V4QmZKeWds", "oracle_document_id": 34 }, "ledger_index": "validated" }'
|
||||
```
|
||||
{% /tab %}
|
||||
|
||||
{% /tabs %}
|
||||
|
||||
[試してみる >](/resources/dev-tools/websocket-api-tool?server=wss%3A%2F%2Fs.devnet.rippletest.net%3A51233%2F#ledger_entry-oracle)
|
||||
|
||||
|
||||
### RippleStateエントリを取得する
|
||||
@@ -823,18 +881,121 @@ rippled json ledger_entry '{ "nft_page": "255DD86DDF59D778081A06D02701E9B2C9F4F0
|
||||
|
||||
{% try-it method="ledger_entry-nft-page" /%}
|
||||
|
||||
## レスポンスのフォーマット
|
||||
### MPT Issuanceオブジェクトを取得する
|
||||
|
||||
レスポンスは[標準フォーマット][]に従って、成功結果には以下のフィールドが含まれます。
|
||||
_([MPTokensV1 amendment][]が必要です。 {% not-enabled /%})_
|
||||
|
||||
| フィールド | 型 | 説明 |
|
||||
`MPTokenIssuance`オブジェクトを返します。
|
||||
|
||||
| フィールド | 型 | 説明 |
|
||||
|:------------------------|:-------|:---------------|
|
||||
| `mpt_issuance` | 文字列 | 192ビットの`MPTokenIssuanceID`を16進文字列で指定。 |
|
||||
|
||||
{% tabs %}
|
||||
|
||||
{% tab label="WebSocket" %}
|
||||
```json
|
||||
{
|
||||
"id": "example_get_mpt_issuance",
|
||||
"command": "ledger_entry",
|
||||
"mpt_issuance": "000004C463C52827307480341125DA0577DEFC38405B0E3E",
|
||||
"ledger_index": "validated"
|
||||
}
|
||||
```
|
||||
{% /tab %}
|
||||
|
||||
{% tab label="JSON-RPC" %}
|
||||
```json
|
||||
{
|
||||
"method": "ledger_entry",
|
||||
"params": [{
|
||||
"mpt_issuance": "000004C463C52827307480341125DA0577DEFC38405B0E3E",
|
||||
"ledger_index": "validated"
|
||||
}]
|
||||
}
|
||||
```
|
||||
{% /tab %}
|
||||
|
||||
{% tab label="Commandline" %}
|
||||
```sh
|
||||
rippled json ledger_entry '{ "mpt_issuance": "000004C463C52827307480341125DA0577DEFC38405B0E3E", "ledger_index": "validated" }'
|
||||
```
|
||||
{% /tab %}
|
||||
{% /tabs %}
|
||||
|
||||
<!-- TODO: add try-it for MPT issuance
|
||||
[Try it! >](/resources/dev-tools/websocket-api-tool#ledger_entry-mpt_issuance)
|
||||
-->
|
||||
|
||||
### MPTokenオブジェクトを取得する
|
||||
|
||||
_([MPTokensV1 amendment][]が必要です。 {% not-enabled /%})_
|
||||
|
||||
`MPToken`オブジェクトを返します。
|
||||
|
||||
| フィールド | 型 | 説明 |
|
||||
|:------------------------|:-------------------------|:----------------------|
|
||||
| `mptoken` | オブジェクトまたは文字列 | 文字列の場合、取得するMPTokenのレジャーエントリIDとして解釈します。オブジェクトの場合、`MPToken`を一意に識別するために、`account`と`mpt_issuance_id`のサブフィールドが必要です。 |
|
||||
| mptoken.mpt_issuance_id | 文字列 | (`MPToken`がオブジェクトの場合必須) MPTokenIssuanceに紐づく192ビットのMPTokenIssuanceID。 |
|
||||
| mptoken.account ️ | 文字列 | (`MPToken`がオブジェクトの場合必須) MPTokenの所有者のアカウント。 |
|
||||
|
||||
{% tabs %}
|
||||
|
||||
{% tab label="WebSocket" %}
|
||||
|
||||
```json
|
||||
{
|
||||
"id": "example_get_mpt_issuance",
|
||||
"command": "ledger_entry",
|
||||
"mptoken": {
|
||||
"mpt_issuance_id": "000002DFA4D893CFBC4DC6AE877EB585F90A3B47528B958D",
|
||||
"account":"r33kves44ksufkHSGg3M6GPPAsoVHEN8C1"
|
||||
}
|
||||
}
|
||||
```
|
||||
{% /tab %}
|
||||
|
||||
{% tab label="JSON-RPC" %}
|
||||
```json
|
||||
{
|
||||
"method": "ledger_entry",
|
||||
"params": [
|
||||
{
|
||||
"mptoken":{
|
||||
"mpt_issuance_id": "000002DFA4D893CFBC4DC6AE877EB585F90A3B47528B958D",
|
||||
"account":"r33kves44ksufkHSGg3M6GPPAsoVHEN8C1"
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
{% /tab %}
|
||||
|
||||
{% tab label="Commandline" %}
|
||||
```sh
|
||||
rippled json ledger_entry '{ "mptoken": {"mpt_issuance_id": "000002DFA4D893CFBC4DC6AE877EB585F90A3B47528B958D", "account":"r33kves44ksufkHSGg3M6GPPAsoVHEN8C1"} }'
|
||||
```
|
||||
{% /tab %}
|
||||
{% /tabs %}
|
||||
|
||||
<!-- TODO: make a try-it link for MPT object
|
||||
[Try it! >](/resources/dev-tools/websocket-api-tool#ledger_entry-mptoken)
|
||||
-->
|
||||
|
||||
## レスポンスフォーマット
|
||||
|
||||
レスポンスは[標準フォーマット][]に従い、成功した結果には次のフィールドが含まれます。
|
||||
|
||||
| フィールド | 型 | 説明 |
|
||||
|:---------------|:-----------------|:-----------------------------------------|
|
||||
| `index` | 文字列 | [レジャーエントリ](../../../protocol/ledger-data/ledger-entry-types/index.md)の一意のID。 |
|
||||
| `ledger_index` | 符号なし整数 | このデータを取得する際に使用したレジャーの [レジャーインデックス][]。 |
|
||||
| `node` | オブジェクト | _(`"binary": true`が指定されている場合、省略)_ [レジャーフォーマット][]に基づいた、このレジャーエントリのデータを含むエントリ。 |
|
||||
| `node_binary` | 文字列 | _(`"binary": true`が指定されていない場合、省略)_ レジャーエントリの[バイナリ形式](../../../protocol/binary-format.md)を16進数で表したもの。 |
|
||||
| `deleted_ledger_index` | 文字列 | _(Clioサーバのみ, `include_deleted`パラメータが設定されている場合のみ)_ レジャーエントリオブジェクトが削除された[レジャーインデックス][]。 |
|
||||
|
||||
処理が成功したレスポンスの例:
|
||||
|
||||
成功したレスポンスの例:
|
||||
|
||||
{% tabs %}
|
||||
|
||||
@@ -904,7 +1065,7 @@ rippled json ledger_entry '{ "nft_page": "255DD86DDF59D778081A06D02701E9B2C9F4F0
|
||||
```
|
||||
{% /tab %}
|
||||
|
||||
{% tab label="コマンドライン" %}
|
||||
{% tab label="Commandline" %}
|
||||
```json
|
||||
{
|
||||
"result": {
|
||||
|
||||
Reference in New Issue
Block a user