ERC-8041 고정공급 에이전트 NFT 컬렉션 (Fixed-Supply Agent NFT Collections)
Draft · NFT·멀티토큰 · 2025-10-11 작성
ERC-8004 에이전트 레지스트리는 등록이 무제한이지만, 이 표준은 발행 상한과 시작 블록을 둔 고정 수량 컬렉션을 만들고 각 에이전트의 민팅 순번을 영구히 기록하게 합니다.
왜 필요한가
ERC-8004 에이전트 레지스트리는 누구나 자유롭게 에이전트를 등록할 수 있는 무제한 민팅 구조입니다. 그런데 'Genesis 100'처럼 수량이 정해진 한정판 컬렉션을 만들거나, 한 에이전트가 'dev-team'처럼 이름이 다른 여러 컬렉션에 동시에 속하게 하거나, 몇 번째로 민팅됐는지(예 5 of 1000)를 영구히 남기거나, 특정 블록부터만 민팅을 열거나, 발행자가 민팅을 직접 통제하는 큐레이션형 드롭을 진행할 표준 방법이 없었습니다. 그 결과 프로젝트마다 컬렉션과 순번을 제각각의 방식으로 구현해야 했고, 지갑이나 마켓플레이스는 이를 일관되게 읽어내거나 검증할 수 없었습니다.
구현해야 하는 것
event CollectionUpdated(uint256 maxSupply, uint256 startBlock, bool open);: 컬렉션이 생성되거나 maxSupply, startBlock, open 값이 바뀔 때마다 발생합니다.event AgentMinted(uint256 indexed agentId, uint256 mintNumber, address indexed owner);: 에이전트가 컬렉션에 추가(민팅)될 때 발생하며 민팅 번호와 수령자를 알립니다.function getAgentMintNumber(uint256 agentId) external view returns (uint256 mintNumber);: 해당 에이전트가 이 컬렉션에서 몇 번째로 민팅됐는지 반환하며, 컬렉션에 속하지 않으면 0을 반환합니다.function getCollectionSupply() external view returns (uint256 currentSupply);: 현재까지 이 컬렉션에서 민팅된 수량을 반환합니다.function contractURI() external view returns (string memory);: ERC-7572 형식의 컬렉션 메타데이터(이름, 설명, 이미지 등) URI를 반환합니다. 구현은 선택입니다.
심층 설명
컬렉션이 갖춰야 하는 네 가지 속성
모든 준수 컬렉션 컨트랙트는 maxSupply(컬렉션 내 최대 에이전트 수), currentSupply(현재까지 민팅된 수), startBlock(민팅이 가능해지는 블록 번호), open(현재 민팅을 받는지 여부)을 유지해야 합니다. 이 네 값은 CollectionUpdated 이벤트를 통해 생성 시점과 변경 시점마다 외부에 알려집니다.
에이전트 민팅 시 반드시 거쳐야 하는 절차
컬렉션 컨트랙트를 통해 에이전트를 민팅할 때는 ERC-8004 레지스트리에 에이전트를 등록하고 1부터 시작하는 순차 민팅 번호를 부여하고 그 번호를 내부에 저장하고 컬렉션을 식별하는 키로 에이전트의 온체인 메타데이터를 기록하고 AgentMinted 이벤트를 발행해야 합니다.
기본 키와 ERC-8119 파라미터 키
대표 컬렉션은 파라미터가 없는 agent-collection 키를 쓰며 인덱싱 없이도 바로 찾을 수 있습니다. 추가 컬렉션은 ERC-8119 파라미터 키 형식인 agent-collection:label, agent-collection/label, agent-collection[label] 중 하나를 써서 구분합니다. 레이블은 임의 값이라 기본 키 이외의 컬렉션을 찾으려면 에이전트의 메타데이터 키를 인덱싱해야 합니다. 한 컨트랙트는 자신의 모든 민팅에 하나의 키만 일관되게 써야 합니다.
컬렉션 메타데이터 인코딩 형식
메타데이터는 abi.encodePacked로 컬렉션 컨트랙트 주소(20바이트), 민팅 번호 바이트 길이(1바이트), 민팅 번호 값(가변 길이)을 이어붙인 형태를 권장합니다(SHOULD). 이를 통해 누구나 에이전트가 속한 컬렉션 주소를 확인하고 민팅 번호를 디코딩하고 컬렉션 컨트랙트에서 추가 정보를 조회할 수 있습니다.
민팅 번호 규칙
민팅 번호는 0이 아닌 1부터 시작해야 하고 에이전트가 추가될 때마다 순차적으로 증가해야 하며 한번 부여되면 영구히 바뀌지 않아야 하고 getAgentMintNumber()로 조회 가능해야 합니다.
공급량 관리 의무
컬렉션 컨트랙트는 maxSupply를 넘는 민팅을 막아야 하고 currentSupply를 정확히 추적해야 하며 성공한 민팅마다 AgentMinted를 발행해야 하고 startBlock 이전에는 민팅을 허용하지 않아야 합니다.
구현에 맡겨진 선택 사항
누가 민팅할 수 있는지(소유자, 공개, 허용목록 등)의 접근 제어, 무료/유료 등의 결제 모델, 개폐나 잠금 같은 컬렉션 상태 관리, 단건/배치 민팅 여부는 표준이 강제하지 않고 구현마다 선택합니다. 다만 컬렉션 단위의 이름·설명·이미지 등을 제공하려면 ERC-7572의 contractURI() 함수를 구현하는 것을 권장합니다(SHOULD).
제안 상태
이 표준은 2025-10-11에 작성되어 현재 Draft 상태이며, 아직 공식 채택 전이라 세부 내용이 바뀌거나 중단될 수 있습니다.
쓸 때 주의할 점
- 컬렉션 메타데이터는 소유자가 임의로 바꿀 수 있습니다: ERC-8004 에이전트 소유자는 자신의 agent-collection 또는 agent-collection:label 메타데이터를 언제든 수정하거나 지울 수 있습니다. 그래서 클라이언트는 이 메타데이터만으로 컬렉션 소속을 확정해서는 안 됩니다(MUST NOT).
- 항상 컬렉션 컨트랙트에 직접 질의해야 합니다: 클라이언트는 메타데이터를 어느 컬렉션을 조회할지 찾는 단서로만 쓰고, 실제 소속 여부는 반드시 getAgentMintNumber(agentId)를 컬렉션 컨트랙트에 직접 호출해 검증해야 합니다(SHOULD). 레이블이 붙은 컬렉션을 찾으려면 에이전트의 메타데이터 키를 인덱싱해야 합니다.
- 민팅 번호 0은 비소속의 확정적 증거입니다: 컬렉션 컨트랙트가 반환하는 민팅 번호가 0이면 해당 에이전트가 그 컬렉션에 속하지 않는다는 확실한 증거로 취급해야 합니다.