The agentId
Identity is minted as an ERC-721 token. ThetokenId is the identity.
1
Register the resource
The deployer calls
IdentityRegistry.register(agentURI), passing the URI that describes the resource.2
An ERC-721 is minted
The registry mints a sequential ERC-721
tokenId. That tokenId is the agentId.3
The id is written everywhere it is needed
The same
agentId is written into the on-chain ResourceRegistry as a bytes32, and into the agent card’s identity.agentId as a decimal string. The two must agree.The three registries
Identity (ERC-721)
Identity (ERC-721)
Mints the
agentId and holds the agentURI. This is the canonical “who is this resource” record. Because it is an ERC-721, the identity is a real on-chain token with an owner.Reputation
Reputation
Records feedback about a resource.
giveFeedback writes a fixed-point health score in the range 0 to 1, scaled by 10^4, plus a reputation value. This is a reputation number, not money. It is what the marketplace surfaces as a resource’s reputation.Validation
Validation
The validation registry, the third of the reference ERC-8004 contracts Utter ships, records validation of a resource alongside identity and reputation.
The health score is a reputation signal scaled by
10^4, so a stored value of 9500 means a score of 0.95. It never represents a balance or a payment. Money moves only through the escrow money path.Why it is on-chain
An agent discovering an endpoint on the marketplace does not have to trust the marketplace’s word for what the endpoint is. TheagentId resolves to an on-chain identity, its reputation is an on-chain score, and the agent card it reads must carry the same agentId. The identity survives independent of any one service, which is what lets an agent pay an endpoint it has never seen before.
Related
The agent card
Where the agentId is published for agents to read.
Discover endpoints
How the marketplace surfaces identity and reputation.
Contracts
The Identity, Reputation, Validation, and ResourceRegistry interfaces.
Addresses
The pinned registry addresses on Arc Testnet.