mirror of
https://github.com/XRPLF/xrpl-dev-portal.git
synced 2025-12-03 01:55:51 +00:00
Merge remote-tracking branch 'upstream/master' into ja-credentials
This commit is contained in:
3
@l10n/ja/docs/_snippets/mpts-disclaimer.md
Normal file
3
@l10n/ja/docs/_snippets/mpts-disclaimer.md
Normal file
@@ -0,0 +1,3 @@
|
||||
{% admonition type="info" name="注意" %}
|
||||
Multi-Purpose Token機能は、XRP LedgerプロトコルへのXLS-33d拡張機能の一部として提案されています。 現時点では、テストネットワーク上でこれらの機能を使用することができます。 安定版リリースでAmendment有効化されるまででは、これらのページに記載されている詳細内容は変更される可能性があります。
|
||||
{% /admonition %}
|
||||
@@ -107,7 +107,7 @@ XRP Ledgerで使用できるように、`rippled`サーバをピアツーピア
|
||||
<tr><th>検出されたピア</th>
|
||||
<td><ul>
|
||||
<li><p>最もシンプルな構成。メンテナンスの負担が抑えられます。</p></li>
|
||||
<li><p>ダイレクトピア接続の機会が多数得られます。ダイレクトピア接続には、いくつかのメリットがあります。サーバは、複数のピアから並行して<a href="ledger-history.html#履歴の取得">履歴を取得</a>できます。同期時と履歴の埋め戻し時のいずれも可能です。履歴は、すべてのピアで完全に保持されているわけではないため、アクセスするピアを増やすことで、幅広い履歴データにアクセスすることもできます。</p></li>
|
||||
<li><p>ダイレクトピア接続の機会が多数得られます。ダイレクトピア接続には、いくつかのメリットがあります。サーバは、複数のピアから並行して<a href="ledger-history#履歴の取得">履歴を取得</a>できます。同期時と履歴の埋め戻し時のいずれも可能です。履歴は、すべてのピアで完全に保持されているわけではないため、アクセスするピアを増やすことで、幅広い履歴データにアクセスすることもできます。</p></li>
|
||||
<li><p>切断されたピアを新しいピアに置き換えることができるため、サーバがネットワークから切断される可能性を抑えることができます。</p></li>
|
||||
</ul></td>
|
||||
<td><ul>
|
||||
@@ -119,8 +119,8 @@ XRP Ledgerで使用できるように、`rippled`サーバをピアツーピア
|
||||
<td><ul>
|
||||
<li><p>最も安全で信頼できる構成(効率的に実装された場合)。</p></li>
|
||||
<li><p>信頼性と冗長性を実現します。</p></li>
|
||||
<li><p><a href="clustering.html">クラスタリング</a>によって、プライベートサーバのパフォーマンスを最適化できます。</p></li>
|
||||
<li><p>必要な数のダイレクトピア接続を作成できます。プライベートサーバでは、複数のピアから並行して<a href="ledger-history.html#履歴の取得">履歴を取得</a>できます。複数のピアを実行するため、各ピアで保持するレジャー履歴の量も制御します。</p></li>
|
||||
<li><p><a href="clustering">クラスタリング</a>によって、プライベートサーバのパフォーマンスを最適化できます。</p></li>
|
||||
<li><p>必要な数のダイレクトピア接続を作成できます。プライベートサーバでは、複数のピアから並行して<a href="ledger-history#履歴の取得">履歴を取得</a>できます。複数のピアを実行するため、各ピアで保持するレジャー履歴の量も制御します。</p></li>
|
||||
</ul></td>
|
||||
<td><ul>
|
||||
<li><p>複数のサーバを実行することで、メンテナンスの負担とコストは高くなります。</p></li>
|
||||
|
||||
@@ -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でより適切にサポートされる可能性があります。
|
||||
@@ -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": {
|
||||
|
||||
@@ -0,0 +1,160 @@
|
||||
---
|
||||
blurb: 指定された`MPTokenIssuanceID`とledgerシーケンスに対する所有者の情報を取得します。
|
||||
labels:
|
||||
- アカウント
|
||||
- XRP
|
||||
---
|
||||
|
||||
# mpt_holders
|
||||
|
||||
{% partial file="/@l10n/ja/docs/_snippets/mpts-disclaimer.md" /%}
|
||||
|
||||
指定された`MPTokenIssuanceID`とレジャーシーケンスに対して、`mpt_holders`はそのMPTの全所有者とその残高を返します。このメソッドは非常に大きなデータセットを返す可能性があるため、`marker`フィールドを使用したページングの実装が必要になると考えられます。このAPIはClioでのみ利用可能で、rippledでは利用できません。
|
||||
|
||||
## リクエストのフォーマット
|
||||
|
||||
*Websocket*
|
||||
|
||||
```json
|
||||
{
|
||||
"command": "mpt_holders",
|
||||
"mpt_issuance_id": "00070C4495F14B0E44F78A264E41713C64B5F89242540EE255534400000000000000",
|
||||
"ledger_index": "validated"
|
||||
}
|
||||
```
|
||||
|
||||
*JSON-RPC*
|
||||
|
||||
```json
|
||||
{
|
||||
"method": "mpt_holders",
|
||||
"params": [
|
||||
{
|
||||
"mpt_issuance_id": "00070C4495F14B0E44F78A264E41713C64B5F89242540EE255534400000000000000",
|
||||
"ledger_index": "validated"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
リクエストには以下のパラメータが含まれます。
|
||||
|
||||
| フィールド | 型 | 必須? | 説明 |
|
||||
|:------------------|:----------------------|:----------|-------------|
|
||||
| `mpt_issuance_id` | 文字列 | はい | クエリ対象の`MPTokenIssuance`。 |
|
||||
| `ledger_index` | 文字列または数値(正の整数) | いいえ | 使用する最大のレジャーインデックス、または自動的にレジャーを選択するためのショートカット文字列。ledger_indexまたはledger_hashのいずれかを指定する必要があります。 |
|
||||
| `ledger_hash` | 文字列 | いいえ | 使用する32バイトのレジャーハッシュ。ledger_indexまたはledger_hashのいずれかを指定する必要があります。 |
|
||||
| `marker` | 文字列 | いいえ | ページングで中断したクエリを続けるために使用します。 |
|
||||
| `limit` | 数値(正の整数) | いいえ | 返されるMPTの数の制限を指定します。 |
|
||||
|
||||
## レスポンスのフォーマット
|
||||
|
||||
```json
|
||||
{
|
||||
"mpt_issuance_id": "000004C463C52827307480341125DA0577DEFC38405B0E3E",
|
||||
"limit":50,
|
||||
"ledger_index": 2,
|
||||
"mptokens": [{
|
||||
"account": "rEiNkzogdHEzUxPfsri5XSMqtXUixf2Yx",
|
||||
"flags": 0,
|
||||
"mpt_amount": "20",
|
||||
"mptoken_index": "36D91DEE5EFE4A93119A8B84C944A528F2B444329F3846E49FE921040DE17E65"
|
||||
},
|
||||
{
|
||||
"account": "rrnAZCqMahreZrKMcZU3t2DZ6yUndT4ubN",
|
||||
"flags": 0,
|
||||
"mpt_amount": "1",
|
||||
"mptoken_index": "D137F2E5A5767A06CB7A8F060ADE442A30CFF95028E1AF4B8767E3A56877205A"
|
||||
}],
|
||||
"validated": true
|
||||
}
|
||||
```
|
||||
|
||||
### レスポンスのフィールド
|
||||
|
||||
レスポンスは[標準フォーマット][]に従い、結果に以下のフィールドが含まれます。
|
||||
|
||||
| フィールド | 型 | 説明 |
|
||||
|:--------------------|:--------|:----------------------------------------|
|
||||
| `mpt_issuance_id` | 文字列 | クエリされた`MPTokenIssuance` |
|
||||
| `mptokens` | 配列 | mptokenの配列。基礎となるMPTokenオブジェクトの全ての関連フィールドを含みます。 |
|
||||
| `marker` | 文字列 | ページング時に次のクエリを続けるために使用します。この結果の後にエントリがない場合は省略されます。 |
|
||||
| `limit` | 数値 | リクエストで指定された制限値 |
|
||||
| `ledger_index` | 数値 | 使用されたレジャーインデックス。 |
|
||||
|
||||
`mptoken`オブジェクトには以下のパラメータがあります。
|
||||
|
||||
| フィールド | 型 | 説明 |
|
||||
|:--------------------|:--------|:----------------------------------------|
|
||||
| `account` | 文字列 | `MPToken`を所有するホルダーのアカウントアドレス。 |
|
||||
| `flags` | 数値 | `MPToken`オブジェクトに割り当てられたフラグ。 |
|
||||
| `mpt_amount` | 文字列 | ホルダーの残高を10進数でエンコードした量。 |
|
||||
| `mptoken_index` | 文字列 | `MPToken`オブジェクトのキー。 |
|
||||
|
||||
##### 例
|
||||
|
||||
`tx`レスポンスの例:
|
||||
|
||||
```json
|
||||
{
|
||||
"result": {
|
||||
"Account": "rBT9cUqK6UvpvZhPFNQ2qpUTin8rDokBeL",
|
||||
"AssetScale": 2,
|
||||
"Fee": "10",
|
||||
"Flags": 64,
|
||||
"Sequence": 303,
|
||||
"SigningPubKey": "ED39955DEA2D083C6CBE459951A0A84DB337925389ACA057645EE6E6BA99D4B2AE",
|
||||
"TransactionType": "MPTokenIssuanceCreate",
|
||||
"TxnSignature": "80D7B7409980BE9854F7217BB8E836C8A2A191E766F24B5EF2EA7609E1420AABE6A1FDB3038468679081A45563B4D0B49C08F4F70F64E41B578F288A208E4206",
|
||||
"ctid": "C000013100000000",
|
||||
"date": 760643692,
|
||||
"hash": "E563D7942E3E4A79AD73EC12E9E4C44B7C9950DF7BF5FDB75FAD0F5CE0554DB3",
|
||||
"inLedger": 305,
|
||||
"ledger_index": 305,
|
||||
"meta": {
|
||||
"AffectedNodes": [...],
|
||||
"TransactionIndex": 0,
|
||||
"TransactionResult": "tesSUCCESS",
|
||||
"mpt_issuance_id": "0000012F72A341F09A988CDAEA4FF5BE31F25B402C550ABE"
|
||||
},
|
||||
"status": "success",
|
||||
"validated": true
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
##### オブジェクト
|
||||
|
||||
`mpt_issuance_id`フィールドはJSON MPTokenIssuanceオブジェクトで提供されます(バイナリでは利用できません)。次ののAPIが影響を受けます、`ledger_data`および`account_objects`。
|
||||
|
||||
|
||||
##### 例
|
||||
|
||||
`account_objects`のレスポンス例
|
||||
|
||||
```json
|
||||
{
|
||||
"result": {
|
||||
"account": "rBT9cUqK6UvpvZhPFNQ2qpUTin8rDokBeL",
|
||||
"account_objects": [
|
||||
{
|
||||
"AssetScale": 2,
|
||||
"Flags": 64,
|
||||
"Issuer": "rBT9cUqK6UvpvZhPFNQ2qpUTin8rDokBeL",
|
||||
"LedgerEntryType": "MPTokenIssuance",
|
||||
"OutstandingAmount": "100",
|
||||
"OwnerNode": "0",
|
||||
"PreviousTxnID": "BDC5ECA6B115C74BF4DA83E36325A2F55DF9E2C968A5CC15EB4D009D87D5C7CA",
|
||||
"PreviousTxnLgrSeq": 308,
|
||||
"Sequence": 303,
|
||||
"index": "75EC6F2939ED6C5798A5F369A0221BC4F6DDC50F8614ECF72E3B976351057A63",
|
||||
"mpt_issuance_id": "0000012F72A341F09A988CDAEA4FF5BE31F25B402C550ABE"
|
||||
}
|
||||
],
|
||||
"ledger_current_index": 309,
|
||||
"status": "success",
|
||||
"validated": false
|
||||
}
|
||||
}
|
||||
```
|
||||
@@ -0,0 +1,60 @@
|
||||
---
|
||||
blurb: XRPLのMulti-Purpose Tokenのオブジェクトについて説明します。
|
||||
labels:
|
||||
- Multi-Purpose Token, MPT, トークン
|
||||
---
|
||||
# MPToken
|
||||
|
||||
{% partial file="/@l10n/ja/docs/_snippets/mpts-disclaimer.md" /%}
|
||||
|
||||
`MPTokenIssuanceID`.`MPToken`オブジェクトは、トークン発行者ではないアカウントが保有する複数のトークンを表します。MPTは通常の支払いやDEXトランザクションを通じて取得され、これらと同じタイプのトランザクションを使用してオプションで償還または交換することができます。MPTokenのオブジェクトキーは、スペースキー、保有者のアドレス、および`MPTokenIssuanceID`をハッシュ化することで生成されます。
|
||||
|
||||
_([MPTokensV1_1 amendment][]により追加されました。)_
|
||||
|
||||
## MPToken JSONの例
|
||||
|
||||
```json
|
||||
{
|
||||
"LedgerEntryType": "MPToken",
|
||||
"Account": "rajgkBmMxmz161r8bWYH7CQAFZP5bA9oSG",
|
||||
"MPTokenIssuanceID": "000004C463C52827307480341125DA0577DEFC38405B0E3E",
|
||||
"Flags": 0,
|
||||
"MPTAmount": "100000000",
|
||||
"OwnerNode": "1"
|
||||
}
|
||||
```
|
||||
|
||||
## MPTokenID
|
||||
|
||||
`MPTokenID`は、以下の値を順番に連結してSHA512-Halfを実行した結果です。
|
||||
|
||||
- `MPToken`スペースキー(0x0074)
|
||||
- トークンの`MPTokenIssuanceID`
|
||||
- トークン保有者の`AccountID`
|
||||
|
||||
## MPTokenのフィールド
|
||||
|
||||
`MPToken`オブジェクトには以下のフィールドがあります。
|
||||
|
||||
| フィールド名 | JSONの型 | 内部の型 | 説明 |
|
||||
|:--------------------|:----------|:----------|:------------|
|
||||
| `LedgerEntryType` | 数値 | UInt16 | 値0x007Fは文字列`MPToken`にマッピングされ、このオブジェクトがMPTの個別アカウントの保有を表すことを示します。 |
|
||||
| `Account` | 文字列 | AccountID | MPTの所有者。 |
|
||||
| `MPTokenIssuanceID` | 文字列 | UInt192 | `MPTokenIssuance`の識別子。 |
|
||||
| `MPTAmount` | 文字列 | UInt64 | この値は、所有者が現在保有しているトークンの正の数量を指定します。このフィールドの有効な値は0x0から0x7FFFFFFFFFFFFFFFの間です。 |
|
||||
| `Flags` | 数値 | UInt32 | (デフォルト) [MPTokenのフラグ](#mptokenのフラグ)をご覧ください。 |
|
||||
| `PreviousTxnID` | 文字列 | Hash256 | このオブジェクトを最後に変更したトランザクションのトランザクションID。 |
|
||||
| `PreviousTxnLgrSeq` | 数値 | UInt32 | このオブジェクトを最後に変更したトランザクションを含むレジャーのシーケンス番号。 |
|
||||
| `OwnerNode` | 文字列 | UInt64 | (デフォルト) 所有者のディレクトリでこのアイテムが参照されているページ。 |
|
||||
|
||||
|
||||
### MPTokenのフラグ
|
||||
|
||||
Flagsは`MPToken`オブジェクトに紐付けられたプロパティまたはその他のオプションです。
|
||||
|
||||
| フラグ名 | フラグ値 | 説明 |
|
||||
|:-------------------|:-------------|:--------------------------------------------|
|
||||
| `lsfMPTLocked` | `0x00000001` | 有効な場合、このアカウントが所有するMPTが現在ロックされており、発行者への価値の送信以外のXRPトランザクションで使用できないことを示します |
|
||||
| `lsfMPTAuthorized` | `0x00000002` | (ホワイトリストの場合のみ適用) 設定されている場合、発行者がそのMPTの保有者を承認したことを示します。このフラグは`MPTokenAuthorize`トランザクションを使用して設定できます。また、`tfMPTUnauthorize`フラグを指定した`MPTokenAuthorize`トランザクションを使用して「解除」することもできます。|
|
||||
|
||||
{% raw-partial file="/docs/_snippets/common-links.md" /%}
|
||||
@@ -0,0 +1,82 @@
|
||||
---
|
||||
blurb: Introduction to XRPL MPTs.
|
||||
labels:
|
||||
- Multi-Purpose Token, MPT, トークン
|
||||
---
|
||||
# MPTokenIssuance
|
||||
|
||||
{% partial file="/@l10n/ja/docs/_snippets/mpts-disclaimer.md" /%}
|
||||
|
||||
`MPTokenIssuance`オブジェクトは、単一のMPT Issuanceを表し、Issuance自体に関連するデータを保持します。このIssuanceは`MPTokenIssuanceCreate`トランザクションを使用して作成され、`MPTokenIssuanceDestroy`トランザクションによって破棄することができます。
|
||||
|
||||
_([MPTokensV1_1 amendment][]により追加されました。)_
|
||||
|
||||
## MPTokenIssuance JSONの例
|
||||
|
||||
```json
|
||||
{
|
||||
"name": "US Treasury Bill Token",
|
||||
"symbol": "USTBT",
|
||||
"issuer": "US Treasury",
|
||||
"issueDate": "2024-03-25",
|
||||
"maturityDate": "2025-03-25",
|
||||
"faceValue": 1000,
|
||||
"interestRate": 2.5,
|
||||
"interestFrequency": "Quarterly",
|
||||
"collateral": "US Government",
|
||||
"jurisdiction": "United States",
|
||||
"regulatoryCompliance": "SEC Regulations",
|
||||
"securityType": "Treasury Bill",
|
||||
"external_url": "https://example.com/t-bill-token-metadata.json"
|
||||
}
|
||||
```
|
||||
|
||||
## MPTokenIssuanceID
|
||||
|
||||
`MPTokenIssuance`オブジェクトのキーは、以下の値を順番に連結したものをSHA512-Halfした結果です。
|
||||
|
||||
- `MPTokenIssuance`スペースキー(0x007E)
|
||||
- トランザクションシーケンス番号
|
||||
- 発行者の`AccountID`
|
||||
|
||||
`MPTokenIssuanceID`は192ビットの整数で、以下の順に連結されます:
|
||||
|
||||
- トランザクションシーケンス番号
|
||||
- 発行者のAccountID
|
||||
|
||||
|
||||
## MPTokenIssuanceのフィールド
|
||||
|
||||
`MPTokenIssuance`オブジェクトには以下のフィールドがあります。
|
||||
|
||||
| フィールド名 | JSON型 | 内部型 | 説明 |
|
||||
| :------------------ | :----- | :-------- | ---- |
|
||||
| `LedgerEntryType` | 数値 | UInt16 | 値0x007Eは文字列MPTokenIssuanceにマッピングされ、このオブジェクトがMulti-Purpose Token (MPT)を記述していることを示します。 |
|
||||
| `Flags` | 数値 | UInt32 | [MPTokenIssuanceのフラグ](#mptokenissuanceのフラグ)をご覧ください。 |
|
||||
| `Issuer` | 文字列 | AccountID | 特定の代替可能トークンの発行量とプロパティの両方を制御するアカウントのアドレス。 |
|
||||
| `AssetScale` | 数値 | UInt8 | 標準単位と対応する分数単位との間の桁数の差です。より正確には、AssetScaleは自然数(0、1、2、...)で、1標準単位は対応する分数単位の10^(-scale)に等しくなります。分数単位が標準単位と等しい場合、AssetScaleは0です。 |
|
||||
| `MaximumAmount` | 文字列 | UInt64 | この値は、非発行アカウントに配布できるMPTの最大数(つまり、発行可能な数)を指定する符号なし数値です。未指定の場合、この値は0x7FFFFFFFFFFFFFFFに設定されます。 |
|
||||
| `OutstandingAmount` | 文字列 | UInt64 | すべてのトークン保有者に発行されたトークン量の合計を指定します。この値は、値が0の場合にLedger上で少ないスペースを占めるように、デフォルトタイプとしてLedgerに保存されます。この値は、発行者が非発行者アカウントにMPTを支払うたびに増加し、非発行者が発行アカウントにMPTを支払うたびに減少します。 |
|
||||
| `TransferFee` | 数値 | UInt16 | この値は、トークンの二次販売が許可されている場合に、発行者が課す手数料をベーシスポイントの10分の1単位で指定します。このフィールドの有効な値は0から50,000までです。値1は1/10ベーシスポイントまたは0.001%に相当し、0%から50%までの手数料設定を可能にします。50,000の`TransferFee`は50%に相当します。このフィールドのデフォルト値は0です。転送手数料の小数点以下は切り捨てられます。支払いが小さい場合、手数料は0に切り捨てられる可能性があります。発行者は、MPTの`AssetScale`が十分に大きいことを確認する必要があります。 |
|
||||
| `MPTokenMetadata` | 文字列 | Blob | この発行に関する任意のメタデータで、16進数形式です。このフィールドの制限は1024バイトです。 |
|
||||
| `PreviousTxnID` | 文字列 | Hash256 | このオブジェクトを最後に変更したトランザクションのトランザクションID。 |
|
||||
| `PreviousTxnLgrSeq` | 数値 | UInt32 | このオブジェクトを最後に変更したトランザクションを含むレジャーのシーケンス番号。 |
|
||||
| `OwnerNode` | 文字列 | UInt64 | このアイテムが参照されている所有者のディレクトリのページ。 |
|
||||
| `Sequence` | 数値 | UInt32 | 特定の送信者からの発行が、Issuanceが後で削除された場合でも一度しか存在できないことを保証するために使用される32ビットの符号なし整数。新しい発行が作成されるたびに、この値はアカウントの現在の`Sequence`番号と一致する必要があります。`Tickets`は通常の順序外でトランザクションを送信できるように、これらのルールから一部例外を設けています。`Tickets`は後で使用するために予約されたシーケンス番号を表します。トランザクションは通常のアカウントSequence番号の代わりに`Ticket`を使用できます。MPTを作成するトランザクションがレジャーに含まれるたびに、トランザクションが正常に実行されたか、tecクラスのエラーコードで失敗したかに関係なく、シーケンス番号(またはTicket)が使用されます。その他のトランザクションの失敗はレジャーに含まれないため、送信者のシーケンス番号は変更されません(また、他の影響もありません)。未確認のMPT作成トランザクションが同じIssuerとシーケンス番号を持つことは可能です。そのようなトランザクションは相互に排他的であり、検証済みレジャーに含まれるのは最大で1つだけです。(他のトランザクションは最終的に効果がありません。) |
|
||||
|
||||
|
||||
### MPTokenIssuanceのフラグ
|
||||
|
||||
Flagsは`MPToken`オブジェクトに関連付けられたプロパティまたはその他のオプションです。`MPTokenIssuanceSet`トランザクションを介して変更可能な`lsfMPTLocked`を除き、これらのフラグは不変です。`MPTokenIssuanceCreate`トランザクション中にのみ設定でき、後で変更することはできません。
|
||||
|
||||
| フラグ名 | フラグ値 | 説明 |
|
||||
| :------------------ | :----------- | ---- |
|
||||
| `lsfMPTLocked` | `0x00000001` | 設定されている場合、すべての残高がロックされていることを示します。 |
|
||||
| `lsfMPTCanLock` | `0x00000002` | 設定されている場合、発行者が個々の残高またはこのMPTのすべての残高をロックできることを示します。設定されていない場合、MPTはいかなる方法でもロックできません。 |
|
||||
| `lsfMPTRequireAuth` | `0x00000004` | 設定されている場合、個々の保有者は承認を必要とすることを示します。これにより、発行者は自身の資産を保有できる人を制限できます。 |
|
||||
| `lsfMPTCanEscrow` | `0x00000008` | 設定されている場合、個々の保有者が残高をエスクローに入れることができることを示します。 |
|
||||
| `lsfMPTCanTrade` | `0x00000010` | 設定されている場合、個々の保有者がXRP Ledger DEXまたはAMMを使用して残高を取引できることを示します。 |
|
||||
| `lsfMPTCanTransfer` | `0x00000020` | 設定されている場合、非発行者が保有するトークンを他のアカウントに転送できることを示します。設定されていない場合、非発行者が保有するトークンは発行者に返却する以外は転送できないことを示します。これにより、ストアクレジットなどのユースケースが可能になります。 |
|
||||
| `lsfMPTCanClawback` | `0x00000040` | 設定されている場合、発行者が`Clawback`トランザクションを使用して個々の保有者から価値を回収できることを示します。 |
|
||||
|
||||
{% raw-partial file="/docs/_snippets/common-links.md" /%}
|
||||
@@ -254,6 +254,16 @@ NFTを含むトランザクション(`tx`と`account_tx`)はメタデータ
|
||||
| `nftoken_ids` | 配列 | トランザクションの結果、レジャー上で変更された`NFToken`のすべての`NFTokenID`を表示します。トランザクションが `NFTokenCancelOffer`の場合のみ表示されます。 |
|
||||
| `offer_id` | 文字列 | `NFTokenCreateOffer`トランザクションからのレスポンスに、新しい`NFTokenOffer`の`OfferID`を表示します。 |
|
||||
|
||||
## MPTのフィールド
|
||||
|
||||
### 合成されたmpt_issuance_idフィールド
|
||||
|
||||
`MPTokenIssuanceID`は、RPCで`MPTokenIssuance`を指定するための識別子です。サーバはAPIレスポンスに合成された`mpt_issuance_id`フィールドを追加して、`MPTokenIssuanceID`のクライアントサイド解析の必要性を回避します。
|
||||
|
||||
### トランザクションのメタデータ
|
||||
|
||||
`MPTokenIssuanceCreate`トランザクションの成功したすべてのJSONトランザクションメタデータに合成された`mpt_issuance_id`フィールドが提供されます(バイナリでは利用できません)。次のAPIが影響を受けます。 `tx`,`account_tx`,`subscribe`,`ledger`
|
||||
|
||||
## delivered_amount
|
||||
|
||||
[Paymentトランザクション][]によって`Destination`に実際送金された金額を表します。トランザクションが成功すると、**[Partial Payments](../../../concepts/payment-types/partial-payments.md)であった場合を除いて、** 宛先は当該の金額を受取ります(Partial Paymentsの場合、`Amount`を上限とする正の金額が受取られます)。`Amount`フィールドを信頼するかどうかを選択するのではなく、メタデータの`delivered_amount`フィールドを使用して、宛先に実際に到達する金額を確認してください。
|
||||
|
||||
@@ -32,11 +32,14 @@ Clawback機能はデフォルトで無効になっています。使用するに
|
||||
|
||||
{% raw-partial file="/@l10n/ja/docs/_snippets/tx-fields-intro.md" /%}
|
||||
|
||||
| フィールド | JSONの型 | [内部の型][] | 説明 |
|
||||
|:-------------------|:----------|:------------|:----------|
|
||||
| `Amount` | [通貨額][] | Amount | 回収する金額と、その金額を回収する相手を表します。`value`サブフィールドの回収する数量はゼロであってはなりません。これが現在の残高より多い場合、トランザクションは全残高を回収します。サブフィールド`Amount`内の`issuer`はトークン所有者のアカウントを表します。|
|
||||
| フィールド | JSONの型 | [内部の型][] | 説明 |
|
||||
|:-------------------|:-----------|:-------------|:----------|
|
||||
| `Amount` | [通貨額][] | Amount | 回収する金額と、その金額を回収する相手を表します。`value`サブフィールドの回収する数量はゼロであってはなりません。これが現在の残高より多い場合、トランザクションは全残高を回収します。サブフィールド`Amount`内の`issuer`はトークン所有者のアカウントを表します。|
|
||||
| `Holder` | 文字列 | AccountID | (任意) 回収する相手のアカウントアドレスを指定します。回収対象のアカウントの所有する`MPToken`オブジェクトの残高が非ゼロである必要があります。 |
|
||||
|
||||
このトランザクションを実行するアカウントは、回収する資産の発行者でなければなりません。XRP Ledgerでは、トラストラインは双方向であり、設定によっては双方が資産の*発行者*とみなされることに注意してください。この仕様において、*発行者*という用語は、未払い残高がある(つまり、発行された資産に"債務がある")トラストラインの側が、その資産を回収することを意味します。
|
||||
{% admonition type="info" name="注記" %}XRP LedgerのIOU(トラストライン)では、トークンを発行した側を_発行者_と呼びますが、トラストラインは双方向性があり、設定によっては双方を発行者とみなすことができます。このトランザクションでは、トークン発行者のアドレスは`Account`フィールドにあり、トークン保有者のアドレスは`Amount`フィールドの`issuer`サブフィールドにあります。{% /admonition %}
|
||||
|
||||
{% admonition type="info" name="注記" %}MPTの保有者から資金を回収するには、発行者は`MPTokenIssuanceCreate`トランザクションを使用してMPTを作成するときに`tfMPTCanClawback`フラグを設定して、MPTがClawbackを許可することを指定しなければなりません。このフラグが設定されたMPTが作成されたと仮定すると、`Clawback`トランザクションを使用して回収を行うことができます。{% /admonition %}
|
||||
|
||||
|
||||
## エラーケース
|
||||
|
||||
@@ -0,0 +1,39 @@
|
||||
---
|
||||
html: mptokenauthorize.html
|
||||
parent: transaction-types.html
|
||||
blurb: アカウントが特定のMPTの残高を保持することを許可します。
|
||||
labels:
|
||||
- Multi-Purpose Token, MPT
|
||||
---
|
||||
|
||||
# MPTokenAuthorize
|
||||
[[ソース]](https://github.com/XRPLF/rippled/blob/master/src/xrpld/app/tx/detail/MPTokenAuthorize.cpp "ソース")
|
||||
|
||||
{% partial file="/@l10n/ja/docs/_snippets/mpts-disclaimer.md" /%}
|
||||
|
||||
このトランザクションは、アカウントが特定のMPT発行の残高を保持することを可能にします。トランザクションが成功すると、保有者アカウントが所有する初期残高がゼロの新しい`MPToken`オブジェクトが作成されます。
|
||||
|
||||
発行者が`MPTokenIssuance`に`lsfMPTRequireAuth`(ホワイトリスト形式)を設定している場合、発行者も保有者に許可を与えるために`MPTokenAuthorize`トランザクションを送信する必要があります。`lsfMPTRequireAuth`が設定されていない状態で発行者がこのトランザクションを送信しようとすると、失敗します。
|
||||
|
||||
<!-- ## MPTokenAuthorizeのフィールド -->
|
||||
|
||||
{% raw-partial file="/@l10n/ja/docs/_snippets/tx-fields-intro.md" /%}
|
||||
|
||||
| フィールド | JSON型 | [内部の型][] | 説明 |
|
||||
|:--------------------|:--------------------|:------------------|:-------------------|
|
||||
| `Account` | 文字列 | `AccountID` | このアドレスはMPTの発行者または潜在的な保有者のいずれかを示すことができます。 |
|
||||
| `TransactionType` | オブジェクト | `UInt16` | 新しいトランザクションタイプMPTokenAuthorizeを示します。整数値は29です。 |
|
||||
| `MPTokenIssuanceID` | 文字列 | `UIn192` | 対象となるMPTのIDを示します。 |
|
||||
| `Holder` | 文字列 | `AccountID` | (任意) 発行者が承認したい保有者のアドレスを指定します。承認/ホワイトリストにのみ使用され、保有者が送信する場合は空である必要があります。 |
|
||||
| `Flags` | 数値 | `UInt32` | [MPTokenAuthorizeのフラグ](#mptokenauthorizeのフラグ)をご覧ください。 |
|
||||
|
||||
|
||||
### MPTokenAuthorizeのフラグ
|
||||
|
||||
MPTokenAuthorizeタイプのトランザクションは、Flagsフィールドにおいて以下の追加の値をサポートします。
|
||||
|
||||
| フラグ名 | 16進数値 | 10進数値 | 説明 |
|
||||
|:-------------------|:-------------|:-------------|:----------------------------|
|
||||
| `tfMPTUnauthorize` | `0x00000001` | 1 | 保有者が送信する場合に設定すると、保有者が`MPToken`の保持を望まなくなったことを示し、その結果`MPToken`は削除されます。保有者の`MPToken`の残高がゼロでない状態でこのフラグを設定しようとすると、トランザクションは失敗します。一方、発行者が送信する場合に設定すると、発行者が保有者の承認を取り消したい(アローリストにのみ適用)ことを意味し、`MPToken`の`lsfMPTAuthorized`フラグが解除されます。 |
|
||||
|
||||
{% raw-partial file="/docs/_snippets/common-links.md" /%}
|
||||
@@ -0,0 +1,64 @@
|
||||
---
|
||||
html: mptokenissuancecreate.html
|
||||
parent: transaction-types.html
|
||||
blurb: 新しいMulti-Purpose Tokenを発行します。
|
||||
labels:
|
||||
- Multi-Purpose Token, MPT
|
||||
---
|
||||
|
||||
# MPTokenIssuanceCreate
|
||||
[[ソース]](https://github.com/XRPLF/rippled/blob/master/src/xrpld/app/tx/detail/MPTokenIssuanceCreate.cpp "ソース")
|
||||
|
||||
{% partial file="/@l10n/ja/docs/_snippets/mpts-disclaimer.md" /%}
|
||||
|
||||
`MPTokenIssuanceCreate`トランザクションは、[MPTokenIssuance](../../ledger-data/ledger-entry-types/mptokenissuance.md)オブジェクトを作成し、作成者アカウントの関連するディレクトリノードに追加します。このトランザクションは、変更不可として定義するトークンのフィールド(例:MPT Flags)を指定できる唯一の機会です。
|
||||
|
||||
トランザクションが成功すると、新しく作成されたトークンはトランザクションを実行したアカウント(作成者アカウント)が所有することになります。
|
||||
|
||||
`MPTokenIssuance`トランザクションのレスポンスを取得すると、トランザクションメタデータには常に`mpt_issuance_id`フィールドが含まれます。
|
||||
|
||||
## MPTokenIssuanceCreateのJSON例
|
||||
|
||||
この例では、トークンの発行者がトランザクションの送信者であることを前提としています。
|
||||
|
||||
```json
|
||||
{
|
||||
"TransactionType": "MPTokenIssuanceCreate",
|
||||
"Account": "rajgkBmMxmz161r8bWYH7CQAFZP5bA9oSG",
|
||||
"AssetScale": 2,
|
||||
"TransferFee": 314,
|
||||
"MaximumAmount": "50000000",
|
||||
"Flags": 83659,
|
||||
"MPTokenMetadata": "FOO",
|
||||
"Fee": "10"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- ## MPTokenIssuanceCreateのフィールド -->
|
||||
|
||||
{% raw-partial file="/@l10n/ja/docs/_snippets/tx-fields-intro.md" /%}
|
||||
|
||||
| フィールド | JSON型 | [内部の型][] | 説明 |
|
||||
| :---------------- | :----- | :----------- | ---- |
|
||||
| `TransactionType` | 文字列 | UInt16 | 新しいトランザクションタイプMPTokenIssuanceCreateを示します。 |
|
||||
| `AssetScale` | 数値 | UInt8 | (任意) 標準単位と対応する分数単位との間の桁数の差を表します。より正確には、AssetScaleは自然数(0, 1, 2, ...)で、1標準単位は対応する分数単位の10^(-scale)に等しくなります。分数単位が標準単位と等しい場合、AssetScaleは0となります。指定されない場合はデフォルトで0となります。 |
|
||||
| `Flags` | 数値 | UInt16 | このトランザクションのフラグを指定します。[MPTokenIssuanceCreateのフラグ](#mptokenissuancecreateのフラグ)をご覧ください。 |
|
||||
| `TransferFee` | 数値 | UInt16 | (任意) トークンの二次販売に対して発行者が請求する手数料を指定します(二次流通が許可されている場合)。このフィールドの有効な値は0から50,000までで、0.000%から50.000%までの転送レートを0.001刻みで設定できます。tfMPTCanTransferフラグが設定されていない場合、このフィールドは存在できません。存在する場合、トランザクションは失敗し、手数料が請求されます。 |
|
||||
| `MaximumAmount` | 文字列 | UInt64 | (任意) このトークンが発行される最大アセット量を10進数エンコードの文字列で指定します。指定されない場合、9,223,372,036,854,775,807(2^63-1)に設定されます。 |
|
||||
| `MPTokenMetadata` | 文字列 | Blob | この発行に関する任意のメタデータで、16進数形式で指定します。このフィールドの制限は1024バイトです。 |
|
||||
|
||||
|
||||
## MPTokenIssuanceCreateのフラグ
|
||||
|
||||
MPTokenIssuanceCreateトランザクションでは、[`Flags`フィールド](../common-fields.md#Flagsフィールド)に以下の追加の値がサポートされています。
|
||||
|
||||
| フラグ名 | 16進数値 | 10進数値 | 説明 |
|
||||
| :----------------- | :----------- | :------------ | ---- |
|
||||
| `tfMPTCanLock` | `0x00000002` | `2` | 設定されている場合、MPTを個別およびグローバルにロックできることを示します。設定されていない場合、MPTはいかなる方法でもロックできません。 |
|
||||
| `tfMPTRequireAuth` | `0x00000004` | `4` | 設定されている場合、個々の保有者は承認が必要であることを示します。これにより発行者は自身のアセットを保有できる者を制限できます。 |
|
||||
| `tfMPTCanEscrow` | `0x00000008` | `8` | 設定されている場合、個々の保有者が残高をエスクローに入れることができることを示します。 |
|
||||
| `tfMPTCanTrade` | `0x00000010` | `16` | 設定されている場合、個々の保有者がXRP Ledger DEXを使用して残高を取引できることを示します。 |
|
||||
| `tfMPTCanTransfer` | `0x00000020` | `32` | 設定されている場合、トークンを発行者以外のアカウントに転送できることを示します。 |
|
||||
| `tfMPTCanClawback` | `0x00000040` | `64` | 設定されている場合、発行者がClawbackトランザクションを使用して個々の保有者から価値を回収できることを示します。 |
|
||||
|
||||
{% raw-partial file="/docs/_snippets/common-links.md" /%}
|
||||
@@ -0,0 +1,36 @@
|
||||
---
|
||||
html: mptokenissuancedestroy.html
|
||||
parent: transaction-types.html
|
||||
blurb: レジャーからMulti-Purpose Tokenを削除します。
|
||||
labels:
|
||||
- Multi-Purpose Token, MPT
|
||||
---
|
||||
# MPTokenIssuanceDestroy
|
||||
[[ソース]](https://github.com/XRPLF/rippled/blob/master/src/xrpld/app/tx/detail/MPTokenIssuanceDestroy.cpp "ソース")
|
||||
|
||||
{% partial file="/@l10n/ja/docs/_snippets/mpts-disclaimer.md" /%}
|
||||
|
||||
`MPTokenIssuanceDestroy`トランザクションは、`MPTokenIssuance`オブジェクトをそれが保持されているディレクトリノードから削除するために使用され、実質的にレジャーからトークンを削除(「破棄」)します。
|
||||
|
||||
この操作が成功すると、対応する`MPTokenIssuance`が削除され、所有者の準備金要件が1つ減少します。対象のMPTの保有者が存在する場合、この操作は失敗しなければなりません。
|
||||
|
||||
## MPTokenIssuanceDestroyのJSONの例
|
||||
|
||||
```json
|
||||
{
|
||||
"TransactionType": "MPTokenIssuanceDestroy",
|
||||
"Fee": "10",
|
||||
"MPTokenIssuanceID": "00070C4495F14B0E44F78A264E41713C64B5F89242540EE255534400000000000000"
|
||||
}
|
||||
```
|
||||
|
||||
<!-- ## MPTokenIssuanceDestroyのフィールド -->
|
||||
|
||||
{% raw-partial file="/@l10n/ja/docs/_snippets/tx-fields-intro.md" /%}
|
||||
|
||||
| フィールド | JSONの型 | [内部の型][] | 説明 |
|
||||
|:--------------------|:--------------------|:-------------|:------------------|
|
||||
| `TransactionType` | 文字列 | UInt16 | 新しいトランザクションタイプMPTokenIssuanceDestroyを示します。 |
|
||||
| `MPTokenIssuanceID` | 文字列 | UInt192 | トランザクションによって削除される`MPTokenIssuance`オブジェクトの識別子。 |
|
||||
|
||||
{% raw-partial file="/docs/_snippets/common-links.md" /%}
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
html: mptokenissuanceset.html
|
||||
parent: transaction-types.html
|
||||
blurb: MPTの変更可能なプロパティを設定します。
|
||||
labels:
|
||||
- Multi-Purpose Token, MPT
|
||||
---
|
||||
# MPTokenIssuanceSet
|
||||
[[ソース]](https://github.com/XRPLF/rippled/blob/master/src/xrpld/app/tx/detail/MPTokenIssuanceSet.cpp "ソース")
|
||||
|
||||
{% partial file="/@l10n/ja/docs/_snippets/mpts-disclaimer.md" /%}
|
||||
|
||||
このトランザクションを使用して、Multi-Purpose Tokenの変更可能なプロパティを更新します。
|
||||
|
||||
## MPTokenIssuanceSetの例
|
||||
|
||||
```json
|
||||
{
|
||||
"TransactionType": "MPTokenIssuanceSet",
|
||||
"Fee": "10",
|
||||
"MPTokenIssuanceID": "00070C4495F14B0E44F78A264E41713C64B5F89242540EE255534400000000000000",
|
||||
"Flags": 1
|
||||
}
|
||||
```
|
||||
|
||||
<!-- ## MPTokenIssuanceSetのフィールド -->
|
||||
|
||||
{% raw-partial file="/@l10n/ja/docs/_snippets/tx-fields-intro.md" /%}
|
||||
|
||||
| フィールド | JSON型 | [内部の型][] | 説明 |
|
||||
|:-------------------|:-------------------|:-------------|:-------------------|
|
||||
| `TransactionType` | 文字列 | UInt16 | 新しいトランザクションタイプ`MPTokenIssuanceSet`を示します。 |
|
||||
| `MPTokenIssuanceID`| 文字列 | UInt192 | `MPTokenIssuance`の識別子。 |
|
||||
| `Holder` | 文字列 | AccountID | (任意) ロック/アンロックする個別のトークン保有者残高のXRPLアドレス。省略した場合、このトランザクションはMPTを保有する全てのアカウントに適用されます。 |
|
||||
| `Flag` | 数値 | UInt64 | このトランザクションのフラグを指定します。[MPTokenIssuanceSetのフラグ](#mptokenissuancesetのフラグ)をご覧ください。 |
|
||||
|
||||
### MPTokenIssuanceSetのフラグ
|
||||
|
||||
`MPTokenIssuanceSet`トランザクションでは、`Flags`フィールドで以下の追加の値がサポートされています。
|
||||
|
||||
| フラグ名 | 16進値 | 10進値 | 説明 |
|
||||
|:-------------------|:-------------|:--------------|:------------------------------|
|
||||
| `tfMPTLock` | `0x00000001` | 1 | 設定された場合、このアセットの全てのMPT残高をロックすることを示します。 |
|
||||
| `tfMPTUnlock` | `0x00000002` | 2 | 設定された場合、このアセットの全てのMPT残高をアンロックすることを示します。 |
|
||||
|
||||
{% raw-partial file="/docs/_snippets/common-links.md" /%}
|
||||
@@ -56,13 +56,14 @@ Paymentは、[アカウントを作成](#アカウントの作成)する唯一
|
||||
|
||||
Paymentトランザクションタイプは、いくつかの異なるタイプの抽象的なアクションを表現することができる汎用ツールです。下の表で説明するように、トランザクションのフィールドに基づいてトランザクションタイプを識別することができます。
|
||||
|
||||
| Paymentの種類 | `Amount` | `SendMax` | `Paths` | `Address` = `Destination`? | 説明 |
|
||||
| :--------------------------------- | :------------------------------ | :------------------------------ | :--------- | :------------------------- | ---- |
|
||||
| [XRP同士の直接支払い][] | String (XRP) | 省略 | 省略 | いいえ | アカウント間でへ直接XRPを送金します。常に正確な金額を送信します。基本的な[取引コスト](../../../../concepts/transactions/transaction-cost.md)以外の手数料は適用されません。 |
|
||||
| [発行通貨の作成・償還][] | Object | Object (任意) | 任意 | いいえ | XRP Ledgerに追跡されているXRP以外の通貨や資産の量を増減させます。[送金手数料](../../../../concepts/tokens/transfer-fees.md)と[凍結](../../../../concepts/tokens/fungible-tokens/freezes.md)は、直接送金・換金する際には適用されません。 |
|
||||
| [クロスカレンシー(通貨間)決済][] | Object (non-XRP) / String (XRP) | Object (non-XRP) / String (XRP) | 通常は必須 | いいえ | 発行された通貨を保有者から別の保有者に送信します。`Amount`と`SendMax`の両方をXRPにすることはできません。これらの支払いは、発行者を介して[リップリング](../../../../concepts/tokens/fungible-tokens/rippling.md)し、トランザクションがパスセットを指定した場合、複数の仲介者を介してより長い[パス](../../../../concepts/tokens/fungible-tokens/paths.md)を取ることができます。トランザクション形式には、発行者が設定した[送金手数料](../../../../concepts/tokens/transfer-fees.md) が適用されます。これらのトランザクションは、異なる通貨間や、場合によっては同じ通貨コードで異なる発行者の通貨間を接続するために、[分散型取引所](../../../../concepts/tokens/decentralized-exchange/index.md)のオファーを利用します。 |
|
||||
| [Partial payment][] | Object (non-XRP) / String (XRP) | Object (non-XRP) / String (XRP) | 通常は必須 | いいえ | 任意の通貨を特定の金額まで送ります。[`tfPartialPayment` フラグ](#paymentのフラグ)を使用します。トランザクションが成功するための最小値を指定する `DeliverMin` 値を含めることができます。トランザクションが `DeliverMin` を指定しない場合、_任意の正の値_ を指定して成功させることができる。 |
|
||||
| 通貨変換 | Object (non-XRP) / String (XRP) | Object (non-XRP) / String (XRP) | 必須 | はい | [分散型取引所](../../../../concepts/tokens/decentralized-exchange/index.md)のオファーを消費して、ある通貨を別の通貨に交換し、[裁定取引](https://ja.wikipedia.org/wiki/%E8%A3%81%E5%AE%9A%E5%8F%96%E5%BC%95)の機会を得ることが出来ます。`Amount`と `SendMax` の両方を XRP にすることはできません。[Data API](../../../data-api.md) は、このタイプの取引を "payment" ではなく、"exchange" として追跡しています。 |
|
||||
| Paymentの種類 | `Amount` | `SendMax` | `Paths` | `Address` = `Destination`? | 説明 |
|
||||
| :--------------------------------- | :---------------------------------- | :---------------------------------- | :--------- | :------------------------- | ---- |
|
||||
| [XRP同士の直接支払い][] | 文字列 (XRP) | 省略 | 省略 | いいえ | アカウント間でへ直接XRPを送金します。常に正確な金額を送信します。基本的な[取引コスト](../../../../concepts/transactions/transaction-cost.md)以外の手数料は適用されません。 |
|
||||
| [発行通貨の作成・償還][] | オブジェクト | オブジェクト (任意) | 任意 | いいえ | XRP Ledgerに追跡されているXRP以外の通貨や資産の量を増減させます。[送金手数料](../../../../concepts/tokens/transfer-fees.md)と[凍結](../../../../concepts/tokens/fungible-tokens/freezes.md)は、直接送金・換金する際には適用されません。 |
|
||||
| [クロスカレンシー(通貨間)決済][] | オブジェクト (非XRP) / 文字列 (XRP) | オブジェクト (非XRP) / 文字列 (XRP) | 通常は必須 | いいえ | 発行された通貨を保有者から別の保有者に送信します。`Amount`と`SendMax`の両方をXRPにすることはできません。これらの支払いは、発行者を介して[リップリング](../../../../concepts/tokens/fungible-tokens/rippling.md)し、トランザクションがパスセットを指定した場合、複数の仲介者を介してより長い[パス](../../../../concepts/tokens/fungible-tokens/paths.md)を取ることができます。トランザクション形式には、発行者が設定した[送金手数料](../../../../concepts/tokens/transfer-fees.md) が適用されます。これらのトランザクションは、異なる通貨間や、場合によっては同じ通貨コードで異なる発行者の通貨間を接続するために、[分散型取引所](../../../../concepts/tokens/decentralized-exchange/index.md)のオファーを利用します。 |
|
||||
| [Partial payment][] | オブジェクト (非XRP) / 文字列 (XRP) | オブジェクト (非XRP) / 文字列 (XRP) | 通常は必須 | いいえ | 任意の通貨を特定の金額まで送ります。[`tfPartialPayment` フラグ](#paymentのフラグ)を使用します。トランザクションが成功するための最小値を指定する `DeliverMin` 値を含めることができます。トランザクションが `DeliverMin` を指定しない場合、_任意の正の値_ を指定して成功させることができる。 |
|
||||
| 通貨変換 | オブジェクト (非XRP) / 文字列 (XRP) | オブジェクト (非XRP) / 文字列 (XRP) | 必須 | はい | [分散型取引所](../../../../concepts/tokens/decentralized-exchange/index.md)のオファーを消費して、ある通貨を別の通貨に交換し、[裁定取引](https://ja.wikipedia.org/wiki/%E8%A3%81%E5%AE%9A%E5%8F%96%E5%BC%95)の機会を得ることが出来ます。`Amount`と `SendMax` の両方を XRP にすることはできません。[Data API](../../../data-api.md) は、このタイプの取引を "payment" ではなく、"exchange" として追跡しています。 |
|
||||
| MPTの支払い | オブジェクト | 省略 | 省略 | はい | MPTを保有者に送信します。[MPTの支払い](#mpt-payments)をご覧ください。 |
|
||||
|
||||
[XRP同士の直接支払い]: ../../../../concepts/payment-types/direct-xrp-payments.md
|
||||
[発行通貨の作成・償還]: ../../../../concepts/tokens/index.md
|
||||
@@ -138,6 +139,35 @@ tfLimitQualityフラグが最も有用となるのは、[Partial Payments](../..
|
||||
|
||||
95人民元/15米ドルのオファーと5人民元/2米ドルのオファーがある上の例で、トランザクションに関してtfPartialPaymentとtfLimitQualityの両方が有効になっている場合、状況は異なります。20米ドルの`SendMax`および100人民元の宛先`Amount`を維持する場合も、クオリティの制限は`5`です。ただし、実行しようとするのはPartial Paymentsであるため、宛先に対する送金の全額を一度で送金できない場合、トランザクションを失敗とするのではなく、送金可能な最大限の金額が送金されます。つまり、トランザクションでは、クオリティが約`6.3`である95人民元/15米ドルのオファーは受け入れますが、5人民元/2米ドルのオファーはクオリティが`2.5`であり、クオリティの制限の`5`より低いため、拒否します。最終的に、トランザクションで送金されるのは満額の100人民元ではなく95人民元になりますが、不利な為替レートで資金を浪費することを避けられます。
|
||||
|
||||
## MPTの支払い
|
||||
|
||||
MPTの支払いを行う場合、_Amount_ フィールドは`mpt_issuance_id`と`value`のみを必要とします。`MPTokenIssuanceID`は、トランザクションのためにMPTを一意に識別するために使用されます。
|
||||
|
||||
MPTokenのバージョン1では、アカウント間の直接支払いのみをサポートしています。DEXでは取引できません。
|
||||
|
||||
### MPTの支払いの例
|
||||
|
||||
```json
|
||||
{
|
||||
"Account": "rLWSJKbwYSzG32JuGissYd66MFTvfMk4Bt",
|
||||
"Amount": {
|
||||
"mpt_issuance_id": "006419063CEBEB49FC20032206CE0F203138BFC59F1AC578",
|
||||
"value": "100"
|
||||
},
|
||||
"DeliverMax": {
|
||||
"mpt_issuance_id": "006419063CEBEB49FC20032206CE0F203138BFC59F1AC578",
|
||||
"value": "100"
|
||||
},
|
||||
"SendMax": {
|
||||
"mpt_issuance_id": "006419063CEBEB49FC20032206CE0F203138BFC59F1AC578",
|
||||
"value": "100"
|
||||
},
|
||||
"Destination": "raZ3wTTKiMHn3BiStvz4ET9rbCHfU1DMak",
|
||||
"Fee": "120",
|
||||
"Flags": 0,
|
||||
}
|
||||
```
|
||||
|
||||
## Credential ID
|
||||
|
||||
[Deposit Authorization](../../../../concepts/accounts/depositauth.md)を使用しているアカウントに対して、受取人によって事前承認された資格証明のセットを`CredentialIDs`フィールドで提供することで、そのアカウントに対して送金することができます。資格証明のセットは、[DepositPreauthエントリ](../../ledger-data/ledger-entry-types/depositpreauth.md)と一致していなければなりません。
|
||||
@@ -151,8 +181,10 @@ tfLimitQualityフラグが最も有用となるのは、[Partial Payments](../..
|
||||
|
||||
提供された資格証明が、Deposit Authorizationを使用していないアカウントに対して提供されている場合、資格証明は不要ですが、有効性は依然としてチェックされます。
|
||||
|
||||
### 準備金を下回るアカウントに対する特別な送金のケース
|
||||
|
||||
## 準備金を下回るアカウントに対する特別な送金のケース
|
||||
|
||||
Deposit Authorizationを使用しているアカウントが、そのアカウントの現在のXRP残高が[準備金要件](../../../../concepts/accounts/reserves.md)よりも少ない場合、Deposit Authorizationには、誰でもPaymentトランザクションを送信できる特別な例外があります。これは、アカウントが「取引できない」状態になるのを防ぐための緊急措置です。この特別なケースに該当するには、`CredentialIDs`フィールドを使用してはいけません。
|
||||
|
||||
|
||||
{% raw-partial file="/docs/_snippets/common-links.md" /%}
|
||||
|
||||
@@ -10,9 +10,9 @@ labels:
|
||||
|
||||
_私は認可Minterとして、トークン発行者のために合意されたレートでトークンをミントし、トークンを売却して利益を得て、ロイヤリティを発行者に還元したいのです。_
|
||||
|
||||
トークン発行者の認可Minterとして動作することができます。この場合、あなたはNFTokenを所有しますが、ロイヤリティはNFTokenの発行者が受け取ります。そのNFTokenを売却する場合、最初の売却益はあなたに入ります。発行者と合意の上、初回売却額の一部または全部を発行者に支払うことができます。
|
||||
トークン発行者の認可Minterとして活動することができます。この場合、NFTの所有者はあなたになりますが、ロイヤリティはNFTokenの発行者に送られます。そのNFTokenを販売すると、最初の販売収益はあなたのものになります。発行者と合意の上、初回売却額の一部または全部を発行者に支払うことも可能です。
|
||||
|
||||
チュートリアル[認可Minterの割り当て](../../tutorials/javascript/nfts/assign-an-authorized-minter.md)で詳しく説明されています。
|
||||
詳しくは、チュートリアル[認可Minterの割り当て](../../tutorials/javascript/nfts/assign-an-authorized-minter.md)をご覧ください。
|
||||
|
||||
[](/docs/img/nft-mkt-auth-minter.png)
|
||||
|
||||
@@ -37,7 +37,7 @@ NFTokenのURLは、NFTのコンテンツが保存されている場所へのリ
|
||||
最も気になるであろう留意点:
|
||||
|
||||
* [コレクションとしてNFTをミントする](../../concepts/tokens/nfts/collections.md)
|
||||
TokenTaxonフィールドを使用して、特定のテーマや目的をもったNFTのセットを作成します。
|
||||
TokenTaxonフィールドを使用して、特定のテーマや目的に基づいたNFTセットを作成可能。
|
||||
* [NFTの固定供給](../../concepts/tokens/nfts/guaranteeing-a-fixed-supply.md)
|
||||
また、「使い捨て」アカウントでNFTを作成し、別のアカウントで一定数のNFTを取得した後、ミントに使用した「使い捨て」アカウントを削除することで、作成したNFTの希少性を確保することができます。[NFTの固定供給](../../concepts/tokens/nfts/guaranteeing-a-fixed-supply.md)をご覧ください。
|
||||
|
||||
@@ -47,15 +47,15 @@ NFTの取引は、売りオファーの作成または買いオファーの承
|
||||
|
||||
NFTをオークション形式で販売することができます。[NFTオークションの実行](../../concepts/tokens/nfts/running-an-nft-auction.md)をご覧ください。
|
||||
|
||||
あなたはブローカーとして、売り手と入札者をつなぎ、取引を完了させ、購入価格の何パーセントかを保持することができます。[NFTokenの取引を仲介する](../../tutorials/javascript/nfts/broker-an-nft-sale.md)をご覧ください。
|
||||
あなたはブローカーとして、売り手と入札者をつなぎ、取引を完了させ、販売価格の一部を報酬として得ることもできます。[NFTokenの取引を仲介する](../../tutorials/javascript/nfts/broker-an-nft-sale.md)をご覧ください。
|
||||
|
||||
### 準備金要件
|
||||
|
||||
販売用のNFTをミントする際には、XRPの準備金が必要となります。各NFTokenページには、2XRPの準備金が必要です。NFTokenページは16~32個のNFTを保管することができます。
|
||||
販売用のNFTをミントする際には、XRPの準備金が必要となります。各NFTokenページには、{% $env.PUBLIC_OWNER_RESERVE %}の準備金が必要です。NFTokenページは16~32個のNFTを保管することができます。
|
||||
|
||||
各`NFTokenOffer`オブジェクトは、2XRPの準備金が必要です。
|
||||
各`NFTokenOffer`オブジェクトは、{% $env.PUBLIC_OWNER_RESERVE %}の準備金が必要です。
|
||||
|
||||
`NFTokenOffer`を作成したり、NFTを売却したりする際には、些細な送金手数料(およそ6000ドロップ、または0.006 XRP)が発生します。大量に販売する場合、こうした少額の手数料はすぐにかさみますので、ビジネスのコストとして考慮する必要があります。
|
||||
`NFTokenOffer`を作成したり、NFTを売却したりする際には、わずかな送金手数料(およそ6000ドロップ、または0.006 XRP)が発生します。大量に販売する場合、こうした少額の手数料はすぐにかさみますので、ビジネスのコストとして考慮する必要があります。
|
||||
|
||||
次のコンテンツをご覧ください。
|
||||
|
||||
@@ -101,4 +101,4 @@ Supplement Information [No link]
|
||||
History
|
||||
Number of owners
|
||||
Price History
|
||||
-->
|
||||
-->
|
||||
@@ -103,22 +103,26 @@ Markdownファイルのページは、[frontmatterスタンザ](#frontmatterの
|
||||
|
||||
新機能を文書化する場合、その機能が導入されたプログラムのバージョンを示すバッジを含めてください。バッジタグは以下の構造です。
|
||||
|
||||
`{badge href="myurl" date="<リリース日>"}新規: <プログラム> <バージョン番号>{% /badge%}`
|
||||
<pre><code>
|
||||
{% badge href="myurl" date="<リリース日>" %}新規: <プログラム> <バージョン番号>{% /badge%}
|
||||
</code></pre>
|
||||
|
||||
例えば次のようなバッジ定義になります。
|
||||
|
||||
`{% badge href="https://github.com/XRPLF/clio/releases/tag/2.0.0" date="February 18, 2024" %}新規: Clio v2.0.0{% /badge %}`
|
||||
<pre><code>
|
||||
{% badge href="https://github.com/XRPLF/clio/releases/tag/2.0.0" date="February 18, 2024" %}新規: Clio v2.0.0{% /badge %}
|
||||
</code></pre>
|
||||
|
||||
次のように表示されます。 {% badge href="https://github.com/XRPLF/clio/releases/tag/2.0.0" date="February 18, 2024" %}新規: Clio v2.0.0{% /badge %}
|
||||
|
||||
When updating a feature, replace _New in:_ with _Updated in:_. For example, the following badge definition:
|
||||
|
||||
機能の更新の場合、_新規:_ を _更新:_ に置き換えてください。例えば、次のバッジ定義となります。
|
||||
|
||||
`{% badge href="https://github.com/XRPLF/clio/releases/tag/2.1.0" date="May 4, 2024" %} 更新: Clio v2.1.0{% /badge %}`
|
||||
|
||||
次のように表示されます。 {% badge href="https://github.com/XRPLF/clio/releases/tag/2.1.0" date="May 4, 2024" %} 更新: Clio v2.1.0{% /badge %}
|
||||
|
||||
いくつかのフレーズは自動的にバッジの色を設定し、また`color="purple"`のような色のパラメータをタグに追加することで色を明示的に設定できます。
|
||||
|
||||
2年以上前の新規/更新バッジは削除するのがベストプラクティスです。
|
||||
|
||||
### 技術用語
|
||||
@@ -140,10 +144,13 @@ When updating a feature, replace _New in:_ with _Updated in:_. For example, the
|
||||
| トランザクションコスト | トランザクション手数料 | XRP Ledgerでトランザクションを送信するために消費されるXRPの金額。これはトランザクションの`Fee`フィールドで指定されますが、_手数料_ という用語は誰かにお金を支払うことを意味するため、_コスト_ の方が望ましいです。 |
|
||||
| トークン | IOU, issuances, issues, 発行済み通貨 | XRP Ledgerのトークンは、_IOU_ という名前から想像されるように、レジャーの外部にある価値を表すことはできません。必要であれば、_代替可能トークン_ を使用して、非代替性トークン(NFT)と区別してください。 |
|
||||
| ウォレット | ウォレット | 文脈によっては、_ウォレット_ はハードウェア、ソフトウェア、暗号鍵ペア、またはオンラインサービスを指します。意味が明確になるように十分な文脈を提供するか、_キーペア_ や _クライアントアプリケーション_ などの別の表現を使用してください。 |
|
||||
| WebSocket | web socket, Websockets | Web上での双方向プロトコル。常に単数形でCamelCaseで記述してください。 |
|
||||
| XRP | Ripple, リップル | XRP Ledgerのネイティブデジタルアセットまたは暗号通貨。XRPはレジャーの外部の価値を表すトークンではありません。 |
|
||||
| XRP Ledger | Ripple, リップル, Ripple Network, リップルネットワーク, RCL | XRP Ledgerは、過去に様々な場面で「リップルネットワーク」や「リップルコンセンサスレジャー」あるいは「RCL」と呼ばれていました。これらの名称は、コアサーバのリファレンス実装を開発しているRipple(Ripple Labs)の社名と類似しているため、紛らわしく、廃止されました。 |
|
||||
| XRPL | XRPL | _XRP Ledger_ の略です。_XRPL_ は不明瞭で、_XRP_ のタイプミスのように見えることがあります。 |
|
||||
|
||||
|
||||
|
||||
## Frontmatterのフィールド
|
||||
|
||||
***Note: Realmのfrontmatter仕様の詳細は完全には文書化されていません。Realmがクローズドベータを終了したら、リンクを更新する必要があります。***
|
||||
@@ -175,11 +182,7 @@ navigation:
|
||||
---
|
||||
```
|
||||
|
||||
## Markdocのコンポーネント
|
||||
|
||||
これらのファイルは[Markdoc](https://markdoc.dev/)で処理されるため、`{% ... %}`構文で特別なタグを含めることができます。Redoclyの組み込みタグに加えて、このリポジトリには`/@theme/markdoc/`に定義されたいくつかのカスタムタグがあります。
|
||||
|
||||
### グラフィック
|
||||
## グラフィック
|
||||
|
||||
`/docs/img`ディレクトリにグラフィックを保存します。グラフィックを埋め込むには、次の構文を使用します。
|
||||
|
||||
@@ -189,7 +192,7 @@ navigation:
|
||||
|
||||

|
||||
|
||||
### ビデオ
|
||||
## ビデオ
|
||||
|
||||
ビデオはYouTubeに保存されます。アップロード後、埋め込み手順をコピーしてドキュメントに貼り付けることができます。
|
||||
|
||||
@@ -215,7 +218,7 @@ si=Mbi8diaFTDR2fc20" title="YouTube video player" frameborder="0" allow="acceler
|
||||
autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
|
||||
referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
|
||||
|
||||
### テーブル
|
||||
## テーブル
|
||||
|
||||
Markdocは、テーブルを生成するための3つの異なる構文スタイルを提供します。
|
||||
|
||||
@@ -283,7 +286,7 @@ Markdocは、テーブルを生成するための3つの異なる構文スタイ
|
||||
|
||||
可能な限り、これらの基本的なテーブルを使用してください。上記の例で提供されていない特別なフォーマットが本当に必要な場合は、HTML構文を使用してテーブルを作成できます。
|
||||
|
||||
### リンク
|
||||
## リンク
|
||||
|
||||
リンクは`[<リンクテキスト>](<URL>)`の構文を使用します。
|
||||
|
||||
@@ -295,11 +298,11 @@ Markdocは、テーブルを生成するための3つの異なる構文スタイ
|
||||
|
||||
[XRPL.org](http://xrpl.org)で世界のあらゆる問題の解決策をご覧ください。
|
||||
|
||||
### 共通のリンク
|
||||
## 共通のリンク
|
||||
|
||||
共通的に引用されるページへのリンクを作成するには、`{% raw-partial file="/docs/_snippets/common-links.md /%}`タグをMarkdownファイルに追加し、`[account_infoメソッド][]`や`[Paymentトランザクション][]`などの参照スタイルのリンクを使用できます。common-linksファイルの内容はアルファベット順になっています。(以前はスクリプトで生成されていましたが、現在は手動で管理されています。)
|
||||
|
||||
### サンプルコード
|
||||
## サンプルコード
|
||||
|
||||
サンプルコードを挿入する場合は、バッククォート(`)文字でコードを囲みます。例えば:
|
||||
|
||||
@@ -313,14 +316,16 @@ Markdocは、テーブルを生成するための3つの異なる構文スタイ
|
||||
|
||||
例えば、
|
||||
|
||||
```javascript<br/>
|
||||
const prepared = await client.autofill({<br/>
|
||||
"TransactionType": "Payment",<br/>
|
||||
"Account": standby_wallet.address,<br/>
|
||||
"Amount": xrpl.xrpToDrops(sendAmount),<br/>
|
||||
"Destination": standbyDestinationField.value<br/>
|
||||
})
|
||||
```
|
||||
<pre><code>
|
||||
```javascript
|
||||
const prepared = await client.autofill({
|
||||
"TransactionType": "Payment",
|
||||
"Account": standby_wallet.address,
|
||||
"Amount": xrpl.xrpToDrops(sendAmount),
|
||||
"Destination": standbyDestinationField.value
|
||||
})
|
||||
```
|
||||
</code></pre>
|
||||
|
||||
次のように表示されます。
|
||||
|
||||
@@ -333,6 +338,14 @@ Markdocは、テーブルを生成するための3つの異なる構文スタイ
|
||||
})
|
||||
```
|
||||
|
||||
## Markdocのコンポーネント
|
||||
|
||||
これらのファイルは[Markdoc](https://markdoc.dev/)で処理されるため、`{% ... %}`構文で特別なタグを含めることができます。Redoclyの組み込みタグに加えて、このリポジトリには`/@theme/markdoc/`に定義されたいくつかのカスタムタグがあります。
|
||||
|
||||
### バッジ
|
||||
|
||||
[新機能](#新機能)をご覧ください。
|
||||
|
||||
### 部分的なコンテンツ
|
||||
|
||||
頻繁に使用するテキストや、ドキュメント内の複数の場所で定期的に更新が必要なテキストがある場合は、再利用のために_snippetファイルを作成できます。
|
||||
@@ -370,5 +383,78 @@ There I was, happy as a lark, skipping through the daisies, when I shyly handed
|
||||
Alas, if only I had heeded that sage advice, I would not rue the day as I do today.
|
||||
</blockquote>
|
||||
|
||||
### Not-Enabledバッジ
|
||||
|
||||
{% not-enabled /%} Markdocコンポーネントは、その機能が本番環境のXRP Ledgerでは利用できないことを示すツールチップ付きの黄色いフラスクアイコンを表示します。投票中だが現在有効になっていない修正についての説明で使用します。例: {% not-enabled /%}
|
||||
|
||||
このタグは自己終了型で、パラメータは必要ありません。
|
||||
|
||||
### リポジトリリンク
|
||||
|
||||
このタグは、通常コードサンプルである、このサイトのソースコードリポジトリの特定のファイルへのリンクを作成します。例えば、
|
||||
|
||||
<pre><code>
|
||||
{% repo-link path="_code-samples/build-a-desktop-wallet/js/1_ledger-index.js" %}`1-ledger-index/index.js`{% /repo-link %}
|
||||
</code></pre>
|
||||
|
||||
次のようになります: {% repo-link path="_code-samples/build-a-desktop-wallet/js/1_ledger-index.js" %}`1-ledger-index/index.js`{% /repo-link %}
|
||||
|
||||
サイトのフォークやブランチで作業している場合、サイト設定の変更で一度にすべてのリンクを更新できます。
|
||||
|
||||
|
||||
### 試してみる
|
||||
|
||||
`{% try-it ... /%}` Markdocタグは、WebSocketツールへのリンクをボタンとして提供する便利なショートカットです。このタグは自己終了型です。
|
||||
|
||||
{% try-it method="account_currencies" server="testnet" /%}
|
||||
|
||||
構文例:
|
||||
|
||||
<pre><code>
|
||||
{% try-it method="account_currencies" server="testnet" /%}
|
||||
</code></pre>
|
||||
|
||||
|
||||
ボタンのテキストは英語では "Try it!" で、ローカライゼーションの`translations.yaml`ファイルの`component.tryit`キーを設定することで翻訳できます。
|
||||
|
||||
このタグは以下のパラメータを受け付けます:
|
||||
|
||||
| パラメータ | 必須? | 説明 |
|
||||
| ---------- | ----- | ---- |
|
||||
| `method` | はい | WebSocketツールページで使用するアンカーのID。ほとんどの WebSocket API メソッドでは、これはまさにその API メソッドですが、それ以上のものも含む可能性があります。例えば、異なる `ledger_entry` のバリエーションには、`ledger_entry-nft-page` のような接尾辞が使用されます。新しいメソッドを文書化する場合は、`/resources/dev-tools/components/websocket-api/data/command-list.json` を編集して、そのメソッドを WebSocket ツールに追加する必要があります。 |
|
||||
| `server` | いいえ | リクエストに使用する特定のサーバ。Clio または `rippled` サーバに固有のメソッドを使用する場合、または、例で使用するデータやAmendmentが特定のテストネットワーク上のみにある場合、サーバを指定する必要があります。 |
|
||||
|
||||
`server`パラメータには以下の値を指定できます。
|
||||
|
||||
| `server`値 | 使用するサーバ |
|
||||
| -------------- | ------------- |
|
||||
| (省略) | デフォルトのサーバ (現在は`s1.ripple.com`) |
|
||||
| `s1` | RippleのMainnet公開クラスタ`s1.ripple.com`(通常Clioサーバーが提供) |
|
||||
| `s2` | RippleのMainnetフルヒストリ公開クラスタ`s2.ripple.com`(通常Clioサーバーが提供) |
|
||||
| `xrplcluster` | 軽量プロキシを前面に配置した`rippled`サーバーが提供する`xrplcluster.com`公開サーバークラスタ |
|
||||
| `devnet` | テストネットサーバのクラスタ`s.altnet.rippletest.net` |
|
||||
| `testnet` |開発ネットサーバのクラスタ`s.devnet.rippletest.net` |
|
||||
|
||||
### トランザクション例
|
||||
|
||||
`{% tx-example ... /%}`Markdocタグは、特定の例示トランザクションを検索するためのボディが事前に入力されたWebSocketツールへのリンクをボタンとして提供する便利なショートカットです。このタグは自己終了型です。例として、
|
||||
|
||||
{% tx-example txid="1AF19BF9717DA0B05A3BFC5007873E7743BA54C0311CCCCC60776AAEAC5C4635" /%}
|
||||
|
||||
構文例:
|
||||
|
||||
<pre><code>
|
||||
{% tx-example txid="1AF19BF9717DA0B05A3BFC5007873E7743BA54C0311CCCCC60776AAEAC5C4635" /%}
|
||||
</code></pre>
|
||||
|
||||
ボタンのテキストは通常英語では"Query example transaction"で、ローカライゼーションの`translations.yaml`ファイルの`component.queryexampletx`キーを設定することで翻訳できます。
|
||||
|
||||
このタグは以下のパラメータを受け付けます。
|
||||
|
||||
| パラメータ | 必須? | 説明 |
|
||||
| ---------- | ------ | ---- |
|
||||
| `txid` | はい | 検索するトランザクションの一意のハッシュ。 |
|
||||
| `server` | いいえ | リクエストに使用する特定のサーバ。可能な値は上記の`{% try-it %}`で定義されているものと同じです。例えば、Mainnetでは有効になっていないAmendmentによって追加されたトランザクションを表示するためには`devnet`を指定する必要があります。 |
|
||||
|
||||
|
||||
{% child-pages /%}
|
||||
|
||||
@@ -1334,7 +1334,7 @@ XRP Ledgerの分散型取引所において、オファーの掛け合わせの
|
||||
| デフォルトの投票(最新の安定版) | いいえ |
|
||||
| Amendment前の機能は廃止? | いいえ |
|
||||
|
||||
_多目的トークン(MPT)_ と呼ばれる新しいタイプの代替可能トークンを実装します。このトークンタイプは、ステーブルコインなどの一般的なトークンのユースケースに最適化されており、双方向のトラストラインに保存されるXRP Ledgerの既存の代替可能トークンに固有の複雑さを回避することを目的としています。このAmendmentは次のものを追加します。
|
||||
_Multi-Purpose Token(MPT)_ と呼ばれる新しいタイプの代替可能トークンを実装します。このトークンタイプは、ステーブルコインなどの一般的なトークンのユースケースに最適化されており、双方向のトラストラインに保存されるXRP Ledgerの既存の代替可能トークンに固有の複雑さを回避することを目的としています。このAmendmentは次のものを追加します。
|
||||
|
||||
**新しいレジャーエントリタイプ:**
|
||||
|
||||
|
||||
@@ -74,6 +74,7 @@ topnav.resources.explorer: エクスプローラ
|
||||
topnav.resources.known-amendments: 既知のAmendment
|
||||
topnav.resources.contribute-code: コードへの貢献
|
||||
topnav.resources.contribute-documentation: ドキュメントへの貢献
|
||||
topnav.resources.contribute-blog: ブログに投稿する
|
||||
topnav.community.title: コミュニティ
|
||||
topnav.community.description: 話題に加わろう。
|
||||
topnav.community.get-involved: 参加する
|
||||
@@ -832,6 +833,7 @@ resources.dev-tool.faucet.content.part4: これらの資金は
|
||||
resources.dev-tool.faucet.content.part5: テストのみ
|
||||
resources.dev-tool.faucet.content.part6: を目的としています。テストネットワークの履歴と残高は必要に応じてリセットされます。Devnetは警告なしにリセットされることがあります。
|
||||
resources.dev-tool.faucet.content.part7: これらのネットワーク上のすべての残高とXRPは、メインネットとは別のものです。安全のため、テストネットやDevnetの認証情報をメインネットで使用しないでください。
|
||||
resources.dev-tool.faucet.content.part8: "以下のツールは、認証情報を生成して即座にチャージします。既存のアドレスにチャージしたい場合は、こちらで行えます:"
|
||||
"Choose Network:": "ネットワークを選択:"
|
||||
Mainnet-like network for testing applications.: アプリケーションのテスト用のメインネットに似たネットワーク。
|
||||
Preview of upcoming amendments.: 今後のAmendmentのプレビューネットワーク。
|
||||
|
||||
Reference in New Issue
Block a user