ERC-7985 게이트웨이 메시지 제어 속성 (Gateway Attributes for Message Control)

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

ERC-7786 크로스체인 메시지 게이트웨이를 위해 취소, 전송 시간창, 재시도, 메시지 순서, 최소 가스 등을 지정하는 표준 속성을 정의합니다.

왜 필요한가

ERC-7786은 크로스체인 메시지 게이트웨이를 위한 확장 가능한 속성 체계를 정의했지만 구체적인 속성 표준화는 후속 명세로 미뤄두었습니다. 그 결과 메시지를 취소하거나 유효기간을 두는 방식, 실패했을 때 재시도하는 방식, 실패를 알리는 방식, 여러 메시지의 전송 순서를 보장하는 방식, 전송에 필요한 가스를 확보하는 방식이 게이트웨이마다 제각각 구현되고 있습니다. 이렇게 되면 같은 기능을 쓰려는 애플리케이션도 게이트웨이마다 다른 통합 로직을 따로 작성해야 하고 생태계 전체가 서로 호환되지 않는 방식으로 쪼개지는 문제가 생깁니다.

구현해야 하는 것

심층 설명

cancellable(bool): 메시지 취소

셀렉터 0xde986d7f(keccak256("cancellable(bool)")의 첫 4바이트)를 사용합니다. 값은 ABI 인코딩된 불린이며 지정하지 않으면 false로 취급될 수 있습니다. true로 설정되면 게이트웨이는 조건이 바뀌거나 요구사항이 변경됐을 때 애플리케이션이 대기 중인 메시지를 취소할 수 있는 메커니즘을 반드시 제공해야 합니다.

deliverBefore/deliverAfter: 전송 시간창

deliverBefore(uint256)는 셀렉터 0x3e97d7ee를 쓰며 지정된 유닉스 타임스탬프 이후로는 메시지를 전송할 수 없습니다. 값이 0이면 만료가 없다는 뜻입니다. deliverAfter(uint256)는 셀렉터 0x745910eb를 쓰며 지정된 타임스탬프 이전에는 전송할 수 없습니다. 값이 0이면 지연이 없다는 뜻입니다. 두 속성을 함께 쓰면 전송 가능한 시간 구간을 만들 수 있습니다. 두 값 모두 지정하지 않으면 0으로 취급될 수 있습니다.

retryPolicy(bytes): 재시도 정책

셀렉터 0xf002c055를 쓰고 abi.encodePacked(uint16 maxRetries, uint32 retryDelay, uint32 backoffMultiplier) 형식으로 인코딩합니다. maxRetries는 최대 재시도 횟수(0이면 재시도 없음), retryDelay는 재시도 간 초 단위 초기 지연, backoffMultiplier는 베이시스 포인트 단위의 지수 백오프 배수(10000이 1배)입니다. 값을 지정하지 않으면 0x로 취급되어 무한 재시도, 지연 없음, 백오프 없음(또는 maxRetries=0, retryDelay=0, backoffMultiplier=0)과 같은 의미가 됩니다.

revertBehavior(uint8): 실패 처리 방식

셀렉터 0x9e521a77를 쓰며 값은 ABI 인코딩된 uint8입니다. 0(Revert on Failure)은 실패 시 전체 메시지 전송을 되돌려야 하며 원래 실패 원인을 전달해야 합니다(SHOULD). 1(Emit-and-Continue)은 실패 시 MessageFailed(bytes32 sendId, string reason) 이벤트를 발생시키고 이후 메시지나 작업 전송을 계속해야 합니다. 2(Silent Failure)는 트랜잭션을 되돌리지도 않고 실패 관련 이벤트도 내지 않아야 합니다. 값을 지정하지 않으면 기본값은 0입니다.

dependsOn(bytes32[]): 메시지 의존성

셀렉터 0xa9fed7b9를 쓰고 메시지 식별자들의 ABI 인코딩된 배열로 값을 지정합니다. 게이트웨이는 dependsOn 배열에 지정된 모든 메시지가 성공적으로 전송되기 전까지 해당 메시지를 전송해서는 안 됩니다. 지정하지 않거나 빈 배열이면 의존성이 없다는 뜻이며 이 메커니즘은 여러 메시지의 순서가 꼬이지 않도록 보장합니다.

minGasLimit(uint256): 최소 가스 요구량

셀렉터 0x39f87ba1를 쓰고 전송에 필요한 최소 가스 단위를 ABI 인코딩된 uint256으로 지정합니다. 게이트웨이는 메시지 전송을 시도하기 전에 최소한 이만큼의 가스가 확보되어 있는지 확인해야 합니다. 지정하지 않으면 게이트웨이는 자체 기본 가스 할당 전략을 쓸 수 있습니다.

구현과 검증 규칙

게이트웨이는 이 속성들을 전부 구현할 필요 없이 독립적으로 선택해 구현할 수 있습니다. 다만 구현하는 속성에 대해서는 반드시 인코딩을 검증해야 하며 인코딩이 잘못됐다면 트랜잭션을 되돌려야 합니다. ERC-7786의 기본 명세가 알려지지 않은 속성을 안전하게 처리하도록 요구하기 때문에, 이 표준을 지원하지 않는 게이트웨이도 정상적으로 동작합니다.

아직 논의 중인 제안

이 문서는 Draft 상태로, 아직 커뮤니티 논의와 수정이 진행 중인 제안입니다. Security Considerations 절은 아직 채워지지 않았고 dependsOn의 순환 의존성 탐지 같은 항목은 주석으로만 언급되어 있어 향후 바뀔 수 있습니다.

ERC 원문 · ← ERCs