SuperAPI AI 工具集

hedera-consensus-service

通用与其它

查看项目

更新于 10-15 22:12

技能介绍

用途:Hedera 共识服务(HCS)提供去中心化、有序且带共识时间戳的消息日志,类似发布/订阅系统。可创建主题、提交消息,并通过镜像节点实时订阅消息,适用于审计追踪、事件日志、供应链追踪与去中心化通信。

主要能力:使用 @hiero-ledger/sdk 创建主题(可设 adminKey、submitKey、memo、自定义费用与费用豁免键);提交字符串或 Uint8Array 消息,回执含 topicSequenceNumber 与 topicRunningHash;通过 TopicMessageQuery 实时订阅,支持 setStartTime、setEndTime、setLimit、setMaxAttempts、setMaxBackoff 等选项;超过 1024 字节的消息自动分块,订阅端自动重组;支持更新主题、更新费用、删除主题与查询 TopicInfo。

使用方式:导入均来自 @hiero-ledger/sdk。可用 Client.forName(...).setOperator(...) 直接模式,或 Wallet + LocalProvider 签名者模式(配合 freezeWithSigner、signWithSigner、executeWithSigner、getReceiptWithSigner)。创建主题用 TopicCreateTransaction,提交用 TopicMessageSubmitTransaction,订阅用 TopicMessageQuery().subscribe(...),返回 SubscriptionHandle,结束时调用 handle.unsubscribe(),关闭时调用 client.close()。

限制与注意:无 adminKey 则主题不可更新或删除;无 submitKey 则任何人可提交;默认自动续期 90 天。创建主题后需等待数秒再订阅,镜像节点需同步。消息不可变,序列号从 1 开始。默认分块 1024 字节、最多 20 块,可通过 setChunkSize() 与 setMaxChunks() 调整。订阅不使用 execute()。具体费用、平台与效果等资料暂未提供。