2.7 KiB
title, type, permalink, stable_id, scope, memory_type, project_id, usage_profile_id, status, revision, request_id, created_at, updated_at, tags
| title | type | permalink | stable_id | scope | memory_type | project_id | usage_profile_id | status | revision | request_id | created_at | updated_at | tags | |||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 天河链集成现状 | fact | main/projects/d44c219a-0b31-4de1-b160-323eb34a4c6a/天河链集成现状 | 46eb1720-910a-4e4e-b56b-b6ac43b0cec1 | project | fact | d44c219a-0b31-4de1-b160-323eb34a4c6a | 7aee455b-24cc-4008-bdaf-443721e6f939 | active | 1 | artveris-migrate-2026-09-03-fact-06 | 2026-09-03T03:39:46.758410+00:00 | 2026-09-03T03:39:46.758410+00:00 |
|
驱动：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 为准）。