NFTokenBurn
NFTokenBurnトランザクションは、NFToken
オブジェクトを保持しているNFTokenPage
内から削除し、トークンをレジャーから削除( バーン )することになります。
このトランザクションの送信者は、NFToken
の所有者でなければなりません。NFToken
がlsfBurnable
フラグを有効にしている場合、代わりに発行者または発行者のNFTokenMinter
によって許可されているアカウントの場合があります。
この操作に成功すると、対応するNFToken
が削除されます。この操作によってNFToken
を保持しているNFTokenPage
が空になるか、統合されてNFTokenPage
が削除されると、所有者準備金が1つ減ります。
(NonFungibleTokensV1_1 amendmentにより追加されました)
NFTokenBurn JSONの例
{ "TransactionType": "NFTokenBurn", "Account": "rNCFjv8Ek5oDrNiMJ3pw6eLLFtMjZLJnf2", "Owner": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B", "Fee": "10", "NFTokenID": "000B013A95F14B0044F78A264E41713C64B5F89242540EE208C3098E00000D65" }
NFTokenBurn フィールド
共通フィールドに加えて、NFTokenBurnトランザクションは以下のフィールドを使用します。
フィールド | JSONの型 | 内部の型 | 説明 |
---|---|---|---|
NFTokenID | 文字列 | Hash256 | このトランザクションによって削除されるNFToken を指定します。 |
Owner | 文字列 | AccountID | (省略可) BurnするNFToken の所有者。所有者がこのトランザクションを送信するアカウントと異なる場合にのみ使用されます。発行者または許可された発行者は、lsfBurnable フラグが有効なNFTをBurnするために、このフィールドを使用することができます。 |
エラーケース
すべてのトランザクションで発生する可能性のあるエラーに加えて、NFTokenBurnトランザクションでは、次のトランザクション結果コードが発生する可能性があります。
エラーコード | 説明 |
---|---|
temDISABLED | NonFungibleTokensV1 Amendmentは有効ではありません。 |
tecNO_ENTRY | 指定された TokenID が見つかりませんでした。 |
tecNO_PERMISSION | このアカウントにはトークンをBurnする権限がありません。 |