Skip to content
Switch branches/tags

OmniBOLT: Facilitates smart assets lightning transactions

Based on the fundamental theory of the Lightning network, the OmniBOLT specification describes how to enable OmniLayer assets to be circulated via lightning channels, and how can smart assets benefit from this novel quick payment theory.

In addition, OmniBOLT provides more flexible contracts for upper-layer decentralized applications. OmniBOLT daemon is a golang implementation of this specification, an open source, off-chain decentralized platform, build upon BTC/OmniLayer network, implements basic HTLC payment, atomic swap of multi-currencies, and more off-chain contracts on the network of smart assets enabled lightning channels.


  • Instant payment of smart assets issued on OmniLayer and Etherium(soon future).
  • Cross channel atomic swap for various crypto assets.
  • Decentralized exchange on top of stable coin enabled lightning channels.
  • Automatic market maker and liquidity pool for DEX.

Why OmniBOLT

Decentralized finance industry requires a much more flexible, extensible, and cheaper smart assets circulation solution to solve the main chain scalability problem. Lightning network is a solid technology for this problem. According to the layer-2 protocol BOLT (Basis of Lightning Technology) specification for off-chain bitcoin transfer, we need a protocol to support a wider range of assets for upper-layer applications: payment, game, finance or scenarios need stable coins.

Meanwhile, Omnilayer is an on-chain smart assets issuance technology, which is proven secure and stable. Constructing lightning channels on top of it automatically acquires the ability to issue assets, tamper resistance, and on-chain settlement. This is where OmniBOLT is built upon.

How it works:


  1. On-chain protocol is Omnilayer, which is the issuance and settlement level;
  2. OmniBOLT 2, 3, and 4 form the main network protocols;
  3. Applications level consists of contracts for various applications;

OmniBOLT itself does not issue tokens. All tokens are issued on Omnilayer, and enter the OmniBOLT network through P2(W)SH backed channels, being locked on the main chain, and can be redeemed on the Omnilayer main chain at any time.

Chapters and Protocol Suite

We not only just list messages and arguments that are used in our implementation, but also complete content that explains why we do so. Most of this spec strictly follows the rules/logic defined in the lightning white paper. The original paper may be hard to read for our programmers, so we draw some diagrams for better understanding. Hope it helps :-)

OmniBOLT #01: Base Protocol and Terminology

OmniBOLT #02: peer-protocol, Poon-Dryja channel open

OmniBOLT #03: RSMC and OmniLayer Transactions

OmniBOLT #04: HTLC and payment Routing

OmniBOLT #05: Atomic Swap Protocol among Channels

OmniBOLT #06: Automatic Market Maker, Liquidity Pool and DEX

OmniBOLT #07: Hierarchical Deterministic (HD) wallet, Invoice Encoding

Technology Guide

OmniBOLT Technology Guide Part I offers quick understanding of the rationale, concepts, architecture of OmniBOLT.

Implementation and API for client applications

Implementation of OmniBOLT specification can be found in this repository OmniBOLT Daemon, as well as the API online documentation can be found here.

Javascript API:. The JS SDK implments a complete set of APIs for HD wallets (required by OmniBOLT #07:) and client applications. It manages pub/priv keys genertion and helps developers automatically fill in the arguments which is hardly to be manually finished.

GUI debugging tool: here.


OmniBolt specification is incubated by Any proposal, please submit issues in this repo.


Facilitate smart assets circulation and exchange in Lightning Network.








No releases published


No packages published