NFTokenMint
NFTokenMint
トランザクションは非代替性トークンを作成し、NFTokenMinter
の関連する NFTokenPage object に NFToken オブジェクトとして追加します。このトランザクションの必須パラメーターは Token
フィールドで、実際のトークンを指定します。このトランザクションは NFTokenMinter
にとって、不変と定義されているトークン フィールド (例えば Flags
) を設定することができる唯一の方法です。
(NonFungibleTokensV1_1 amendmentが必要です)
{currentpage.name}} JSONの例
{
"TransactionType": "NFTokenMint",
"Account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"TransferFee": 314,
"NFTokenTaxon": 0,
"Flags": 8,
"Fee": "10",
"URI": "697066733A2F2F62616679626569676479727A74357366703775646D37687537367568377932366E6634646675796C71616266336F636C67747179353566627A6469",
"Memos": [
{
"Memo": {
"MemoType":
"687474703A2F2F6578616D706C652E636F6D2F6D656D6F2F67656E65726963",
"MemoData": "72656E74"
}
}
]
}
NFTokenMint Fields
In addition to the common fields, NFTokenMint transactions use the following fields:
フィールド | 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 フラグ を有効にしなければなりません。 |
URI |
文字列 | Blob | (省略可) 最大 256 バイトの任意のデータ。JSONでは、16進数の文字列としてエンコードされる必要があります。URIを16進数に変換するために、xrpl.convertStringToHex ユーティリティを使用することができます。これは、NFTに関連するデータまたはメタデータを指し示すURIであることを想定しています。コンテンツは、HTTP または HTTPS URL、IPFS URI、マグネットリンク、RFC2379 "data" URL としてエンコードされた即値データ、あるいは発行者固有のエンコーディングにデコードされていることがあります。URIの有効性はチェックされません。 |
NFTokenMintフラグ
NFTokenMint型のトランザクションでは、以下のようにFlags
フィールドに追加の値を設定することが可能です。
フラグ名 | 16進数値 | 整数値 | 説明 |
---|---|---|---|
tfBurnable |
0x00000001 |
1 | 発行者 (または発行者が許可した者) が NFToken を破棄できるようにします。(NFToken の所有者は常に破棄することができます)。 |
tfOnlyXRP |
0x00000002 |
2 | 発行された NFToken は XRP でのみ売買が可能です。これは、トークンに送金手数料がかかり、発行者が XRP 以外の発行済み通貨で手数料を受け取りたくない場合に望ましいでしょう。 |
tfTrustLine |
0x00000004 |
4 | 非推奨 発行者が、発行した NFToken を転送する際に受け取る手数料を保有するために、自動的に トラストライン を作成します。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フィールド) を使用することができます。メモは署名された取引の一部であり、履歴アーカイブから入手できますが、レジャーの状態データには保存されません。
他のアカウントの代わりとして発行する
別のアカウントで NFT を発行する場合、次の 2 つを実行する必要があります。アカウント A があなたのアカウントで、アカウント B が NFToken を発行したいアカウントであるとします。
- アカウントBの
NFTokenMinter
アカウント設定を、アカウントAに設定します。(これは、アカウントBが、自分に代わってNFTを作成するためにアカウントAを信頼することを意味します)。 - NFTokenを発行する際、
Issuer
フィールドをアカウントBに設定します。
NFTokenMintと発行者の組み合わせ例
{
"TransactionType": "NFTokenMint",
"Account": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
"Issuer": "rNCFjv8Ek5oDrNiMJ3pw6eLLFtMjZLJnf2",
"TransferFee": 25000,
"NFTokenTaxon": 0,
"Flags": 8,
"Fee": "10",
"URI": "697066733A2F2F62616679626569676479727A74357366703775646D37687537367568377932366E6634646675796C71616266336F636C67747179353566627A6469",
"Memos": [
{
"Memo": {
"MemoType":
"687474703A2F2F6578616D706C652E636F6D2F6D656D6F2F67656E65726963",
"MemoData": "72656E74"
}
}
]
}
このトランザクションは、発行者である rNCFjv8Ek5oDrNiMJ3pw6eLFtMjZLJnf2
がその AccountRoot
の NFTokenMinter
フィールドを rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B
と設定して、そのアカウントが自身に代わってトークンを発行する権限を与えていると想定したものです。
エラーケース
すべてのトランザクションで発生する可能性のあるエラーに加えて、NFTokenMintトランザクションでは、次のトランザクション結果コードが発生する可能性があります。
エラーコード | 説明 |
---|---|
temDISABLED |
NonFungibleTokensV1の修正は有効ではありません。 |
temBAD_NFTOKEN_TRANSFER_FEE |
TransferFee が許容範囲外です。 |
temINVALID_FLAG |
Flags 値には、許可されていない、または有効なフラグでないビットが有効になっています。fixRemoveNFTokenAutoTrustLine amendment が有効になっている場合、tfTrustLine フラグはこのエラーを発生させます。 |
temMALFORMED |
トランザクションが正しく指定されていません。例えば、URI フィールドが256バイトより長い場合です。 |
tecNO_ISSUER |
Issuer は、レジャーに存在しないアカウントを指定しています。 |
tecNO_PERMISSION |
Issuer フィールドで参照されるアカウントは、このトランザクションの送信者(NFTokenMinter 設定を使用)が自身の代わりに発行することを承認していません。 |
tecINSUFFICIENT_RESERVE |
トークンを発行した後、オーナーは更新された 準備金要件 を満たせなくなります。新しいNFToken は、新しいNFTokenPageオブジェクトを必要とする場合にのみ、オーナーの準備金を増加させることに注意する必要があり、それぞれ最大32 NFTを格納することができます。 |
tecMAX_SEQUENCE_REACHED |
Issuer の MintedNFTokens フィールドはすでに最大値になっています。これは、発行者またはその代理人が合計で 232-1 つの NFToken を発行した場合にのみ発生します。 |