ERC-6944 ERC-5219 리졸브 모드 (ERC-5219 Resolve Mode)

Draft · 기타 · 2023-04-27 작성

새 리졸브 모드 "5219"를 정의합니다. 컨트랙트는 이 값으로 ERC-4804 주소 체계 안에서 자신이 ERC-5219 방식으로 자원 요청에 응답한다는 사실을 알립니다.

왜 필요한가

ERC-4804는 웹 주소처럼 생긴 URL로 이더리움 컨트랙트의 자원에 접근하는 방식을 정의합니다. 이때 컨트랙트가 요청을 어떤 방식으로 해석해 응답할지를 정하는 값이 리졸브 모드(resolve mode)이며, 원문 작성 시점에는 자동 해석을 뜻하는 "auto"와 수동 해석을 뜻하는 "manual" 두 가지가 있었습니다. 한편 ERC-5219는 컨트랙트가 자원 요청을 받아 응답하는 별도의 인터페이스를 정의합니다. 그런데 어떤 컨트랙트가 ERC-5219 방식으로 응답한다는 사실을 ERC-4804 체계 안에서 알릴 표준 방법이 없으면, 클라이언트는 그 컨트랙트에 어떤 형식으로 요청을 보내야 할지 미리 알 수 없습니다. 이 표준은 리졸브 모드에 "5219"라는 새 값을 추가해 두 표준을 연결합니다.

구현해야 하는 것

심층 설명

resolveMode 반환값

resolveMode 함수는 external pure로 선언되며 bytes32 값 하나를 돌려줍니다. ERC-5219 방식으로 해석되려면 반드시(MUST) "5219"를 돌려줘야 하며 16진수로는 0x3532313900000000000000000000000000000000000000000000000000000000입니다. 이 값은 대소문자를 구분하지 않고 해석됩니다. 원문 작성 시점 기준으로 다른 선택지는 자동 해석을 뜻하는 "auto"와 수동 해석을 뜻하는 "manual"입니다.

IDecentralizedApp 상속

표준 인터페이스 IERC5219Resolver는 IDecentralizedApp을 상속합니다. 원문 주석은 IDecentralizedApp이 ERC-5219 인터페이스라고 밝힙니다. 따라서 ERC-5219를 ERC-4804 리졸브 모드로 쓰려는 컨트랙트는 resolveMode 함수만 추가하는 것이 아니라 ERC-5219가 정의한 자원 요청 처리 기능까지 함께 구현해야 합니다. 요청을 실제로 처리하는 방법 자체는 이 표준이 아니라 ERC-5219 명세를 따릅니다.

ERC-165를 쓰지 않는 이유

이 표준은 지원 여부 확인에 ERC-165를 쓰지 않습니다. ERC-165는 컨트랙트가 특정 인터페이스를 구현했는지 질의하는 일반적인 방법이지만 원문은 resolveMode를 직접 호출해 반환값을 확인하는 것만으로 상호 운용성을 검사할 수 있기 때문이라고 설명합니다. 클라이언트 입장에서는 어차피 해석 방식을 알기 위해 resolveMode를 호출해야 하므로, 함수 호출 한 번으로 ERC-5219 방식인지까지 함께 판별할 수 있습니다.

참조 구현과 하위 호환성

원문은 참조 구현으로 추상 컨트랙트 ERC5219Resolver를 제시합니다. 이 컨트랙트는 IDecentralizedApp을 상속하고 resolveMode에서 문자열 리터럴 "5219"를 그대로 돌려줍니다. 반환형이 bytes32이므로 이 값은 명세가 요구하는 0x35323139로 시작하는 32바이트 값으로 처리됩니다. 자원 요청을 실제로 처리하는 부분은 추상 컨트랙트이므로 구현자가 채워야 합니다. 하위 호환성에 대해서는 발견된 문제가 없다고 원문에 적혀 있습니다.

초안 단계의 제안입니다

이 제안은 2023년 4월 27일에 만들어졌고 현재 상태가 초안(Draft)입니다. 초안 단계의 제안은 내용이 바뀌거나 진행이 멈출 수 있으므로, 실제 구현에 반영하기 전에 최신 원문을 확인하는 것이 좋습니다. 또한 이 표준은 Standards Track의 ERC 범주에 속하며 ERC-4804와 ERC-5219를 선행 표준(requires)으로 지정하므로, 구현하려면 두 표준의 명세를 함께 읽어야 합니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs