Skip to content

story: Document Self Agent ID (live on mainnet, currently undocumented) #2262

Description

@GigaHierz

Part of #2266.

User story

As a developer giving an AI agent a verifiable, sybil-resistant identity, I want the Self page to show me how — with code — so I don't have to leave Celo's docs to learn that Agent ID exists.

Context & evidence

At bdf40b37, build-on-celo/build-with-self.mdx contains 0 occurrences of "agent" (grep -oi agent | wc -l → 0). Its headings are a feature list, not a journey, and there is no code:

## What is Self?
### How It Works
## Use cases
## New Features (2025)
### Expanded Identity Document Support
### Points/Rewards System
### Major Integrations
## Technical Resources
## Support

Agent ID is mentioned only in passing on build-with-ai/8004.mdx and build-with-ai/usecases.mdx. This is the largest content gap versus the agent-first message. It is independent of the restructure and can ship before it (#2259 moves the file with a redirect).

Acceptance criteria

  • "Identity for AI agents" section: what Agent ID is; registry addresses for Celo mainnet (chain 42220) and Celo Sepolia (chain 11142220 — note it is not Alfajores 44787), verified against the Self docs and on-chain before publishing — never copied from memory
  • Wallet-free CLI registration quickstart
  • Agent-side agent.fetch() auto-signing and service-side verifier middleware, as troubleshooting-grade snippets per the code-example policy in AGENTS.md (task: Add AGENTS.md — repo guidance for structure, headings, writing style, and code-example policy #2251) — no large end-to-end app
  • Cross-links both ways with build-with-ai/8004.mdx (Self Agent ID is an ERC-8004 implementation with a proof-of-human extension)
  • Page restructured as a journey: overview → quickstart → reference links; the "New Features (2025)" feature-list headings removed
  • Every snippet run once; command and output noted in the PR

Prior art

restructure-research/03-web2-readability-audit.md in PR #2210 at 9bd831fe0dc55c29f3e276dd1aee163330513039 (Journey 2) contains a concrete spec for the section.

Non-goals

Celo Agent Visa beyond one link (OPEN). Human identity verification content already on the page stays.

Depends on / blocks

No dependencies. OPEN: confirm the owner.

Measured at: bdf40b37

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentationenhancementUser story / featurepriority:highMajor feature broken, workaround existssize:MA day-ish: several files or needs design thoughtstatus: triageNeeds triage

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions