PyBand

BandChain Python Library

Pyband is a library that is used to interact with BandChain through the gRPC protocol. Querying data and sending transaction can be done here!

⭐️ Features

This helper library allows users to interact with BandChain.

PyBand supports the following features:

• Getting the information of a specific oracle script, data source, and request ID.
• Getting the account information of specific address.
• Getting the latest request for a specific oracle script with its matching calldata and validator ask_count and min_count.
• Querying all the reporters associated with a specific validator.
• Seeing what client_id you are using and getting BandChain's latest block data.
• Able to send transaction in 3 modes: block mode, async mode, and sync mode.

📦 Installation

This library is available on PyPI

pip install pyband

💎 Example Usage

The example below shows how this library can be used to get the result of the latest request for the price of any cryptocurrency. In this example, we will get the latest price of BTC on BandChain's testnet.

The specified parameters are:

• oracleScriptID: 111
• calldata: The hex string representing the OBI-encoded value of {'symbols': ['BTC'], 'multiplier': 100000000}
• minCount: 10
• askCount: 16

importasynciofrompybandimportClient, PyObiasyncdefmain():
grpc_url="laozi-testnet6.bandchain.org"c=Client.from_endpoint(grpc_url, 443)
oid=111calldata="00000001000000034254430000000005f5e100"min_count=10ask_count=16req_info=awaitc.get_latest_request(oid, calldata, min_count, ask_count)
oracle_script=awaitc.get_oracle_script(oid)
obi=PyObi(oracle_script.schema)
# Converts the calldata into a readable syntaxprint(obi.decode_input(bytes.fromhex(calldata)))
# Prints the resultprint(obi.decode_output(req_info.request.result.result))
if__name__=="__main__":
asyncio.run(main())

Below is the results of the example above.

{'symbols': ['BTC'], 'multiplier': 100000000}
{'rates': [1936488410000]}

This example shows how to send a transaction on BandChain using block mode.

importasyncioimportosfrompybandimportClient, Transaction, Walletfrompyband.messages.cosmos.bank.v1beta1importMsgSendfrompyband.proto.cosmos.base.v1beta1importCoinasyncdefmain():
# Create a GRPC connectiongrpc_url="laozi-testnet6.bandchain.org"c=Client.from_endpoint(grpc_url, 443)
# Convert a mnemonic to a walletwallet=Wallet.from_mnemonic(os.getenv("MNEMONIC"))
sender=wallet.get_address().to_acc_bech32()
# Prepare a transaction's propertiesmsg_send=MsgSend(
from_address=sender,
to_address="band19ajhdg6maw0ja0a7qd9sq7nm4ym9f4wjg8r96w",
amount=[Coin(amount="1000000", denom="uband")],
)
account=awaitc.get_account(sender)
account_num=account.account_numbersequence=account.sequencefee= [Coin(amount="50000", denom="uband")]
chain_id=awaitc.get_chain_id()
# Step 4 Construct a transactiontxn= (
Transaction()
.with_messages(msg_send)
.with_sequence(sequence)
.with_account_num(account_num)
.with_chain_id(chain_id)
.with_gas(2000000)
.with_fee(fee)
.with_memo("")
)
# Sign and broadcast a transactiontx_block=awaitc.send_tx_sync_mode(wallet.sign_and_build(txn))
# Converting to JSON for readabilityprint(tx_block.to_json(indent=4))
if__name__=="__main__":
asyncio.run(main())

🧀 Notes

For more examples, please go to examples.