请选择 进入手机版 | 继续访问电脑版
  • 设为首页
  • 点击收藏
  • 手机版
    手机扫一扫访问
    迪恩网络手机版
  • 关注官方公众号
    微信扫一扫关注
    公众号

ebellocchia/py_crypto_hd_wallet: HD wallet for cryptocurrencies based on my bip_ ...

原作者: [db:作者] 来自: 网络 收藏 邀请

开源软件名称:

ebellocchia/py_crypto_hd_wallet

开源软件地址:

https://github.com/ebellocchia/py_crypto_hd_wallet

开源编程语言:

Python 100.0%

开源软件介绍:

PY crypto HD wallet

PyPI version Build Status codecov Codacy Badge CodeFactor License: MIT

Introduction

This package contains a very basic implementation of a HD (Hierarchical Deterministic) wallet based on my bip_utils library.
It is basically a nice wrapper for the bip_utils library for generating mnemonics, seeds, public/private keys and addresses. Therefore, it has no network functionalities.
The supported coins are the same of the bip_utils library, so check the related page.

Install the package

The package requires Python 3, it is not compatible with Python 2. To install it:

  • Using setuptools:

      python setup.py install
    
  • Using pip, from this directory (local):

      pip install .
    
  • Using pip, from PyPI:

      pip install py_crypto_hd_wallet
    

NOTE: if you are using an Apple M1, please make sure to update coincurve (required by bip_utils) to version 17.0.0 otherwise it won't work.

To run tests:

python -m unittest discover

Or you can install tox:

pip install tox

And then simply run tox:

tox

To run tests and get the code coverage and report.

BIP wallet

A BIP wallet is a wallet based on BIP-0044, BIP-0049 and BIP-0084 specifications.

BIP Wallet factory construction

A BIP wallet is created using the HdWalletBipFactory class.
A HdWalletBipFactory class is simply constructed by specifying the desired coin. After the construction, the factory can be used to create wallets with the specified coin.

Supported coin enumerative:

BIP-0044

Coin Main net enum Test net enum
Akash Network HdWalletBip44Coins.AKASH_NETWORK -
Algorand HdWalletBip44Coins.ALGORAND -
Avalanche C-Chain HdWalletBip44Coins.AVAX_C_CHAIN -
Avalanche P-Chain HdWalletBip44Coins.AVAX_P_CHAIN -
Avalanche X-Chain HdWalletBip44Coins.AVAX_X_CHAIN -
Band Protocol HdWalletBip44Coins.BAND_PROTOCOL -
Binance Chain HdWalletBip44Coins.BINANCE_CHAIN -
Binance Smart Chain HdWalletBip44Coins.BINANCE_SMART_CHAIN -
Bitcoin HdWalletBip44Coins.BITCOIN HdWalletBip44Coins.BITCOIN_TESTNET
Bitcoin Cash HdWalletBip44Coins.BITCOIN_CASH HdWalletBip44Coins.BITCOIN_CASH_TESTNET
Bitcoin Cash SLP HdWalletBip44Coins.BITCOIN_CASH_SLP HdWalletBip44Coins.BITCOIN_CASH_SLP_TESTNET
BitcoinSV HdWalletBip44Coins.BITCOIN_SV HdWalletBip44Coins.BITCOIN_SV_TESTNET
Celo HdWalletBip44Coins.CELO -
Certik HdWalletBip44Coins.CERTIK -
Chihuahua HdWalletBip44Coins.CHIHUAHUA -
Cosmos HdWalletBip44Coins.COSMOS -
Dash HdWalletBip44Coins.DASH HdWalletBip44Coins.DASH_TESTNET
Dogecoin HdWalletBip44Coins.DOGECOIN HdWalletBip44Coins.DOGECOIN_TESTNET
eCash HdWalletBip44Coins.ECASH HdWalletBip44Coins.ECASH_TESTNET
Elrond HdWalletBip44Coins.ELROND -
EOS HdWalletBip44Coins.EOS -
Ethereum HdWalletBip44Coins.ETHEREUM -
Ethereum Classic HdWalletBip44Coins.ETHEREUM_CLASSIC -
Fantom Opera HdWalletBip44Coins.FANTOM_OPERA -
Filecoin HdWalletBip44Coins.FILECOIN -
Harmony One (Cosmos address) HdWalletBip44Coins.HARMONY_ONE_ATOM -
Harmony One (Ethereum address) HdWalletBip44Coins.HARMONY_ONE_ETH -
Harmony One (Metamask address) HdWalletBip44Coins.HARMONY_ONE_METAMASK -
Huobi Chain HdWalletBip44Coins.HUOBI_CHAIN -
IRIS Network HdWalletBip44Coins.IRIS_NET -
Kava HdWalletBip44Coins.KAVA -
Kusama (ed25519 SLIP-0010) HdWalletBip44Coins.KUSAMA_ED25519_SLIP -
Litecoin HdWalletBip44Coins.LITECOIN HdWalletBip44Coins.LITECOIN_TESTNET
Nano HdWalletBip44Coins.NANO -
Near Protocol HdWalletBip44Coins.NEAR_PROTOCOL -
NEO HdWalletBip44Coins.NEO -
OKEx Chain (Cosmos address) HdWalletBip44Coins.OKEX_CHAIN_ATOM -
OKEx Chain (Ethereum address) HdWalletBip44Coins.OKEX_CHAIN_ETH -
OKEx Chain (Old Cosmos address before mainnet upgrade) HdWalletBip44Coins.OKEX_CHAIN_ATOM_OLD -
Ontology HdWalletBip44Coins.ONTOLOGY -
Osmosis HdWalletBip44Coins.OSMOSIS -
Polkadot (ed25519 SLIP-0010) HdWalletBip44Coins.POLKADOT_ED25519_SLIP -
Polygon HdWalletBip44Coins.POLYGON -
Ripple HdWalletBip44Coins.RIPPLE -
Secret Network (old path) HdWalletBip44Coins.SECRET_NETWORK_OLD -
Secret Network (new path) HdWalletBip44Coins.SECRET_NETWORK_NEW -
Solana HdWalletBip44Coins.SOLANA -
Stellar HdWalletBip44Coins.STELLAR -
Terra HdWalletBip44Coins.TERRA -
Tezos HdWalletBip44Coins.TEZOS -
Theta Network HdWalletBip44Coins.THETA -
Tron HdWalletBip44Coins.TRON -
VeChain HdWalletBip44Coins.VECHAIN -
Verge HdWalletBip44Coins.VERGE -
Zcash HdWalletBip44Coins.ZCASH HdWalletBip44Coins.ZCASH_TESTNET
Zilliqa HdWalletBip44Coins.ZILLIQA -

Harmony One and OKEx Chain have different formats, see bip_utils description for more information.

BIP-0049

Coin Main net enum Test net enum
Bitcoin HdWalletBip49Coins.BITCOIN HdWalletBip49Coins.BITCOIN_TESTNET
Bitcoin Cash HdWalletBip49Coins.BITCOIN_CASH HdWalletBip49Coins.BITCOIN_CASH_TESTNET
Bitcoin Cash SLP HdWalletBip49Coins.BITCOIN_CASH_SLP HdWalletBip49Coins.BITCOIN_CASH_SLP_TESTNET
BitcoinSV HdWalletBip49Coins.BITCOIN_SV HdWalletBip49Coins.BITCOIN_SV_TESTNET
Dash HdWalletBip49Coins.DASH HdWalletBip49Coins.DASH_TESTNET
Dogecoin HdWalletBip49Coins.DOGECOIN HdWalletBip49Coins.DOGECOIN_TESTNET
eCash HdWalletBip49Coins.ECASH HdWalletBip49Coins.ECASH_TESTNET
Litecoin HdWalletBip49Coins.LITECOIN HdWalletBip49Coins.LITECOIN_TESTNET

BIP-0084

Coin Main net enum Test net enum
Bitcoin HdWalletBip84Coins.BITCOIN HdWalletBip84Coins.BITCOIN_TESTNET
Litecoin HdWalletBip84Coins.LITECOIN HdWalletBip84Coins.LITECOIN_TESTNET

BIP-0086

Coin Main net enum Test net enum
Bitcoin HdWalletBip86Coins.BITCOIN HdWalletBip86Coins.BITCOIN_TESTNET

Example

from py_crypto_hd_wallet import HdWalletBipFactory, HdWalletBip44Coins, HdWalletBip49Coins

# Create a BIP-0044 Bitcoin wallet factory
hd_wallet_fact = HdWalletBipFactory(HdWalletBip44Coins.BITCOIN)
# Create a BIP-0049 Litecoin wallet factory
hd_wallet_fact = HdWalletBipFactory(HdWalletBip49Coins.LITECOIN)

Wallet creation

After a wallet factory is constructed, it can be used to create wallets.
Supported words number:

Words number Enum
12 HdWalletBipWordsNum.WORDS_NUM_12
15 HdWalletBipWordsNum.WORDS_NUM_15
18 HdWalletBipWordsNum.WORDS_NUM_18
21 HdWalletBipWordsNum.WORDS_NUM_21
24 HdWalletBipWordsNum.WORDS_NUM_24

Supported languages:

Language Enum
Chinese (simplified) HdWalletBipLanguages.CHINESE_SIMPLIFIED
Chinese (traditional) HdWalletBipLanguages.CHINESE_TRADITIONAL
Czech HdWalletBipLanguages.CZECH
English HdWalletBipLanguages.ENGLISH
French HdWalletBipLanguages.FRENCH
Italian HdWalletBipLanguages.ITALIAN
Korean HdWalletBipLanguages.KOREAN
Portuguese HdWalletBipLanguages.PORTUGUESE
Spanish HdWalletBipLanguages.SPANISH

A wallet can be created in the following ways:

  • Randomly by generating a random mnemonic with the specified words number (default: 24) and language (default: English):

      from py_crypto_hd_wallet import HdWalletBip44Coins, HdWalletBipWordsNum, HdWalletBipLanguages, HdWalletBipFactory
    
      # Create factory
      hd_wallet_fact = HdWalletBipFactory(HdWalletBip44Coins.BITCOIN)
      # Create randomly (words number: 24, language: English)
      hd_wallet = hd_wallet_fact.CreateRandom("my_wallet_name")
      # Create randomly by specifying the words number (language: English):
      hd_wallet = hd_wallet_fact.CreateRandom("my_wallet_name", HdWalletBipWordsNum.WORDS_NUM_12)
      hd_wallet = hd_wallet_fact.CreateRandom("my_wallet_name", HdWalletBipWordsNum.WORDS_NUM_24)
      # Specifying the language:
      hd_wallet = hd_wallet_fact.CreateRandom("my_wallet_name", HdWalletBipWordsNum.WORDS_NUM_12, HdWalletBipLanguages.ITALIAN)
      hd_wallet = hd_wallet_fact.CreateRandom("my_wallet_name", HdWalletBipWordsNum.WORDS_NUM_12, HdWalletBipLanguages.CZECH)
      hd_wallet = hd_wallet_fact.CreateRandom("my_wallet_name", HdWalletBipWordsNum.WORDS_NUM_12, HdWalletBipLanguages.KOREAN)
    
  • From an already existent mnemonic (language is autoamtically detected):

      from py_crypto_hd_wallet import HdWalletBip44Coins, HdWalletBipFactory
    
      # Create factory
      hd_wallet_fact = HdWalletBipFactory(HdWalletBip44Coins.BITCOIN)
    
      # Create from mnemonic
      mnemonic = "garbage fossil patrol shadow put morning miss chapter sister undo nation dignity"
      hd_wallet = hd_wallet_fact.CreateFromMnemonic("my_wallet_name", mnemonic)
    
  • From a seed:

      import binascii
      from py_crypto_hd_wallet import HdWalletBip44Coins, HdWalletBipFactory
    
      # Create factory
      hd_wallet_fact = HdWalletBipFactory(HdWalletBip44Coins.BITCOIN)
    
      # Create from seed
      seed_bytes = b"5eb00bbddcf069084889a8ab9155568165f5c453ccb85e70811aaed6f6da5fc19a5ac40b389cd370d086206dec8aa6c43daea6690f20ad3d8d48b2d2ce9e38e4"
      hd_wallet = hd_wallet_fact.CreateFromSeed("my_wallet_name", binascii.unhexlify(seed_bytes))
    
  • From an extended key:

      from py_crypto_hd_wallet import HdWalletBip44Coins, HdWalletBipFactory
    
      # Create factory
      hd_wallet_fact = HdWalletBipFactory(HdWalletBip44Coins.BITCOIN)
    
      # Create from private extended key
      ex_key = "xprv9s21ZrQH143K4L5D8NLB8rE6XwqsK7hkDLUnVpeMq1t59fZPGU4811A1ih8mPrKisgftXWJZZXAoKdzCcX4WERMXns4s9pDYr54iHs3sSha"
      hd_wallet = hd_wallet_fact.CreateFromExtendedKey("my_wallet_name", ex_key)
    
      # Create from public extended key, generating a public-only wallet
      ex_key = "xpub6DCoCpSuQZB2jawqnGMEPS63ePKWkwWPH4TU45Q7LPXWuNd8TMtVxRrgjtEshuqpK3mdhaWHPFsBngh5GFZaM6si3yZdUsT8ddYM3PwnATt"
      hd_wallet = hd_wallet_fact.CreateFromExtendedKey("my_wallet_name", ex_key)
    
  • From a private key:

      import binascii
      from py_crypto_hd_wallet import HdWalletBip44Coins, HdWalletBipFactory
    
      # Create factory
      hd_wallet_fact = HdWalletBipFactory(HdWalletBip44Coins.BITCOIN)
    
      # Create from private key bytes
      priv_key = binascii.unhexlify(b"e8f32e723decf4051aefac8e2c93c9c5b214313817cdb01a1494b917c8436b35")
      hd_wallet = hd_wallet_fact.CreateFromPrivateKey("my_wallet_name", priv_key)
    

In case of errors (e.g. construction from an invalid mnemonic, seed or keys) a ValueError exception will be raised.

Generating wallet keys and addresses

After a wallet is created, you can generate keys and addresses by simply calling the Generate method.
For generating a wallet, you can specify:

  • acc_idx : Account index (default value: 0)
  • change_idx : Chain: external (default value: HdWalletChanges.CHAIN_EXT)
  • addr_num : Number of addresses (default value: 20)
  • addr_off : Address offset (default value: 0)

In case a wallet was created from an extended key, only the levels starting for the extended key depth will be generated.
The levels are the ones specified by the BIP-0044 specification:

master / purpose / coin_type / account / change / address_index

For example:

  • if the wallet was created from a master key, all the levels will be generated
  • if the wallet was created from an account key, only account, change and address_index levels will be generatedd; in this case, the account index parameter will be ignored
  • if the wallet was created from a change key, only change and address_index levels will be generated; in this case, the account and change index parameter will be ignored
  • if the wallet was created from an address_index key, only address_index level will be generated; in this case, all the parameters will be ignored

In case the extended key was public, only public keys will be generated (watch-only wallet).
Please note that, for watch-only wallets, the public extended key shall be of change or address index level, otherwise an exception will be raised.

Supported change index enumerative:

  • External chain: HdWalletChanges.CHAIN_EXT
  • Internal chain: HdWalletChanges.CHAIN_INT

Example

import binascii
from py_crypto_hd_wallet import HdWalletBip44Coins, HdWalletBipChanges, HdWalletBipFactory

# Create factory
hd_wallet_fact = HdWalletBipFactory(HdWalletBip44Coins.BITCOIN)
# Create random
hd_wallet = hd_wallet_fact.CreateRandom("my_wallet_name")

# Generate with default parameters
hd_wallet.Generate()
# Specify parameters (it'll generate addresses from index 10 to 15)
hd_wallet.Generate(acc_idx=1, change_idx=HdWalletBipChanges.CHAIN_EXT, addr_num=5, addr_off=10)
# After generated, you can check if the wallet is watch-only with the IsWatchOnly method
is_wo = hd_wallet.IsWatchOnly()

In case of invalid parameters, a ValueError exception will be raised.

Getting wallet data

After keys and addresses were generated, you can:

  • Get the whole data as dictionary:

      # Get wallet data as a dictionary
      wallet_data = hd_wallet.ToDict()
    
  • Get the whole data as a string in JSON format:

      # Get wallet data as a string in JSON format
      wallet_data = hd_wallet.ToJson()
    
  • Save data to a file in JSON format using the HdWalletSaver class, to store the generated keys and addresses:

      # Save wallet data to file
      HdWalletSaver(hd_wallet).SaveToFile("my_wallet.txt")
    
  • Get a specific data, see the next paragraph

Getting specific wallet data

For getting specific data, the following methods of HdWalletBip can be used:

  • GetData(HdWalletBipDataTypes) : return the specified data type if existent, None otherwise
  • HasData(HdWalletBipDataTypes) : return if the specified data type is existent

The possible data types HdWalletBipDataTypes are:

  • HdWalletBipDataTypes.WALLET_NAME : wallet name
  • HdWalletBipDataTypes.COIN_NAME : coin name
  • HdWalletBipDataTypes.SPEC_NAME : specification name
  • HdWalletBipDataTypes.MNEMONIC : mnemonic
  • HdWalletBipDataTypes.PASSPHRASE : passphrase
  • HdWalletBipDataTypes.SEED_BYTES : seed bytes
  • HdWalletBipDataTypes.ACCOUNT_IDX : account index
  • HdWalletBipDataTypes.CHANGE_IDX : change index
  • HdWalletBipDataTypes.MASTER_KEY : master keys (HdWalletBipKeys object)
  • HdWalletBipDataTypes.PURPOSE_KEY : purpose keys (HdWalletBipKeys object)
  • HdWalletBipDataTypes.COIN_KEY : coin keys (HdWalletBipKeys object)
  • HdWalletBipDataTypes.ACCOUNT_KEY : account keys (HdWalletBipKeys object)
  • HdWalletBipDataTypes.CHANGE_KEY : change keys (HdWalletBipKeys object)
  • HdWalletBipDataTypes.ADDRESS_OFF : addresses offset (if different from zero)
  • HdWalletBipDataTypes.ADDRESS : addresses (HdWalletBipAddresses object)

In case of keys, a HdWalletBipKeys object is returned. This object has the following methods:

  • ToDict() : return keys as a dictionary
  • ToJson() : return keys as a string in JSON format
  • HasKey(HdWalletBipKeyTypes) : get if the specified key type is existent
  • GetKey(HdWalletBipKeyTypes) : get the specified key if existent, None otherwise

The possible key types HdWalletBipKeyTypes are:

  • HdWalletBipKeyTypes.EX_PRIV : private key in extended serialized format
  • HdWalletBipKeyTypes.RAW_PRIV : raw private key
  • HdWalletBipKeyTypes.WIF_PRIV : private key in WIF format, if supported by the coin
  • HdWalletBipKeyTypes.EX_PUB : public key in extended serialized format
  • HdWalletBipKeyTypes.RAW_COMPR_PUB : raw public key in compressed format
  • HdWalletBipKeyTypes.RAW_UNCOMPR_PUB : raw public key in uncompressed format
  • HdWalletBipKeyTypes.ADDRESS : address correspondet to the public key

In case of addresses, a HdWalletBipAddresses is returned, This object has the following methods:

  • ToDict() : return addresses as a dictionary
  • ToJson() : return addresses as a string in JSON format
  • Count() : get the number of addresses
  • getitem(addr_idx) : get the address at the specified index using operator []
  • iter() : allows iterating over all addresses

Each address is of type HdWalletBipKeys, so you can access it as a HdWalletBipKeys class as previously described.

Example

from py_crypto_hd_wallet import (
    HdWalletBip44Coins, HdWalletBipDataTypes, HdWalletBipKeyTypes, HdWalletBipFactory
)

# Create factory
hd_wallet_fact = HdWalletBipFactory(HdWalletBip44Coins.BITCOIN)
# Create random
hd_wallet = hd_wallet_fact.CreateRandom("my_wallet_name")

# Generate with default parameters
hd_wallet.Generate()

# Get wallet, coin and specification names
wallet_name = hd_wallet.GetData(HdWalletBipDataTypes.WALLET_NAME)
coin_name   = hd_wallet.GetData(HdWalletBipDataTypes.COIN_NAME)
spec_name   = hd_wallet.GetData(HdWalletBipDataTypes.SPEC_NAME)
# Get wallet account index
acc_idx = hd_wallet.GetData(HdWalletBipDataTypes.ACCOUNT_IDX)

# Get wallet account keys
acc_key = hd_wallet.GetData(HdWalletBipDataTypes.ACCOUNT_KEY)
# Print keys in different formats
print(acc_key.ToDict())
print(acc_key.ToJson())
# Check if a key type is existent
has_wif = acc_key.HasKey(HdWalletBipKeyTypes.WIF_PRIV)
# Get keys individually
ex_priv = acc_key.GetKey(HdWalletBipKeyTypes.EX_PRIV)
raw_priv = acc_key.GetKey(HdWalletBipKeyTypes.RAW_PRIV)
wif_priv = acc_key.GetKey(HdWalletBipKeyTypes.WIF_PRIV)
ex_pub = acc_key.GetKey(HdWalletBipKeyTypes.EX_PUB)
raw_compr_pub = acc_key.GetKey(HdWalletBipKeyTypes.RAW_COMPR_PUB)
raw_uncompr_pub = acc_key.GetKey(HdWalletBipKeyTypes.RAW_UNCOMPR_PUB)
# Get address
address = acc_key.GetKey(HdWalletBipKeyTypes.ADDRESS)

# Get wallet addresses
addresses = hd_wallet.GetData(HdWalletBipDataTypes.ADDRESS)
# Get address count
addr_cnt = addresses.Count()
# Get a specific address index
addr_0 = addresses[0]
# Print first address in different formats
print(addresses[0].ToDict())
print(addresses[0].ToJson())
# Iterate over all addresses and print their keys and addresses
for addr in addresses:
   print(addr.GetKey(HdWalletBipKeyTypes.RAW_PRIV))
   print(addr.GetKey(HdWalletBipKeyTypes.RAW_COMPR_PUB))
   print(addr.GetKey(HdWalletBipKeyTypes.ADDRESS))

Substrate wallet

A Substrate wallet is a wallet based on Substrate (Polkadot/Kusama ecosystem). It doesn't follow BIPs but it generates a pair of private and public keys depending on the derivation path.

Substrate Wallet factory construction

A Substrate wallet is created using the HdWalletSubstrateFactory class.
A HdWalletSubstrateFactory class is simply constructed by specifying the desired coin. After the construction, the factory can be used to create wallets with the specified coin.

Supported coin enumerative:

Coin Enum
Acala HdWalletSubstrateCoins.ACALA
Bifrost HdWalletSubstrateCoins.BIFROST
Chainx HdWalletSubstrateCoins.CHAINX
Edgeware HdWalletSubstrateCoins.EDGEWARE
Generic HdWalletSubstrateCoins.GENERIC
Karura HdWalletSubstrateCoins.KARURA
Kusama HdWalletSubstrateCoins.KUSAMA
Moonbeam HdWalletSubstrateCoins.MOONBEAM
Moonriver HdWalletSubstrateCoins.MOONRIVER
Phala Network HdWalletSubstrateCoins.PHALA
Plasm Network HdWalletSubstrateCoins.PLASM
Polkadot HdWalletSubstrateCoins.POLKADOT
Sora HdWalletSubstrateCoins.SORA
Stafi HdWalletSubstrateCoins.STAFI

Example

from py_crypto_hd_wallet import HdWalletSubstrateFactory, HdWalletSubstrateCoins

# Create a substrate wallet factory
hd_wallet_fact = HdWalletSubstrateFactory(HdWalletSubstrateCoins.POLKADOT)

Wallet creation

After a wallet factory is constructed, it can be used to create wallets.
Supported words number:

Words number Enum
12 HdWalletSubstrateWordsNum.WORDS_NUM_12
15 HdWalletSubstrateWordsNum.WORDS_NUM_15
18 HdWalletSubstrateWordsNum.WORDS_NUM_18
21 HdWalletSubstrateWordsNum.WORDS_NUM_21
24 HdWalletSubstrateWordsNum.WORDS_NUM_24

Supported languages:

Language Enum
Chinese (simplified) HdWalletSubstrateLanguages.CHINESE_SIMPLIFIED
Chinese (traditional) HdWalletSubstrateLanguages.CHINESE_TRADITIONAL
Czech HdWalletSubstrateLanguages.CZECH
English HdWalletSubstrateLanguages.ENGLISH
French HdWalletSubstrateLanguages.FRENCH
Italian HdWalletSubstrateLanguages.ITALIAN
Korean HdWalletSubstrateLanguages.KOREAN
Portuguese HdWalletSubstrateLanguages.PORTUGUESE
Spanish HdWalletSubstrateLanguages.SPANISH

A wallet can be created in the following ways:

  • Randomly by generating a random mnemonic with the specified words number (default: 24) and language (default: English):

      from py_crypto_hd_wallet import HdWalletSubstrateCoins, HdWalletSubstrateWordsNum, HdWalletSubstrateLanguages, HdWalletSubstrateFactory
    
      # Create factory
      hd_wallet_fact = HdWalletSubstrateFactory(HdWalletSubstrateCoins.POLKADOT)
      # Create randomly (words number: 24, language: English)
      hd_wallet = hd_wallet_fact.CreateRandom("my_wallet_name")
      # Create randomly by specifying the words number (language: English):
      hd_wallet = hd_wallet_fact.CreateRandom("my_wallet_name", HdWalletSubstrateWordsNum.WORDS_NUM_12)
      hd_wallet = hd_wallet_fact.CreateRandom("my_wallet_name", HdWalletSubstrateWordsNum.WORDS_NUM_24)
      # Specifying the language:
      hd_wallet = hd_wallet_fact.CreateRandom("my_wallet_name", HdWalletSubstrateWordsNum.WORDS_NUM_12, HdWalletSubstrateLanguages.ITALIAN)
      hd_wallet = hd_wallet_fact.CreateRandom("my_wallet_name", HdWalletSubstrateWordsNum.WORDS_NUM_12, HdWalletSubstrateLanguages.CZECH)
      hd_wallet = hd_wallet_fact.CreateRandom("my_wallet_name", HdWalletSubstrateWordsNum.WORDS_NUM_12, HdWalletSubstrateLanguages.KOREAN)
    
  • From an already existent mnemonic (language is autoamtically detected):

      from py_crypto_hd_wallet import HdWalletSubstrateCoins, HdWalletSubstrateFactory
    
      # Create factory
      hd_wallet_fact = HdWalletSubstrateFactory(HdWalletSubstrateCoins.POLKADOT)
    
      # Create from mnemonic
      mnemonic = "garbage fossil patrol shadow put morning miss chapter sister undo nation dignity"
      hd_wallet = hd_wallet_fact.CreateFromMnemonic("my_wallet_name", mnemonic)
    
  • From a seed:

      import binascii
      from py_crypto_hd_wallet import HdWalletSubstrateCoins, HdWalletSubstrateFactory
    
      # Create factory
      hd_wallet_fact = HdWalletSubstrateFactory(HdWalletSubstrateCoins.POLKADOT)
    
      # Create from seed
      seed_bytes = b"5eb00bbddcf069084889a8ab9155568165f5c453ccb85e70811aaed6f6da5fc19a5ac40b389cd370d086206dec8aa6c43daea6690f20ad3d8d48b2d2ce9e38e4"
      hd_wallet = hd_wallet_fact.CreateFromSeed("my_wallet_name", binascii.unhexlify(seed_bytes))
    
  • From a private key:

      import binascii
      from py_crypto_hd_wallet import HdWalletSubstrateCoins, HdWalletSubstrateFactory
    
      # Create factory
      hd_wallet_fact = HdWalletSubstrateFactory(HdWalletSubstrateCoins.POLKADOT)
    
      # Create from private key bytes
      priv_key = binascii.unhexlify(b"2ec306fc1c5bc2f0e3a2c7a6ec6014ca4a0823a7d7d42ad5e9d7f376a1c36c0d14a2ddb1ef1df4adba49f3a4d8c0f6205117907265f09a53ccf07a4e8616dfd8")
      hd_wallet = hd_wallet_fact.CreateFromPrivateKey("my_wallet_name", priv_key)
    
  • From a public key:

      import binascii
      from py_crypto_hd_wallet import HdWalletSubstrateCoins, HdWalletSubstrateFactory
    
      # Create factory
      hd_wallet_fact = HdWalletSubstrateFactory(HdWalletSubstrateCoins.POLKADOT)
    
      # Create from public key bytes
      pub_key = binascii.unhexlify(b"66933bd1f37070ef87bd1198af3dacceb095237f803f3d32b173e6b425ed7972")
      hd_wallet = hd_wallet_fact.CreateFromPublicKey("my_wallet_name", pub_key)
    

In case of errors (e.g. construction from an invalid mnemonic, seed or keys) a ValueError exception will be raised.

Generating wallet keys and addresses

After a wallet is created, you can generate keys and addresses by simply calling the Generate method.
For generating a wallet, you can specify a substrate derivation path (if not specified, the default path will be emtpy).\

Example

import binascii
from py_crypto_hd_wallet import HdWalletSubstrateCoins, HdWalletSubstrateFactory

# Create factory
hd_wallet_fact = HdWalletSubstrateFactory(HdWalletSubstrateCoins.ACALA)
# Create random
hd_wallet = hd_wallet_fact.CreateRandom("my_wallet_name")

# Generate with empty path
hd_wallet.Generate()

# Generate with specified path
hd_wallet.Generate(path="//hard/soft")
# After generated, you can check if the wallet is watch-only with the IsWatchOnly method
is_wo = hd_wallet.IsWatchOnly()

If an invalid path is specified, a ValueError exception will be raised.

Getting wallet data

After keys and addresses were generated, you can:

  • Get the whole data as dictionary:

      # Get wallet data as a dictionary
      wallet_data = hd_wallet.ToDict()
    
  • Get the whole data as a string in JSON format:

      # Get wallet data as a string in JSON format
      wallet_data = hd_wallet.ToJson()
    
  • Save data to a file in JSON format using the HdWalletSaver class, to store the generated keys and addresses:

      # Save wallet data to file
      HdWalletSaver(hd_wallet).SaveToFile("my_wallet.txt")
    
  • Get a specific data, see the next paragraph

Getting specific wallet data

For getting specific data, the following methods of HdWalletSubstrate can be used:

  • GetData(HdWalletSubstrateDataTypes) : return the specified data type if existent, None otherwise
  • HasData(HdWalletSubstrateDataTypes) : return if the specified data type is existent

The possible data types HdWalletSubstrateDataTypes are:

  • HdWalletSubstrateDataTypes.WALLET_NAME : wallet name
  • HdWalletSubstrateDataTypes.COIN_NAME : coin name
  • HdWalletSubstrateDataTypes.MNEMONIC : mnemonic
  • HdWalletSubstrateDataTypes.PASSPHRASE : passphrase
  • HdWalletSubstrateDataTypes.SEED_BYTES : seed bytes
  • HdWalletSubstrateDataTypes.PATH : derivation path, if any
  • HdWalletSubstrateDataTypes.KEY : generated keys and address (HdWalletSubstrateKeys object)

In case of keys, a HdWalletSubstrateKeys object is returned. This object has the following methods:

  • ToDict() : return keys as a dictionary
  • ToJson() : return keys as a string in JSON format
  • HasKey(HdWalletSubstrateKeyTypes) : get if the specified key type is existent
  • GetKey(HdWalletSubstrateKeyTypes) : get the specified key if existent, None otherwise

The possible key types HdWalletSubstrateKeyTypes are:

  • HdWalletSubstrateKeyTypes.PRIV : private key
  • HdWalletSubstrateKeyTypes.PUB : public key
  • HdWalletSubstrateKeyTypes.ADDRESS : address correspondet to the public key

Example

from py_crypto_hd_wallet import (
    HdWalletSubstrateCoins, HdWalletSubstrateDataTypes, HdWalletSubstrateKeyTypes, HdWalletSubstrateFactory
)

# Create factory
hd_wallet_fact = HdWalletSubstrateFactory(HdWalletSubstrateCoins.KUSAMA)
# Create random
hd_wallet = hd_wallet_fact.CreateRandom("my_wallet_name")

# Generate with default parameters
hd_wallet.Generate()

# Print wallet
print(hd_wallet.ToDict())
print(hd_wallet.ToJson())

# Get wallet and coin names
wallet_name = hd_wallet.GetData(HdWalletSubstrateDataTypes.WALLET_NAME)
coin_name = hd_wallet.GetData(HdWalletSubstrateDataTypes.COIN_NAME)
# Get path
has_path = hd_wallet.HasData(HdWalletSubstrateDataTypes.PATH)
if has_path:
    path = hd_wallet.GetData(HdWalletSubstrateDataTypes.PATH)

# Get wallet keys
keys = hd_wallet.GetData(HdWalletSubstrateDataTypes.KEY)
# Print keys
print(keys.ToDict())
print(keys.ToJson())
# Get keys individually
priv = keys.GetKey(HdWalletSubstrateKeyTypes.PRIV)
pub = keys.GetKey(HdWalletSubstrateKeyTypes.PUB)
# Get address
address = keys.GetKey(HdWalletSubstrateKeyTypes.ADDRESS)


鲜花

握手

雷人

路过

鸡蛋
该文章已有0人参与评论

请发表评论

全部评论

热门推荐
阅读排行榜

扫描微信二维码

查看手机版网站

随时了解更新最新资讯

139-2527-9053

在线客服(服务时间 9:00~18:00)

在线QQ客服
地址:深圳市南山区西丽大学城创智工业园
电邮:jeky_zhao#qq.com
移动电话:139-2527-9053

Powered by 互联科技 X3.4© 2001-2213 极客世界.|Sitemap