Home /
Learn /
Glossary
Learn /
Glossary

RGB Protocol on Bitcoin —

glossary.

This RGB Protocol on Bitcoin glossary covers the core concepts behind the protocol — from foundational cryptographic concepts to protocol-specific terminology. All definitions based on docs.rgb.info.

◎ All definitions sourced from docs.rgb.info/annexes/glossary ↗

No terms found for your search.
A
AluVM
Algorithmic Logic Unit VM Core

A register-based virtual machine used for smart contract validation and distributed computing in RGB Bitcoin Protocol. AluVM executes the state validation scripts embedded in RGB Schemas, verifying that state transitions comply with the contract’s business logic. Unlike Ethereum’s EVM, AluVM operates entirely client-side — never on-chain.

docs.rgb.info ↗
Anchor Core

The set of client-side data that proves the inclusion of a unique commitment inside a Bitcoin transaction. In RGB, an Anchor contains: the Bitcoin transaction ID of the witness transaction, the Multi Protocol Commitment (MPC), the Deterministic Bitcoin Commitment (DBC), and — for Tapret scheme — the Extra Transaction Proof (ETP). The Anchor is what links off-chain RGB contract data to on-chain Bitcoin transactions.

Assignment Contract

The RGB equivalent of a Bitcoin transaction output. An Assignment modifies, updates, or creates properties of a contract’s state. It is formed by a Seal Definition (which binds the assignment to a Bitcoin UTXO) and an Owned State (which contains the digital property being assigned). Every state transition creates new Assignments for the recipients.

Learn more about state transitions →
B
Business logic Contract

The set of operations and rules contained in a contract Schema that governs how the contract state can be validly updated. Business logic in RGB is expressed declaratively in the Schema and executed by AluVM during client-side validation — never on-chain. This is fundamentally different from Ethereum, where business logic is stored and executed as bytecode on the blockchain.

C
Client-side validation
CSV Core

The cryptographic model at the foundation of RGB Bitcoin Protocol. Instead of every network node validating every transaction, each participant validates only their own relevant slice of contract history — the chain of state transitions from genesis to their current asset ownership. This data is exchanged privately between parties as a consignment. A compact cryptographic commitment is anchored to Bitcoin to prevent double-spending.

Full explanation →
Commitment Cryptography

A cryptographic object derived from applying a hash function to some data. A commitment has two essential properties: Binding — it is computationally infeasible to find two different messages that produce the same commitment. Hiding — the original message cannot be reconstructed from the commitment alone. In RGB, commitments to state transitions are anchored to Bitcoin transactions without revealing any contract data.

Consignment Contract

The data package transferred between parties in RGB Bitcoin Protocol, subject to client-side validation. There are two types: a Contract Consignment — provided by the issuer at asset creation, containing the Schema and Genesis — and a Transfer Consignment — provided by the sender to the receiver, containing the full state transition history from Genesis to the new unspent Assignment. The consignment is private and exchanged directly between parties.

Contract Contract

A set of digital rights established and executed between parties through RGB Bitcoin Protocol. A contract has an active state and business logic — expressed as ownership rights and executive rights — defined by a Schema. Only state changes allowed by the Schema’s declarations and validation scripts are valid within a contract’s scope.

D
Deterministic Bitcoin Commitment
DBC Bitcoin

The set of rules allowing exactly one commitment to be provably registered in a Bitcoin transaction. RGB supports two DBC schemes: Opret — embedding the commitment in an OP_RETURN output — and Tapret — embedding it in a Taproot output using the taptweak mechanism. Both schemes ensure that the commitment is verifiable and unique within the transaction.

G
Genesis Contract

The set of data that represents the starting state of every RGB contract — the moment of asset issuance. Genesis is regulated by the contract’s Schema and is the equivalent of Bitcoin’s Genesis Block at the client-side validation level. It defines all global state (ticker, name, supply) and the initial ownership allocations. Every consignment traces its history back to Genesis.

Global state Contract

The public properties of an RGB contract’s state — defined at Genesis and optionally updatable according to Schema rules — that are not owned by any specific party. Examples include an asset’s ticker, name, and total supply. Global state is shared across all parties interacting with the contract, unlike Owned State which belongs to specific UTXO holders.

H
HTLC
Hash Time-Locked Contract Lightning

The mechanism used by the Lightning Network to route payments across multiple hops without trust. An HTLC locks funds that can be claimed either by revealing a cryptographic secret (the payment preimage) or recovered by the sender after a timelock expires. In RGB Lightning channels, each routed payment adds a dedicated HTLC output to the commitment transaction with a corresponding RGB asset allocation — meaning whoever claims the HTLC output (via secret or timelock) receives both the satoshis and the RGB assets assigned to it.

How HTLCs work on RGB →
I
Invoice Contract

A base58 URL-encoded string that embeds the necessary data for a payer to construct a valid State Transition toward the receiver. An RGB invoice specifies the asset, amount, and the blind UTXO where the receiver wants to receive the allocation — without revealing which specific UTXO it is (blinding for privacy). Invoices are the standard payment request format in RGB Bitcoin Protocol.

M
Multi Protocol Commitment
MPC Cryptography

The Merkle Tree structure used in RGB Bitcoin Protocol to include multiple state transition commitments from different contracts in a single Bitcoin transaction. This is a key scalability feature: thousands of RGB state transitions across many different assets can be batched into a single on-chain transaction, each paying only a tiny fraction of the transaction fee.

O
Owned state Contract

The part of a contract’s state enclosed in an Assignment that contains the digital property subject to someone’s ownership. Ownership of an Owned State is defined by control of the Bitcoin UTXO referenced in the corresponding Seal Definition. Examples: the token balance owned by a specific UTXO holder, or the NFT media content assigned to a specific key.

Opret
OP_RETURN commitment Bitcoin

One of the two commitment schemes used by RGB Protocol on Bitcoin to anchor state transitions on-chain. Opret embeds the Multi Protocol Commitment (MPC) in a Bitcoin OP_RETURN output — a provably unspendable output that can carry up to 80 bytes of arbitrary data. The alternative scheme is Tapret, which uses a Taproot output instead. Both schemes are supported in RGB Lightning channels.

docs.rgb.info — DBC ↗
S
Schema Contract

A declarative template that defines the structure of an RGB contract — its state variables, transition rules, and validation logic. As documented in docs.rgb.info, a Schema is the analog of a class in object-oriented programming. It defines what operations are valid, what data types the contract uses, and how state can change. Schemas are compiled to binary .rgb files and imported by wallet software. Five standard schemas are supported: NIA, UDA, CFA, IFA, PFA.

See supported schemas →
Single-use seal Cryptography

A cryptographic primitive — proposed by Peter Todd — that is a promise to commit to a message exactly once, such that the commitment is provably known to all relevant parties. In RGB Bitcoin Protocol, every state transition is bound to a Bitcoin UTXO. Spending that UTXO closes the seal and makes the associated transition final and tamper-proof — exactly preventing double-spending without requiring on-chain contract data.

How single-use seals work →
Stash Contract

The complete set of client-side data related to one or more RGB contracts that a user has validated and stored locally. The stash is the user’s private database of their RGB asset history — equivalent to a local Bitcoin wallet’s UTXO set, but for RGB contract states. Unlike blockchain data, the stash is not replicated by the network and must be backed up by the user.

State transition Contract

The primary contract operation in RGB Bitcoin Protocol — the mechanism by which RGB contract state moves from one owner to another. A state transition consumes existing Owned States (inputs) and creates new Assignments (outputs), committing the transition to a Bitcoin UTXO via a single-use seal. The transition history from Genesis forms the DAG that receivers validate locally.

How state transitions work →
T
Taproot Bitcoin

Bitcoin’s Segregated Witness version 1 (SegWit v1) transaction format, activated in November 2021 via BIP341 and BIP342. RGB Bitcoin Protocol uses Taproot outputs for the Tapret commitment scheme — embedding state transition commitments in Taproot transaction outputs with zero additional on-chain footprint compared to a standard Taproot transaction.

Transition bundle Contract

A set of RGB state transitions belonging to the same contract that are committed together in the same Bitcoin witness transaction. Transition bundles, together with the MPC (Multi Protocol Commitment), allow multiple contracts’ state transitions to be batched into a single on-chain Bitcoin transaction — a key scalability feature of RGB Bitcoin Protocol.

U
UTXO
Unspent Transaction Output Bitcoin

A Bitcoin Unspent Transaction Output — defined by a transaction hash and a vout index (outpoint). UTXOs are the fundamental unit of Bitcoin ownership. In RGB Bitcoin Protocol, UTXOs are also the anchors of RGB asset ownership: controlling a UTXO means controlling the RGB assets assigned to it via single-use seals. Spending a UTXO both moves the bitcoin and closes the RGB seal, transferring the associated RGB assets.

W
Witness transaction Bitcoin

The Bitcoin transaction that provides the seal closing operation for one or more RGB state transitions. A witness transaction contains an MPC (Multi Protocol Commitment) tree commitment — either via Opret (OP_RETURN output) or Tapret (Taproot output). The witness transaction is the only on-chain footprint of an RGB state transition; it reveals nothing about the contract data it commits to.

Want to go deeper

into RGB Protocol on Bitcoin?

Read the full technical specification or explore the protocol layer by layer.