btmhdw

btmhdw

The implementation of Hierarchical Deterministic (HD) wallets generator for Bytom blockchain.

Installation

Install btmhdw

pip install btmhdw

Development

Clone the repository and then run

pip install -e . -r requirements.txt

Running the test

You can run the tests with:

pip install -r test-requirements.txt

pytest tests

Or use tox to run the complete suite against the full set of build targets, or pytest to run specific tests against a specific version of Python.

Usage

Create a new Bytom wallet

from btmhdw import BTMHDW

# init BTMHDW
btmhdw = BTMHDW()

# Generate mnemonic english/japanese
mnemonic = btmhdw.generate_mnemonic("english")

# Checking mnemonic language
if not btmhdw.check_mnemonic(mnemonic, "english"):
    exit()

# Create a new wallet
wallet = btmhdw.create(mnemonic=mnemonic, network="mainnet")

print(wallet)

OUTPUT

{
  'mnemonic': 'gauge base climb fit output toast brave crush vacant predict hire remind',
  'address': 'bm1qn6g0tky8lx44j2ccz8cu88ngn4snfqr74d9ndw',
  'seed': 'b699dee73ef9be58fbf3490dab6e49071f96df97c5d2614a465b1fd3b76373f56edbac4e24b137f6226402e59902f0eaa882603f94b83618384500db1e30585b',
  'xprivate': '8007196f3e0841bbdf90d97df172a19cb18edda007466d362fa2d5ff23822a40189b8b295cc023e0b2c78f79725f859ac512afdfebc0b94cfd83faa59e42d82e',
  'xpublic': 'd47ece6097f93b5d19259886d210dab017f5b37520b4dad8160712fd5b1065e7189b8b295cc023e0b2c78f79725f859ac512afdfebc0b94cfd83faa59e42d82e',
  'program': '001468029bfd7635cec9100ed21ab6aee3a41986db71',
  'path': 'm/44/153/1/0/1',
}

Get wallet from XPrivate key

from btmhdw import BTMHDW

XPRIVATE = "8007196f3e0841bbdf90d97df172a19cb18edda007466d362fa2d5ff23822a40189b8b295cc023e0b2c78f79725f859ac512afdfebc0b94cfd83faa59e42d82e"

# init BTMHDW
btmhdw = BTMHDW()

# Wallet from xprivate
wallet = btmhdw.from_xprivate(xprivate=XPRIVATE, network="mainnet")

print(wallet)

OUTPUT

{
  'address': 'bm1qn6g0tky8lx44j2ccz8cu88ngn4snfqr74d9ndw',
  'xprivate': '8007196f3e0841bbdf90d97df172a19cb18edda007466d362fa2d5ff23822a40189b8b295cc023e0b2c78f79725f859ac512afdfebc0b94cfd83faa59e42d82e',
  'xpublic': 'd47ece6097f93b5d19259886d210dab017f5b37520b4dad8160712fd5b1065e7189b8b295cc023e0b2c78f79725f859ac512afdfebc0b94cfd83faa59e42d82e', 
  'program': '001468029bfd7635cec9100ed21ab6aee3a41986db71',
  'path': 'm/44/153/1/0/1'
}

Example

Here are more btmhdw/example

Meta

Meheret Tesfaye – @meherett – [e-mail]

Distributed under the MIT license. See LICENSE for more information.

https://github.com/meherett/btmhdw

License

This project is licensed under the MIT License - see the LICENSE file for details

API

Class BTMHDW()

generate_mnemonic(): It is to generate new mnemonic.

Parameters

Optional:

• String - strength, 128.
• String - passphrase, password of the key.
• String - language, mnemonic language of the key.

Returns

Object:

• String - mnemonic, generated mnemonic 12 words.

Example

print(btmhdw.generate_mnemonic(language="english", passphrase="meherett"))
print(btmhdw.generate_mnemonic(language="japanese", passphrase="meherett"))

Output

"spare uniform possible grief attitude machine peace update tornado area evolve spread"
"あけがた　ひてい　ぎじかがく　くうき　どうぐ　だじゃれ　おおう　りねん　こんだて　てわたし　はぶらし　ちいき"

---

check_mnemonic(): It is to check mnemonic language.

Parameters

Object:

• String - mnemonic, mnemonic 12 words.

Optional:

• String - language, english/japanese by default english.

Returns

Object:

• Boolean - boolean, True/False.

Example

MNEMONIC = "ancient young hurt bone shuffle deposit congress normal crack six boost despair"

print(btmhdw.check_mnemonic(MNEMONIC, "english"))
print(btmhdw.check_mnemonic(MNEMONIC, "japanese"))

Output

True
False

---

generate_entropy(): It is to generate new entropy.

Returns

Object:

• String - entropy, generated entropy 32 length.

Example

print(btmhdw.generate_entropy())

Output

"fbb9d20ec1fb94762b56dbc9cd184e23"

create(): It is to create new Bytom wallet.

Parameters

Optional:

• String - mnemonic, from mnemonic 12 words.
• String - passphrase, password of the key.
• String - account, account path index by default 1.
• String - change, change path index 0 or 1 by default 0.
• String - address, address path index by default 1.
• String - path, string of index.
• Array - indexes, array of index.
• String - network, mainnet(bm)/testnet(tm)/solonet(sm) by default sm.

Returns

Object:

• Object - object, keys are entropy, mnemonic, address, seed, xprivate, xpublic, program and path

Example

mnemonic = btmhdw.generate_mnemonic("english")

createdWallet = btmhdw.create(mnemonic=mnemonic, 
                                    network="mainnet")
print(createdWallet['address'])
print(createdWallet['xprivate'], '\n')
print(createdWallet)

Output

"bm1qsv6u5z2uxtefnehkyuetyx4llu27umqscu8vtk"
"983fc70dc7c4a26ff9af39af4c0cc3057565b8f70a31158a6f37e1804ae6414ea6cade89861c53fafa461e5f0e116f47a816b11ba05585b79c577531c6000ffe" 

{
  'mnemonic': 'alarm fix day evoke void hawk pistol pulp impact farm average mask',
  'address': 'bm1qsv6u5z2uxtefnehkyuetyx4llu27umqscu8vtk',
  'seed': '6e269a33fb2c65b9a1966bc9579628869630d7d647792eaa3692fdae1db1a719ff4dfef17acf6027fb20ba7ce04e4715460ea2d280f69f646df1f2a6ef6ffea1',
  'xprivate': '983fc70dc7c4a26ff9af39af4c0cc3057565b8f70a31158a6f37e1804ae6414ea6cade89861c53fafa461e5f0e116f47a816b11ba05585b79c577531c6000ffe',
  'xpublic': '4a7bfcbccbe97aa3f92795c761697f98b6b2350597ab73c85109b025301db1aaa6cade89861c53fafa461e5f0e116f47a816b11ba05585b79c577531c6000ffe',
  'program': '0014312b5e9ee3625a50847ffd5244dbc0d8f01b8566',
  'path': 'm/44/153/1/0/1',
}

---

from_xprivate(): It is to get wallet from xprivate key.

Parameters

Object:

• String - xprivate, xprivate key.

Optional:

• String - account, account path index by default 1.
• String - change, change path index 0 or 1 by default 0.
• String - address, address path index by default 1.
• String - path, string of index.
• Array - indexes, array of index.
• String - network, mainnet(bm)/testnet(tm)/solonet(sm) by default sm.

Returns

Object:

• Object - object, keys are address, xprivate, xpublic, program and path

Example

XPRIVATE = "c003f4bcccf9ad6f05ad2c84fa5ff98430eb8e73de5de232bc29334c7d074759d513bc370335cac51d77f0be5dfe84de024cfee562530b4d873b5f5e2ff4f57c"

wallet_from_xprivate = btmhdw.from_xprivate(xprivate=XPRIVATE, network="mainnet")

print(wallet_from_xprivate['address'])
print(wallet_from_xprivate['xprivate'], '\n')
print(wallet_from_xprivate)

Output

"bm1qtzg058tt5eyf2qqfy2650erxqxhfkt4p236708"
"c003f4bcccf9ad6f05ad2c84fa5ff98430eb8e73de5de232bc29334c7d074759d513bc370335cac51d77f0be5dfe84de024cfee562530b4d873b5f5e2ff4f57c" 

{
  'address': 'bm1qtzg058tt5eyf2qqfy2650erxqxhfkt4p236708', 
  'xprivate': 'c003f4bcccf9ad6f05ad2c84fa5ff98430eb8e73de5de232bc29334c7d074759d513bc370335cac51d77f0be5dfe84de024cfee562530b4d873b5f5e2ff4f57c',
  'xpublic': '1b0541a7664cee929edb54d9ef21996b90546918a920a77e1cd6015d97c56563d513bc370335cac51d77f0be5dfe84de024cfee562530b4d873b5f5e2ff4f57c',
  'program': '0014dcf6b21d83c978d3125d1330c928c38fee315200',
  'path': 'm/44/153/1/0/1',
}

---

Class BytomHDWallet()

master_key_from_mnemonic(): It is to get master key from mnemonic.

Parameters

Object:

• String - mnemonic, mnemonic 12 words.

Optional:

• String - passphrase, password of the key.

Returns

Object:

• Object - BytomHDWallet, class.

Example

MNEMONIC = "ancient young hurt bone shuffle deposit congress normal crack six boost despair"

bytomHDWallet = BytomHDWallet.master_key_from_mnemonic(mnemonic=MNEMONIC, 
                                                       passphrase="Meheret Tesfaye")

---

master_key_from_xprivate(): It is to get master key from XPrivate.

Parameters

Object:

• String - xprivate, xprivate key.

Returns

Object:

• Object - BytomHDWallet, class.

Example

XPRIVATE = "c003f4bcccf9ad6f05ad2c84fa5ff98430eb8e73de5de232bc29334c7d074759d513bc370335cac51d77f0be5dfe84de024cfee562530b4d873b5f5e2ff4f57c"

bytomHDWallet = BytomHDWallet.master_key_from_xprivate(xprivate=XPRIVATE)

---

generate_entropy(): It is to generate new entropy.

Returns

Object:

• String - entropy, generated entropy.

Example

print(bytomHDWallet.generate_entropy().hex())

Output

"7184af4506fb1b51c52d2e73251cc3a7"

---

master_key_from_entropy(): It is to get master key from mnemonic.

Parameters

Optional:

• String - entropy, from entropy.
• String - strength, 128.
• String - passphrase, password of the key.
• String - language, mnemonic language of the key.

Returns

Object:

• Object - BytomHDWallet, class.
• String - mnemonic, generated mnemonic 12 words.

Example

entropy = bytomHDWallet.generate_entropy()

bytomHDWallet, mnemonic = bytomHDWallet.master_key_from_entropy(entropy=entropy,
                                                                passphrase="meherett",
                                                                language="japanese")
print(mnemonic)
print(bytomHDWallet)

Output

"たいむ　おまいり　たんめい　きちょう　ろんぶん　いなか　しなぎれ　ほえる　いもうと　ひしょ　じゆう　にんむ"
<btmhdw.BytomHDWallet object at 0x7f3374618cf8>

---

xprivate_key(): It is to get XPrivate key.

Returns

Object:

• String - xprivate, xprivate from master key.

Example

MNEMONIC = "ancient young hurt bone shuffle deposit congress normal crack six boost despair"

bytomHDWallet = BytomHDWallet()
bytomHDWallet = bytomHDWallet.master_key_from_mnemonic(mnemonic=MNEMONIC)
bytomHDWallet.from_path("m/44/153/1/0/1")

print(bytomHDWallet.xprivate_key())

Output

"302a25c7c0a68a83fa043f594a2db8b44bc871fced553a8a33144b31bc7fb84887c9e75915bb6ba3fd0b9f94a60b7a5897ab9db6a48f888c2559132dba9152b0"

---

xpublic_key(): It is to get XPublic key.

Parameters

Optional:

• String - xprivate, from xprivate key.

Returns

Object:

• String - xpublic, xpublic from xprivate/master key.

Example

XPRIVATE = "c003f4bcccf9ad6f05ad2c84fa5ff98430eb8e73de5de232bc29334c7d074759d513bc370335cac51d77f0be5dfe84de024cfee562530b4d873b5f5e2ff4f57c"

print(bytomHDWallet.xpublic_key(xprivate=XPRIVATE))

Output

"302a25c7c0a68a83fa043f594a2db8b44bc871fced553a8a33144b31bc7fb84887c9e75915bb6ba3fd0b9f94a60b7a5897ab9db6a48f888c2559132dba9152b0"

---

expand_xprivate_key(): It is to get Expand XPrivate key.

Parameters

Optional:

• String - xprivate, from xprivate key.

Returns

Object:

• String - expandPrivate, expand private key from xprivate/master key.

Example

XPRIVATE = "c003f4bcccf9ad6f05ad2c84fa5ff98430eb8e73de5de232bc29334c7d074759d513bc370335cac51d77f0be5dfe84de024cfee562530b4d873b5f5e2ff4f57c"

print(bytomHDWallet.expand_xprivate_key(xprivate=XPRIVATE))

Output

"c003f4bcccf9ad6f05ad2c84fa5ff98430eb8e73de5de232bc29334c7d074759b47fcbbf006db960004839862e694fb3647fdc081ae109bbfe3b07de83e39807"

---

public_key(): It is to get public key(length 64).

Parameters

Optional:

• String - xpublic, from xpublic key.

Returns

Object:

• String - public, public key(length 64) from xpublic/master key.

Example

XPUBLIC = "3c6664244d2d57168d173c4691dbf8741a67d972b2d3e1b0067eb825e2005d20c5eebd1c26ccad4de5142d7c339bf62cc1fb79a8b3e42a708cd521368dbc9286"

print(bytomHDWallet.public_key(xpublic=XPUBLIC))

Output

"3c6664244d2d57168d173c4691dbf8741a67d972b2d3e1b0067eb825e2005d20"

---

from_indexes(): It is to set collection of index.

Parameters

Object:

• Array - indexes, array of index.

Returns

Object:

• Object - BytomHDWallet, class.

Example

INDEXES = ['2c000000', '99000000', '01000000', '01000000', '99000000']

bytomHDWallet = bytomHDWallet.from_indexes(indexes=INDEXES)

---

from_index(): It is to set index.

Parameters

Object:

• Number - index, number.

Returns

Object:

• Object - BytomHDWallet, class.

Example

bytomHDWallet = BytomHDWallet()

bytomHDWallet.from_index(44)
bytomHDWallet.from_index(153)
bytomHDWallet.from_index(1)  # account
bytomHDWallet.from_index(0)  # change 0 or 1
bytomHDWallet.from_index(1)  # address

# Advanced BTMHDW_HARDEN

bytomHDWallet.from_index(44)
bytomHDWallet.from_index(153 + BTMHDW_HARDEN)
bytomHDWallet.from_index(1 + BTMHDW_HARDEN)
bytomHDWallet.from_index(0)
bytomHDWallet.from_index(1)

---

from_path(): It is to set index from path.

Parameters

Object:

• String - path, string of index.

Returns

Object:

• Object - BytomHDWallet, class.

Example

bytomHDWallet = BytomHDWallet()

bytomHDWallet.from_path("m/44/153/1/0/1")

# Advanced BTMHDW_HARDEN using "'"

bytomHDWallet.from_path("m/44/153'/1'/0/1")

---

get_indexes(): It is to get collection of index.

Returns

Object:

• Array - indexes, collection of index.

Example

print(bytomHDWallet.get_indexes())

Output

['2c000000', '99000000', '01000000', '01000000', '99000000']

---

get_path(): It is to get path of indexes.

Parameters

Optional:

• String - indexes, from array of index.

Returns

Object:

• String - path, string of index from indexes/master key.

Example

from btmhdw import INDEXES

print(bytomHDWallet.get_path(indexes=INDEXES))

Output

"m/44/153/1/0/1"

---

child_xprivate_key(): It is to get child of XPrivate key.

Parameters

Optional:

• String - xprivate, from xprivate key.
• String - indexes, collection of index.
• String - path, path of index.

Returns

Object:

• String - childXPrivate, child xprivate key from xprivate/indexes/master key.

Example

from btmhdw import INDEXES

XPRIVATE = "c003f4bcccf9ad6f05ad2c84fa5ff98430eb8e73de5de232bc29334c7d074759d513bc370335cac51d77f0be5dfe84de024cfee562530b4d873b5f5e2ff4f57c"

child_xprivate_key = bytomHDWallet.child_xprivate_key(xprivate=XPRIVATE,
                                                      indexes=INDEXES)
print(child_xprivate_key)

Output

"d01acc504811886d732ea6ea19c066b0f1fb4d0b2a0b97414d1d3916c70c47596aca269da2343d4d7588ffa3c8b9244a156748276114e5f2b86fa69ec241b62a"

---

sing(): Singing message.

Parameters

Object:

• String - message, message to sing.

Optional:

• String - xprivate, xprivate key.

Returns

Object:

• String - signature, signed message.

Example

MESSAGE = "27c42b40a7a35a6d489fb2e41bde15bdb4b4c276045bd0628525b88c2abbc4c0"

signature = bytomHDWallet.sign(message=MESSAGE)

print(signature)

Output

"75ca5b6cf7ba40c7a51f20e1fd03686666e09cf58d0d2978ab6072d8057cbbd3072eabbdefe96eefcbb0c8ec654239b82fa5efcbe24e8704c7d06efd79c40d0a"

---

verify(): Verifying signed message.

Parameters

Object:

• String - message, message to sing.
• String - signature, signed message.

Optional:

• String - xpublic, xpublic key.

Returns

Object:

• Boolean - bool, true or false.

Example

MESSAGE = "27c42b40a7a35a6d489fb2e41bde15bdb4b4c276045bd0628525b88c2abbc4c0"

verify_signature = bytomHDWallet.verify(message=MESSAGE, signature=signature)

print(verify_signature)

Output

True

---

child_xpublic_key(): It is to get child of XPublic key.

Parameters

Optional:

• String - xpublic, from xpublic key.
• String - indexes, collection of index.
• String - path, path of index.

Returns

Object:

• String - child_xpublic_key, child xpublic key from xpublic/indexes/master key.

Example

from btmhdw import INDEXES

XPUBLIC = "3c6664244d2d57168d173c4691dbf8741a67d972b2d3e1b0067eb825e2005d20c5eebd1c26ccad4de5142d7c339bf62cc1fb79a8b3e42a708cd521368dbc9286"

child_xpublic_key = bytomHDWallet.child_xpublic_key(xpublic=XPUBLIC,
                                                    indexes=INDEXES)
print(child_xpublic_key)

Output

"e87ca3acdebdcad9a1d0f2caecf8ce0dbfc73d060807a210c6f2254883479614bcde9cf9e8ee322097d639b33b398c2e419de4092409bf43b3632ddefc4beae9"

---

program(): It is to get control program.

Parameters

Optional:

• String - xpublic, from xpublic key.
• String - path, path of index.
• String - indexes, collection of index.

Returns

Object:

• String - program, control program from xpublic/master key.

Example

from btmhdw import INDEXES, PATH

# Getting contract Program from xpublic and path or indexes
print(BytomHDWallet().program(xpublic=XPUBLIC, path="m/44/153/2/0/8"))
print(BytomHDWallet().program(xpublic=XPUBLIC, path=PATH))
print(BytomHDWallet().program(xpublic=XPUBLIC, indexes=INDEXES))
print(BytomHDWallet().program(xpublic=XPUBLIC, indexes=['2c000000', '99000000', '01000000', '01000000', '01000000']))
print(BytomHDWallet().program(public=PUBLIC))

Output

"00140afb404c13a122306ee86f5ff9b177334d8e23b7"
"0014052620b86a6d5e07311d5019dffa3864ccc8a6bd"
"00140afb404c13a122306ee86f5ff9b177334d8e23b7"
"0014052620b86a6d5e07311d5019dffa3864ccc8a6bd"
"001478c3aa31753389fcde04d33d0779bdc2840f0ad4"

---

address(): It is to get address.

Parameters

Optional:

• String - program, from control program.
• String - network, mainnet(bm)/testnet(tm)/solonet(sm) by default sm.

Returns

Object:

• String - address, address from control program/master key.

Example

XPUBLIC = "3c6664244d2d57168d173c4691dbf8741a67d972b2d3e1b0067eb825e2005d20c5eebd1c26ccad4de5142d7c339bf62cc1fb79a8b3e42a708cd521368dbc9286"

program = BytomHDWallet().program(xpublic=XPUBLIC, path="m/44/153/2/0/8")
print(bytomHDWallet.address(program=program,
                            network='mainnet'))  # or network bm
print(bytomHDWallet.address(program=program,
                            network='testnet'))  # or network tm
print(bytomHDWallet.address(program=program,
                            network='solonet'))  # or network sm

Output

"bm1qpta5qnqn5y3rqmhgda0lnvthxdxcugahcpaum5"
"tm1qpta5qnqn5y3rqmhgda0lnvthxdxcugahuhucm9"
"sm1qpta5qnqn5y3rqmhgda0lnvthxdxcugahesham6"

---

Extra Functions

sing(): Singing message.

Parameters

Object:

• String - message, message to sing.
• String - xprivate, xprivate key.

Returns

Object:

• String - signature, signed message.

Example

from btmhdw import sign

MESSAGE = "27c42b40a7a35a6d489fb2e41bde15bdb4b4c276045bd0628525b88c2abbc4c0"
XPRIVATE = "302a25c7c0a68a83fa043f594a2db8b44bc871fced553a8a33144b31bc7fb84887c9e75915bb6ba3fd0b9f94a60b7a5897ab9db6a48f888c2559132dba9152b0"

signature = sign(message=MESSAGE, xprivate=XPRIVATE)

print(signature)

Output

"a39045f6c8b87b3adce39057e448b37c2300bb3dfce0d8b6034a28bbcccfa4353fc23cb158a310990205fed302bbdfa64255b49f7b1eb2fb502756f164922309"

---

verify(): Verifying signed message.

Parameters

Object:

• String - message, message to sing.
• String - signature, signed message.
• String - xpublic, xpublic key.

Returns

Object:

• Boolean - bool, true or false.

Example

from btmhdw import verify

MESSAGE = "27c42b40a7a35a6d489fb2e41bde15bdb4b4c276045bd0628525b88c2abbc4c0"
SIGNATURE = "a39045f6c8b87b3adce39057e448b37c2300bb3dfce0d8b6034a28bbcccfa4353fc23cb158a310990205fed302bbdfa64255b49f7b1eb2fb502756f164922309"
XPUBLIC = "9407d490e9dbc7762c924122368e6c5743d5829ff2a1e2eb4b219a08e080499687c9e75915bb6ba3fd0b9f94a60b7a5897ab9db6a48f888c2559132dba9152b0"

verify_signature = verify(message=MESSAGE, signature=SIGNATURE, xpublic=XPUBLIC)

print(verify_signature)

Output

True