ORBIT Node - Validation for Op_Return Bitcoin-Implemented Tokens

Join the chat at https://gitter.im/AlphaGriffin/orbit

A node for processing and validating tokens on Bitcoin Cash implementing the ORBIT standard.

The official website for ORBIT is http://orbit.cash.


An ORBIT Node is a program that processes ORBIT-related information found on the Bitcoin Cash blockchain. It works in conjuction with an existing BCH Node (such as the Bitcoin-ABC bitcoind program) to review transactions containing OP_RETURN data and determine if they are valid ORBIT transactions and compute current balances for ORBIT tokens. A small database is utilized to track the verified ORBIT events and maintain balance information. Through a socket RPC interface, the ORBIT Node may be queried to retrieve token balances and history.

ORBIT Node is open source and licensed under the MIT license. See the LICENSE file for more details.

The ORBIT Ecosystem

ORBIT is a specification for simple, fungible tokens implemented by utilizing OP_RETURN for the storage of token events on the Bitcoin Cash blockchain. No changes to the Bitcoin Cash protocol or nodes are required. However, wallets may wish to incorporate this token standard in order to allow the user to easily take account of and interact with tokens that adhere to this ORBIT standard.

The following projects, when used in conjunction with ORBIT Node, complete a full ecosystem for tokens on Bitcoin Cash using ORBIT:


The ORBIT repository at https://github.com/AlphaGriffin/orbit defines the official and complete specification for ORBIT.

The current specification version is: 0 (beta testing). Version 0 is reserved and should be used for all testing.


Your help is appreciated! Alpha Griffin is a small team focused on developing new technology projects. If you have questions or comments or would like to contribute to the ORBIT node or ecosystem in any way, please feel free to contact us. You may submit issues or pull requests directly on GitHub or communicate with the team members at the following locations:

Have a suggestion or request? Let us know!

To-Do List

There are a number of tasks already identified on the To-Do list that could use your help (included here in generated documentation).

To-do list for ORBIT Node:

- finish API documentation
- node to node communication and hash check (consensus)
- handling node upgrades (hashes will be different and consensus will fail)
- test cases
- improved db indexes


This ORBIT Node is written in Python.


In addition to the above, ORBIT Node requires RPC access to a local or remote Bitcoin Cash Node such as the one provided by Bitcoin ABC (https://www.bitcoinabc.org).

Build Overview

Both a Makefile and setup.py are provided and used. The setup.py uses Python’s standard setuptools package and you can call this script directly to do the basic Python tasks such as creating a wheel, etc.

The most common project build tasks are all provided in the Makefile. To see the full list of project targets:

make help

Sphinx is used to generate html documentation and man pages. All documentation (html as well as man pages) may be regenerated at any time with:

make docs

Every so often, when new source class files are created or moved, you will want to regenerate the API documentation templates. These templates may be modified by hand so this task does not overwrite existing files; you’ll need to remove any existing files from api/ that you want recreated. Then generate the API templates and re-build all documentation as follows:

make apidoc
make docs

There’s not much to do for a simple Python project but your build may want to do more. In any case you can call make python if you need to (in orbit this target simply delegates to ./setup.py build).

Build all the common tasks (including documentation) as follows:

make all

To clean up all the common generated files from your project folder:

make clean


To install this project to the local system:

make install

Note that you may need superuser permissions to perform the above step.




All changes are tracked in the CHANGELOG file.

Copyright (C) 2018 Alpha Griffin

saw_081218_1 - Minor updates to documentation and requirements.

saw_081018_1 - Add continuous daemon operation and web API.

saw_080718_1 - Add support for token crowd-sale/faucet advertisements and registrations (TESTING
               REQUIRED). Break transaction processing into smaller batches while communicating
               with the BCH node. Add a hashing algorithm for future node consensus checks.

saw_080118_1 - Now supporting token transfers.

saw_073118_1 - Updated for API version 0.3. Now validates address ownership for token events.

saw_072818_1 - Implement some commands.

saw_072718_2 - Misc. installation and documentation fixes.

saw_072718_1 - The beginnings of an ORBIT node.

“Orbit the moon”