ERC-1066 스마트 컨트랙트 상태 코드 (Status Codes)
Stagnant · 기타 · 2018-05-05 작성
스마트 컨트랙트가 성공·실패만이 아니라 대기, 초과, 권한 필요 등 다양한 상황을 표준화된 1바이트 코드로 표현하게 하는 공통 상태 코드 체계입니다.
왜 필요한가
현재 스마트 컨트랙트는 상황이 복잡해도 성공과 실패를 명확히 구분해 알리지 못합니다. 문제가 생기면 트랜잭션을 되돌리는 revert로 사람의 개입을 요구하거나, true·false 같은 단순한 값만 반환해 정확히 무슨 일이 일어났는지 알기 어렵습니다. 그 결과 사용자는 거래가 왜 실패했는지 알 수 없고, 다국어 번역 같은 피드백도 받을 수 없습니다. 개발자도 컨트랙트가 실행 중 어떤 상태를 거쳤는지 파악하기 어려워 디버깅이 힘들고, 컨트랙트마다 자체 에러 체계를 따로 만들어야 해서 다른 컨트랙트와 자동으로 상호작용하며 상태를 주고받기도 어렵습니다.
심층 설명
코드 반환 형식
상태 코드는 byte(bytes1) 타입으로, 함수가 단독으로 반환하거나 여러 값을 반환할 때 그 첫 번째 값으로 반환됩니다. 예를 들어 함수가 status만 반환할 수도 있고, (status, newCounter)처럼 상태와 실제 값을 함께 반환할 수도 있습니다. 항상 첫 번째 위치에 고정해 반환함으로써 HTTP 응답의 헤더나 BEAM 언어의 태그드 튜플처럼 일관된 위치에서 상태를 읽을 수 있게 합니다.
16x16 코드 테이블 구조
코드는 2자리 16진수(0x00~0xFF)로 표현되며, 상위 니블은 '카테고리', 하위 니블은 '이유'를 나타냅니다. 예컨대 0x10과 0x11은 같은 카테고리(권한·제어)에 속하고, 0x04와 0x24는 같은 이유(하한·부족)를 공유합니다. 0x0 범주의 코드는 정수와도 호환되어 hex"1" == hex"01" == 1 처럼 캐스팅할 수 있습니다.
카테고리별 의미
0x0*는 범용(성공·실패·대기 등), 0x1*는 권한·제어(허용·금지·정지등), 0x2*는 검색·비교·범위(찾음·초과·미달), 0x3*는 협상·거버넌스(동의·투표·정족수), 0x4*는 가용성·시간(일시정지·만료), 0x5*는 토큰·자금(전송 성공·실패·에스크로), 0xA*는 애플리케이션별 코드, 0xE*는 암호화·신원·증명(서명·복호화), 0xF*는 오프체인 동작을 나타냅니다. 0x6~0x9, 0xB~0xD 범위는 아직 미지정(TBD)으로 전체가 예약되어 있습니다.
짝수는 차단, 홀수는 비차단
설계 규칙상 짝수 코드는 수신자가 제어권을 갖지 못하는 차단 상태를, 홀수 코드는 수신자가 자유롭게 다음 행동을 할 수 있는 비차단 상태를 나타냅니다. 이는 0x00(실패, false)과 0x01(성공, true)의 짝수·홀수 대응과도 맞아떨어져, 간단한 비트 검사만으로 블로킹 여부를 판단할 수 있습니다.
revert-with-reason과 완전히 호환
이 표준은 revert-with-reason을 대체하지 않고 보완하는 용도입니다. revert할 때 표준 상태 코드를 함께 전달하면 어떤 알려진 에러 상태 때문인지 파악할 수 있고, ERC-1444 같은 번역 테이블과 결합하면 사용자가 원하는 언어와 상세도로 자동 번역된 메시지를 제공할 수 있습니다. 또한 상태 코드는 트랜잭션을 되돌리지 않고도 알려진 에러 상태, 오프체인 조건, 시간 지연 등을 표현할 수 있어 revert보다 쓰임이 넓습니다.
애플리케이션별 확장과 메타 코드
0xA* 범위는 애플리케이션에 특화된 상태를 위해 예약되어 있어, 구현자가 구체적인 의미를 부여할 수 있습니다. 256개 코드로 부족한 경우에는 bytes1 코드를 더 큰 바이트 배열에 담아 확장할 수 있습니다. 각 카테고리의 마지막 코드(예: 0x0F, 0x1F, 0xEF, 0xFF)는 해당 범주에 대한 부가 정보나 메타데이터를 나타내는 용도로 쓰입니다. 아직 지정되지 않은 코드는 임의로 써도 되는 빈 공간이 아니라, 향후 추가 규격을 위해 열려 있는 자리입니다.
제안 상태: Stagnant
이 제안은 Stagnant(정체) 상태로, 이제 활발히 논의되거나 진행되지 않고 멈춰 있는 제안입니다.