{"id":27089050,"url":"https://github.com/soldapper/mcburn-js","last_synced_at":"2025-10-16T03:32:20.357Z","repository":{"id":220537786,"uuid":"751904512","full_name":"SolDapper/mcburn-js","owner":"SolDapper","description":"A Node.js CLI to burn even the most stubborn of cNFTs.","archived":false,"fork":false,"pushed_at":"2025-02-08T00:57:31.000Z","size":337,"stargazers_count":6,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-02-08T01:29:13.204Z","etag":null,"topics":["burner","cli","cnft","solana"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SolDapper.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-02-02T15:28:33.000Z","updated_at":"2025-02-08T00:57:34.000Z","dependencies_parsed_at":"2024-02-05T21:28:18.517Z","dependency_job_id":"f3dfccd4-752a-4216-b218-9aef6cdb26fa","html_url":"https://github.com/SolDapper/mcburn-js","commit_stats":null,"previous_names":["mcdegens-dao/mcburn-js","soldapper/mcburn-js"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SolDapper%2Fmcburn-js","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SolDapper%2Fmcburn-js/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SolDapper%2Fmcburn-js/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SolDapper%2Fmcburn-js/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SolDapper","download_url":"https://codeload.github.com/SolDapper/mcburn-js/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247445650,"owners_count":20939953,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["burner","cli","cnft","solana"],"created_at":"2025-04-06T06:38:13.886Z","updated_at":"2025-10-16T03:32:20.274Z","avatar_url":"https://github.com/SolDapper.png","language":"JavaScript","readme":"# mcburn-js\n\nA Node.js based CLI for interacting with the **mcburn** cNFT burner program for Solana.\n\nThis CLI serves as a personal wallet hygiene tool for forcefully burning a cNFT.\n\n**mcburn** allows you to burn a cNFT without connecting your wallet to an external application.\n\nIt is especically helpful when a cNFT appears to be \"unburnable\" by other means.\n\n# install/update mcburn-js\n\n1. Create a new mcburn folder in your projects and navigate to it in your terminal.\n```javascript\nmkdir my-mcburner\ncd my-mcburner\n```\n2. Run this command in your terminal to install or update mcburn-js.\n```javascript\ngit clone https://github.com/McDegens-DAO/mcburn-js.git \u0026\u0026 mv mcburn-js/* . \u0026\u0026 npm install \u0026\u0026 npm run updater\n```\n3. If it's a new install, open **config.js** in your editor to add your settings.\n```javascript\n• add your private keypair \n• add your helius endpoint\n• save config.js and close\n```\n# using mcburn\n\n**burn a cnft**\n```javascript\nnpm run mcburn torch \u003ctokenId\u003e\n```\n**burn a cnft but do not deactivate the helper alt** (if one exist)\n```javascript\nnpm run mcburn torch \u003ctokenId\u003e true\n```\n**retry burn using an existing alt address**\n```javascript\nnpm run mcburn retry \u003ctokenId\u003e false \u003caltAddress\u003e\n```\n**retry burn using an existing alt address but do not deactivate helper alt**\n```javascript\nnpm run mcburn retry \u003ctokenId\u003e true \u003caltAddress\u003e\n```\n**deactivate a helper alt and try to close it**\n```javascript\nnpm run mcburn deactivate \u003caltAddress\u003e\n```\n**deactivate a helper alt and do not try to close it**\n```javascript\nnpm run mcburn deactivate \u003caltAddress\u003e true\n```\n**close a helper alt and recover funds**\n```javascript\nnpm run mcburn close \u003caltAddress\u003e\n```\n\n# more details\n\n**mcburn torch**\n\nThe torch command will run a complete burn. Please be advised that if there are more than \n20 proofs being passed for the cNFT, the creation of an ALT (lookup table) \nis necessary prior to burning which requires rent, that you will reclaim.\nThe **torch** command will attempt to create the ALT automatically when necessary \nand continue the burning process. In these cases it can take some time for the burn \nprocess to complete because it will attempt to deactivate and close the ALT after burning \nto recoup the rent for you. \n```javascript\n  npm run mcburn torch \u003ctokenId\u003e\n```\n\n**torch and stop**\n\nPassing an additional \"true\" argument after the token id will stop the script after the burn. \nIf 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.\n```javascript\n  npm run mcburn torch \u003ctokenId\u003e true\n```\n\n**mcburn retry**\n\nIn 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.\n```javascript\n  npm run mcburn retry \u003ctokenId\u003e false \u003caltAddress\u003e\n```\n```javascript\n  // Passing \"true\" will skip the ALT Deactivation\n  npm run mcburn retry \u003ctokenId\u003e true \u003caltAddress\u003e\n```\n\n**mcburn deactivate**\n\nIf you have an orphaned ALT that you need to deactivate you can do it directly with this command.\n```javascript\n  npm run mcburn deactivate \u003caltAddress\u003e\n```\n\n**deactivate and stop**\n\nPassing **true** as an additional argument will attempt to deactivate the ALT without trying to close if afterwards.\n```javascript\n  npm run mcburn deactivate \u003caltAddress\u003e true\n```\n\n**mcburn close**\n\nOnce deactivated you can then close an ALT to recoup its rent. Before an ALT can be closed it must first have been deactivated. \nClosing an ALT cannot be done immediately after deactivation. If you run **mcburn close** immediately, it will display the remaining wait time \nin \"blocks\" in your terminal and retry once per min until it's permitted to be closed.\n```javascript\n  npm run mcburn close \u003caltAddress\u003e\n```\n\n# notes\n\n**Static ALT**\n\n(lookup table)\n\nAddress: 6NVtn6zJDzSpgPxPRtd6UAoWkDxmuqv2HgCLLJEeQLY\n\nThe 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. \nThere are 5 *Lookup Table Entries* in the *Static ALT* that are used by default in every tx:\n\n1. Burner Program Id\n2. System Program Id\n3. State Compression Program Id\n4. Noop Program Id\n5. Bubblegum Program Id\n\n**Helper ALT**\n\n(lookup table)\n\nIn some cases multiple transactions are required to burn a stubborn cNFT.\n\n**Example**\n\nIf \u003e 20 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.\n\n**ALT Rent**\n\nSince 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.\n\n# solana program\n\n**Program Id:** GwR3T5wAAWRCCNyjCs2g9aUM7qAtwNBsn2Z515oGTi7i\n\nYou can find the open source **mcburn** Rust repo here: [mcburn-rs](https://github.com/honeygrahams2/mcburn-rs)\n\nThe mcburn program is deployed on Solana mainnet and all are welcome to use it.\n\n# bulk burning\n\nFor bulk burning through an application we recommend [Sol Incinerator](https://sol-incinerator.com/)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoldapper%2Fmcburn-js","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsoldapper%2Fmcburn-js","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoldapper%2Fmcburn-js/lists"}