ERC-8122 미니멀 AI 에이전트 레지스트리 (Minimal Agent Registry)
Draft · NFT·멀티토큰 · 2025-12-17 작성
ERC-6909 토큰 ID로 AI 에이전트를 등록하고 ERC-8048로 메타데이터를 온체인에 저장해 소유권 이전과 발견이 가능한 경량 레지스트리 표준입니다.
왜 필요한가
기존 오프체인 에이전트 프로토콜은 에이전트 간 통신은 다루지만 에이전트를 찾아내는 발견 기능은 다루지 않습니다. ERC-8004이 에이전트 레지스트리 표준을 제공하지만 체인마다 하나의 싱글톤 레지스트리만 두는 방식이라 화이트햇 해킹 에이전트 모음이나 디파이 스테이블코인 전략 에이전트 모음처럼 특정 목적에 맞춰 큐레이션된 컬렉션이나 고정 공급량 컬렉션을 만들기 어렵습니다. 또한 누구나 자신만의 레지스트리를 쉽게 배포할 표준이 없고, 메타데이터를 외부 저장소에 둘 경우 검열이나 삭제, 변조에 취약해집니다.
구현해야 하는 것
event Registered(uint256 indexed agentId, address indexed owner, string service_type, string service, address agent_account);: 새 에이전트가 등록될 때 발생하는 이벤트로 에이전트 ID, 소유자, 서비스 정보를 기록합니다.function register(address owner, string calldata service_type, string calldata service, address agent_account) external returns (uint256 agentId);: 표준 메타데이터 필드를 직접 지정해 새 에이전트를 등록합니다.function register(address owner, MetadataEntry[] calldata metadata) external returns (uint256 agentId);: 임의의 키값 메타데이터 배열을 전달해 새 에이전트를 등록합니다.function registerBatch(address[] calldata owners, MetadataEntry[][] calldata metadata) external returns (uint256[] memory agentIds);: 여러 소유자와 메타데이터를 한 번에 전달해 여러 에이전트를 일괄 등록합니다.function ownerOf(uint256 agentId) external view returns (address);: 주어진 agentId의 현재 소유자 주소를 반환합니다.function setContractMetadata(string calldata key, bytes calldata value) external;: 레지스트리 컨트랙트 자체에 대한 메타데이터를 설정합니다.
심층 설명
식별자 구조
각 에이전트는 agentRegistry와 agentId 두 값으로 전역적으로 고유하게 식별됩니다. agentRegistry는 ERC-7930 상호운용 주소로, 체인 타입과 체인 참조, 컨트랙트 주소를 하나의 바이너리 형식에 담아 별도의 네임스페이스나 chainId 필드 없이도 레지스트리 컨트랙트를 가리킵니다. agentId는 레지스트리가 자체 구현 방식에 따라 부여하는 uint256 토큰 ID입니다. 이 두 값의 조합으로 어느 체인, 어느 레지스트리에 있는 에이전트든 구분할 수 있습니다.
Agent ID 텍스트 포맷
에이전트 ID를 텍스트로 표시할 때는 ERC-8127의 [alias.]agentId@registry 형식을 따라야 하며, 이는 사람이 읽기 쉬운 토큰 식별자 형식입니다. registry는 ERC-7930 상호운용 주소를 소문자 16진수로 표기한 값이고 agentId는 10진수 토큰 ID입니다. alias는 선택 사항으로 에이전트의 name 메타데이터 필드 값을 사용할 수 있습니다. 예시로 alias를 포함한 agent.12345@0x0001...045, alias가 없는 12345@0x0001...045 형태가 있습니다.
소유권 모델과 전송 제한
레지스트리는 agentId를 소유자 주소에 매핑해 유지하고 ownerOf(uint256 agentId) 함수로 현재 소유자를 반환해야 합니다. 존재하지 않는 agentId를 조회하면 반드시 되돌려야 합니다. 단일 소유권을 강제하기 위해 transfer와 transferFrom의 amount 파라미터는 반드시 정확히 1이어야 하며, 1이 아니면 전송이 되돌려져야 합니다. 전송이 일어나면 _owners 매핑이 새 소유자로 갱신되어야 합니다.
컨트랙트 레벨 메타데이터
레지스트리는 자신의 정보를 위해 ERC-8049를 구현하는 것이 권장되며, 사용할 경우 setContractMetadata 함수를 반드시 노출해야 합니다. 접근 제어는 구현에 따라 다릅니다. name, description, image 키는 설정이 권장되고, symbol, banner_image, featured_image, external_link 키는 선택적으로 설정할 수 있습니다. 구현체는 필요에 따라 추가 키를 정의할 수 있습니다.
에이전트 메타데이터 키
모든 에이전트 메타데이터는 ERC-8048의 키값 저장소 인터페이스로 온체인에 저장됩니다. 레지스트리는 ERC-8048을 구현하고 setMetadata 함수를 노출해야 하며, 호출자가 해당 agentId의 소유자, 승인된 지출자, 또는 오퍼레이터가 아니면 되돌려야 합니다. 상호운용성을 위해 name, ens_name, image, description, service_type, service, agent_account 키가 권장됩니다. 모든 메타데이터 값은 bytes로 저장되며 타입이 명시되지 않으면 UTF-8 문자열을 인코딩한 값이어야 합니다.
URI 치환과 IPFS, 추가 서비스
image, service 같은 메타데이터의 URI 필드는 {id} 플레이스홀더를 포함할 수 있으며 클라이언트는 이를 토큰 ID로 치환해 해석해야 합니다. 예를 들어 service URI가 https://api.example.com/agents/{id}이고 토큰 ID가 12345이면 https://api.example.com/agents/12345로 해석됩니다. URI는 IPFS 프로토콜을 사용할 수 있고 ipfs://<CID> 형식이 권장됩니다. 추가 서비스는 ERC-8119의 파라미터화된 저장 키를 사용해 service_type:1, service:1처럼 번호를 붙여 저장할 수 있습니다.
등록 절차와 이벤트
새 에이전트는 인터페이스에 정의된 등록 함수 중 하나를 호출해 발행됩니다. 등록 시 레지스트리는 고유한 새 agentId를 부여하고, 전달된 owner를 _owners 매핑에 설정하며, 그 owner는 해당 agentId에 대해 balance 1을 받습니다. 이 과정에서 ERC-6909의 Transfer 이벤트(address(0)에서 owner로), 메타데이터 항목마다 ERC-8048의 MetadataSet 이벤트, 그리고 Registered 이벤트가 발생합니다. service_type, service, agent_account 중 설정되지 않은 값이 있으면 이벤트 발행 시 기본값으로 설정되어야 합니다.
제안 상태
이 ERC는 현재 Draft 상태로, 아직 바뀌거나 멈출 수 있는 제안입니다.