ERC-7738 무허가 스크립트 레지스트리 (Permissionless Script Registry)
Draft · 기타 · 2024-07-01 작성
컨트랙트 주소만 대면 그 컨트랙트와 연결된 실행 스크립트의 위치(URI)를 누구나 등록하고 조회할 수 있는 공용 등록소(레지스트리)를 정의합니다. 지갑이나 앱은 여기서 스크립트를 찾아 내려받을 수 있습니다.
왜 필요한가
기존에는 토큰 컨트랙트에 스크립트를 연결하려면 ERC-5169라는 조회 기능을 컨트랙트를 만들 때부터 넣어 두거나, 나중에 고칠 수 있는 업그레이드 경로를 마련해 두어야 했습니다. 이미 배포된 컨트랙트에 그 기능이 없으면 스크립트를 연결할 방법이 없습니다. 그렇다고 스크립트 목록을 중앙 서버에 모아 두면 그 서버의 보안을 따로 챙겨야 하고 특정 조직이 데이터베이스의 문지기 노릇을 하게 되는 문제가 생깁니다. 이 표준은 체인 위에 누구나 쓸 수 있는 등록소 컨트랙트를 하나 두어 컨트랙트를 고치지 않고도 스크립트 위치를 올리고 찾을 수 있게 합니다.
구현해야 하는 것
event ScriptUpdate(address indexed contractAddress, string[] newScriptURI);: 어떤 컨트랙트의 스크립트 URI가 갱신될 때 발생하는 이벤트입니다. 이 인터페이스를 구현한 지갑은 이를 보고 캐시해 둔 스크립트를 갱신할 수 있습니다.function scriptURI(address contractAddress) external view returns (string[] memory);: 해당 컨트랙트 주소에 등록된 스크립트 URI 목록을 돌려줍니다.function setScriptURI(address contractAddress, string[] memory scriptURIList) external;: 해당 컨트랙트 주소에 스크립트 URI 목록을 등록하거나 갱신하고 ScriptUpdate 이벤트를 발생시킵니다.
심층 설명
ERC-5169와의 관계
ERC-5169는 컨트랙트 자신이 클라이언트 스크립트 조회 기능을 제공하는 방식입니다. 이 방식은 컨트랙트를 만들 때 해당 인터페이스를 구현해 두거나 업그레이드 경로를 허용해야 합니다. ERC-7738은 조회 기능을 컨트랙트 바깥의 별도 등록소로 옮겨 ERC-5169 없이 작성된 컨트랙트도 스크립트를 스스로 연결할 수 있게 합니다. 또한 중앙 온라인 서버를 두는 방식과 달리 서버 보안 관리나 데이터베이스 문지기 역할을 맡을 조직이 필요 없습니다.
멀티체인 싱글턴 구조
등록소 컨트랙트는 프로토타입 스크립트와 인증된 스크립트를 공급합니다. 지원하는 여러 체인에서 동일한 주소에 배포되는 멀티체인 싱글턴 인스턴스로 운영됩니다. 등록소는 주어진 컨트랙트 주소에 대해 URI 링크 집합을 돌려주고 이 링크들은 지갑, 뷰어, 미니댑이 가져올 수 있는 스크립트 프로그램을 가리킵니다. 포인터는 등록소의 setter를 통해 누구나 허가 없이 설정할 수 있습니다.
구현 요구사항
구현 컨트랙트는 IERC7738 인터페이스를 반드시 구현해야 하고(MUST), 스크립트가 갱신될 때 ScriptUpdate 이벤트를 반드시 발생시켜야 합니다(MUST). scriptURI가 돌려주는 목록은 해당 컨트랙트의 ERC-173 owner()가 올린 항목이 먼저 오도록 정렬해야 합니다(SHOULD). 단순한 지갑 구현은 목록의 첫 번째 scriptURI를 선택하기 때문입니다. scriptURI 항목이 많은 경우를 대비해 항목을 페이지 단위로 넘겨 볼 수단도 제공해야 합니다(SHOULD).
참조 구현과 간이 구현
실제 등록소 구현이 여러 메인넷, L2, 테스트넷 체인의 0x0077380bCDb2717C9640e892B9d5Ee02Bb5e0682 주소에 배포되어 있으며 setScriptURI 함수를 직접 호출하거나 동봉된 ethers 스크립트로 등록할 수 있습니다. 함께 실린 간이 구현 DecentralisedRegistry는 setScriptURI에서 목록이 비어 있지 않은지 확인하고 호출자가 대상 컨트랙트의 owner()가 아니면서 기존 등록자도 아니면 주소 목록(addrList)에 추가합니다. scriptURI는 소유자가 올린 항목을 먼저 담은 뒤 나머지 등록자들의 항목을 이어 붙여 돌려줍니다.
테스트 케이스
테스트 케이스는 NFTRegistryTest.test.ts에 포함되어 있으며 컨트랙트와 배포 스크립트, 레지스트리 스크립트가 테스트 스크립트와 함께 제공됩니다. 저장소를 받아 hardhat을 설치하고 npx hardhat test로 실행할 수 있습니다.
제안 상태
이 제안은 아직 Draft(초안) 상태입니다. 내용이 앞으로 바뀔 수 있으므로 구현할 때는 최신 원문을 확인해야 합니다.
쓸 때 주의할 점
- 소유자 서명으로 스크립트 검증: 대상 컨트랙트가 ERC-173 Ownable 인터페이스를 구현한 경우, 스크립트를 가져온 뒤 서명이 owner()와 일치하는지 검증할 수 있습니다. TokenScript라면 SDK나 온라인 검증 서비스를 쓰거나, XML에서 서명을 추출해 스크립트의 keccak256 해시로 ecrecover하여 서명 키 주소를 확인할 수 있습니다.
- Ownable이 없는 컨트랙트의 대안: 컨트랙트가 Ownable을 구현하지 않았다면 제3자 API나 블록 탐색기로 배포 키를 확인해 서명과 대조하거나, 호스팅 앱이 내장 키체인으로 서명 키를 사전 인증하거나, 거버넌스 토큰 기반의 스크립트 위원회가 키 설정과 검증 요청을 인증하는 방법을 쓸 수 있습니다.
- 검증되지 않은 스크립트 취급: 이런 검증 기준을 충족하지 못한 스크립트는 메인넷에서는 지갑이 사용에 신중해야 하며 앱이나 사용자의 재량에 맡겨집니다. 테스트넷에서는 지갑 제공자의 재량에 따라 스크립트가 동작하도록 허용해도 됩니다.