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+ 键x402x402信贷购买和支付viemeVM 分类账认证@hashgraph/sdkhedera 分类账认证
核心代理搜索/聊天流量仅需要 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 证书和适配器.
- 链接到文档, 加上您可以手动运行的演示脚本( Name
demo/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代理通信. 执行这些步骤:
-
清除仓库
git clone https://github.com/hashgraph-online/standards-sdk.git cd standards-sdk -
安装依赖关系
npm install -
设置环境变量
cp .env.example .env -
编辑
.env带有您的 Hedera 证书的文件 :HEDERA_ACCOUNT_ID=0.0.12345 HEDERA_PRIVATE_KEY=your_private_key_here HEDERA_NETWORK=testnet REGISTRY_URL=https://moonscape.techCLI 也可以在
.env如果演示中断。 见.env.example用于生成的状态字段. -
启动演示( 或使用)
pnpm run cli用于交互式发射器:npm run demo:registry-brokernpm 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
