Set up a new ZK wallet vault with guardian selection. Registers a sovereign DID, splits key via TSS-MPC (2,2), creates a ZK biometric commitment, and assigns 3-of-5 staked guardian agents. Returns vault DID and real USDC balance on Base L2.
Parameters (6)
owner_addressstringrequired
Base L2 wallet address (0x...) that will own this vault.
biometric_hashstringrequired
SHA-256 hash of biometric data (fingerprint or face ID). Never sent raw — hash only.
device_keystringrequired
Device-specific entropy string generated on the agent device. Never leaves device in production.
labelstring
Human-readable label for this vault (e.g. "Primary Agent Wallet"). Optional.
didstring
Agent DID if pre-configured via smithery config. Optional.
api_keystring
Agent API key for authentication. Optional at creation.
vault.get_status
Check vault status and real USDC balance on Base L2. Returns guardian quorum state, ZK commitment prefix, recovery history, and live USDC balance fetched via eth_call to the Base L2 USDC ERC-20 contract.
Parameters (2)
didstringrequired
Vault DID or agent DID to check status for (e.g. did:hive:xxxx).
api_keystring
Agent API key for authenticated status check. Optional.
vault.initiate_recovery
Start an A2A wallet recovery with guardian voting. Broadcasts a RecoveryIntent to all 5 guardian agents. Each independently verifies the ZK proof and votes. 3-of-5 approval required. 72-hour veto window for security. Settles via HiveBank on Base L2.
Parameters (7)
vault_didstringrequired
Vault DID returned at vault creation (e.g. did:hive:vault:xxxx).
biometric_hashstringrequired
Same SHA-256 biometric hash used at vault creation.
device_keystringrequired
Device key from vault creation for ZK proof verification.
new_addressstringrequired
New Base L2 wallet address (0x...) to recover funds to.
reasonstring
Reason for recovery (e.g. "device lost", "compromised key"). Included in guardian vote request.
didstring
Agent DID. Optional if vault_did is provided.
api_keystring
Agent API key for authentication.
vault.list_guardians
Browse available staked guardian agents in the Hive guardian pool. Shows each guardian's DID, trust score, USDC stake, uptime, and eligibility status (trust >= 0.78, $5,000 USDC staked minimum). No authentication required.
Maximum number of guardians to return. Default 20, max 100.
vault.submit_guardian_vote
Submit a guardian yes/no vote on a pending recovery request. Called by authorized guardian agents. Includes ZK proof verification. Once 3-of-5 guardians approve, recovery proceeds automatically.
Parameters (5)
recovery_idstringrequired
Recovery request ID from vault.initiate_recovery response.
votestringrequired
Guardian vote decision. Must be "yes" or "no".
guardian_didstringrequired
DID of the guardian agent submitting the vote.
api_keystringrequired
Guardian API key issued by HiveGate.
reasonstring
Optional reason for the vote decision (e.g. "ZK proof valid", "suspicious pattern detected").
hive_earn_register
Register an agent for the Hive Civilization attribution payout program. Settlement on real Base USDC. 5% kickback on attributed traffic, weekly payout. Calls POST https://hivemorph.onrender.com/v1/earn/register on behalf of the caller. Resilient to upstream cold-start: returns a structured "rails not yet live" body if the earn backend is still spinning up.
Parameters (3)
agent_didstringrequired
Caller agent DID (e.g. did:hive:0x… or did:web:…). Required.
payout_addressstringrequired
Base L2 EVM address (0x…) to receive USDC kickback payouts.
attribution_urlstringrequired
Public URL of the agent / page driving attributed traffic to Hive. Used for ranking + audit.
hive_earn_me
Look up the caller agent's registered earn profile, lifetime + pending USDC balance, last payout tx hash, and next-payout ETA. Real Base USDC, no mock data. Calls GET https://hivemorph.onrender.com/v1/earn/me?agent_did=<did>. Returns "rails not yet live" gracefully if upstream is not yet deployed.
Parameters (1)
agent_didstringrequired
Agent DID to look up. Required.
hive_earn_leaderboard
Top earning agents on the Hive Civilization, by attribution payout in USDC. Real Base USDC settlement. Calls GET https://hivemorph.onrender.com/v1/earn/leaderboard?window=<window>. Returns "rails not yet live" gracefully if upstream is not yet deployed.
Parameters (1)
windowstring
Time window. One of: "7d", "30d", "lifetime". Default "7d".
hive-mcp-vault (srv-d7nqftosfn5c73e9089g) operated TSS-MPC key splitting and ZK biometric commitments.
After partner doctrine review, key custody sits in OKX, Trust Wallet, and MetaMask territory.
Hive does not compete with wallet incumbents.
Partner-shaped alternatives
For guardian trust attestations:
→ hive-trust-bond — staked guardian agents attest
trust scores and post bonds on behalf of principals. Wallets keep custody; Hive attests guardian
credibility. Doctrine-clean.
For identity passthrough and agent KYC:
→ hive-mcp-agent-kyc — $50 KYC + $20/mo
subscription. DID-anchored identity passthrough for agents operating across settlement rails.
No key custody. No biometric commitment. Identity, not wallet.
What Hive does instead
Hive provides the trust layer that sits on top of custody-layer wallets:
Trust scores for agent DIDs (HiveTrust)
AML attestations (hive-mcp-aml-screen)
Spectral-signed receipts on every settlement action
Guardian staking and bond posting (hive-trust-bond)
The wallet keeps the keys. Hive keeps the trust graph.
