Skip to content

Commit fc5e9e1

Browse files
tequdevtequdev
committed
[JA] translate MPToken contents
1 parent b38a8f1 commit fc5e9e1

File tree

14 files changed

+842
-5
lines changed

14 files changed

+842
-5
lines changed

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

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

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

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

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

Lines changed: 257 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,7 @@ label:
2525
| `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 %} |
2626
| `ledger_hash` | 文字列 | _（省略可）_ 使用するレジャーバージョンの20バイトの16進数の文字列。（[レジャーの指定][]をご覧ください。 |
2727
| `ledger_index` | 文字列 または 符号なし整数 | _（省略可）_ 使用するレジャーの[レジャーインデックス][]、またはレジャーを自動的に選択するためのショートカット文字列("validated"や"closed"、"current"など)。（[レジャーの指定][]をご覧ください。 |
28+
| `include_deleted` | 真偽値 | _(省略可, Clioサーバのみ)_ クエリされたオブジェクトが削除されている場合、その完全なデータを削除前の状態で返します。`false`または提供されていない場合、クエリされたオブジェクトが削除されている場合は`objectNotFound`を返します。 |
2829

2930
`generator`と`ledger`パラメータは非推奨であり、予告なく削除される可能性があります。
3031

@@ -39,13 +40,16 @@ label:
3940
- [Bridgeオブジェクトを取得する](#bridgeオブジェクトを取得する)
4041
- [Directorynodeオブジェクトを取得する](#directorynodeオブジェクトを取得する)
4142
- [Offerオブジェクトを取得する](#offerオブジェクトを取得する)
43+
- [Oracleオブジェクトを取得する](#oracleオブジェクトを取得する)
4244
- [RippleStateオブジェクトを取得する](#ripplestateオブジェクトを取得する)
4345
- [Checkオブジェクトを取得する](#checkオブジェクトを取得する)
4446
- [Escrowオブジェクトを取得する](#escrowオブジェクトを取得する)
4547
- [Paychannelオブジェクトを取得する](#paychannelオブジェクトを取得する)
4648
- [DepositPreauthオブジェクトを取得する](#depositpreauthオブジェクトを取得する)
4749
- [Ticketオブジェクトを取得する](#ticketオブジェクトを取得する)
4850
- [Nft Pageを取得する](#nft-pageを取得する)
51+
- [MPT Issuanceオブジェクトを取得する](#mpt-issuanceオブジェクトを取得する)
52+
- [MPTokenオブジェクトを取得する](#mptokenオブジェクトを取得する)
4953
- [レスポンスのフォーマット](#レスポンスのフォーマット)
5054
- [考えられるエラー](#考えられるエラー)
5155

@@ -400,6 +404,60 @@ rippled json ledger_entry '{ "offer": { "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJY
400404

401405
[試してみる >](/resources/dev-tools/websocket-api-tool#ledger_entry-offer)
402406

407+
### Oracleオブジェクトを取得する
408+
409+
_([PriceOracle amendment][]が必要です)_
410+
411+
[Oracleエントリ](../../../protocol/ledger-data/ledger-entry-types/oracle.md)を取得します。これは、トークン価格を保存できる単一の価格オラクルを表します。
412+
413+
| フィールド | 型 | 必須? | 説明 |
414+
|-----------------------------|----------------------|-------|------|
415+
| `oracle` | Object | はい | オラクルの識別子。 |
416+
| `oracle.account` | String - [Address][] | はい | `Oracle`オブジェクトを制御するアカウント。 |
417+
| `oracle.oracle_document_id` | Number | はい | `Account`のオラクルの一意の識別子。 |
418+
419+
{% tabs %}
420+
421+
{% tab label="WebSocket" %}
422+
```json
423+
{
424+
"id": "example_get_oracle",
425+
"command": "ledger_entry",
426+
"oracle" : {
427+
"account": "rNZ9m6AP9K7z3EVg6GhPMx36V4QmZKeWds",
428+
"oracle_document_id": 34
429+
},
430+
"ledger_index": "validated"
431+
}
432+
```
433+
{% /tab %}
434+
435+
{% tab label="JSON-RPC" %}
436+
```json
437+
{
438+
"method": "ledger_entry",
439+
"params" : [
440+
{
441+
"oracle" : {
442+
"account": "rNZ9m6AP9K7z3EVg6GhPMx36V4QmZKeWds",
443+
"oracle_document_id": 34
444+
},
445+
"ledger_index": "validated"
446+
}
447+
]
448+
}
449+
```
450+
{% /tab %}
451+
452+
{% tab label="Commandline" %}
453+
```sh
454+
rippled json ledger_entry '{ "oracle": { "account": "rNZ9m6AP9K7z3EVg6GhPMx36V4QmZKeWds", "oracle_document_id": 34 }, "ledger_index": "validated" }'
455+
```
456+
{% /tab %}
457+
458+
{% /tabs %}
459+
460+
[試してみる >](/resources/dev-tools/websocket-api-tool?server=wss%3A%2F%2Fs.devnet.rippletest.net%3A51233%2F#ledger_entry-oracle)
403461

404462

405463
### RippleStateオブジェクトを取得する
@@ -865,6 +923,205 @@ rippled json ledger_entry '{ "nft_page": "255DD86DDF59D778081A06D02701E9B2C9F4F0
865923
{% /tabs %}
866924

867925

926+
### MPT Issuanceオブジェクトを取得する
927+
928+
`MPTokenIssuance`オブジェクトを返します。
929+
930+
| フィールド | 型 | 説明 |
931+
|:------------------------|:-------|:---------------|
932+
| `mpt_issuance` | 文字列 | 192ビットの`MPTokenIssuanceID`。 |
933+
934+
<!-- MULTICODE_BLOCK_START -->
935+
936+
*WebSocket*
937+
938+
```json
939+
{
940+
"id": "example_get_mpt_issuance",
941+
"command": "ledger_entry",
942+
"mpt_issuance": "000004C463C52827307480341125DA0577DEFC38405B0E3E",
943+
"ledger_index": "validated"
944+
}
945+
```
946+
947+
*JSON-RPC*
948+
949+
```json
950+
{
951+
"method": "ledger_entry",
952+
"params": [{
953+
"mpt_issuance": "000004C463C52827307480341125DA0577DEFC38405B0E3E",
954+
"ledger_index": "validated"
955+
}]
956+
}
957+
```
958+
*Commandline*
959+
960+
```sh
961+
rippled json ledger_entry '{ "mpt_issuance": "000004C463C52827307480341125DA0577DEFC38405B0E3E", "ledger_index": "validated" }'
962+
```
963+
### MPTokenオブジェクトを取得する
964+
965+
`MPToken`オブジェクトを返します。
966+
967+
| フィールド | 型 | 説明 |
968+
|:------------------------|:-------------------------|:----------------------|
969+
| `mptoken` | オブジェクトまたは文字列 | 文字列の場合、取得するMPTokenのレジャーエントリIDとして解釈します。オブジェクトの場合、`MPToken`を一意に識別するために、`account`と`mpt_issuance_id`のサブフィールドが必要です。 |
970+
| mptoken.mpt_issuance_id | 文字列 | (`MPToken`がオブジェクトの場合必須) MPTokenIssuanceに紐づく192ビットのMPTokenIssuanceID。 |
971+
| mptoken.account ️ | 文字列 | (`MPToken`がオブジェクトの場合必須) MPTokenの所有者のアカウント。 |
972+
973+
<!-- MULTICODE_BLOCK_START -->
974+
975+
*WebSocket*
976+
977+
```json
978+
{
979+
"id": "example_get_mpt_issuance",
980+
"command": "ledger_entry",
981+
"mpt_issuance_id": "000002DFA4D893CFBC4DC6AE877EB585F90A3B47528B958D",
982+
"account":"r33kves44ksufkHSGg3M6GPPAsoVHEN8C1"
983+
}
984+
```
985+
986+
*JSON-RPC*
987+
988+
```json
989+
{
990+
"method": "ledger_entry",
991+
"params": [
992+
{
993+
"mptoken":{
994+
"mpt_issuance_id": "000002DFA4D893CFBC4DC6AE877EB585F90A3B47528B958D",
995+
"account":"r33kves44ksufkHSGg3M6GPPAsoVHEN8C1"
996+
}
997+
}
998+
]
999+
}
1000+
```
1001+
*Commandline*
1002+
1003+
```sh
1004+
rippled json ledger_entry '{ "mpt_issuance_id": "000002DFA4D893CFBC4DC6AE877EB585F90A3B47528B958D", "account":"r33kves44ksufkHSGg3M6GPPAsoVHEN8C1"}'
1005+
```
1006+
<!-- MULTICODE_BLOCK_END -->
1007+
1008+
[試してみる! >](/resources/dev-tools/websocket-api-tool#ledger_entry-mpt_issuance)
1009+
1010+
## レスポンスフォーマット
1011+
1012+
レスポンスは[標準フォーマット][]に従い、成功した結果には次のフィールドが含まれます。
1013+
1014+
| フィールド | 型 | 説明 |
1015+
|:---------------|:-----------------|:-----------------------------------------|
1016+
| `index` | 文字列 | [レジャーエントリ](../../../protocol/ledger-data/ledger-entry-types/index.md)の一意のID。 |
1017+
| `ledger_index` | 正の整数 | このデータを取得するために使用されたレジャーの[レジャーインデックス](../../../protocol/data-types/basic-data-types.md#ledger-index)。 |
1018+
| `node` | オブジェクト | _(`"binary": true`の場合省略)_ このレジャーエントリのデータ。[レジャーのフォーマット](../../../protocol/ledger-data/ledger-entry-types/index.md)に従っています。 |
1019+
| `node_binary` | 文字列 | _(`"binary": true`の場合省略)_ レジャーオブジェクトの[バイナリフォーマっt](../../../protocol/binary-format.md)。 |
1020+
1021+
成功したレスポンスの例:
1022+
1023+
<!-- MULTICODE_BLOCK_START -->
1024+
1025+
*WebSocket*
1026+
1027+
```json
1028+
{
1029+
"id": "example_get_accountroot",
1030+
"result": {
1031+
"index": "13F1A95D7AAB7108D5CE7EEAF504B2894B8C674E6D68499076441C4837282BF8",
1032+
"ledger_hash": "31850E8E48E76D1064651DF39DF4E9542E8C90A9A9B629F4DE339EB3FA74F726",
1033+
"ledger_index": 61966146,
1034+
"node": {
1035+
"Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
1036+
"AccountTxnID": "4E0AA11CBDD1760DE95B68DF2ABBE75C9698CEB548BEA9789053FCB3EBD444FB",
1037+
"Balance": "424021949",
1038+
"Domain": "6D64756F31332E636F6D",
1039+
"EmailHash": "98B4375E1D753E5B91627516F6D70977",
1040+
"Flags": 9568256,
1041+
"LedgerEntryType": "AccountRoot",
1042+
"MessageKey": "0000000000000000000000070000000300",
1043+
"OwnerCount": 12,
1044+
"PreviousTxnID": "4E0AA11CBDD1760DE95B68DF2ABBE75C9698CEB548BEA9789053FCB3EBD444FB",
1045+
"PreviousTxnLgrSeq": 61965653,
1046+
"RegularKey": "rD9iJmieYHn8jTtPjwwkW2Wm9sVDvPXLoJ",
1047+
"Sequence": 385,
1048+
"TransferRate": 4294967295,
1049+
"index": "13F1A95D7AAB7108D5CE7EEAF504B2894B8C674E6D68499076441C4837282BF8"
1050+
},
1051+
"validated": true
1052+
},
1053+
"status": "success",
1054+
"type": "response"
1055+
}
1056+
```
1057+
1058+
*JSON-RPC*
1059+
1060+
```json
1061+
200 OK
1062+
1063+
{
1064+
"result": {
1065+
"index": "13F1A95D7AAB7108D5CE7EEAF504B2894B8C674E6D68499076441C4837282BF8",
1066+
"ledger_hash": "395946243EA36C5092AE58AF729D2875F659812409810A63096AC006C73E656E",
1067+
"ledger_index": 61966165,
1068+
"node": {
1069+
"Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
1070+
"AccountTxnID": "4E0AA11CBDD1760DE95B68DF2ABBE75C9698CEB548BEA9789053FCB3EBD444FB",
1071+
"Balance": "424021949",
1072+
"Domain": "6D64756F31332E636F6D",
1073+
"EmailHash": "98B4375E1D753E5B91627516F6D70977",
1074+
"Flags": 9568256,
1075+
"LedgerEntryType": "AccountRoot",
1076+
"MessageKey": "0000000000000000000000070000000300",
1077+
"OwnerCount": 12,
1078+
"PreviousTxnID": "4E0AA11CBDD1760DE95B68DF2ABBE75C9698CEB548BEA9789053FCB3EBD444FB",
1079+
"PreviousTxnLgrSeq": 61965653,
1080+
"RegularKey": "rD9iJmieYHn8jTtPjwwkW2Wm9sVDvPXLoJ",
1081+
"Sequence": 385,
1082+
"TransferRate": 4294967295,
1083+
"index": "13F1A95D7AAB7108D5CE7EEAF504B2894B8C674E6D68499076441C4837282BF8"
1084+
},
1085+
"status": "success",
1086+
"validated": true
1087+
}
1088+
}
1089+
```
1090+
1091+
*Commandline*
1092+
1093+
```json
1094+
{
1095+
"result": {
1096+
"index": "13F1A95D7AAB7108D5CE7EEAF504B2894B8C674E6D68499076441C4837282BF8",
1097+
"ledger_hash": "395946243EA36C5092AE58AF729D2875F659812409810A63096AC006C73E656E",
1098+
"ledger_index": 61966165,
1099+
"node": {
1100+
"Account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
1101+
"AccountTxnID": "4E0AA11CBDD1760DE95B68DF2ABBE75C9698CEB548BEA9789053FCB3EBD444FB",
1102+
"Balance": "424021949",
1103+
"Domain": "6D64756F31332E636F6D",
1104+
"EmailHash": "98B4375E1D753E5B91627516F6D70977",
1105+
"Flags": 9568256,
1106+
"LedgerEntryType": "AccountRoot",
1107+
"MessageKey": "0000000000000000000000070000000300",
1108+
"OwnerCount": 12,
1109+
"PreviousTxnID": "4E0AA11CBDD1760DE95B68DF2ABBE75C9698CEB548BEA9789053FCB3EBD444FB",
1110+
"PreviousTxnLgrSeq": 61965653,
1111+
"RegularKey": "rD9iJmieYHn8jTtPjwwkW2Wm9sVDvPXLoJ",
1112+
"Sequence": 385,
1113+
"TransferRate": 4294967295,
1114+
"index": "13F1A95D7AAB7108D5CE7EEAF504B2894B8C674E6D68499076441C4837282BF8"
1115+
},
1116+
"status": "success",
1117+
"validated": true
1118+
}
1119+
}
1120+
```
1121+
1122+
<!-- MULTICODE_BLOCK_END -->
1123+
1124+
8681125
## 考えられるエラー
8691126

8701127
* いずれかの[汎用エラータイプ][]。

0 commit comments

Comments
 (0)