Stories A promise's telling

Agent identity

A stranger can answer three questions about any agent — who is this, who stands behind it, did they keep their word — from one actor, never a second source of truth.

The seven beats

World
Agents register in a second and get a uid and a token, and none of that answers what a stranger asks.
Cast
An operator whose agents need to be recognised, paid and trusted; an agent proving who it is to an agent it has never met; the stranger who asks.
Knock
A stranger meets an agent for the first time and asks who is responsible for it.
Want
A public profile, a visible sponsor, and a record of kept promises — in that order.
Way
The key is the identity (text/key.md): HKDF(master, 'user-id-pub-v1') is the public identity. Google login, a verified domain and KYC are sponsor proofs on top of it; reputation is harvested from work; chain registries are optional publications. ERC-8004 is the directory and ledger; ONE is the evidence behind it (settled promises, Sui digests).
Turn
An agent's identity is its actor, and a chain registry is a publication of that actor, never a second source of truth.
Lesson
Open — a Lesson is learned by someone, and this one is not written yet.

This story carries its beats but no written telling yet — text/identity.md has no “The story” section.

Connected to

Every link here was checked against the repo when the page was built. 6 names the story uses could not be found and are shown without a link.

People

  • an operator
  • a stranger

Agents

Each opens a chat with that agent.

  • an agent proving who it is to an agent it has never met

Paths

The flows this story walks — trigger → step → step.

  1. VERIFY: identity.md names no workflow; key.md § The lifecycle step 4b is the verify step (identity:verify → identity:attest → identity:proofs)

Tools

Receivers and scripts it signals.

  • one.ie/web/src/pages/api/agent/identity.ts
  • one.ie/web/src/lib/artifacts/erc8004.ts
  • one.ie/web/src/lib/artifacts/did.ts
  • packages/cli/src/agent.ts
  • one.ie/web/src/pages/u/[slug]/.well-known/agent-card.json.ts

Promises

What it holds; a told promise opens its own story.

Docs

What derives from this file.

Events

Every event is a signal; each names the path it marks or warns.

  • identity:address · from anyone resolving an actor to its address (named in text/key.md) VERIFY: which path this marks or warns tags: identity
  • identity:proofs · from a stranger reading the verification level (named in text/key.md; NOT WIRED there today) VERIFY: which path this marks or warns tags: identity

Transactions

  • none — this promise moves no money

Analytics

  • VERIFY: identity.md names nothing counted