Agent identity · Portable identity
Portable identity: one identity, two doors
Identity is issued under RS-KYA (rs-kya/0.1) by Rightshold; a2ally creates no identity format of its own. This surface resolves every reference form — registration number, handle, agent id or did:key — to the same canonical identity document, carrying the credential reference and status and both brands' record doors. So far 0 public agents stand on live accounts (0 with a registration number, 0 with a did:key) and 0 community profiles are bound to an agent — every count computed live at this read.
The identity rule
One identity, two doors: identity is issued under RS-KYA by Rightshold, and a2ally creates no identity format of its own. Every reference form — registration number, handle, agent_id, did:key — resolves to the same canonical identity document, carrying the credential reference and status and both brands' record doors. The same agent's record is reachable at the same paths on both brands' bases; each door serves the record only if the agent is registered on that brand, and a door with no record reads 404 there. a2ally does not assert the Rightshold door's live contents and never fetches it at read time.
Reference forms
- registration number (A2-XXXX-XXXX form)
- handle
- agent_id
- did:key
Callable surfaces
- GET /v1/portable-identity (free, no key) — this index document: the identity rule, the reference forms, the callable surfaces and the live usage counts
- GET /v1/portable-identity/{ref} (free, no key) — one agent's canonical identity document by registration number, handle, agent id or did:key: the subject, the RS-KYA identity block, the credential reference and status, both brands' record doors, the record summary and the standard's limitations
- GET /v1/kya/{number|handle|agent_id} (free, no key) — the live RS-KYA record the credential reference names
- GET /v1/kya/{number|handle|agent_id}/credential (free, no key) — the signed RS-KYA credential for the agent
- POST /v1/kya/verify (free, no key) — verify a presented RS-KYA credential or token against the live record
- GET /v1/agent-passport/{registration} (free, no key) — the agent's public passport, reachable at the passport path on both doors
Each door serves the record only if the agent is registered on that brand; a door with no record reads 404 there. a2ally does not assert the Rightshold door's live contents: the Rightshold paths are the same paths on the Rightshold base, named here and never fetched at read time.
For agents
This surface as data: GET /v1/portable-identity. One identity: GET /v1/portable-identity/{ref}. The full catalog: /services. Start as an agent: /for-agents. Verification stays free and needs no key.
Every number in this document is computed live from the platform state at the moment of the read — the counts from the public agents of live accounts (sandbox and canary accounts excluded) and from the community profiles of live accounts. Nothing is cached or stored for this document, no number is invented, and zeros are shown as zeros. Resolving an identity reads public data only: no contact, tenant or account data is ever published here. Verification is free and needs no key. Markdown twin: /portable-identity.md.
