HOL Standards SDK

在应用中实现 HCS 标准、智能体发现与可信通信。

Star 数
★ 1.3k
最近更新
1 个月前
License
Apache-2.0
主语言
TypeScript

30 秒速览

运行形态
代码库 / SDK命令行工具开发框架
可在哪里用
平台专用
上手难度
中 · 需要几步配置
开始前需要
npm 或 pnpm运行 Hedera 演示所需的 Hedera 凭据核心智能体搜索与聊天流程所需的 fetch 实现Shell / 命令行网络访问本地文件系统
典型场景
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 ★

这个 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 流程的交互入口。

  1. Hedera 应用开发者需要在 TypeScript 项目中实现 HCS-1、HCS-2、HCS-3、HCS-7、HCS-10、HCS-11、HCS-20 或 HCS-27。
  2. 智能体平台团队需要通过 Registry Broker 搜索智能体、进行聊天并查询技能版本的生命周期与信任状态。
  3. 技能发布者需要为特定名称和版本申请验证,并通过 DNS TXT 记录证明域名控制权。
  4. 去中心化身份开发者需要验证并持久化 HCS-14 UAID 的 _uaid.<nativeId> DNS TXT 证明。
  5. 原型开发者需要演示两个 HCS-10 智能体的注册、连接、消息交换和中断恢复。
  6. 只需要 Registry Broker 功能的应用希望使用不捆绑网络传输的精简客户端。

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
  • npm install @hol-org/standards-sdk
  • npm install @hashgraphonline/standards-sdk
  • npm install @hol-org/rb-client
环境变量
HEDERA_ACCOUNT_ID HEDERA_PRIVATE_KEY REGISTRY_URL REGISTRY_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-broker
npm 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?

FollowAgents 源码审查 · FARS-2.1
缺口较多
44/ 100 五分制 2.2 / 5
信任安全 11/29
可靠稳定 3/14
适用触发 9/18
规范维护 10/18
有效结果 7/13
证据核验 4/8
查看各维度的扣分理由
信任安全11 / 29 · 1.9/5

README 提供密钥使用环境变量的示例,并提示保护私钥;但 SDK 示例会注册技能、验证域名证明、持久化 DNS 状态,HCS-10 演示还会自动资助代理、创建主题并注册,未见明确的逐项确认或恢复控制说明。数据流和外部副作用有部分描述,依赖安全仅有定期审计的概括性声明;因此这些方面只给部分分。项目包元数据、维护者文件指引、安全策略和漏洞报告地址支持来源归属得 2 分;发布者身份仍按题设视为未知。

可靠稳定3 / 14 · 1.1/5

README、package.json 和导出入口共同显示这是覆盖多项 HCS 标准的 SDK,并提供构建、类型检查及演示命令;但 README 同时称产品为 HOL SDK,包名仍为旧的 @hashgraphonline 范围,且列出 @hol-org 范围分发,名称状态不完全一致。依赖声明可见,但材料未给出可复现锁定、可用性保障或对失败模式的说明。故自洽性与依赖可用性仅部分支持,失败消息在样本中没有证据。

适用触发9 / 18 · 2.5/5

README 面向构建 Hedera 应用的开发者,列出支持标准、CLI、多个演示路径及可选客户端依赖,足以支持若干常见场景和 Node/浏览器使用;但没有清晰界定 SDK 的不适用场景或能力边界。样本中的 SKILL.md 只是定价元数据演示技能,没有可判断的触发条件或面向对象说明,故触发精度仅得 1 分。

规范维护10 / 18 · 2.8/5

README 按快速开始、文档、标准、演示、安全和贡献组织,并提供安装命令、代码示例及演示入口;许可证文件与元数据均明确 Apache-2.0,得满分。包名与 README 中的新旧 scope 并存,版本号为 canary,但样本没有变更日志或清晰版本迁移说明;安全策略写明受支持版本和报告渠道,README 指向维护者名单,但更新责任与支持范围仍较有限。

有效结果7 / 13 · 2.7/5

SDK 集中导出多项标准实现,README 提供可复制的客户端示例、演示和 CLI 指引,对目标开发者有实用价值。材料没有量化收益、资源成本或部署维护成本;广泛功能和可选依赖能说明用途,但不足以证明收益相对复杂度的表现,因此成本效益只得 1 分。

证据核验4 / 8 · 2.5/5

README 的安装命令、示例和演示路径可追溯到具体接口或脚本名,package.json 与导出入口也能佐证 SDK 范围;但核心功能声明主要由 README 自述,样本没有对应测试结果或独立材料交叉验证。文档未始终区分已实现能力、演示行为与面向用户的预期,故交叉佐证及事实/推断区分只得部分分。

风险与缓解建议
  • 使用演示前应留意其可能自动资助代理、创建链上主题、注册代理或持久化状态;样本没有说明每项副作用的确认和恢复机制。
  • 凭据示例涉及 Hedera 私钥,虽然文档建议通过环境变量保存,仍需自行控制变量文件和运行环境的访问权限。
  • 样本中的包范围与 README 的 HOL 新旧分发名称并存;安全策略所列支持版本也应结合实际发布信息核对。
证据充分度:低 评估于 2026年11月8日 审查版本 04f97c87da60
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/standards-sdk.svg?lang=zh)](https://followagents.com/zh/agents/standards-sdk)
<a href="https://followagents.com/zh/agents/standards-sdk"><img src="https://followagents.com/badge/standards-sdk.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v0.1.192
    发布说明摘录
    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 查看 ↗
  2. v0.1.191
    发布说明摘录
    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 查看 ↗
  3. v0.1.190
    发布说明摘录
    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,文档说明可从中断位置恢复。
是否包含所有支付和账本传输依赖?
不包含。精简客户端不捆绑网络传输;X402、EVM 和 Hedera 认证分别需要额外的软件包。
使用成本是多少?
代码采用 Apache-2.0 许可证,但源材料没有说明 Registry Broker、Hedera 交易、智能体注资或 X402 支付的具体费用。
HOL Standards SDK 官网是什么?
HOL Standards SDK 的 GitHub 仓库填写的官网是 https://hol.org。这个链接由仓库作者设置;源码在 GitHub(hashgraph-online/standards-sdk)。
HOL Standards SDK 开源吗?
开源。源码在 GitHub(hashgraph-online/standards-sdk),许可证是 Apache-2.0。
HOL Standards SDK 还在维护吗?
更新变慢了:GitHub 上最近一次提交是 2026-10-19,在最近半年内,但不在最近 30 天内。最新版本是 v0.1.192(2026-10-19)。
HOL Standards SDK 是谁开发的?
HOL Standards SDK 由 GitHub 账号 hashgraph-online 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念