EIP-3540 EOF - EVM 객체 포맷 v1 (EOF - EVM Object Format v1)
콜 결정 없음 · EVM·실행 · 원문 상태 Stagnant · 2021-03-16 작성
EOF는 EVM 바이트코드를 배포할 때 한 번만 검증하는 확장 가능한 컨테이너 포맷으로, 코드와 데이터를 섹션으로 나눠 담습니다.
왜 필요한가
지금 온체인에 배포된 EVM 바이트코드는 정해진 구조가 없어, 클라이언트는 실행할 때마다 JUMPDEST 분석을 반복해야 합니다. 이는 실행 오버헤드이자, 새 기능을 추가하거나 기존 기능을 없애려 할 때 걸림돌이 됩니다. 또한 코드와 데이터(생성자 인자 등)가 한 덩어리로 섞여 있어, L2 같은 온체인 코드 검증기들이 둘을 구분하기 어렵습니다. 그래서 배포 전에 코드를 미리 손봐야 하거나, 취약한 방식에 의존하거나, 비싼 점프 분석을 돌려야 했습니다. EOF는 배포 시점에 한 번 구조를 검증해 이런 문제를 해결하려 합니다.
무엇이 바뀌나
지금
- 바이트코드에 정해진 구조가 없고, 실행마다 JUMPDEST 분석을 반복함
- 코드와 데이터가 섞여 있어 둘을 구분하기 어려움
- 0xEF로 시작하는 코드는 배포할 수 없음(EIP-3541로 예약됨)
- 버전 필드가 없어 새 기능 도입이나 기존 기능 폐기가 어려움
EIP-3540 이후
- 배포 시점에 한 번 검증을 거쳐 이후에는 유효성이 보장되는 EOF 컨테이너
- 코드(code section)와 데이터(data section)가 섹션으로 분리됨
- version 번호로 향후 규칙 변경을 관리할 수 있음
- EOF1 컨트랙트는 EOF가 아닌 컨트랙트를 DELEGATECALL할 수 없어 파괴 공격 경로가 줄어듦
누구에게 영향이 있나
- 스마트컨트랙트·컴파일러 개발자: 컴파일러가 새 컨테이너 포맷에 맞춰 코드와 데이터를 섹션으로 나눠 출력해야 합니다.
- 클라이언트 팀: 컨트랙트 생성 시 EOF 헤더와 섹션 구조를 검증하는 로직을 구현해야 합니다.
- L2·온체인 코드 검증 도구: 코드와 데이터가 섹션으로 분리되어 분석이 쉬워지고 가스비도 절감됩니다.
- 프록시 컨트랙트 운영자: legacy 프록시가 DELEGATECALL로 EOF 구현체를 호출하는 경로는 허용되어 업그레이드가 가능합니다.
심층 설명
컨테이너 전체 구조
EOF 컨테이너는 magic(2바이트, 0xEF00), version(1바이트), 그 뒤를 잇는 섹션 헤더들, 헤더 종료를 알리는 0x00, 그리고 섹션 본문들로 구성됩니다. 구조를 요약하면 magic, version, (section_kind, section_size_or_sizes)+, 0, 섹션 본문 순입니다. 섹션 헤더는 section_kind(1바이트)와 section_size 또는 section_size_list로 이루어지고, section_kind는 0이 될 수 없습니다. 0은 헤더 종료 바이트로 예약되어 있습니다. 컨테이너에는 최소 하나의 섹션이 있어야 하고, 섹션 밖에 떠도는 바이트는 허용되지 않습니다.
EOF1 헤더 필드
EOF 버전 1 헤더는 magic(0xEF00), version(0x01), kind_type(0x01)과 type_size, kind_code(0x02)와 num_code_sections 및 각 code_size, 선택적으로 kind_container(0x03)와 num_container_sections 및 각 container_size, kind_data(0xFF)와 data_size, 마지막으로 terminator(0x00) 순서로 나열됩니다. type_size는 코드 섹션 하나당 4바이트이므로 반드시 4로 나누어져야 하고, 코드 섹션 개수는 type_size/4와 같아야 합니다. 컨테이너 전체 크기는 EIP-3860이 정의한 MAX_INITCODE_SIZE를 넘을 수 없습니다.
body 구성: types/code/container/data 섹션
body는 types_section 하나, code_section 하나 이상, container_section 0개 이상, data_section 하나로 구성됩니다. types_section은 코드 섹션별로 inputs(스택에서 소비하는 값 수), outputs(반환하는 값 수), max_stack_increase(코드 섹션이 늘릴 수 있는 최대 스택 높이)를 4바이트씩 담습니다. outputs 값 0x80은 별도 EIP가 정의하는 종료하지 않는 함수를 나타내는 특수값입니다. container_section은 임의의 EOF 컨테이너를 통째로 담을 수 있고, data_section은 임의의 바이트열이며 아직 배포되지 않은 컨테이너에서는 실제 내용보다 data_size가 더 길어도 됩니다.
실행 의미의 변화
EOF 컨트랙트는 항상 code section 0의 첫 바이트부터 실행을 시작합니다. CODESIZE, CODECOPY, EXTCODESIZE, EXTCODECOPY, EXTCODEHASH, GAS는 검증 단계에서 거부되며 대체 명령도 없습니다. CALL, DELEGATECALL, STATICCALL도 거부되고, 대체 명령은 별도 EIP가 도입합니다. EOF 컨트랙트가 DELEGATECALL(또는 대체 명령)로 EOF가 아닌 컨트랙트(legacy, EOA, 빈 계정)를 호출하는 것은 금지되며, 호출 깊이 검사에 실패한 것과 같은 방식으로 실패합니다. 다만 legacy 컨트랙트가 EOF 컨트랙트를 DELEGATECALL하는 경로는 허용되는데, 기존 프록시 컨트랙트가 EOF로 업그레이드된 구현체를 쓸 수 있게 하기 위해서입니다.
legacy 컨트랙트에서 본 EOF 컨트랙트
legacy 컨트랙트가 EXTCODECOPY로 EOF 컨트랙트의 코드를 복사하려 하면 EF00의 앞 2바이트만 복사된 것처럼 동작합니다. EXTCODEHASH는 EF00의 해시값인 0x9dbf3648db8210552e9c4f75c6a1c3057c0ca432043bd648be15fe7be05646f5를 반환하고, EXTCODESIZE는 2를 반환합니다. 다만 생성 중인 EOF 컨트랙트에 대해서는 이 규칙이 적용되지 않고, 코드가 없는 계정과 동일하게 취급됩니다.
MAGIC 바이트 선택
EOF 식별자는 0xEF00입니다. 첫 바이트 0xEF는 EIP-3541이 이 용도로 예약해 둔 값이고, 두번째 바이트 0x00은 메인넷에 이미 배포되어 있던 0xEF로 시작하는 세 컨트랙트(EFF09f918bf09f9fa9, EF, EF)와 충돌하지 않도록 고른 값입니다. Goerli, Ropsten, Rinkeby, Kovan, Sepolia 등 공개 테스트넷에는 London 포크 블록 기준으로 0xEF로 시작하는 컨트랙트가 존재하지 않습니다. 이 EIP는 MAGIC으로 시작하면서 유효한 EOF가 아닌 바이트코드가 이미 존재하는 체인에는 적용해서는 안 됩니다.
EOF1은 EOF1만 DELEGATECALL 가능
현재 컨트랙트는 SELFDESTRUCT, CALLCODE, DELEGATECALL 세 경로로 자기파괴될 수 있습니다. EIP-3670이 앞의 두 경로를 막지만 DELEGATECALL 경로는 남아 있습니다. EOF1 컨트랙트가 다른 EOF1 컨트랙트만 DELEGATECALL할 수 있도록 제한하면 EOF1 컨트랙트는 절대 파괴될 수 없다는 강한 보장이 생기고, Parity 멀티시그처럼 파괴된 라이브러리 컨트랙트로 인한 공격이 EOF1 컨트랙트에서는 원천적으로 사라집니다.
현재 상태와 전제조건
이 EIP는 상태가 Stagnant로, 아직 확정되어 하드포크에 포함된 것이 아니며 앞으로 바뀌거나 중단될 수 있습니다. EIP-3541(0xEF 바이트 예약)과 EIP-3860(MAX_INITCODE_SIZE)을 전제로 하고, 실제 컨트랙트 생성 명령어나 CALL류 대체 명령, EXTDATACOPY 등은 모두 별도 EIP에서 정의됩니다. 즉 이 EIP 하나만으로는 완결된 기능이 아니라, EOF라는 여러 EIP로 구성된 포맷의 기반 컨테이너 규격입니다.