ERC-6823 토큰 매핑 슬롯 조회 확장 (Token Mapping Slot Retrieval Extension)

Draft · 토큰 · 2023-03-29 작성

ERC-20/721/1155 토큰 컨트랙트에 소유권 매핑이 저장된 스토리지 슬롯을 알려 주는 함수를 추가해 외부 도구가 거래 결과를 이벤트에 기대지 않고 스토리지에서 직접 정확히 확인할 수 있게 합니다.

왜 필요한가

스마트컨트랙트에서 매핑(mapping)은 크기가 정해져 있지 않아 각 값이 keccak-256 해시로 계산된 별도의 저장 위치에 흩어져 저장됩니다. 이 위치는 매핑이 컨트랙트 안에서 몇 번째 변수로 선언됐는지에 따라 달라지는데, 변수 선언 순서는 컨트랙트마다 다르므로 밖에서는 보편적인 방법으로 알아낼 수 없습니다. 그래서 외부 도구가 토큰 전송 같은 거래를 미리 모의 실행(오프체인 시뮬레이션)해도, 소유권 데이터가 실제로 어느 위치에 기록되는지 확신할 수 없습니다. 결국 시뮬레이션은 컨트랙트가 내보내는 이벤트에 크게 의존하게 되는데, 원문은 이벤트가 참고용 정보일 뿐이며 유일한 진실의 원천은 상태(스토리지)여야 한다고 지적합니다. 저장 구조를 알 수 없으니 정작 진실의 원천인 스토리지를 직접 검증하지 못하고 응용 계층이 내보내는 정보에 기대야 하는 문제가 생깁니다.

구현해야 하는 것

심층 설명

매핑 저장 방식과 문제의 뿌리

EVM 스토리지는 32바이트 키와 32바이트 값의 키-값 저장소입니다. 상태 변수는 선언 순서대로 위치 0, 1, 2…에 배정되고 32바이트보다 작은 값 여러 개는 가능하면 한 슬롯에 묶입니다. 매핑은 크기를 알 수 없어 자리만 32바이트를 차지하고 키 k에 대한 값의 위치는 h(k)와 매핑의 위치 p를 이어 붙여 keccak-256 해시한 값으로 정해집니다. p는 매핑 앞에 선언된 변수들의 순서와 성격에 따라 달라지므로 구현을 알아야만 구할 수 있습니다. 이 구조는 Solidity뿐 아니라 Vyper 등 여러 언어에 공통으로 적용됩니다.

getTokenLocationRoot 함수 요구사항

구현자는 getTokenLocationRoot() 함수를 반드시(MUST) 구현해야 하고 이 함수는 컨트랙트에서 매핑 타입에 예약된 스토리지 슬롯을 반드시 돌려줘야 합니다. 선언은 external pure로 하는 것이 권장(SHOULD)됩니다. 참조 구현은 어셈블리로 <mapping_name>.slot을 읽어 bytes32로 돌려주는 한 줄짜리 함수이며 ERC-20, ERC-721, ERC-1155 확장 모두 동일한 형태입니다.

하나의 보편적 진입점

함수 이름을 일부러 범용적으로 지어 세 토큰 표준이 같은 구현을 공유하게 했습니다. 이 함수가 보편적으로 구현되면 함수 서명에서 나오는 셀렉터 하나가 모든 토큰 컨트랙트의 소유권 스토리지 슬롯을 직접 읽는 단일 진입점이 됩니다. 원문은 이렇게 되면 오프체인 시뮬레이션이 훨씬 정확해지고 이벤트는 정보 제공 용도로만 쓰이게 된다고 설명합니다.

검증 활용 예시

호출자는 돌려받은 슬롯으로 특정 토큰 ID의 저장 위치를 계산한 뒤, 그 값을 기대값과 비교해 이벤트가 알린 동작을 검증합니다. ERC-721 발행이면 슬롯 값을 토큰 소유자 주소와, ERC-20 전송이면 새 소유자 주소와, ERC-1155 소각이면 0 주소와 비교합니다. 비교는 기존의 여러 도구로 수행할 수 있습니다. 또 전체 상태가 아니라 특정 위치만 증명해 특정 토큰의 소유권을 추적하는 원자적 스토리지 증명도 가능해질 수 있다고 원문은 덧붙입니다.

비용과 호환성

기존 표준과의 호환성을 깨지 않는 간결한 방식을 목표로 설계됐습니다. 함수 하나가 추가되므로 컨트랙트 배포 비용이 아주 조금 늘지만 외부에서 이 함수를 쓰는 데는 비용이 전혀 들지 않습니다. 구현을 최소화해 오늘날 EVM용 스마트컨트랙트 개발에 쓰이는 주요 언어들과 직접 호환되도록 했습니다. 하위 호환성 문제는 발견되지 않았습니다.

제안 상태

이 제안은 2023년 3월에 만들어진 초안(Draft) 상태입니다. 내용이 앞으로 바뀔 수 있는 단계이므로 구현 전에 최신 상태를 확인하는 것이 좋습니다.

ERC 원문 · ← ERCs