ERC-6900 모듈형 스마트 컨트랙트 계정 (Modular Smart Contract Accounts)
Draft · 계정·지갑 · 2023-04-18 작성
스마트 컨트랙트 계정의 검증·실행·훅 로직을 모듈이라는 외부 컨트랙트로 분리해 표준을 따르는 어떤 계정에든 설치하고 제거할 수 있게 하는 표준입니다.
왜 필요한가
ERC-4337 계정 추상화(Account Abstraction) 덕분에 세션 키, 구독 결제, 지출 한도, 역할 기반 접근 제어 같은 기능을 계정의 검증·실행 로직을 바꿔 구현할 수 있게 되었습니다. 그런데 지금은 이런 기능이 특정 계정 구현에 내장되어 있거나, Safe 모듈처럼 특정 플랫폼 전용 모듈 체계로만 제공됩니다. 그 결과 사용자는 원하는 기능에 따라 여러 계정 구현을 오가야 해서 계정이 기능과 보안 설정별로 쪼개지고 데이터 이동성이 떨어집니다. 모듈 개발자도 어느 플랫폼을 지원할지 골라야 해서 플랫폼 종속이 생기거나 같은 기능을 여러 번 개발해야 합니다. 이 표준은 계정 개발자와 모듈 개발자의 구현 작업을 조율하는 공통 규격을 정의해 표준을 따르는 모든 모듈을 지원하는 모듈형 계정을 만들 수 있게 합니다.
구현해야 하는 것
function execute(address target, uint256 value, bytes calldata data) external payable returns (bytes memory);: 계정이 지정한 주소로 값과 호출 데이터를 보내는 표준 실행 함수입니다.function executeBatch(Call[] calldata calls) external payable returns (bytes[] memory);: 여러 호출을 한 번에 실행합니다. 하나라도 실패하면 전체가 되돌려져야 합니다.function executeWithRuntimeValidation(bytes calldata data, bytes calldata authorization) external payable returns (bytes memory);: 어떤 런타임 검증 함수를 쓸지 authorization의 앞 24바이트(ModuleEntity)로 지정해 호출을 실행합니다.function accountId() external view returns (string memory);: 계정 구현의 고유 식별자를 "vendor.account.semver" 형식 문자열로 돌려줍니다.event ExecutionInstalled(address indexed module, ExecutionManifest manifest);: 실행 모듈이 설치될 때 발생하는 이벤트입니다.event ExecutionUninstalled(address indexed module, bool onUninstallSucceeded, ExecutionManifest manifest);: 실행 모듈이 제거될 때 onUninstall 성공 여부와 함께 발생합니다.event ValidationInstalled(address indexed module, uint32 indexed entityId);: 검증 함수가 설치될 때 발생하는 이벤트입니다.event ValidationUninstalled(address indexed module, uint32 indexed entityId, bool onUninstallSucceeded);: 검증 함수가 제거될 때 onUninstall 성공 여부와 함께 발생합니다.function onInstall(bytes calldata data) external;: 설치 시 계정이 호출해 모듈이 해당 계정용 초기 데이터를 설정하게 합니다.function onUninstall(bytes calldata data) external;: 제거 시 계정이 호출해 모듈이 해당 계정용 데이터를 정리하게 합니다.function moduleId() external view returns (string memory);: 모듈의 고유 식별자를 "vendor.module.semver" 형식 문자열로 돌려줍니다.function validateUserOp(uint32 entityId, PackedUserOperation calldata userOp, bytes32 userOpHash) external returns (uint256);: 유저 오퍼레이션 검증을 수행하고 validAfter, validUntil, authorizer를 담은 값을 돌려줍니다.function preUserOpValidationHook(uint32 entityId, PackedUserOperation calldata userOp, bytes32 userOpHash) external returns (uint256);: 유저 오퍼레이션 검증 전에 실행되는 훅으로, authorizer 값은 0 또는 1만 반환해야 합니다.function preSignatureValidationHook(uint32 entityId, address sender, bytes32 hash, bytes calldata signature) external view;: 서명 검증 전에 실행되는 훅입니다. 거부하려면 revert해야 합니다.function executionManifest() external pure returns (ExecutionManifest memory);: 모듈이 계정에 설치할 실행 함수, 훅, 인터페이스 ID를 담은 매니페스트를 돌려줍니다. 시간이 지나도 변하지 않아야 합니다.function preExecutionHook(uint32 entityId, address sender, uint256 value, bytes calldata data) external returns (bytes memory);: 실행 전에 실행되는 훅으로, 후속 post 훅에 넘길 컨텍스트를 반환할 수 있습니다.function postExecutionHook(uint32 entityId, bytes calldata preExecHookData) external;: 실행 후에 실행되는 훅으로, 짝이 되는 pre 훅이 반환한 데이터를 받습니다.
심층 설명
세 가지 모듈러 함수와 기본 구조
이 표준은 계정 기능을 세 범주로 나눕니다. 검증 함수(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을 쓰지 않는 모듈형 계정이 등장할 수 있어 표준이 생태계의 연구와 채택에 맞춰 함께 진화할 것이라고 밝히고 있습니다.
쓸 때 주의할 점
- executionManifest 파라미터 검증: installExecution()에 넘기는 executionManifest 파라미터는 온체인에서 매우 제한적으로만 검사되고 모듈의 executionManifest() 반환값과 반드시 같지도 않습니다. 지갑·SDK는 설치 전에 이 파라미터를 신중히 구성하고 검증해야 하며 제거 시에는 설치에 쓴 것과 같은 매니페스트를 써서 잔여 데이터를 남기지 않는 것이 좋습니다.
- 전역 검증 함수의 루트 권한 위험: 전역 검증이 켜진 검증 함수는 allowGlobalValidation이 켜진 모든 실행 함수를 검증할 수 있어 해당 함수들을 보호하던 제한을 우회할 수 있습니다. 사실상 노출된 네이티브·실행 함수와 계정 전체에 대한 루트 접근을 얻을 수 있으므로, 지갑은 어떤 검증 함수를 전역으로 설치하도록 허용할지 주의해야 합니다.
- 제거 후 잔여 상태: 표준은 모듈 추가·삭제 시 어떤 데이터를 설치·제거해야 하는지 강제하지 않습니다. onUninstall()이 호출되지 않거나 상태를 다 지우지 못하면 잔여 데이터가 남고 제거된 함수에 연결된 실행 훅이 그대로 남을 수 있습니다. 같은 entityId로 모듈을 재설치하면 이전 권한이나 데이터가 의도치 않게 재사용될 수 있으므로 실행 훅을 포함해 관련 데이터를 완전히 제거하는 것이 좋습니다.
- 모듈은 신뢰 대상: 계정 자체는 신뢰되는 구성 요소이고 설치된 모듈은 접근 범위에 따라 다양한 수준으로 신뢰됩니다. 범위가 넓은 악성 모듈은 네이티브 함수 셀렉터에 revert하는 훅을 붙여 계정을 못 쓰게 만들거나 자금을 빼가는 실행 함수를 추가할 수 있습니다. 사용자는 계정에 어떤 모듈을 추가할지 신중해야 합니다.