用途:hcli 是与 Hedera 区块链交互的命令行工具,语法为 hcli <plugin> <command> [options],覆盖账户、代币(FT/NFT)、智能合约、共识主题和网络配置等操作。
主要能力:插件目录包括 account、hbar、token、topic、schedule、contract、contract-erc20、contract-erc721、network、config、credentials、batch、swap、eip712、x402、plugin-management。可创建/转账代币、管理 NFT、部署和调用 Solidity 合约、提交共识消息、调度交易、批量交易、资产交换、EIP-712 签名,以及通过 KMS 签署 x402 支付挑战(支付方私钥不外泄,由 facilitator 提交)。全局标志含 --format/-F(human 或 json)、--network/-N、--payer/-P、--confirm/-Y、--max-transaction-fee/-M。金额写法:"1" 为显示单位,"100t" 为最小原始单位。
使用方式:首次需配置网络并设置操作员,如 hcli network use --global testnet 和 hcli network set-operator --operator <accountId>:<privateKey>。执行前应阅读对应 references/<plugin>.md;涉及批量或调度时还需阅读 references/batch.md 或 references/schedule.md。仅标注 [scheduled] 的命令支持 --scheduled。状态保存于 ~/.hiero-cli/state/ 下按插件命名的 JSON 文件。若 hcli 未安装,可用 npm install -g @hiero-ledger/hiero-cli 安装(需用户确认)。
适用场景:需要脚本化或自动化操作 Hedera 账户、代币、合约、主题、支付签名等的开发与运维场景。
限制:需先配置操作员才能执行区块链命令;部分功能依赖已部署合约或启用的插件;x402 仅支持 Hedera 的 mainnet/testnet exact 要求,非 Hedera 方案无法签名。收费、价格、平台细节等暂未提供。