Embedded Blockchain Clients

Overview

The blockchain client SDK is targeted to embedded devices and allows you to easily interact with the IoTeX blockchain in order to fetch blockchain data, send transactions or perform contract execution actions.

How does it work

The communication with the blockchain is done over HTTP, using the HTTP to JSON-RPC bridge at gateway.iotexlab.io.

Supported devices

• Unix machines with curl support

• ESP32 based boards using Arduino framework

• ESP8266 based boards using Arduino framework

• Nano33 IoT using Arduino framework

• Arduino MKR WiFi 1010 using Arduino framework (not tested)

Porting to a new platform

Effort has been taken in trying to decouple non-platform dependant code as much as possible. However, a specific implementation of the following modules is needed when porting the library to a non supported device:

• Http: the HTTP interface needs implemented. See src/http/platform_name/http.cpp for implemented platforms.

• Storage: The storage class needs implemented. It contains only two methods: savePrivateKey() saves the private key, and readPrivateKey() reads the private key. See src/storage/platform_name/storage.cpp for implemented platforms.

• Random: The random class needs implemented for true random number generation. It contains a single method fillRandom(), that fills a buffer with random bytes. See src/random/platform_name/random.cpp for implemented platforms.

Library architecture

Below are the main modules comprising the SDK:

ABI

Classes and functions to encode data using the Ethereum abi specification.

Account

Classes and functions to create a wallet from a private key, obtain the address and send actions to the blockchain.

API

Classes and functions that wrap the HTTP endpoint calls to interact with the blockchain.

Connection

Classes and methods that represent a connection to the blockchain.

Contract

Classes and methods to interact with contracts.

Encoder

Classes and methods to perform different types of encoding (eg. bech32, protobuf, base64).

HTTP

Classes and methods to perform HTTP requests.

Protobuf

Classes and methods to handle protobuf message serialization and deserialization.

Random

Random generator implementations for each platform.

Signer

Classes and functions to sign messages.

Storage

Classes and functions to store and read the private key from persistent storage.