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가 넘어가면 통제권도 자동으로 따라가게 합니다.
구현해야 하는 것
event AgentBound( uint256 indexed agentId, Standard indexed standard, address indexed boundAddress, uint256 tokenId, address registeredBy );: 바인딩이 처음 기록될 때 에이전트 id, 통제 방식(Standard), 바운드 주소, 토큰 id, 등록을 일으킨 주소를 기록하는 이벤트입니다.function bindingOf(uint256 agentId) external view returns (Binding memory);: 특정 에이전트 id에 대해 저장된 바인딩(통제 방식, 바운드 주소, 토큰 id)을 돌려줍니다.function bindingHashOf(uint256 agentId) external view returns (bytes32);: 바인딩을 32바이트 전역 고유 식별자(UBID)로 변환해 돌려줍니다.
심층 설명
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로, 아직 바뀌거나 멈출 수 있는 제안입니다.
쓸 때 주의할 점
- 인터페이스 변경사항 확인: tokenContract가 boundAddress로, TokenStandard가 Standard로 이름이 바뀌었고 값이 3개에서 8개로 늘었습니다. 인코딩 자체는 그대로지만 이름으로 참조하는 코드는 고쳐야 하며 bindingHashOf 유무로 업데이트된 배포인지 구분할 수 있습니다.
- 인식하지 못하는 Standard 값 주의: 기존 표준 값으로 색인하던 인덱서는 AgentBound 이벤트 시그니처와 토픽이 그대로라 계속 정상 동작하지만 새로 추가된 Standard 값은 인식하지 못할 수 있습니다.
- 권한 규칙은 바인딩 계약 코드에 전적으로 의존합니다: 이 표준은 바인딩을 찾고 검증하는 방법만 정하며 바인딩 계약 안의 권한 규칙은 규정하지 않으므로, 신뢰는 전부 그 계약의 코드에 달려 있습니다.