Skip to content

Instantly share code, notes, and snippets.

Last active November 2, 2021 17:38
Show Gist options
  • Save CoinWhisperer/6d673f1f3d13da1611cd to your computer and use it in GitHub Desktop.
Save CoinWhisperer/6d673f1f3d13da1611cd to your computer and use it in GitHub Desktop.
A simple python program to create bitcoin burn addresses.
#! /usr/bin/env python
burn-btc: create a bitcoin burn address
By James C. Stroud
This program requries base58 (
Call the program with a template burn address as the only argument::
% burn-btc 1BurnBTCForFunBurnBTCForFunXXXXXXX
For instructions, call the program with no arguments::
% burn-btc
usage: burn-btc TEMPLATE
TEMPLATE - 34 letters & numbers (no zeros)
the first two are coin specific
An example template is accessible using "test" as the argument::
% burn-btc test
Validate bitcoin burn addresses at
import sys
import binascii
from hashlib import sha256
from base58 import b58encode, b58decode
ABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz"
class BurnBTCError(Exception):
class AlphabetError(BurnBTCError):
def hh256(s):
s = sha256(s).digest()
return binascii.hexlify(sha256(s).digest())
def b58ec(s):
unencoded = str(bytearray.fromhex(unicode(s)))
encoded = b58encode(unencoded)
return encoded
def b58dc(encoded, trim=0):
unencoded = b58decode(encoded)[:-trim]
return unencoded
def burn(s):
decoded = b58dc(s, trim=4)
decoded_hex = binascii.hexlify(decoded)
check = hh256(decoded)[:8]
coded = decoded_hex + check
return b58ec(coded)
def usage():
print "usage: burn-btc TEMPLATE"
print " TEMPLATE - 34 letters & numbers (no zeros)"
print " the first two are coin specific"
raise SystemExit
if __name__ == "__main__":
if len(sys.argv) != 2:
if sys.argv[1] == "test":
template = "1BurnBTCForFunBurnBTCForFunXXXXXXX"
template = sys.argv[1]
for c in template:
if c not in ABET:
raise AlphabetError("Character '%s' is not valid base58." % c)
tlen = len(template)
if tlen < 34:
template = template + ((34 - tlen) * "X")
template = template[:34]
print burn(template)
Copy link

Awesome idea, I'm thinking about using this! :)

Copy link

When I try to run this I get this error on my CentOS system:

ImportError: No module named base58

Sorry I'm a noob with python. Any ideas?

Copy link

Figured it out, evermind!

Copy link

suprnurd commented Apr 2, 2020

This was exactly what I was looking for, thanks so much for sharing!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment