ERC-8004 트러스트리스 에이전트 (Trustless Agents)
Draft · 기타 · 2025-08-13 작성
AI 에이전트를 블록체인에 등록해 조직 경계를 넘어 발견하고 선택할 수 있게 하는 표준입니다. 신원, 평판, 검증 세 가지 레지스트리로 사전 신뢰가 없어도 에이전트와 거래할 수 있습니다.
왜 필요한가
AI 에이전트끼리 통신하는 규약으로는 MCP(Model Context Protocol)와 A2A(Agent2Agent)가 있지만, 이 규약들은 에이전트를 어떻게 찾고 어디까지 믿을지는 다루지 않습니다. 서로 모르는 조직의 에이전트에게 일을 맡기려면 그 에이전트가 누구인지, 과거에 일을 잘했는지, 결과가 맞는지 확인할 공통 장치가 필요합니다. 이런 장치가 없으면 에이전트 경제는 이미 서로 아는 조직 사이의 닫힌 거래에 머물게 됩니다. 이 표준은 신원, 평판, 검증이라는 세 가지 가벼운 레지스트리(등록부)를 블록체인에 두어 사전 신뢰 없이도 에이전트를 발견하고 고르고 상호작용할 수 있게 합니다. 신뢰 방식은 골라 쓸 수 있고 단계적으로 설계되어 피자 주문처럼 위험이 낮은 일부터 의료 진단처럼 위험이 높은 일까지 걸린 가치에 비례하는 보안을 적용할 수 있습니다.
구현해야 하는 것
function register(string agentURI, MetadataEntry[] calldata metadata) external returns (uint256 agentId): 등록 파일 URI와 추가 온체인 메타데이터를 함께 지정해 새 에이전트를 발행합니다.function register(string agentURI) external returns (uint256 agentId): 등록 파일 URI만 지정해 새 에이전트를 발행합니다.function register() external returns (uint256 agentId): URI 없이 에이전트를 먼저 발행하고 agentURI는 나중에 setAgentURI()로 추가합니다.event Registered(uint256 indexed agentId, string agentURI, address indexed owner): 에이전트 등록이 완료되면 발생하는 이벤트입니다.function setAgentURI(uint256 agentId, string calldata newURI) external: 에이전트 등록 파일을 가리키는 agentURI를 갱신합니다.event URIUpdated(uint256 indexed agentId, string newURI, address indexed updatedBy): agentURI가 갱신되면 발생하는 이벤트입니다.function getMetadata(uint256 agentId, string memory metadataKey) external view returns (bytes memory): 에이전트의 온체인 메타데이터를 키로 조회합니다.function setMetadata(uint256 agentId, string memory metadataKey, bytes memory metadataValue) external: 에이전트의 온체인 메타데이터를 키-값으로 저장합니다.event MetadataSet(uint256 indexed agentId, string indexed indexedMetadataKey, string metadataKey, bytes metadataValue): 메타데이터가 설정되면 발생하는 이벤트입니다.function setAgentWallet(uint256 agentId, address newWallet, uint256 deadline, bytes calldata signature) external: 새 지갑의 서명(EOA는 EIP-712, 컨트랙트 지갑은 ERC-1271)으로 소유를 증명해 수금용 agentWallet을 변경합니다.function getAgentWallet(uint256 agentId) external view returns (address): 현재 설정된 agentWallet 주소를 조회합니다.function unsetAgentWallet(uint256 agentId) external: 설정된 agentWallet을 해제합니다.function getIdentityRegistry() external view returns (address identityRegistry): 평판·검증 레지스트리가 연결된 신원 레지스트리 주소를 조회합니다.function giveFeedback(uint256 agentId, int128 value, uint8 valueDecimals, string calldata tag1, string calldata tag2, string calldata endpoint, string calldata feedbackURI, bytes32 feedbackHash) external: 임의의 클라이언트 주소가 에이전트에게 고정소수점 값과 선택 태그, 파일 URI로 피드백을 남깁니다.event NewFeedback(uint256 indexed agentId, address indexed clientAddress, uint64 feedbackIndex, int128 value, uint8 valueDecimals, string indexed indexedTag1, string tag1, string tag2, string endpoint, string feedbackURI, bytes32 feedbackHash): 새 피드백이 등록되면 발생하는 이벤트입니다.function revokeFeedback(uint256 agentId, uint64 feedbackIndex) external: 피드백을 남긴 클라이언트가 자신의 피드백을 철회합니다.event FeedbackRevoked(uint256 indexed agentId, address indexed clientAddress, uint64 indexed feedbackIndex): 피드백이 철회되면 발생하는 이벤트입니다.function appendResponse(uint256 agentId, address clientAddress, uint64 feedbackIndex, string calldata responseURI, bytes32 responseHash) external: 누구나 특정 피드백에 응답(예: 환불 증빙, 스팸 표시)을 덧붙입니다.event ResponseAppended(uint256 indexed agentId, address indexed clientAddress, uint64 feedbackIndex, address indexed responder, string responseURI, bytes32 responseHash): 피드백에 응답이 덧붙으면 발생하는 이벤트입니다.function getSummary(uint256 agentId, address[] calldata clientAddresses, string tag1, string tag2) external view returns (uint64 count, int128 summaryValue, uint8 summaryValueDecimals): 지정한 클라이언트 목록과 태그로 걸러 피드백 개수와 요약 값을 집계합니다. clientAddresses는 비워 둘 수 없습니다.function readFeedback(uint256 agentId, address clientAddress, uint64 feedbackIndex) external view returns (int128 value, uint8 valueDecimals, string tag1, string tag2, bool isRevoked): 특정 클라이언트가 남긴 특정 피드백 하나를 읽습니다.function readAllFeedback(uint256 agentId, address[] calldata clientAddresses, string tag1, string tag2, bool includeRevoked) external view returns (address[] memory clients, uint64[] memory feedbackIndexes, int128[] memory values, uint8[] memory valueDecimals, string[] memory tag1s, string[] memory tag2s, bool[] memory revokedStatuses): 필터 조건에 맞는 피드백 전체를 배열로 읽습니다. 철회된 피드백은 기본적으로 제외됩니다.function getResponseCount(uint256 agentId, address clientAddress, uint64 feedbackIndex, address[] responders) external view returns (uint64 count): 피드백에 덧붙은 응답 개수를 조회합니다. agentId 외 인자는 선택 필터입니다.function getClients(uint256 agentId) external view returns (address[] memory): 해당 에이전트에 피드백을 남긴 클라이언트 주소 목록을 조회합니다.function getLastIndex(uint256 agentId, address clientAddress) external view returns (uint64): 특정 클라이언트가 해당 에이전트에 남긴 마지막 피드백 인덱스를 조회합니다.function validationRequest(address validatorAddress, uint256 agentId, string requestURI, bytes32 requestHash) external: 에이전트 소유자나 오퍼레이터가 지정한 검증자에게 작업 검증을 요청합니다.event ValidationRequest(address indexed validatorAddress, uint256 indexed agentId, string requestURI, bytes32 indexed requestHash): 검증 요청이 등록되면 발생하는 이벤트입니다.function validationResponse(bytes32 requestHash, uint8 response, string responseURI, bytes32 responseHash, string tag) external: 요청에 지정된 검증자가 0~100 점수로 검증 결과를 기록합니다. 같은 요청에 여러 번 호출할 수 있습니다.event ValidationResponse(address indexed validatorAddress, uint256 indexed agentId, bytes32 indexed requestHash, uint8 response, string responseURI, bytes32 responseHash, string tag): 검증 응답이 기록되면 발생하는 이벤트입니다.function getValidationStatus(bytes32 requestHash) external view returns (address validatorAddress, uint256 agentId, uint8 response, bytes32 responseHash, string tag, uint256 lastUpdate): 특정 검증 요청의 현재 상태를 조회합니다.function getSummary(uint256 agentId, address[] calldata validatorAddresses, string tag) external view returns (uint64 count, uint8 averageResponse): 에이전트의 검증 통계(건수와 평균 점수)를 집계합니다. 검증자 목록과 태그는 선택 필터입니다.function getAgentValidations(uint256 agentId) external view returns (bytes32[] memory requestHashes): 에이전트에 대한 검증 요청 해시 목록을 조회합니다.function getValidatorRequests(address validatorAddress) external view returns (bytes32[] memory requestHashes): 특정 검증자에게 들어온 검증 요청 해시 목록을 조회합니다.
심층 설명
신원 레지스트리: ERC-721 기반 에이전트 신원
신원 레지스트리는 ERC-721에 URIStorage 확장을 더해 에이전트를 등록합니다. 원문은 ERC-721의 tokenId를 agentId, tokenURI를 agentURI라고 부릅니다. 에이전트의 전역 식별자는 agentRegistry 문자열 {namespace}:{chainId}:{identityRegistry}(예: eip155:1:0x742...)와 레지스트리가 증가 방식으로 부여하는 agentId의 조합입니다. 토큰 소유자가 에이전트의 소유자이며 소유권을 이전하거나 등록 파일 갱신 같은 관리를 오퍼레이터에게 위임할 수 있습니다. register()는 세 가지 오버로드가 있고 등록 시 Transfer 이벤트 하나, 예약 키 agentWallet에 대한 MetadataSet 이벤트 하나, 추가 메타데이터별 MetadataSet 이벤트, 그리고 Registered 이벤트가 발생합니다. ERC-721 기반이므로 모든 에이전트를 NFT 호환 앱에서 바로 조회하고 이전할 수 있습니다.
등록 파일 구조와 도메인 검증
agentURI는 반드시 등록 파일로 연결되어야 하며 ipfs://, https://, base64 인코딩 data: URI 등 어떤 URI 방식도 쓸 수 있습니다. 파일 상단의 type, name, description, image 필드는 ERC-721 앱과의 호환을 위한 것입니다. services 목록에는 web, A2A 에이전트 카드, MCP 엔드포인트, OASF, ENS 이름, DID, 이메일 등 엔드포인트를 원하는 만큼 추가할 수 있고 version 필드는 권장 사항입니다. registrations에는 agentId와 agentRegistry가 들어가며 등록 항목의 모든 필드가 필수입니다. supportedTrust는 선택 필드로, 없거나 비어 있으면 이 표준은 신뢰가 아니라 발견 용도로만 쓰입니다. 엔드포인트가 소유자의 것이 아닌 도메인을 가리킬 수 있으므로, 해당 도메인의 /.well-known/agent-registration.json에 온체인 에이전트와 일치하는 registrations 항목을 올려 도메인 통제를 증명할 수 있습니다.
온체인 메타데이터와 agentWallet
레지스트리는 getMetadata(uint256 agentId, string metadataKey)와 setMetadata(uint256 agentId, string metadataKey, bytes metadataValue)로 선택적 온체인 메타데이터를 지원합니다. 키 agentWallet은 예약되어 있어 setMetadata()나 register()의 메타데이터 배열로는 설정할 수 없습니다. 이 키는 에이전트가 대금을 받는 주소를 뜻하며 처음에는 소유자 주소로 설정됩니다. 변경하려면 setAgentWallet(agentId, newWallet, deadline, signature)를 호출하면서 새 지갑에 대한 유효한 서명(EOA는 EIP-712, 컨트랙트 지갑은 ERC-1271)으로 통제권을 증명해야 합니다. 에이전트가 이전되면 agentWallet은 자동으로 해제되어 사실상 0 주소로 초기화되고 새 소유자가 다시 검증해야 합니다.
평판 레지스트리: 피드백 쓰기
어떤 clientAddress든 giveFeedback()으로 피드백을 남길 수 있습니다. 값은 부호 있는 고정소수점 value(int128)와 valueDecimals(uint8, 0~18)로 표현하며 예를 들어 업타임 99.77%는 value 9977에 valueDecimals 2로 적습니다. 제출자는 해당 agentId의 소유자나 승인된 오퍼레이터여서는 안 됩니다. tag1, tag2, endpoint, feedbackURI, feedbackHash는 선택이며 feedbackHash는 feedbackURI가 가리키는 내용의 KECCAK-256 해시로 무결성을 보장합니다. IPFS처럼 내용 주소 방식 URI면 해시를 생략해도 됩니다. 컨트랙트에는 value, valueDecimals, tag1, tag2, isRevoked가 클라이언트별 1부터 세는 feedbackIndex와 함께 저장되고 endpoint·feedbackURI·feedbackHash는 이벤트로만 발행되고 저장되지는 않습니다. 피드백은 revokeFeedback()으로 철회할 수 있고 누구나 appendResponse()로 환불 증빙이나 스팸 표시 같은 응답을 덧붙일 수 있습니다.
평판 읽기와 집계의 역할 분담
getSummary()는 agentId와 clientAddresses가 필수이며, clientAddresses를 비워 둘 수 없습니다. 클라이언트로 거르지 않은 집계 결과는 사이빌·스팸 공격에 노출되기 때문입니다. readAllFeedback()은 agentId만 필수이고 나머지는 선택 필터이며 철회된 피드백은 기본적으로 제외합니다. getClients()와 getLastIndex()로 피드백을 남긴 주소 목록과 마지막 인덱스를 조회할 수 있습니다. 리뷰어와 태그 기준의 단순 필터링은 온체인에서 지원하지만 더 복잡한 평판 집계는 오프체인에서 이루어질 것으로 원문은 설명합니다. 피드백을 남기는 쪽이 에이전트라면 평판 집계를 쉽게 하기 위해 온체인 agentWallet 메타데이터에 설정된 주소를 clientAddress로 쓰는 것이 권장됩니다.
검증 레지스트리: 요청과 응답
에이전트의 소유자나 오퍼레이터가 validationRequest()로 검증을 요청합니다. requestURI는 검증에 필요한 입력과 출력을 모두 담은 오프체인 자료를 가리키고 requestHash는 그 자료의 keccak256 커밋이면서 요청의 식별자가 됩니다. 응답은 요청에 지정된 validatorAddress만 validationResponse()로 남길 수 있습니다. response는 0~100 값으로, 0은 실패 100은 통과인 이진 판정으로 쓰거나 중간값으로 스펙트럼 판정을 표현할 수 있습니다. 같은 requestHash에 여러 번 응답할 수 있어 tag를 활용한 소프트 파이널리티와 하드 파이널리티 같은 단계적 검증 상태나 상태 갱신이 가능합니다. 컨트랙트는 requestHash, validatorAddress, agentId, response, responseHash, lastUpdate, tag를 저장해 온체인 조회와 조합이 가능합니다. 검증자는 예를 들어 스테이크로 보증된 재실행, zkML 검증기, TEE 오라클, 신뢰받는 심판 등을 쓸 수 있고 보상과 슬래싱은 개별 검증 프로토콜의 몫입니다.
설계 배경, 배포 방식, 제안 상태
원문 Rationale에 따르면 이 표준은 MCP와 A2A 외에 새로운 통신 규약이 나올 수 있다는 점을 고려해 블록체인에서 유연한 등록 파일로 연결하고 거기에 엔드포인트를 자유롭게 추가하는 구조를 택했습니다. 클라이언트는 등록할 필요가 없으므로 EIP-7702를 활용해 마찰 없는 피드백을 구현할 수 있고 피드백이 온체인에 남고 전체 자료는 IPFS 사용이 권장되므로 서브그래프로 인덱서를 만들기 쉽습니다. 레지스트리는 체인별 싱글턴으로 배포될 것으로 예상되며 한 체인에 등록된 에이전트가 다른 체인에서 활동할 수도 있고 여러 체인에 중복 등록할 수도 있습니다. 결제는 이 프로토콜과 별개 사안으로 표준에 포함되지 않습니다. 이 제안은 아직 Draft(초안) 상태라 내용이 바뀔 수 있습니다.
쓸 때 주의할 점
- 사이빌 공격 가능성: 가짜 에이전트의 평판을 부풀리는 사이빌 공격이 가능합니다. 이 프로토콜의 기여는 신호를 공개하고 같은 스키마를 쓰게 하는 것이며 리뷰어를 신뢰 기준으로 삼아 리뷰어별로 필터링하는 평판 시스템이 여럿 등장할 것으로 원문은 기대합니다.
- 온체인 기록은 삭제 불가: 온체인에 올라간 포인터와 해시는 삭제할 수 없으며 이는 감사 추적의 무결성을 보장합니다.
- 검증자 보상과 슬래싱은 범위 밖: 검증자에 대한 보상과 슬래싱은 개별 검증 프로토콜이 관리하며 이 표준의 범위에 들지 않습니다.
- 기능의 실제 동작은 보장하지 않음: 이 표준은 등록 파일이 온체인 에이전트와 대응함은 암호학적으로 보장하지만 광고된 기능이 실제로 동작하고 악의적이지 않다는 것까지 보장하지는 못합니다. 평판, 검증, TEE 증명이라는 세 가지 신뢰 모델이 이 검증 수요를 지원하도록 설계되었습니다.