ERC-7579 최소 모듈형 스마트 계정 표준 (Minimal Modular Smart Accounts)
Draft · 계정·지갑 · 2023-12-14 작성
기능을 모듈이라는 외부 컨트랙트로 분리한 스마트 계정이 서로 호환되도록, 계정과 모듈이 지켜야 할 최소한의 인터페이스와 동작을 정합니다.
왜 필요한가
스마트 컨트랙트로 만든 계정은 서명 검증이나 자동 실행 같은 기능을 모듈로 떼어내 붙였다 뗐다 할 수 있게 만드는 추세입니다. 그런데 지금은 계정마다 만드는 방식이 제각각이라, 한 계정용으로 만든 모듈을 다른 계정에서 쓸 수 없는 모듈 파편화가 생기고 사용자는 한 번 고른 계정 제품에 묶이는 종속(벤더 락인) 문제를 겪습니다. 지갑 앱이나 개발 도구 입장에서도 계정마다 다른 방식을 일일이 지원해야 합니다. 이 표준은 계정 구현 방식 자체는 최대한 자유롭게 두면서 실행과 설정, 모듈 연결에 필요한 공통 인터페이스만 정해 모듈 생태계가 여러 계정에서 함께 돌아가게 하려는 제안입니다.
구현해야 하는 것
function execute(bytes32 mode, bytes calldata executionCalldata) external;: 계정 명의로 거래를 실행합니다. 지원하지 않는 모드가 요청되면 반드시 되돌려야(revert) 합니다.function executeFromExecutor(bytes32 mode, bytes calldata executionCalldata) external returns (bytes[] memory returnData);: 실행자(Executor) 모듈이 호출하는 실행 함수입니다. 각 하위 호출의 반환 데이터를 배열로 돌려줍니다.function executeUserOp(PackedUserOperation calldata userOp, bytes32 userOpHash) external;: ERC-4337 EntryPoint가 호출하는 선택 함수로, userOp.callData를 계정이 실행합니다.function accountId() external view returns (string memory accountImplementationId);: 계정 구현을 식별하는 문자열을 돌려줍니다. vendorname.accountname.semver 형태를 권장합니다.function supportsExecutionMode(bytes32 encodedMode) external view returns (bool);: 계정이 해당 실행 모드를 지원하는지 알려줍니다.function supportsModule(uint256 moduleTypeId) external view returns (bool);: 계정이 해당 모듈 타입을 지원하는지 알려줍니다.event ModuleInstalled(uint256 moduleTypeId, address module);: 모듈이 설치될 때 반드시 발생시키는 이벤트입니다.event ModuleUninstalled(uint256 moduleTypeId, address module);: 모듈이 제거될 때 반드시 발생시키는 이벤트입니다.function installModule(uint256 moduleTypeId, address module, bytes calldata initData) external;: 특정 타입의 모듈을 계정에 설치하고 모듈의 onInstall을 호출합니다. 이미 설치돼 있으면 되돌립니다.function uninstallModule(uint256 moduleTypeId, address module, bytes calldata deInitData) external;: 설치된 모듈을 제거하고 모듈의 onUninstall을 호출합니다. 설치돼 있지 않으면 되돌립니다.function isModuleInstalled(uint256 moduleTypeId, address module, bytes calldata additionalContext) external view returns (bool);: 해당 모듈이 계정에 설치돼 있는지 알려줍니다.function onInstall(bytes calldata data) external;: 계정이 모듈을 설치할 때 모듈 쪽에서 호출되는 초기화 함수입니다. 오류 시 되돌립니다.function onUninstall(bytes calldata data) external;: 계정이 모듈을 제거할 때 모듈 쪽에서 호출되는 해제 함수입니다. 오류 시 되돌립니다.function isModuleType(uint256 moduleTypeId) external view returns(bool);: 모듈이 주어진 타입에 해당하는지 알려줍니다. 한 모듈이 여러 타입일 수 있습니다.function validateUserOp(PackedUserOperation calldata userOp, bytes32 userOpHash) external returns (uint256);: 검증자 모듈이 ERC-4337 UserOperation의 서명이 userOpHash에 대해 유효한지 검증합니다.function isValidSignatureWithSender(address sender, bytes32 hash, bytes calldata signature) external view returns (bytes4);: ERC-1271 서명 검증 요청을 검증자 모듈이 처리합니다. 유효하면 MAGIC_VALUE를 돌려주고 상태를 바꾸지 않습니다.function preCheck(address msgSender, uint256 value, bytes calldata msgData) external returns (bytes memory hookData);: 실행 전에 계정이 훅 모듈에 호출하는 사전 점검 함수입니다. 임의의 hookData를 돌려줄 수 있습니다.function postCheck(bytes calldata hookData) external;: 실행 후에 계정이 훅 모듈에 호출하는 사후 점검 함수로, preCheck가 돌려준 hookData를 검증할 수 있습니다.
심층 설명
모듈 4종과 공통 인터페이스
모듈은 고유한 타입 ID로 구분합니다. 검증(Validation)은 1, 실행(Execution)은 2, 폴백(Fallback)은 3, 훅(Hooks)은 4입니다. 모든 모듈은 IERC7579Module(onInstall, onUninstall, isModuleType)을 구현해야 하고 검증자는 추가로 IERC7579Validator를, 훅은 IERC7579Hook을 구현해야 합니다. 한 모듈이 여러 타입을 겸할 수 있으며 이 경우 onInstall과 onUninstall의 data 안에 moduleTypeId를 넣어 타입별 설치·해제를 처리하는 방식이 제시돼 있습니다. 계정은 설치된 모듈을 저장할 때 타입을 구분할 수 있어야 하는데, 예를 들어 설치된 실행자만 executeFromExecutor를 호출하도록 접근 제어를 걸 수 있어야 합니다. 타입을 구분하지 않으면 검증자가 계정 명의로 임의 거래를 실행하는 보안 문제가 생길 수 있다는 것이 Rationale의 설명입니다.
실행 모드 bytes32 인코딩
execute와 executeFromExecutor는 실행 방식을 bytes32 하나로 인코딩한 mode로 받습니다. 구성은 callType 1바이트(0x00 단일 call, 0x01 배치 call, 0xfe staticcall, 0xff delegatecall), execType 1바이트(0x00 실패 시 revert, 0x01 revert하지 않고 오류 처리), 예약된 unused 4바이트, 커스텀 모드를 만들 수 있는 modeSelector 4바이트, 추가 데이터용 modePayload 22바이트입니다. 계정이 모든 모드를 구현할 필요는 없지만 supportsExecutionMode로 지원 여부를 밝혀야 하고 지원하지 않는 모드가 요청되면 반드시 revert해야 합니다. modeSelector를 4바이트로 한 것은 Solidity 함수 셀렉터와 같은 수준의 충돌 저항성을 주기 위해서이고 modePayload에는 예를 들어 실행 전후에 부를 훅 주소 같은 데이터를 담을 수 있습니다.
실행 데이터 인코딩 규칙
실행 데이터의 인코딩 방식도 정해져 있습니다. 단일 호출은 target, value, callData를 이 순서로 붙여 넣습니다(Solidity의 abi.encodePacked). delegatecall은 target과 callData를 같은 방식으로 붙입니다. 배치 호출은 Execution(address target, uint256 value, bytes memory callData) 구조체 배열로 만든 뒤 패딩을 포함해 인코딩합니다(abi.encode). 또한 계정은 ERC-4337 v0.7의 executeUserOp을 선택적으로 구현할 수 있는데, 이때 셀렉터 4바이트를 제외한 userOp.callData[4:]가 계정에 대한 유효한 호출이 되도록 실행해야 하며 원래 msg.sender를 보존하기 위해 delegatecall로 실행하는 것이 권장됩니다.
계정 설정과 모듈 설정 인터페이스
계정은 IERC7579AccountConfig를 구현해야 합니다. accountId는 비어 있지 않은 문자열을 돌려줘야 하고 vendorname.accountname.semver 구조와 계정 간 고유성이 권장됩니다. 이는 표준화되지 않은 계정별 동작을 프런트엔드 라이브러리가 구분하는 데 쓰입니다. supportsExecutionMode와 supportsModule은 각각 실행 모드와 모듈 타입 지원 여부를 알려줍니다. 모듈 설정 쪽에서는 installModule이 권한 제어를 구현하고 initData와 함께 모듈의 onInstall을 호출하고 ModuleInstalled 이벤트를 내고 이미 설치됐거나 초기화가 실패하면 revert해야 합니다. uninstallModule도 같은 구조로 onUninstall 호출과 ModuleUninstalled 이벤트, 미설치 시 revert를 요구합니다. isModuleInstalled는 additionalContext를 받아 설치 여부를 돌려줍니다.
검증과 ERC-1271 포워딩
검증자 선택을 어떻게 구현할지는 표준이 정하지 않습니다. 다만 계정이 검증자 선택 정보를 데이터 필드(예: ERC-4337의 userOp.signature)에 인코딩한다면, 검증자를 호출하기 전에 해당 값을 반드시 정리(sanitize)해야 합니다. 계정의 검증 함수는 검증자의 반환값을 그대로 돌려주는 것이 권장됩니다. 계정은 ERC-1271 인터페이스를 반드시 구현해야 하며, isValidSignature 호출을 검증자에 넘길 수 있습니다. 포워딩할 때는 isValidSignatureWithSender(sender, hash, signature) 형태로 호출해야 하고 sender는 계정을 호출한 msg.sender입니다. signature 파라미터에 검증자 선택 인코딩이 있다면 역시 정리한 뒤 넘겨야 합니다. 검증자의 validateUserOp은 서명 불일치 시 revert 대신 ERC-4337의 SIG_VALIDATION_FAILED를 돌려주는 것이 권장됩니다.
폴백 핸들러와 훅
계정은 호출을 폴백 핸들러 모듈로 넘기는 fallback 함수를 구현할 수 있습니다. 이때 call이나 staticcall로 핸들러를 호출해야 하고 ERC-2771 방식으로 원래 msg.sender를 calldata에 붙여야 하며 calldata의 함수 셀렉터를 기준으로 핸들러를 라우팅해야 합니다. 폴백 핸들러가 자체 권한 제어를 둔다면 msg.sender 대신 ERC-2771의 _msgSender()를 써야 합니다. 핵심 계정 로직을 폴백으로 구현하는 것은 권장되지 않습니다. 훅은 선택 확장으로, 이를 지원하는 계정은 execute나 executeFromExecutor를 거치는 모든 호출 전후에 훅의 preCheck와 postCheck를 반드시 호출해야 하고 installModule과 uninstallModule 전후 호출도 권장됩니다. 계정이 ERC-165를 구현하는 경우, 기능 대신 revert하는 인터페이스 함수에 대해서는 해당 인터페이스 ID에 false를 돌려줘야 합니다.
ERC-4337 의존과 확장 경로, 제안 상태
이 표준의 검증 흐름은 ERC-4337에 의존합니다. 현재 만들어지는 모듈형 계정이 모두 ERC-4337 기반이기 때문인데, 롤업의 네이티브 계정 추상화처럼 다른 방식이 쓰이기 시작하면 ERC-4337 의존성을 별도 ERC 확장으로 옮겨 선택 사항으로 만드는 업그레이드 경로가 제시돼 있습니다. 새로운 기능 표준화도 핵심 인터페이스를 바꾸지 않고 별도 ERC 확장으로 제안하도록 권장합니다. 이미 배포된 스마트 계정도 프록시라면 호환 구현으로 업그레이드해서, 업그레이드가 불가능한 계정이라면 호환 어댑터를 폴백 핸들러로 추가해서 이 표준을 따를 수 있다고 설명합니다. 이 제안은 현재 Draft(초안) 상태로, 내용이 아직 바뀔 수 있습니다.
쓸 때 주의할 점
- delegatecall 실행 주의: 계정이 delegatecall 실행을 구현할 때는 대상 컨트랙트가 안전한지 반드시 확인해야 합니다. 그렇지 않으면 보안 취약점이 생길 수 있습니다.
- onInstall·onUninstall 콜백 위험: 모듈의 onInstall과 onUninstall은 재진입 같은 예상치 못한 콜백으로 이어질 수 있어 계정이 보호 루틴을 갖춰야 합니다. 악의적인 모듈이 onUninstall에서 일부러 revert해 제거를 막을 수도 있습니다.
- 단일 활성 모듈 교체 시 상태 잔존: 폴백 핸들러처럼 한 번에 하나만 활성화되는 모듈 타입에서, 새 모듈을 installModule로 설치해도 이전 모듈이 제대로 제거되지 않을 수 있습니다. 이전 모듈을 나중에 다시 설치하면 남은 상태 때문에 예상치 못한 동작이 생길 수 있습니다.
- 폴백 핸들러 권한 제어 부족: 폴백 핸들러의 권한 제어가 충분하지 않으면 승인되지 않은 실행이 일어날 수 있습니다.
- 악의적 훅에 의한 서비스 거부: 악의적인 훅이 preCheck나 postCheck에서 revert할 수 있어 신뢰할 수 없는 훅을 추가하면 계정 전체가 동작하지 못하는 서비스 거부가 생길 수 있습니다.