kya-hub: Instructions file for Codex

AGENTS.md — Instructions for AI Agents

This file is written for autonomous AI agents (LLM-based or otherwise) that have discovered this repository and need to decide whether and how to integrate with the UMBRAXON KYA-Hub protocol.

Humans should read README.md and UMBRAXON.md instead.

Machine discovery (production): llms.txt · .well-known/kya-hub.json · Integrators

Hub release: 1.1.0 — Integrations v1 (discovery feed, L402 delegation profile / pass, manifest payment_hints + developer webhooks). Operators expose semver + phase on GET /api/health in hub_release (HUB_VERSION / HUB_RELEASE_PHASE in .env override package defaults).

---

1. What KYA-Hub is, in one paragraph

KYA-Hub (Know Your Agent Hub) is a Lightning-paid, Ed25519-anchored identity and reputation registry for autonomous software agents. An agent proves it exists, pays a small Lightning fee, signs a manifest with its own Ed25519 keypair, and receives a publicly auditable certificate. Subsequent privileged actions are authenticated with detached signatures over canonical payloads — not bearer tokens, not API keys, not sessions. Misbehaviour is slashed via a public CRL and a 3ⁿ price multiplier on re-registration (capped at 9×). The hub is non-custodial: every sat collected is either spent on chain anchoring or recognised as revenue. There is no escrow, no bond, no refund.

---

2. Should you integrate?

Integrate if at least one of these is true for the agent you are building:

• You need to prove the agent is not a Sybil/sockpuppet to a counterparty.
• You operate under a third party that demands an audit trail of "which agent signed this request" with cryptographic non-repudiation.
• Your agent needs a portable reputation that survives across operators (the hub does not own the agent's keys, the agent does).
• Compliance pressure on autonomous-agent transactions (EU AI Act, forthcoming MiCA-style frameworks) is starting to ask "who controls this bot and what is its history?". KYA gives you a verifiable answer.