#bitcoin #lightning #rgb #smart-contracts #lnp-bp

bin+lib rgb-core

RGB Core Library: confidential & scalable smart contracts on Bitcoin & Lightning (consensus layer)

56 releases

new 0.11.0-beta.2 Nov 19, 2023
0.10.8 Oct 13, 2023
0.10.7 Jul 25, 2023
0.10.0-rc.1 Mar 28, 2023
0.4.3 Mar 19, 2021

#542 in Magic Beans

Download history 432/week @ 2023-08-05 244/week @ 2023-08-12 172/week @ 2023-08-19 146/week @ 2023-08-26 218/week @ 2023-09-02 288/week @ 2023-09-09 161/week @ 2023-09-16 99/week @ 2023-09-23 233/week @ 2023-09-30 195/week @ 2023-10-07 483/week @ 2023-10-14 336/week @ 2023-10-21 269/week @ 2023-10-28 459/week @ 2023-11-04 480/week @ 2023-11-11 335/week @ 2023-11-18

1,571 downloads per month
Used in 26 crates (11 directly)



RGB Core Library

Build Tests Lints codecov

crates.io Docs unsafe forbidden Apache-2 licensed

RGB is confidential & scalable client-validated smart contracts for Bitcoin & Lightning. To learn more about RGB please check RGB blueprint and RGB FAQ websites.

RGB Core library provides consensus-critical and validation code for RGB. It is a standard implementation, jointly with LNP/BP Standards defining RGB consensus and validation rules.

The consensus-critical code library is shared with the following libraries:

  1. Client-side-validation Foundation Lib. It is non-bitcoin-specific library, covering concepts related to client-side-validation (commitments, single-use-seals abstracted from bitcoin, consensus-critical data encoding protocols).
  2. BP Core Lib. This is client-side-validation applied to bitcoin protocol with deterministic bitcoin commitments (tapret) and TXO-based single-use-seals.
  3. AluVM virtual machine used by RGB for Turing-complete smart contract functionality.
  4. Encoding schema, defining structured data types used in RGB smart contracts.

The development of the project is supported and managed by LNP/BP Standards Association. The design of RGB smart contract system and implementation of this and underlying consensus libraries was done in 2019-2022 by Dr Maxim Orlovsky basing or earlier ideas of client-side-validation and RGB as "assets for bitcoin and LN" by Peter Todd and Giacomo Zucco. Upon the release of RGBv1 the protocol will be immutable and this library will accept only bugfixes; i.e. it will be ossified by requiring consensus ACK for the new changes across the large set of maintainers.

The current list of the projects based on the library include:

  • RGB Standard Lib: library providing high-level RGB smart contract API in rust.
  • RGB Node: standalone & embeddable node for running RGB.
  • MyCitadel Node: wallet node providing RGB smart contract functionality integrated with Lightning network, bitcoin blockchain indexers, decentralized data storage and propagation (Storm) and wallet services. It can run as embedded, desktop, server or cloud-based node.


Minimum supported rust compiler version (MSRV): 1.66, rust 2021 edition.

The library can be integrated into other rust projects via Cargo.toml [dependecies] section:

rgb-core = "0.10"

If the library will be used for wallet applications and work with PSBT files, than use wallet feature, which is non-default:

rgb-core = "0.10"

For serialization purposes library provides serde feature, which is turned off by default.


Currently, library functionality is freezed and as a part of ossification only bugfixes are accepted.

Altcoins and "blockchains" other than Bitcoin blockchain/Bitcoin protocols are not supported and not planned to be supported; pull requests targeting them will be declined.


See LICENCE file.


~267K SLoC