MAcode/tcs-iptv/contracts/tcs_registry/README.md

tcs_registry — ChainMaker 智能合约（Go）

可信数据空间的链上合约，实现 TCS-IPTV 的四类核心数据结构与合约方法。 与 internal/chain 的 Client 接口语义一一对应：MVP 用 MemoryChain 开发测试， 真实部署时由 chain-svc 通过 ChainMaker Go SDK 调用本合约。

合约方法（对应需求16-AC2）

方法	权限	说明
IssueMA(ccCode, ctid, merkleRoot, fileHash, contentJSON)	仅监管节点	签发 MA 码并 1:1 强绑定哈希；不可重复、不可解绑
RegisterHashBinding(ctid, bindingJSON)	审核/监管	追加哈希绑定（转码版父子关系）
RegisterMapping(ctid, party, partyID, cdnEndpoint)	三方	注册编码映射；MA 必须已签发
VerifyHash(ccCode, fileHash) -> bool	任意	校验提交哈希与绑定哈希是否一致
QueryContent(ccCode) -> json	任意	查询内容主记录
QueryMappings(ccCode) -> json	任意	查询全部三方映射与 CDN 端点
RecordVersionChange(ctid, vcJSON)	审核/监管	记录版本变更，触发重审
Revoke(ccCode, reason)	仅监管节点	下架，返回受影响映射

权限模型（对应需求14）

合约内通过 sender() 的组织/角色证书判断调用方身份：

• RoleRegulator（监管主体）：IssueMA / Revoke 唯一发起方
• RoleReviewer（审核主体/CSPS/媒资库）：哈希绑定、版本变更
• RoleCP：送审时注册哈希、本方映射
• RoleOperator：注册本方映射、验真

国密

底层链使用长安链 ChainMaker（国密 SM2 签名 / SM3 哈希）。 内容哈希在链外用 SHA-256 计算（哈希SDK），链上仅存哈希值与映射，明文不入链（需求20-AC2）。

状态键设计（KV）

content:{ccCode}            -> Content JSON
binding:{ccCode}:{idx}      -> HashBinding JSON
hashidx:{fileHash}          -> ccCode      （防换壳重发）
mapping:{ccCode}:{idx}      -> Mapping JSON
version:{ccCode}:{idx}      -> VersionChange JSON
ctid2ma:{ctid}             -> ccCode

构建与部署（真实链，二期接入）

# 依赖 ChainMaker contract SDK
go mod init tcs_registry
# 编译为 wasm 或 docker-go 合约，按 ChainMaker 部署流程发布

MVP 阶段：业务逻辑与规则已在 internal/chain.MemoryChain 完整实现并测试通过， 本合约为真实链落地的等价实现规格，二期搭建 ChainMaker 测试网后落地替换。