ERC-7884 쓰기 작업 리디렉션 라우터 (Operation Router)
Draft · 기타 · 2025-01-23 작성
스마트 컨트랙트가 쓰기 요청을 받았을 때 그 처리를 L1, L2 체인의 다른 컨트랙트, 또는 오프체인 서버로 넘기도록 표준화된 방법으로 알려주는 프로토콜입니다.
왜 필요한가
이더리움 생태계가 커지면서 데이터를 L1, L2, 오프체인 데이터베이스 등 여러 곳에 나눠 저장해야 하는 경우가 늘고 있습니다. 그런데 어떤 쓰기 요청을 어디로 보내야 하는지 알려주는 공통된 방법이 없으면, 컨트랙트마다 서로 다른 방식으로 이를 처리하게 되고 지갑이나 클라이언트 쪽에서는 이를 자동으로 인식해 처리할 수가 없습니다. 또한 오프체인에 데이터를 저장하도록 위임할 때 그 요청이 정말 정당한 사용자로부터 온 것인지 인증하는 표준 방식도 없어서, 매번 각 서비스가 독자적인 인증 체계를 만들어야 하는 비효율이 생깁니다.
구현해야 하는 것
error FunctionNotSupported();: getOperationHandler가 처리할 수 없는, 인코딩된 함수 호출을 받았을 때 발생시키는 에러입니다.error OperationHandledOnchain( uint256 chainId, address contractAddress );: 쓰기 작업이 L1이나 특정 L2 체인의 지정된 컨트랙트에서 처리되어야 함을 알리는 에러입니다.struct DomainData { string name; string version; uint64 chainId; address verifyingContract; }: EIP-712 타입 서명의 도메인을 정의하는 구조체로, 컨트랙트 이름·버전·체인 ID·서명 대상 컨트랙트 주소를 담습니다.struct MessageData { bytes data; address sender; uint256 expirationTimestamp; }: 오프체인 저장 인증을 위한 메시지 컨텍스트로, 원본 ABI 인코딩된 함수 호출, 요청자 주소, 만료 시각을 담습니다.error OperationHandledOffchain( DomainData sender, string url, MessageData data );: 쓰기 작업이 오프체인 엔티티로 넘겨져야 함을 알리는 에러로, EIP-712 도메인 정보, 요청할 URL, 인증 컨텍스트가 포함된 메시지를 함께 담습니다.function getOperationHandler(bytes calldata encodedFunction) external view;: ABI로 인코딩된 함수 호출을 받아, 그것을 처리할 적절한 핸들러를 판별하는 view 함수입니다.
심층 설명
revert를 반환값처럼 쓰는 구조
getOperationHandler는 view 함수이지만 실제 반환값 없이 항상 에러를 revert시켜 정보를 전달하는 방식입니다. 지원하지 않는 함수면 FunctionNotSupported를, 처리 위치가 있으면 OperationHandledOnchain 또는 OperationHandledOffchain을 revert합니다. 클라이언트는 이 호출을 try/catch로 감싸고 revert된 에러의 종류와 인자를 읽어 다음 동작을 결정합니다. CCIP-Read(ERC-3668)에서 쓰인 것과 같은 패턴을 쓰기 작업에 적용한 것입니다.
온체인 라우팅: OperationHandledOnchain
요청이 L1 자신이나 다른 L2 체인의 컨트랙트에서 처리돼야 할 때 쓰입니다. chainId와 contractAddress 두 값만 돌려주며, 클라이언트는 이 정보로 해당 체인에 연결해 실제 쓰기 트랜잭션을 그 컨트랙트로 보냅니다. 구현 예시에서는 selector가 setAddress(bytes32,address)일 때 체인 ID 10(L2)과 특정 주소로 라우팅하도록 되어 있습니다.
오프체인 라우팅: OperationHandledOffchain과 인증
오프체인 데이터베이스로 라우팅할 때는 DomainData(EIP-712 도메인), url(요청할 주소), MessageData(원본 인코딩 데이터, 요청자 주소, 만료 시각)를 함께 돌려줍니다. 클라이언트는 이 MessageData를 EIP-712 방식으로 서명한 뒤 해당 URL로 요청을 보냅니다. HTTP 요청 경로는 ERC-3668이 쓰는 /{sender}/{data}.json 형식을 따라, API가 마치 컨트랙트처럼 동작하게 합니다.
multicall에 대한 제약
getOperationHandler는 넘겨받은 인코딩된 함수 하나만 보고 목적지를 판단하므로, 여러 함수를 한 번에 묶어 호출하는 multicall처럼 서로 다른 컨트랙트로 가야 하는 트랜잭션은 한 번에 처리할 수 없습니다. 이런 경우 각 호출마다 getOperationHandler를 먼저 호출해 목적지를 확인한 뒤, 그 목적지로 순차적으로 실제 트랜잭션을 보내야 합니다.
하위 호환성
이 표준은 기존 인터페이스와 충돌하지 않는 새 인터페이스만 추가하고, 정보 조회에는 view 함수만 사용하며, 기존 저장 방식과 나란히 구현할 수 있어 완전히 하위 호환됩니다.
제안 상태
이 ERC는 현재 Draft 상태로, 아직 내용이 바뀌거나 논의가 더 진행될 수 있는 제안입니다.
쓸 때 주의할 점
- 오프체인 핸들러의 서명 검증: 오프체인 핸들러는 EIP-712 서명을 반드시 검증해야 합니다.
- 접근 제어 구현: 오프체인 핸들러는 적절한 접근 제어(access control)를 구현해야 합니다.
- 동시 수정 처리: 오프체인 핸들러는 동시에 들어오는 수정 요청을 안전하게 처리해야 합니다.
- 요청 속도 제한과 전송 보안: 오프체인 핸들러는 요청 속도 제한(rate limiting)을 두고, 통신에는 HTTPS 같은 안전한 전송을 사용해야 합니다.
- 이상 패턴 모니터링: 공격을 암시할 수 있는 비정상적인 패턴을 모니터링하고, 실패한 트랜잭션에 대한 적절한 에러 처리를 구현해야 합니다.