@hashgraphonline/standards-sdk

中文文档
0.1.192发布于 2026/10/19Apache-2.0TypeScriptESM + CJS构建来源已验证近 30 天下载 6179

Hashgraph Online标准SDK提供了希罗共识标准(HCS)的完整实施,为开发者提供了在Hashgraph网络上构建美妙的分散应用所需的全部工具. 页:1

中文使用文档
文档目录16 节
  1. 快速启动
  2. 可选依赖关系 @hol-org/rb-client
  3. 文档
  4. 注册经纪人技能验证(DNS TXT域名证明)
  5. 经纪人技能生命周期状况
  6. 注册经纪 UAID DNS 核查(HCS-14 DNS TXT profile)
  7. 互动 CLI 和 Demos
  8. 支持的标准
  9. 运行演示文稿
  10. 演示
  11. 捐款
  12. 警卫
  13. 维护者
  14. 资源
  15. 校对:Soup
  16. 许可证

HOL 标准 SDK

一个轻量级SDK,为HOL创建的Hashgraph共识标准提供参考执行.

这个SDK是由 高级由海德拉生态系统内的主要海德拉组织组成的联盟.

SDK文档
HCS 标准文档

快速启动

npm install @hol-org/standards-sdk
# Legacy scope:
# npm install @hashgraphonline/standards-sdk

对于独立注册经纪客户,其足迹较小:

npm install @hol-org/rb-client

HOL范围分布平行发布:

  • @hol-org/rb-client仅限注册代理客户端
  • @hol-org/standards-sdk: HOL 范围内的全部 SDK

可选依赖关系 @hol-org/rb-client

零网络运输的客户船捆绑. 当您需要相关特性时安装这些同位素 :

  • axios + 键 x402-axios + 键 x402 x402信贷购买和支付
  • viem eVM 分类账认证
  • @hashgraph/sdk hedera 分类账认证

核心代理搜索/聊天流量仅需要 fetch 执行.

文档

完整的文件、实例和API参考文献,访问:

注册经纪人技能验证(DNS TXT域名证明)

这个 RegistryBrokerClient 支持版本范围技能验证外加 DNS TXT 域证明 :

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', // or 'express'
});

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,
});

可运行演示 : pnpm -C standards-sdk tsx demo/registry-broker/skill-domain-proof-demo.ts --skill-name=<name> --base-url=<broker-api-url>。 。 。 .

经纪人技能生命周期状况

这个 RegistryBrokerClient 能够解决技能名称/版本和表面预览证据的生命周期状态,当回波只完成了验证-第一检查时:

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>。 。 。 .

注册经纪 UAID DNS 核查(HCS-14 DNS TXT profile)

这个 RegistryBrokerClient 可以核实和坚持 _uaid.<nativeId> TXT 代理 UAID 的证明 :

import { RegistryBrokerClient } from '@hashgraphonline/standards-sdk';

const client = new RegistryBrokerClient({
  baseUrl: 'https://hol.org/registry/api/v1',
});

const verify = await client.verifyUaidDnsTxt({
  uaid: 'uaid:aid:...;uid=...;proto=a2a;nativeId=agent.hol.org',
  persist: true,
});

const status = await client.getVerificationDnsStatus(
  'uaid:aid:...;uid=...;proto=a2a;nativeId=agent.hol.org',
  { refresh: true, persist: false },
);

可运行演示 : pnpm -C standards-sdk run demo:registry-broker-uaid-dns -- --uaid=<uaid> --base-url=<broker-api-url>。 。 。 .

互动 CLI 和 Demos

启动捆绑的CLI来探索注册经纪人演示,检查所需的env vars,并运行帮助脚本:

pnpm run cli

CLI浮出水面:

  • 被引导的注册经纪人演示(OpenRouter,聊天历史,分类账认证)外加HCS-10代理流.
  • 一张需要的 Env vars 的地图 这样你就可以快速地拖出 Hedera 证书和适配器.
  • 链接到文档, 加上您可以手动运行的演示脚本( Namedemo/registry-broker, (中文(简体) ), demo/hcs-10) (中文(简体) ).

见 cli/标准cli/README.md 用于高级和非交互式命令.

支持的标准

标准说明
HCS-1文件存储
HCS-2登记和索引编制标准
HCS-3递归文件加载
HCS-7智能哈希纳尔
HCS-10代理商和大赦国际的对等通讯
HCS-11分散配置和身份标准
HCS-20可审计点
HCS-27透明度日志

运行演示文稿

SDK包括演示执行,显示注册经纪人流量(发现,聊天,分类账认证,OpenRouter)和HCS-10代理通信. 执行这些步骤:

  1. 清除仓库

    git clone https://github.com/hashgraph-online/standards-sdk.git
    cd standards-sdk
    
  2. 安装依赖关系

    npm install
    
  3. 设置环境变量

    cp .env.example .env
    
  4. 编辑 .env 带有您的 Hedera 证书的文件 :

    HEDERA_ACCOUNT_ID=0.0.12345
    HEDERA_PRIVATE_KEY=your_private_key_here
    HEDERA_NETWORK=testnet
    REGISTRY_URL=https://moonscape.tech
    

    CLI 也可以在 .env 如果演示中断。 见 .env.example 用于生成的状态字段.

  5. 启动演示( 或使用) pnpm run cli 用于交互式发射器:

    npm run demo:registry-broker
    
    npm run demo:hcs-10
    

每个演示目录包含 README 指令外加您可以审查 demo/registry-broker 财务报告和审定财务报表 demo/hcs-10 包括OpenRouter、历史快照、分类账认证和收费流.

演示

写入文件

文员演示( E)demo/inscribe-demo.ts)显示不同的文件记录能力:

  • 使用缓冲器的文字铭文
  • 基于 URL 的铭文
  • 文件缓冲标记
  • 从 URL 创建 Hashinal NFT
  • 从缓冲器创建 Hashinal NFT
  • 从文本内容创建 Hashinal NFT

每一个铭文都显示了不同的选项和元数据能力.

HCS-10 AI 代理通讯 Demo

HCS-10演示(demo/hcs-10/index.ts) 显示AI代理之间不信任的对等通信:

  • 代理创建和注册(艾利斯和鲍勃)
  • 代理元数据和简介管理
  • 代理之间的连接建立
  • 发送和检索小消息
  • 用递归存储发送和检索大信件
  • 信件数据处理
  • 可恢复代理创建: 如果代理创建被中断, SDK 将自动恢复使用环境变量保存的状态

该演示自动处理代理供资、专题创建和在全球登记册登记。 代理创建进度实时跟踪并保存到 .env 文件,允许从任何中断中恢复.

捐款

请读我们的 贡献指南 财务报告和审定财务报表 行为守则 (b) 在对这一项目作出贡献之前.

对于错误和特性请求,请使用 问题模板。 。 。 .

警卫

关于安全问题,请参见我们 安全政策。 。 。 .

维护者

见 安保人员 用于项目维护者列表.

资源

校对:Soup

许可证

阿帕奇 - 2.0

版本与发布记录

@hashgraphonline/standards-sdk 共发布 579 个版本,首次发布于 2025/03/14;过去 12 个月发布了 325 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.1.192latest2026/10/1929 天前
0.1.1912026/10/081 个月前
0.1.1902026/10/061 个月前
0.1.1892026/10/021 个月前
0.1.158-feat-agent-network-subscriptions.canary.b2176d5.1492026/10/021 个月前
0.1.1882026/10/011 个月前

其他发布通道:canary-feat-setup-canary-pipeline-for-npm-releases → 0.1.116-feat-setup-canary-pipeline-for-npm-releases.canary.135f7d1.3,canary-fix-hiero-did-import → 0.1.117-fix-hiero-did-import.canary.a27d005.4,canary-fix-browser-imports → 0.1.118-fix-browser-imports.canary.b290965.5,canary-feat-registry-broker-demos → 0.1.125-feat-registry-broker-demos.canary.c17bfd4.13.2,canary-feat-interactive-cli → 0.1.125-feat-interactive-cli.canary.d7618f0.17,canary-feat-async-registrations → 0.1.126-feat-async-registrations.canary.27a51b1.18.2。

关于 @hashgraphonline/standards-sdk 的常见问题

@hashgraphonline/standards-sdk 是什么?

Hashgraph Online标准SDK提供了希罗共识标准(HCS)的完整实施,为开发者提供了在Hashgraph网络上构建美妙的分散应用所需的全部工具. 页:1

如何安装 @hashgraphonline/standards-sdk?

在项目目录运行 npm install @hashgraphonline/standards-sdk,或使用 pnpm add / yarn add / bun add。

@hashgraphonline/standards-sdk 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@hashgraphonline/standards-sdk 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@hashgraphonline/standards-sdk 可以商用吗?

@hashgraphonline/standards-sdk 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@hashgraphonline/standards-sdk 的下载量有多少?

根据 npm 官方下载统计,@hashgraphonline/standards-sdk 在 2026/10/18 – 2026/11/16 这 30 天内被下载 6,179 次,日均约 206 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@hashgraphonline/standards-sdk 还在维护吗?

最新版本 0.1.192 发布于 2026/10/19(29 天前);至今共发布 579 个版本,其中过去 12 个月发布了 325 个;首次发布于 2025/03/14。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。