# @hashgraphonline/standards-sdk 中文文档

规范地址：https://npmcn.com/package/%40hashgraphonline/standards-sdk/

版本：0\.1\.192
npm 元数据更新时间：2026-10-19T14:06:20.775Z
中文译文更新时间：2026-11-17T13:49:09.767Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40hashgraphonline/standards-sdk
原文对照：https://npmcn.com/package/%40hashgraphonline/standards-sdk/?lang=original
项目主页：https://hashgraphonline.com/docs/libraries/standards-sdk/
源码仓库：https://github.com/hashgraph-online/standards-sdk

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：32.7 MB，2727 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：20 个
- peer 依赖：@hiero-did-sdk/resolver ^0\.1\.8，@hiero-did-sdk/registrar ^0\.1\.8
- 首次发布：2025-03-14T15:37:33.130Z
- 最新版本发布：2026-10-19T14:06:20.423Z
- 近 30 天下载量：6179（2026-10-18 至 2026-11-16，npm 官方下载统计）
- 已发布版本数：579（近 12 个月 325 个）

## 中文简介

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

## 安装

```sh
npm install @hashgraphonline/standards-sdk
```

也可以使用：`pnpm add @hashgraphonline/standards-sdk`、`yarn add @hashgraphonline/standards-sdk`、`bun add @hashgraphonline/standards-sdk`

## README

# HOL 标准 SDK

| ![](https://npmcn.com/package/%40hashgraphonline/standards-sdk/Hashgraph-Online.png) | 一个轻量级SDK,为HOL创建的Hashgraph共识标准提供参考执行.  
  
这个SDK是由 [高级](https://hol.org/)由海德拉生态系统内的主要海德拉组织组成的联盟.  
  
[SDK文档](https://hol.org/docs/libraries/standards-sdk/)  
[HCS 标准文档](https://hol.org/docs/standards) |
| :-- | :-- |

## 快速启动

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

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

```bash
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参考文献,访问:

-   [标准 SDK 文档](https://hol.org/docs/libraries/standards-sdk/)

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

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

```typescript
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` 能够解决技能名称/版本和表面预览证据的生命周期状态,当回波只完成了验证-第一检查时:

```typescript
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 的证明 :

```typescript
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,并运行帮助脚本:

```bash
pnpm run cli
```

CLI浮出水面:

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

见 [cli/标准cli/README.md](https://npmcn.com/package/%40hashgraphonline/standards-sdk/cli/standards-cli/README.md) 用于高级和非交互式命令.

## 支持的标准

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

## 运行演示文稿

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

1.  清除仓库
    
    ```bash
    git clone https://github.com/hashgraph-online/standards-sdk.git
    cd standards-sdk
    ```
    
2.  安装依赖关系
    
    ```bash
    npm install
    ```
    
3.  设置环境变量
    
    ```bash
    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` 用于交互式发射器:
    
    ```bash
    npm run demo:registry-broker
    ```
    
    ```bash
    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` 文件,允许从任何中断中恢复.

## 捐款

请读我们的 [贡献指南](https://npmcn.com/package/%40hashgraphonline/standards-sdk/CONTRIBUTING.md) 财务报告和审定财务报表 [行为守则](https://npmcn.com/package/%40hashgraphonline/standards-sdk/CODE_OF_CONDUCT.md) (b) 在对这一项目作出贡献之前.

对于错误和特性请求,请使用 [问题模板](https://github.com/hashgraph-online/standards-sdk/issues/new/choose)。 。 。 .

## 警卫

关于安全问题,请参见我们 [安全政策](https://npmcn.com/package/%40hashgraphonline/standards-sdk/SECURITY.md)。 。 。 .

## 维护者

见 [安保人员](https://npmcn.com/package/%40hashgraphonline/standards-sdk/MAINTAINERS.md) 用于项目维护者列表.

## 资源

-   [HCS 标准文档](https://hol.org/docs/standards)
-   [Hedera 文档](https://docs.hedera.com/)
-   [电报社区](https://t.me/hashinals)

### 校对:Soup

-   [与Go & HCS-2建立分权登记册](https://hol.org/blog/building-decentralized-registry-go-hedara)
-   [与 MCP 通用代理发现](https://hol.org/blog/universal-agent-discovery-mcp)
-   [创建反应服务代理](https://hol.org/blog/creating-reactive-service-agents)
-   [端到端加密代理通讯](https://hol.org/blog/end-to-end-encrypted-agent-communication)
-   [建有x402的货币化代理](https://hol.org/blog/building-monetized-agents-x402)
-   [沟通](https://hol.org/blog/bridging-agentverse-communication)
-   [发现NANDA代理公司](https://hol.org/blog/discovering-nanda-agents-registry-broker)
-   [ERC-8004:无信用代理登记处](https://hol.org/blog/erc-8004-trustless-agent-registry)

## 许可证

阿帕奇 - 2.0

## 常见问题

### @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 和提交记录判断。

