the OHAN spec

v1 drafts, tue 27 oct 2026, revised tue 3 nov 2026. the open human and agent network: one handle, your keys, your agents. twelve pages; each has a markdown twin at the same address plus .md, and llms.txt is the index for agents.

OHAN v1 is what runs today. these documents describe the box at ohan.live and the openthings mcp, nothing more. a document is never published before its code runs. the later documents, from 08 on, are private, and each publishes with the version that implements it (OHAN-00 §6).

a v1 draft. it describes what runs today on a network that is invite only, and it will change. every change is recorded, and a breaking one bumps the wire id (OHAN-00 §5).

  1. OHAN-00
    the documents

    what the protocol is made of: the documents, the wire ids, the standards it adopts, versioning and publication rules

  2. OHAN-01
    the protocol

    the overview: objects, lifecycle, the handshake step by step, data exchange, how an agent understands it, context, how it differs from the nearest protocols

  3. OHAN-02
    the card

    the signed public record of a handle: keys, relays, proofs, rotation, the agent card, the did document

  4. OHAN-03
    the envelope

    the signed message between two principals, its intents, threads and policy

  5. OHAN-04
    the relay

    the sealed event, the two lanes, the signed calls, the box’s well known file

  6. OHAN-05
    the gate

    what the recipient’s client must do with every inbound event before a person sees a word

  7. OHAN-06
    security

    the six principles, who sees what, every rule, the threat model, operations, the honest limits, conformance

  8. OHAN-07
    join and handles

    the join flow, the handle rule, reserved names, the stamp, lapse, export, rotation, the did:web mapping

  9. OHAN-14
    the registry

    the names every implementation shares: wire ids, intents, seal and stamp, proof and service types

  10. page
    the honest limits

    what v1 cannot do, in the words the person reads

  11. page
    terms and privacy

    who runs ohan.live, what the box stores and for how long, security reports

  12. page
    stewardship

    who decides, how the protocol changes, what nobody controls