首页 /
构建 /
开发者工具
构建 /
开发者工具

构建所需的一切工具,

基于比特币上的 RGB 协议。

RGB SDK、多语言库、闪电节点集成、沙盒环境和核心协议库:在比特币上的 RGB 协议上构建生产级应用所需的一切。

一句话概括

本页梳理了完整的 RGB 开发者技术栈——从推荐使用的 SDK 到协议层的库——按照你的集成需要深入协议的程度进行组织。

01 /
RGB 开发者技术栈

选择合适的层,

适合你的使用场景。

RGB 工具按层级组织——应用开发从最上层开始,协议层工作则需要深入下层。

应用层——从这里开始

RGB Lib + 语言绑定

面向钱包、交易所和应用的高层 SDK。支持 Rust、Python、Swift、Kotlin、Node.js。

rgb-lib

闪电层

RGB Lib + 语言绑定

运行支持 RGB 的闪电节点。管理类型化资产通道,通过闪电网络路由 RGB 支付。

rgb-lightning-node

协议层

核心库 — rgb-consensus、rgb-core、rgb-std

底层协议实现。适合协议贡献者和高级集成场景。

rgb-protocol

基础层

比特币 — 承诺层

比特币仅存储密码学承诺。所有 RGB 逻辑都运行在这一层之上。

比特币
02 /
应用 SDK

RGB Lib——推荐的

起点

高层库,将 RGB 协议的复杂性抽象为简洁实用的 API,供钱包和应用开发者使用。

应用推荐使用

RGB Lib

一个高层 RGB 库,处理客户端验证、UTXO 管理、模式处理和状态转换的全部复杂性——提供简洁的 API 用于发行资产、生成发票和转移。从零到可用 RGB 集成的最快路径。

★45

RGB Lib 同时支持 Electrum 和 Esplora 两种后端连接比特币节点,可在主网、测试网和回归测试网上运行。它负责模式管理、凭证创建、PSBT 集成和盲发票生成。

# Add to Cargo.toml

[dependencies]

rgb-lib = “0.3”

# Available language bindings:

03 /
凭证传输

在钱包之间转移状态,

无需信任。

基础设施 · Rust

RGB Proxy Server

用于在钱包之间中继 RGB 凭证传输的服务器。用于闪电网络支付流程中,在各方之间传递状态转换。设计上无需信任——运营方无法篡改客户端验证

04 /
闪电网络集成

RGB Lightning Node——资产通道

基于闪电网络。

运行原生支持 RGB 资产通道的闪电节点。构建于 RGB Lib 和 LDK(闪电网络开发工具包)之上。

闪电网络 · Rust

RGB Lightning Node

完整的闪电节点实现,支持 RGB 资产通道。开启资产通道,管理 RGB 支付的 HTLC,并通过闪电网络路由资产。基于 LDK 构建,参考节点实现。

闪电网络 · Rust · LDK

Rust Lightning 分支

Rust Lightning(LDK)库的 RGB 兼容分支。RGB Lightning Node 的基础——展示了 RGB 状态转换如何在 LDK 层面与通道管理集成。

闪电网络 · 机器人

RGB Lightning Network Bot

一个用于在闪电网络上测试 RGB 的 Telegram 机器人——通过聊天方式访问 RGB 资产通道,无需在本地安装或运行闪电节点。快速上手体验转账的好方法。

t.me/rgb_lightning_bot ↗

Telegram 机器人

05 /
沙盒与测试

在上线主网前,

先在本地测试。

隔离的 Docker 环境,用于开发和测试 RGB 应用,无需花费真实比特币。

测试 · Docker · Shell

RGB Sandbox

基于 Docker 的本地环境,预先配置了比特币回归测试网、Electrum 服务器和完整的 RGB 基础设施。运行演示脚本,几分钟内即可看到完整的发行 → 转移 → 接收流程。

测试 · Python

RGB Faucet

RGB 资产的测试网水龙头——让开发者无需手动发行即可在测试网上获取测试用 RGB 代币。适用于测试钱包集成和转账流程。

测试 · Rust

RGB Tests

比特币 RGB 协议的官方集成测试套件。涵盖共识验证、状态转换、模式合规性和闪电通道行为。作为预期协议行为的参考。

rgb-protocol/rgb-tests ↗

官方测试套件

06 /
开源钱包实现

参考钱包代码

可供学习参考。

开源钱包实现,展示 RGB Lib 如何集成到生产级移动端和桌面端应用中。

钱包 · Kotlin · Android

Iris Wallet Android

面向 RGB 资产的开源 Android 钱包——使用 rgb-lib-kotlin 实现移动端 RGB 集成的参考实现。由 Bitfinex 开发。生产级代码,已在主网版 Iris Wallet 中使用。

钱包 · Python · 桌面端

Iris Wallet Desktop

面向 RGB 资产的开源桌面端钱包——桌面端 RGB 集成的参考实现。RGB 功能由 rgb-lightning-node 提供,封装在功能完整的 Python 图形界面中,并具备 UTXO 管理功能。

07 /
核心协议库

协议层库,

适用于高级集成。

实现比特币 RGB 协议规范的底层 Rust 库。适合协议贡献者和在共识层构建的开发者。

核心 · Rust

rgb-consensus

比特币 RGB 协议的共识与验证逻辑。协议规则的权威实现——模式验证、状态转换验证和承诺方案。

核心 · Rust

rgb-schemas

所有标准 RGB 模式的官方实现——NIA、UDA、CFA、IFA、PFA。资产发行的参考实现。RGB Lib 底层使用。

核心 · Rust

rgb-ops

面向 RGB 应用的非共识关键 API。构建于 rgb-consensus 之上,提供实用接口——连接核心协议验证与更高层的应用开发。

核心 · Rust

rgb-api

RGB API 层,为与 RGB 协议交互提供结构化接口。连接核心共识逻辑与 RGB Lib 等更高层 SDK 实现之间的空白。

核心 · Rust

rgb-aluvm

用于 RGB 合约验证的 AluVM 实现。在状态转换验证过程中于客户端执行模式验证脚本的虚拟机。

核心 · Rust

rgb-strict-types

RGB 模式用于精确定义状态数据类型的严格类型系统实现。每个合约状态变量都通过其语义 ID(semId)确定性地标识。

08 /
生态系统 SDK

由生态系统构建,

开箱即用。

由 RGB 生态系统项目维护的 SDK 和集成——在 RGB 协议协会核心工具之外扩展开发者技术栈。

应用 · TypeScript/Python

Kaleidoswap SDK

Kaleidoswap 原子交换基础设施的官方多语言 SDK。包含用于资产、报价和交换订单的 client.maker,以及用于控制 RGB Lightning Node 的 client.rln。仅限测试网/signet。

应用 · TypeScript

RGB SDK for Web

面向浏览器的 SDK,用于浏览器内的 RGB 资产和闪电网络支付——运行编译为 WebAssembly 的基于 LDK 的 RGB Lightning Node,完全在浏览器中运行。无需服务器、无需 Node.js、无需原生二进制文件。

应用 · TypeScript

RGB module for Tether’s WDK

将 Tether 的钱包开发工具包(WDK)接口与 RGB 连接——通过熟悉的 WDK 抽象实现密钥派生、UTXO 编排、资产发行(NIA/CFA/UDA/IFA)、转账和加密备份。

09 /
资源

接下来,

去哪里看。

RGB SDK 快速上手指南

快速上手指南

分步教程——从设置到在主网上发行第一个 RGB 资产。

RGB SDK 库地图

RGB 库地图

所有 RGB SDK 库及其相互关系的地图。 docs.rgb.info ↗
RGB SDK GitHub rgb-protocol 仓库

GitHub — rgb-protocol

核心协议仓库与文档。
github.com/rgb-protocol ↗

RGB SDK GitHub RGB-Tools 仓库

GitHub — RGB-Tools

SDK、钱包、闪电节点及工具仓库。
github.com/RGB-Tools ↗

比特币上的 RGB 协议 AI 助手

RGB Lightning Network Bot

一个用于在闪电网络上测试 RGB 的 Telegram 机器人。

t.me/rgb_lightning_bot ↗

RGB SDK 开发者社区

RGB Community Hub

提问、分享你的集成、获取社区帮助。t.me/rgbtelegram ↗

准备好开始构建了吗,

基于比特币上的 RGB 协议?

跟随分步指南——从设置到你的第一个 RGB 资产。