---
title: 天河链集成现状
type: fact
permalink: main/projects/d44c219a-0b31-4de1-b160-323eb34a4c6a/天河链集成现状
stable_id: 46eb1720-910a-4e4e-b56b-b6ac43b0cec1
scope: project
project_id: d44c219a-0b31-4de1-b160-323eb34a4c6a
memory_type: fact
status: active
revision: 1
restored_from_commit: 6a6a895eafcca6052e81a14fca103a42635dd1c2
created_at: '2026-09-23T15:07:51.779557+00:00'
updated_at: '2026-09-23T15:07:51.779614+00:00'
tags:
- blockchain
- tianhe
- nft
---

驱动：`mock`（默认，拟真一次完成）/ `tianhe`，每次上链动态读系统设置（后台“系统设置 → 区块链存证”可切驱动/环境/AppID/AppKey，无需重启）。测试 API `https://test.api.tichain.tianhecloud.com`，正式 `https://api.tichain.tianhecloud.com`。
链路：每件上链 = 仅一次 `publish` 发行（接口2），铸一个链上数字商品：productId=追溯码，name≤42，author≤120，feature≤500（仅放作品主图公开 URL），operateId≤20 字符；确认走接口9 `GET /api/v2/nfr/transaction/status`（参数放 JSON body，status "0x0"=成功）回填 tokenId/区块高度；tokenId 可能返回 -1 待确认回填。不调 upload（元数据存证）/transfer/burn。`TianheProvider.attest`(upload) 代码保留未用。
状态机：`PENDING → SUBMITTING → CONFIRMING → ONCHAIN | FAILED | UNKNOWN`；确认节奏：提交后立即【不到】再 10s【再】再 30s 共 3 次自动，之后停等手动“重新确认”；未完成任务由启动与周期恢复扫描重投。
身份：单平台托管钱包（公证者），UserID 固定 `artveris-platform`，UserKey 一次性随机生成并明文存 `system_setting`（MASKED_KEYS，UI 掩码，揭示/复制 POST 带审计）；AppKey 加密存（SECRET_KEYS），揭示走 `POST /settings/tianhe/app-key/reveal` 返回明文并记日志。支持 UserKey 轮换（接口7）。重装后“手动录入”原 UserID/UserKey 复用钱包，切勿重新注册。合约地址存 `tianheContractAddress`，最大 tokenId 存 `tianheMaxTokenId`。
测试环境凭据见密码库“artveris · 天河链测试环境凭据”；生产必须另注册。
C 端：区块链卡展示交易哈希/合约/区块高度/上链时间，不展示 dataHash/tokenId；“查看存证”动态拼 `https://{test.}explorer.tianhecloud.com/#/tiChain/transDetail?hash=<txHash>`（按 `tianheEnv` 或 API base 是否含 `test.`），不信任 DB 历史 explorerUrl。
`BlockchainProof.dataHash` 是平台内部结构化摘要，不上链，不能作为链上防篡改证据。详细集成文档：`docs/天河链集成说明.md`（`docs/天河链文档.md` 是过时官方快照，以 APIFox 为准）。