ERC-7988 미니멀 아바타 스마트월렛(MASW) (Minimal Avatar Smart Wallet (MASW))
Draft · 계정·지갑 · 2025-07-08 작성
EOA가 EIP-7702로 지정할 수 있는 불변 코드의 위임 지갑으로, 서명된 배치 호출과 가스 대납을 하나의 고정 ABI로 제공해 지갑별 인터페이스 파편화를 줄입니다.
왜 필요한가
EIP-7702는 EOA가 트랜잭션마다 임의의 컨트랙트 코드를 위임받아 실행하게 해 주지만, 각 지갑이 서로 다른 ABI와 수수료 정산 방식을 쓰면 문제가 커집니다. dApp과 릴레이어는 지갑마다 별도의 어댑터를 만들어야 하고, 가스 대납(스폰서십)은 수수료 지급 경로가 지갑마다 달라지면 릴레이어가 예측 가능한 보상을 기대하기 어려워져 대납 거래량이 늘지 않습니다. 또한 인덱서, 디버거, 정적분석 도구는 지갑마다 다른 바이트코드와 호출 구조를 각각 해석해야 하므로 디코딩과 가스 추정의 정확도가 떨어집니다. 커스터마이징을 어디까지 허용할지 기준이 없으면 보안 검증 범위도 지갑마다 달라져, 연구와 보안 강화 노력이 분산됩니다.
구현해야 하는 것
function setPolicyModule(address newModule) external;: 배치 실행 전후 검증을 담당하는 Policy 모듈 주소를 교체합니다.function setRecoveryModule(address newModule) external;: 서명 검증을 대체할 Recovery 모듈 주소를 교체합니다.event BatchExecuted(bytes32 indexed structHash);: 배치 실행이 끝났을 때 구조체 해시(structHash)를 기록합니다.event ModuleChanged(bytes32 indexed kind, address oldModule, address newModule);: Policy 또는 Recovery 모듈이 교체되었을 때 이전·새 모듈 주소를 기록합니다.function postCheck(address sender, bytes calldata rawData, uint256 value) external view returns (bool);: 배치 실행 후 같은 방식으로 검사해 통과 여부를 반환합니다.function isValidSignature(bytes32 hash, bytes calldata sig) external view returns (bytes4);: 주어진 해시와 서명이 유효한지 검사해 유효하면 0x1626ba7e를 반환합니다.
심층 설명
executeBatch 검증 단계
targets·values·calldatas 배열 길이가 서로 같고 0보다 커야 하며, block.timestamp가 expiry 이하여야 합니다. 저장된 metaNonce가 서명에 쓰인 값과 일치해야 하며 일치 확인 후 증가합니다. EIP-712 다이제스트를 복구해 owner와 일치하거나, recoveryModule이 설정돼 있으면 그 모듈의 승인을 받아야 유효합니다.
정책 모듈 훅
policyModule이 0이 아니면 호출 목록 실행 전에 preCheck가, 실행 후에 postCheck가 호출됩니다. 두 함수 모두 sender, rawData, 총 전송 ETH 값(value)을 받아 true를 반환해야 통과하며, revert나 false를 반환하면 배치 전체가 거부됩니다. 여러 하위 정책을 연결해 첫 실패 지점에서 멈추는 집계기 구조도 허용됩니다.
복구 모듈
recoveryModule이 설정된 경우 isValidSignature(hash, sig)가 서명 검증을 대신 수행하며, 유효한 서명이면 반드시 0x1626ba7e를 반환해야 합니다. 이를 통해 owner의 개인키 서명 외에 대체 인증 수단을 꽂아 넣을 수 있습니다.
가스 대납과 수수료 구조
릴레이어와 owner는 사전에 오프체인에서 (token, fee)를 합의하고, 이 값은 서명된 배치 데이터에 포함되므로 릴레이어가 임의로 수수료를 올릴 수 없습니다. 같은 서명된 배치를 다른 릴레이어가 먼저 전파하면 그쪽이 수수료를 가져가고 원래 트랜잭션은 반드시 되돌려지며, 이 때문에 릴레이어 간 경쟁은 자연스럽게 정렬됩니다. 릴레이어는 제출 전에 아바타의 잔액을 미리 확인해야 하며, 자금이 부족하면 트랜잭션이 멤풀에서 무효 처리됩니다.
도메인 분리자 구성
DOMAIN_SEPARATOR는 EIP712Domain 타입 해시에 이름 "MASW", 버전 "1", 실제 체인ID(block.chainid, 0 사용 금지), 그리고 _owner를 인코딩해 만듭니다. verifyingContract 자리에 owner를 넣어 위임 전후로 분리자가 동일하게 유지되도록 설계했습니다.
저장 슬롯 구조
슬롯 0은 단조 증가하는 metaNonce, 슬롯 1은 재진입 가드 플래그 _entered, 슬롯 2는 Policy 모듈 주소, 슬롯 3은 Recovery 모듈 주소입니다. owner와 DOMAIN_SEPARATOR는 immutable로 선언되어 별도의 저장 슬롯을 차지하지 않습니다.
논스 경합(Nonce-Race)
MASW는 배치별이 아닌 전역 단일 metaNonce를 사용합니다. 두 릴레이어가 같은 논스로 동시에 제출하면 하나는 성공하고 하나는 되돌려집니다. expiry를 보통 30초 이하로 짧게 설정해 경합의 영향을 낮추도록 권장하며, 지갑 UI는 이런 실패를 사용자에게 보여줘야 합니다.
제안 상태
이 ERC는 현재 Draft 상태로, 아직 확정되지 않았으며 세부 조항이나 ABI 구성이 앞으로 바뀌거나 논의가 중단될 수 있습니다.
쓸 때 주의할 점
- 동일 체인 재전송(Replay): 같은 체인에서 서명된 배치가 다시 제출되는 것을 막기 위해 전역 metaNonce를 사용해 한 번 쓰인 서명은 재사용할 수 없습니다.
- 크로스체인 재전송: 도메인 분리자에 실제 chainId를 바인딩해, 한 체인에서 서명된 배치가 다른 체인에서 재사용되는 것을 방지합니다.
- 수수료 과다 청구·프런트러닝: fee가 서명된 데이터 안에 포함되어 릴레이어가 임의로 수수료를 올릴 수 없으며, 선점 경쟁에 따른 위험은 릴레이어가 부담합니다.
- 재진입 공격: nonReentrant 가드를 사용하며, 외부 호출 전(논스 증가)과 후(수수료 지급)에만 상태를 변경해 재진입 경로를 차단합니다.
- 악성 모듈 교체: 핵심 로직은 불변이며 Policy·Recovery 모듈을 교체하려면 owner가 서명한 트랜잭션이 필요해 임의 모듈 교체를 막습니다.