ERC-8074 EIP-712 셀렉터 기반 자기서술 바이트 (Self-Describing Bytes via EIP-712 Selectors)

Draft · 기타 · 2025-10-30 작성

컨트랙트의 bytes 매개변수에 담긴 데이터가 어떤 구조체인지 EIP-712 타입 문자열에서 뽑은 4바이트 셀렉터로 표시해, 여러 컨트랙트가 같은 페이로드를 일관되게 식별하고 해석할 수 있게 합니다.

왜 필요한가

ERC-721이나 ERC-1155 같은 표준은 확장을 위해 bytes라는 빈 매개변수를 함수에 두지만, 그 안에 어떤 데이터가 들어있는지 알려주는 공통된 방법이 없습니다. 그래서 컨트랙트마다 제각각의 방식으로 데이터를 구분하고, 하나의 컨트랙트가 여러 종류의 페이로드를 받아야 하면 그때그때 임시 규칙을 만들어야 합니다. 또 데이터가 여러 컨트랙트를 거쳐 전달되는 흐름이 복잡해지면 각 컨트랙트가 같은 bytes를 서로 다르게 해석해야 할 수도 있어 혼란이 생깁니다. 결국 표준화된 식별 규약이 없으면 상호운용성이 떨어지고, 매번 새로운 파싱 규칙을 약속해야 하는 번거로움이 남습니다.

심층 설명

타입 셀렉터 정의

타입 셀렉터는 EIP-712 타입 문자열을 keccak256으로 해시한 값의 앞 4바이트입니다. 공식은 typeSelector(T) = bytes4(keccak256(bytes(T)))입니다. 예를 들어 TransferNote(bytes32 reference,string comment,uint256 deadline)이라는 타입 문자열의 keccak256 값 앞 4바이트는 0xf91f3a24가 됩니다. 이는 솔리디티가 함수 호출을 식별할 때 쓰는 함수 셀렉터 방식과 같은 원리입니다.

단일 페이로드 인코딩 구조

하나의 구조체를 담는 페이로드는 타입 셀렉터 뒤에 그 구조체 필드들을 abi.encode한 결과를 이어붙여 만듭니다. encoding = typeSelector(T) ++ abi.encode(<fields of T>) 형태입니다. 예시에서는 0xf91f3a24 ++ abi.encode(reference, comment, deadline)로 인코딩됩니다. 이 데이터를 받는 쪽은 앞 4바이트만 보고 알고 있는 셀렉터인지 먼저 판단한 뒤 나머지를 디코딩할 수 있습니다.

DataList 멀티 페이로드 래퍼

여러 개의 타입 지정 페이로드를 하나의 bytes에 함께 담아야 할 때는 공용 래퍼 타입 DataList(bytes[] items)를 씁니다. 이 타입의 셀렉터는 0xae74f986로 고정되어 있고, encoding = 0xae74f986 ++ abi.encode(items) 형태입니다. items 배열의 각 원소(items[i])는 반드시 자기 자신의 셀렉터를 가진 유효한 단일 페이로드여야 합니다(MUST).

디코딩 절차

디코딩은 먼저 bytes의 앞 4바이트를 셀렉터로 읽는 것으로 시작합니다. 셀렉터가 0xae74f986이면 나머지를 (bytes[] items)로 디코딩하고 각 항목을 재귀적으로 다시 파싱합니다. 다른 알려진 셀렉터라면 그에 맞게 나머지를 해석하고, 모르는 셀렉터는 반드시 무시해야 합니다(MUST NOT 처리 불가 시 에러가 아니라 무시). 페이로드들 사이의 순서는 의미가 없고, 만든 쪽은 중복된 항목을 넣지 않는 것이 권장됩니다(SHOULD).

기존 표준과의 호환성

ERC-721, ERC-1155처럼 확장을 위해 bytes 매개변수를 쓰는 표준, 그리고 bytes 데이터 전달 관행을 더 다진 ERC-5750과 함께 쓸 수 있도록 설계되었습니다. 이 ERC를 모르는 기존 컨트랙트는 해당 bytes를 그냥 의미 없는 데이터로 취급하면 되므로 하위 호환성이 깨지지 않습니다.

설계 근거

새로운 스키마 문법을 만드는 대신 이미 서명 생태계에서 쓰이는 EIP-712 타입 문자열을 재사용해 정합성을 맞췄습니다. 4바이트 셀렉터를 쓴 이유는 솔리디티의 함수 셀렉터 관행을 그대로 따라 간결하게 만들기 위해서입니다. DataList 래퍼는 특별한 파싱 규칙이나 새로운 ABI 규격을 추가하지 않으면서도 여러 페이로드를 하나의 bytes에 담는 멀티플렉싱을 가능하게 합니다.

표준 상태

이 ERC는 현재 Draft 상태입니다. 아직 확정되지 않은 초기 제안 단계이므로, 앞으로 사양이 바뀌거나 논의가 멈출 수 있다는 점을 염두에 두어야 합니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs