Merge pull request #2925 from tequdev/ja-mpt

[JA] MPToken

Author: mDuo13

@l10n/ja/docs/_snippets/mpts-disclaimer.md

@@ -0,0 +1,3 @@
+{% admonition type="info" name="注意" %}
+Multi-Purpose Token機能は、XRP LedgerプロトコルへのXLS-33d拡張機能の一部として提案されています。 現時点では、テストネットワーク上でこれらの機能を使用することができます。 安定版リリースでAmendment有効化されるまででは、これらのページに記載されている詳細内容は変更される可能性があります。
+{% /admonition %}

@l10n/ja/docs/concepts/tokens/fungible-tokens/multi-purpose-tokens.md

@@ -0,0 +1,54 @@
+---
+blurb: Multi-Purpose Tokenは、トラストラインよりもコンパクトで柔軟なトークンタイプです。
+labels:
+  - トークン
+  - MPT
+  - Multi-Purpose Token
+status: not_enabled
+---
+# Multi-Purpose Token
+
+{% partial file="/@l10n/ja/docs/_snippets/mpts-disclaimer.md" /%}
+
+Multi-Purpose Token(MPT)は、トラストラインよりもコンパクトで柔軟なトークンタイプです。
+
+MPTを使用することで、数行のコードですぐに使えるトークン化機能を利用できます。1つのトークンプログラムから多くのトークンを作成することができます。以下のような特徴があります。
+
+- MPTはメタデータをXRPLブロックチェーンに直接保存します。
+- 1024バイトのURIフィールドがメタデータへのポインタを提供し、オンチェーンソースに加えてオフチェーンソースをメタデータに使用することができます。これにより、アプリケーションはチェーンから必要な情報に直接アクセスできるようになり、追加情報を追加する機能を失うことなく、トークンの相互運用性を高めることができます。
+- MPT は、発行可能なトークン数の上限を設定することで、トークンの供給量を固定することができます。
+- MPT を転送不可トークンと定義することもできます。この場合、トークンは発行者にのみ転送することができ、トークン保有者の間では転送できません。航空会社のクレジットを発行したり、ロイヤリティ報酬を発行したりする場合に便利です。
+- 発行者は、トークン保有者間でトークンが取引されるたびにオンチェーン収益を得るために送金手数料を設定することができます。
+- MPTには高度なコンプライアンス機能もあります。
+    - トークン保有者が保有するトークンをロックし、コンプライアンス要件をサポートする機能。
+    - すべてのトークン保有者のすべてのMPT残高に対してグローバルロックを設定する機能。
+    - 発行者は、トークン保有者のウォレットからMPTをクローバックできるように設定することができ、MPTを失効させたり、ウォレットキーを紛失した場合に再割り当てしたりすることができます。
+    - オプトイン機能として、発行者が許可したウォレットにのみ発行されたトークンを保持させることができます。
+
+## MPTとトラストラインの比較
+
+トラストラインと異なり、MPTは双方向の債務関係を表すものではありません。代わりに、MPTは一方向のトラストラインのように機能し、1つの残高のみを持ちます。これにより、オンラインゲームでの評価ポイントの追跡など、非金融的なユースケースを含む一般的なトークン化要件をサポートするためのオーバーヘッドが削減されます。
+
+MPTはトラストラインよりも単純な概念モデルを提供します。
+
+MPTはトラストラインよりも必要とするスペースは大幅に少なくなっています。トークン保有者が保有する各MPTに約52バイトが必要なのに対し、新しいトラストラインには少なくとも234バイトが必要です。
+
+これにより、ノード運営者の長期的なインフラストラクチャとストレージの負担が軽減され、ネットワークの回復力が向上します。
+
+また、MPTは大量のトランザクションを処理する際のノードのパフォーマンスも向上させます。
+
+MPTは一方向です。トラストラインが「残高相殺」を使用するのに対し、MPTは単一の残高のみを持ちます。
+
+アカウントは最大32の固有のMPT発行が可能です。発行者がこれ以上のMPTをサポートしたい場合は、追加のアカウントを作成することで対応できます。
+
+トークン保有者はレジャー外での信頼決定を最初に行わずにMPTを取得することはないため、MPTには信用の限度(trust limit)がありません。例えば、MPTの一般的なユースケースである法定通貨担保型ステーブルコインでは、トークン保有者は保有して安心できる量以上のステーブルコインを購入することはありません。
+
+既存の機能の一部とは異なり、MPTはリップリング(Rippling)の対象ではなく、その機能に関連する設定も必要ありません。
+
+## MPTとIOUの比較
+
+技術的なレベルでは、MPTはレジャー上で代替可能トークンを表現する根本的に異なる方法を提供します。IOUがトラストラインで表現され、双方向の債務関係を持つのに対し、MPTはMPTokenオブジェクトで捕捉されるよりシンプルな一方向の関係を使用します。これにより、レジャー上のスペースの大幅な節約が実現されます。トラストラインではなくトークンオブジェクトとして代替可能トークンを表現することで、トークンレベルのメタデータ、固定供給量、固定小数点残高など、実世界の金融資産のための機能をオンチェーンで実現しやすくなります。
+
+実際の利用レベルでは、MPTはトラストラインやリップリングと比較してより分かりやすい概念モデルを提供します。開発者はXLS-20 NFTの概念モデルと類似点を持つ`MPToken`および`MPTokenIssuance`オブジェクトを中心にWeb3アプリケーションを構築しやすくなります。また、一般ユーザにとっても、利用可能なトークン、発行したトークン、ウォレット内の保有トークンを理解しやすくなります。MPTの発行者と保有者の両方にとって、IOUトラストラインによる同等の表現と比較して、通常XRPの準備金が少なくて済みます。
+
+MPTはIOUを補完することを意図しています。MPTまたはIOUのいずれかが適しているユースケースもありますが、長期的には両方が必要となる可能性が高いでしょう。貸借のための与信枠など、長期的にIOUでより適切に表現できる使用例もあるでしょう。MPT機能では、まず一般的なユースケースを実現し、その後追加の機能サポートを提供する形で段階的に進化すべきです。MPTの開発期間中、一部のケースではIOUでの表現が適している場合もありますが、後にMPTでより適切にサポートされる可能性があります。

@l10n/ja/docs/references/http-websocket-apis/public-api-methods/ledger-methods/ledger_entry.md

@@ -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`パラメータは非推奨であり、予告なく削除される可能性があります。
 
@@ -39,13 +40,16 @@ label:
     - [Bridgeオブジェクトを取得する](#bridgeオブジェクトを取得する)
     - [Directorynodeオブジェクトを取得する](#directorynodeオブジェクトを取得する)
     - [Offerオブジェクトを取得する](#offerオブジェクトを取得する)
+    - [Oracleオブジェクトを取得する](#oracleオブジェクトを取得する)
     - [RippleStateオブジェクトを取得する](#ripplestateオブジェクトを取得する)
     - [Checkオブジェクトを取得する](#checkオブジェクトを取得する)
     - [Escrowオブジェクトを取得する](#escrowオブジェクトを取得する)
     - [Paychannelオブジェクトを取得する](#paychannelオブジェクトを取得する)
     - [DepositPreauthオブジェクトを取得する](#depositpreauthオブジェクトを取得する)
     - [Ticketオブジェクトを取得する](#ticketオブジェクトを取得する)
     - [Nft Pageを取得する](#nft-pageを取得する)
+    - [MPT Issuanceオブジェクトを取得する](#mpt-issuanceオブジェクトを取得する)
+    - [MPTokenオブジェクトを取得する](#mptokenオブジェクトを取得する)
   - [レスポンスのフォーマット](#レスポンスのフォーマット)
   - [考えられるエラー](#考えられるエラー)
 
@@ -400,6 +404,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オブジェクトを取得する
@@ -750,18 +808,120 @@ 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進数で表したもの。 |
+| `index`        | 文字列           | [レジャーエントリ](../../../protocol/ledger-data/ledger-entry-types/index.md)の一意のID。 |
+| `ledger_index` | 正の整数 | このデータを取得するために使用されたレジャーの[レジャーインデックス][]。 |
+| `node`         | オブジェクト           | _(`"binary": true`の場合省略)_ このレジャーエントリのデータ。[レジャーのフォーマット][]に従っています。 |
+| `node_binary`  | 文字列           | _(`"binary": true`の場合省略)_ レジャーオブジェクトの[バイナリフォーマット](../../../protocol/binary-format.md)。 |
+| `deleted_ledger_index` | String | _(Clioサーバのみ, `include_deleted`パラメータが設定されている場合のみ)_ レジャーエントリオブジェクトが削除された[レジャーインデックス][]。 |
 
-処理が成功したレスポンスの例:
+成功したレスポンスの例:
 
 {% tabs %}
 
@@ -831,7 +991,7 @@ rippled json ledger_entry '{ "nft_page": "255DD86DDF59D778081A06D02701E9B2C9F4F0
 ```
 {% /tab %}
 
-{% tab label="コマンドライン" %}
+{% tab label="Commandline" %}
 ```json
 {
   "result": {