mcburn-js

A Node.js based CLI for interacting with the mcburn cNFT burner program for Solana.

This CLI serves as a personal wallet hygiene tool for forcefully burning a cNFT.

mcburn allows you to burn a cNFT without connecting your wallet to an external application.

It is especically helpful when a cNFT appears to be "unburnable" by other means.

burn a cnft

npm run mcburn torch <tokenId>

burn a cnft but do not deactivate the helper alt (if one exist)

npm run mcburn torch <tokenId> true

retry burn using an existing alt address

npm run mcburn retry <tokenId> false <altAddress>

retry burn using an existing alt address but do not deactivate helper alt

npm run mcburn retry <tokenId> true <altAddress>

deactivate a helper alt and try to close it

npm run mcburn deactivate <altAddress>

deactivate a helper alt and do not try to close it

npm run mcburn deactivate <altAddress> true

close a helper alt and recover funds

npm run mcburn close <altAddress>

For bulk burning we recommend the Sol Incinerator application.

Installing mcburn-js

1. Start a new Node.js project.

2. Navigate to your project root and run this command in your terminal to clone the repo:

git clone https://github.com/McDegens-DAO/mcburn-js.git

3. Move the downloaded files to your project root.

4. Run this command in your terminal to install required modules:

npm install

5. Open mcburn.js in your editor.

• add your private keypair 
• add your helius endpoint
• save mcburn.js and close

// settings
const keypair = [0,0,0,"~"]; // this is your private keypair, be careful
const rpc = "https://rpc.helius.xyz/?api-key=xxxxxxxxxx"; // helius
const priority = 20; // lamports (priority fee)
const burner = "GwR3T5wAAWRCCNyjCs2g9aUM7qAtwNBsn2Z515oGTi7i"; // burner program
const throttle = 5000; // more seconds if your rpc limits are being stressed

Commands

mcburn torch

The torch command will run a complete burn. Please be advised that if there are more than 22 proofs being passed for the cNFT, the creation of an ALT (lookup table) is necessary prior to burning which requires rent, that you will reclaim. The torch command will attempt to create the ALT automatically when necessary and continue the burning process. In these cases it can take some time for the burn process to complete because it will attempt to deactivate and close the ALT after burning to recoup the rent for you.

  npm run mcburn torch <tokenId>

example output

npm run mcburn torch 8yriTfMg1BQDyaD7X2mUpeXSTe6W4Q91SwxupHnThWv1

> mcburn@0.0.2 mcburn
> node mcburn.js torch 8yriTfMg1BQDyaD7X2mUpeXSTe6W4Q91SwxupHnThWv1

private key in use!
assetId:  8yriTfMg1BQDyaD7X2mUpeXSTe6W4Q91SwxupHnThWv1
data_hash:  DWqMofJFqehTD2zg3hNfEA58WRYDW7xndJoSXG1ccW2g
creator_hash:  EKDHSGbrGztomDfuiV4iqiZ6LschDJPsFiXjZ83f92Md
leaf_id:  3840261
leafDelegate:  FBQHeifBur7UDEUkBV9v16TAYfhDTnpjbwV8GTdp5jMq
owner:  7Z3LJB2rxV4LiRBwgwTcufAWxnFTVJpcoCMiCo8Z5Ere
fetching proof...
tree_id:  BK1odnvdPePUsARpypamop1ug97d6yS4WTDXSRjNV8hF
root:  5ME3yJBttQeoCJ9u8LdGxtKrEuQYvg47R3SPAAJBKYet
fetching tree...
treeAuthorityPDA:  HZdoqGiwv7iihzDJvAnoYtMg65n3P4VQoD9HjV7m1DT6
canopyDepth:  0
totalSize:  138
proofs:  24
retrying:  false
creating alt...
ALT HELPER ADDRESS:  GxXLjXfreP3WceAue8HzJyaLr8TrDBESWtMCjRrqtopu
signature:  3K6cwE5kb78kKMa6xxXUJU1dibPGNDBE9iAXn6J5vwGGBW4kHhvQHVJTomFGkBVaRQAR8S3Mq4ZmN331MmHWqw9
finalizing alt creation...
alt created:  GxXLjXfreP3WceAue8HzJyaLr8TrDBESWtMCjRrqtopu
fetching alt...
alt found:  GxXLjXfreP3WceAue8HzJyaLr8TrDBESWtMCjRrqtopu
burning... 8yriTfMg1BQDyaD7X2mUpeXSTe6W4Q91SwxupHnThWv1
signature:  516vnbfRAmWRWDsY6iERS8wBkzcyjFY4MfVPWnhZrchhmEWoCfEpBMD38PPRDuRwmFA9bVyMWWLVLwv3F2Lj3LB3
finalizing burn...  8yriTfMg1BQDyaD7X2mUpeXSTe6W4Q91SwxupHnThWv1
asset burned:  8yriTfMg1BQDyaD7X2mUpeXSTe6W4Q91SwxupHnThWv1
deactivate helper: GxXLjXfreP3WceAue8HzJyaLr8TrDBESWtMCjRrqtopu
deactivating... GxXLjXfreP3WceAue8HzJyaLr8TrDBESWtMCjRrqtopu
signature:  dAELj4BeRbzhhpqBoJQrGV8JCqcAjLTzUjN6mPEs9EK2PVdhy5bFLdmWEgetH5NU6NgiHxenL7tnacTTpcX4j69
finalizing deactivation... GxXLjXfreP3WceAue8HzJyaLr8TrDBESWtMCjRrqtopu
helper deactivated:  GxXLjXfreP3WceAue8HzJyaLr8TrDBESWtMCjRrqtopu
waiting to close... GxXLjXfreP3WceAue8HzJyaLr8TrDBESWtMCjRrqtopu
attempting to close...  GxXLjXfreP3WceAue8HzJyaLr8TrDBESWtMCjRrqtopu
wait time: 340 blocks...
attempting to close...  GxXLjXfreP3WceAue8HzJyaLr8TrDBESWtMCjRrqtopu
wait time: 195 blocks...
attempting to close...  GxXLjXfreP3WceAue8HzJyaLr8TrDBESWtMCjRrqtopu
wait time: 57 blocks...
attempting to close...  GxXLjXfreP3WceAue8HzJyaLr8TrDBESWtMCjRrqtopu
signature:  39S67GB3jeoBUkpiFiRGYE7mi2Z1wVo1mu7s3k5x5532ubZ9XW2UfrRGNA1ygKVwVDQJuwR3xs8JgW3QU6dkWZTr
finalizing rent recovery...  GxXLjXfreP3WceAue8HzJyaLr8TrDBESWtMCjRrqtopu
...
alt closed:  GxXLjXfreP3WceAue8HzJyaLr8TrDBESWtMCjRrqtopu
funds recovered:  GxXLjXfreP3WceAue8HzJyaLr8TrDBESWtMCjRrqtopu
done

torch and stop

Passing an additional "true" argument after the token id will stop the script after the burn. If the burn required an ALT, the ALT would then be orphaned. You would then have to deactivate and close the ALT so save the ALT address.

  npm run mcburn torch <tokenId> true

mcburn retry

In the case where an ALT is created but the burn transaction fails, you should use the retry command to continue where you left off while using the ALT address that was already created and paid for.

  npm run mcburn retry <tokenId> false <altAddress>

  npm run mcburn retry <tokenId> true <altAddress>

mcburn deactivate

If you have an orphaned ALT that you need to deactivate you can do it directly with this command.

  npm run mcburn deactivate <altAddress>

example output

npm run mcburn deactivate ALDWF8Bouqjx6DhfUVt42kPiTQaoKmwCzoX8oZw6HCAS

> mcburn@0.0.2 mcburn
> node mcburn.js deactivate ALDWF8Bouqjx6DhfUVt42kPiTQaoKmwCzoX8oZw6HCAS

private key in use!
deactivate helper: ALDWF8Bouqjx6DhfUVt42kPiTQaoKmwCzoX8oZw6HCAS
deactivating... ALDWF8Bouqjx6DhfUVt42kPiTQaoKmwCzoX8oZw6HCAS
signature:  4fgEqarJ8ZiuTTQYrwvsQMAQfoW6hFwK2SHyZtP6EFxbf7AgqcRAyT19hn15kZifVvWaceyccR2zeLvbdoC1yiKP
finalizing deactivation... ALDWF8Bouqjx6DhfUVt42kPiTQaoKmwCzoX8oZw6HCAS
helper deactivated:  ALDWF8Bouqjx6DhfUVt42kPiTQaoKmwCzoX8oZw6HCAS
waiting to close... ALDWF8Bouqjx6DhfUVt42kPiTQaoKmwCzoX8oZw6HCAS
attempting to close...  ALDWF8Bouqjx6DhfUVt42kPiTQaoKmwCzoX8oZw6HCAS
wait time: 341 blocks...
attempting to close...  ALDWF8Bouqjx6DhfUVt42kPiTQaoKmwCzoX8oZw6HCAS
wait time: 200 blocks...
attempting to close...  ALDWF8Bouqjx6DhfUVt42kPiTQaoKmwCzoX8oZw6HCAS
wait time: 67 blocks...
attempting to close...  ALDWF8Bouqjx6DhfUVt42kPiTQaoKmwCzoX8oZw6HCAS
signature:  44tCvruBeGz128pPvXL4ayHmyT1SPac64QZvwtX5ZK4JwPocheZ5zCv68iCMEd6StEbqosxiEvpvHufSfruEzEe
finalizing rent recovery...  ALDWF8Bouqjx6DhfUVt42kPiTQaoKmwCzoX8oZw6HCAS
...
alt closed:  ALDWF8Bouqjx6DhfUVt42kPiTQaoKmwCzoX8oZw6HCAS
funds recovered:  ALDWF8Bouqjx6DhfUVt42kPiTQaoKmwCzoX8oZw6HCAS
done

deactivate and stop

Passing true as an additional argument will attempt to deactivate the ALT without trying to close if afterwards.

  npm run mcburn deactivate <altAddress> true

mcburn close

Once deactivated you can then close an ALT to recoup its rent. Before an ALT can be closed it must first have been deactivated. Closing an ALT cannot be done immediately after deactivation. If you run mcburn close immediately, it will display the remaining wait time in "blocks" in your terminal and retry once per min until it's permitted to be closed.

  npm run mcburn close <altAddress>

example output

npm run mcburn close B43LkievT1y9V51a8NENVVURA7NJ2EoF6EHZqgJqyAWa

> mcburn@0.0.2 mcburn
> node mcburn.js close B43LkievT1y9V51a8NENVVURA7NJ2EoF6EHZqgJqyAWa

private key in use!
attempting to close...  B43LkievT1y9V51a8NENVVURA7NJ2EoF6EHZqgJqyAWa
signature:  51473hGK8gR98NK4Xf5KY7C24qKLmekDrLE1fsNz6YraNEHwtFbX2hJXjeK3h14j7rgyxeBfGrbcp8JGEpSFWtRi
finalizing rent recovery...  B43LkievT1y9V51a8NENVVURA7NJ2EoF6EHZqgJqyAWa
alt closed:  B43LkievT1y9V51a8NENVVURA7NJ2EoF6EHZqgJqyAWa
funds recovered:  B43LkievT1y9V51a8NENVVURA7NJ2EoF6EHZqgJqyAWa
done

Notes

Static ALT

(lookup table)

Address: 6NVtn6zJDzSpgPxPRtd6UAoWkDxmuqv2HgCLLJEeQLY

The mcburn Solana program uses a predefined ALT we call a the Static ALT where common program ids are stored to reduce the overall tx size of the burn. There are 5 Lookup Table Entries in the Static ALT that are used by default in every tx:

1. Burner Program Id
2. System Program Id
3. State Compression Program Id
4. Noop Program Id
5. Bubblegum Program Id

Helper ALT

(lookup table)

In some cases multiple transactions are required to burn a stubborn cNFT.

Example

If > 22 proofs are passed in the ix, there will first be a tx to create a Helper ALT prior to the burn transaction. The Helper ALT is used in this case to store the extra proofs that would blow the tx size limit.

ALT Rent

Since the ALT requires rent you have to save the Helper ALT address so that you can deactivate it and close it to recover funds. Please note that only the ALT creator can perform these actions and reclaim funds.

Solana Program

Program Id: GwR3T5wAAWRCCNyjCs2g9aUM7qAtwNBsn2Z515oGTi7i

You can find the open source mcburn Rust repo here: mcburn-rs

Our program is deployed on Solana mainnet and all are welcome to use it.