Python interface and Robonomics IO

Some extrinsics implemented in Robonomics pallets are hard to be submitted from the Polkadot app. More that, there is a need to interact with this functionality using programming languages. For this purpose a simple Python tool was developed called robonomics-interface. It’s a wrapper over polkascan-maintained py-substrate-interface. Below is a brief description of this package and some useful links and examples. Also, CLI tools is discussed.

robonomics-interface

Available on PyPi package is ready to download and set up.
There is a detailed docstring-generated documentation available as well.

All in all, this is a tool for developers who wish to interact with Robonomics blockchain via programming tools. Almost
all the Python projects of Robonomics team which interact with the parachain use this interface.

Installation

The installation process requires user to have at least Python 3.8 installed. Neither x86, nor arm7, nor arm8
architectures require compilation process. All the wheels are built and published by dependencies maintainers.

pip is used as an installation tool:

$ pip3 install robonomics_interface

Sample use

The main idea is to create an Account instance and then use it to create pallet-dedicated instances.

from robonomicsinterface import Account, Datalog
account = Account()
datalog_ = Datalog(account)
datalog_.get_item(addr="4G1V6yyvrkd3Z57H1giUky8RTRX3SZieRvuDpQzK4knNRy5R",index=2)

>>> (1657226418528, 'blah')

Local node

It is also possible to use custom endpoints (e.g. local node for testing):

account = Account(remote_ws="ws://127.0.0.1:9944")

Extrinsics are also possible to submit:

from robonomicsinterface import Account, Datalog
account = Account(seed="one two three four five six seven eight nine ten eleven twelve")
datalog_ = Datalog(account)
datalog_.record("Hello, Robonomics!")

>>> 0xb2f742b6164ffc14b75a21188b37287c2416e6617635805e0a77db12773f6068  # this is an extrinsic hash

Docs
As have been said, more examples are available on the documentation page.

CLI tool

robonomics-interface also contains a Python click CLI tools to use for purposes of prototyping and quick tests. It is installed
with the package and available in the Terminal:

$ robomomics_interface --help

#Usage: robonomics_interface [OPTIONS] COMMAND [ARGS]...
#
#Options:
#  --help  Show this message and exit.
#
#Commands:
#  read   Subscribe to datalog/launch events in the chain
#  write  Send various extrinsics (launch commands or record datalogs)

You may try to use it with local node. Pipeline philosophy is adopted:

$ echo "Hello, Robonomics!" | robonomics_interface write datalog -s "//Alice" --remote_ws "ws://127.0.0.1:9944"

#0x22dbac7d25d2ee67c7d985f074163f674c8c9b4c554e545ca4c7186307e9023c  # this is an extrinsic hash

Couldn't complete

Thanks,
we'll keep in touch!

It was hard

Thanks,
we'll keep in touch!

It was ok

Thanks,
we'll keep in touch!

It was easy

Thanks,
we'll keep in touch!
Main contributors: @PaTara43
Make a contribution

Robonomics wiki is open source. See something that's wrong or unclear? Submit a pull request.

Latest commit on 23.09.2024 by Julia
? Ask your question