ERC-7617 웹3 URL 청크 분할 전송 (Chunk support for ERC-5219 mode in Web3 URL)
Draft · 기타 · 2024-02-08 작성
web3:// 주소로 제공되는 콘텐츠를 여러 조각(청크)으로 나눠 차례로 이어받을 수 있게 합니다. 한 번에 가져오기 어려운 큰 콘텐츠도 제공할 수 있습니다.
왜 필요한가
이더리움에서는 웹사이트 같은 콘텐츠를 스마트 컨트랙트에 담아 web3://라는 주소 체계로 제공할 수 있습니다. 그런데 데이터를 읽어 오는 통로인 RPC 엔드포인트에는 가스 한도(gas limit)가 있어서 한 번의 호출로 돌려줄 수 있는 데이터 양에 상한이 있습니다. 콘텐츠가 크면 이 한도에 걸려 끝까지 읽어 오지 못하는 문제가 생깁니다. 이 표준은 콘텐츠를 여러 청크로 나누고 각 응답에 다음 청크의 주소를 알려 주는 HTTP 헤더를 실어 보내는 방식을 정의합니다. 클라이언트는 그 주소를 따라가며 청크를 이어받고 헤더가 더 이상 없을 때까지 반복합니다. 이렇게 하면 가스 한도에 막히지 않고 임의 크기의 콘텐츠를 제공할 수 있습니다.
심층 설명
전제가 되는 표준들
이 표준은 ERC-6860 web3:// 표준의 맥락에서 ERC-6944 resolve 모드를 확장합니다. 머리말의 requires에는 ERC-5219와 ERC-6944가 올라 있습니다. 새 인터페이스를 만들지 않고 ERC-6944에 정의된 request() 메서드가 돌려주는 값 위에 선택적 HTTP 헤더 하나를 얹는 방식입니다. 따라서 이 표준을 쓰려면 콘텐츠를 제공하는 대상 스마트 컨트랙트가 ERC-6944 resolve 모드를 사용해야 합니다.
web3-next-chunk 헤더의 정의
새로 정의되는 것은 선택적(optional) HTTP 헤더인 web3-next-chunk 하나입니다. 이 헤더는 ERC-6944의 request() 메서드가 돌려주는 headers KeyValue 배열에 담겨 반환됩니다. 헤더 값은 완전한 web3:// URL이거나 상대(relative) URL이며 리소스 데이터의 다음 청크를 가리킵니다. 이 URL이 가리키는 대상 스마트 컨트랙트도 ERC-6944 resolve 모드를 사용해야 합니다.
클라이언트의 처리 절차
프로토콜은 최초 request() 호출의 결과인 HTTP 상태 코드, HTTP 헤더, 본문을 지체 없이 web3:// 클라이언트에 돌려줍니다. web3-next-chunk 헤더가 있으면 그 URL을 해석합니다. URL이 유효하지 않거나 대상 컨트랙트가 ERC-6944 resolve 모드를 쓰지 않으면 HTTP 데이터 스트리밍을 오류로 끝냅니다. 그렇지 않으면 request()를 호출하되 반환된 statusCode는 무시하고 body 데이터를 다음 청크로 보냅니다. 응답에 web3-next-chunk 헤더가 또 있으면 헤더가 나오지 않을 때까지 같은 과정을 반복합니다.
왜 헤더 방식을 골랐는가
다음 청크를 가리키는 헤더를 쓰는 방식은 ERC-6944의 request() 인터페이스를 바꾸지 않아도 되기 때문에 선택되었습니다. 또 헤더 값으로 web3:// URL을 쓰면 다음 청크를 어떤 수단으로 제공할지에 유연성이 생깁니다. 예를 들어 같은 컨트랙트의 다른 경로든 다른 컨트랙트든 URL로 가리킬 수 있는 곳이면 됩니다.
해결하려는 문제
이더리움 RPC 엔드포인트에는 가스 한도가 있고 큰 콘텐츠를 제공할 때 이 한도에 도달할 수 있습니다. 청크 기능을 더하면 임의 크기(arbitrary sized)의 콘텐츠를 제공할 가능성이 생깁니다. 원문의 Security Considerations 절은 발견된 보안 고려 사항이 없다고만 적고 있습니다.
아직 Draft 단계입니다
이 제안은 2024년 2월 8일에 만들어졌고 상태가 Draft입니다. 내용이 바뀌거나 진행이 멈출 수 있는 초안 단계이므로, 구현 전에 최신 원문을 확인하는 것이 좋습니다.