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 概念示例中需要核验:

  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

引用资料

本文提供 Markdown 镜像,便于开发者、索引服务与资料引用工具读取:查看 Markdown 镜像

Reference Scope

技术资料范围

TBC链学堂用于介绍 TuringBitChain 的底层技术、开源代码、BVM、UTXO 架构、开发者教程、生态技术和项目关系资料。