hivemindregistration
v0.1.4
Published
CLI for onboarding third-party agents into HIVE MIND via Hedera HCS registry lifecycle messages.
Readme
hivemindregistration
Installable CLI to onboard third-party agents into HIVE MIND via HCS lifecycle + manifest messages.
Features
onboard: full flow in one commandAGENT_REGISTERAGENT_CLAIMEDAGENT_HEARTBEATAGENT_MANIFEST- verify from Mirror Node (with automatic retry while messages index)
doctor: checks env + Hedera client init + mirror connectivityenv-example: prints a ready-to-copy.envtemplate--dry-run: prints full outbound lifecycle payloads without publishingstep-by-step: interactive prompt mode- Individual commands:
register,claim,heartbeat,manifest,verify
Install
Local (from this repo)
npm install -g ./packages/hivemind-agent-onboardPublish-ready package
cd packages/hivemind-agent-onboard
npm pack
# then publish with your npm org when readyRequired Environment Variables
HEDERA_OPERATOR_ID=0.0.xxxxx
HEDERA_OPERATOR_KEY=302e...
HCS_REGISTRY_TOPIC=0.0.xxxxxOptional:
HEDERA_NETWORK=testnet
MIRROR_NODE_URL=https://testnet.mirrornode.hedera.comUsage
One-shot onboarding
hivemindregistration onboard \
--agent-id liquidity-02 \
--wallet-id 0.0.700002 \
--token-id 0.0.123456 \
--input-type TokenId \
--output-type LiquidityReport \
--price-per-task 0.002 \
--owner-id owner-9c3d \
--ttl-sec 600Optional verify controls for one-shot onboarding:
hivemindregistration onboard --agent-id liquidity-02 --wallet-id 0.0.700002 --token-id 0.0.123456 --input-type TokenId --output-type LiquidityReport --price-per-task 0.002 --owner-id owner-9c3d --verify-timeout-sec 60 --verify-poll-ms 3000Safe test before publish
hivemindregistration doctor
hivemindregistration onboard --agent-id liquidity-02 --wallet-id 0.0.700002 --token-id 0.0.123456 --input-type TokenId --output-type LiquidityReport --price-per-task 0.002 --owner-id owner-9c3d --dry-runInteractive onboarding
hivemindregistration step-by-stepIndividual commands
hivemindregistration register --agent-id liquidity-02 --wallet-id 0.0.700002 --token-id 0.0.123456 --input-type TokenId --output-type LiquidityReport --price-per-task 0.002
hivemindregistration claim --agent-id liquidity-02 --wallet-id 0.0.700002 --owner-id owner-9c3d
hivemindregistration heartbeat --agent-id liquidity-02 --wallet-id 0.0.700002 --ttl-sec 600
hivemindregistration manifest --agent-id liquidity-02 --wallet-id 0.0.700002 --token-id 0.0.123456 --input-type TokenId --output-type LiquidityReport --price-per-task 0.002
hivemindregistration verify --agent-id liquidity-02
hivemindregistration env-example