Skip to content

RGB-WG/rgb-std

Folders and files

NameName
Last commit message
Last commit date

Latest commit

c00aa3b · Jan 7, 2025
Oct 13, 2024
Aug 22, 2024
Jun 13, 2024
Oct 13, 2024
Mar 21, 2024
Jan 6, 2025
Oct 13, 2024
Apr 30, 2024
Oct 13, 2024
Feb 20, 2023
Feb 20, 2023
Dec 17, 2024
Dec 17, 2024
Feb 20, 2023
Feb 4, 2024
Feb 20, 2023
Oct 13, 2024
Aug 19, 2024
Dec 30, 2023
Aug 19, 2024
Feb 20, 2023
Jun 17, 2022

RGB wallet & standard libraries for smart contracts on Bitcoin & Lightning

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 wallet standard library provides non-consensus-critical high-level API for RGB applications. It is based on [RGB Core Lib][Core], implementing validation and consensus rules for 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 Node: standalone & embeddable node for running RGB.
  • [MyCitadel Node][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.

Library

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

rgb-std = "0.11.0"

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

MSRV

Minimum supported rust compiler version (MSRV) is shown in rust-version of Cargo.toml.

Contributing

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.

License

See LICENCE file.