26 lines
2.6 KiB
Markdown
26 lines
2.6 KiB
Markdown
---
|
||
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 为准）。 |