Join 75,960 users and earn money for participation

Basic use of SmartBCH with Python, Web3Py

5 234 boost
Avatar for ClearSky
Written by   38
1 month ago (Last updated: 4 weeks ago)

SmartBCH becoming is becoming more popular with time, It brings the best of Ethereum world to BCH. I wanted to explore it and help others too so I created this short introduction to use smartBCH for Python developers.

First you should install web3 :

pip3 install web3

Let us start a Python interpreter and import Web3:

>>> from web3 import Web3

Then we should use a provider, for a quick start you will depend on an external service that connects us to the network

>>> w3 = Web3(Web3.HTTPProvider(''))

We have used here the smartBCH node from here is a list of provider that we can use:

If you use the one with Websocket instead of http you will have to change the provider method to be Websocket like this:

w3 = Web3(Web3.WebsocketProvider('wss://'))

Testing connection

Let us test connection, we should get True if the node is up and ready:

>>> w3.isConnected()

Lest us start querying for some useful data, Let us query for the latest block :

>>> w3.eth.get_block('latest')
AttributeDict({'difficulty': 0, 'extraData': HexBytes('0x'), 'gasLimit': 1000000000, 'gasUsed': 0, 'hash': HexBytes('0xcfa93b9979df7ea7658940eb319a22a208947f43c4983a83c5d7bc7934d88d5c'), 'logsBloom': HexBytes('0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000'), 'miner': '0x930C23CE7536B0ede6AfE7754134d4011217D6AA', 'mixHash': HexBytes('0x0000000000000000000000000000000000000000000000000000000000000000'), 'nonce': HexBytes('0x0000000000000000'), 'number': 665462, 'parentHash': HexBytes('0xbe439275cbc6588651ea43c4b58c3372c3a5a7ee18b639a9f0390f58d05adceb'), 'receiptsRoot': HexBytes('0x0000000000000000000000000000000000000000000000000000000000000000'), 'sha3Uncles': HexBytes('0x0000000000000000000000000000000000000000000000000000000000000000'), 'size': 557, 'stateRoot': HexBytes('0x38bbd2b0bfb71e273080fee38aaf84edd25bcf04e30a874f781a10252a93a521'), 'timestamp': 1631452685, 'totalDifficulty': 0, 'transactions': [], 'transactionsRoot': HexBytes('0x0000000000000000000000000000000000000000000000000000000000000000'), 'uncles': []})

To just get the number of latest block:

>>> w3.eth.block_number

To get the balance of an account/address:

>>> w3.eth.get_balance('0x54E4F23a819F0DDe10344F5BD06b57906a752934')

Balances are shown in a unit called Wei by default, to convert to BCH use:

>>> balance = w3.eth.get_balance('0x54E4F23a819F0DDe10344F5BD06b57906a752934')
>>> w3.fromWei(balance, 'ether')

To convert from BCH to Wei:

>>> w3.toWei(Decimal('0.000000005'), 'ether')

To get a transaction detail:

>>> w3.eth.get_transaction('0xaac856e36d6ccae43bc07c1e078e4c29efb14efc8f0d795c63632557c1bb1642')
AttributeDict({'blockHash': HexBytes('0x649d3f7eb7fbe805edb6ad7d63aceb60041c4ede1ca5f1e31b4bab6da1ad0442'), 'blockNumber': 631598, 'from': '0x579564809ACDA82232b91f2931a0876f97669df6', 'gas': 208096, 'gasPrice': 1050000000, 'hash': HexBytes('0xaac856e36d6ccae43bc07c1e078e4c29efb14efc8f0d795c63632557c1bb1642'), 'input': '0xe2bbb158000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000f3b4741d5bbf42c20', 'nonce': 32, 'to': '0xDEa721EFe7cBC0fCAb7C8d65c598b21B6373A2b6', 'transactionIndex': 1, 'value': 0, 'v': None, 'r': None, 's': None})

To lookup transaction receipt:

>>> w3.eth.get_transaction_receipt('0xaac856e36d6ccae43bc07c1e078e4c29efb14efc8f0d795c63632557c1bb1642') 


I don't have good understanding of how contracts work on Ethereum but still we can query them and get some useful information.

To start dealing with contracts we need two pieces of information:

  1. Contract address

  2. ABI (Application Binary Interface)

Contract Address

Normally you can find the contract on the explorer and it seems it serve similar purpose to token id for SLP token.

Contract for Maze token

You can look it from here:

Address should be in Checksum format (few letters should be capitals), if you got the address in non-checksum format you can use this to convert it:

>>> w3.toChecksumAddress('0x481de06dca0198844faa36fca04db364e5c2f86c')


@b_s_z in smartBCH community group on Telegram provided me with the ABI for the Maze token, you can get it from this gitlab snippet:

In Etherscan you can see an Ethereum Token API like this one for Tether

Tether ABI in Ethereum

Dealing with contracts

After getting the address and ABI we assign them, I'll not post the full ABI here as it's a bit long. Just copy it from snippet, you may want to minify so it fit in one line.

>>> address = '0x481De06DCA0198844faA36FCa04Db364e5c2f86C'
>>> abi = '[{"constant":true,"inputs":[],"name":"name","outputs":[{"name":"","type":"string"}],"payable":false, OMITTED

Then we create an instance for the contract and check for the address:

>>> contract = w3.eth.contract(address=address, abi=abi)
>>> contract.address

Get token symbol:

>>> contract.functions.symbol().call()

We can ask for total supply:

>>> contract.functions.totalSupply().call()

Number of decimals:

>>> contract.functions.decimals().call()

Get Token balance on account:

>>> bob = '0x481De06DCA0198844faA36FCa04Db364e5c2f86C'
>>> raw_balance = contract.functions.balanceOf(bob).call()
>>> raw_balance

You can find much more examples from example page, All what I've to do is to set the provider to SmartBCH provider. You need also to make sure that unites are correct because apparently it uses Ethereum definition like wei and ether.


In this article I've just explained few very basic uses. Hopefully in the feature I'll have time to explore EVM more. It's attractive and very useful.

$ 80.72
$ 50.05 from Anonymous user(s)
$ 23.02 from @TheRandomRewarder
$ 5.02 from @quest
+ 11
Avatar for ClearSky
Written by   38
1 month ago (Last updated: 4 weeks ago)
Enjoyed this article?  Earn Bitcoin Cash by sharing it! Explain
...and you will also help the author collect more tips.


✊Thanks for the info, I may be new to crypto but I am trying my best to learn

$ 0.00
1 month ago

WOw this is cool. I'm going to wait for games within the smartBCH network.. I think they are going to happen soon.

$ 0.00
1 month ago

That's really cool. Didn't know this. Thanks for sharing!!

$ 0.00
1 month ago

Glad you like it.

$ 0.00
1 month ago

But what a wonderful article we have here! I am a computer engineer, programmer and designer. I program in several languages ​​such as: c, c ++, c # and php. I have used python for some very specific thing.

Definitely using this tutorial I will do something about it and put it to the test. I start fresh in read (I've only been 1 day), and the truth is I really like the content I find here.

Thanks for sharing and congratulations on such a wonderful post.

$ 0.50
1 month ago