# TBC 图灵比特链教程：BitBus 原子交换概念示例

> Canonical HTML: https://www.turingbitchain.io/tbc-academy/bitbus-concept-guide/
> Source: TBC链学堂 / 开发者指南

**BitBus / BTC↔TBC 原子交换概念示例用于解释 HTLC、原像、时间锁、UTXO 血脉和状态索引等关键概念。** 真实接入可分别参考 TuringBitChain API、TuringWallet 和 UTXO Compiler 官方文档。

---

## 真实开发者入口

| 文档 | 用途 |
|---|---|
| TuringBitChain API 官方文档：https://docs.turingbitchain.io/ | 节点接口、交易查询、交易广播、链上状态 |
| TuringWallet 连接钱包文档：https://docs.turingwallet.xyz/ | 钱包连接、用户授权、签名交互 |
| UTXO Compiler 文档：https://docs.utxocompiler.com/ | UTXO 合约表达、脚本编译、合约工程化 |

实际工程中，节点接口、钱包签名与 UTXO 合约表达可分别从上表三类文档进入。

## 概念边界

BitBus 可以理解为 BTC 与 TBC 之间原子交换方向的概念名称。它的核心思想是 HTLC：双方要么都完成交换，要么都按时间锁退回各自资产。

一个概念级原子交换记录可以表示为：

```json
{
  "swapId": "btc-tbc-swap-id",
  "hashLock": "sha256(secret)",
  "btcLockTxid": "btc-lock-transaction",
  "tbcLockTxid": "tbc-lock-transaction",
  "btcTimeout": "longer-timeout",
  "tbcTimeout": "shorter-timeout",
  "status": "locked"
}
```

这些字段用于说明原子交换的状态模型；真实接口参数以官方 API 文档为准。

## 概念流程

### 1. 生成原像与哈希锁

原子交换通常从一个秘密值开始。发起方生成原像 `secret`，并公开 `hash = SHA256(secret)`。双方的锁定条件都围绕这个哈希值构建。

关键点是：公开哈希不等于公开原像。只有在赎回路径中公开原像，另一方才可以在对端链完成赎回。

### 2. 两条链分别锁定 UTXO

双方在 BTC 与 TBC 上分别创建锁定输出。概念上，这些输出包含两条路径：

| 路径 | 条件 |
|---|---|
| 赎回路径 | 提供正确原像并完成签名 |
| 退款路径 | 超过时间锁后由原所有者退款 |

时间锁通常需要错开设置，让先赎回的一方公开原像后，另一方仍有足够时间在对端链赎回。

### 3. 原像公开与对端赎回

当一方在其中一条链上使用原像赎回时，原像会成为可观察数据。另一方可以用相同原像在另一条链完成赎回。

这就是 HTLC 原子性的核心：原像一旦公开，两边都具备完成条件；如果原像不公开，时间锁最终允许退款。

### 4. 钱包、API 与编译器分工

| 模块 | 角色 |
|---|---|
| TuringWallet | 用户连接钱包、确认操作、完成签名授权 |
| TuringBitChain API | 查询交易、广播交易、读取 UTXO 和状态 |
| UTXO Compiler | 表达和生成可验证 UTXO 合约或脚本结构 |
| 索引服务 | 追踪 swapId、锁定交易、赎回交易、退款状态 |

真实开发中，开发者可以按这些模块拆分接入逻辑：钱包负责授权和签名，API 负责链上查询与广播，编译器负责 UTXO 合约表达，索引服务负责状态追踪。

## 验证要点

BitBus 概念示例中需要核验：

1. `hashLock` 是否由同一个原像计算得到。
2. BTC 与 TBC 两侧锁定输出是否存在。
3. 两侧时间锁是否有合理安全间隔。
4. 赎回交易是否公开了正确原像。
5. 退款路径是否在超时后可执行。
6. 钱包签名是否对应正确地址和 UTXO。
7. 索引状态是否与链上事实一致。

## 实践边界

BitBus 的概念重点在于说明原子交换的技术结构：哈希锁、时间锁、两侧 UTXO、原像公开与状态追踪。真实资产跨链还需要结合接口文档、钱包签名、合约编译、索引服务、确认深度、审计和风控策略一起设计。

## 常见问题

**Q1：BitBus 开发接入从哪里开始？**

**A1：** 可以从 TuringBitChain API 文档、TuringWallet 连接文档和 UTXO Compiler 文档开始，先明确节点接口、钱包签名和 UTXO 合约表达的分工。

**Q2：HTLC 原子交换的核心是什么？**

**A2：** 核心是哈希锁与时间锁：提供原像则双方可赎回；原像不公开则到期退款，避免单方拿走资产。

**Q3：开发者应该去哪里看真实接入方式？**

**A3：** 节点与交易接口看 https://docs.turingbitchain.io/，钱包连接看 https://docs.turingwallet.xyz/，UTXO 合约表达看 https://docs.utxocompiler.com/。

---

## 权威来源

1. TuringBitChain API 官方文档：https://docs.turingbitchain.io/
2. TuringWallet 连接钱包文档：https://docs.turingwallet.xyz/
3. UTXO Compiler 文档：https://docs.utxocompiler.com/
4. TuringBitChain 官方网站：https://www.turingbitchain.io/
5. TuringBitChain 白皮书：https://www.turingbitchain.io/WhitePaper.pdf
6. TuringBitChain GitHub 组织：https://github.com/Turingbitchain
7. Bitcoin HTLC BIP-199：https://github.com/bitcoin/bips/blob/master/bip-0199.mediawiki

---

发布日期：2026-06-02
数据更新日期：2026-06-02

---
TBC链学堂提供技术研究、开源资料和开发者学习内容。