EIP-8016 SSZ 호환 유니언 (SSZ CompatibleUnion)

콜 결정 없음 · 확장성·데이터 · 원문 상태 Draft · 2025-08-28 작성

여러 변형 중 하나를 담는 새 SSZ 타입 CompatibleUnion을 정의합니다. 어떤 변형을 골라도 공통 필드가 머클 트리에서 항상 같은 위치(gindex)를 갖도록 보장합니다.

왜 필요한가

이더리움에는 트랜잭션처럼 한 종류의 데이터가 조금씩 다른 기능을 가진 여러 변형으로 존재하는 경우가 있습니다. 이때도 변형들이 공유하는 공통 필드는 같은 방식으로 증명하고 검증할 수 있는 것이 바람직합니다. 그런데 지금의 SSZ(Simple Serialize)에서는 한 컨테이너의 여러 버전이 동시에 존재하면, 같은 필드라도 버전마다 머클 트리 안의 위치 번호인 일반화 인덱스(gindex)가 달라질 수 있습니다. 그러면 증명을 검증하는 쪽은 버전별로 필드와 gindex의 대응표를 따로 관리해야 하고 새 버전이 나올 때마다 그 표를 갱신해야 합니다. 검증자가 불필요하게 복잡해지고 유지보수 부담이 쌓입니다. CompatibleUnion은 머클화가 서로 호환되는 타입 옵션만 묶도록 제한해서 어떤 옵션이 선택되든 같은 필드가 항상 같은 gindex에 놓이도록 만듭니다. 또 선택자 태그 덕분에 파서가 데이터의 트리 모양을 일찍 알 수 있어 역직렬화가 효율적입니다.

무엇이 바뀌나

지금

EIP-8016 이후

누구에게 영향이 있나

심층 설명

타입 정의와 불법 타입 규칙

CompatibleUnion({selector: type})은 주어진 하위 타입 중 하나를 담는 새 SSZ 복합 타입입니다. 표기는 CompatibleUnion({1: Square, 2: Circle})처럼 선택자 번호와 타입을 짝지어 씁니다. 모든 타입 옵션이 같은 고정 길이를 갖더라도 이 타입은 항상 가변 길이(variable-size)로 취급합니다. 기본값은 정의되지 않으며 오류입니다. 다음은 불법 타입입니다. 타입 옵션이 하나도 없는 CompatibleUnion({}), 선택자가 uint8(1)부터 uint8(127) 범위를 벗어나는 경우, 그리고 어떤 타입 옵션이 다른 옵션과 머클화가 호환되지 않는 경우입니다.

호환 머클화의 판정 규칙

어떤 타입 옵션끼리 묶일 수 있는지는 명시적인 규칙으로 정합니다. 타입은 자기 자신과 호환됩니다. byte와 uint8은 서로 호환됩니다. Bitlist[N]과 Bitvector[N]은 용량 N이 같으면 호환됩니다. List[type, N]과 Vector[type, N]은 원소 타입이 호환되고 N이 같으면 호환됩니다. ProgressiveList[type]은 원소 타입이 호환되면 호환됩니다. Container는 필드 이름과 순서가 같고 모든 필드 타입이 호환되면 호환됩니다. ProgressiveContainer(active_fields)는 양쪽 active_fields의 1 항목이 모두 이름이 같고 타입이 호환되는 필드에 대응하며, 그 밖의 필드 이름이 양쪽에 겹치지 않으면 호환됩니다. CompatibleUnion끼리는 양쪽의 모든 타입 옵션이 서로 호환되면 호환됩니다. 그 외의 모든 타입은 비호환입니다.

직렬화, 역직렬화, JSON 매핑

값에는 담긴 데이터인 value.data와 선택된 타입 옵션을 가리키는 value.selector가 있습니다. 직렬화는 value.selector.to_bytes(1, "little") + serialize(value.data)입니다. 역직렬화는 범위의 첫 바이트를 타입 선택자로 읽고 나머지를 선택된 타입으로 역직렬화합니다. 구현은 네 가지 잘못된 입력을 방어해야 합니다. 범위를 벗어난 선택자, 선택자 1바이트도 없는 불완전한 데이터, 손상되거나 변형된 직렬화 데이터, 그리고 내부 타입의 잘못된 직렬화(내부 타입의 역직렬화에 위임)입니다. JSON으로는 { "selector": string, "data": type } 형태의 객체로 표현하며 data의 내용은 선택자에 따라 달라집니다.

mix_in_selector와 루트 유일성

머클화 명세에 도우미 함수 mix_in_selector가 추가됩니다. 머클 루트 root와 uint8로 직렬화한 선택자 selector를 받아 hash(root, selector)를 반환합니다. 호환 유니언 값의 해시 트리 루트는 mix_in_selector(hash_tree_root(value.data), value.selector)입니다. 이 선택자 혼합은 여러 타입 옵션이 같은 머클 트리 모양을 가질 때, 또는 옵션들이 List[type, N]이나 ProgressiveList[type] 필드의 원소 타입만 다를 때(빈 리스트의 해시 트리 루트는 원소 타입과 무관하기 때문) 서로 다른 유일한 hash_tree_root를 보장합니다. 선택자가 없다면 이런 경우를 불법 타입으로 정의하거나, 서명 루트에 섞거나 원소 타입을 별도 필드에 넣는 식으로 애플리케이션 로직에서 처리해야 합니다.

선택자 범위와 설계 선택의 이유

선택자 0은 불완전한 초기화로 생기는 문제를 막기 위해 예약하며 미래의 EIP에서 선택적 필드(optionality) 표시에 쓰일 가능성이 있습니다. 127 초과(최상위 비트가 1인 값)는 앞으로의 하위 호환 확장을 위해 예약합니다. 1부터 127까지의 범위면 현재 수요에 충분합니다. 대안으로 active_fields 비트벡터를 그대로 내보내는 필드 컬렉션 설계도 검토됐지만 ProgressiveContainer가 중첩되면 파서가 전체 트리 모양을 바로 알 수 없어 파싱이 매우 비효율적이고 비트벡터 때문에 모든 중첩 계층이 가변 길이가 되어 직렬화 형식에 큰 오버헤드가 생깁니다. CompatibleUnion은 태그를 내보내 파서가 중첩 필드까지 무엇을 기대할지 일찍 알게 합니다. 한편 기존 필드를 CompatibleUnion으로 감싸는 것은 하위 호환 변경이 아닙니다. 다만 새 옵션 추가와 기존 옵션 제거는 검증자를 깨지 않으므로, 확장이 예상되는 곳에는 타입 옵션이 하나뿐이어도 처음부터 CompatibleUnion을 도입해야 합니다.

기존 유니언 제안과의 관계

CompatibleUnion은 SSZ 명세에 있던 이전 유니언 제안의 대안입니다. 이전 제안은 폐기된 샤딩 명세에서만 사용됐습니다. 포털 네트워크도 네트워크 타입에 유니언 개념을 쓰지만 거기에 hash_tree_root를 적용하지 않으므로, 새 네트워킹 버전에서 이 호환 유니언 제안으로 전환할 수 있습니다. 테스트는 ethereum/remerkleable의 test_impl.py와 test_typing.py에 정적 테스트가 있고 ethereum/consensus-specs 릴리스의 tests/general/phase0/ssz_generic에 무작위 테스트가 포함됩니다. 참조 구현은 ethereum/remerkleable입니다.

현재 상태: Draft

이 EIP는 2025년 8월 28일에 만들어졌고 현재 상태는 Draft입니다. 명세가 아직 확정되지 않았으므로 선택자 범위, 호환 규칙, JSON 매핑 등 세부 내용이 바뀔 수 있습니다. 제공된 코어 개발자 콜 기록에는 이 EIP에 대한 포크 포함 결정이 없습니다.

EIP 원문 · ← EIPs