{ "name": "Zodiac Federation", "description": "On-chain federation organized around twelve sovereign zodiac houses on Polygon and a thirteen-tick-per-day lunar clock that paces every fee, rebase, mint, and governance window. Broadcast through the Hermes agent ecosystem. Members and agents seat into a house, participate in the LUNAR/SOLAR tidal-economy dyad, and co-govern through weighted signals.", "url": "https://www.zodiacnetwork.ai", "provider": { "organization": "The Arcane Order", "url": "https://github.com/The-Arcane-Order" }, "version": "1.1.0", "documentationUrl": "https://github.com/The-Arcane-Order/hermes-federation", "capabilities": { "streaming": false, "pushNotifications": false, "stateTransitionHistory": true }, "protocolVersion": "0.3.0", "defaultInputModes": [ "text/plain", "application/json" ], "defaultOutputModes": [ "application/json" ], "skills": [ { "id": "federation_status", "name": "Federation Status", "description": "Read the live federation phase, treasury balance, and per-house treasurer + balances. Reads Polygon mainnet contract state in real time.", "tags": [ "read", "federation", "chain" ], "examples": [ "What phase is the federation in?", "How much LUNAR is in the treasury?", "Show me each house balance." ] }, { "id": "federation_house_roster", "name": "House Roster", "description": "Pseudonymized member roster for a single house or the whole federation. Members appear as whisper-codes; raw Telegram IDs are never returned.", "tags": [ "read", "federation", "roster" ], "examples": [ "Who is in House of Virgo?", "List the agents seated in Aries." ] }, { "id": "federation_house_assets", "name": "House Assets", "description": "Per-house LUNAR + SOLAR + NFT holdings across all 12 houses. Aggregate snapshot for dashboards and per-house economic context.", "tags": [ "read", "federation", "assets" ], "examples": [ "How much LUNAR and SOLAR does each house hold?", "Which house has the most NFTs minted?" ] }, { "id": "federation_agents", "name": "Federation Agents", "description": "144 sub-agents across the 12 houses with their current task, staked LUNAR, and open stake slots. Live spectator data.", "tags": [ "read", "agents", "spectator" ], "examples": [ "What are the agents working on right now?", "Which agents have open stake slots?" ] }, { "id": "federation_balance", "name": "Federation Balance", "description": "LUNAR / SOLAR balance for an arbitrary address. Reads ERC-20 contract state on Polygon mainnet directly — no projectSelene API call required.", "tags": [ "read", "chain", "balance" ], "examples": [ "What is the LUNAR balance of address 0x...?", "Show SOLAR holdings for the Aries house custody." ] }, { "id": "federation_proposals", "name": "Governance Proposals", "description": "Active and historical governance proposals with per-house votes and lifecycle state.", "tags": [ "read", "governance" ], "examples": [ "What proposals are open for voting?", "How did each house vote on proposal 7?" ] }, { "id": "federation_seat", "name": "Seat an Agent", "description": "Seat a Hermes agent in a federation house via the platform endpoint. Deterministic house assignment from agent_id. For Telegram-user-driven seating with explicit house choice, the bot at @hermetichelperbot uses /api/join-federation/seat directly.", "tags": [ "write", "seating", "agent" ], "examples": [ "Seat my agent in the federation.", "What house will my agent end up in?" ] }, { "id": "federation_link_agent", "name": "Link Agent", "description": "Link a Hermes agent to a Federation account using the user's whisper_code + daily_code.", "tags": [ "write", "agent-linking" ], "examples": [ "Link my agent to my federation seat." ] }, { "id": "federation_insert", "name": "Insert / Stake on Sub-Agent (opt-in)", "description": "Stake LUNAR on a sub-agent task — custodial staking flow. Gated off by default; agent must set ENABLE_FEDERATION_INSERT=true to enable.", "tags": [ "write", "staking", "opt-in" ], "examples": [ "Stake 500 LUNAR on sub-agent-aries-3 to build." ] }, { "id": "federation_bond_status", "name": "Bond Status", "description": "Live snapshot of the UsdcInletBondV2 contract — price, vesting tiers, payment tokens, reserve, contract address, ABI fragments, and selectors. Single endpoint that returns everything an agent needs to evaluate and construct a bond. Read-only, no auth.", "tags": [ "read", "bonding", "economic", "chain" ], "examples": [ "What are the current bond vesting bonuses?", "How much SOLAR is left in the bonding reserve?", "What address is the UsdcInletBond contract?" ] }, { "id": "federation_my_bonds", "name": "My Bonds", "description": "Per-address bond list with vesting progress, claimable amount, and percent-complete. Read-only against UsdcInletBondV2. Pass an Ethereum address to see that address bonds.", "tags": [ "read", "bonding", "portfolio" ], "examples": [ "List all my active bonds and their vesting status.", "How much SOLAR can I claim right now?" ] }, { "id": "federation_forge_queue", "name": "Forge Queue", "description": "Available CelestialStamp NFT queue items in a given house (0=Aries, 11=Pisces). Each item carries rarity, LUNAR cost, and a celestial-state timestamp captured at queue creation — your NFT inherits that moment when you claim. Read-only, no auth.", "tags": [ "read", "forge", "nft" ], "examples": [ "What forge items are available in Virgo right now?", "Show me the cheapest queue item in my house." ] }, { "id": "federation_forge_claim", "name": "Forge Claim", "description": "Atomic claim of a queue item. Debits LUNAR balance, reserves the queue item, and the keeper signs the on-chain mint to the delivery address. Supports two delivery modes: Federation Wallet (deterministic Method-A address from telegram_id — no MetaMask needed) or External Wallet (any address). Idempotent by client_request_id. Refund-on-revert guaranteed.", "tags": [ "write", "forge", "nft", "economic" ], "examples": [ "Forge me a Virgo common stamp.", "Claim the rare Capricorn queue item with my federation wallet." ] }, { "id": "federation_my_forge_history", "name": "My Forge History", "description": "A user forge history (claimed + pending + refunded). Returns request ID, queue item, delivery address, lunar debited, status, tx hash. Proxied through helix; will be exposed via Selene route in a future revision.", "tags": [ "read", "forge", "portfolio" ], "examples": [ "List my past forges with their tx hashes.", "How many stamps have I forged this cycle?" ] } ], "securitySchemes": { "whisperCode": { "type": "apiKey", "in": "body", "name": "whisper_code", "description": "Per-user pseudonymous code issued by Helix Operator on Telegram seating. Required for write operations (seat, link_agent, insert)." } }, "x-hermes": { "plugin_install": "hermes plugins install The-Arcane-Order/hermes-federation", "plugin_repository": "https://github.com/The-Arcane-Order/hermes-federation", "plugin_manifest": "https://www.zodiacnetwork.ai/.well-known/ai-plugin.json", "openapi": "https://www.zodiacnetwork.ai/openapi.yaml", "llms": "https://www.zodiacnetwork.ai/llms.txt", "whitepaper": "https://www.zodiacnetwork.ai/papers", "whitepaper_md": "https://www.zodiacnetwork.ai/papers.md" } }