KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #typescript #codex #cli #claude-code #mcp #rust #deepseek-harness #ai-agent

rgb-node

★ 149 Open GitHub ↗

The official (self-hosted) server for RGB

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# RGB Node: sovereign smart contracts backend

![Build](https://github.com/RGB-WG/rgb-node/workflows/Build/badge.svg)
![Lints](https://github.com/RGB-WG/rgb-node/workflows/Lints/badge.svg)
[![Apache-2 licensed](https://img.shields.io/crates/l/rgb-node)](https://raw.githubusercontent.com/RGB-WG/rgb-node/master/LICENSE)

## Components

This repository contains the following crates:

- `rgb-node`: main indexing daemon, which can be used as an embedded multi-thread service,
  or compiled into a standalone binary (`rgbd`);
- `rgb-client`: client to work with the daemon and a command-line utility `rgb-cli`;
- `rgb-rpc`: a shared crate between `rgb-node` and `rgb-client`.

## Node Architecture

The node operates as a set of threads, communicating through Crossbeam channels.
It leverages [`microservices.rs`] and [`netservices.rs`] crates,
which serves as the node non-blocking reactor-based (see [`io-reactor`]) microservice frameworks.

The node daemon has the following components:

- **Broker**, integrating all services and managing their communications;
- **Dispatcher**: reactor-based thread managing incoming client RPC connections;
- **Contracts reader**, performing read-only ultra-fast access to the contracts and their state;
- **Contracts writer**, performing operations on contracts which require persistence;
- **Watcher**, connecting BP Node and monitoring on-chain and mempool events;
- **Validator**: a worker thread pool, doing consignment validation in background;
- **AsyncDispatcher**, used in embedded mode (see below).

All read operations can be performed in parallel;
the write operation does not block read operations
but requires exclusive access to the contract (meaning that all writes to the same contract are
performed serially).

## Using

RGB Node can be run in two modes:
as a standalone server and as a multithreaded service embedded into some other process.

### Standalone server

The mode is turned on using `server` feature flag and leads to production of `rgbd` executable.
The binary can be run as a daemon and accessed via binary RGB RPC interface.
The use of the RPC API can be simplified through `rgb-client` crate, providing high-level API.

By default, the node exposes a binary RPC API over TCP, which can be exposed as more high-level APIs
(HTTP REST, Websocket-based, or JSON-RPC) using special adaptor services.

### Embedded service

The mode is turned on using `embedded` feature flag and leads to production of `rgbnode` library.
To run RGB Node inside any app in this mode please call `Broker::start_embedded`,
giving in the method arguments a configuration and instantiated persistence provider.
The method returns `Broker` instance; call `Broker::client` to receive an `AsyncClient` which can
be used to process all calls to the node.

NB: Do not forget to join the `Broker` thread from the main app by calling `Broker::run` method.

## OS Support

The project currently supports Linux, macOS, and UNIX.
Windows support is a work-in-progress, requiring downstream [`io-reactor`] framework changes.

[`io-reactor`]: https://github.com/rust-amplify/io-reactor

[`microservices.rs`]: https://github.com/cyphernet-labs/microservices.rs

[`netservices.rs`]: https://github.com/cyphernet-labs/netservices.rs

rgb-node

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README