Overview
What the ERC-8004 Identity Adapter is and why you might need it.
The ERC-8004 Identity Adapter is a Solidity contract that lets an external token (ERC-721, ERC-1155, or ERC-6909) drive an ERC-8004 identity record.
The adapter:
- registers the ERC-8004 identity itself
- keeps permanent custody of the resulting ERC-8004 token
- binds the new
agentIdto exactly one external token - forwards controller-gated writes into the ERC-8004 registry
It is upgradeable (UUPS) and admin-managed via OwnableUpgradeable,
so you have a controlled path to track future ERC-8004 protocol changes.
Why an adapter#
NFTs can't own ERC-8004 records. The adapter makes it possible by binding an NFT to an ERC-8004 record. The owner of an ERC-721, ERC-1155, or ERC-6909 token then controls the ERC-8004 registration through the adapter contract.
How control works#
The adapter checks the bound token contract before any write into the ERC-8004 record.
- ERC-721: the caller must equal
ownerOf(tokenId). - ERC-1155: any address with
balanceOf(caller, tokenId) > 0qualifies. - ERC-6909: any address with
balanceOf(caller, tokenId) > 0qualifies.
Next steps#
- Quickstart, clone, build, deploy.
- Concepts, binding model, shared control, wallet proofs.
- Contract Reference, every function on the adapter.
- Deployed Addresses, proxy, implementation, and registry addresses with explorer links per chain.