Package: cryptos
Pycryptotools, Python library for Crypto coins signatures and transactionsThis is a fork of Vitalik Buterin's originalpybitcointoolslibrary.After a lot of work, the library is finally active again and being actively updated. This took a lot of work and unfortunately some backward imcompatible changes may have been introduced in v2. If you run into issues after upgrading open an issue and will try to help. If it's reasonable to do so we can consider restoring the previous behaviour in v2, otherwise will assist with migration.Installation:pipinstallcryptosLibrary now supports making and pushing raw transactions for:Bitcoin mainnetBitcoin testnetBitcoin Cash mainnetBitcoin Cash testnetLitecoin mainnetLitecoin testnetDash mainnetDash testnetDogecoin mainnetDogecoin testnetTransaction broadcast has been tested for all of these.Segregated Witness transactions also supported for:Bitcoin mainnetBitcoin testnetLitecoin mainnetLitecoin testnetHere are the first mainnet segwit transactions made with this library:Bitcoin:https://blockchain.info/tx/9f3bd4fa14e424abd5623ba98877e33cfee3e7bd6f9f71d7a39e402501458c81Litecoin:https://live.blockcypher.com/ltc/tx/b16ad0332ca3114f0dc773fda643c49e41308df4204940539bea5806cfee0989/https://live.blockcypher.com/ltc/tx/3b936180daf05adcd7e9f04b60e1ba9a4a6db486c0ad91cb795b29ca46313000/Aim is to provide a simple, class-based API which makes switching between different coins and mainnet and testnet, and adding new coins, all very easy.Roadmap:Change from unittest to pytestExtend wallets to make transactionsRead the docs pageE-commerce tools (exchange rates, short-time invoices)Command client for easy creation, signing and broadcasting of raw transactionsMulti-crypto wallet CLIAdvantages:Methods have a simple interface, inputting and outputting in standard formatsClasses for different coins with a common sync and async interfaceMany functions can be taken out and used individuallySupports binary, hex and base58Transaction deserialization format almost compatible with BitcoinJSElectrum and BIP0032 supportMake and publish a transaction all in a single command line instruction with full controlIncludes non-bitcoin-specific conversion and JSON utilitiesDisadvantages:Not a full node, has no idea what blocks areExample usage - the long way (best way to learn :) ):WARNING: While it's fun to mess around with this on the testnet, do not do the following procedure on the mainnet unless you really know what you are doing. Any value in the inputs not included in the outputs will be lost.
So if the total inputs value is 1 BTC, and the total outputs amount to 0.6 BTC, 0.4 BTC will be given to the miners as a fee. The faster way, listed later in the README, ensures the difference between
inputs and outputs is sent as change back to the sender (except for a small minter fee).
If in doubt, before broadcasting a transaction, visithttps://live.blockcypher.com/btc/decodetx/and decode the raw tx
and make sure it looks right. If you aren't familiar with how Bitcoin transactions work, you should run through
this procedure a few times on the testnet before developing for mainnet.OTHER WARNING: If transactions are taking a long time to be confirmed, try increasing the fee from what the
library calculates to use.> from cryptos import *
> c = Bitcoin(testnet=True)
> priv = sha256('a big long brainwallet password')
> priv
'89d8d898b95addf569b458fbbd25620e9c9b19c9f730d5d60102abbabcb72678'
> pub = c.privtopub(priv)
> pub
'041f763d81010db8ba3026fef4ac3dc1ad7ccc2543148041c61a29e883ee4499dc724ab2737afd66e4aacdc0e4f48550cd783c1a73edb3dbd0750e1bd0cb03764f'
> addr = c.pubtoaddr(pub)
> addr
'mwJUQbdhamwemrsR17oy7z9upFh4JtNxm1'
> inputs = c.unspent(addr)
> inputs
[{'height': 0, 'tx_hash': '6d7a1b133f5ad2ce77d8980a1c84d7b595e4085d5a4a6d347e8a92df6ffc31f5', 'tx_pos': 0, 'value': 7495, 'address': 'mwJUQbdhamwemrsR17oy7z9upFh4JtNxm1'}, {'height': 0, 'tx_hash': 'e1e7b62e5eb4d399c75649e9256a91f0371268ca265ab9265a433bb263baf2f2', 'tx_pos': 0, 'value': 1866771, 'address': 'mwJUQbdhamwemrsR17oy7z9upFh4JtNxm1'}]
> outs = [{'value': 1000000, 'address': 'tb1q95cgql39zvtc57g4vn8ytzmlvtt43skngdq0ue'}, {'value': sum(i['value'] for i in inputs) - 1000000 - 750 , 'address': 'mwJUQbdhamwemrsR17oy7z9upFh4JtNxm1'}]
outs
[{'value': 1000000, 'address': 'tb1q95cgql39zvtc57g4vn8ytzmlvtt43skngdq0ue'}, {'value': 873516, 'address': 'mwJUQbdhamwemrsR17oy7z9upFh4JtNxm1'}]
> tx = c.mktx(inputs,outs)
> tx
{'locktime': 0, 'version': 1, 'ins': [{'height': 0, 'tx_hash': '6d7a1b133f5ad2ce77d8980a1c84d7b595e4085d5a4a6d347e8a92df6ffc31f5', 'tx_pos': 0, 'value': 7495, 'address': 'mwJUQbdhamwemrsR17oy7z9upFh4JtNxm1', 'script': '', 'sequence': 4294967295}, {'height': 0, 'tx_hash': 'e1e7b62e5eb4d399c75649e9256a91f0371268ca265ab9265a433bb263baf2f2', 'tx_pos': 0, 'value': 1866771, 'address': 'mwJUQbdhamwemrsR17oy7z9upFh4JtNxm1', 'script': '', 'sequence': 4294967295}], 'outs': [{'value': 1000000, 'script': '00142d30807e2513178a791564ce458b7f62d758c2d3'}, {'value': 873516, 'script': '76a914ad25bdf0fdfd21ca91a82449538dce47f8dc213d88ac'}]}
> tx2 = c.signall(tx, priv)
> tx2
{'locktime': 0, 'version': 1, 'ins': [{'height': 0, 'tx_hash': '6d7a1b133f5ad2ce77d8980a1c84d7b595e4085d5a4a6d347e8a92df6ffc31f5', 'tx_pos': 0, 'value': 7495, 'address': 'mwJUQbdhamwemrsR17oy7z9upFh4JtNxm1', 'script': '473044022012ba62de78427811650f868209572404a0846bf60b3a3705799877bb5351827702202bcadc067f5dce01ecf10306e033a905a156aec71d769bcffc0e221a0c91c6030141041f763d81010db8ba3026fef4ac3dc1ad7ccc2543148041c61a29e883ee4499dc724ab2737afd66e4aacdc0e4f48550cd783c1a73edb3dbd0750e1bd0cb03764f', 'sequence': 4294967295}, {'height': 0, 'tx_hash': 'e1e7b62e5eb4d399c75649e9256a91f0371268ca265ab9265a433bb263baf2f2', 'tx_pos': 0, 'value': 1866771, 'address': 'mwJUQbdhamwemrsR17oy7z9upFh4JtNxm1', 'script': '47304402205c9b724d2499f167b9557b8efd13b8b2109ae287b712f2db1d3d46cfc31c71a702201a74bda43116977c4605d499177152afd3965b2fe586f3236053786ef19e96090141041f763d81010db8ba3026fef4ac3dc1ad7ccc2543148041c61a29e883ee4499dc724ab2737afd66e4aacdc0e4f48550cd783c1a73edb3dbd0750e1bd0cb03764f', 'sequence': 4294967295}], 'outs': [{'value': 1000000, 'script': '00142d30807e2513178a791564ce458b7f62d758c2d3'}, {'value': 873516, 'script': '76a914ad25bdf0fdfd21ca91a82449538dce47f8dc213d88ac'}]}
> tx3 = serialize(tx2)
> tx3
'0100000002f531fc6fdf928a7e346d4a5a5d08e495b5d7841c0a98d877ced25a3f131b7a6d000000008a473044022012ba62de78427811650f868209572404a0846bf60b3a3705799877bb5351827702202bcadc067f5dce01ecf10306e033a905a156aec71d769bcffc0e221a0c91c6030141041f763d81010db8ba3026fef4ac3dc1ad7ccc2543148041c61a29e883ee4499dc724ab2737afd66e4aacdc0e4f48550cd783c1a73edb3dbd0750e1bd0cb03764ffffffffff2f2ba63b23b435a26b95a26ca681237f0916a25e94956c799d3b45e2eb6e7e1000000008a47304402205c9b724d2499f167b9557b8efd13b8b2109ae287b712f2db1d3d46cfc31c71a702201a74bda43116977c4605d499177152afd3965b2fe586f3236053786ef19e96090141041f763d81010db8ba3026fef4ac3dc1ad7ccc2543148041c61a29e883ee4499dc724ab2737afd66e4aacdc0e4f48550cd783c1a73edb3dbd0750e1bd0cb03764fffffffff0240420f00000000001600142d30807e2513178a791564ce458b7f62d758c2d32c540d00000000001976a914ad25bdf0fdfd21ca91a82449538dce47f8dc213d88ac00000000'
> c.pushtx(tx3)
'd5b5b148285da8ddf9d719627c21f5cbbb3e17ae315dbb406301b9ac9c5621e5'Faster wayTo send 0.00006 BTC from native segwit addr tb1qsp907fjefnpkczkgn62cjk4ehhgv2s805z0dkv belonging to privkey 89d8d898b95addf569b458fbbd25620e9c9b19c9f730d5d60102abbabcb72678
to address tb1q95cgql39zvtc57g4vn8ytzmlvtt43skngdq0ue, with change returned to the sender address:> from cryptos import *
> c = Bitcoin(testnet=True)
> c.send("89d8d898b95addf569b458fbbd25620e9c9b19c9f730d5d60102abbabcb72678", "tb1qsp907fjefnpkczkgn62cjk4ehhgv2s805z0dkv", "tb1q95cgql39zvtc57g4vn8ytzmlvtt43skngdq0ue", 5000)
72caf37e96081374284356aa20cffef31f4c1f158b87f46f7f995bfdaaf5d1c6'Or if you prefer to verify the tx (for example, athttps://live.blockcypher.com/btc/decodetx/) you can break it into two steps:> from cryptos import *
> c = Bitcoin(testnet=True)
> tx = c.preparesignedtx("89d8d898b95addf569b458fbbd25620e9c9b19c9f730d5d60102abbabcb72678", "tb1qsp907fjefnpkczkgn62cjk4ehhgv2s805z0dkv", "tb1q95cgql39zvtc57g4vn8ytzmlvtt43skngdq0ue", 5000)
> serialize(tx)
'010000000001014ae7e7fdead71cc8303c5b5e68906ecbf978fb9d84f5f9dd505823356b9a1d6e0000000000ffffffff0288130000000000001600142d30807e2513178a791564ce458b7f62d758c2d3a00f000000000000160014804aff26594cc36c0ac89e95895ab9bdd0c540ef02483045022100cff4e64a4dd0f24c1f382e4b949ae852a89a5f311de50cd13d3801da3669675c0220779ebcb542dc80dae3e16202c0b58dd60261662f3b3a558dca6ddf22e30ca4230121031f763d81010db8ba3026fef4ac3dc1ad7ccc2543148041c61a29e883ee4499dc00000000'
> c.pushtx(tx)
'6a7c437b0de10c42f2e9e18cc004e87712dbda73a851a0ea6774749a290c7e7d'Another example with Litecoin testnet and a change address:> from cryptos import *
> l = Litecoin(testnet=True)
> tx = l.preparesignedtx("89d8d898b95addf569b458fbbd25620e9c9b19c9f730d5d60102abbabcb72678", "tltc1qsp907fjefnpkczkgn62cjk4ehhgv2s80d2dnx9", "tltc1q95cgql39zvtc57g4vn8ytzmlvtt43skn39z3vs", 967916800, change_addr="tltc1qst3pkm860tjt9y70ugnaluqyqnfa7h54q7xv2n")
> tx
'010000000144ea7b41df09cee54c43f817dc11fd4d88c9b721b4c13b588f6a764eab78f692000000008b4830450221008efa819db89f714dbe0a19a7eb605d03259f4755a0f12876e9dddf477e1867b8022072bc76d120e92668f4765b5d694aee4a3cafd6cd4aaa8d5ebf88c3f821c81d9c4141041f763d81010db8ba3026fef4ac3dc1ad7ccc2543148041c61a29e883ee4499dc724ab2737afd66e4aacdc0e4f48550cd783c1a73edb3dbd0750e1bd0cb03764fffffffff02003db139000000001976a91409fed3e08e624b23dbbacc77f7b2a39998351a6888acf046df07000000001976a914ad25bdf0fdfd21ca91a82449538dce47f8dc213d88ac00000000'
> crypto.pushtx(tx)
{'status': 'success', 'data': {'txid': 'd8b130183824d0001d3bc669b31e798e2654868a7fda743aaf35d757d89db0eb', 'network': 'tbcc'}}2-of-3 MultiSig Transaction example:> from cryptos import *
> coin = Bitcoin(testnet=True)
> publickeys = ['02e5c473c051dae31043c335266d0ef89c1daab2f34d885cc7706b267f3269c609', '0391ed6bf1e0842997938ea2706480a7085b8bb253268fd12ea83a68509602b6e0', '0415991434e628402bebcbaa3261864309d2c6fd10c850462b9ef0258832822d35aa26e62e629d2337e3716784ca6c727c73e9600436ded7417d957318dc7a41eb']
> script, address = coin.mk_multsig_address(publickeys, 2)
> script
'522102e5c473c051dae31043c335266d0ef89c1daab2f34d885cc7706b267f3269c609210391ed6bf1e0842997938ea2706480a7085b8bb253268fd12ea83a68509602b6e0410415991434e628402bebcbaa3261864309d2c6fd10c850462b9ef0258832822d35aa26e62e629d2337e3716784ca6c727c73e9600436ded7417d957318dc7a41eb53ae'
> address
'2ND6ptW19yaFEmBa5LtEDzjKc2rSsYyUvqA'
> tx = coin.preparetx(address, "myLktRdRh3dkK3gnShNj5tZsig6J1oaaJW", 1100000, 50000)
> for i in range(0, len(tx['ins'])):
    sig1 = coin.multisign(tx, i, script, "cUdNKzomacP2631fa5Q4yHv2fADc8Ueymr5Z5NUSJjVM13igcVJk")
    sig3 = coin.multisign(tx, i, script, "cMrziExc6iMV8vvAML8QX9hGDP8zNhcsKbdS9BqrRa1b4mhKvK6f")
    tx = apply_multisignatures(tx, i, script, sig1, sig3)
> tx
'0100000001e62c0b5434108607f52856bfbcf5093363fbd4789141a661a4c6c8042769ed2001000000fd1d0100483045022100dfc75916f6bb5c5b72a45dea44dbc45b47ba90912efb84680a373acadb3b1212022022dbbd66e4871624609d875bdb592d11335eb4ec49c7b87bb0b8bc76f72f80f30147304402204c38cab196ec0e82a9f65ecba70a0dbf73f49e5886e1000b9bc52894e28fa5c9022007bff3f90bcece19036625806d4d1951a03c256627163f1ac4e76a6ee8eae072014c89522102e5c473c051dae31043c335266d0ef89c1daab2f34d885cc7706b267f3269c609210391ed6bf1e0842997938ea2706480a7085b8bb253268fd12ea83a68509602b6e0410415991434e628402bebcbaa3261864309d2c6fd10c850462b9ef0258832822d35aa26e62e629d2337e3716784ca6c727c73e9600436ded7417d957318dc7a41eb53aeffffffff02e0c81000000000001976a914c384950342cb6f8df55175b48586838b03130fad88ac301224030000000017a914d9cbe7c2c507c306f4872cf965cbb4fe51b621998700000000'
> coin.pushtx(tx)
{'status': 'success', 'data': {'txid': 'b64e19311e3aa197063e03657679e2974e04c02c5b651c4e8d55f428490ab75f', 'network': 'BTCTEST'}}Asyncio InterfaceThere is also an asyncio interface for all methods requiring interaction with the explorer:python -m asyncio
> from cryptos import *
> c = Bitcoin(testnet=True)
> await c.send("89d8d898b95addf569b458fbbd25620e9c9b19c9f730d5d60102abbabcb72678", "tb1qsp907fjefnpkczkgn62cjk4ehhgv2s805z0dkv", "tb1q95cgql39zvtc57g4vn8ytzmlvtt43skngdq0ue", 5000)
72caf37e96081374284356aa20cffef31f4c1f158b87f46f7f995bfdaaf5d1c6'Supported coins> from cryptos import *
> priv = sha256('a big long brainwallet password')
> b = Bitcoin()
> b.privtoaddr(priv)
'1GnX7YYimkWPzkPoHYqbJ4waxG6MN2cdSg'
> b = Bitcoin(testnet=True)
> b.privtoaddr(priv)
'mwJUQbdhamwemrsR17oy7z9upFh4JtNxm1'
> l = Litecoin()
> l.privtoaddr(priv)
'Lb1UNkrYrQkTFZ5xTgpta61MAUTdUq7iJ1'
> l = Litecoin(testnet=True)
> l.privtoaddr(priv)
'mwJUQbdhamwemrsR17oy7z9upFh4JtNxm1'
> c = BitcoinCash()
> c.privtoaddr(priv)
'1GnX7YYimkWPzkPoHYqbJ4waxG6MN2cdSg'
> c = BitcoinCash(testnet=True)
> c.privtoaddr(priv)
'mwJUQbdhamwemrsR17oy7z9upFh4JtNxm1'
> d = Dash()
> d.privtoaddr(priv)
'XrUMwoCcjTiz9gzP9S9p9bdNnbg3MvAB1F'
> d = Dash(testnet=True)
> d.privtoaddr(priv)
'yc6xxkH4B1P4VRuviHUDBd3j4tAQpy4fzn'
> d = Doge()
> d.privtoaddr(priv)
'DLvceoVN5AQgXkaQ28q9qq7BqPpefFRp4E'BIP39-BIP44 Standard Wallets:Aims to be compatible withhttps://iancoleman.io/bip39/. Good choice for supporting different coins and networks from
the same wallet words. Also compatible with electrum when bip39 option is selected.> from cryptos import *
> words = entropy_to_words(os.urandom(16))
> words
'practice display use aisle armor salon glue okay sphere rather belt mansion'  
> keystore.bip39_is_checksum_valid(words)
(True, True)
> coin = Bitcoin()
> wallet = coin.wallet(words)
> wallet.keystore.root_derivation
"m/44'/0'/0'"
> wallet.keystore.xprv      #Account Extended Private Key
'xprv9y1M42LhHxTuoQbCuySz4Ek6EB3guE4CiXDXhHQnR7LwgpUV7AxQVm7D4HpUWRStwUXFepQRz7av2iaAXXYoizT9JoqWE6qffxNdiMxFQtc'
> wallet.keystore.xpub      # Account Extended Public Key
'xpub6BzhTXsb8L2D1tfg1zyzRNgpnCtBJgn45k98VfpPySsvZcodeiGf3ZRguZLoS6VwEQ4iZ7Y4bq5A5eqyooyc4jC9beFTB3mmxrGwjRLa3pm'
> addr1 = wallet.new_receiving_address()
> addr1
'18q3EiCiKd5vydnaVwWEpAFyzfL2ftAZ1L'
> wallet.privkey(addr1)
'L4cKz3epcM3CAmwkSwJwZ2c4q5ukmSVWCrE9PqE46ybU3XyzfTYx'
> addr2 = wallet.new_change_address()
> addr2
'1BgkpwEDrTbCNduyR97EpW4zvFhEzWsyvi'
> wallet.privkey(addr2)
'L5Xmbnsen2cN36WxbuHkAixBmuJ8b3GZPmLtaRPf66p4gfnqHDqi'
> addr3 = wallet.new_change_address()
> addr3
'1KjxFsDP9SXAmKKD4ZgSep5kYaYgAGK3P9'
> priv3 = wallet.privkey(addr3)
> priv3
'L1ktR1kifTXLXoroLZiB3AF9UtKLRW2FmYnnR7VbPZBYkscgRkyn'
> assert coin.privtoaddr(priv3) == addr3
TrueDash example:> from cryptos import *
> words = 'practice display use aisle armor salon glue okay sphere rather belt mansion'  
> coin = Dash()
> wallet = coin.wallet(words)
> wallet.keystore.root_derivation
"m/44'/5'/0'"
> wallet.keystore.xprv      #Account Extended Private Key
'xprv9yiTHjM4MPNQndsxkrvE2QgF36nvutGt3e9k5DjkjfAnNbqGm1wL77XV2xHiwnUfwcgAZUWkdpEnxRWELTrgXDVhvntNFwme1CqCgm1a91f'
> wallet.keystore.xpub      # Account Extended Public Key
'xpub6ChohEsxBkvi17xRrtTEPYcyb8dRKLzjQs5Lsc9NHzhmFQARJZFaeuqxtEMHaF4J8MzatWSYrmq2qAc3BaxFiKzEwX1AKQx5uWHZr3y8s82'
> addr1 = wallet.new_receiving_address()
> addr1
'Xea1GEenz6Toq5YQjvjz86MTT8ezT5ZwnY'
> wallet.privkey(addr1)
'XDbSZeVzBiHanwrSU5yripFd8Lq5tnrjxgvbaksNPhAExbS29aAa'
> addr2 = wallet.new_change_address()
> addr2
'XwYCR4CwafwoGe6P4H9LndaqAQkmE6xYix'
> wallet.privkey(addr2)
'XHwHKxVfhzPEGZGGfQ9uwKK2xQjavF2yNUkq7FGXFA6SyZv4jge1'
> addr3 = wallet.new_change_address()
> addr3
'XfZwJaFiBx4qLqnQydvqGyWDPciAtjFmgn'
> priv3 = wallet.privkey(addr3)
> priv3
'XCNac8eQE642wWKaxnWHLa1GW1Y1uppvT5uda3LYVXAJZAAdR1Fx'
> assert coin.privtoaddr(priv3) == addr3
TrueBIP39-BIP49 Segwit Wallets:> from cryptos import *
> words = entropy_to_words(os.urandom(20))
> words
'jealous silver churn hedgehog border physical market parent hungry design cage lab drill clay attack' 
> keystore.bip39_is_checksum_valid(words)
(True, True)
> coin = Bitcoin()
> wallet = coin.p2wpkh_p2sh_wallet(words)
> wallet.keystore.root_derivation
"m/49'/0'/0'"
> wallet.keystore.xprv      #Account Extended Private Key
'yprvAHoU8z6164hTNdwpArPgn2bdNExmUu9HwxeyhUok8pLDNQSCzYo8rvD6tFvMKk4EQXF2UGzRea5FBHjrtcuYmuBB7Z6EoznKCPeUwXaZduB'
> wallet.keystore.xpub      # Account Extended Public Key
'ypub6WnpYVctvSFkb82HGsvh9AYMvGoFtMs9KBaaVsDMh9sCFCmMY67PQiXajW1FQq7AKsgvWGSrmZ82rquUpwcKR6Ey1sdMdeQWvgCKvABjWy8'
> addr1 = wallet.new_receiving_address()
> addr1
'38yA1L6u6NiADrafrqZKDt1fTRHpGC3E7g'
> wallet.privkey(addr1)
'Ky13njnYGrj5jowjUarqcmaRCG37zSwqRJkTj296cQsSvFtsV5a5'
> addr2 = wallet.new_change_address()
> addr2
'3B5f8vVBRTAh2krbd4PiCtpyn7LhFJBDdV'
> wallet.privkey(addr2)
'KzCNhiuvwQ1T6hXL21Act86HacauJGe1c8ttECqx1Fai6tPc1bEG'
> addr3 = wallet.new_change_address()
> addr3
'3NvrTctHm6dQc6G2p3XYciWH8H6Lfcz9Jc'
> wallet.privkey(addr3)
'KwdZhDopz3UVNW3Qso5UiyGkiDmayRZmAZdfAojvGsoP7da7HueX'BIP39-BIP84 New Segwit Wallets:> from cryptos import *
> words = 'jealous silver churn hedgehog border physical market parent hungry design cage lab drill clay attack'
> coin = Bitcoin()
> wallet = coin.p2wpkh_wallet(words)
> wallet.keystore.root_derivation
"m/84'/0'/0'
> wallet.keystore.xprv      #Account Extended Private Key
'zprvAcSKXVdgJHh5vyEeC6HSVScUCHxrKEWkkFSE2YsLpTborr4y2rHMrmr66yvxkGVqiiwwUCqUVkPB7o5ThnK3Dybi5PEywikXbNKQcHNMYPd'
> wallet.keystore.xpub      # Account Extended Public Key
'zpub6qRfw1Aa8fFP9TK7J7pSraZCkKoLihEc7UMppwGxNo8njeQ7aPbcQaAZxFtnjCj9XveSJEnwV88YPyXXUCr3yRSSAKzibVCQB7AudUQn6Qg'
> addr1 = wallet.new_receiving_address()
> addr1
'bc1qkh6wwkyhfceuxq236pc9gtv2agfqnelzh5m94f'
> wallet.privkey(addr1)
'Kwnaq7cvD4CAnTcppou6wpUpMFx5yZRqkpZcy6bBvPVKp2FQzJNf'
> addr2 = wallet.new_change_address()
> addr2
'bc1qj3vc5ft8nuka447z7ecujksszq6cm2r8p750n9'
> wallet.privkey(addr2)
'L1QjmcLmeR5tbH62WxKoSdZBBHn69PuQSnLo2LaimnztsDANMP5M'
> addr3 = wallet.new_change_address()
> addr3
'bc1qft00enx8c6unn00pmfdgq36ftd0u0q4lk5ajpy'
> wallet.privkey(addr3)
'Kx91EteCnRmUPr8eibiEsAcFDyKJ2z9uAwGUQfMVw5ABQx7QyVgg'Electrum walletsThese aim to be compatible with the default Electrum wallet seed style. They do not have different derivation paths for different coins.
No checks have been made against any non-Bitcoin Electum wallet (e.g. Electrum Litecoin, Electron Cash)
At this moment, there is no support generating the seed words Electrum requires (which contains versioning) so seed words need to be copied from Electrum.
Electrum versioning allows for auto-detection of wallet type, .e.g standard or segwit.> from cryptos import *
> seed_words = 'bitter grass shiver impose acquire brush forget axis eager alone wine silver'
> wallet = Bitcoin().electrum_wallet(seed_words)
> wallet.keystore.xtype
'p2wpkh'
> wallet.keystore.root_derivation
"m/0'/"
> wallet.keystore.xprv
'zprvAZswDvNeJeha8qZ8g7efN3FXYVJLaEUsE9TW6qXDEbVe74AZ75c2sZFZXPNFzxnhChDQ89oC8C5AjWwHmH1HeRKE1c4kKBQAmjUDdKDUZw2'
> wallet.keystore.xpub
'zpub6nsHdRuY92FsMKdbn9BfjBCG6X8pyhCibNP6uDvpnw2cyrVhecvHRMa3Ne8kdJZxjxgwnpbHLkcR4bfnhHy6auHPJyDTQ3kianeuVLdkCYQ'
> addr1 = wallet.new_receiving_address()
> addr1
'bc1q3g5tmkmlvxryhh843v4dz026avatc0zzr6h3af'
> wallet.privkey(addr1)
'L9fSXYNxYWHJWUqrQ6yhZCAJXq6XsfvcJ1Y2EnMAZfLLRNVQswQj'
> addr2 = wallet.new_change_address()
> addr2
'bc1qdy94n2q5qcp0kg7v9yzwe6wvfkhnvyzje7nx2p'
> wallet.privkey(addr2)
'L8rPGyfyzdLLEzxuBeC87Jvpp8FKxwrRtmkZ2PkRmRjqxNF8TVwG'
> addr3 = wallet.new_change_address()
> addr3
'bc1q6xwxcw6m9ga35687tnu5tstmsvmzjwdnzktemv'
> wallet.privkey(addr3)
'L7NeR6r9yU2n4zddxTCUpKYmzugYuouyLsCZR9naTqkBW6sjpxDM'Watch walletsFor security reasons the seed and xprv should ideally be held in cold storage only. If a web application needs to be
able to provide addresses on demand, the solution is to use a watch wallet, generated from the xpub.For example, let's take the Dash xpub from a previous example:> from cryptos import *
> coin = Dash()
> xpub = 'xpub6ChohEsxBkvi17xRrtTEPYcyb8dRKLzjQs5Lsc9NHzhmFQARJZFaeuqxtEMHaF4J8MzatWSYrmq2qAc3BaxFiKzEwX1AKQx5uWHZr3y8s82'
> wallet = coin.watch_wallet(xpub)
> wallet.is_watching_only
True
> wallet.new_receiving_address()
'Xea1GEenz6Toq5YQjvjz86MTT8ezT5ZwnY'
> wallet.new_change_address()
'XwYCR4CwafwoGe6P4H9LndaqAQkmE6xYix'Full list of wallet methods:wallet -> BIP 39 Standardwatch_wallet -> BIP 39 Standard, watch-onlyp2wpkh_p2sh_wallet -> BIP 39 Segwit P2SH addresses, beginning with 3 for Bitcoin mainnetwatch_p2wpkh_p2sh_wallet -> BIP 39 Segwit P2SH addresses, watch-onlyp2wpkh_wallet -> BIP 39 New Segwit Addresses, beginning with 'bc' for Bitcoin mainnetwatch_p2wpkh_wallet -> BIP New Segwit Address, watch-onlyelectrum_wallet -> detects p2kh or p2wpkh based on seedwatch_electrum_wallet -> Watch electrum standard walletwatch_electrum_p2wpkh_wallet -> Watch electrum new segwit walletOld style Electrum words wallet:> import os
> from cryptos import *
> words = entropy_to_words(os.urandom(16))
> words
'float skirt road remind fire antique vendor select senior latin small glide'
> seed = mnemonic_to_seed(words)
> seed
b'\xb7Z\x9b\x9b\x9c\x1bq\x81\x1b\xdc\x98\x1c\xbc\xb8\xbb\x130\xea,\xda\x14\xeb\x9bF\xafu\x88\xc2\xf9\xfc\x7f\xd0\xb0?\x9d\xf3\xa7$0Tx\xd3\xb7\x82\x87U\xe7\xcc\xdd\x16\xddd\xbf'T\t_\xdc R!x\t'
> electrum_privkey(seed, 0)
'5a37812b3057e44636c6e07023e16a8669e12a4365dfabbcb376ed272081d522'
> electrum_privkey(seed, 300, 0)
'04cf414f200cd090239f2116d90608a74eae34ae21103ca9eef7bd9579e48bed'
> electrum_privkey(seed, 0, 1)      #Change address
'9ca3631f813a6f81b70fbfc4384122bfe6fb159e6f7aea2811fe968c2a39d42a'Included scriptsThe following scripts are included. They also provide good sample code for using the library.
Run each script with -h option for details on the cli options.broadcast: Broadcast a transaction from raw hex
        convert_private_key: Convert a private key to a new format
        create_private_key: Generate a new private key
        cryptosend: Send crypto to another address
        explorer: View information in the blockchain about a block, transaction or address
        get_block_sizes: Get the size of a series of blocks
        subscribe: Subscribe to an address for changes
        view_private_key_addresses: View details about a private key including available addressesThe cryptotool command line interface:Cryptool is back to work in progress. This is a legacy reference for now. Use the scripts from the previous section for now.cryptotool bip32_master_key 21456t243rhgtucyadh3wgyrcubw3grydfbng
xprv9s21ZrQH143K2napkeoHT48gWmoJa89KCQj4nqLfdGybyWHP9Z8jvCGzuEDv4ihCyoed7RFPNbc9NxoSF7cAvH9AaNSvepUaeqbSpJZ4rbT

cryptotool bip32_ckd xprv9s21ZrQH143K2napkeoHT48gWmoJa89KCQj4nqLfdGybyWHP9Z8jvCGzuEDv4ihCyoed7RFPNbc9NxoSF7cAvH9AaNSvepUaeqbSpJZ4rbT 0
xprv9vfzYrpwo7QHFdtrcvsSCTrBESFPUf1g7NRvayy1QkEfUekpDKLfqvHjgypF5w3nAvnwPjtQUNkyywWNkLbiUS95khfHCzJXFkLEdwRepbw 

cryptotool bip32_privtopub xprv9s21ZrQH143K2napkeoHT48gWmoJa89KCQj4nqLfdGybyWHP9Z8jvCGzuEDv4ihCyoed7RFPNbc9NxoSF7cAvH9AaNSvepUaeqbSpJZ4rbT
xpub661MyMwAqRbcFGfHrgLHpC5R4odnyasAZdefbDkHBcWarJcXh6SzTzbUkWuhnP142ZFdKdAJSuTSaiGDYjvm7bCLmA8DZqksYjJbYmcgrYFThe -s option lets you read arguments from the command linecryptotool sha256 'some big long brainwallet password' | pybtctool -s privtoaddr | pybtctool -s history
[{'output': u'97f7c7d8ac85e40c255f8a763b6cd9a68f3a94d2e93e8bfa08f977b92e55465e:0', 'value': 50000, 'address': u'1CQLd3bhw4EzaURHbKCwM5YZbUQfA4ReY6'}, {'output': u'4cc806bb04f730c445c60b3e0f4f44b54769a1c196ca37d8d4002135e4abd171:1', 'value': 50000, 'address': u'1CQLd3bhw4EzaURHbKCwM5YZbUQfA4ReY6'}]
cryptotool random_electrum_seed | pybtctool -s electrum_privkey 0 0
593240c2205e7b7b5d7c13393b7c9553497854b75c7470b76aeca50cd4a894d7The -b option lets you read binary data as an argumentcryptotool sha256 123 | pybtctool -s changebase 16 256 | pybtctool -b changebase 256 16
a665a45920422f9d417e4867efdc4fb8a04a1f3fff1fa07e998e86f7f7a27ae30aThe -j option lets you read json from the command line (-J to split a json list into multiple arguments)cryptotool unspent 1FxkfJQLJTXpW6QmxGT6oF43ZH959ns8Cq | pybtctool -j select 200000001 | pybtctool -j mksend 1EXoDusjGwvnjZUyKkxZ4UHEf77z6A5S4P:20000 1FxkfJQLJTXpW6QmxGT6oF43ZH959ns8Cq 1000 | pybtctool -s signall 805cd74ca322633372b9bfb857f3be41db0b8de43a3c44353b238c0acff9d523
0100000003d5001aae8358ae98cb02c1b6f9859dc1ac3dbc1e9cc88632afeb7b7e3c510a49000000008b4830450221009e03bb6122437767e2ca785535824f4ed13d2ebbb9fa4f9becc6d6f4e1e217dc022064577353c08d8d974250143d920d3b963b463e43bbb90f3371060645c49266b90141048ef80f6bd6b073407a69299c2ba89de48adb59bb9689a5ab040befbbebcfbb15d01b006a6b825121a0d2c546c277acb60f0bd3203bd501b8d67c7dba91f27f47ffffffff1529d655dff6a0f6c9815ee835312fb3ca4df622fde21b6b9097666e9284087d010000008a473044022035dd67d18b575ebd339d05ca6ffa1d27d7549bd993aeaf430985795459fc139402201aaa162cc50181cee493870c9479b1148243a33923cb77be44a73ca554a4e5d60141048ef80f6bd6b073407a69299c2ba89de48adb59bb9689a5ab040befbbebcfbb15d01b006a6b825121a0d2c546c277acb60f0bd3203bd501b8d67c7dba91f27f47ffffffff23d5f9cf0a8c233b35443c3ae48d0bdb41bef357b8bfb972336322a34cd75c80010000008b483045022014daa5c5bbe9b3e5f2539a5cd8e22ce55bc84788f946c5b3643ecac85b4591a9022100a4062074a1df3fa0aea5ef67368d0b1f0eaac520bee6e417c682d83cd04330450141048ef80f6bd6b073407a69299c2ba89de48adb59bb9689a5ab040befbbebcfbb15d01b006a6b825121a0d2c546c277acb60f0bd3203bd501b8d67c7dba91f27f47ffffffff02204e0000000000001976a914946cb2e08075bcbaf157e47bcb67eb2b2339d24288ac5b3c4411000000001976a914a41d15ae657ad3bfd0846771a34d7584c37d54a288ac00000000Fun stuff with json:cryptotool unspent 1EXoDusjGwvnjZUyKkxZ4UHEf77z6A5S4P | pybtctool -j multiaccess value | pybtctool -j sum
625216206372

cryptotool unspent 1EXoDusjGwvnjZUyKkxZ4UHEf77z6A5S4P | pybtctool -j count
6198To use the testnet you can add --testnet:cryptotool unspent 2N8hwP1WmJrFF5QWABn38y63uYLhnJYJYTF --testnet
[{"output": "209e5caf8997a3caed4dce0399804ad7fa50c70f866bb7118a42c79de1b76efc:1", "value": 120000000}, {"output": "79f38b3e730eea0e44b5a2e645f0979
2d9f8732a823079ba4778110657cbe7b2:0", "value": 100000000}, {"output": "99d88509d5f0e298bdb6883161c64c7f54444519ce28a0ef3d5942ff4ff7a924:0", "value
": 82211600}, {"output": "80acca12cf4b3b562b583f1dc7e43fff936e432a7ed4b16ac3cd10024820d027:0", "value": 192470000}, {"output": "3e5a3fa342c767d524b653aec51f3efe2122644c57340fbf5f79c75d1911ad35:0", "value": 10000000}]Or the --coin option to use a coin other than bitcoin (bch, btc, dash, doge or ltc)cryptotool unspent LV3VLesnCi3p3zf26Y86kH2FZxfQq2RjrA --coin ltc
[{"output": "42bfe7376410696e260b2198f484f5df4aa6c744465940f9922ac9f8589670a4:0", "value": 14282660}]

cryptotool unspent myLktRdRh3dkK3gnShNj5tZsig6J1oaaJW --coin ltc --testnet
[{"output": "68f9c662503715a3baf29fe4b07c056b0bf6654dbdd9d5393f4d6a18225d0ff3:0", "value": 16333531}, {"output": "aa40041a1fcdb952d6a38594a27529f890d17d715fd54b6914cd6709fa94ca67:0", "value": 100000000}, {"output": "3b72bae956d27ab0ad309808ab76beaf203109f423e533fd7c40f1201672f598:1", "value": 164712303}]Make and broadcast a transaction on the Bitcoin Cash testnet:cryptotool send 89d8d898b95addf569b458fbbd25620e9c9b19c9f730d5d60102abbabcb72678 mgRoeWs2CeCEuqQmNfhJjnpX8YvtPACmCX 999950000 --fee 50000 --coin bch --testnet
{"status": "success", "data": {"txid": "caae4c059ac07827047237560ff44f97c940600f8f0a1e3392f4bcaf91e38c5c", "network": "tbcc"}}The arguments are the private key of the sender, the receiver's address and the fee (default 10000). Change will be returned to the sender.Listing of main coin-specific methods:privtopub            : (privkey) -> pubkeypubtoaddr            : (pubkey) -> addressprivtoaddr           : (privkey) -> Convert a wif encoded private key to correct address, if not wif encoded then p2pkhprivtop2pkh          : (privkey) -> p2pkh addressencode_privkey       : (privkey, format, script_type="p2pkh") -> privkeysign                 : (txobj, i, privkey) -> create digital signature of tx with privkey and add to input isignall              : (txobj, privkey) -> create digital signature of tx with privkey for all inputshistory              : (address, merkle_proof=False) -> tx history of an addressget_histories        : (*addresses, merkle_proof=False) -> tx histories of an addressunspent              : (address, merkle_proof=False) -> unspent outputs for an addressesget_unspents         : (addresses, merkle_proof=False) -> unspent outputs for multiple addressespushtx               : (hex or tx object) -> push a transaction to the blockchainget_raw_tx           : (txid) -> Get the raw hex of a transaction idget_tx               : (txid) -> fetch a tx from the blockchainget_verbose_tx       : (txid) -> Transaction details verbose outputget_txs              : (*txids) -> Fetch multiple transaction detailscalculate_fee        : (Tx) -> Calculate the fee of a transactionsend                 : (privkey, frm, to, value, change_addr=None, fee=None, estimate_fee_blocks: int = 6) -> create and a push a simple transaction to send coins to an address and return change to the change address or sendersend_to_multiple_receivers_tx          : (privkey, addr outs:value pairs, change_addr=None,fee=10000,, estimate_fee_blocks: int = 6) -> create and a push a transaction to send coins to multiple addresses and return change to the change address or senderpreparetx            : (frm, to, value, fee, estimate_fee_blocks: int = 6,change_addr=None): -> create unsigned txobj with change outputpreparemultitx       : (frm, outs:value pairs, change_addr=None, fee=None, estimate_fee_blocks: int = 6): -> create unsigned txobj with multiple outputs and additional change outputpreparesignedtx      : (privkey, frm, to, value, change_addr=None, fee=10000, estimate_fee_blocks: int = 6) -> create signed txobj with change outputpreparesignedmultirecipienttx : (privkey, frm, outs: value pairs, change_addr=None, fee=10000, estimate_fee_blocks: int = 6) -> create signed txobj with multiple outputs and additional change outputmktx                 : (inputs, outputs, locktifme=0, sequence=0xFFFFFFFF) -> create unsigned txobjmktx_with_change     : (inputs, outputs, change_addr=None, fee=None, estimate_fee_blocks=6, locktime=0, sequence=0xFFFFFFFF) -> create unsigned txobjmk_multisig_address  : (pubkeys, M) -> Returns both M-of-N multisig script and addressmultisign            : (txobj, i, script, privkey) -> signatureapply_multisignatures: (txobj, i, script, sigs) -> tx with index i signed with sigsmk_multsig_segwit_address : (pubkeys, M)- Returns both M-of-N multisig script and native segwit addressmk_multsig_cash_address: (pubkeys, M)- Returns both M-of-N multisig script and Bitcoin Cash addresspubtop2w             : (pub) -> pay to witness script hash (segwit address)privtop2w            : (priv) -> pay to witness script hash (segwit address)pubtop2wpkh_p2sh     : (pub) -> Convert a public key to a segwit address encoded in a p2sh scriptprivtop2wpkh_p2sh    : (priv) -> Convert a private key to a segwit address encoded in a p2sh scripthash_to_segwit_addr  : (hash) -. Convert a public key hash to a native segwit addressscripthash_to_segwit_addr: (hash) -> Convert the hash of a p2sh script to a native segwit addressis_address           : (addr) -> true if addr is a valid address for this networkis_p2pkh              : (address) -> Return true if an address is in p2pkh formatis_p2sh              : (addr) -> true if addr is a pay to script hash for this networkis_segwit            : (priv, addr) -> true if priv-addr pair represent a pay to witness script hashis_cash_or_legacy_p2pkh_address : (address) -> Returns true if an address is a legacy p2pkh address or a Bitcoin Cash formatted p2pkh addressis_native_segwit      : (address) -> Returns true if an address is of native segwit typeis_cash_address       : (address) -> Returns true if an address is of Bitcoin Cash address formatmaybe_legacy_segwit   : (address) -> Returns true if address is likely a legacy segwit p2sh addressis_p2wsh              : (address) -> Returns true is address is a Pay To Witness Script Addressis_segwit_or_p2sh     : (address) -> Returns true if an address is a Pay to Witness or Pay to Script addresscurrent_block_height : () -> Latest block heightblock_height         : (txhash) -> Block height containing the txhashinspect              : (tx_hex) -> Deserialize a transaction and decode and ins and outsmerkle_prove         : (txhash) -> Proves a transaction is valid and returns txhash, merkle siblings and block header.estimate_fee_per_kb  : (numblocks) -> Get estimated fee kb to get transaction confirmed within numblocks number of blockstx_size              : (tx) -> Estimate final transaction size of an unsigned transactionestimate_fee         : (tx, numblocks=6) -> Estimate required fee of an unsigned transactionraw_block_header     : (height) -> Get the raw data of a block headerblock_header         : (height) -> Get the decoded details of a block headerblock_headers        : (*heights) -> Get a list of decoded block headerssubscribe_to_block_headers: (callback(height, raw_header, decoded_header)) -> Run a callback whenever a new block is added to the blockchainunsubscribe_from_block_headers: () -> Remove all subscriptions to block headersconfirmations        : (height) -> Number of confirmations a transaction at this height hassubscribe_to_address : (callback(addr, status), addr) -> Run a callback every time there is an activity on an addresssubscribe_to_address_transactions : (callback(address: str, txs, newly_confirmed, history, unspent, confirmed, unconfirmed, proven), addr) -> Run a callback every time there is an activity on an address with details transaction and balance information already retrievedunsubscribe_from_address: (addr) -> Remove all subscriptions for this addressget_balance           : (addr) -> Get the balance, confirmed and unconfirmed, for an addressget_balances          : (*addrs) -> Get the balance, confirmed and unconfirmed, for multiple addressesget_merkle            : (tx) -> Get the merkle root of a transactionmerkle_prove          : (tx) -> Prove a transaction is validmerkle_prove_by_txid  : (txid) -> Prove a transaction id is validbalance_merkle_proven : (addr) -> Get the merkle proven balance for an addressbalance_merkle_proven : (*addrs) -> Get the merkle proven balance for multiple addressesget_address_variations: (addr) -> Return alternative formats for an address (e.g. Standard + Bitcoin Cash address)pub_is_for_p2pkh_addr : (pub, addr) -> Returns true if the p2pkh address for pub is addrwiftoaddr             : (priv) -> Convert a private key in WIF format to the correct address typeelectrum_address      : (masterkey, n, for_change) -> Electrum Address (for old Electrum seeds)encode_privkey        : (privkey, format, script_type) -> Convert a private key to a different format or script typesoutput_script_to_address : (script) -> Convert an output script to an addressscripttoaddr          : (script)  -> Convert an input script to an addressaddrtoscript          : (address) -> Convert an address to an output scriptaddrtoscripthash      : (address) -> Convert an address to scripthash as required by ElectrumX serversp2sh_scriptaddr       : (script) -> Convert an output P2SH script to a P2SH addressp2sh_segwit_addr      : (script) -> Convert an output P2SH script to a native segwit P2WSH addresspubtosegwitaddress    : (pub) -> Convert a public key to a native segwit addressprivtosegwitaddress   : (priv) -> Convert a private key to a native segwit addressscripthash_to_cash_addr: (scripthash) -> Convert a scripthash to a Bitcoin Cash addresspubtocashaddress      : (pub) -> Convert a public key to a Bitcoin Cash addressprivtocashaddress     : (priv) -> Convert a private key to a Bitcoin Cash addressp2sh_cash_addr        : (script) -> Convert an script to a Bitcoin Cash addresshash_to_cash_addr     : (hash) -> Convert the hash of a p2sh script to a Bitcoin Cash addresslegacy_addr_to_cash_address: (addr) -> Convert a legacy P2PKH address to a Bitcoin Cash addresscash_address_to_legacy_addr: (addr) -> Convert a Bitcoin Cash address to a legalcy P2PKH addressListing of main non-coin specific commands:add                  : (key1, key2) -> key1 + key2 (works on privkeys or pubkeys)multiply             : (pubkey, privkey) -> returns pubkey * privkeyecdsa_sign           : (message, privkey) -> sigecdsa_verify         : (message, sig, pubkey) -> True/Falseecdsa_recover        : (message, sig) -> pubkeyrandom_key           : () -> privkeyrandom_electrum_seed : () -> electrum seedelectrum_stretch     : (seed) -> secret exponentelectrum_privkey     : (seed or secret exponent, i, type) -> privkeyelectrum_mpk         : (seed or secret exponent) -> master public keyelectrum_pubkey      : (seed or secexp or mpk) -> pubkeybip32_master_key     : (seed) -> bip32 master keybip32_ckd            : (private or public bip32 key, i) -> child keybip32_privtopub      : (private bip32 key) -> public bip32 keybip32_extract_key    : (private or public bip32_key) -> privkey or pubkeydeserialize          : (hex or bin transaction) -> JSON txserialize            : (JSON tx) -> hex or bin tx
s* verify_tx_input      : (tx, i, script, sig, pub) -> True/Falsetx_hash              : (hex or bin tx) -> hashaccess               : (json list/object, prop) -> desired property of that json objectmultiaccess          : (json list, prop) -> like access, but mapped across each list elementslice                : (json list, start, end) -> given slice of the listcount                : (json list) -> number of elementssum                  : (json list) -> sum of all valuesselect               : (unspent, value) -> returns list of unspents which are enough to cover the valueAnother reminder and useful linksAnother reminder, if you are doing something new with the library, whether a regular transaction, multisig,
segwit or a coin you haven't worked with before, try it out in testnet first or alternatively with small amounts
on the mainnet. The original pybitcointools had issues opened in Github where people lost money either due to
not understanding what they were doing or because of bugs.Working togetherIf you wish to work together on crypto or other software related projects you can contact me using social links on my Github profile.
I can very easily and quickly build software tools on top of this pybitcointools library.