EIP-7834 EOF 전용 메타데이터 섹션 (Separate Metadata Section for EOF)
콜 결정 없음 · EVM·실행 · 원문 상태 Review · 2024-12-06 작성
EOF 컨테이너에 코드가 접근할 수 없는 전용 메타데이터 섹션을 추가합니다. 메타데이터가 바뀌어도 실행 코드는 그대로여서 소스코드 검증이 쉬워집니다.
왜 필요한가
스마트 컨트랙트 바이트코드에는 실행 코드 외에 컴파일러 버전이나 소스 파일의 해시 같은 메타데이터가 함께 들어갑니다. 지금은 Solidity와 Vyper 컴파일러가 이런 정보를 CBOR라는 형식으로 인코딩해 실행 코드 뒤에 그냥 붙입니다. 바이트코드에 구조가 없어서 어디까지가 실행 코드이고 어디부터가 메타데이터인지 구분하기 어렵습니다. 체인에 올라간 바이트코드와 소스 컴파일 결과를 비교하는 소스코드 검증에서는 검증 서비스마다 메타데이터를 골라내는 자체 추측 로직을 만들어 써야 합니다. 바이트코드를 구조화하는 EOF(Ethereum Object Format)가 도입돼도 전용 메타데이터 자리가 없으면 데이터 섹션에 넣어야 하는데, 그러면 메타데이터 크기가 바뀔 때 데이터를 읽는 명령어의 위치 값이 밀려 실행 코드 자체가 달라지고 코드가 메타데이터에 접근할 수도 있습니다. 같은 소스로 컴파일한 두 컨트랙트가 메타데이터 차이만으로 검증에 실패하지 않으려면 별도 섹션이 필요합니다.
무엇이 바뀌나
지금
- 메타데이터가 실행 코드 뒤나 데이터 섹션에 섞여 있어 구분하려면 추측 로직에 의존합니다
- 메타데이터 크기가 바뀌면 실행 코드의 데이터 읽기 위치가 밀려 코드 자체가 달라집니다
- 코드가 이론상 메타데이터 바이트에 접근할 수 있습니다
- 여러 바이트코드가 중첩된 팩토리 컨트랙트는 각각의 메타데이터를 찾기가 더 까다롭습니다
EIP-7834 이후
- 메타데이터가 헤더에 크기가 명시된 전용 섹션에 들어가 위치가 명확해집니다
- 메타데이터를 바꿔도 실행 코드는 그대로여서 검증할 때 쉽게 제외할 수 있습니다
- 메타데이터 섹션은 코드에서 접근할 수 없습니다
- 메타데이터가 필요 없으면 섹션을 아예 생략해 컨테이너 크기를 줄일 수 있습니다
누구에게 영향이 있나
- 소스코드 검증 서비스: 추측 로직 없이 메타데이터 섹션을 건너뛰고 실행 코드만 비교할 수 있습니다.
- 컴파일러 팀(Solidity·Vyper): 메타데이터를 데이터 섹션 대신 전용 섹션에 쓰도록 출력 형식을 바꿀 수 있습니다.
- 클라이언트·툴링 팀: EOF 컨테이너 처리 로직에 새 섹션 종류(0x05)를 반영해야 합니다.
- 일반 사용자: 쓰고 있는 컨트랙트가 공개된 소스와 일치하는지 확인하기 쉬워집니다.
심층 설명
헤더에 추가되는 kind_metadata와 metadata_size
EIP-3540 컨테이너 헤더에 두 개의 OPTIONAL 필드를 추가합니다. kind_metadata는 1바이트이고 값은 0x05로, 메타데이터 섹션의 종류 표시자입니다. metadata_size는 2바이트 빅엔디언 부호 없는 정수이고 값 범위는 0x0001-0xFFFF로, 메타데이터 섹션 내용의 길이를 나타냅니다. 두 필드는 kind_data(값 0xff)와 data_size 앞, 컨테이너 섹션 관련 필드 뒤에 놓입니다. data_size는 0x0000부터 허용되는 것과 달리 metadata_size의 최솟값은 0x0001이므로, 섹션을 선언하면서 내용을 비워 둘 수는 없습니다.
바디의 metadata_section 위치와 내용
바디는 types_section, code_section(들), container_section(들), metadata_section, data_section 순서가 됩니다. metadata_section은 data_section 바로 앞에 OPTIONAL로 들어갑니다. 내용은 임의의 바이트 열이며 그 구조와 인코딩은 이 EIP가 정의하지 않습니다. 컴파일러, 툴링, 컨트랙트 개발자가 정하도록 남겨 두었고 현재 Solidity와 Vyper 컴파일러의 관행은 CBOR 인코딩입니다.
메타데이터 섹션이 OPTIONAL인 이유
metadata_section과 헤더의 kind_metadata, metadata_size 필드는 모두 OPTIONAL입니다. 덕분에 메타데이터를 쓰지 않으려는 컴파일러는 추가 바이트 없이 컨테이너를 만들 수 있습니다. 반면 data_section은 배포 과정에서 크기와 내용이 바뀔 수 있어 데이터가 비어 있더라도 REQUIRED입니다. metadata_section은 배포 중에 바뀌지 않을 것으로 전제합니다.
data_section 앞 배치와 0x05 값 선택
metadata_section을 data_section 뒤가 아니라 앞에 둔 이유는, 뒤에 두면 배포 시점에 data_section이 바뀔 때 metadata_section의 위치가 함께 밀리기 때문입니다. 앞에 두면 이 문제를 피할 수 있습니다. kind 값으로 0x04가 아닌 0x05를 고른 것은 기존 EOF 툴링이 변경 사항을 받아들이기 쉽게 하기 위해서입니다.
데이터 섹션에 메타데이터를 넣을 때의 세 가지 문제
pre-EOF에서는 Solidity가 CBOR 인코딩한 메타데이터와 그 길이 2바이트를 런타임 바이트코드 끝에 붙이고, 여기에 IPFS 또는 Swarm 해시와 experimental 플래그를 포함합니다. Vyper는 0.4.1부터 initcode에 무결성 해시를 CBOR로 붙입니다. 전용 섹션 없이 EOF의 data_section에 메타데이터를 넣으면 원문이 드는 세 가지 문제가 생깁니다. 첫째, data_section 안에서 메타데이터 부분을 구분하기 어려워 pre-EOF와 같은 문제가 반복됩니다. 둘째, 메타데이터 크기가 바뀌면 DATALOADN 오프셋이 밀리는 식으로 실행 바이트코드가 달라져 메타데이터 크기만 다른 동일한 컨트랙트 둘이 소스코드 검증에서 일치하지 않습니다. 셋째, DATALOADN 명령을 조작하면 코드가 이론상 메타데이터에 접근할 수 있습니다.
호환성, 보안, 현재 상태
EIP-3540이 아직 구현되지 않았기 때문에 하위 호환성 문제는 없을 것으로 봅니다. 메타데이터 섹션은 실행되지 않는 영역이어서 원문은 별도의 보안 고려 사항이 없다고 적습니다. 이 EIP는 현재 Review 상태이므로 명세가 아직 바뀔 수 있습니다.