ERC-8217 에이전트 NFT 신원 결속 (Agent NFT Identity Bindings)

Draft · NFT·멀티토큰 · 2026-04-05 작성

이 표준은 ERC-8004 에이전트 등록을 NFT나 계정 같은 외부 객체에 연결해 NFT를 가진 사람이 그 에이전트 신원도 함께 소유하고 이전할 수 있게 합니다.

왜 필요한가

ERC-8004 등록 자체가 NFT입니다. 프로젝트나 캐릭터, 컬렉션 같은 기존 NFT(마스터 NFT)가 에이전트 등록을 소유하게 하려면 두 NFT를 서로 연결해야 합니다. 이런 연결이 없으면 마스터 NFT를 다른 사람에게 넘겨도 ERC-8004 신원은 따라가지 않고 원래 소유자에게 남습니다. 즉 캐릭터나 컬렉션을 거래해도 그 에이전트 자격이나 평판 기록은 분리된 채로 남아 새 소유자가 통제할 수 없는 문제가 생깁니다. 이 표준은 어떤 마스터 NFT가 어떤 에이전트 id를 통제하는지 체인마다 하나뿐인 표준 계약에 기록해 마스터 NFT가 넘어가면 통제권도 자동으로 따라가게 합니다.

구현해야 하는 것

심층 설명

IERC8217 인터페이스와 Standard 열거형

바인딩 계약은 Binding 구조체(standard, boundAddress, tokenId)를 agentId별로 저장하고 bindingOf로 돌려줍니다. Standard는 ERC721, ERC1155, ERC6909, ERC1155F, ERC6909F, ACCOUNT, CONTRACT_OWNABLE, CONTRACT_ADMIN 여덟 값을 가지며 바인딩 해시의 일부이므로 기존 값을 재번호·재배열·삭제할 수 없습니다. ACCOUNT, CONTRACT_OWNABLE, CONTRACT_ADMIN은 토큰이 아니라 주소 자체에 묶이므로 tokenId는 쓰이지 않고 반드시 0이어야 합니다. tokenId가 해시에 포함되므로 0이 아닌 값을 쓰면 같은 바운드 주소가 서로 다른 식별자를 여러 개 갖게 됩니다.

메타데이터 레코드 형식

바인딩은 ERC-8004 온체인 메타데이터 레코드로 저장됩니다. 키는 반드시 agent-binding이고 값은 그 체인의 표준 바인딩 계약 주소를 정확히 20바이트로 담아야 합니다. abi.encode가 아니라 abi.encodePacked로 패딩 없이 저장하므로 32바이트가 아니라 20바이트입니다. agent-binding은 예약된 키로 취급되어 신뢰할 수 없는 호출자가 덮어쓰지 못하도록 해야 합니다.

배포 모델: 체인당 하나의 싱글톤

이 표준을 따르는 바인딩 계약은 체인마다 단 하나의 표준 싱글톤으로만 배포되어야 합니다. standard, boundAddress, tokenId는 반드시 이 계약의 bindingOf를 통해서만 얻어야 합니다.

바인딩 불변성

특정 agentId에 대해 agent-binding이 한 번 기록되면 저장된 바인딩 계약 주소와 bindingOf(agentId)가 돌려주는 Binding 값은 이후 변하지 않아야 합니다. 이 덕분에 클라이언트와 인덱서는 한 번 검증한 바인딩 결과를 캐시 무효화 없이 계속 신뢰해 사용할 수 있습니다.

bindingHashOf와 UBID 계산

bindingHashOf(agentId)는 keccak256(ABI_ENCODE(bytes bindingContractInteroperableAddress, uint8 standard, address boundAddress, uint256 tokenId))를 돌려줍니다. 네 값은 (bytes,uint8,address,uint256) 튜플로 abi.encode 방식(패킹 인코딩 금지)으로 인코딩된 뒤 keccak256으로 해시됩니다. bindingContractInteroperableAddress는 바인딩 계약이 위치한 체인에서의 완전한 ERC-7930 Interoperable Address여야 하며 미리 해시해서는 안 됩니다. 이 해시는 네 값만의 순수 함수이므로 오프체인에서도 계산할 수 있고 Universal Binding Identifier(UBID)라고도 부릅니다.

여러 Standard가 필요한 이유

ERC-8004 에이전트 신원을 통제하는 방식은 여러 형태를 띠고 각 Standard 값은 서로 다른 권한 규칙을 가리킵니다. 같은 주소라도 여러 규칙을 동시에 만족할 수 있어 바운드 주소만으로는 어떤 규칙이 적용되는지 알 수 없으므로, Standard가 그 선택을 명시적으로 기록합니다.

바인딩 해시가 필요한 이유

많은 경우 바운드 객체(예: NFT 컬렉션)가 에이전트의 1차 신원이고 ERC-8004 등록은 그에 부수적입니다. 바인딩 해시의 원문에는 에이전트 id나 레지스트리 주소가 들어가지 않으므로, 하나의 바운드 객체는 거기 묶인 등록이 몇 개든 하나의 식별자를 유지합니다. Binding 자체는 발견(주소와 토큰 id 찾기)에 유용하지만 식별자로는 32바이트 단일 값인 bindingHashOf가 더 유용해 평판 시스템 등이 개별 등록 대신 이 값을 키로 쓸 수 있습니다. 권한 규칙(standard)도 식별 대상의 일부이므로 해시에 포함되어 같은 주소라도 ACCOUNT와 CONTRACT_OWNABLE로 묶이면 서로 다른 식별자를 받습니다.

최근 인터페이스 변경과 초안 상태

이 표준은 최근 네 가지가 바뀌었습니다. Binding 구조체와 AgentBound 이벤트의 tokenContract가 boundAddress로 이름이 바뀌었고 TokenStandard가 Standard로 이름이 바뀌며 값이 3개에서 8개로 늘었고 bindingHashOf 함수와 UnknownAgent 에러가 새로 추가되었습니다. 현재 상태는 Draft로, 아직 바뀌거나 멈출 수 있는 제안입니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs