Harmony Blockchain: Getting Familiar with It Using Python

In this article, we are going to get familiar with the Harmony blockchain. and install the dependencies such as Docker to be able to connect to the Harmony blockchain. After installing everything and connecting to the blockchain, using the Python scripts, we will get some data from the shard of the Testnet.

What Is Harmony Blockchain?

Harmony is a powerful blockchain platform designed to ease and facilitate the development of Dapps. The innovation of Harmony in decentralized applications is based on random state sharding. The random state sharding allows creating blocks faster. This blockchain is EVM compatible with staking features as well. The good news for Python developers is that all the smart contracts in Harmony are written in Python. Developing on Harmony looks very familiar for Ethereum developers because it is fully Ethereum compatible.

Installing the Dependencies for Harmony Blockchain

To get started with the harmony blockchain, follow the instructions below:
For Windows and Linux:

For Mac Os and Linux:

Docker

Docker is the most important dependency for Harmony blockchain. However, it's different to install it based on the operating system and we are going through on Linux

Installation Guide on Linux

1. Depedencies

Enter the following commands one by one in the terminal to install the docker dependencies:

2. Add Docker’s official GPG key

Enter the following 2 commands one by one in the terminal:

3. Add the Docker repository to Linux:

To add the docker repository to Linux, enter the 2 following commands separately in the terminal:

4. Install Docker Engine and Docker Compose:

The 2 separate commands should install the Docker engine and Docker Compose for you:

5. Checking the installation:

To check the installation, first install the 2 following commands in the terminal:

And then, check the version of Docker:

Result:

After installation for every use, you need to first sign in to docker and run the following commands in terminal:

Now, let’s git clone the harmony blockchain repository by using the following command in the terminal:

Then, install it using this command in the terminal of the same directory:

Finally, the whole set of the following commands altogether will provide you the connection to the Harmony blockchain:

Once you faced the "=== FINISHED RPC TESTS ===" message and also passed all tests, you can be sure that everything has gone the right way.

Connecting to Harmony Testnet:

Using the below scripts, we will at first to a Testnet of shard0 in the Harmony blockchain and then use a test address to check the balance, balance by shard, latest balance, and the account nonce:

from pyhmy import account

test_net = 'https://api.s0.b.hmny.io'	# this is shard 0
test_address = 'one18t4yj4fuutj83uwqckkvxp9gfa0568uc48ggj7'

balance = account.get_balance(test_address, endpoint=test_net)				
total_balance = account.get_total_balance(test_address, endpoint=test_net)	
balance_by_shard = account.get_balance_on_all_shards(test_address, endpoint=test_net)												
genesis_balance = account.get_balance_by_block(test_address, block_num=0, endpoint=test_net)
latest_balance = account.get_balance_by_block(test_address, block_num='latest', endpoint=test_net)						
account_nonce = account.get_account_nonce(test_address, block_num='latest', endpoint=test_net)									

print(balance)
print(total_balance)
print(balance_by_shard)
print(genesis_balance)
print(latest_balance)
print(account_nonce)

Result:

And by using the following scripts, we can get the data of the number out of transactions that have been sent and received on shard 0 of the Testnet.

from pyhmy import account

test_net = 'https://api.s0.b.hmny.io'	# this is shard 0
test_address = 'one18t4yj4fuutj83uwqckkvxp9gfa0568uc48ggj7'

tx_count = account.get_transactions_count(test_address, tx_type='ALL', endpoint=test_net) 											
sent_tx_count = account.get_transactions_count(test_address, tx_type='SENT', endpoint=test_net)							
received_tx_count = account.get_transactions_count(test_address, tx_type='RECEIVED', end-point=test_net)									
legacy_tx_count = account.get_transaction_count(test_address, block_num='latest', endpoint=test_net)	
# API is legacy
legacy_tx_count_pending = account.get_transaction_count(test_address, block_num='pending', end-point =        
       test_net)
       
print(tx_count)
print(sent_tx_count)
print(received_tx_count)
print(legacy_tx_count)
print(legacy_tx_count_pending)

Result:

Using the code below, we can get the number of staking transactions in total, sent and received on shard 0 of the Harmony Testnet:

from pyhmy import account

test_net = 'https://api.s0.b.hmny.io'	# this is shard 0
test_net_shard_1 = 'https://api.s1.b.hmny.io'
test_address = 'one18t4yj4fuutj83uwqckkvxp9gfa0568uc48ggj7'

stx_count = account.get_staking_transactions_count(test_address, tx_type='ALL', end-point=test_net)
sent_stx_count = account.get_staking_transactions_count(test_address, tx_type='SENT', end-point=test_net)
received_stx_count = account.get_staking_transactions_count(test_address, tx_type='RECEIVED', 
       endpoint=test_net)							

print(stx_count)
print(sent_stx_count)
print(received_stx_count)

Result:

Using the following code, we can get the first 100 transaction hashes of the shard 0:

from pyhmy import account

test_net = 'https://api.s0.b.hmny.io'	# this is shard 0
test_net_shard_1 = 'https://api.s1.b.hmny.io'
test_address = 'one18t4yj4fuutj83uwqckkvxp9gfa0568uc48ggj7'

first_100_tx_hashes = account.get_transaction_history(test_address, page=0, page_size=20, 
       include_full_tx=False, endpoint=test_net)

print(first_100_tx_hashes)

Result:

Wrapping Up

In this tutorial, we have managed to install the dependencies for connecting to the Harmony blockchain. Then, by using docker, we connected to the Harmony blockchain. In addition to that, by using some Python script and harmony library, we got some data from the shard 0 of the Testnet.

Download this Article in PDF format

Care to Know About Metaverse?

In Arashtad, we are providing custom services on 3d developments such as 3d websites, 3d models, metaverses and all 3d applications.

Check Out All Services

Arashtad Services

Drop us a message and tell us about your ideas.

Tell Us What You Need

Blockchain Development