ERC-7604 ERC-1155 퍼밋 승인 (ERC-1155 Permit Approvals)

Draft · NFT·멀티토큰 · 2024-01-27 작성

소유자가 트랜잭션 대신 서명 한 장으로 ERC-1155 토큰의 특정 ID와 수량에 대한 승인을 만들 수 있게 합니다. ERC-20의 퍼밋(permit) 방식을 ERC-1155로 확장한 표준입니다.

왜 필요한가

ERC-1155 토큰을 다른 주소나 컨트랙트가 대신 옮기게 하려면 소유자가 먼저 승인(approval) 트랜잭션을 보내야 합니다. 승인과 실제 사용이 두 번의 트랜잭션으로 나뉘고 소유자에게는 가스비를 낼 ETH도 있어야 합니다. ERC-20에는 ERC-2612, ERC-721에는 ERC-4494라는 퍼밋 방식이 있어 서명 한 장으로 승인을 만들 수 있지만 두 방식은 각자의 토큰 표준에만 적용됩니다. ERC-1155는 하나의 컨트랙트가 여러 토큰 ID와 수량(balance)을 함께 다루는 구조라 기존 퍼밋을 그대로 쓸 수 없습니다. 게다가 ERC-1155에는 수량 단위 승인이 원래 없어서 승인을 하면 해당 토큰 ID의 잔액 전체에 대한 권한을 주게 됩니다. 이 표준은 수량 단위 승인을 정의한 ERC-5216과 EIP-712 서명을 묶어서 이 공백을 메웁니다.

구현해야 하는 것

심층 설명

세 가지 필수 함수

이 표준은 ERC-1155와 ERC-5216 위에 permit, nonces, DOMAIN_SEPARATOR 세 함수를 추가합니다. permit은 서명 기반 승인의 진입점입니다. nonces는 owner와 tokenId 조합별 논스를 조회하고 DOMAIN_SEPARATOR는 EIP-712 도메인 구분값을 반환합니다. ERC-2612(value만 다룸)나 ERC-4494(tokenId만 다룸)와 달리 tokenId와 value를 모두 서명에 포함하는 점이 핵심 차이입니다.

permit이 성립하는 조건

permit(owner, spender, tokenId, value, deadline, sig) 호출은 다음 조건이 모두 맞을 때에만 allowance(owner, spender, tokenId)를 value로 설정하고 nonces(owner, tokenId)를 1 올리며 ERC-5216이 정의한 Approval 이벤트를 내야 합니다. 조건은 네 가지입니다. 현재 블록 시간이 deadline 이하여야 하고 owner가 제로 주소가 아니어야 합니다. 상태 갱신 전의 nonces[owner][tokenId]가 서명에 담긴 nonce와 같아야 하며 sig가 owner의 유효한 secp256k1, ERC-2098, 또는 ERC-1271 서명이어야 합니다. 하나라도 어긋나면 반드시 되돌려야 합니다. 서명자가 제로 주소가 아닌지도 반드시 확인해야 합니다.

EIP-712 서명 구조

서명 대상 메시지는 Permit(address owner,address spender,uint256 tokenId,uint256 value,uint256 nonce,uint256 deadline) 타입 해시와 각 값을 abi.encode한 뒤, hex"1901"과 DOMAIN_SEPARATOR를 앞에 붙여 keccak256으로 해시한 값입니다. DOMAIN_SEPARATOR는 EIP-712에 따라 정의하되 컨트랙트와 체인마다 고유해야 다른 도메인에서 일어나는 리플레이 공격을 막을 수 있습니다. 흔한 선택은 name, version, chainId, verifyingContract를 담은 EIP712Domain 해시입니다.

호출자 제한이 없는 설계

명세 어디에서도 msg.sender를 참조하지 않으므로 permit은 아무 주소나 호출할 수 있습니다. 흔한 사용 사례는 릴레이어가 소유자 대신 퍼밋을 제출하는 것입니다. 이때 릴레이어는 퍼밋을 제출할지 보류할지 선택할 권리를 공짜로 얻는 셈이므로, 걱정된다면 소유자가 deadline을 가까운 미래로 잡아 유효 기간을 제한할 수 있습니다. 반대로 deadline을 uint(-1)로 하면 사실상 만료되지 않는 퍼밋을, value를 uint(-1)로 하면 사실상 무제한 승인을 만들 수 있습니다.

ERC-5216이 필요한 이유

ERC-1155는 수량 단위 승인을 기본으로 지원하지 않습니다. 그대로 퍼밋을 만들면 해당 계정의 tokenId 잔액 전체에 대한 승인이 되어 버립니다. 그래서 이 표준은 수량 단위 승인과 allowance, Approval 이벤트를 정의한 ERC-5216을 필수로 요구합니다. 이 덕분에 퍼밋 하나로 특정 토큰 ID의 특정 수량만 승인할 수 있습니다.

서명을 bytes로 받는 이유

ERC-2612는 서명을 v, r, s 세 컴포넌트로 나누어 받지만 이 표준은 가변 길이 bytes 배열 하나로 받습니다. ERC-2098 서명처럼 r, s, v 컴포넌트(65바이트)로 쉽게 분리하거나 재구성하기 어려운 형식도 지원하기 위해서입니다. ERC-1271 덕분에 컨트랙트 계정의 서명도 검증할 수 있습니다. 또한 이 형식은 알 수 없는 코드에 대한 호출을 피합니다.

ERC-165 인터페이스 등록

이 표준의 ERC-165 인터페이스 ID는 0x7409106d입니다. 구현 컨트랙트는 supportsInterface(0x7409106d) 호출에 true를 반환해야 합니다. ERC-165는 ERC-1155에서 이미 요구되지만 여기서는 어떤 컨트랙트가 이 표준을 구현했는지 다른 쪽에서 쉽게 확인하고 그에 맞게 상호작용할 수 있게 하는 용도로 다시 요구됩니다.

아직 Draft 단계인 제안

이 문서는 2024년 1월 27일에 만들어진 Draft 상태의 제안입니다. 최종 확정 전까지 인터페이스나 세부 규칙이 바뀔 수 있으므로, 구현하거나 통합할 때는 최신 원문을 확인해야 합니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs