ERC-725 범용 데이터 저장·실행 계정 표준 (General data key/value store and execution)
Draft · 계정·지갑 · 2017-10-02 작성
스마트 컨트랙트에 자유롭게 읽고 쓸 수 있는 키/값 데이터 저장소(ERC725Y)와 다른 주소 호출·컨트랙트 배포까지 하는 범용 실행 기능(ERC725X)을 더하는 표준입니다.
왜 필요한가
보통의 스마트 컨트랙트는 배포하는 순간 저장할 수 있는 데이터의 종류와 할 수 있는 동작이 코드에 고정됩니다. 나중에 새로운 종류의 정보를 붙이고 싶어도 컨트랙트를 새로 배포해야 하고 컨트랙트를 하나의 계정처럼 써서 임의의 다른 컨트랙트를 호출하게 만들려면 그때마다 전용 함수를 만들어야 합니다. 또 이런 기능을 저마다 다른 방식으로 구현하면 지갑이나 앱이 공통된 방법으로 데이터를 읽거나 실행을 요청할 수 없습니다. 이 표준은 오래 쓸 수 있는 스마트 컨트랙트 계정 시스템을 만들려는 동기에서 나왔고 데이터 저장과 실행이라는 두 가지 공통 블록을 표준화해 이 문제를 풉니다. 두 블록은 함께 써서 계정을 만들 수도 있고 ERC725Y만 따로 써서 NFT나 토큰의 메타데이터를 확장하는 데 쓸 수도 있습니다.
구현해야 하는 것
function execute(uint256 operationType, address target, uint256 value, bytes memory data) external payable returns(bytes memory): 소유자만 부를 수 있는 범용 실행 함수입니다. 연산 타입에 따라 다른 컨트랙트 호출, 코인 전송, 컨트랙트 배포를 수행하고 결과를 돌려줍니다.function executeBatch(uint256[] memory operationsType, address[] memory targets, uint256[] memory values, bytes[] memory datas) external payable returns(bytes[] memory): 여러 건의 실행을 한 번에 처리합니다. 네 배열의 길이는 같아야 하고 각 건마다 결과를 배열로 돌려줍니다.event Executed(uint256 indexed operationType, address indexed target, uint256 indexed value, bytes4 data);: 연산 타입 0, 3, 4로 호출이 실행될 때 반드시 발생하는 이벤트입니다.event ContractCreated(uint256 indexed operationType, address indexed contractAddress, uint256 indexed value, bytes32 salt);: 연산 타입 1, 2로 새 컨트랙트가 배포될 때 반드시 발생하는 이벤트입니다.function getData(bytes32 dataKey) external view returns(bytes memory): 주어진 데이터 키에 저장된 값을 읽어 옵니다. 누구나 부를 수 있는 조회 함수입니다.function getDataBatch(bytes32[] memory dataKeys) external view returns(bytes[] memory): 여러 데이터 키의 값을 한 번에 읽어 배열로 돌려줍니다.function setData(bytes32 dataKey, bytes memory dataValue) external: 하나의 데이터 키에 바이트 값을 저장합니다. 소유자만 부를 수 있습니다.function setDataBatch(bytes32[] memory dataKeys, bytes[] memory dataValues) external: 여러 데이터 키에 값을 한 번에 저장합니다. 두 배열의 길이는 같아야 하고 소유자만 부를 수 있습니다.event DataChanged(bytes32 indexed dataKey, bytes dataValue): 데이터 키에 값이 성공적으로 저장될 때 반드시 발생하는 이벤트입니다.
심층 설명
두 개의 하위 표준과 소유권 구조
이 표준은 범용 키/값 저장소인 ERC725Y와 범용 실행 함수인 ERC725X라는 두 하위 표준으로 구성되며 함께 쓰거나 따로 쓸 수 있습니다. 계정 버전은 LSP0-ERC725Account로 별도 표준화되어 있습니다. 컨트랙트는 단일 소유자가 통제하며 소유자는 컨트랙트일 수도 외부 계정일 수도 있습니다. ERC-173을 요구하고 owner() view, transferOwnership(address newOwner) 함수와 OwnershipTransferred 이벤트를 구현해야 합니다(SHOULD). 두 하위 표준 모두 ERC-165 supportsInterface를 반드시 구현해야 하고 인터페이스 ID는 ERC725X가 0x7545acac, ERC725Y가 0x629aa694입니다.
execute와 다섯 가지 연산 타입
execute(함수 셀렉터 0x44c028fe)는 다른 컨트랙트 호출, 네이티브 토큰 전송, 새 컨트랙트 배포를 하나의 함수로 처리합니다. operationType은 0이 CALL, 1이 CREATE, 2가 CREATE2, 3이 STATICCALL, 4가 DELEGATECALL이고 앞으로 추가될 수 있습니다. 원문은 4번을 잠재적으로 위험한 연산 타입이라고 명시합니다. 반드시 현재 소유자만 부를 수 있고 실행이나 배포가 실패하면 반드시 revert해야 합니다. 배포(타입 1, 2)에서는 target을 address(0)으로, STATICCALL과 DELEGATECALL(타입 3, 4)에서는 value를 0으로 두어야 합니다(SHOULD). 반환값은 호출 결과 바이트이거나 배포된 컨트랙트 주소입니다.
data 파라미터의 형식
data 필드의 내용은 연산 타입에 따라 다릅니다. CALL, STATICCALL, DELEGATECALL에서는 임의의 바이트나 abi 인코딩된 함수 호출입니다. CREATE에서는 배포할 컨트랙트의 생성 바이트코드 뒤에 abi 인코딩된 생성자 인자를 붙입니다. CREATE2에서는 생성 바이트코드 뒤에 abi 인코딩된 생성자 인자와 bytes32 salt를 차례로 붙입니다. 즉 data = 생성 코드 + 생성자 인자 + salt 형태입니다. CREATE2의 자세한 동작은 EIP-1014를 참조하라고 안내합니다.
ERC725Y 키/값 저장소
저장소는 bytes32 데이터 키에 바이트 값을 대응시키는 구조입니다. getData(0x54f6127f)로 읽고 setData(0x7f23690c)로 씁니다. 쓰기는 반드시 현재 소유자만 할 수 있고 성공하면 DataChanged 이벤트가 반드시 발생합니다. 데이터 키는 자유롭게 정하거나 표준으로 정의할 수 있는데, 흔한 방식은 단어의 해시를 쓰는 것입니다. 예를 들어 keccak256('ERCXXXMyNewKeyType')은 0x6935a24ea384927f250ee0b954ed498cd9203fc5d2bf95c735e52e6ca675e047이 됩니다. 키 타입과 값 타입, 인코딩을 더 명시적으로 정의한 표준으로 LSP2-ERC725JSONSchema가 있습니다. 저장된 데이터는 체인 밖 앱뿐 아니라 다른 컨트랙트도 읽고 쓸 수 있어 다른 프로토콜이 이 데이터를 새로운 방식으로 해석해 반응할 수 있습니다.
배치 함수와 오버로딩 제거
executeBatch(0x31858452), getDataBatch(0xdedff9c6), setDataBatch(0x97902421)는 여러 건을 한 번에 처리해 가스를 아끼는 함수이며 배열 파라미터들은 반드시 길이가 같아야 합니다. executeBatch는 각 호출 건마다 Executed 또는 ContractCreated 이벤트를 발생시킵니다. 2018/19년의 ERC725v2 이후 컨트랙트는 현재 버전과 호환되며 주로 인터페이스 ID와 이벤트 파라미터가 바뀌고 배치 함수가 추가되었습니다. 2023년부터는 함수 오버로딩을 제거했는데, 오버로딩이 Solidity에서는 되지만 다른 블록체인 언어에서 널리 지원되지 않아 언어 독립성을 위해 배열을 받는 함수에 Batch라는 이름을 붙이는 방식으로 바꾼 것입니다.
범용 저장을 택한 이유
키/값을 범용으로 저장하는 방식은 시간이 지나도 업그레이드할 수 있게 하려고 선택되었습니다. 저장된 값은 나중에 바꿀 수 있고 다른 스마트 컨트랙트 프로토콜이 이 데이터를 새로운 방식으로 해석해 ERC725 컨트랙트와의 상호작용에 다르게 반응할 수 있습니다. 단일 키와 다중 키 조회를 모두 제공한 것은 두 사용 사례 모두에서 가스 비용을 최소로 유지하기 위해서입니다. 참조 구현은 ERC725.sol로 제공됩니다.
아직 Draft 상태인 제안
이 문서는 2017년 10월에 만들어졌고 현재 상태가 Draft입니다. 아직 확정되지 않아 내용이 바뀔 수 있는 제안이라는 점을 감안해야 합니다.
쓸 때 주의할 점
- 재진입 등 호출 체인 공격: 이 컨트랙트는 범용 실행을 허용하므로 재진입(re-entrancy) 공격과 그 밖의 호출 체인 공격을 막기 위해 특별한 주의가 필요합니다.
- delegatecall(연산 타입 4)의 위험: 연산 타입 4의 delegatecall을 쓰면 호출된 컨트랙트가 호출한 컨트랙트의 상태를 바꿀 수 있고 소유자 변수와 ERC725Y 데이터 저장 항목도 마음대로 바꿀 수 있습니다. selfdestruct 호출을 비롯한 해로운 상태 변경 연산도 가능하다는 점을 고려해야 합니다.