NFTokenBurn

[Source]

The NFTokenBurn transaction is used to remove a NFToken object from the NFTokenPage in which it is being held, effectively removing the token from the ledger (burning it).

The sender of this transaction must be the owner of the NFToken to burn; or, if the NFToken has the lsfBurnable flag enabled, can be the issuer or the issuer's authorized NFTokenMinter account instead.

If this operation succeeds, the corresponding NFToken is removed. If this operation empties the NFTokenPage holding the NFToken or results in consolidation, thus removing a NFTokenPage, the owner’s reserve requirement is reduced by one.

(Added by the NonFungibleTokensV1_1 amendment.)

Example NFTokenBurn JSON

{
  "TransactionType": "NFTokenBurn",
  "Account": "rNCFjv8Ek5oDrNiMJ3pw6eLLFtMjZLJnf2",
  "Owner": "rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B",
  "Fee": "10",
  "NFTokenID": "000B013A95F14B0044F78A264E41713C64B5F89242540EE208C3098E00000D65"
}

Query example transaction.

NFTokenBurn Fields

In addition to the common fields, NFTokenBurn transactions use the following fields:

Field	JSON Type	Internal Type	Description
`NFTokenID`	String	Hash256	The `NFToken` to be removed by this transaction.
`Owner`	String	AccountID	(Optional) The owner of the `NFToken` to burn. Only used if that owner is different than the account sending this transaction. The issuer or authorized minter can use this field to burn NFTs that have the `lsfBurnable` flag enabled.

Error Cases

Besides errors that can occur for all transactions, NFTokenBurn transactions can result in the following transaction result codes:

Error Code	Description
`temDISABLED`	The NonFungibleTokensV1 amendment is not enabled.
`tecNO_ENTRY`	The specified `TokenID` was not found.
`tecNO_PERMISSION`	The account does not have permission to burn the token.