Burning a token

Understanding how to remove unwanted tokens from your wallet

There are sometimes occasions when you want to delete a token from your wallet.

  • Your address was airdropped a token you no longer want
  • You created an NFT but something about it is not right.
  • A project sent you voting or other tokens that you no longer need

To get rid of those tokens, you have a few options.

Programmatically

To burn tokens programmatically, simply spend an Unspent Transaction Output (UTXO) containing the tokens you wish to eliminate. Ensure not to include these tokens in the output of the transaction.

Using AppKit

If you're working with AppKit, the transaction builder conveniently offers a burntoken method tailored for this purpose.

Ergo Token Minter Integration

The burn token functionality integrated by ThierryM1212 can be observed here. The crucial steps involved are as follows:

  1. Identify and select the input boxes holding the tokens to be burnt, along with a small ERG amount.
  2. Construct the output boxes, excluding consideration of the tokens. The transaction builder automatically appends an additional output change box encompassing all tokens.
  3. Retrieve the transaction JSON representation.
  4. Edit the output change box details to eliminate the tokens intended for burning.
  5. Dispatch the modified transaction (JSON) to the network.

This streamlined approach simplifies the process of burning tokens while maintaining transaction integrity.