ERC-7412 주문형 오프체인 데이터 조회 (On-Demand Off-Chain Data Retrieval)
Draft · 기타 · 2023-07-26 작성
컨트랙트가 실행 중 체인 밖 데이터가 필요하면 정해진 에러로 실행을 중단하고 클라이언트가 서명된 데이터를 받아 와 검증 호출을 앞에 붙인 멀티콜 트랜잭션을 만들어 주는 표준입니다.
왜 필요한가
이더리움 확장 로드맵은 레이어2와 레이어3처럼 여러 실행 환경으로 나뉘는 방향으로 진행되고 있습니다. 그래서 여러 체인의 데이터를 읽는 능력이 확장 가능한 앱을 만드는 데 중요해졌지만 오라클 네트워크가 모든 레이어2와 레이어3에 수많은 가격 데이터를 쉬지 않고 밀어 넣어 주기를 기대하기는 어렵습니다. 다른 체인에 데이터를 쓰는 브리지는 개발되고 있지만 다른 체인이나 체인 밖의 데이터를 읽어 오는 비슷한 표준이 필요합니다. 기존의 ERC-3668은 리버트(revert, 실행 중단)를 이용해 오프체인 데이터를 요구하는 방식을 도입했지만 콜백 함수에 의존하기 때문에 중첩된 호출이 서로 다른 오프체인 데이터를 요구하는 상황을 다루기 어렵습니다. 이 표준은 콜백 대신 멀티콜(multicall, 여러 호출을 한 트랜잭션에 묶는 방법)을 써서 이런 제약을 넘습니다.
구현해야 하는 것
error OracleDataRequired(address oracleContract, bytes oracleQuery, uint256 feeRequired): 오프체인 데이터가 필요할 때 컨트랙트가 이 에러로 리버트합니다. 어느 오라클 컨트랙트에서 어떤 질의로 데이터를 받아야 하는지와 필요한 수수료를 알려 줍니다.function oracleId() view external returns (bytes32 oracleId);: 원하는 서명 데이터를 만드는 탈중앙 오라클 네트워크를 가리키는 고유 식별자를 돌려줍니다.function fulfillOracleQuery(bytes signedOffchainData) payable external;: 서명된 오프체인 데이터를 받아 검증하고 온체인에 기록해 이어지는 호출이 읽을 수 있게 합니다.error FeeRequired(uint amount): 질의 처리에 수수료가 필요할 때 리버트하는 에러입니다. amount는 wei 단위의 네이티브 가스 토큰 양입니다.error Errors(bytes[] errors);: 여러 에러를 한 번에 묶어 돌려주는 선택적 에러입니다. 클라이언트가 여러 데이터 요청을 한 번의 시뮬레이션으로 처리할 수 있게 합니다.
심층 설명
OracleDataRequired 에러의 구성
이 표준을 구현하는 컨트랙트는 오프체인 데이터가 필요할 때마다 error OracleDataRequired(address oracleContract, bytes oracleQuery, uint256 feeRequired)로 리버트해야 합니다(MUST). oracleQuery는 필요한 오프체인 데이터를 지정하며, 유효한 데이터 형식은 오라클 컨트랙트가 알려 주는 오라클 ID에 따라 다릅니다. 크로스체인 읽기라면 체인 ID, 컨트랙트 주소, 함수 시그니처, 페이로드, 타임스탬프 또는 'latest'가 들어갈 수 있고 가격 피드라면 티커 심볼과 타임스탬프가 들어갈 수 있습니다. oracleContract는 오프체인 데이터를 검증해 제공함으로써 이 에러를 피하게 해 줄 수 있는 컨트랙트의 주소입니다.
IERC7412 인터페이스와 오라클 ID
오라클 컨트랙트는 IERC7412 인터페이스를 구현해야 합니다(MUST). oracleId()는 원하는 서명 오프체인 데이터를 만드는 탈중앙 오라클 네트워크를 가리키는 고유 식별자를 돌려줍니다. 원문은 오라클 ID를 이더리움 생태계의 체인 ID에 비유합니다. 클라이언트가 체인 ID를 보고 RPC 엔드포인트를 찾듯, 오라클 ID에 대응하는 게이트웨이를 찾을 것으로 기대됩니다. fulfillOracleQuery(bytes signedOffchainData)는 서명된 오프체인 데이터를 받아 검증하고 온체인에 기록합니다. signedOffchainData에서 oracleQuery를 끌어낼 수 있어야 하며 그래야 오라클 컨트랙트가 질의를 기준으로 검증된 데이터를 제공할 수 있습니다.
수수료 처리: FeeRequired
질의 처리에 비용이 필요하면 IERC7412 구현 컨트랙트는 error FeeRequired(uint amount)로 리버트해야 합니다(MUST). amount는 fulfillOracleQuery 실행에 필요한 네이티브 가스 토큰의 양을 wei 단위로 나타냅니다. 호출자가 수수료를 걷을 수 있을 만큼 충분한 msg.value를 보내면 이 에러는 해소되어야 합니다. 다만 amount보다 많이 보낸 가스 토큰은 돌려주지 않을 수 있습니다(MAY NOT). 원문은 실제로는 수수료가 거의 일정하게 유지될 것으로 예상한다고 적습니다. 이 구조는 데이터 소비자에게서 수수료를 걷어 탈중앙 오라클 네트워크의 노드 운영자에게 제공하는 경제적 유인을 만듭니다.
여러 요청 묶기: Errors 배열
여러 가격 피드를 동시에 쓰는 프로토콜처럼 오라클 데이터 요청이 여러 개 필요한 경우를 위해, 인터페이스는 error Errors(bytes[] errors)라는 묶음 에러를 둘 수 있습니다(MAY). 이렇게 하면 클라이언트가 한 번의 트랜잭션 시뮬레이션에서 여러 OracleDataRequired 에러를 효율적으로 처리할 수 있어 별도 요청 횟수가 줄어듭니다. 이 에러를 만난 클라이언트는 배열 안의 에러를 하나씩 해석해 처리해야 하며 중첩된 에러 객체가 있으면 재귀를 쓸 수 있습니다.
멀티콜 구성 책임과 지갑 지원
멀티콜을 어떻게 구성할지는 클라이언트의 책임입니다. 필요한 fulfillOracleQuery 호출을 원래 호출보다 앞에 두어 하나의 원자적 트랜잭션으로 묶습니다. ERC-4337 계정 추상화를 지원하는 지갑은 이미 원자적 다중 작업을 만들 수 있고 EOA(외부 소유 계정) 지원을 위해서는 프로토콜이 ERC-2771을 구현할 수도 있습니다. 일반 멀티콜 컨트랙트는 msg.sender나 msg.data를 참조하지 않는 함수로만 멀티콜을 구성할 수 있다는 제약이 있습니다. 한편 oracleId로 URI를 쓰고 oracleQuery에 URI를 지정하면, ERC-3668과 비슷하게 클라이언트 라이브러리를 고치지 않고도 임의의 온체인 URI와 호환되게 만들 수 있습니다.
ERC-3668과의 차이
이 제안은 사실상 ERC-3668의 대안입니다. 에러 구성이 매우 단순해서 구현자는 의존할 오라클 네트워크, 그 네트워크가 받는 질의 형식, 데이터를 받을 컨트랙트만 알면 됩니다. 콜백 대신 멀티콜에 의존하므로 중첩된 호출이 서로 다른 오프체인 데이터를 요구하는 상황을 훨씬 단순하게 다룰 수 있습니다. 계정 추상화 클라이언트를 쓰는 경우를 포함해 최종 사용자는 호출 내부 구조가 아무리 복잡해도 트랜잭션 하나에 서명하면 되고 클라이언트가 필요한 오프체인 데이터를 자동으로 앞에 붙입니다. 또 오라클 제공자는 무제한의 네트워크를 확장성 있게 지원할 수 있고 프로토콜 개발용 로컬·포크 네트워크와도 호환됩니다.
참조 구현이 보여 주는 동작
원문의 클라이언트 의사코드는 원하는 트랜잭션을 시뮬레이션하다가 OracleDataRequired 에러가 나면 오프체인 데이터를 받아 와 검증 트랜잭션을 멀티콜 맨 앞에 추가하고 에러가 사라질 때까지 이를 반복합니다. 오라클 컨트랙트 예시는 검증된 데이터를 latestVerifiedData 매핑에 저장합니다. 저장된 데이터의 타임스탬프가 STALENESS_TOLERANCE(86400초, 하루)보다 오래되면 다시 OracleDataRequired로 리버트합니다. 상위 컨트랙트 예시인 CrosschainAdder의 개발자는 표준 구현을 신경 쓸 필요 없이 온체인 데이터를 읽듯 오라클 컨트랙트 함수를 호출하면 됩니다. 이런 크로스체인 함수는 두 체인 ID가 배포된 체인 자신을 가리키게 해서 연산이 많은 뷰 함수를 밖에서 돌리고 온체인의 O(n) 이상 반복을 피하는 데도 쓸 수 있습니다.
제안 상태: Draft
이 문서는 원문 기준 Draft(초안) 상태의 표준 추적(Standards Track) ERC입니다. 2023년 7월 26일에 만들어졌고 아직 확정되지 않았으므로, 에러 형식이나 인터페이스 등 명세 내용이 앞으로 바뀔 수 있습니다. 구현하거나 의존하기 전에 최신 원문을 확인하는 것이 좋습니다.
쓸 때 주의할 점
- 멀티콜이 트랜잭션 내용을 가릴 수 있음: 정교한 트랜잭션 해석 기능이 없는 지갑에서는 멀티콜에 의존하는 구조 때문에 트랜잭션 내용이 가려질 수 있습니다. 멀티콜은 이 표준과 무관하게 프로토콜 개발에서 점점 흔해지고 있어 지갑 개발자들이 이미 다루고 있는 과제입니다.
- 데이터 유효성 확인은 검증자 컨트랙트의 책임: 오라클 네트워크가 제공한 데이터의 유효성을 확인하는 것은 검증자 컨트랙트의 책임입니다. 이 표준 자체가 잘못된 데이터가 스마트 컨트랙트에 제공될 새로운 기회를 만드는 것은 아닙니다.