RGB smart contracts

RGB is confidential & scalable client-validated smart contracts for Bitcoin & Lightning. It embraces the concepts of private & mutual ownership, abstraction and separation of concerns and represents "post-blockchain", Turing-complete form of trustless distributed computing which does not require introduction of "tokens". To learn more about RGB please check RGB black paper and RGB Tech websites.

This repository provides client-facing library which can be used by desktop apps and mobile wallets for integrating RGB support. It also provides binary rgb which runs in the command-line and exposes all RGB functionality locally, requiring only Electrum server.

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-2023 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.

Installing

First, you need to install cargo. Minimum supported rust compiler version (MSRV) is shown in rust-version of Cargo.toml.

Next, you need to install developer components, which are OS-specific:

• Linux

  sudo apt update
  sudo apt install -y build-essential cmake pkg-config
  

• MacOS

  brew install cmake pkg-config
  

• Windows: download and install the latest Build Tools for Visual Studio, including the 'Desktop development with C++' workflow and recommended optional features

Finally, install RGB command-line utility shipped with this repo by running

cargo install rgb-wallet

To use the library from other rust code add dependency to the Cargo.toml file:

[dependencies]
rgb-std = "0.11.0-beta.7" # use the latest version
rgb-runtime = "0.11.0-beta.7" # use the latest version

Using the demo script

Run examples/demo.sh.

Using command-line

1. Initialize the data directory by running rgb init command.
2. Import contract issuers by some developer. For instance, you may take those from the repository of Pandora Prime or download from rgbex.io. Once downloaded, run rgb import <ISSUERS> command, replacing <ISSUERS> with a path to the downloaded files (you can use wildmarks, like *.issuers).
3. Check that the import has completed successfully by running rgb contracts --issuers and checking that all imported issuers are present.

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.