{"skill":"HeyEthAgentSkill","name":"hey_eth","version":"2026-03-29","provider":"statechannel.org","base_url":"https://statechannel.org/heyeth","description":"Official agent skill for hey.eth — Free ENS handles for autonomous agents. Wallet-signed claims, directory lookup, CCIP resolution, and pay.eth hub routing. Fully live, ccipReady: true, publicClaims: true.","status":{"ok":true,"ccipConfigured":true,"claimSignatureRequired":true,"zone":"hey.eth","resolverSupportsExtended":true,"checkedAt":"2026-03-29T18:50:00.774Z"},"tools":[{"name":"discover","method":"GET","path":"/docs","description":"Discover full live route set, branded URLs, examples, zone status, and pay.eth hub metadata. Recommended first call for any agent.","parameters":{"type":"object","properties":{},"required":[]},"returns":"Full docs JSON including all endpoints"},{"name":"check_handle","method":"GET","path":"/handle/{handle}","description":"Check if a handle is available and return owner, addresses, offers array, and hub routing hints.","parameters":{"type":"object","properties":{"handle":{"type":"string","description":"Label to check (e.g. 'agent007')","example":"agent007"}},"required":["handle"]},"example_url":"https://statechannel.org/heyeth/handle/agent007"},{"name":"check_handle_query","method":"GET","path":"/handle","description":"Alternative query-param lookup (stable path for agents).","parameters":{"type":"object","properties":{"label":{"type":"string","description":"Handle label","example":"agent007"}},"required":["label"]}},{"name":"get_info","method":"GET","path":"/info/{handle}","description":"Get full claimed directory record (owner + all published addresses/coins + text records).","parameters":{"type":"object","properties":{"handle":{"type":"string","description":"Claimed handle","example":"agent007"}},"required":["handle"]}},{"name":"get_coin_info","method":"GET","path":"/info/{handle}/{coin}","description":"Get specific coin address for a handle (ETH, BTC, etc.).","parameters":{"type":"object","properties":{"handle":{"type":"string","example":"agent007"},"coin":{"type":"string","example":"ETH"}},"required":["handle","coin"]}},{"name":"get_status","method":"GET","path":"/status","description":"Current hey.eth zone owner, resolver, CCIP readiness, and pay hub metadata.","parameters":{"type":"object","properties":{},"required":[]}},{"name":"get_pay_metadata","method":"GET","path":"/pay/sepolia","description":"Sepolia pay.eth hub metadata for payment routing (x402s offers).","parameters":{"type":"object","properties":{},"required":[]}},{"name":"request_challenge","method":"POST","path":"/auth/challenge","description":"Get the exact EIP-191 message your agent wallet must sign to prove ownership.","parameters":{"type":"object","properties":{"handle":{"type":"string","example":"agent007"},"owner":{"type":"string","description":"0x wallet address","example":"0x1234567890123456789012345678901234567890"}},"required":["handle","owner"]},"body_example":{"handle":"agent007","owner":"0x1234567890123456789012345678901234567890"}},{"name":"claim","method":"POST","path":"/claim","description":"Claim a free handle (or update existing same-owner record). Requires signature from request_challenge.","parameters":{"type":"object","properties":{"handle":{"type":"string"},"owner":{"type":"string"},"nonce":{"type":"string","description":"From challenge response"},"signature":{"type":"string","description":"0x... EIP-191 signature"},"addresses":{"type":"object","description":"Optional coin addresses (defaults to ETH + BAL)","additionalProperties":{"type":"string"}},"texts":{"type":"object","description":"Optional ENS text records such as com.twitter","additionalProperties":{"type":"string"}}},"required":["handle","owner","nonce","signature"]}},{"name":"update","method":"PUT","path":"/handle/{handle}","description":"Clean update route for already-claimed handles (preferred over claim for edits).","parameters":{"type":"object","properties":{"handle":{"type":"string"},"owner":{"type":"string"},"nonce":{"type":"string"},"signature":{"type":"string"},"addresses":{"type":"object","additionalProperties":{"type":"string"}},"texts":{"type":"object","additionalProperties":{"type":"string"}}},"required":["handle","owner","nonce","signature"]}},{"name":"ccip_gateway","method":"POST","path":"/ccip","description":"Signed CCIP gateway for ENS resolvers (addr(), text(), etc.). Used by standard ENS wallets.","parameters":{"type":"object","properties":{"sender":{"type":"string","description":"Resolver contract address"},"data":{"type":"string","description":"Encoded calldata"}},"required":["sender","data"]}}],"notes":["All write operations require a fresh wallet signature (EIP-191).","Free claims for any ENS-safe label under hey.eth.","CCIP is live and mainnet resolver is already offchain-capable.","Use discover() first to get the absolute latest branded URLs if needed.","Full live docs JSON available at https://statechannel.org/heyeth/docs"],"example_usage":{"claim_flow":["1. POST /auth/challenge → get message","2. Sign message with owner wallet","3. POST /claim with nonce + signature + addresses/texts"]}}