HOL Standards SDK

这个 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 功能的应用希望使用不捆绑网络传输的精简客户端。

如何安装或部署这个 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 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

常见问题