Learn

ERC-8004 (RFC) reputation registry

The reputation registry is a public comment box for an agent that already has an ERC-8004 identity. People, and other agents, can leave a score. Anyone can read those scores. The chain does not turn them into one official star rating.

The spec is still a Draft, so the details can change.

How a review works

Think of a stack of report cards on the classroom wall. Each card names the student, the person who wrote it, and a mark. You can ignore cards from people you do not know. ERC-8004 does that for an agent, on a public chain.

1. The agent must already exist. Feedback is attached to an agentId from the identity registry. You cannot review an agent that was never registered on that chain.
2. The score. giveFeedback records a number and how many decimal places that number uses. A reviewer can also add up to two short tags, such as “on time” or “support,” and can name which service they are rating.
3. The longer note. The reviewer can point to a file with the full story. The contract announces that link. It does not store the whole story. What it keeps is the score, the tags, who wrote it, and whether it was later taken back.
4. You cannot rate your own agent. The owner of the agent, and an operator the owner has approved, are not allowed to leave feedback on that agent. A review has to come from someone else.
5. Each reviewer has a list. Your first review of that agent is number 1. The next is number 2. The same person can leave more than one note over time.
6. Taking it back. The same wallet can call revokeFeedback. The review is marked revoked. It is not erased, so the history still shows that a note was there and was withdrawn.
7. A reply. Anyone can attach a response. The agent owner might point to a refund. Another app might mark the review as spam. The reply is another link, not a new score.

Reviews live on the chain where they were written. A score on one chain does not automatically show up on another chain, even if the same project is registered in both places.

What the registry does not do

• It does not publish one official score for the agent.
• A summary function, getSummary, only counts reviewers you name. If you ask for “everyone,” fake wallets can flood the list. The spec blocks that empty filter on purpose.
• It does not check that the work was actually good. A score is a claim by one address.
• It does not prove the reviewer is a real customer. Apps are expected to decide which reviewers to trust.
• It does not move the agent’s chat logs, model, or server. Those stay outside this registry.

Professional use

A person can let past clients leave a public mark on the agent they use for work.

• A designer can show scores tagged to quoting or delivery, written by client wallets, not by the designer.
• A researcher can point a new client at named reviewers instead of a star that nobody can trace.
• A developer’s coding agent can collect notes on one endpoint, so the review is about that service and not a vague “the person is nice.”

The next client still chooses which reviewers count. A pile of reviews from brand-new wallets is weaker than a few reviews from wallets that have hired the agent before.

Business use

A company can use the same public box for agents that talk to customers or to other companies.

• A support agent can show ratings from known customer wallets.
• A purchasing agent at another company can read those notes before it hires the agent.
• A shop can ignore tags it does not care about and build its own score from the tags it does.
• An auditor or insurer can read the same public notes and publish its own judgment, without the company owning the only copy of the reviews.

The company cannot fill the box with its own praise. The owner wallet is blocked from reviewing its agent. Staff still have to answer bad reviews in public if they want a reply on the record.

Personal use

A person can use the box for an agent that is not a business.

• Friends can leave “this was helpful” on a personal assistant, and you can choose to show only those friends.
• A game character or a muse can collect fan notes that stay with the agent ID.
• You can take back a review you wrote. The record shows that you withdrew it.

Leaving, revoking, or replying to a review costs a network fee. A review does not include your private chat. If the long note lives at a link, readers can see it only while that link still works.

Back to Ethereum ERC Standards