fix space etc

This commit is contained in:
develoQ
2023-02-20 13:07:14 +09:00
parent a3fbe11952
commit bdd633e192
11 changed files with 75 additions and 76 deletions

View File

@@ -133,7 +133,7 @@ XRP Ledger開発者ポータルは主に英語で記載されているため、
# ...
```
サポート対象の各言語のプロパティーをいくつか定義する最上位の`languages`リストもあります。各言語のショートコードは、[IETF BCP47](https://tools.ietf.org/html/bcp47)に沿ったものである必要があります。.例えば、英語は「en」、スペイン語は「es」、日本語は「ja」、簡体字中国語は「zh-CN」、繁体字中国語台湾で使用は「zh-TW」になります。`display_name`フィールドでは、言語名をその言語で記載して定義します。`prefix`フィールドでは、その言語版のサイトへのハイパーリンクに使用されるプレフィックスを定義します。`languages`のサンプルの定義を以下に示します。
サポート対象の各言語のプロパティーをいくつか定義する最上位の`languages`リストもあります。各言語のショートコードは、[IETF BCP47](https://tools.ietf.org/html/bcp47)に沿ったものである必要があります。例えば、英語は「en」、スペイン語は「es」、日本語は「ja」、簡体字中国語は「zh-CN」、繁体字中国語台湾で使用は「zh-TW」になります。`display_name`フィールドでは、言語名をその言語で記載して定義します。`prefix`フィールドでは、その言語版のサイトへのハイパーリンクに使用されるプレフィックスを定義します。`languages`のサンプルの定義を以下に示します。
```yaml
languages:

View File

@@ -1,3 +1,3 @@
各[]レジャー](ledgers.html)の状態ツリーは**レジャーオブジェクト**のセットで構成されており、それらが総合して共有レジャーのすべての設定、残高、関係を表します。
各[レジャー](ledgers.html)の状態ツリーは**レジャーオブジェクト**のセットで構成されており、それらが総合して共有レジャーのすべての設定、残高、関係を表します。
rippledサーバーが互いに通信するために使用する[ピアプロトコル](peer-protocol.html)では、レジャーオブジェクトは生[バイナリーフォーマット](serialization.html)で表されます。rippled APIでは、レジャーオブジェクトはJSONオブジェクトとして表されます。

View File

@@ -41,7 +41,7 @@ D = A × ( e ^ (t ÷ τ) )
2. 変換する量に適用します。
- レジャー値を表示値に変換する場合は、デマレージ係数を乗じる。
- 表示値をレジャー値に変換する場合は、デマレージ係数で割ってください。
3. 必要であれば、結果値が望ましい精度で表現できるように調整する。XRP Ledgerの[発行通貨形式](currency-formats.html#発行済み通貨の精度)により、レジャー値の精度は小数点以下15桁までとされています。.
3. 必要であれば、結果値が望ましい精度で表現できるように調整する。XRP Ledgerの[発行通貨形式](currency-formats.html#発行済み通貨の精度)により、レジャー値の精度は小数点以下15桁までとされています。
## 利子付き通貨コードフォーマット

View File

@@ -3,13 +3,12 @@ html: non-fungible-token-transfers.html
parent: non-fungible-tokens.html
blurb: NFTokenをダイレクトモードまたはブローカーモードで取引する。
labels:
- Non-fungible Tokens, NFTs
status: not_enabled
- 非代替性トークン, NFT
---
# XRP Ledger上でNFTokenを売買する
XRP Ledger上のアカウント間で`NFToken`オブジェクトを転送することができます。`NFToken` の売買をオファーしたり、他のアカウントから自分が保有する NFToken への売買オファーを受け入れることができます。`NFToken`無料(価格が0)で売却することで、`NFToken` を配布することもできます。すべてのオファーは [NFTokenCreateOfferトランザクション][] を使って作成されます。
XRP Ledger上のアカウント間で`NFToken`オブジェクトを転送することができます。`NFToken`の売買をオファーしたり、他のアカウントから自分が保有するNFTokenへの売買オファーを受け入れることができます。`NFToken`無料(価格が0)で売却することで、`NFToken`を配布することもできます。すべてのオファーは[NFTokenCreateOfferトランザクション][]を使って作成されます。
_([NonFungibleTokensV1_1 amendment][]が必要です)_
@@ -18,12 +17,12 @@ _([NonFungibleTokensV1_1 amendment][]が必要です)_
### 売却オファーの作成
`NFToken` オブジェクトの所有者であれば、`tfSellToken` フラグを指定して [NFTokenCreateOffer トランザクション][] を使用して売却オファーを作成することができます。`NFTokenID` と、対価として受け取る金額 `Amount` を指定します。オプションで、そのオファーが無効になる `Expiration` と、その `NFToken` を購入することができる唯一のアカウントである `Destination` を指定することができます。
`NFToken`オブジェクトの所有者であれば、`tfSellToken`フラグを指定して[NFTokenCreateOfferトランザクション][]を使用して売却オファーを作成することができます。`NFTokenID`と、対価として受け取る金額`Amount`を指定します。オプションで、そのオファーが無効になる`Expiration`と、その`NFToken`を購入することができる唯一のアカウントである`Destination`を指定することができます。
### 売却オファーを受け入れる
販売されている `NFToken` を購入するには、`NFTokenAcceptOffer` トランザクションを使用します。`NFTokenOffer` オブジェクトの所有者アカウントと `NFTokenOfferID` を指定し、受け入れることを決定します。
販売されている`NFToken`を購入するには、`NFTokenAcceptOffer`トランザクションを使用します。`NFTokenOffer`オブジェクトの所有者アカウントと`NFTokenOfferID`を指定し、受け入れることを決定します。
## 購入オファー
@@ -31,19 +30,19 @@ _([NonFungibleTokensV1_1 amendment][]が必要です)_
### 購入オファーの作成
どのアカウントでも `NFToken` の購入オファーを作成することができます。`tfSellToken` のフラグを指定せずに、[NFTokenCreateOffer][] を使用することで、購入オファーを作成することが可能です。`Owner`アカウント、`NFTokenID`、オファーの `Amount` を指定します。
どのアカウントでも`NFToken`の購入オファーを作成することができます。`tfSellToken`のフラグを指定せずに、[NFTokenCreateOffer][]を使用することで、購入オファーを作成することが可能です。`Owner`アカウント、`NFTokenID`、オファーの`Amount`を指定します。
### 購入オファーを受け入れる
`NFTokenAcceptOffer` トランザクションを使用して `NFToken` を転送します。`NFTokenOfferID` と所有者アカウントを指定して、トランザクションを完了させてください。
`NFTokenAcceptOffer`トランザクションを使用して`NFToken`を転送します。`NFTokenOfferID`と所有者アカウントを指定して、トランザクションを完了させてください。
## 取引モード
`NFToken`を取引する場合、購入者と販売者の間で直接取引を行う、 _ダイレクト_ 取引と、第三者の口座が売りと買いのオファーをマッチングして取引を仲介する、 _ブローカー_ 取引を選択することができます。
ダイレクトモードでの取引では、販売者が転送をコントロールすることができます。販売者は誰でも購入できるように `NFToken` を出品するか、特定の取引先アカウントに `NFToken` を販売することができます。販売者はNFTokenの販売価格全額を受け取ります。
ダイレクトモードでの取引では、販売者が転送をコントロールすることができます。販売者は誰でも購入できるように`NFToken`を出品するか、特定の取引先アカウントに`NFToken`を販売することができます。販売者はNFTokenの販売価格全額を受け取ります。
ブローカーモードでは、販売者は第三者のアカウントに`NFToken`の販売を仲介させます。ブローカーアカウントは、合意したレートで仲介手数料を徴収し、転送を行います。購入はリアルタイムで完了し、ブローカーと販売者には購入資金から支払われ、ブローカーによる前払いは必要ありません。
@@ -57,7 +56,7 @@ _([NonFungibleTokensV1_1 amendment][]が必要です)_
ブローカーを利用すると、いくつかの利点があります。例えば
* ブローカーは仲介者として、`NFToken`の販売価格を最大化するために活動することができます。ブローカーが販売価格の何割かを受け取る場合、価格が高ければ高いほど、ブローカーの収入も増えます。
* ブローカーは、ニッチな市場や 価格帯などの基準に基づいて`NFToken`オブジェクトの管理を行う管理者として活動することができます。これによって、クリエイターの作品を発見できないような購入者のグループを呼び込むことができるでしょう。
* ブローカーは、ニッチな市場や価格帯などの基準に基づいて`NFToken`オブジェクトの管理を行う管理者として活動することができます。これによって、クリエイターの作品を発見できないような購入者のグループを呼び込むことができるでしょう。
* ブローカーは、Opensea.ioのようなマーケットプレイスとして機能し、アプリケーション層でオークション機能を提供することもできます。
@@ -69,13 +68,13 @@ _([NonFungibleTokensV1_1 amendment][]が必要です)_
![Brokered Mode with Reserve](img/nft-brokered-mode-with-reserve.png)
もう1つのワークフローは、クリエイターが販売をよりコントロールできるようにするものです。このワークフローでは、クリエイターが新しい`NFToken`を発行します。入札者はオファーを作成し、ブローカーを宛先として設定します。ブローカーは落札者を選び、仲介手数料を差し引き、`NFTokenCreateOffer`を使用してクリエイターに署名の依頼をします。クリエーターは要求されたオファーに署名し、ブローカーを宛先として設定します。ブローカーは `NFTokenAcceptOffer` を使って売却を完了し、仲介手数料を保持します。ブローカーは `NFTokenCancelOffer` を使用して `NFToken` に対する残りの入札をキャンセルします。
もう1つのワークフローは、クリエイターが販売をよりコントロールできるようにするものです。このワークフローでは、クリエイターが新しい`NFToken`を発行します。入札者はオファーを作成し、ブローカーを宛先として設定します。ブローカーは落札者を選び、仲介手数料を差し引き、`NFTokenCreateOffer`を使用してクリエイターに署名の依頼をします。クリエーターは要求されたオファーに署名し、ブローカーを宛先として設定します。ブローカーは`NFTokenAcceptOffer`を使って売却を完了し、仲介手数料を保持します。ブローカーは`NFTokenCancelOffer`を使用して`NFToken`に対する残りの入札をキャンセルします。
![Brokered Mode without Reserve](img/nft-brokered-mode-without-reserve.png)
所有者が他のアカウントで作成した `NFToken` をリセールする場合にも、同じワークフローを使用することができます。
所有者が他のアカウントで作成した`NFToken`をリセールする場合にも、同じワークフローを使用することができます。
<!--{# common link defs #}-->

View File

@@ -3,21 +3,21 @@ html: nftokenacceptoffer.html
parent: transaction-types.html
blurb: NFTokenの購入または売却のオファーを受け入れる。
labels:
- NFTs, Non-fungible Tokens
- NFT, 非代替性トークン
---
# NFTokenAcceptOffer
`NFTokenAcceptOffer` トランザクションは `NFToken` の購入または売却のオファーを受け入れるために使用されます。トランザクションは次のいずれかになります。
`NFTokenAcceptOffer`トランザクションは`NFToken`の購入または売却のオファーを受け入れるために使用されます。トランザクションは次のいずれかになります。
* 1つのオファーを受け入れることを許可する。これは _ダイレクト_ モードと呼ばれます。
* 2つの異なるオファー、1つは与えられた `NFToken` の購入を提案し、もう1つは同じ `NFToken` の売却を提案し、アトミックに受け入れられることを許可します。これは _ブローカー_ モードと呼ばれます。
* 2つの異なるオファー、1つは与えられた`NFToken`の購入を提案し、もう1つは同じ`NFToken`の売却を提案し、アトミックに受け入れられることを許可します。これは _ブローカー_ モードと呼ばれます。
_([NonFungibleTokensV1_1 amendment][]が必要です)_
## ブローカー vs. ダイレクト モード
トランザクションが動作するモードは、トランザクションの `NFTokenSellOffer` フィールドと `NFTokenBuyOffer` フィールドの存在によって決まります。
トランザクションが動作するモードは、トランザクションの`NFTokenSellOffer`フィールドと`NFTokenBuyOffer`フィールドの存在によって決まります。
| `NFTokenSellOffer` | `NFTokenBuyOffer` | Mode |
|:-------------------|:------------------|:---------|
@@ -38,27 +38,27 @@ _([NonFungibleTokensV1_1 amendment][]が必要です)_
ダイレクトモードでは、以下の場合、`NFTokenAcceptOffer`トランザクションは失敗します。
* `NFTokenAcceptOffer` トランザクションの対象となる `NFTokenOffer``NFToken` `購入`オファーであり、`NFTokenAcceptOffer` を送信したアカウントが、実行時に対応する `NFToken` を所有していない場合。
* `NFTokenAcceptOffer` トランザクションの対象となる `NFTokenOffer``NFToken` `売却`オファーであり、実行時に `NFToken` の所有者ではないアカウントが送信している場合。
* `NFTokenAcceptOffer` トランザクションの対象となる `NFTokenOffer``NFToken` `売却`オファーであり、実行時に `NFTokenOffer` 内の受信者である `Account` 以外のアカウントによって送信された場合(存在する場合)。
* `NFTokenAcceptOffer` トランザクションの対象となる `NFTokenOffer``expiration` が設定されており、そのトランザクションが含まれる親レジャーのフィールドの終了時刻が既に経過している場合。
* `NFTokenAcceptOffer` トランザクションの対象となる `NFTokenOffer` が、`NFTokenAcceptOffer` を実行するアカウントが所有し、 `NFToken` の売買が行われる場合。
* `NFTokenAcceptOffer`トランザクションの対象となる`NFTokenOffer``NFToken``購入`オファーであり、`NFTokenAcceptOffer`を送信したアカウントが、実行時に対応する`NFToken`を所有していない場合。
* `NFTokenAcceptOffer`トランザクションの対象となる`NFTokenOffer``NFToken``売却`オファーであり、実行時に`NFToken`の所有者ではないアカウントが送信している場合。
* `NFTokenAcceptOffer`トランザクションの対象となる`NFTokenOffer``NFToken``売却`オファーであり、実行時に`NFTokenOffer`内の受信者である`Account`以外のアカウントによって送信された場合(存在する場合)。
* `NFTokenAcceptOffer`トランザクションの対象となる`NFTokenOffer``expiration`が設定されており、そのトランザクションが含まれる親レジャーのフィールドの終了時刻が既に経過している場合。
* `NFTokenAcceptOffer`トランザクションの対象となる`NFTokenOffer`が、`NFTokenAcceptOffer`を実行するアカウントが所有し、`NFToken`の売買が行われる場合。
このような失敗の副作用として、`NFTokenOffer` オブジェクトが削除され、オファーがキャンセルされたかのように準備金が払い戻されることがあります。このため、適切な `tec` クラスのエラーを使用する必要があります。
このような失敗の副作用として、`NFTokenOffer`オブジェクトが削除され、オファーがキャンセルされたかのように準備金が払い戻されることがあります。このため、適切な`tec`クラスのエラーを使用する必要があります。
トランザクションが正常に実行された場合
* 既存の `owner``NFTokenPage` からトークンが削除され、新しい `owner``NFTokenPage` に追加されます。
* `NFTokenOffer` で指定された通り、購入者から販売者に資金が移動します。対応する `NFToken` のオファーに `TransferFee` が指定されている場合、`issuer` は指定されたパーセンテージを受け取り、残りは `NFToken` の販売者に送られます。
* 既存の`owner``NFTokenPage`からトークンが削除され、新しい`owner``NFTokenPage`に追加されます。
* `NFTokenOffer`で指定された通り、購入者から販売者に資金が移動します。対応する`NFToken`のオファーに`TransferFee`が指定されている場合、`issuer`は指定されたパーセンテージを受け取り、残りは`NFToken`の販売者に送られます。
### ブローカーモード
ブローカーモードでは、以下の場合、`NFTokenAcceptOffer`トランザクションは失敗します。
* `NFTokenAcceptOffer` トランザクションに対する `NFTokenOffer``購入`オファーがトランザクションを送信するアカウントによって所有されている場合。
* `NFTokenAcceptOffer` トランザクションに 対する `NFTokenOffer``売却`オファーが、トランザクションを送信するアカウントによって所有されている場合。
* `NFToken` の売却オファーを出したアカウントが、その実行時に対応する `NFToken` の現在の所有者ではない場合。
* `NFTokenAcceptOffer`トランザクションに対する`NFTokenOffer``購入`オファーがトランザクションを送信するアカウントによって所有されている場合。
* `NFTokenAcceptOffer`トランザクションに対する`NFTokenOffer``売却`オファーが、トランザクションを送信するアカウントによって所有されている場合。
* `NFToken`の売却オファーを出したアカウントが、その実行時に対応する`NFToken`の現在の所有者ではない場合。
* いずれかのオファー(`購入`または`売却`)が`expiration`を指定しており、そのトランザクションが含まれる親レジャーのクローズ時間がすでに経過している場合。
@@ -68,17 +68,17 @@ _([NonFungibleTokensV1_1 amendment][]が必要です)_
| フィールド | JSONの型 | [内部の型][] | 説明 |
|:-------------------|:--------------------|:------------------|:--------------|
| `NFTokenSellOffer` | 文字列 | Hash256 | _(省略可)_ `NFToken` の売却を提案する `NFTokenOffer` の識別情報です。 |
| `NFTokenBuyOffer` | 文字列 | Hash256 | _(省略可)_ `NFToken` の購入を提案する `NFTokenOffer` の識別情報です。 |
| `NFTokenBrokerFee` | [通貨額][] | Amount | _(省略可)_ このフィールドはブローカーモードでのみ有効であり、2つのオファーをまとめるための手数料としてブローカーが保持する金額を指定します。残りの金額は買われる `NFToken` の販売者に送られます。指定する場合、発行者が課す送金手数料を考慮する前に、販売者が受け取る金額が少なくとも売却オファーで示された金額になるように手数料を設定しなければなりません。 |
| `NFTokenSellOffer` | 文字列 | Hash256 | _(省略可)_ `NFToken`の売却を提案する`NFTokenOffer`の識別情報です。 |
| `NFTokenBuyOffer` | 文字列 | Hash256 | _(省略可)_ `NFToken`の購入を提案する`NFTokenOffer`の識別情報です。 |
| `NFTokenBrokerFee` | [通貨額][] | Amount | _(省略可)_ このフィールドはブローカーモードでのみ有効であり、2つのオファーをまとめるための手数料としてブローカーが保持する金額を指定します。残りの金額は`NFToken`の販売者に送られます。指定する場合、発行者が課す送金手数料を考慮する前に、販売者が受け取る金額が少なくとも売却オファーで示された金額になるように手数料を設定しなければなりません。 |
ダイレクトモードでは、`NFTokenSellOffer` または `NFTokenBuyOffer` フィールドの **いずれか** を指定する必要があります。ブローカーモードでは、**両方**のフィールドを指定する必要があります。
ダイレクトモードでは、`NFTokenSellOffer`または`NFTokenBuyOffer`フィールドの**いずれか**を指定する必要があります。ブローカーモードでは、**両方**のフィールドを指定する必要があります。
この機能は、`NFToken`の所有者が第三者のブローカーにトークンの売却を提案し、ブローカーが`NFToken`を所有したり資金を預けることなく、より高額で`NFToken`を売却することを可能にするものです。
両方のオファーが同じ資産に対するものである場合、資金が転送される順序によって、本来成功するはずの取引が、資金不足のために失敗する可能性があります。決定論的なトランザクション実行を保証し、成功の可能性を最大化するために、`NFToken`を購入しようとするアカウントから先に資金が引き落とされます。ブローカーに支払われる資金は、販売者に入金される前に入金されます。
ブローカーモードでは、`NFTokenBuyOffer``NFTokenSellOffer` の両方が同じ `NFTokenID` を指定する必要があります。
ブローカーモードでは、`NFTokenBuyOffer``NFTokenSellOffer`の両方が同じ`NFTokenID`を指定する必要があります。
## エラーケース
@@ -87,15 +87,15 @@ _([NonFungibleTokensV1_1 amendment][]が必要です)_
| エラーコード | 説明 |
|:-----------------------------------|:----------------------------------------|
| `temDISABLED` | [NonFungibleTokensV1の修正][]は有効ではありません。 |
| `temMALFORMED` | トランザクションのフォーマットが正しくありません。たとえば、`NFTokenSellOffer``NFTokenBuyOffer` のどちらも指定されていないか、`NFTokenBrokerFee` に負の値が指定されています。|
| `temMALFORMED` | トランザクションのフォーマットが正しくありません。たとえば、`NFTokenSellOffer``NFTokenBuyOffer`のどちらも指定されていないか、`NFTokenBrokerFee`に負の値が指定されています。|
| `tecCANT_ACCEPT_OWN_NFTOKEN_OFFER` | 購入者と販売者が同じアカウントになっています。 |
| `tecEXPIRED` | トランザクションで指定されたオファーの有効期限が既に切れています。 |
| `tecINSUFFICIENT_FUNDS` | 購入者が申し出た金額を全額持っていない。購入額がXRPで指定されている場合、[所有者準備金](reserves.html)が原因である可能性があります。購入額が発行済み通貨である場合、トークンが[凍結](freezes.html) されていることが原因と考えられま す。 |
| `tecINSUFFICIENT_FUNDS` | 購入者が申し出た金額を全額持っていない。購入額がXRPで指定されている場合、[所有者準備金](reserves.html)が原因である可能性があります。購入額が発行済み通貨である場合、トークンが[凍結](freezes.html) されていることが原因と考えられます。 |
| `tecINSUFFICIENT_PAYMENT` | ブローカーモードにおいて、提示された購入額は、`BrokerFee` _および_ `NFToken`の売却コストを支払うには十分な額ではありません。 |
| `tecOBJECT_NOT_FOUND` | トランザクションで指定されたオファーがレジャーに存在しません。 |
| `tecNFTOKEN_BUY_SELL_MISMATCH` | ブローカーモードにおいて、2つのオファーが有効なマッチングではありません。例えば、販売者が購入者の提示額よりも高い金額を提示している、購入と売却のオファーが異なる通貨で提示されている、販売者が購入者や ブローカーとは異なる販売先を指定している、などです。 |
| `tecNFTOKEN_OFFER_TYPE_MISMATCH` | `NFTokenBuyOffer` で識別されるオブジェクトが実際には購入オファーでない、または `NFTokenSellOffer` で識別されるオブジェクトが実際には売却オファーでない場合です。|
| `tecNO_PERMISSION` | 販売者が売却する `NFToken` を所有していません。または、マッチングオファーが、オファーを受け入れるアカウントとは異なる `Destination` アカウントを指定しています。 |
| `tecNFTOKEN_OFFER_TYPE_MISMATCH` | `NFTokenBuyOffer`で識別されるオブジェクトが実際には購入オファーでない、または`NFTokenSellOffer`で識別されるオブジェクトが実際には売却オファーでない場合です。|
| `tecNO_PERMISSION` | 販売者が売却する`NFToken`を所有していません。または、マッチングオファーが、オファーを受け入れるアカウントとは異なる`Destination`アカウントを指定しています。 |
<!--{# common link defs #}-->

View File

@@ -3,15 +3,15 @@ html: nftokenburn.html
parent: transaction-types.html
blurb: TokenBurnを使用して、NFTを永久に破棄します。
labels:
- Non-fungible Tokens, NFTs
- 非代替性トークン, NFT
---
# NFTokenBurn
NFTokenBurn トランザクションは、`NFToken` オブジェクトを保持している `NFTokenPage` 内から削除し、トークンをレジャーから削除( _バーン_ )することになります。
NFTokenBurnトランザクションは、`NFToken`オブジェクトを保持している`NFTokenPage`内から削除し、トークンをレジャーから削除( _バーン_ )することになります。
このトランザクションの送信者は、`NFToken` の所有者でなければなりません。`NFToken``lsfBurnable` フラグを有効にしている場合、代わりに発行者または発行者の `NFTokenMinter` によって許可されているアカウントの場合があります。
このトランザクションの送信者は、`NFToken`の所有者でなければなりません。`NFToken``lsfBurnable`フラグを有効にしている場合、代わりに発行者または発行者の`NFTokenMinter`によって許可されているアカウントの場合があります。
この操作に成功すると、対応する `NFToken` が削除されます。この操作によって `NFToken` を保持している `NFTokenPage` が空になるか、統合されて `NFTokenPage` が削除されると、所有者準備金が1つ減ります。
この操作に成功すると、対応する`NFToken`が削除されます。この操作によって`NFToken`を保持している`NFTokenPage`が空になるか、統合されて`NFTokenPage`が削除されると、所有者準備金が1つ減ります。
_([NonFungibleTokensV1_1 amendment][]が必要です)_
@@ -32,7 +32,7 @@ _([NonFungibleTokensV1_1 amendment][]が必要です)_
| フィールド | JSONの型 | [内部の型][] | 説明 |
|:------------------|:----------|:------------------|:-------------------------|
| `NFTokenID` | 文字列 | Hash256 | このトランザクションによって削除される `NFToken` を指定します。 |
| `NFTokenID` | 文字列 | Hash256 | このトランザクションによって削除される`NFToken`を指定します。 |
| `Owner` | 文字列 | AccountID | _(省略可)_ Burnする`NFToken`の所有者。所有者がこのトランザクションを送信するアカウントと異なる場合にのみ使用されます。発行者または許可された発行者は、`lsfBurnable`フラグが有効なNFTをBurnするために、このフィールドを使用することができます。 |

View File

@@ -3,11 +3,11 @@ html: nftokencanceloffer.html
parent: transaction-types.html
blurb: NFTokenの売買のための既存のトークンへのオファーをキャンセルする。
labels:
- NFTs, Non-fungible Tokens
- NFT, 非代替性トークン
---
# NFTokenCancelOffer
`NFTokenCancelOffer` トランザクションは、`NFTokenCreateOffer` を使用して作成した既存のトークンへのオファーをキャンセルするために使用できます。
`NFTokenCancelOffer`トランザクションは、`NFTokenCreateOffer`を使用して作成した既存のトークンへのオファーをキャンセルするために使用できます。
## {{currentpage.name}} JSONの例
@@ -29,22 +29,22 @@ _([NonFungibleTokensV1_1 amendment][]が必要です)_
`NFTokenOffer` オブジェクトで表される既存のオファーは、以下の方法でキャンセルすることができます。
* `NFTokenOffer`を最初に作成したアカウント
* `NFTokenOffer` `Destination` フィールドのアカウント(存在する場合)
* `NFTokenOffer``Destination`フィールドのアカウント(存在する場合)
* `NFTokenOffer`が有効期限を指定しており、`NFTokenCancelOffer`が含まれる親レジャーのクローズ時刻が有効期限より大きい場合、任意のアカウントに設定することができます
このトランザクションは、リストアップされた `NFTokenOffer` オブジェクトがあればレジャーから削除し、それに応じて必要な準備金を調整します。`NFTokenOffer` が見つからなくてもエラーにはなりません。その場合、トランザクションは正常に完了するでしょう。
このトランザクションは、リストアップされた`NFTokenOffer`オブジェクトがあればレジャーから削除し、それに応じて必要な準備金を調整します。`NFTokenOffer`が見つからなくてもエラーにはなりません。その場合、トランザクションは正常に完了するでしょう。
{% include '_snippets/tx-fields-intro.md' %}
| フィールド | JSONの型 | [内部の型][] | 説明 |
|:------------------|:----------|:------------------|:-------------------------|
| `NFTokenOffers` | 配列 | VECTOR256 | キャンセルする `NFTokenOffer` オブジェクトの ID の配列 (`NFToken` オブジェクトの ID ではなく、`NFTokenOffer` オブジェクトの ID)です。各エントリーは [NFTokenOffer](nftokenoffer.html) オブジェクトの異なる [オブジェクト ID](ledger-object-ids.html) である必要があり、配列に重複した項目がある場合、トランザクションはエラーとなります。 |
| `NFTokenOffers` | 配列 | VECTOR256 | キャンセルする`NFTokenOffer`オブジェクトのIDの配列(`NFToken`オブジェクトのIDではなく、`NFTokenOffer`オブジェクトのID)です。各エントリーは[NFTokenOffer](nftokenoffer.html)オブジェクトの異なる[オブジェクトID](ledger-object-ids.html)である必要があり、配列に重複した項目がある場合、トランザクションはエラーとなります。 |
`NFTokenOffers` フィールドの ID の 1 つ以上が、レジャーに現在存在するオブジェクトを参照していない場合でも、トランザクションは成功しますたとえば、それらのオファーはすでに削除されている可能性があります。ID の 1 つが存在するオブジェクトを指していても、[NFTokenOffer](nftokenoffer.html) オブジェクトでない場合は、エラーでトランザクションが失敗します。
`NFTokenOffers`フィールドのIDの1つ以上が、レジャーに現在存在するオブジェクトを参照していない場合でも、トランザクションは成功しますたとえば、それらのオファーはすでに削除されている可能性があります。IDの1つが存在するオブジェクトを指していても、[NFTokenOffer](nftokenoffer.html)オブジェクトでない場合は、エラーでトランザクションが失敗します。
注意すべき点は、誤って `nft_offer_index` ではなく `nft_id` を指定してしまった場合、 `tesSUCCESS` 応答を受け取る可能性があることです。適切にフォーマットされた ID 値が見つからない場合、システムは `NFTokenOffer` が既に削除されたと判断するからです。
注意すべき点は、誤って`nft_offer_index`ではなく`nft_id`を指定してしまった場合、`tesSUCCESS`応答を受け取る可能性があることです。適切にフォーマットされたID値が見つからない場合、システムは`NFTokenOffer`が既に削除されたと判断するからです。
ID のいずれかが、存在するが [NFTokenOffer](nftokenoffer.html) オブジェクトでないオブジェクトを指している場合、トランザクションはエラーで失敗します。
ID[NFTokenOffer](nftokenoffer.html)オブジェクトでないオブジェクトを指している場合、トランザクションはエラーで失敗します。
## エラーケース
@@ -53,8 +53,8 @@ ID のいずれかが、存在するが [NFTokenOffer](nftokenoffer.html) オブ
| エラーコード | 説明 |
|:-------------------|:--------------------------------------------------------|
| `temDISABLED` | [NonFungibleTokensV1の修正][]は有効ではありません。 |
| `temMALFORMED` | トランザクションが有効なフォーマットではありませんでした。たとえば、`NFTokenOffers` 配列が空であるか、一度にキャンセルできるオファーの最大数を超える数を含んでいた場合です。 |
| `tecNO_PERMISSION` | `NFTokenOffers` フィールドの ID のうち少なくとも 1 つが、キャンセルできないオブジェクトを参照しています。例えば、このトランザクションの送信者がオファーの所有者や`Destination`ではない場合や、オブジェクトが`NFTokenOffer`タイプのオブジェクトではなかった場合などです。 |
| `temMALFORMED` | トランザクションが有効なフォーマットではありませんでした。たとえば、`NFTokenOffers`配列が空であるか、一度にキャンセルできるオファーの最大数を超える数を含んでいた場合です。 |
| `tecNO_PERMISSION` | `NFTokenOffers`フィールドのIDのうち少なくとも1つが、キャンセルできないオブジェクトを参照しています。例えば、このトランザクションの送信者がオファーの所有者や`Destination`ではない場合や、オブジェクトが`NFTokenOffer`タイプのオブジェクトではなかった場合などです。 |
<!--{# common link defs #}-->
{% include '_snippets/rippled-api-links.md' %}

View File

@@ -3,7 +3,7 @@ html: nftokencreateoffer.html
parent: transaction-types.html
blurb: NFTの売買のオファーを作成する。
labels:
- Non-fungible Tokens, NFTs
- 非代替性トークン, NFT
---
# NFTokenCreateOffer

View File

@@ -1,19 +1,19 @@
---
html: nftokenmint.html
parent: transaction-types.html
blurb: TokenMintを使用して新規NFTを発行する。.
blurb: TokenMintを使用して新規NFTを発行する。
labels:
- Non-fungible Tokens, NFTs
- 非代替性トークン, NFT
---
# NFTokenMint
[[ソース]](https://github.com/ripple/rippled/blob/master/src/ripple/app/tx/impl/NFTokenMint.cpp "Source")
`NFTokenMint` トランザクションは非代替性トークンを作成し、`NFTokenMinter` の関連する [NFTokenPage object][] に [NFToken][] オブジェクトとして追加します。このトランザクションの必須パラメーターは `Token` フィールドで、実際のトークンを指定します。このトランザクションは `NFTokenMinter` にとって、不変と定義されているトークン フィールド (例えば `Flags`) を設定することができる唯一の方法です。
`NFTokenMint`トランザクションは非代替性トークンを作成し、`NFTokenMinter`に紐付く[NFTokenPageオブジェクト][]に[NFToken][]オブジェクトとして追加します。このトランザクションの必須パラメータ`Token`フィールドで、実際のトークンを指定します。このトランザクションは`NFTokenMinter`にとって、不変と定義されているトークンフィールド(例えば`Flags`)を設定することができる唯一の方法です。
_([NonFungibleTokensV1_1 amendment][]が必要です)_
## {currentpage.name}} JSONの例
## {{currentpage.name}} JSONの例
```json
@@ -42,10 +42,10 @@ _([NonFungibleTokensV1_1 amendment][]が必要です)_
| フィールド | JSONの型 | [内部の型][] | 説明 |
|:--------------|:--------------------|:------------------|:-------------------|
| `NFTokenTaxon` | 数値 | UInt32 | トークンに関連する分類群。Taxonは通常、トークンの発行者が選択した値である。1つのTaxonは複数のトークンに使用することができます。`0xFFFF'FFFF`より大きいTaxonの識別子は使用できません。 |
| `Issuer` | 文字列 | AccountID | _(省略可)_ The 送信元アカウントが他のアカウントの代理としてトークンを発行する場合における、トークンの発行者。トランザクションを送信するアカウントが `NFToken` の発行者である場合、このフィールドは指定してはいけません。指定される場合、発行者の [AccountRoot オブジェクト][] には `NFTokenMinter` フィールドが、このトランザクションの送信者 (このトランザクションの `Account` フィールド) に設定されていなければなりません。 |
| `TransferFee` | 数値 | UInt16 | _(省略可)_ この値は、`NFToken`の二次販売が許可されている場合に、発行者が徴収する手数料を指定します。このフィールドの有効な値は0から50000の間で、0.001刻みで0.00%から50.00%の送金手数料を設定することができます。このフィールドが設定されている場合、トランザクションは [`tfTransferable` フラグ](#nftokenmintフラグ) を有効にしなければなりません。 |
| `URI` | 文字列 | Blob | _(省略可)_ 最大 256 バイトの任意のデータ。JSONでは、16進数の文字列としてエンコードされる必要があります。URIを16進数に変換するために、[`xrpl.convertStringToHex`](https://js.xrpl.org/modules.html#convertStringToHex)ユーティリティを使用することができます。これは、NFTに関連するデータまたはメタデータを指し示すURIであることを想定しています。コンテンツは、HTTP または HTTPS URL、IPFS URI、マグネットリンク、[RFC2379 "data" URL](https://datatracker.ietf.org/doc/html/rfc2397) としてエンコードされた即値データ、あるいは発行者固有のエンコーディングにデコードされていることがあります。URIの有効性はチェックされません。 |
| `NFTokenTaxon` | 数値 | UInt32 | トークンに関連する分類群。Taxonは通常、トークンの発行者が選択した値で。1つのTaxonは複数のトークンに使用することができます。`0xFFFFFFFF`より大きいTaxonの識別子は使用できません。 |
| `Issuer` | 文字列 | AccountID | _(省略可)_ 送信元アカウントが他のアカウントの代理としてトークンを発行する場合における、トークンの発行者。トランザクションを送信するアカウントが `NFToken` の発行者である場合、このフィールドは指定してはいけません。指定される場合、発行者の[AccountRootオブジェクト][]には `NFTokenMinter` フィールドが、このトランザクションの送信者(このトランザクションの`Account`フィールド)に設定されていなければなりません。 |
| `TransferFee` | 数値 | UInt16 | _(省略可)_ この値は、`NFToken`の二次販売が許可されている場合に、発行者が徴収する手数料を指定します。このフィールドの有効な値は0から50000の間で、0.001刻みで0.00%から50.00%の送金手数料を設定することができます。このフィールドが設定されている場合、トランザクションは[`tfTransferable`フラグ](#nftokenmintフラグ) を有効にしなければなりません。 |
| `URI` | 文字列 | Blob | _(省略可)_ 最大256バイトの任意のデータ。JSONでは、16進数の文字列としてエンコードされる必要があります。URIを16進数に変換するために、[`xrpl.convertStringToHex`](https://js.xrpl.org/modules.html#convertStringToHex)ユーティリティを使用することができます。これは、NFTに関連するデータまたはメタデータを指し示すURIであることを想定しています。コンテンツは、HTTPまたはHTTPS URL、IPFS URI、マグネットリンク、[RFC2379 "data" URL](https://datatracker.ietf.org/doc/html/rfc2397) としてエンコードされた即値データ、あるいは発行者固有のエンコーディングにデコードされていることがあります。URIの有効性はチェックされません。 |
@@ -55,22 +55,22 @@ NFTokenMint型のトランザクションでは、以下のように[`Flags`フ
| フラグ名 | 16進数値 | 整数値 | 説明 |
|:--------------|:-------------|:--------------|:------------------------------|
| `tfBurnable` | `0x00000001` | 1 | 発行者 (または発行者が許可した者)`NFToken` を破棄できるようにします。(`NFToken` の所有者は常に破棄することができます)。 |
| `tfOnlyXRP` | `0x00000002` | 2 | 発行された `NFToken`XRP でのみ売買が可能です。これは、トークンに送金手数料がかかり、発行者が XRP 以外の発行済み通貨で手数料を受け取りたくない場合に望ましいでしょう。 |
| `tfTrustLine` | `0x00000004` | 4 | **非推奨** 発行者が、発行した `NFToken` を転送する際に受け取る手数料を保有するために、自動的に [トラストライン](trust-lines-and-issuing.html) を作成します。[fixRemoveNFTokenAutoTrustLineの修正][]により、このフラグの設定は無効となります。 |
| `tfTransferable` | `0x00000008` | 8 | 発行された `NFToken` は他の人に譲渡することができます。このフラグが _有効でない_ 場合、トークンは _発行者から_ 、または _発行者へ_ 転送することができます。 |
| `tfBurnable` | `0x00000001` | 1 | 発行者(または発行者が許可した者)`NFToken`を破棄できるようにします。(`NFToken`の所有者は常に破棄することができます)。 |
| `tfOnlyXRP` | `0x00000002` | 2 | 発行された`NFToken`XRPでのみ売買が可能です。これは、トークンに送金手数料がかかり、発行者がXRP以外の発行済み通貨で手数料を受け取りたくない場合に望ましいでしょう。 |
| `tfTrustLine` | `0x00000004` | 4 | **非推奨** 発行者が、発行した`NFToken`を転送する際に受け取る手数料を保有するために、自動的に[トラストライン](trust-lines-and-issuing.html) を作成します。[fixRemoveNFTokenAutoTrustLineの修正][]により、このフラグの設定は無効となります。 |
| `tfTransferable` | `0x00000008` | 8 | 発行された`NFToken`は他の人に譲渡することができます。このフラグが _有効でない_ 場合、トークンは _発行者から_ 、または _発行者へ_ のみ転送することができます。 |
## 追加情報の埋め込み
発行時に追加情報を指定する必要がある場合 (たとえば、特定の [区画] (https://en.wikipedia.org/wiki/Plat) を参照して不動産 を特定できる詳細情報、[車両識別番号] (https://ja.wikipedia.org/wiki/%E8%BB%8A%E4%B8%A1%E8%AD%98%E5%88%A5%E7%95%AA%E5%8F%B7) を指定して車両を特定できる詳細情報、その他オブジェクト固有の説明)、 [取引メモ] (transaction-common-fields.html#memosフィールド) を使用することができます。メモは署名された取引の一部であり、履歴アーカイブから入手できますが、レジャーの状態データには保存されません。
発行時に追加情報を指定する必要がある場合(たとえば、特定の[区画](https://en.wikipedia.org/wiki/Plat)を参照して不動産を特定できる詳細情報、[車両識別番号](https://ja.wikipedia.org/wiki/%E8%BB%8A%E4%B8%A1%E8%AD%98%E5%88%A5%E7%95%AA%E5%8F%B7)を指定して車両を特定できる詳細情報、その他オブジェクト固有の説明)、[取引メモ](transaction-common-fields.html#memosフィールド)を使用することができます。メモは署名された取引の一部であり、履歴アーカイブから入手できますが、レジャーの状態データには保存されません。
## 他のアカウントの代わりとして発行する
別のアカウントで NFT を発行する場合、次の 2 つを実行する必要があります。*アカウント A* があなたのアカウントで、*アカウント B*NFToken を発行したいアカウントであるとします。
別のアカウントでNFTを発行する場合、次の2つを実行する必要があります。*アカウント A*があなたのアカウントで、*アカウント B*NFTokenを発行したいアカウントであるとします。
1. *アカウントB*の`NFTokenMinter`アカウント設定を、*アカウントA*に設定します。(これは、*アカウントB*が自分に代わってNFTを作成するために*アカウントA*を信頼することを意味します)。
2. NFTokenを発行する際、`Issuer` フィールドをアカウントBに設定します。
1. *アカウントB*の`NFTokenMinter`アカウント設定を、*アカウントA*に設定します。(これは、*アカウントB*が自分に代わってNFTを作成するために*アカウントA*を信頼することを意味します)。
2. NFTokenを発行する際、`Issuer`フィールドをアカウントBに設定します。
### NFTokenMintと発行者の組み合わせ例
@@ -97,7 +97,7 @@ NFTokenMint型のトランザクションでは、以下のように[`Flags`フ
```
このトランザクションは、発行者である `rNCFjv8Ek5oDrNiMJ3pw6eLFtMjZLJnf2` がその `AccountRoot``NFTokenMinter` フィールド `rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B` と設定して、そのアカウントが自身に代わってトークンを発行する権限を与えていると想定したものです。
このトランザクションは、発行者である`rNCFjv8Ek5oDrNiMJ3pw6eLFtMjZLJnf2`がその`AccountRoot``NFTokenMinter`フィールド `rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B`と設定して、そのアカウントが自身に代わってトークンを発行する権限を与えていると想定したものです。
## エラーケース
@@ -107,12 +107,12 @@ NFTokenMint型のトランザクションでは、以下のように[`Flags`フ
|:------------------------------|:---------------------------------------------|
| `temDISABLED` | [NonFungibleTokensV1の修正][]は有効ではありません。 |
| `temBAD_NFTOKEN_TRANSFER_FEE` | `TransferFee`が許容範囲外です。 |
| `temINVALID_FLAG` | `Flags` 値には、許可されていない、または有効なフラグでないビットが有効になっています。[fixRemoveNFTokenAutoTrustLine amendment][] が有効になっている場合、`tfTrustLine` フラグはこのエラーを発生させます。|
| `temINVALID_FLAG` | `Flags`値には、許可されていない、または有効なフラグでないビットが有効になっています。[fixRemoveNFTokenAutoTrustLine amendment][]が有効になっている場合、`tfTrustLine`フラグはこのエラーを発生させます。|
| `temMALFORMED` | トランザクションが正しく指定されていません。例えば、`URI`フィールドが256バイトより長い場合です。 |
| `tecNO_ISSUER` | `Issuer`は、レジャーに存在しないアカウントを指定しています。 |
| `tecNO_PERMISSION` | `Issuer`フィールドで参照されるアカウントは、このトランザクションの送信者(`NFTokenMinter`設定を使用)が自身の代わりに発行することを承認していません。 |
| `tecINSUFFICIENT_RESERVE` | トークンを発行した後、オーナーは更新された[ 準備金要件 ](reserves.html) を満たせなくなります。新しい`NFToken`は、新しい[NFTokenPageオブジェクト][]を必要とする場合にのみ、オーナーの準備金を増加させることに注意する必要があり、それぞれ最大32 NFTを格納することができます。|
| `tecMAX_SEQUENCE_REACHED` | `Issuer` `MintedNFTokens` フィールドはすでに最大値になっています。これは、発行者またはその代理人が合計で 2<sup>32</sup>-1 つの `NFToken` を発行した場合にのみ発生します。 |
| `tecINSUFFICIENT_RESERVE` | トークンを発行した後、オーナーは更新された[準備金要件](reserves.html)を満たせなくなります。新しい`NFToken`は、新しい[NFTokenPageオブジェクト][]を必要とする場合にのみ、オーナーの準備金を増加させることに注意する必要があり、それぞれ最大32NFTを格納することができます。|
| `tecMAX_SEQUENCE_REACHED` | `Issuer``MintedNFTokens`フィールドはすでに最大値になっています。これは、発行者またはその代理人が合計で2<sup>32</sup>-1つの`NFToken`を発行した場合にのみ発生します。 |
<!--{# common link defs #}-->

View File

@@ -54,7 +54,7 @@ Channelの**宛先アドレス**は以下の操作を実行できます。
| `Signature` | 文字列 | Blob | _省略可_ クレームの署名です16進数。署名付きメッセージには、Channel IDとクレームの額が含まれています。トランザクションの送信者がChannelの支払元アドレスでない場合には必須です。 |
| `PublicKey` | 文字列 | Blob | _省略可_ 署名に使用する公開鍵16進数。公開鍵はレジャーに保管されているこのChannelの`PublicKey`と一致している必要があります。トランザクションの送信者がChannelの支払元アドレスでない場合には必須です。また`Signature`フィールドは省略されます。(`rippled`がトランザクションをレジャーに適用する前に署名の有効性をチェックできるように、トランザクションにPubKeyが指定されています。 |
[DeletableAccounts Amendment](known-amendments.html#deletableaccounts) :not_enabledが有効であり、 _かつ_ Payment Channelの作成時に[fixPayChanRecipientOwnerDir Amendment](known-amendments.html#fixpaychanrecipientownerdir)が有効でなかった場合は、Payment Channelの送金先が[削除](accounts.html#アカウントの削除)され、現在レジャーに存在しない可能性があります。宛先が削除されている場合、支払元アカウントはチャネルから宛先にXRPを送金できません。トランザクションは`tecNO_DST`で失敗します。もちろん、削除されたアカウントがトランザクションを送信することはできません。宛先アカウントが削除されている場合に、このトランザクションタイプを他の用途チャネルの有効期限の調整、XRPのないチャネルのクローズ、有効期限を過ぎたチャネルの削除などで使用しても影響はありません。
[DeletableAccounts Amendment](known-amendments.html#deletableaccounts)が有効であり、 _かつ_ Payment Channelの作成時に[fixPayChanRecipientOwnerDir Amendment](known-amendments.html#fixpaychanrecipientownerdir)が有効でなかった場合は、Payment Channelの送金先が[削除](accounts.html#アカウントの削除)され、現在レジャーに存在しない可能性があります。宛先が削除されている場合、支払元アカウントはチャネルから宛先にXRPを送金できません。トランザクションは`tecNO_DST`で失敗します。もちろん、削除されたアカウントがトランザクションを送信することはできません。宛先アカウントが削除されている場合に、このトランザクションタイプを他の用途チャネルの有効期限の調整、XRPのないチャネルのクローズ、有効期限を過ぎたチャネルの削除などで使用しても影響はありません。
## PaymentChannelClaimフラグ

View File

@@ -303,7 +303,7 @@ ripple-lib 1.xでは、全てのメソッドとプロパティは、`RippleAPI`
| `combine()` | [`xrpl.multisign()`](https://js.xrpl.org/modules.html#multisign) | |
| `submit()` | [`Client.submit()`](https://js.xrpl.org/classes/Client.html#submit) | また、信頼性の高いトランザクション送信も可能になりました。詳細は、[トランザクション送信](#トランザクションの送信)を参照してください。 |
| `generateXAddress()` | [`xrpl.Wallet.generate()`](https://js.xrpl.org/classes/Wallet.html#generate) | `xrpl.Wallet.generate()` で [`Wallet` インスタンス](https://js.xrpl.org/classes/Wallet.html) を作成し、ウォレットのインスタンスで `.getXAddress()` を呼び出して X-address を取得します。 詳しくは、[キーおよびウォレット](#キーおよびウォレット)を参照してください。 |
| `generateAddress()` | [`xrpl.Wallet.generate()`](https://js.xrpl.org/classes/Wallet.html#generate) | [`Wallet`インスタンス](https://js.xrpl.org/classes/Wallet.html)を作成します。. 詳しくは、[キーおよびウォレット](#キーおよびウォレット)を参照してください。 |
| `generateAddress()` | [`xrpl.Wallet.generate()`](https://js.xrpl.org/classes/Wallet.html#generate) | [`Wallet`インスタンス](https://js.xrpl.org/classes/Wallet.html)を作成します。詳しくは、[キーおよびウォレット](#キーおよびウォレット)を参照してください。 |
| `isValidAddress()` | [`xrpl.isValidAddress()`](https://js.xrpl.org/modules.html#isValidAddress) | 現在は、モジュールの静的メソッドです。 |
| `isValidSecret()` | [`xrpl.isValidSecret()`](https://js.xrpl.org/modules.html#isValidSecret) | 現在は、モジュールの静的メソッドです。 |
| `deriveKeypair()` | [`xrpl.deriveKeypair()`](https://js.xrpl.org/modules.html#deriveKeypair) | 現在は、モジュールの静的メソッドです。 |