All tools for building on
RGB Protocol on Bitcoin.
RGB SDK, libraries in multiple languages, Lightning Node integration, sandbox environment, and core protocol libraries: everything you need to build production-grade applications on RGB Protocol on Bitcoin.
Choose the right layer
for your use case.
The RGB tooling is organized in layers — start at the top for application development, go deeper for protocol-level work.
Application layer — start here
RGB Lib + language bindings
High-level SDK for wallets, exchanges, and apps. Available in Rust, Python, Swift, Kotlin, Node.js.
Lightning layer
RGB Lib + language bindings
Run an RGB-enabled Lightning node. Manage typed asset channels, route RGB payments over LN.
Protocol layer
Core libraries — rgb-consensus, rgb-core, rgb-std
Low-level protocol implementation. For protocol contributors and advanced integrations.
Foundation
Bitcoin — commitment layer
Bitcoin stores only cryptographic commitments. All RGB logic lives above this layer.
RGB Lib — the recommended
starting point.
High-level library that abstracts RGB protocol complexity into clean, practical APIs for wallet and application developers.
RGB Lib
A high-level RGB library that handles all the complexity of client-side validation, UTXO management, schema handling, and state transitions — exposing clean APIs for issuing assets, generating invoices, and transferring. The fastest path from zero to a working RGB integration.
RGB Lib supports both Electrum and Esplora backends for Bitcoin node connection, and works on mainnet, testnet, and regtest. It handles schema management, consignment creation, PSBT integration, and blind invoice generation.
# Add to Cargo.toml
[dependencies]
rgb-lib = “0.3”
# Available language bindings:
RGB Lightning Node — asset channels
over Lightning.
Run a Lightning node with native RGB asset channel support. Built on top of RGB Lib and LDK (Lightning Development Kit).
Lightning · Rust
RGB Lightning Node
Full Lightning node implementation with RGB asset channel support. Opens typed asset channels, manages HTLCs for RGB payments, and routes assets over the Lightning Network. Built on LDK.
Lightning · Rust (archive)
RGB Lightning Sample
Reference implementation and sample code for RGB Lightning channel integration. Useful as a learning resource for understanding how RGB state transitions embed in Lightning commitment transactions.
rgb-lightning-sample↗
★ 47 · archived
Lightning · RUST
RGB Proxy Server
Relay server for RGB consignment transport between wallets. Used in Lightning payment flows to pass state transitions between parties. Trustless by design. Operators cannot tamper with client-side validation
RGB-Tools/rgb-proxy-server ↗
Open source
Test locally before
going to mainnet.
Isolated Docker environments for developing and testing RGB applications without spending real bitcoin.
Testing · Docker · Shell
RGB Sandbox
Docker-based local environment with Bitcoin regtest, Electrum server, and full RGB infrastructure pre-configured. Run the demo scripts to see a complete issue → transfer → receive cycle in minutes.
Testing · Python
RGB Faucet
A testnet faucet for RGB assets — allows developers to receive test RGB tokens on testnet without having to issue them manually. Useful for testing wallet integrations and transfer flows.
RGB-Tools/faucet-rgb↗
Open source
Testing · Rust
RGB Tests
Official integration test suite for RGB Bitcoin Protocol. Covers consensus validation, state transitions, schema compliance, and Lightning channel behavior. Reference for expected protocol behavior.
rgb-protocol/rgb-tests ↗
Official test suite
Reference wallet code
to learn from.
Open-source wallet implementations that show how RGB Lib integrates into production mobile and desktop applications.
Wallet · Kotlin · Android
Iris Wallet Android
Open-source Android wallet for RGB assets — the reference implementation for mobile RGB integration using rgb-lib-kotlin. Developed by Bitfinex. Production-grade code, used in the mainnet Iris Wallet.
Wallet · Python · Desktop
Iris Wallet Desktop
Open-source desktop wallet for RGB assets — the reference implementation for desktop RGB integration. Shows how to use RGB Lib in a Python application with a full GUI and UTXO management.
Wallet · Rust · LDK
Rust Lightning fork
RGB-compatible fork of the Rust Lightning (LDK) library. The foundation for RGB Lightning Node — shows how RGB state transitions integrate at the LDK level for channel management.
RGB-Tools/rust-lightning↗
LDK fork
Protocol-level libraries
for advanced integrations.
Low-level Rust libraries implementing the RGB Bitcoin Protocol specification. For protocol contributors and developers building at the consensus level.
Core · Rust
rgb-consensus
Consensus and validation logic for RGB Bitcoin Protocol. The authoritative implementation of protocol rules — schema validation, state transition verification, and commitment schemes.
Core · Rust
rgb-schemas
Official implementations of all standard RGB schemas — NIA, UDA, CFA, IFA, PFA. The reference implementation for asset issuance. Used by RGB Lib under the hood.
Core · Rust
rgb-ops
Non-consensus-critical APIs for RGB applications. Builds on top of rgb-consensus to provide practical interfaces — bridging core protocol validation with higher-level application development.
Core · Rust
rgb-api
RGB API layer providing structured interfaces for interacting with the RGB protocol. Bridges the gap between core consensus logic and higher-level SDK implementations like RGB Lib.
Core · Rust
rgb-aluvm
AluVM implementation for RGB contract validation. The virtual machine that executes Schema validation scripts client-side during state transition verification.
rgb-protocol/rgb-aluvm ↗
Open source
Core · Rust
rgb-strict-types
Strict type system implementation used by RGB Schemas to precisely define state data types. Every contract state variable is deterministically identified by its semantic ID (semId).
rgb-protocol/rgb-strict-types ↗
Open source
Where to go
from here.
Get started guide
Step-by-step tutorial — from setup to first RGB asset on mainnet.
GitHub — rgb-protocol
Core protocol repositories and documentation.
github.com/rgb-protocol ↗
GitHub — RGB-Tools
SDK, wallets, Lightning Node, and tooling repositories.
github.com/RGB-Tools ↗
RGB Community Hub
Ask questions, share integrations, get help from the community. t.me/rgbtelegram ↗
Ready to start building
on RGB Protocol on Bitcoin?
Follow the step-by-step guide — from setup to your first RGB asset.