ERC-7579 최소 모듈형 스마트 계정 표준 (Minimal Modular Smart Accounts)

Draft · 계정·지갑 · 2023-12-14 작성

기능을 모듈이라는 외부 컨트랙트로 분리한 스마트 계정이 서로 호환되도록, 계정과 모듈이 지켜야 할 최소한의 인터페이스와 동작을 정합니다.

왜 필요한가

스마트 컨트랙트로 만든 계정은 서명 검증이나 자동 실행 같은 기능을 모듈로 떼어내 붙였다 뗐다 할 수 있게 만드는 추세입니다. 그런데 지금은 계정마다 만드는 방식이 제각각이라, 한 계정용으로 만든 모듈을 다른 계정에서 쓸 수 없는 모듈 파편화가 생기고 사용자는 한 번 고른 계정 제품에 묶이는 종속(벤더 락인) 문제를 겪습니다. 지갑 앱이나 개발 도구 입장에서도 계정마다 다른 방식을 일일이 지원해야 합니다. 이 표준은 계정 구현 방식 자체는 최대한 자유롭게 두면서 실행과 설정, 모듈 연결에 필요한 공통 인터페이스만 정해 모듈 생태계가 여러 계정에서 함께 돌아가게 하려는 제안입니다.

구현해야 하는 것

심층 설명

모듈 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(초안) 상태로, 내용이 아직 바뀔 수 있습니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs