mirror of
https://github.com/XRPLF/xrpl-dev-portal.git
synced 2025-11-16 09:45:51 +00:00
Merge remote-tracking branch 'origin' into institutional-defi-page
This commit is contained in:
@@ -0,0 +1,125 @@
|
||||
---
|
||||
seo:
|
||||
description: オーダーブック情報の変更をサブスクライブします。
|
||||
labels:
|
||||
- 分散型取引所
|
||||
- クロスカレンシー
|
||||
---
|
||||
# book_changes
|
||||
[[ソース]](https://github.com/XRPLF/rippled/blob/master/src/ripple/rpc/BookChanges.h "ソース")
|
||||
|
||||
{% code-page-name /%} メソッドは、[分散型取引所(DEX)](../../../../concepts/tokens/decentralized-exchange/index.md) のオーダーブックの変更に関する情報を、以前のレジャーバージョンと比較して提供します。これは「ローソク足」チャートの作成に役立つ場合があります。
|
||||
|
||||
### リクエストのフォーマット
|
||||
|
||||
リクエストの例:
|
||||
|
||||
{% tabs %}
|
||||
|
||||
{% tab label="WebSocket" %}
|
||||
```json
|
||||
{
|
||||
"id": "example_book_changes",
|
||||
"command": "{% $frontmatter.seo.title %}",
|
||||
"ledger_index": 88530953
|
||||
}
|
||||
```
|
||||
{% /tab %}
|
||||
|
||||
{% tab label="JSON-RPC" %}
|
||||
```json
|
||||
{
|
||||
"method": "{% $frontmatter.seo.title %}",
|
||||
"params": [{
|
||||
"ledger_index": 88530953
|
||||
}]
|
||||
}
|
||||
```
|
||||
{% /tab %}
|
||||
|
||||
{% tab label="コマンドライン" %}
|
||||
```sh
|
||||
#Syntax: book_changes [<ledger hash|id>]
|
||||
rippled book_changes 88530953
|
||||
```
|
||||
{% /tab %}
|
||||
|
||||
{% /tabs %}
|
||||
|
||||
[試してみる! >](/resources/dev-tools/websocket-api-tool#book_changes)
|
||||
|
||||
リクエストには以下のパラメーターが含まれます。
|
||||
|
||||
| フィールド | 型 | 必須? | 説明 |
|
||||
|:---------------|:-------------------------|:-------|------|
|
||||
| `ledger_hash` | [ハッシュ][] | いいえ | 使用するレジャーバージョンの32バイトの16進文字列。(詳しくは[レジャーの指定][]をご覧ください。) |
|
||||
| `ledger_index` | [レジャーインデックス][] | いいえ | 使用するレジャーの[レジャーインデックス][]、または自動的にレジャーを選択するためのショートカット文字列。([レジャーの指定][]) |
|
||||
|
||||
{% admonition type="warning" name="既知の問題" %}
|
||||
`rippled`のこのメソッドにいくつかの既知の問題があります。
|
||||
|
||||
- デフォルトまたはショートカット文字列を使用する代わりに、`ledger_index`または`ledger_hash`を明示的に指定する必要があります。([Issue #5034](https://github.com/XRPLF/rippled/issues/5034))
|
||||
- JSON-RPC APIのレスポンスは、検証済みのレジャーをクエリする場合でも`validated`フィールドが欠落する可能性があります。([#5035](https://github.com/XRPLF/rippled/issues/5035))
|
||||
- 最近閉じたレジャーをクエリする場合、成功したレスポンスが意図したデータの代わりにレジャーリクエストオブジェクトを返すことがあります。([#5033](https://github.com/XRPLF/rippled/issues/5033))
|
||||
- 古いレジャーからデータをクエリする場合、サーバーが長時間(30秒以上)応答しない可能性があります。([#5036](https://github.com/XRPLF/rippled/issues/5036))
|
||||
|
||||
これらのバグはClioサーバーには適用されません。
|
||||
{% /admonition %}
|
||||
|
||||
## レスポンスのフォーマット
|
||||
|
||||
成功したレスポンスの例:
|
||||
|
||||
{% tabs %}
|
||||
|
||||
{% tab label="WebSocket" %}
|
||||
{% code-snippet file="/_api-examples/book_changes/ws-response.json" language="json" /%}
|
||||
{% /tab %}
|
||||
|
||||
{% tab label="JSON-RPC" %}
|
||||
{% code-snippet file="/_api-examples/book_changes/jsonrpc-response.json" language="json" prefix="200 OK\n\n" /%}
|
||||
{% /tab %}
|
||||
|
||||
{% tab label="コマンドライン" %}
|
||||
{% code-snippet file="/_api-examples/book_changes/jsonrpc-response.json" language="json" prefix="Loading: \"/etc/opt/ripple/rippled.cfg\"\n2024-Jun-07 18:41:45.257772761 UTC HTTPClient:NFO Connecting to 127.0.0.1:5005\n\n" /%}
|
||||
{% /tab %}
|
||||
|
||||
{% /tabs %}
|
||||
|
||||
このレスポンスは[標準フォーマット][]に従っており、正常に完了した場合は結果に次のフィールドが含まれます。
|
||||
|
||||
| フィールド | 型 | 説明 |
|
||||
|:---------------|:-------------------------|:-----------------|
|
||||
| `changes` | 配列 | このレジャーバージョンで更新された各オーダーブックの[Book Updateオブジェクト](#book-updateオブジェクト)のリスト。オーダーブックが更新されなかった場合、配列は空になります。 |
|
||||
| `ledger_hash` | [ハッシュ][] | このデータを取得する際に使用されたレジャーバージョンの識別ハッシュ。 |
|
||||
| `ledger_index` | [レジャーインデックス][] | このデータを取得する際に使用されたレジャーバージョンのレジャーインデックス。 |
|
||||
| `ledger_time` | 数値 | このデータを取得する際に使用されたレジャーバージョンの公式クローズ時間。[リップルエポックからの秒数][]で表されます。 |
|
||||
| `type` | 文字列 | 文字列`bookChanges`。これはオーダーブック更新メッセージであることを示します。 |
|
||||
| `validated` | 真偽値 | _(省略可)_ `true`の場合、検証済みのレジャーバージョンから取得されたことを表します。 |
|
||||
|
||||
### Book Updateオブジェクト
|
||||
|
||||
Book Updateオブジェクトは、1つのレジャーバージョンにおける1つのオーダーブックの変更を表し、次のフィールドを含みます。
|
||||
|
||||
| フィールド | 型 | 説明 |
|
||||
|:---------------|:-----------------|:------------------------|
|
||||
| `currency_a` | 文字列 | オーダーブック内の2つの通貨のうちの最初の通貨の識別子。XRPの場合、これは文字列`XRP_drops`です。[トークン](../../../../concepts/tokens/index.md)の場合、[base58][]で表された発行者のアドレスの後にスラッシュ(`/`)が続き、その後に[通貨コード][]が続きます。これは3文字の標準コードまたは20文字の16進コードになります。 |
|
||||
| `currency_b` | 文字列 | オーダーブック内の2つの通貨のうちの2番目の通貨の識別子。これは`currency_a`と同じ形式ですが、`currency_b`はXRPになることはありません。 |
|
||||
| `volume_a` | 文字列 - 数値 | このレジャーバージョンでこのオーダーブックの取引を通じて移動した最初の通貨(つまり`currency_a`)の総量、または _取引高_。 |
|
||||
| `volume_b` | 文字列 - 数値 | このレジャーバージョンでこのオーダーブックの取引を通じて移動した2番目の通貨(つまり`currency_b`)の取引高。 |
|
||||
| `high` | 文字列 - 数値 | このレジャーバージョンでこのオーダーブックの取引を通じてマッチしたすべてのオファーの中で最も高い取引レート。最初の通貨と2番目の通貨の比率として表されます。(つまり、`currency_a : currency_b`。) |
|
||||
| `low` | 文字列 - 数値 | このレジャーバージョンでこのオーダーブックの取引を通じてマッチしたすべてのオファーの中で最も低い取引レート。最初の通貨と2番目の通貨の比率として表されます。 |
|
||||
| `open` | 文字列 - 数値 | このレジャーバージョンでこのオーダーブックの取引を処理する前のオーダーブックの最初の取引の取引レート。最初の通貨と2番目の通貨の比率として表されます。 |
|
||||
| `close` | 文字列 - 数値 | このレジャーバージョンでこのオーダーブックの取引を処理した後のオーダーブックの最初の取引の取引レート。最初の通貨と2番目の通貨の比率として表されます。 |
|
||||
|
||||
XRP-トークンのオーダーブックでは、XRPは常に`currency_a`で表されます。トークン-トークンのオーダーブックでは、発行者と通貨コードでアルファベット順に並べ替えられます。
|
||||
|
||||
XRPに関する取引レートは常に[XRPのdrop数][]を使用して計算されます。例えば、XRPからFOOへのレートが1.0 XRP に対して 1 FOOの場合、APIによって報告されたレートは`1000000`(1 FOOあたり100万ドロップのXRP)になります。
|
||||
|
||||
## 考えられるエラー
|
||||
|
||||
* いずれかの[汎用エラータイプ][]。
|
||||
* `lgrNotFound` - `ledger_hash`または`ledger_index`で指定したレジャーが存在しないか、存在してはいるもののサーバが保有していません。
|
||||
* `invalidParams` - 1つ以上のフィールドの指定が正しくないか、1つ以上の必須フィールドが指定されていません。
|
||||
|
||||
{% raw-partial file="/docs/_snippets/common-links.md" /%}
|
||||
@@ -5,12 +5,11 @@ seo:
|
||||
description: 分散型ID(DID)の定義と詳細
|
||||
labels:
|
||||
- DID
|
||||
status: not_enabled
|
||||
---
|
||||
# DID
|
||||
[[ソース]](https://github.com/XRPLF/rippled/blob/master/src/ripple/protocol/impl/LedgerFormats.cpp#L330-L341 "ソース)
|
||||
|
||||
_([DID Amendment][] {% not-enabled /%} が必要です。)_
|
||||
_([DID Amendment][])_
|
||||
|
||||
`DID`のレジャーエントリは、単一の[DID](../../../../concepts/decentralized-storage/decentralized-identifiers.md)への参照、またはそれに関連するデータを保持します。
|
||||
|
||||
|
||||
@@ -5,13 +5,12 @@ seo:
|
||||
description: DIDを削除する。
|
||||
labels:
|
||||
- DID
|
||||
status: not_enabled
|
||||
---
|
||||
# DIDDelete
|
||||
|
||||
[[ソース]](https://github.com/XRPLF/rippled/blob/master/src/ripple/app/tx/impl/DID.cpp "ソース")
|
||||
|
||||
_([DID Amendment][] {% not-enabled /%} が必要です。)_
|
||||
_([DID Amendment][])_
|
||||
|
||||
指定した`Account`フィールドに関連付けられている[DIDレジャーエントリ](../../ledger-data/ledger-entry-types/did.md)を削除します。
|
||||
|
||||
|
||||
@@ -5,13 +5,12 @@ seo:
|
||||
description: DIDを作成または更新します。
|
||||
labels:
|
||||
- DID
|
||||
status: not_enabled
|
||||
---
|
||||
# DIDSet
|
||||
|
||||
[[ソース]](https://github.com/XRPLF/rippled/blob/master/src/ripple/app/tx/impl/DID.cpp "ソース")
|
||||
|
||||
_([DID Amendment][] {% not-enabled /%} が必要です。)_
|
||||
_([DID Amendment][])_
|
||||
|
||||
新しい[DIDレジャーエントリ](../../ledger-data/ledger-entry-types/did.md)を作成したり、既存の項目を更新したりします。
|
||||
|
||||
|
||||
@@ -19,7 +19,7 @@ labels:
|
||||
|:----------------------------------|:-----------|:------------------------------------|
|
||||
| [fixXChainRewardRounding][] | v2.2.0 | {% badge href="https://xrpl.org/blog/2024/rippled-2.2.0" %}投票中: 2024-06-04{% /badge %} |
|
||||
| [PriceOracle][] | v2.2.0 | {% badge href="https://livenet.xrpl.org/transactions/05D03F7BF08BF4A915483F7B10EAC7016034656A54A8A6AD4A49A9AD362764A1" %}有効: 2024-11-02{% /badge %} |
|
||||
| [DID][] | v2.0.0 | {% badge href="https://xrpl.org/blog/2024/rippled-2.0.0.html" %}投票中: 2024-01-09{% /badge %} |
|
||||
| [DID][] | v2.0.0 | {% badge href="https://livenet.xrpl.org/transactions/7239CF04E6E1EEC606269135DA3C916B82D4B010F5315E7AEB3D5A3B6B5B343D" %}有効: 2024-10-30{% /badge %} |
|
||||
| [XChainBridge][] | v2.0.0 | {% badge href="https://xrpl.org/blog/2024/rippled-2.0.0.html" %}投票中: 2024-01-09{% /badge %} |
|
||||
| [fixEmptyDID][] | v2.2.0 | {% badge href="https://livenet.xrpl.org/transactions/A858AE8832981D77A4C5038D633CC9CBD54C9764BD2A3F8CA174E02D1736F472" %}有効: 2024-09-27{% /badge %} |
|
||||
| [fixPreviousTxnID][] | v2.2.0 | {% badge href="https://livenet.xrpl.org/transactions/C7A9804E1F499ABBF38D791BAD25B1479DB1CEA4E9B6C5C08D6D4EF13F41E171" %}有効: 2024-09-27{% /badge %} |
|
||||
@@ -293,7 +293,7 @@ Clawbackはデフォルトでは無効になっています。Clawbackを使用
|
||||
| Amendment | DID |
|
||||
|:-------------|:----|
|
||||
| Amendment ID | DB432C3A09D9D5DFC7859F39AE5FF767ABC59AED0A9FB441E83B814D8946C109 |
|
||||
| ステータス | 投票中 |
|
||||
| ステータス | 有効 |
|
||||
| デフォルトの投票(最新の安定版) | いいえ |
|
||||
| Amendment前の機能は廃止? | いいえ |
|
||||
|
||||
@@ -301,8 +301,8 @@ Clawbackはデフォルトでは無効になっています。Clawbackを使用
|
||||
|
||||
次の新しいトランザクションを追加します。
|
||||
|
||||
- DIDDelete - XRPLアカウントに関連付けられたDIDを削除します。
|
||||
- DIDSet - 新しいDIDを作成するか、既存のDIDを更新します。
|
||||
- [DIDDelete](../docs/references/protocol/transactions/types/diddelete.md) - XRPLアカウントに関連付けられたDIDを削除します。
|
||||
- [DIDSet](../docs/references/protocol/transactions/types/didset.md) - 新しいDIDを作成するか、既存のDIDを更新します。
|
||||
|
||||
新しい`DID`レジャーエントリタイプを追加します。
|
||||
|
||||
|
||||
@@ -996,6 +996,17 @@ const events = [
|
||||
image: require('../static/img/events/aquarium.png'),
|
||||
end_date: "December 11, 2024",
|
||||
},
|
||||
{
|
||||
name: "XRPL Meetup NYC",
|
||||
description:
|
||||
"Get ready for an unforgettable evening at the XRPL Meetup NYC!",
|
||||
type: "meetup",
|
||||
link: "https://xrpl.at/Aquarium-XRPL-Residency-DemoDay4",
|
||||
location: " New York, New York",
|
||||
date: "November 19, 2024",
|
||||
image: require('../static/img/events/new-york.jpeg'),
|
||||
end_date: "November 19, 2024",
|
||||
},
|
||||
];
|
||||
|
||||
|
||||
|
||||
@@ -329,6 +329,18 @@ const events = [
|
||||
start_date: "October 25, 2024",
|
||||
end_date: "October 25, 2024",
|
||||
},
|
||||
{
|
||||
name: "XRPL Meetup NYC",
|
||||
description:
|
||||
"Get ready for an unforgettable evening at the XRPL Meetup NYC!",
|
||||
type: "meetup",
|
||||
link: "https://xrpl.at/Aquarium-XRPL-Residency-DemoDay4",
|
||||
location: " New York, New York",
|
||||
date: "November 19, 2024",
|
||||
image: require('../static/img/events/new-york.jpeg'),
|
||||
end_date: "November 19, 2024",
|
||||
start_date: "November 19, 2024",
|
||||
},
|
||||
{
|
||||
name: "XRPL Builder Office Hours",
|
||||
description:
|
||||
|
||||
@@ -19,6 +19,8 @@ To make a digital signature, you use a cryptographic key pair associated with th
|
||||
|
||||
Many [client libraries](../../references/client-libraries.md) and applications can generate a key pair suitable for use with the XRP Ledger. However, you should only use key pairs that were generated with devices and software you trust. Compromised applications can expose your secret to malicious users who can then send transactions from your account later.
|
||||
|
||||
Note: Different tools have different defaults. Many client libraries (such as xrpl.js) use Ed25519 as the default cryptographic algorithm, but `rippled`'s [wallet_propose](../../references/http-websocket-apis/admin-api-methods/key-generation-methods/wallet_propose) admin RPC command uses secp256k1 as the default. This means that you may get a different address if you instantiate a wallet from the same seed using a different tool, unless you specify the algorithm explicitly.
|
||||
|
||||
|
||||
## Key Components
|
||||
|
||||
|
||||
@@ -3,13 +3,12 @@ html: decentralized-identifiers.html
|
||||
parent: accounts.html
|
||||
seo:
|
||||
description: Decentralized identifiers enable verifiable, decentralized digital identities.
|
||||
status: not_enabled
|
||||
labels:
|
||||
- DID
|
||||
---
|
||||
# Decentralized Identifiers
|
||||
|
||||
_(Requires the [DID amendment][] {% not-enabled /%})_
|
||||
_(Requires the [DID amendment][])_
|
||||
|
||||
A Decentralized Identifier (DID) is a new type of identifier defined by the World Wide Web Consortium (W3C) that enables verifiable, digital identities. DIDs are fully under the control of the DID owner, independent from any centralized registry, identity provider, or certificate authority.
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
seo:
|
||||
description: Get information on
|
||||
description: Get information on order book changes
|
||||
labels:
|
||||
- Decentralized Exchange
|
||||
- Cross-Currency
|
||||
@@ -20,7 +20,7 @@ An example of the request format:
|
||||
```json
|
||||
{
|
||||
"id": "example_book_changes",
|
||||
"command": "book_changes",
|
||||
"command": "{% $frontmatter.seo.title %}",
|
||||
"ledger_index": 88530953
|
||||
}
|
||||
```
|
||||
|
||||
@@ -5,12 +5,11 @@ seo:
|
||||
description: The definition and details of a Decentralized Identifier (DID).
|
||||
labels:
|
||||
- DID
|
||||
status: not_enabled
|
||||
---
|
||||
# DID
|
||||
[[Source]](https://github.com/XRPLF/rippled/blob/master/src/ripple/protocol/impl/LedgerFormats.cpp#L330-L341 "Source")
|
||||
|
||||
_(Requires the [DID amendment][] {% not-enabled /%})_
|
||||
_(Requires the [DID amendment][])_
|
||||
|
||||
A `DID` ledger entry holds references to, or data associated with, a single [DID](../../../../concepts/decentralized-storage/decentralized-identifiers.md).
|
||||
|
||||
|
||||
@@ -5,13 +5,12 @@ seo:
|
||||
description: Delete a DID.
|
||||
labels:
|
||||
- DID
|
||||
status: not_enabled
|
||||
---
|
||||
# DIDDelete
|
||||
|
||||
[[Source]](https://github.com/XRPLF/rippled/blob/master/src/ripple/app/tx/impl/DID.cpp "Source")
|
||||
|
||||
_(Requires the [DID amendment][] {% not-enabled /%})_
|
||||
_(Requires the [DID amendment][])_
|
||||
|
||||
Delete the [DID ledger entry](../../ledger-data/ledger-entry-types/did.md) associated with the specified `Account` field.
|
||||
|
||||
|
||||
@@ -5,13 +5,12 @@ seo:
|
||||
description: Create or update a DID.
|
||||
labels:
|
||||
- DID
|
||||
status: not_enabled
|
||||
---
|
||||
# DIDSet
|
||||
|
||||
[[Source]](https://github.com/XRPLF/rippled/blob/master/src/ripple/app/tx/impl/DID.cpp "Source")
|
||||
|
||||
_(Requires the [DID amendment][] {% not-enabled /%})_
|
||||
_(Requires the [DID amendment][])_
|
||||
|
||||
Creates a new [DID ledger entry](../../ledger-data/ledger-entry-types/did.md) or updates the fields of an existing one.
|
||||
|
||||
|
||||
@@ -19,7 +19,7 @@ This list is updated manually. For a live view of amendment voting, see the Amen
|
||||
|:----------------------------------|:-----------|:------------------------------|
|
||||
| [fixXChainRewardRounding][] | v2.2.0 | {% badge href="https://xrpl.org/blog/2024/rippled-2.2.0" %}Open for Voting: 2024-06-04{% /badge %} |
|
||||
| [PriceOracle][] | v2.2.0 | {% badge href="https://livenet.xrpl.org/transactions/05D03F7BF08BF4A915483F7B10EAC7016034656A54A8A6AD4A49A9AD362764A1" %}Enabled: 2024-11-02{% /badge %} |
|
||||
| [DID][] | v2.0.0 | {% badge href="https://xrpl.org/blog/2024/rippled-2.0.0.html" %}Open for Voting: 2024-01-09{% /badge %} |
|
||||
| [DID][] | v2.0.0 | {% badge href="https://livenet.xrpl.org/transactions/7239CF04E6E1EEC606269135DA3C916B82D4B010F5315E7AEB3D5A3B6B5B343D" %}Enabled: 2024-10-30{% /badge %} |
|
||||
| [XChainBridge][] | v2.0.0 | {% badge href="https://xrpl.org/blog/2024/rippled-2.0.0.html" %}Open for Voting: 2024-01-09{% /badge %} |
|
||||
| [fixEmptyDID][] | v2.2.0 | {% badge href="https://livenet.xrpl.org/transactions/A858AE8832981D77A4C5038D633CC9CBD54C9764BD2A3F8CA174E02D1736F472" %}Enabled: 2024-09-27{% /badge %} |
|
||||
| [fixPreviousTxnID][] | v2.2.0 | {% badge href="https://livenet.xrpl.org/transactions/C7A9804E1F499ABBF38D791BAD25B1479DB1CEA4E9B6C5C08D6D4EF13F41E171" %}Enabled: 2024-09-27{% /badge %} |
|
||||
@@ -293,7 +293,7 @@ Also changes the OfferCreate transaction to return `tecEXPIRED` when trying to c
|
||||
| Amendment | DID |
|
||||
|:-------------|:----|
|
||||
| Amendment ID | DB432C3A09D9D5DFC7859F39AE5FF767ABC59AED0A9FB441E83B814D8946C109 |
|
||||
| Status | Open for Voting |
|
||||
| Status | Enabled |
|
||||
| Default Vote (Latest stable release) | No |
|
||||
| Pre-amendment functionality retired? | No |
|
||||
|
||||
@@ -301,8 +301,8 @@ Adds to the ledger Decentralized Identifier (DID) functionality that conforms to
|
||||
|
||||
Adds new transactions:
|
||||
|
||||
- DIDDelete - Delete the DID associated with your XRPL account.
|
||||
- DIDSet - Create a new DID or update an existing one.
|
||||
- [DIDDelete](../docs/references/protocol/transactions/types/diddelete.md) - Delete the DID associated with your XRPL account.
|
||||
- [DIDSet](../docs/references/protocol/transactions/types/didset.md) - Create a new DID or update an existing one.
|
||||
|
||||
Adds a new `DID` ledger entry type.
|
||||
|
||||
|
||||
BIN
static/img/events/new-york.jpeg
Normal file
BIN
static/img/events/new-york.jpeg
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 3.9 MiB |
Reference in New Issue
Block a user