Skip to content
This repository has been archived by the owner on May 24, 2024. It is now read-only.
/ Byteduino Public archive

A very light C/C++ implementation of Obyte (formerly Byteball) for Arduino


Notifications You must be signed in to change notification settings


Folders and files

Last commit message
Last commit date

Latest commit



79 Commits

Repository files navigation

A very light C/C++ implementation of Obyte for Arduino ESP8266 and ESP32


Obyte (formerly Byteball) is a last generation crypto currency using a Directed Acyclic Graph (DAG) instead of a blockchain like Bitcoin and its clones do. Brillantly designed, it offers a lot of features without suffering from complexity which makes it a great platform for IoT devices. This library is made to help hobbyists and professionals to implement Obyte platform into microcontrollers and build cool and original projects.

To get support or discuss about this library, connect to Obyte Discord and join #byteduino channel.

What can I do with this library?

Transaction broadcasting

The device has its own Obyte address and can send payments to other addresses. Beside sending payments, this function allows to post data into the immutable public ledger while proving they existed at time they were posted. These can also be used as inputs for smart-contracts.

Encrypted messenging

Byteball protocol integrates a communication layer that is used for private chat but also in background to exchange data like smart-contract definitions or private assets history. Independently from any interaction with DAG, this layer is available for your own benefits:

  • Deploy state of the art cryptography based on ECDSA signing and AES encryption. You are sure of the identity of your correspondent and protect your communication even from the middle-men.
  • Don't run a server that relays messages, use those from Obyte network. Your devices can always communicate without specific network configuration as long as they are connected to internet.
  • Chat with your device using any GUI Obyte wallet running on macOS, Android, Iphone, Linux or Windows.
  • Write Javascript application on top of an headless wallet and have it interacting with your device.
Transaction cosigning

On such small device, it's not possible to implement all Obyte features. But when needed, it's possible to delegate work to a distant server by charging it to prepare transactions that the device cosigns after having checked only critical points. This way we ensure that the transaction has been authorized by the Byteduino device although the distant server could have been compromized. The hardware-cosigner used as second factor authentification for a GUI wallet is a practical application of that.

Supported hardware

  • ESP8266 Arduino for ESP8266

  • Limitations: due to the low amount of RAM available for program (around 40KB), this device cannot treat very large messages. It cannot handle units containing more than 50 to 100 inputs/outputs and it must use the same hub as all paired devices and cosigners.

  • Recommended board: Wifi WeMos D1 Mini Pro (~$5 retail price), including 16MB flash and USB-to-serial converter.

  • ESP32 Arduino for ESP32

  • Recommended board: any board based on ESP32 WROOM module like ESP-32S NodeMCU or WeMos Lolin D32 ($5 to $10 retail price)

Get started


Search for Byteduino in Arduino library manager and install the last version.

External libraries

Some external libraries are required, you have to add them to your Arduino IDE through the library manager:

  • ArduinoJson by Benoit Blanchon version 5.13.2 (not compatible with version 6!)
  • micro-ecc by Kenneth MacKay version 1.0.0

Other third party code that needed to be tweaked is included in the project under the /libs folder.

Keys generation

For now the Byteduino device doesn't generate the private key used to derive identification and payments addresses for 2 reasons:

  • the hardware random number generator embedded in the chip is poorly document and we are not sure it's cryptographically secure.
  • we need to derive an extended pubkey to be provided to other cosigners, the required code isn't implemented yet.

So we use a good old computer to generate keys and we configure the Byteduino device in its sketch.

Copy-paste into your setup() the 3 functions with keys as parameters.

Minimal sketch
#include <Arduino.h>
#include <ESP8266WiFiMulti.h>
#include <byteduino.h>

#if defined (ESP32)
#include <WiFiMulti.h>
WiFiMulti WiFiMulti;

#if defined (ESP8266)
#include <ESP8266WiFiMulti.h>
ESP8266WiFiMulti WiFiMulti;

void setup() {


  //don't forget to change the keys below, you will get troubles if more than 1 device is connected using the same keys

  while (!Serial)

  //we don't need an access point

  //set your wifi credentials here
  WiFiMulti.addAP("my_wifi_ssid", "my_wifi_password");

  while ( != WL_CONNECTED) {
    Serial.println(F("Not connected to wifi yet"));


void loop() {
  // put your main code here, to run repeatedly:

This code connects your device to wifi network, starts a websocket and authenticates to the hub. By default the device will acknowledge any pairing or wallet creation request (for single address wallet only).

The serial monitor should return this:

Device address: 
Device name: 
Pairing code:
Extended Pub Key:
Funding address:
Wss connected to: /bb

Use the pairing code to pair a GUI wallet with your device. Use the funding address to send Bytes to your device, for reference around 1500 bytes are required to post one datafeed.

To get verbose serial output, add #define DEBUG_PRINT to your byteduino.h.

Functions references

Coming soon

Example sketches

Check example sketches in examples folder.

Example projects
  • Hardware cosigner: hardware cosigner with web interface, compatible with GUI wallet to secure your funds.

Go further

The Obyte platform has rich features like human readable smart-contracts and the potential to solve a lot of issues. To know more about it, it's advised to read the very detailled whitepaper. More features could be implemented in this library: payment in assets, deterministic wallet, smart-contracts... Don't hesitate to contact us if you need a specific feature for your project.