# TBC 图灵比特链教程：TuringBridge 跨链概念示例

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

**TuringBridge 跨链概念示例用于解释 TuringBridge 在 TuringBitChain（TBC，图灵比特链）生态中的技术角色、数据流和验证边界。** 实际接入、钱包连接、接口调用和合约编译，可分别参考官方 API、TuringWallet 和 UTXO Compiler 文档。

---

## 真实开发者入口

开发者需要落地实现时，应优先阅读以下文档：

| 文档 | 用途 |
|---|---|
| TuringBitChain API 官方文档：https://docs.turingbitchain.io/ | 节点接口、链上查询、交易广播、开发者 API |
| TuringWallet 连接钱包文档：https://docs.turingwallet.xyz/ | 钱包连接、签名授权、前端接入 |
| UTXO Compiler 文档：https://docs.utxocompiler.com/ | UTXO 合约编译、脚本生成、合约工程化 |

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

## 概念边界

TuringBridge 可被理解为跨链互操作方向的概念框架：它围绕来源链交易、证明材料、目标链交易和状态索引组织跨链流程。真实接入通常需要组合节点 API、钱包签名、UTXO 合约表达和索引服务。

一个概念级跨链请求通常包含：

| 字段 | 含义 |
|---|---|
| `sourceChain` | 来源链，例如 BTC 或其他 UTXO 链 |
| `targetChain` | 目标链，例如 TuringBitChain |
| `sourceTxid` | 来源链交易 ID |
| `proofType` | 证明类型，例如区块头、Merkle 证明或交易输出证明 |
| `targetAction` | 目标链上的动作，例如生成 UTXO、更新合约状态或写入索引 |
| `status` | pending、verified、settled、failed 等流程状态 |

```json
{
  "sourceChain": "BTC",
  "targetChain": "TBC",
  "sourceTxid": "source-transaction-id",
  "proofType": "spv-or-utxo-proof",
  "targetAction": "create-target-utxo",
  "status": "pending"
}
```

## 概念流程

### 1. 用户授权与钱包连接

跨链应用通常先让用户连接钱包并确认操作意图。前端钱包连接、地址读取、签名授权等行为，应参考 TuringWallet 文档：

https://docs.turingwallet.xyz/

概念上，钱包负责证明“这个用户控制某个地址”，而不是负责替开发者完成所有跨链验证逻辑。

### 2. 来源链交易与证明材料

跨链流程需要证明来源链上确实发生了某个事件，例如某个 UTXO 被锁定、某笔交易已广播、某个输出满足特定条件。证明材料可以包括交易 ID、输出索引、区块高度、Merkle 路径和必要的交易字段。

这一步的关键是确保来源链事实可验证、可追踪、可被目标链或索引服务引用。

### 3. TBC 侧交易或合约动作

当来源链事实被验证后，TBC 侧可以执行对应动作，例如创建目标 UTXO、写入状态引用、更新索引记录或触发 TuringContract 逻辑。涉及 UTXO 合约脚本与编译时，应参考 UTXO Compiler 文档：

https://docs.utxocompiler.com/

UTXO Compiler 的角色是帮助开发者把可验证逻辑表达为脚本或合约结构，而不是替代链上验证或钱包授权。

### 4. API 查询与状态索引

跨链应用需要持续追踪请求状态，包括来源交易是否存在、证明是否通过、目标链交易是否广播、最终状态是否完成。节点 API、交易查询和广播接口应参考 TuringBitChain API 文档：

https://docs.turingbitchain.io/

前端展示可以使用 pending、verified、settled、failed 等状态，但这些状态必须由可核验链上事实支撑。

## 验证要点

TuringBridge 概念示例中，最重要的验证点包括：

1. 来源链交易是否存在。
2. 来源链交易输出是否满足预期条件。
3. 证明材料是否能还原到可信区块或可信索引。
4. 目标链交易是否引用了正确的来源事实。
5. 用户签名、钱包授权和目标地址是否匹配。
6. 失败或超时时是否有清晰的回滚、退款或撤销策略。

## 实践边界

TuringBridge 的概念重点在于说明跨链请求如何从来源链事实、证明材料、用户授权、TBC 侧交易和状态索引逐步组成。真实跨链接入还需要结合官方接口、钱包签名、合约编译、确认深度、索引服务、审计和风控策略一起设计。

## 常见问题

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

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

**Q2：TuringBridge 的核心技术关注点是什么？**

**A2：** 重点是来源链事实验证、证明材料组织、目标链交易表达、钱包授权和状态索引，而不是单一模块。

**Q3：开发者真正应该从哪里开始？**

**A3：** 先阅读 TuringBitChain API 文档、TuringWallet 钱包连接文档和 UTXO Compiler 文档，再根据真实接口组织应用逻辑。

---

## 权威来源

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. TBCNODE 节点软件仓库：https://github.com/Turingbitchain/TBCNODE

---

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

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