ERC-6860 Web3 URL의 EVM 호출 변환 (Web3 URL to EVM Call Message Translation)

Draft · 기타 · 2023-09-29 작성

web3://uniswap.eth/ 같은 HTTP 모양의 주소를 이더리움 가상머신(EVM)의 읽기 호출로 바꾸는 규칙을 정합니다. 중개 서버 없이 온체인 콘텐츠를 주소 하나로 직접 읽을 수 있게 합니다.

왜 필요한가

지금은 블록체인에 올라 있는 데이터를 보려면 대부분 웹2 방식의 중개자를 거칩니다. 댑 웹사이트, 노드 서비스 제공자, 익스플로러 같은 프록시(proxy)가 블록체인 요청을 대신 변환해 주는데, 이 중개자들은 사용자가 통제할 수 없는 존재입니다. 중개자가 멈추거나 내용을 다르게 보여 주면 사용자는 이를 확인하거나 피할 방법이 없습니다. 이 표준은 웹2 사용자가 중개자 없이 web3:// 형태의 주소만으로 온체인 콘텐츠, 특히 SVG나 HTML 같은 온체인 웹 콘텐츠에 직접 접근하는 간단한 방법을 정의합니다. 또 주소(URI)를 쓰는 기존 표준인 SVG, HTML 등과 서로 연동할 수 있게 하며 사람이 읽기 어려운 16진수 호출 데이터 대신 이름과 메서드, 인자를 사람이 읽을 수 있는 형태로 적게 합니다. 이 제안은 기존 ERC-4804를 소폭 수정하고 명확히 다듬은 갱신판입니다.

구현해야 하는 것

심층 설명

URL 구조와 각 부분의 의미

Web3 URL은 schema "://" [ userinfo "@" ] contractName [ ":" chainid ] pathQuery [ "#" fragment ] 형태의 ASCII 문자열입니다. schema는 w3 또는 web3입니다. userinfo는 EVM 호출 메시지의 From 필드로, 생략하면 0x0을 보낸이 주소로 씁니다. contractName은 To 필드로, 0x로 시작하는 20바이트 주소이거나 이름 서비스의 도메인 이름입니다. 도메인 이름을 주소로 바꾸는 방법은 ENS의 경우 ERC-6821에 정의되어 있고 다른 이름 서비스는 이후 ERC에서 다룹니다. chainid는 이름 해석과 호출이 일어날 체인을 지정하며 생략하면 사용한 이름 서비스의 기본 체인(예: eth는 1)을 쓰고 이름 서비스를 쓰지 않았다면 기본값은 1입니다. fragment는 HTTP URL처럼 자원 참조용 문자열이며 스마트 컨트랙트에 전달되지 않습니다. 이 명세는 읽기 전용(Solidity의 view 함수) 의미만 정의하고, 상태를 바꾸는 함수는 향후 확장으로 남겨 둡니다.

해석 모드 판별 규칙

To 주소와 chainid가 정해지면 프로토콜은 대상 주소의 resolveMode() 메서드를 호출해 모드를 확인합니다. 반환값이 bytes32로 "manual"(0x6d616e75616c0000...)이면 수동 모드입니다. 반환값이 "auto"(0x6175746f0000...)이거나 0x0000...이거나, 호출 자체가 오류를 내면(메서드 미구현 또는 메서드 내부 오류) 자동 모드입니다. 그 밖의 값이면 프로토콜은 "unsupported resolve mode" 오류로 요청을 실패 처리합니다. 예시에서 이 호출의 calldata는 keccak("resolveMode()")[0:4] 즉 0xDD473FAE입니다.

수동 모드: 경로를 그대로 calldata로

수동 모드는 mPathQuery(경로와 선택적 쿼리)를 퍼센트 인코딩 해제 없이 그대로 메시지의 calldata로 씁니다. mPathQuery가 비어 있으면 "/"(0x2f)를 보냅니다. 반환 데이터는 ABI로 인코딩된 bytes로 취급해 디코딩한 바이트를 프론트엔드에 돌려줍니다. MIME 타입은 기본이 text/html이고 경로에 fileExtension이 있으면 그 확장자에서 유추한 타입으로 대체합니다. 상대 URL은 HTTP와 비슷하게 지원되어, 현재 컨트랙트 기준의 절대 경로와 상대 경로를 모두 쓸 수 있습니다.

자동 모드: 메서드와 인자를 ABI로 인코딩

자동 모드에서 aPath가 비어 있거나 "/"면 빈 calldata로 호출합니다. 그 외에는 /method/인자1/인자2 형태를 표준 Solidity 컨트랙트 ABI로 인코딩합니다. 인자는 [ type "!" ] value 문법으로, bool, int, uint, int<X>, uint<X>(X는 8부터 256까지 8 단위), address, bytes<X>(X는 1부터 32), bytes, string 타입을 지원합니다. 타입을 생략하면 순서대로 자동 판별합니다. 값이 숫자면 uint256, 0x+32바이트면 bytes32, 0x+20바이트면 address, 0x 뒤가 20도 32도 아닌 길이면 bytes, true/false면 bool, 그 외에는 address로 보고 도메인 이름으로 해석하며 해석에 실패하면 지원하지 않는 이름 서비스 오류를 돌려줍니다. 자동 모드의 상대 URL은 제한적으로, 자기 자신(빈 값), "/" 경로, 또는 전체 메서드와 인자만 쓸 수 있습니다.

returns 속성과 반환 데이터 처리

쿼리의 returns 속성은 반환 데이터의 형식을 지정하며 이더리움 ABI 함수 시그니처의 인자 부분 문법을 따릅니다(uint, int 별칭 허용). returns가 없거나 비어 있으면 반환 데이터를 ABI 인코딩된 bytes로 취급해 디코딩한 바이트를 돌려주고 MIME 타입은 기본적으로 미정이지만 마지막 인자가 string 타입이고 fileExtension이 있으면 그 확장자에서 유추합니다. returns=()이면 원시 바이트를 0x 접두사 16진수 문자열로 JSON 배열에 담아 ["0xXXXXX"] 형태로 돌려줍니다. 그 밖의 경우 지정된 타입으로 ABI 디코딩해 JSON으로 인코딩하는데, 이더리움 JSON-RPC 형식을 따라 bytes와 address는 0x 접두사 16진수로, 정수는 가장 압축된 16진수로(0은 "0x0"), 불리언과 문자열은 JSON 고유 타입으로 적습니다. returns 속성이 여러 번 나오면 마지막 것이 적용됩니다. returnTypes는 returns의 별칭이지만 ERC-4804 하위 호환용이므로 사용을 권장하지 않습니다.

ERC-4804과 달라진 점

이 ERC는 ERC-4804의 갱신판입니다. 교정으로는, 수동 모드에서 경로를 전혀 해석하지 않는다던 규정을 MIME 타입 판별을 위해 해석한다고 바로잡았고 자동 모드에서 returns가 없을 때 반환 데이터를 bytes32가 아니라 bytes로 취급한다고 바로잡았습니다. 명확화로는 ABNF 형식 정의 추가, 해석 모드 판별 상세화, 수동 모드의 퍼센트 인코딩·반환 데이터·MIME 처리 상세화, 자동 모드의 인자 인코딩과 returns 처리 상세화가 있습니다. 변경으로는 ethereum-web3://와 eth-web3:// 프로토콜 이름 삭제, 지원 타입 확대(ERC-4804는 uint256, bytes32, address, bytes, string만 지원), returns 지정 시 정수를 문자열이 아닌 0x 접두사 16진수로 인코딩하도록 바꾼 점이 있습니다.

설계 원칙

이 표준은 이더리움에 탈중앙 표현 계층을 더해 EVM을 탈중앙 백엔드로 쓰려는 제안입니다. 설계 원칙은 네 가지입니다. 사람이 읽을 수 있을 것: 주소 대신 이름 서비스의 이름을, 16진수 calldata 대신 메서드와 인자를 씁니다. HTTP URL 표준과 최대한 호환될 것: 상대 경로, 쿼리, 프래그먼트, 퍼센트 인코딩을 지원해 기존 브라우저가 최소 수정으로 확장할 수 있게 합니다. 단순할 것: 타입을 일일이 적는 대신 최대 가능성 원칙으로 자동 판별하되 필요하면 명시 타입도 지원합니다. 유연할 것: 컨트랙트가 인코딩 규칙을 재정의해 자원 해석을 세밀하게 제어할 수 있습니다.

제안 상태

이 문서는 현재 Draft(초안) 상태입니다. 내용이 앞으로 바뀔 수 있는 단계의 제안이라는 점을 감안해야 합니다.

ERC 원문 · ← ERCs