ERC-7700 크로스체인 스토리지 라우터 프로토콜 (Cross-chain Storage Router Protocol)

Draft · 기타 · 2024-04-30 작성

스마트 컨트랙트가 데이터 저장 요청을 L1의 다른 컨트랙트, L2, 외부 데이터베이스로 넘겨(라우팅) 비싼 메인넷 저장 비용을 피할 수 있게 하는 표준입니다. 이렇게 저장한 데이터는 CCIP-Read(EIP-3668)로 다시 읽을 수 있습니다.

왜 필요한가

이더리움 메인넷(L1)에 데이터를 저장하면 가스비가 비쌉니다. 그래서 많은 서비스가 데이터를 L2나 외부 데이터베이스에 두고 읽을 때만 CCIP-Read(EIP-3668)라는 기존 표준으로 불러옵니다. 그런데 CCIP-Read는 읽기만 다루기 때문에, 데이터를 바깥 저장소에 안전하게 쓰는 방법은 지금까지 서비스마다 각자 알아서 만들어야 했습니다. 특히 데이터베이스에 저장할 때는 나중에 L1 컨트랙트가 데이터가 진짜인지 확인할 수 있도록 별도의 보안 장치를 직접 설계해야 합니다. 이 표준은 저장 요청을 어디로 보낼지 컨트랙트가 알려 주는 공통 방식을 정해 앱이 밑에 어떤 저장소가 있는지 몰라도 동작할 수 있게 합니다. 쓰기(CCIP-Store)와 읽기(CCIP-Read)를 짝지어 크로스체인 데이터의 수명 주기를 완성하는 제안입니다.

심층 설명

리버트 기반 라우팅 구조

저장 함수가 호출되면 L1 컨트랙트는 데이터를 저장하는 대신 StorageRoutedTo__() 형태의 리버트를 발생시켜 저장 위치의 메타데이터를 돌려줍니다. 클라이언트는 이 리버트를 해석해 지정된 곳에 데이터를 다시 제출합니다. 이 문서는 StorageRoutedToL1(), StorageRoutedToL2(), StorageRoutedToDatabase() 세 가지 라우터를 정의합니다. 이렇게 저장된 데이터는 EIP-3668(CCIP-Read) 호환 컨트랙트가 읽어 데이터 수명 주기를 완성합니다. StorageRoutedToSolana(), StorageRoutedToIPFS() 같은 새 라우터도 예시로 언급됩니다.

L1·L2 라우터

StorageRoutedToL1(address contractL1)은 라우팅 대상인 L1 contract 주소만 필요합니다. StorageRoutedToL2(address contractL2, uint256 chainId)는 L2의 chainId 목록과 대응하는 contract 주소만 필요합니다. 두 경우 모두 클라이언트는 원래 호출과 정확히 같은 콜데이터로 트랜잭션을 만들어 라우팅된 컨트랙트의 같은 함수를 호출해야 합니다. 즉 콜데이터는 라우팅 전후에 불변이어야 합니다. 메타데이터는 getMetadata(node) 같은 임의의 온체인 코드로 얻으며 전역 상수일 수도 있습니다.

데이터베이스 라우터와 클라이언트 4단계

StorageRoutedToDatabase(string gatewayUrl)는 오프체인 저장을 처리할 gatewayUrl만 리버트로 돌려주며 L1에는 그 외의 데이터를 저장하지 않아도 됩니다. 리버트 이후 클라이언트는 네 단계를 거칩니다. 첫째, 사용자에게 비밀 서명 sigKeygen을 받아 결정적 dataSigner 키쌍을 생성합니다. 둘째, 생성된 서명자의 개인키로 콜데이터에 서명해 dataSig를 만듭니다. 셋째, 사용자에게 dataSigner를 승인하는 approval 서명을 받습니다. 넷째, 콜데이터를 dataSig, approval, dataSigner와 함께 게이트웨이에 전송합니다.

결정적 키 생성 keygen()

서명 키는 keygen(username, sigKeygen, spice)으로 지갑 서명에서 결정적으로 만듭니다. username은 EIP-155 체인 ID와 체크섬 주소로 만든 CAIP-10 식별자 eip155:${chainId}:${wallet}입니다. spice는 사용자에게 받은 선택적 password를 PBKDF2로 늘린 값으로, pepper는 keccak256(abi.encodePacked(username))이고 반복 횟수는 무차별 대입 방지를 위해 500,000회로 고정됩니다. inputKey는 sha256(sigKeygen), salt는 sha256(`${username}:${spice}:${sigKeygen}`)이며 이를 HKDF(dLen 42)에 넣어 secp256k1 키쌍을 얻습니다. sigKeygen 메시지에는 Origin(username), Protocol(eth:${chainId}:${contract} 형식으로 컨트랙트마다 고유), Extradata(keccak256(abi.encodePacked(spice, wallet)))가 들어갑니다.

데이터 서명과 서명자 승인

파생 서명자는 지갑 단위이므로 한 노드의 여러 키나 한 지갑이 가진 여러 노드의 데이터를 사용자에게 다시 묻지 않고 백그라운드에서 일괄 서명할 수 있습니다. dataSig 메시지에는 Origin, Data Type, Data Value가 들어가며 dataType은 중첩 키를 /로 이어 씁니다. 예를 들어 ENS의 text > avatar는 text/avatar, address > 60은 address/60입니다. dataSigner는 L1에 저장되지 않으므로, 노드의 소유자나 관리자가 서명한 approval을 함께 제출해야 합니다. approval 메시지에는 Origin, 체크섬 처리된 Approved Signer, Approved By(CAIP-10)가 들어갑니다. 이 설계로 지갑 서명 횟수는 갱신 건수와 무관하게 2회로 고정됩니다.

CCIP-Read 호환 페이로드와 POST 형식

오프체인 데이터 파일의 최종 페이로드는 고정 셀렉터 callback.signedData.selector = 0x2b45eb2b로 식별하며 abi.encode(['bytes4','address','bytes32','bytes32','bytes'], [funcSelector, dataSigner, dataSig, approval, encodedData])로 만듭니다. 클라이언트는 이 data와 인덱싱용 원본 값을 POST 요청으로 게이트웨이에 보냅니다. POST 본문에는 node, preimage, chainId, approval과 필드별 value, signature, timestamp, data가 들어갑니다. CCIP-Read 지원 컨트랙트는 네 파라미터를 디코드한 뒤 approval이 소유자·관리자의 승인인지, dataSig가 dataSigner의 서명인지 검증하고 나서 encodedData 값을 해석해 돌려줍니다.

새 라우터를 추가하는 규칙

새 저장소용 StorageRoutedTo__() 리버트는 이 문서를 참조하는 별도의 ERC 제안으로 등록해야 합니다. 각 제안은 라우터의 구조와 구현자가 돌려줘야 할 메타데이터를 상세히 문서화해야 하고 서명이 필요한 메시지 페이로드의 정확한 형식과 보안·접근성·프라이버시를 위해 쓰는 자체 암호 기법의 완전한 설명을 담아야 합니다.

제안 상태

이 문서는 아직 Draft(초안) 상태입니다. 내용이 바뀔 수 있는 제안 단계이므로 구현 전에 최신 원문을 확인해야 합니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs