Skip to main content

PyWallet

Python version PyPi version PyPi status

Simple BIP32 (HD) wallet creation for: BTC, BTG, BCH, ETH, LTC, DASH, DOGE

BIP32 (or HD for “hierarchical deterministic”) wallets allow you to create child wallets which can only generate public keys and don’t expose a private key to an insecure server.

This library simplify the process of creating new wallets for the BTC, BTG, BCH, ETH, LTC, DASH and DOGE cryptocurrencies.

Most of the code here is forked from:

I simply added support for a few more cryptocurrencies (BCH, BTG, DASH), as well as created methods to simplify the creation of HD wallets and child wallets.

Enjoy!


Installation

Install via PiP:

$ sudo pip install pywallet

Example code:

Create HD Wallet

The following code creates a new Bitcoin HD wallet:

# create_btc_wallet.py

from pywallet import wallet

# generate 12 word mnemonic seed
seed = wallet.generate_mnemonic()

# create bitcoin wallet
w = wallet.create_wallet(network="BTC", seed=seed, children=1)

print(w)

Output looks like this:

$ python create_btc_wallet.py

{
  "coin": "BTC",
  "seed": "guess tiny intact poet process segment pelican bright assume avocado view lazy",
  "address": "1HwPm2tcdakwkTTWU286crWQqTnbEkD7av",
  "xprivate_key": "xprv9s21ZrQH143K2Dizn667UCo9oYPdTPSMWq7D5t929aXf1kfnmW79CryavzBxqbWfrYzw8jbyTKvsiuFNwr1JL2qfrUy2Kbwq4WbBPfxYGbg",
  "xpublic_key": "xpub661MyMwAqRbcEhoTt7d7qLjtMaE7rrACt42otGYdhv4dtYzwK3RPkfJ4nEjpFQDdT8JjT3VwQ3ZKjJaeuEdpWmyw16sY9SsoY68PoXaJvfU",
  "wif": "L1EnVJviG6jR2oovFbfxZoMp1JknTACKLzsTKqDNUwATCWpY1Fp4",
  "children": [{
     "address": "1E3btRwsoJx2jUcMnATyx7poHhV2tomL8g",
     "path": "m/0",
     "xpublic_key": "xpub69Fho5TtAbdoXyWzgUV1ZYst9K4bVfoGNLZxQ9u5js4Rb1jEyUjDtoATXbWvAcV8cERCMMnH8wYRVVUsRDSfaMjLqaY3TvD7Am9ALjq5PsG",
     "wif": "KysRDiwJNkS9VPzy1UH76DrCDizsWKtEooSzikich792RVzcUaJP"
 }]
}

Similarly, you can do the same for an Ethereum wallet:

# create_eth_wallet.py

from pywallet import wallet

seed = wallet.generate_mnemonic()
w = wallet.create_wallet(network="ETH", seed=seed, children=1)

print(w)

Output looks like this (no WIF for Ethereum):

$ python create_eth_wallet.py

{
  "coin": "ETH",
  "seed": "traffic happy world clog clump cattle great toy game absurd alarm auction",
  "address": "0x3b777f60eb04fcb13e6b27e468532e491409722e",
  "xprivate_key": "xprv9yTuSjwb95QZznV6epMWpb4Kpc2S8ZRaQuAf5B697YXtQD2tDmmJ5KvwJWVjtbVrdJ1WBKNnuodrpTKGfHfiPSEgrAxUjL5RP1gQwwT3fFx",
  "xpublic_key": "xpub6GhhMtkVjoPi5DKtqapKzMzrzdGjo1EPc7Ka6KdeoXYdCrTBH1Hu1wKysm8boWSy8VeTKVJi6gQJ2qJ4YG2ZhvFDcUUgMJrFCJWN1PGtBry",
  "wif": "",
  "children": [{
    "address": "0x87eb82d43fa7316df0a989c0d951a9037ed02f9b",
    "path": "m/0",
    "xpublic_key": "xpub6LnpVXD73jNuAYXxzQCnEY6wXQspwkiAEkZWoX4BW9Tzx6KbUrMUYAU1Yvw4kebPHSPiEJPo8irHWHSwQR6WuVwUj85xURsugPWeJVH6sau",
    "wif": ""
  }]
}

* Valid options for network are: BTC, BTG, BCH, LTC, DASH, DOGE

Create Child Wallet

You can create child-wallets (BIP32 wallets) from the HD wallet’s Extended Public Key to generate new public addresses without revealing your private key.

Example:

# create_child_wallet.py

from pywallet import wallet

WALLET_PUBKEY = 'YOUR WALLET XPUB'

# generate address for specific user (id = 10)
user_addr = wallet.create_address(network="BTC", xpub=WALLET_PUBKEY, child=10)

# or generate a random address, based on timestamp
rand_addr = wallet.create_address(network="BTC", xpub=WALLET_PUBKEY)

print("User Address\n", user_addr)
print("Random Address\n", rand_addr)

Output looks like this:

$ python create_child_wallet.py

User Address
{
  "address": "13myudz3WhpBezoZue6cwRUoHrzWs4vCrb",
  "path": "m/0/395371597"
}
Random Address
{
  "address": "1KpS2wC5J8bDsGShXDHD7qdGvnic1h27Db",
  "path": "m/0/394997119"
}

IMPORTANT

I highly recommend that you familiarize yourself with the Blockchain technology and be aware of security issues. Reading Mastering Bitcoin and going over Steven Buss’s security notes on the Bitmerchant repository is a good start.

Enjoy!

Release files for pywallet-lts 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pywallet-lts 0.1.2
File Size Uploaded
pywallet_lts-0.1.2.tar.gz 32.9 kB Details

Release files / pywallet_lts-0.1.2.tar.gz

Download URL pywallet_lts-0.1.2.tar.gz
Size 32.9 kB
Tags Source
SHA-256 checksum
How to use checksums
23fe95123160b574eed5c8c042ed1a1568c694df2f475ebbd9d5a5c8c007b7b7
BLAKE2b-256 checksum
How to use checksums
ad9bf06ab752211ad0f6ba4b52350fd335cff62e12295d9c43f1c4365153fd73
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.10.6

Release history Release notifications | RSS feed

This release

0.1.2 This release

1 release file

0.1.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page