HOL Standards SDK
在应用中实现 HCS 标准、智能体发现与可信通信。
- Star 数
- ★ 1.3k
- 最近更新
- 1 个月前
- License
- Apache-2.0
- 主语言
- TypeScript
- FA 评分
- 44/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- Hedera 应用开发者需要在 TypeScript 项目中实现 HCS-1、HCS-2、HCS-3、HCS-7、HCS-10、HCS-11、HCS-20 或 HCS-27。
- 不适合
- 需要脱离 Hedera/HCS 生态构建通用协议的团队
- 只想安装成品聊天机器人的用户
- 要求文档明确承诺特定大模型平台兼容性的团队
- 官网
- hol.org ↗ 来自 GitHub 仓库设置
- 维护状态
- 近半年有提交最近提交 2026-10-19最新版本 v0.1.192(2026-10-19)近 7 天每天 +0.6 ★
- 源码审查
- 44/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
HOL Standards SDK 是由 HOL 维护的轻量级开发套件,为 Hashgraph Consensus Standards 提供参考实现。它以 @hol-org/standards-sdk 完整包和体积更小的 @hol-org/rb-client Registry Broker 客户端发布,并附带交互式 CLI 与可运行演示。覆盖的标准包括文件存储、注册与索引、递归文件加载、Smart Hashinals、智能体通信、去中心化身份、可审计积分和透明度日志。应用可通过 RegistryBrokerClient 执行智能体搜索与聊天、技能状态查询、技能域名证明及 UAID DNS TXT 验证,也可运行 HCS-10 智能体创建、注册、连接和消息交换流程。SDK 在调用方的 JavaScript/TypeScript 项目中运行;网络传输、Hedera 凭据、Registry Broker 地址及可选支付或账本认证依赖由使用者配置。
应用导入 RegistryBrokerClient,以 API 密钥或 baseUrl 连接 Registry Broker。客户端可调用 requestSkillVerification 申请指定名称和版本的技能验证,使用 createSkillDomainProofChallenge 生成 DNS TXT 挑战,再通过 verifySkillDomainProof 提交域名证明;getSkillStatus 返回信任层级、后续步骤和可能存在的预览状态 URL。对于 HCS-14 UAID 配置,它通过 verifyUaidDnsTxt 检查并可持久化 _uaid.<nativeId> TXT 证明,并由 getVerificationDnsStatus 刷新或读取状态。HCS-10 演示创建并注册 Alice 和 Bob,建立连接,收发小消息,并用递归存储处理大消息;创建进度可写入 .env,中断后继续。其他演示涵盖文本、URL 和文件缓冲区铭刻,以及从 URL、缓冲区或文本创建 Hashinal NFT。pnpm run cli 提供 Registry Broker、OpenRouter、聊天历史、账本认证和 HCS-10 流程的交互入口。
- Hedera 应用开发者需要在 TypeScript 项目中实现 HCS-1、HCS-2、HCS-3、HCS-7、HCS-10、HCS-11、HCS-20 或 HCS-27。
- 智能体平台团队需要通过 Registry Broker 搜索智能体、进行聊天并查询技能版本的生命周期与信任状态。
- 技能发布者需要为特定名称和版本申请验证,并通过 DNS TXT 记录证明域名控制权。
- 去中心化身份开发者需要验证并持久化 HCS-14 UAID 的
_uaid.<nativeId>DNS TXT 证明。 - 原型开发者需要演示两个 HCS-10 智能体的注册、连接、消息交换和中断恢复。
- 只需要 Registry Broker 功能的应用希望使用不捆绑网络传输的精简客户端。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
npm install @hol-org/standards-sdknpm install @hashgraphonline/standards-sdknpm install @hol-org/rb-client
- 环境变量
HEDERA_ACCOUNT_IDHEDERA_PRIVATE_KEYREGISTRY_URLREGISTRY_BROKER_API_KEY- 配置文件
.env.example.env
如何安装或部署这个 Agent?
完整 SDK 使用新的 HOL 包作用域安装:
npm install @hol-org/standards-sdk旧作用域仍在文档中列出:
npm install @hashgraphonline/standards-sdk只使用 Registry Broker 时可安装较小的客户端:
npm install @hol-org/rb-client@hol-org/rb-client 不内置网络传输。核心智能体搜索和聊天只要求运行环境提供 fetch;X402 购买与支付需另装 axios、x402-axios 和 x402,EVM 账本认证需 viem,Hedera 账本认证需 @hashgraph/sdk。运行仓库演示时,先克隆并安装依赖:
git clone https://github.com/hashgraph-online/standards-sdk.git
cd standards-sdk
npm install然后创建环境文件:
cp .env.example .env填写演示所用配置:
HEDERA_ACCOUNT_ID=0.0.12345
HEDERA_PRIVATE_KEY=your_private_key_here
HEDERA_NETWORK=testnet
REGISTRY_URL=https://moonscape.tech源材料没有声明具体 Node.js 版本。
如何使用这个 Agent?
可先启动交互式 CLI,查看演示、所需环境变量及辅助脚本:
pnpm run cli分别运行 Registry Broker 或 HCS-10 演示:
npm run demo:registry-brokernpm run demo:hcs-10查询技能生命周期状态的最小示例:
import { RegistryBrokerClient } from '@hashgraphonline/standards-sdk';
const client = new RegistryBrokerClient({
baseUrl: 'https://hol.org/registry/api/v1',
});
const status = await client.getSkillStatus({
name: 'registry-broker',
version: '1.0.0',
});
console.log(status.trustTier);
console.log(status.nextSteps);
console.log(status.preview?.statusUrl ?? null);对应的可运行演示命令为:
pnpm -C standards-sdk run demo:registry-broker-skill-status -- --skill-name=<name> --skill-version=<version> --base-url=<broker-api-url>需要技能域名验证时,配置 REGISTRY_BROKER_API_KEY 后调用挑战与验证接口:
import { RegistryBrokerClient } from '@hashgraphonline/standards-sdk';
const client = new RegistryBrokerClient({
apiKey: process.env.REGISTRY_BROKER_API_KEY,
});
await client.requestSkillVerification({
name: 'demo-skill',
version: '1.0.0',
tier: 'basic',
});
const challenge = await client.createSkillDomainProofChallenge({
name: 'demo-skill',
version: '1.0.0',
domain: 'example.com',
});
const challengeToken = challenge.txtRecordValue.replace(/^hol-skill-verification=/, '');
await client.verifySkillDomainProof({
name: 'demo-skill',
version: '1.0.0',
domain: 'example.com',
challengeToken,
});这个 Agent 有哪些优点和局限?
- 一个 SDK 覆盖八项明确列出的 HCS 标准,并提供 HCS-10 通信及 Registry Broker 的具体参考流程。
- 同时提供完整 SDK 与零网络传输捆绑的精简
@hol-org/rb-client,便于按功能控制依赖体积。 - 技能验证同时覆盖名称/版本级状态和 DNS TXT 域名证明,UAID 也有独立的 HCS-14 DNS 验证接口。
- HCS-10 演示会实时保存智能体创建状态,流程中断后能够从已记录位置继续。
- 交互式 CLI 集中展示演示、环境变量、文档入口和可单独运行的脚本。
- 核心标准和多数高级流程围绕 Hedera/HCS 生态,采用其他账本或协议的团队需要自行适配。
- 完整演示需要配置 Hedera 账户、私钥、网络和 Registry URL,初始设置不止一次安装命令。
@hol-org/rb-client不捆绑网络传输;支付和账本认证还需按功能安装多组可选依赖。- 源材料没有说明支持的 Node.js 版本,也没有给出 ChatGPT、Codex、Claude 或其 API 的原生兼容承诺。
- 账本费用、Registry Broker 服务费用及 X402 支付成本均未说明,采用前需另行确认。
这个 Agent 与同类方案有什么区别?
与完整的 @hol-org/standards-sdk 相比,@hol-org/rb-client 只提供 Registry Broker 客户端,安装体积更小且不捆绑网络传输。前者适合需要 HCS 标准实现、HCS-10 流程及完整演示的项目;后者适合只做智能体搜索、聊天或 Registry Broker 集成,并愿意按需添加 fetch、X402、EVM 或 Hedera 认证依赖的应用。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| HOL Standards SDK 当前 | 44 · 缺口较多 | 代码库 / SDK | ★ 1.3k | 1 个月前 | TypeScript | — |
| Hindsight | 68 · 存在缺口 | 自托管服务免费版 + 付费版 | ★ 62k | 今天 | Python | OpenAI API · Claude API |
| Omnara 托管 Agent 平台 | 68 · 存在缺口 | 云服务 / SaaS免费版 + 付费版 | ★ 3.4k | 1 天前 | Go | Codex · Claude Code · Claude.ai · OpenAI API · Claude API |
| PenguinHarness | 67 · 存在缺口 | 桌面应用免费 + 模型费 | ★ 3.3k | 今天 | TypeScript | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
README 提供密钥使用环境变量的示例,并提示保护私钥;但 SDK 示例会注册技能、验证域名证明、持久化 DNS 状态,HCS-10 演示还会自动资助代理、创建主题并注册,未见明确的逐项确认或恢复控制说明。数据流和外部副作用有部分描述,依赖安全仅有定期审计的概括性声明;因此这些方面只给部分分。项目包元数据、维护者文件指引、安全策略和漏洞报告地址支持来源归属得 2 分;发布者身份仍按题设视为未知。
README、package.json 和导出入口共同显示这是覆盖多项 HCS 标准的 SDK,并提供构建、类型检查及演示命令;但 README 同时称产品为 HOL SDK,包名仍为旧的 @hashgraphonline 范围,且列出 @hol-org 范围分发,名称状态不完全一致。依赖声明可见,但材料未给出可复现锁定、可用性保障或对失败模式的说明。故自洽性与依赖可用性仅部分支持,失败消息在样本中没有证据。
README 面向构建 Hedera 应用的开发者,列出支持标准、CLI、多个演示路径及可选客户端依赖,足以支持若干常见场景和 Node/浏览器使用;但没有清晰界定 SDK 的不适用场景或能力边界。样本中的 SKILL.md 只是定价元数据演示技能,没有可判断的触发条件或面向对象说明,故触发精度仅得 1 分。
README 按快速开始、文档、标准、演示、安全和贡献组织,并提供安装命令、代码示例及演示入口;许可证文件与元数据均明确 Apache-2.0,得满分。包名与 README 中的新旧 scope 并存,版本号为 canary,但样本没有变更日志或清晰版本迁移说明;安全策略写明受支持版本和报告渠道,README 指向维护者名单,但更新责任与支持范围仍较有限。
SDK 集中导出多项标准实现,README 提供可复制的客户端示例、演示和 CLI 指引,对目标开发者有实用价值。材料没有量化收益、资源成本或部署维护成本;广泛功能和可选依赖能说明用途,但不足以证明收益相对复杂度的表现,因此成本效益只得 1 分。
README 的安装命令、示例和演示路径可追溯到具体接口或脚本名,package.json 与导出入口也能佐证 SDK 范围;但核心功能声明主要由 README 自述,样本没有对应测试结果或独立材料交叉验证。文档未始终区分已实现能力、演示行为与面向用户的预期,故交叉佐证及事实/推断区分只得部分分。
- 使用演示前应留意其可能自动资助代理、创建链上主题、注册代理或持久化状态;样本没有说明每项副作用的确认和恢复机制。
- 凭据示例涉及 Hedera 私钥,虽然文档建议通过环境变量保存,仍需自行控制变量文件和运行环境的访问权限。
- 样本中的包范围与 README 的 HOL 新旧分发名称并存;安全策略所列支持版本也应结合实际发布信息核对。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
Documentation - Standards SDK docs: https://hol.org/docs/libraries/standards-sdk/ <!-- Release notes generated using configuration in .github/release.yml at v0.1.192 --> What's Changed Other Changes * fix(hcs-25): resolve ans trust discovery agents by uid by @chou-godaddy in https://github.com/hashgraph-online/standards-sdk/pull/185 Full Changelog: https://github.com/hashgraph-online/standards-sdk/compare/v0.1.191...v0.1.192在 GitHub 查看 ↗ -
发布说明摘录
Documentation - Standards SDK docs: https://hol.org/docs/libraries/standards-sdk/ <!-- Release notes generated using configuration in .github/release.yml at v0.1.191 --> What's Changed Other Changes * feat(hcs-25): add ans-trust-discovery adapter and collector by @chou-godaddy in https://github.com/hashgraph-online/standards-sdk/pull/184 New Contributors * @chou-godaddy made their first contribution in https://github.com/hashgraph-online/standards-sdk/pull/184 Full Changelog: https://github.com/hashgraph-online/standards-sdk/compare/v0.1.190...v0.1.191在 GitHub 查看 ↗ -
发布说明摘录
Documentation - Standards SDK docs: https://hol.org/docs/libraries/standards-sdk/ <!-- Release notes generated using configuration in .github/release.yml at v0.1.190 --> What's Changed Other Changes * feat(hcs-25): add signal collectors for end-to-end trust-score collection by @kantorcodes in https://github.com/hashgraph-online/standards-sdk/pull/181 Full Changelog: https://github.com/hashgraph-online/standards-sdk/compare/v0.1.189...v0.1.190在 GitHub 查看 ↗
常见问题
核心搜索和聊天是否必须安装 Hedera SDK?
@hol-org/rb-client 的核心智能体搜索和聊天流程只要求提供 fetch;只有 Hedera 账本认证才需要 @hashgraph/sdk。技能域名验证需要什么权限?
REGISTRY_BROKER_API_KEY 请求验证,并要求把挑战值发布为目标域名的 DNS TXT 记录,因此需要相应的 Broker 凭据和 DNS 管理权限。HCS-10 智能体创建中断后需要重新开始吗?
.env,文档说明可从中断位置恢复。是否包含所有支付和账本传输依赖?
使用成本是多少?
HOL Standards SDK 官网是什么?
HOL Standards SDK 开源吗?
HOL Standards SDK 还在维护吗?
HOL Standards SDK 是谁开发的?
谢谢反馈,我们会据此改进页面。