ERC-7618 web3 URL 압축 콘텐츠 제공 (Content encoding in ERC-5219 mode Web3 URL)
Draft · 기타 · 2024-02-08 작성
블록체인에 압축해 저장한 웹 자원을 web3:// 주소로 제공할 때, 클라이언트가 그 압축 방식을 지원하지 않으면 프로토콜이 먼저 압축을 풀어 전달하게 하는 표준입니다.
왜 필요한가
블록체인에 데이터를 저장하는 비용은 비싸기 때문에, 웹사이트 파일 같은 자원은 압축해서 저장하고 제공하는 편이 유리합니다. 일반 웹(HTTP)에서는 클라이언트가 자기가 풀 수 있는 압축 방식 목록(Accept-Encoding)을 보내면 서버가 그중 하나로 압축해 보내는 협상 방식을 씁니다. 그런데 블록체인은 저장과 연산에 제약이 있어 이 협상 방식을 그대로 흉내 내기 어렵습니다. 그렇다고 컨트랙트가 정해진 압축 방식 표시(Content-Encoding)를 붙여 무조건 압축본을 보내면, 그 방식을 구현하지 않은 HTTP 클라이언트는 내용을 풀 수 없는 문제가 생깁니다. 이 표준은 프로토콜이 지원하는 압축 방식 목록을 정해 두고 필요하면 프로토콜 쪽에서 압축을 푼 뒤 클라이언트에 전달하게 해서 압축 저장과 안전한 제공을 동시에 가능하게 합니다.
심층 설명
ERC-6944 리졸브 모드의 확장
이 표준은 ERC-6860 web3:// 표준의 한 갈래인 ERC-6944 리졸브 모드를 확장합니다. ERC-6944에서 컨트랙트의 request() 메서드는 응답 데이터와 함께 headers라는 KeyValue 배열을 반환하는데, 이 배열에 Content-Encoding HTTP 헤더가 들어 있으면 반환 데이터가 해당 알고리즘으로 압축되어 있다는 뜻으로 해석합니다. 기존 인터페이스를 바꾸지 않고 헤더 해석 규칙만 추가하는 방식이므로, ERC-6944 리졸브 모드에 그대로 얹을 수 있습니다.
프로토콜이 디코딩해야 하는 조건
request() 반환에 Content-Encoding 헤더가 있고 그 값이 클라이언트가 Accept-Encoding 헤더로 알린 지원 알고리즘 목록에 없거나, 클라이언트가 Accept-Encoding 헤더 자체를 보내지 않았다면, 프로토콜은 콘텐츠를 디코딩한 뒤 web3:// 클라이언트에 전달해야 합니다(MUST). 즉 클라이언트가 해당 압축을 풀 수 있다고 밝힌 경우에만 압축본이 그대로 전달되고, 그렇지 않으면 항상 프로토콜 쪽에서 압축을 풉니다.
필수 지원 알고리즘과 오류 처리
프로토콜은 gzip과 br(브로틀리) 두 가지 콘텐츠 인코딩을 반드시 지원해야 합니다(MUST). 프로토콜이 디코딩해야 하는 상황에서 컨트랙트가 알린 Content-Encoding이 이 목록에 없는 방식이면, 미지원 콘텐츠 인코딩이라는 오류를 클라이언트에 보내야 합니다(MUST). 디코딩에 성공하면 압축이 풀린 데이터를 클라이언트에 보냅니다.
디코딩 시 헤더 제거 규칙
프로토콜이 콘텐츠를 디코딩한 경우에는 Content-Encoding 헤더를 클라이언트에 전달하면 안 됩니다(MUST NOT). 이미 압축이 풀린 데이터를 받는 클라이언트가 헤더만 보고 다시 압축을 풀려고 시도하는 상황을 막기 위한 규칙입니다. 전달되는 데이터의 실제 상태와 헤더가 항상 일치하게 됩니다.
HTTP 방식을 그대로 복제하지 않은 이유
표준 HTTP의 Accept-Encoding과 Content-Encoding 협상 구조를 web3:// 프로토콜에 그대로 옮기는 것은 블록체인의 저장·연산 제약 때문에 최적이 아닙니다. 그렇다고 고정된 Content-Encoding으로 무조건 압축본을 내보내면 그 알고리즘을 구현하지 않은 HTTP 클라이언트가 문제를 겪습니다. 그래서 프로토콜이 지원 알고리즘 목록을 정하고 필요할 때 프로토콜 쪽에서 디코딩하는 절충안을 택했습니다. 또한 표준 HTTP와 최대한 가깝게 유지하기 위해 새 HTTP 헤더를 만들지 않고 기존 Content-Encoding 헤더를 재사용합니다.
제안 상태
이 ERC는 현재 Draft(초안) 상태입니다. 아직 내용이 바뀔 수 있는 제안 단계이므로, 구현하기 전에 최신 원문을 확인하는 것이 좋습니다. 이 표준은 ERC-5219와 ERC-6944를 전제로 합니다.