构建所需的一切工具,
基于比特币上的 RGB 协议。
RGB SDK、多语言库、闪电节点集成、沙盒环境和核心协议库:在比特币上的 RGB 协议上构建生产级应用所需的一切。
选择合适的层,
适合你的使用场景。
RGB 工具按层级组织——应用开发从最上层开始,协议层工作则需要深入下层。
应用层——从这里开始
RGB Lib + 语言绑定
面向钱包、交易所和应用的高层 SDK。支持 Rust、Python、Swift、Kotlin、Node.js。
闪电层
RGB Lib + 语言绑定
运行支持 RGB 的闪电节点。管理类型化资产通道,通过闪电网络路由 RGB 支付。
协议层
核心库 — rgb-consensus、rgb-core、rgb-std
底层协议实现。适合协议贡献者和高级集成场景。
基础层
比特币 — 承诺层
比特币仅存储密码学承诺。所有 RGB 逻辑都运行在这一层之上。
RGB Lib——推荐的
起点。
高层库,将 RGB 协议的复杂性抽象为简洁实用的 API,供钱包和应用开发者使用。
在钱包之间转移状态,
无需信任。
基础设施 · Rust
RGB Proxy Server
用于在钱包之间中继 RGB 凭证传输的服务器。用于闪电网络支付流程中,在各方之间传递状态转换。设计上无需信任——运营方无法篡改客户端验证
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-Tools/rust-lightning↗
LDK 分支
闪电网络 · 机器人
RGB Lightning Network Bot
一个用于在闪电网络上测试 RGB 的 Telegram 机器人——通过聊天方式访问 RGB 资产通道,无需在本地安装或运行闪电节点。快速上手体验转账的好方法。
t.me/rgb_lightning_bot ↗
Telegram 机器人
在上线主网前,
先在本地测试。
隔离的 Docker 环境,用于开发和测试 RGB 应用,无需花费真实比特币。
测试 · Docker · Shell
RGB Sandbox
基于 Docker 的本地环境,预先配置了比特币回归测试网、Electrum 服务器和完整的 RGB 基础设施。运行演示脚本,几分钟内即可看到完整的发行 → 转移 → 接收流程。
测试 · Python
RGB Faucet
RGB 资产的测试网水龙头——让开发者无需手动发行即可在测试网上获取测试用 RGB 代币。适用于测试钱包集成和转账流程。
测试 · Rust
RGB Tests
比特币 RGB 协议的官方集成测试套件。涵盖共识验证、状态转换、模式合规性和闪电通道行为。作为预期协议行为的参考。
rgb-protocol/rgb-tests ↗
官方测试套件
参考钱包代码
可供学习参考。
开源钱包实现,展示 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 管理功能。
协议层库,
适用于高级集成。
实现比特币 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-strict-types
RGB 模式用于精确定义状态数据类型的严格类型系统实现。每个合约状态变量都通过其语义 ID(semId)确定性地标识。
由生态系统构建,
开箱即用。
由 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)、转账和加密备份。
接下来,
去哪里看。

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


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

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


RGB Community Hub
提问、分享你的集成、获取社区帮助。t.me/rgbtelegram ↗
准备好开始构建了吗,
基于比特币上的 RGB 协议?
跟随分步指南——从设置到你的第一个 RGB 资产。
