ERC-725 범용 데이터 저장·실행 계정 표준 (General data key/value store and execution)

Draft · 계정·지갑 · 2017-10-02 작성

스마트 컨트랙트에 자유롭게 읽고 쓸 수 있는 키/값 데이터 저장소(ERC725Y)와 다른 주소 호출·컨트랙트 배포까지 하는 범용 실행 기능(ERC725X)을 더하는 표준입니다.

왜 필요한가

보통의 스마트 컨트랙트는 배포하는 순간 저장할 수 있는 데이터의 종류와 할 수 있는 동작이 코드에 고정됩니다. 나중에 새로운 종류의 정보를 붙이고 싶어도 컨트랙트를 새로 배포해야 하고 컨트랙트를 하나의 계정처럼 써서 임의의 다른 컨트랙트를 호출하게 만들려면 그때마다 전용 함수를 만들어야 합니다. 또 이런 기능을 저마다 다른 방식으로 구현하면 지갑이나 앱이 공통된 방법으로 데이터를 읽거나 실행을 요청할 수 없습니다. 이 표준은 오래 쓸 수 있는 스마트 컨트랙트 계정 시스템을 만들려는 동기에서 나왔고 데이터 저장과 실행이라는 두 가지 공통 블록을 표준화해 이 문제를 풉니다. 두 블록은 함께 써서 계정을 만들 수도 있고 ERC725Y만 따로 써서 NFT나 토큰의 메타데이터를 확장하는 데 쓸 수도 있습니다.

구현해야 하는 것

심층 설명

두 개의 하위 표준과 소유권 구조

이 표준은 범용 키/값 저장소인 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입니다. 아직 확정되지 않아 내용이 바뀔 수 있는 제안이라는 점을 감안해야 합니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs