{"id":18487672,"url":"https://github.com/omnilaboratory/OmniBOLT-spec","last_synced_at":"2025-04-08T20:31:43.893Z","repository":{"id":39364555,"uuid":"197193255","full_name":"omnilaboratory/OmniBOLT-spec","owner":"omnilaboratory","description":"Facilitate smart assets circulation and exchange in Lightning Network.","archived":false,"fork":false,"pushed_at":"2023-03-14T05:31:39.000Z","size":2988,"stargazers_count":272,"open_issues_count":1,"forks_count":10,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-02T11:56:16.162Z","etag":null,"topics":["bitcoin","blockchain","dex","lightning-network","payment-channel","stablecoin-payment"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/omnilaboratory.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-07-16T12:50:43.000Z","updated_at":"2025-02-11T16:50:16.000Z","dependencies_parsed_at":"2024-11-06T12:55:55.798Z","dependency_job_id":"80ef52c1-ccfd-4a0a-bc24-52ac56a4f364","html_url":"https://github.com/omnilaboratory/OmniBOLT-spec","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omnilaboratory%2FOmniBOLT-spec","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omnilaboratory%2FOmniBOLT-spec/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omnilaboratory%2FOmniBOLT-spec/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omnilaboratory%2FOmniBOLT-spec/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/omnilaboratory","download_url":"https://codeload.github.com/omnilaboratory/OmniBOLT-spec/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247923056,"owners_count":21018919,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bitcoin","blockchain","dex","lightning-network","payment-channel","stablecoin-payment"],"created_at":"2024-11-06T12:50:38.968Z","updated_at":"2025-04-08T20:31:42.406Z","avatar_url":"https://github.com/omnilaboratory.png","language":null,"funding_links":[],"categories":["Others"],"sub_categories":[],"readme":"# OmniBOLT: Facilitates smart assets lightning transactions\n\n[![](https://img.shields.io/badge/license-MIT-brightgreen)](https://github.com/omnilaboratory/OmniBOLT-spec/blob/master/LICENSE) [![](https://img.shields.io/badge/made%20by-Omni%20Foundation-blue)]() [![](https://img.shields.io/badge/project-OmniBOLT%20Daemon-orange)](https://github.com/omnilaboratory/obd)\n\n* `Contact`: Neo Carmack(neocarmack@omnilab.online), Ben Fei(benfei@omnilab.online)\n\nBased 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.\n\nIn addition, OmniBOLT provides more flexible contracts for upper-layer decentralized applications. [OmniBOLT daemon](https://github.com/omnilaboratory/obd) is a golang implementation of this specification, an open source, off-chain decentralized platform, built 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](https://github.com/omnilaboratory/OmniBOLT-spec/blob/master/OmniBOLT-02-peer-protocol.md#omnilayer-assets).\n\n \n## Features  \n \n* Instant payment of smart assets issued on OmniLayer and Etherium(soon future). \n* Cross channel atomic swap for various crypto assets.\n* Decentralized exchange on top of stable coin enabled lightning channels. \n\u003c!--\n* Collateral Lending Contract and more flexible contracts for various DeFi scenarios based on atomic swap, without any extra cost of transaction fee or any intermediary;  \n\t* Interested readers shall directly go to [chapter 6: DEX, Collateral Lending Contract, online store ...](https://github.com/omnilaboratory/OmniBOLT-spec/blob/master/OmniBOLT-06-Mortgage-Loan-Contracts-for-Crypto-Assets.md) to seek more examples.\n --\u003e\n* Automatic market maker and liquidity pool for DEX.\n \n## Why OmniBOLT\n\nThe decentralized finance industry requires a much more flexible, extensible, and cheaper smart assets circulation solution to solve the main chain scalability problem. The Lightning Network is a solid technology for this problem. Besides the layer-2 protocol [BOLT (Basis of Lightning Technology)](https://github.com/lightningnetwork/lightning-rfc/blob/master/00-introduction.md) 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 that need stablecoins.  \n\nMeanwhile, 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.\n\n## How it works:\n\n\u003cp align=\"center\"\u003e\n  \u003cimg width=\"500\" alt=\"OmniBOLT-Protocol-Suite\" src=\"https://github.com/omnilaboratory/OmniBOLT-spec/blob/master/imgs/OmniBOLT-Protocol-Suite.png\"\u003e\n\u003c/p\u003e\n\n1. On-chain protocol is [Omnilayer](https://github.com/OmniLayer/spec/blob/master/OmniSpecification.adoc), which is the token issuance and settlement layer;  \n2. OmniBOLT 2, 3, and 4 form the main network protocols;   \n3. Applications level consists of contracts for various applications; \n\nOmniBOLT does not issue tokens. All tokens are issued on [Omnilayer](https://github.com/OmniLayer/spec/blob/master/OmniSpecification.adoc), and enter the OmniBOLT lightning 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.  \n\nCurrently supported assets are of:  \n1. [Fixed number tokens](https://github.com/OmniLayer/spec/blob/master/OmniSpecification.adoc#731-new-property-creation-with-fixed-number-of-tokens): [divisible or indivisible](https://github.com/OmniLayer/spec/blob/master/OmniSpecification.adoc#field-property-type)\n2. [Variable number tokens](https://github.com/OmniLayer/spec/blob/master/OmniSpecification.adoc#732-new-property-creation-via-crowdsale-with-variable-number-of-tokens): [divisible or indivisible](https://github.com/OmniLayer/spec/blob/master/OmniSpecification.adoc#field-property-type)\n\nAll assets are fungible assets.\n\n\n## Chapters and Protocol Suite\n\nWe 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 :-)\n\n[OmniBOLT #01](https://github.com/omnilaboratory/OmniBOLT-spec/blob/master/OmniBOLT-01-basic-protocol-and-Terminology.md): Base Protocol and Terminology\n\n[OmniBOLT #02:](https://github.com/omnilaboratory/OmniBOLT-spec/blob/master/OmniBOLT-02-peer-protocol.md) peer-protocol, Poon-Dryja channel open\n\n[OmniBOLT #03:](https://github.com/omnilaboratory/OmniBOLT-spec/blob/master/OmniBOLT-03-RSMC-and-OmniLayer-Transactions.md) RSMC and OmniLayer Transactions \n\n[OmniBOLT #04:](https://github.com/omnilaboratory/OmniBOLT-spec/blob/master/OmniBOLT-04-HTLC-and-Payment-Routing.md) HTLC and payment Routing\n\n[OmniBOLT #05:](https://github.com/omnilaboratory/OmniBOLT-spec/blob/master/OmniBOLT-05-Atomic-Swap-among-Channels.md) Atomic Swap Protocol among Channels\n\n\u003c!--\n[OmniBOLT #06:](https://github.com/omnilaboratory/OmniBOLT-spec/blob/master/OmniBOLT-06-Mortgage-Loan-Contracts-for-Crypto-Assets.md) DEX, Collateral Lending Contract, online store and more applications\n--\u003e\n[OmniBOLT #06:](https://github.com/omnilaboratory/OmniBOLT-spec/blob/master/OmniBOLT-06-Automatic-Market-Maker-and-DEX.md) Automatic Market Maker, Liquidity Pool and DEX\n\n[OmniBOLT #07:](https://github.com/omnilaboratory/OmniBOLT-spec/blob/master/OmniBOLT-07-Hierarchical-Deterministic-(HD)-wallet.md)  Hierarchical Deterministic (HD) wallet, Invoice Encoding\n\n\n\n## Technology Guide\n[OmniBOLT Technology Guide Part I](https://github.com/omnilaboratory/OmniBOLT-spec/blob/master/docs/OmniBOLT-Technology-guide-part-I-2020-05-01_en.pdf) offers quick understanding of the rationale, concepts, architecture of OmniBOLT.  \n\n## Implementation and API for client applications\n\nImplementation of OmniBOLT specification can be found in this repository [OmniBOLT Daemon](https://github.com/omnilaboratory/obd).  \n \n## Quick Start\n\nIt is recommended to start with a graphic tool to play with OmniBOLT: [https://github.com/omnilaboratory/obd#quick-start-on-regtest](https://github.com/omnilaboratory/obd#quick-start-on-regtest)\n\n\n## Contribution\n\nOmniBolt specification is incubated by [Omnilayer.foundation](https://github.com/OmniLayer).\nAny proposal, please submit issues in this repo.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fomnilaboratory%2FOmniBOLT-spec","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fomnilaboratory%2FOmniBOLT-spec","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fomnilaboratory%2FOmniBOLT-spec/lists"}