ERC-6900 모듈형 스마트 컨트랙트 계정 (Modular Smart Contract Accounts)

Draft · 계정·지갑 · 2023-04-18 작성

스마트 컨트랙트 계정의 검증·실행·훅 로직을 모듈이라는 외부 컨트랙트로 분리해 표준을 따르는 어떤 계정에든 설치하고 제거할 수 있게 하는 표준입니다.

왜 필요한가

ERC-4337 계정 추상화(Account Abstraction) 덕분에 세션 키, 구독 결제, 지출 한도, 역할 기반 접근 제어 같은 기능을 계정의 검증·실행 로직을 바꿔 구현할 수 있게 되었습니다. 그런데 지금은 이런 기능이 특정 계정 구현에 내장되어 있거나, Safe 모듈처럼 특정 플랫폼 전용 모듈 체계로만 제공됩니다. 그 결과 사용자는 원하는 기능에 따라 여러 계정 구현을 오가야 해서 계정이 기능과 보안 설정별로 쪼개지고 데이터 이동성이 떨어집니다. 모듈 개발자도 어느 플랫폼을 지원할지 골라야 해서 플랫폼 종속이 생기거나 같은 기능을 여러 번 개발해야 합니다. 이 표준은 계정 개발자와 모듈 개발자의 구현 작업을 조율하는 공통 규격을 정의해 표준을 따르는 모든 모듈을 지원하는 모듈형 계정을 만들 수 있게 합니다.

구현해야 하는 것

심층 설명

세 가지 모듈러 함수와 기본 구조

이 표준은 계정 기능을 세 범주로 나눕니다. 검증 함수(validation function)는 계정을 대신해 수행되는 행동의 권한을 확인하고 실행 함수(execution function)는 계정이 허용한 커스텀 로직을 실행하며 훅(hook)은 그 전후에 추가 로직과 점검을 수행합니다. 훅은 다시 검증 함수 앞에서 도는 검증 훅과, 실행 전후에 도는 실행 훅으로 나뉩니다. 실행 훅은 특정 실행 함수 또는 특정 검증 함수에 붙일 수 있고 pre 실행 훅은 post 실행 훅이 소비할 데이터를 반환할 수 있습니다. 모듈은 이 세 종류의 모듈러 함수를 원하는 만큼 담은 배포된 컨트랙트이고 매니페스트는 계정에 설치할 실행 함수, 인터페이스 ID, 훅을 기술합니다. 모듈형 계정은 ERC-4337 EntryPoint를 통한 호출과 EOA·컨트랙트의 직접 호출을 모두 지원합니다.

필수·선택 인터페이스

모듈형 계정은 ERC-4337의 IAccount와 IAccountExecute, 모듈 관리와 실행을 담당하는 IERC6900Account, 그리고 ERC-1271의 isValidSignature를 반드시 구현해야 합니다. 온체인 상태 조회를 위한 IERC6900AccountView와, 모듈이 설치한 인터페이스를 위한 ERC-165는 선택입니다. 모듈은 IERC6900Module을 반드시 구현하고 이에 대한 ERC-165를 지원해야 하며 역할에 따라 IERC6900ValidationModule, IERC6900ValidationHookModule, IERC6900ExecutionModule, IERC6900ExecutionHookModule을 선택적으로 구현합니다. 계정과 모듈의 식별자는 각각 "vendor.account.semver", "vendor.module.semver" 형식이어야 합니다.

패킹된 타입: ModuleEntity, ValidationConfig, HookConfig

모듈 함수는 모듈 주소 20바이트와 엔티티 ID 4바이트를 합친 bytes24 타입 ModuleEntity로 식별합니다. 엔티티 ID는 한 모듈 안의 여러 내부 구현으로 호출을 라우팅하는 식별자입니다. ValidationConfig는 여기에 플래그 1바이트를 더한 bytes25로, isGlobal, isSignatureValidation, isUserOpValidation 세 플래그를 담습니다. HookConfig도 bytes25로, 실행 훅의 hasPre와 hasPost, 그리고 훅 종류(0이면 실행 훅, 1이면 검증 훅) 플래그를 담습니다. 이런 패킹 덕분에 검증 함수와 훅을 저장하고 전달할 때 하나의 짧은 값으로 다룰 수 있습니다.

세 가지 검증 흐름과 적용 범위 검사

검증은 유저 오퍼레이션 검증(validateUserOp), 런타임 검증(executeWithRuntimeValidation 또는 직접 호출 검증), 서명 검증(isValidSignature) 세 경로로 일어납니다. 각 경로에서 계정은 먼저 해당 검증 함수가 실행하려는 셀렉터에 적용되는지 확인하고 그 검증 함수에 연결된 같은 종류의 검증 훅을 모두 실행한 뒤 검증 함수를 호출해야 합니다. 훅이나 검증 함수가 revert하면 계정도 revert해야 합니다. 훅별 데이터는 유저 오퍼레이션에서는 userOp.signature, 런타임에서는 authorization, 서명 검증에서는 signature 필드로 전달하는 것이 권장됩니다. 유저 오퍼레이션 검증의 결과 시간 범위는 훅들과 검증 함수가 반환한 범위의 교집합이어야 하고 하나라도 authorizer로 1(서명 실패)을 반환하면 계정도 1을 반환해야 합니다. isUserOpValidation이나 isSignatureValidation 플래그가 꺼진 검증 함수를 해당 용도로 쓰려 하면 revert해야 하며 execute나 executeBatch의 대상이 계정 자신이면 내부 셀렉터에 대한 검증 적용 여부를 추가로 확인하거나 revert해야 합니다.

직접 호출 검증(direct call validation)

엔티티 ID 0xffffffff로 설치된 검증 함수는 직접 호출 검증으로 쓰입니다. 모듈이나 다른 주소가 executeWithRuntimeValidation으로 감싸지 않고 계정 함수를 직접 호출하면, 계정은 이를 호출자 주소와 엔티티 ID 0xffffffff 조합의 검증 시도로 취급해야 합니다. 그런 검증 함수가 설치되어 있고 호출하려는 함수에 적용된다면, 계정은 런타임 검증을 수행하지 않고 호출을 계속 허용해야 합니다. 다만 그 검증 함수에 설치된 검증 훅과 실행 훅은 여전히 실행되어야 합니다. 이 방식으로 특정 주소에게 계정의 일부 기능에 대한 직접 접근 권한을 줄 수 있습니다.

실행 흐름과 훅 순서

executeWithRuntimeValidation을 제외한 IERC6900Account의 상태 변경 함수, 모듈이 정의한 실행 함수, 계정의 네이티브 함수는 공통 실행 절차를 따라야 합니다. 호출자가 EntryPoint나 계정 자신이 아니면 직접 호출 검증의 접근 제어를 확인합니다. 대상 함수 전에 적용되는 모든 pre 실행 훅을 실행하는데, 검증 함수에 연결된 훅을 먼저, 셀렉터에 연결된 훅을 나중에 실행해야 합니다. 대상 함수 실행 후 post 실행 훅은 pre 훅의 역순으로 실행해야 하고 pre와 post를 겸하는 훅이 비어 있지 않은 bytes를 반환했다면 그 데이터를 post 훅에 넘겨야 합니다. 실행할 훅 집합은 실행 단계 시작 시점의 계정 상태로 고정되어야 하며 실행 중에 훅 구성이 바뀌어도 원래 집합이 끝까지 실행됩니다. 훅 실행 순서는 먼저 설치된 것이 먼저 실행되는 방식이 권장됩니다.

설치와 제거 규칙

검증 함수를 설치할 때 계정은 사용자가 지정한 검증 훅과 실행 훅을 모두 설치하고 지정한 셀렉터들을 검증하도록 구성하며 isGlobal 같은 플래그를 지정대로 설정하고 ValidationInstalled 이벤트를 발생시켜야 합니다. 제거할 때는 플래그와 셀렉터 구성을 모두 지우고 훅을 모두 제거해야 하며 onUninstall의 revert는 계정 설계에 따라 try/catch로 무시할 수 있습니다. 실행 모듈 설치는 매니페스트를 따르는데, 실행 함수 셀렉터는 계정 안에서 유일해야 하고 네이티브 ERC-4337, ERC-6900 함수와 충돌하면 안 됩니다. 설치·제거 시 각각 ExecutionInstalled, ExecutionUninstalled 이벤트를 발생시켜야 합니다. 기본 검증 같은 일부 기능을 코어에 내장한 세미 모듈러 계정도 허용되며 이 경우에도 완전 모듈형 계정과의 호환성을 유지하는 것이 권장됩니다.

제안 상태

이 제안은 Draft 상태입니다. 아직 명세가 바뀔 수 있는 단계이므로 구현 시 최신 원문을 확인해야 합니다. 원문은 현재 ERC-4337을 호출 흐름의 하나로 요구하지만 롤업의 네이티브 계정 추상화처럼 ERC-4337을 쓰지 않는 모듈형 계정이 등장할 수 있어 표준이 생태계의 연구와 채택에 맞춰 함께 진화할 것이라고 밝히고 있습니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs