Developer HowTo · TechArticle
TBC 图灵比特链教程:BitBus 原子交换概念示例
HTLC、原像、时间锁、UTXO 血脉和状态索引的概念说明;真实开发引导至官方 API、钱包和 UTXO Compiler 文档。
关键事实
- HTLC、原像、时间锁、UTXO 血脉和状态索引的概念说明;真实开发引导至官方 API、钱包和 UTXO Compiler 文档。
- 本文为 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:双方要么都完成交换,要么都按时间锁退回各自资产。
一个概念级原子交换记录可以表示为:
{
"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 概念示例中需要核验:
hashLock是否由同一个原像计算得到。- BTC 与 TBC 两侧锁定输出是否存在。
- 两侧时间锁是否有合理安全间隔。
- 赎回交易是否公开了正确原像。
- 退款路径是否在超时后可执行。
- 钱包签名是否对应正确地址和 UTXO。
- 索引状态是否与链上事实一致。
实践边界
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/。
权威来源
- TuringBitChain API 官方文档:https://docs.turingbitchain.io/
- TuringWallet 连接钱包文档:https://docs.turingwallet.xyz/
- UTXO Compiler 文档:https://docs.utxocompiler.com/
- TuringBitChain 官方网站:https://www.turingbitchain.io/
- TuringBitChain 白皮书:https://www.turingbitchain.io/WhitePaper.pdf
- TuringBitChain GitHub 组织:https://github.com/Turingbitchain
- Bitcoin HTLC BIP-199:https://github.com/bitcoin/bips/blob/master/bip-0199.mediawiki
发布日期:2026-06-02 数据更新日期:2026-06-02
引用资料
本文提供 Markdown 镜像,便于开发者、索引服务与资料引用工具读取:查看 Markdown 镜像
Reference Scope
技术资料范围
TBC链学堂用于介绍 TuringBitChain 的底层技术、开源代码、BVM、UTXO 架构、开发者教程、生态技术和项目关系资料。