多Agent账户管理：如何用 standards-sdk 快速创建 HCS-15 Petal 账户，一文搞定资金管理

【免费下载链接】standards-sdkThe official HOL Standards SDK, implementing the standards found in https://hol.org/docs/standards项目地址https://gitcode.com/gh_mirrors/st/standards-sdk点击查看免费下载本文介绍standards-sdkHashgraph Online 官方标准 SDK中的HCS-15规范实现教你如何用「基础账户 花瓣账户Petal Account」结构管理多个 AI Agent 的链上身份与资金覆盖账户创建、共享密钥、资金分配与浏览器钱包签名等完整流程。什么是 HCS-15先搞懂基础账户 花瓣账户模型 HCS-15 是 Hashgraph 生态中关于Petal花瓣账户结构的标准。它的核心思想很简单概念说明典型用途Base Account基础账户使用全新 ECDSA 密钥创建并自动生成 EVM 别名地址0x 开头作为资金主账户可直连 EVM 生态Petal Account花瓣账户复用基础账户的同一把公钥创建不设置独立别名为每个 Agent / 场景开设分账户独立持有资金打个比方基础账户是你的主钱包每个花瓣账户就像主钱包上分出来的零钱包——每个 Agent 各领一个资金互相隔离密钥却统一管理。这正是多 Agent 场景下做资金管理的关键给每个 Agent 独立的账户余额避免互相挤占同时无需维护一堆不同的私钥。这套逻辑在 SDK 中通过交易备忘录如hcs-15:op:base_create、hcs-15:op:petal_create做了清晰标记方便在链上追溯每一笔账户创建交易的来源相关定义见 tx.ts。3分钟上手安装 standards-sdk 并配置 HCS-15 环境第一步安装 SDKnpm install hol-org/standards-sdk旧版 scope 同样可用npm install hashgraphonline/standards-sdk第二步准备环境变量HCS-15 的 Node 端客户端需要一个操作账户来支付交易费用。在项目的.env文件中配置HEDERA_NETWORKtestnet HEDERA_OPERATOR_ID你的账户ID HEDERA_OPERATOR_KEY你的私钥第三步跑通官方演示如果你克隆了本仓库git clone https://gitcode.com/gh_mirrors/st/standards-sdk可以直接运行官方演示脚本它会完整走完创建基础账户 → 创建花瓣账户 → 验证 → 写入 HCS-11 智能体档案的全流程pnpm run demo:hcs-15演示源码在 demo/hcs-15/petal-accounts-demo.ts是学习 HCS-15 用法最好的参考。一行代码创建基础账户拿到账户、私钥和 EVM 地址在 Node 项目中创建HCS15Client后调用createBaseAccount即可。它的实现位于 sdk.ts流程全自动生成一把全新的ECDSA 密钥对用公钥 EVM 别名构建AccountCreateTransaction提交到网络并等待回执import { HCS15Client } from hol-org/standards-sdk; const hcs15 new HCS15Client({ network: testnet, operatorId: process.env.HEDERA_OPERATOR_ID, operatorKey: process.env.HEDERA_OPERATOR_KEY, }); const base await hcs15.createBaseAccount({ initialBalance: 1, // 初始余额 1 HBAR accountMemo: HCS-15 Base, }); console.log(base.accountId); // Hedera 账户 ID console.log(base.evmAddress); // 对应的 0x EVM 地址创建成功后你会拿到四样东西accountIdHedera 账户 ID如0.0.123456privateKey / privateKeyHex新账户的私钥请务必妥善保存publicKey公钥对象evmAddress由 ECDSA 公钥派生的 EVM 地址可直接在以太坊生态中使用 小贴士基础账户默认初始余额为 10 HBAR见 tx.ts 中的默认值可通过initialBalance参数按需调整。创建 Petal 账户共享密钥机制如何工作HCS-15 最巧妙的设计在于createPetalAccount花瓣账户直接复用基础账户的公钥创建不设置独立别名。这意味着✅ 你只需要保管一把私钥就能操作主账户下所有花瓣账户✅ 每个花瓣账户有独立的账户 ID 和独立余额天然实现资金隔离✅ 花瓣账户可通过基础账户的密钥签名管理成本低调用方式同样简单完整实现见 sdk.tsconst petal await hcs15.createPetalAccount({ basePrivateKey: base.privateKey, // 传入基础账户的私钥 initialBalance: 0.5, // 给这个花瓣拨 0.5 HBAR accountMemo: HCS-15 Petal, }); console.log(petal.accountId);创建后记得验证使用verifyPetalAccount实现见 base-client.ts通过 Mirror Node 比对两个账户的公钥是否一致const verified await hcs15.verifyPetalAccount( petal.accountId, // 花瓣账户 base.accountId // 基础账户 ); // true 表示密钥一致账户关系可信进阶给 Petal 账户绑定 HCS-11 智能体档案多 Agent 场景下光有账户还不够——Agent 还需要一个数字名片。createPetalAccount支持传入profile参数SDK 会自动联动 HCS-10 和 HCS-11 标准为花瓣账户创建一份 HCS-11 档案名称、简介、社交链接等并返回三个关键 Topic ID返回值含义profileTopicId档案本体所在的 TopicinboundTopicId该 Agent 的入站消息 Topic别人找它outboundTopicId该 Agent 的出站消息 Topic它找别人const result await hcs15.createPetalAccount({ basePrivateKey: base.privateKey, initialBalance: 0.5, profile: { baseAccountId: base.accountId, displayName: 客服 Agent-01, bio: 负责自动答疑的花瓣账户, }, }); console.log(result.profile?.profileTopicId);这一步的联动逻辑见 sdk.ts内部通过PersonBuilder组装档案并以花瓣账户自身为操作者提交到 HCS-10 注册表。这样一来开账户 注册身份 打通消息通道一次调用全部完成。资金分配策略多 Agent 钱包怎么管钱 结合 HCS-15 的特性这里给出几个实用的资金管理建议主账户留足运营金基础账户负责支付所有交易的 gas 费用由 operator 账户签名建议保持充足余额。initialBalance参数就是为初始拨款设计的。每个 Agent 按职责拨款为每个花瓣账户设置与其职责匹配的initialBalance如 0.5 HBAR而非平均分配。演示脚本中的做法就是这样基础账户 1 HBAR花瓣账户 0.5 HBAR见 petal-accounts-demo.ts。用maxAutomaticTokenAssociations预留 Token 空间如果你的 Agent 将来要接收 NFT 或代币如 HCS-6 Hashinal创建花瓣账户时提前设置该参数避免后续追加关联操作。用 memo 做标签账本accountMemo账户备注和transactionMemo交易备注是零成本的对账工具。约定好命名规范如petal:agent-01链上记录一目了然。定期核验账户关系生产环境中建议定期调用verifyPetalAccount确认花瓣账户与主账户的密钥关系未被破坏返回false时及时告警。浏览器钱包模式不用私钥也能创建 Petal 账户 如果你的应用跑在浏览器里DApp 场景私钥应该留在用户的钱包中。HCS-15 提供了专门的浏览器客户端HCS15BrowserClient实现见 browser.ts通过hashgraphonline/hashinal-wcHashinals Wallet Connect或DAppSigner接入钱包createBaseAccount/createPetalAccount方法签名与 Node 端几乎一致交易由钱包弹出确认私钥全程不离开用户设备import { HCS15BrowserClient } from hol-org/standards-sdk/browser; const hcs15 new HCS15BrowserClient({ network: testnet, hwc: myWalletSDK, // 已连接的钱包 SDK 实例 }); const base await hcs15.createBaseAccount({ initialBalance: 1 });如果没连钱包就调用会抛出HCS-15 Browser client requires an active signer错误——这是正常的保护机制。常见问题与排错 现象原因与对策抛出HCS-15 BASE_ACCOUNT_CREATE_FAILED基础账户创建失败通常是 operator 余额不足或网络配置错误检查network与 operator 配置抛出HCS-15 PETAL_ACCOUNT_CREATE_FAILED花瓣账户创建失败确认传入的basePrivateKey是ECDSA 格式私钥浏览器端提示 requires an active signer钱包未连接或未授权先完成钱包连接流程verifyPetalAccount返回 false两个账户公钥不一致或 Mirror Node 查询失败失败时 SDK 会记录 warn 日志错误码定义可参考 sdk.ts 与 sdk.ts。总结用「一主多花」结构管好你的 Agent 军团standards-sdk 的 HCS-15 实现把多 Agent 账户管理简化成了三步createBaseAccount—— 一把 ECDSA 密钥 EVM 地址主账户就位createPetalAccount—— 共享密钥创建花瓣账户按需拨付款项可顺带绑定 HCS-11 档案verifyPetalAccount—— 定期核验账户关系安心运维配合 HCS-10注册与发现、HCS-11身份档案等标准你甚至不需要手写任何AccountCreateTransaction就能搭建起一套密钥统一、资金隔离、身份可发现的 Agent 账户体系。核心类型定义PetalConfig、PetalAccount、PetalCreationResult等都集中在 types.ts建议收藏备查。赞分享【免费下载链接】standards-sdkThe official HOL Standards SDK, implementing the standards found in https://hol.org/docs/standards项目地址https://gitcode.com/gh_mirrors/st/standards-sdk点击查看免费下载相关推荐Prototype.js扩展开发如何创建自定义组件和插件Prototype.js扩展开发如何创建自定义组件和插件 Prototype.js是一款功能强大的JavaScript框架为开发者提供了丰富的工具和API0G Compute Network 账户管理完全指南主账户与 Provider 子账户的资金流、CLI/SDK 实操与安全机制0G Compute Network 账户管理完全指南主账户与 Provider 子账户的资金流、CLI/SDK 实操与安全机制 0G Compute NetBingGPT多账户管理终极指南如何在同一设备上使用多个账号BingGPT是一款强大的桌面应用程序让用户能够直接与新一代AI聊天功能进行交互无需安装特定浏览器或插件。对于需要同时使用多个账户的用户来说BingGPTAI 应用桌面应用创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考