> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kaleidoswap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# KaleidoSwap 工作原理：比特币、闪电网络与二层协议

> KaleidoSwap 背后的技术：比特币负责最终结算，闪电网络充当各比特币分层协议之间的互操作总线，哈希锁定合约则让跨层交易要么双方都完成，要么都不完成。

比特币早已不再只有一层。资产如今分布在闪电通道、状态链、虚拟 UTXO、联盟侧链，以及锚定在比特币自身之上的客户端验证叠加层中。每一层都有自己的状态模型，而且没有任何一层能读取另一层的账目。

但它们几乎都*能*表达一种**哈希锁定合约**：只向公开某个哈希原像的人付款，或在期限过后退款。KaleidoSwap 正是构建在这个共享原语之上。同一个原像用在一笔交易的两条腿上，就能让跨越两个互不兼容分层的交换要么双方都完成，要么都不完成。

## 比特币：结算层

每个 KaleidoSwap 钱包的内核都是一个比特币钱包：它持有 UTXO、签署交易，并向比特币网络广播。链上交易用于：

* **钱包充值** —— 在转入更快的分层之前先存入 BTC
* **开通与关闭通道** —— 把闪电通道锚定到链上
* **RGB 承诺** —— 把资产状态转移嵌入比特币交易
* **锚定进入与退出** —— 进出 Liquid、Arkade 或 Spark

比特币是价值最终结算的地方，也是上面每一层安全性的来源。

## 闪电网络：互操作总线

闪电网络是一种二层协议，它通过双向支付通道而不是区块来转移价值。在 KaleidoSwap 中，它承担两个不同的角色。

第一个是**快速、低成本的支付**。交换以秒计结算，而不是等待若干个确认，费用也只有几聪。

第二个角色则是整套技术栈得以成立的原因：闪电网络是**互操作总线**。大多数比特币分层协议都可以通过闪电网络触达 —— 或原生支持，或经由服务提供商 —— 而闪电网络的 HTLC 本身就是哈希锁定的。这让它成为跨层交易可以借道的公共媒介，即便涉及的两个分层彼此毫不知情。

## KaleidoSwap 连接的分层

| 分层                 | 是什么                     | 你持有什么                         | 状态             |
| ------------------ | ----------------------- | ----------------------------- | -------------- |
| **比特币 L1**         | 基础链                     | UTXO                          | 已上线            |
| **闪电网络**           | 比特币之上的支付通道              | 以 BTC 计的通道余额                  | 已上线            |
| **闪电网络上的 RGB**     | 闪电通道内经客户端验证的资产          | 同一通道内的 RGB 资产（USDT、XAUT）与 BTC | 已在测试网络上线，主网已验证 |
| **比特币 L1 上的 RGB**  | 同样的资产直接锚定到 UTXO，不使用通道   | UTXO 上的 RGB 资产                | 已上线，无需节点       |
| **Spark**          | 基于状态链的分层，用于快速、低费用的转账    | Spark 代币、USDB                 | 已上线            |
| **Arkade**         | 使用虚拟 UTXO（VTXO）的链下比特币交易 | VTXO 余额                       | 已上线            |
| **Liquid**         | 联盟式比特币侧链                | Liquid 资产，包括 USDt             | 已上线            |
| **Taproot Assets** | 兼容闪电网络的代币层              | —                             | 开发中            |
| **Fedimint**       | 联盟式电子现金                 | —                             | 计划中            |
| **Cashu**          | 乔姆式电子现金铸造方              | Ecash 代币                      | 计划中            |

<Note>
  各客户端支持的范围不同。桌面应用驱动一个完整的 RGB 闪电节点，而浏览器扩展用一组助记词即可覆盖 Spark、Arkade、Liquid 以及无需节点的 RGB-L1。按客户端的详细对照见[架构](/cn/whats-kaleidoswap/architecture#client-architecture)。
</Note>

## 资产叠加层：RGB

RGB 是构建在比特币之上的客户端验证智能合约系统（完整规范见 [RGB 协议官方文档](https://docs.rgb.info)）。与基于账户的智能合约平台不同，RGB 把合约逻辑和状态保留在**链下**，只把比特币交易当作密码学承诺来使用。由此带来：

* **隐私** —— 资产余额和转移不会出现在区块链上
* **可扩展性** —— 代币转移不会让链膨胀
* **比特币级安全** —— 资产状态锚定在比特币的工作量证明上
* **可编程性** —— 支持全部四种 RGB 接口：NIA 同质化代币（USDT、XAUT）、IFA、UDA 与 CFA

RGB 是一个*叠加层*，而不是独立的一层：同一份资产既可以待在比特币 UTXO 上，也可以搭载在闪电通道里。正是「搭载在通道里」让 RGB 资产能以闪电网络的速度交易，也支撑了 KaleidoSwap 在 2025 年完成的[首笔闪电网络主网 RGB 资产交换](https://kaleidoswap.medium.com/%EF%B8%8F-the-first-ever-rgb-asset-swap-on-lightning-mainnet-1b940dcd0efd)。

## 一笔交换如何完成

KaleidoSwap 采用\*\*询价（Request for Quote，RFQ）\*\*模型，而不是自动做市商。你发出询价，做市商给出价格，再由你决定是否接下。

<Steps>
  <Step title="请求报价">
    你的客户端从做市方持续接收某个交易对的实时价格。每份报价都带一个 `rfq_id` 和一个有效期。
  </Step>

  <Step title="锁定汇率">
    接下一份报价即锁定汇率，并返回交换参数，其中包括 `payment_hash` —— 两条腿都会锁定到这个哈希上。
  </Step>

  <Step title="锁定两条腿">
    双方各自把资产投入一份合约：只有出示该哈希的原像才能取走，超过期限则自动退款。此时还没有任何不可撤销的资金变动。
  </Step>

  <Step title="公开原像">
    为领取第一条腿，原像被公开。由于两条腿锁定的是同一个哈希，公开原像也就同时解锁了第二条腿。
  </Step>

  <Step title="结算或退款">
    双方都收到自己换来的资产。若任意一方停滞，时间锁到期后双方各自取回自己的资金 —— 绝不会出现只完成一半的交易。
  </Step>
</Steps>

协议层面的细节 —— 接口端点、`swapstring` 以及时序图 —— 见[原子交换协议](/cn/api-reference/swap-protocol)。

<h2 id="where-atomicity-holds">
  原子性在哪些情况下成立
</h2>

原子性取决于一笔交易所触及的分层。有两件事决定它，而且彼此独立：该分层是否具备原生哈希锁，以及由谁的保证来强制执行。

* **由比特币共识强制执行。** 比特币 L1、闪电网络，以及闪电网络上的 RGB。哈希锁不需要任何人配合，因此任何一方都不可能同时拿走两份资产。
* **在该分层自身的信任模型内强制执行。** Spark 暴露 HTLC，Arkade 用 Tapscript 构建 VHTLC，Liquid 继承 Bitcoin Script。哈希锁是真实存在的，但它附带该分层自己的假设（一组运营方、一个服务器签名、一个联盟），因此这条腿的原子性只存在于该分层之内，而不延伸到它下面。
* **由服务提供商中介。** 完全没有原生哈希锁：由某个服务为这条腿做桥接，在此期间你需要信任它，整笔交易也就不是端到端原子的。

KaleidoSwap 已上线的原子路径是闪电网络上的 BTC ↔ RGB 资产。其他路径通过已支持的交易场所完成，并在应用中作了相应标注。把原生哈希锁定结算扩展到更多分层的工作正在进行中；在 Spark、Arkade 和 Liquid 上，限制来自我们的实现进度，而不是缺少这个原语。

## 流动性：LSP 与做市商

一笔哈希锁定的交易依然需要对面有人，拿着对的资产，待在对的位置。

\*\*闪电服务提供商（LSP）\*\*解决的是位置问题。你不必自己四处寻找对等节点、盘算通道大小，只需连接一个 LSP，它会：

* **按需开通通道** —— 需要时即可订购入向流动性，还可以预先注入某种 RGB 资产
* **路由支付** —— 让你的交易能够抵达目的地
* **实现 LSPS1** —— 标准的通道订购接口，KaleidoSwap 将其扩展到了 RGB 资产
* **促成交换** —— 充当锁定另一条腿的对手方

**做市商**解决的是定价问题：他们把报价推送到询价引擎，赚取点差和路由费。目前这部分流动性由 KaleidoSwap LSP 自行启动；从 2027 年起，外部做市方将通过同一套接口展开竞争 —— 正是这一步把单一对手方变成一个市场。

## 网络

| 网络            | 用途                              | 状态            |
| ------------- | ------------------------------- | ------------- |
| **regtest**   | 在私有链上进行本地开发                     | 可用            |
| **signet**    | 共享测试网络，不涉及真实价值                  | 可用            |
| **Mutinynet** | signet 的一个变体，出块时间快且可预测，适合测试闪电网络 | 可用            |
| **主网**        | 真实资金                            | 在浏览器扩展中为实验性支持 |

<Warning>
  扩展中的主网支持仍属实验性质，SDK 也面向测试网络。交换可能失败或卡住。除非你能接受资金损失的风险，否则请使用测试网络。
</Warning>