ERC-7738 무허가 스크립트 레지스트리 (Permissionless Script Registry)

Draft · 기타 · 2024-07-01 작성

컨트랙트 주소만 대면 그 컨트랙트와 연결된 실행 스크립트의 위치(URI)를 누구나 등록하고 조회할 수 있는 공용 등록소(레지스트리)를 정의합니다. 지갑이나 앱은 여기서 스크립트를 찾아 내려받을 수 있습니다.

왜 필요한가

기존에는 토큰 컨트랙트에 스크립트를 연결하려면 ERC-5169라는 조회 기능을 컨트랙트를 만들 때부터 넣어 두거나, 나중에 고칠 수 있는 업그레이드 경로를 마련해 두어야 했습니다. 이미 배포된 컨트랙트에 그 기능이 없으면 스크립트를 연결할 방법이 없습니다. 그렇다고 스크립트 목록을 중앙 서버에 모아 두면 그 서버의 보안을 따로 챙겨야 하고 특정 조직이 데이터베이스의 문지기 노릇을 하게 되는 문제가 생깁니다. 이 표준은 체인 위에 누구나 쓸 수 있는 등록소 컨트랙트를 하나 두어 컨트랙트를 고치지 않고도 스크립트 위치를 올리고 찾을 수 있게 합니다.

구현해야 하는 것

심층 설명

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 원문 · ← ERCs