ERC-7780 ERC-7579 검증 모듈 확장 (Validation Module Extension for ERC-7579)
Draft · 계정·지갑 · 2024-10-01 작성
ERC-7579 모듈형 스마트 계정에 정책, 서명자, 무상태 검증기 같은 새 모듈 유형을 더해 서명 검증과 권한 검사 로직을 부품처럼 조합해 쓸 수 있게 합니다.
왜 필요한가
모듈형 스마트 계정(ERC-7579)에서는 검증기(validator) 모듈이 서명이 올바른지 확인합니다. 그런데 기존 검증기는 호출한 주소(msg.sender)가 계정이라고 전제하고 그 주소로 저장해 둔 설정을 찾아 서명과 비교합니다. 이 구조 때문에 다른 모듈이 이미 잘 만들어진 서명 검증 로직을 그대로 가져다 쓰고 싶어도 쓸 수 없고 새 검증기를 만들 때마다 비슷한 검증 코드를 다시 작성해야 합니다. 또 거래가 무엇을 하려는 것인지 확인해 허용 여부를 정하는 권한 검사 로직을 계정이 직접 쓰고 싶어도 표준화된 모듈 유형이 없어 외부 모듈에 의존해야 했습니다. 이 제안은 정책, 서명자, 무상태 검증기 등 새 모듈 유형을 정의해 이런 로직을 표준화된 방식으로 나누고 재사용할 수 있게 합니다.
구현해야 하는 것
function isModuleType(uint256 moduleTypeId) external view returns (bool);: 모듈이 ERC-7579 기준의 특정 모듈 유형에 해당하는지 여부를 반환합니다.
심층 설명
여섯 가지 새 모듈 유형
ERC-7579의 기존 모듈 위에 Policy(유형 id 5), Signer(6), StatelessValidator(7), PreValidationHookERC1271(8), PreValidationHookERC4337(9), StatelessValidatorWithSender(10)를 추가합니다. 요약부는 정책, 서명자, 무상태 검증기 세 가지를 중심으로 소개하지만 명세는 여섯 개의 유형 id를 정의합니다. 어떤 모듈도 계정이 반드시 구현해야 하는 것은 아니며, 계정이 직접 구현하거나 다른 모듈이 조합용으로 활용할 수 있습니다. 하나의 모듈이 여러 유형을 겸할 수도 있습니다.
Policy 모듈(유형 5)
정책 모듈은 ERC-7579의 IModule과 IPolicy 인터페이스를 반드시 구현해야 합니다. checkUserOpPolicy는 UserOperation이 실행되어도 되는지 검사하며 저장된 설정과 대조해 userOp 안의 실행 내용을 검증하는 것이 권장됩니다(SHOULD). checkSignaturePolicy는 해시를 확인해 서명의 용도와 허용 여부를 판단하는 것이 권장되고 보낸 주소(sender)를 추가로 확인할 수 있습니다(MAY). 두 함수 모두 ERC-4337이 정한 검증 데이터를 uint256으로 반환합니다.
Signer 모듈(유형 6)
서명자 모듈은 IModule과 ISigner 인터페이스를 반드시 구현해야 합니다. checkUserOpSignature는 서명자 설정 id, UserOperation, userOpHash를 받아 서명 검사 결과를 EntryPoint에 돌려줄 값으로 반환합니다. checkSignature는 설정 id, sender, 해시, 서명을 받아 ERC-1271 방식으로 검사하고 서명이 유효하면 ERC-1271 매직 값(bytes4)을 반환합니다. 설정 id(bytes32)를 인자로 받으므로 하나의 모듈이 여러 설정을 구분해 쓸 수 있는 구조입니다.
StatelessValidator(유형 7)
무상태 검증기는 IStatelessValidator 인터페이스를 반드시 구현해야 합니다. validateSignatureWithData는 서명이 해시에 대한 유효한 서명인지 반드시 검증하고(MUST), 검증된 서명을 호출 데이터로 전달받은 data와 반드시 비교해야 하며(MUST), 유효하면 true, 아니면 false를 반드시 반환해야 합니다(MUST). data에는 예를 들어 서명을 대조할 소유자 목록이 들어갈 수 있습니다. 저장된 상태 대신 인자로 받은 값과 비교하므로 msg.sender가 계정이 아니어도 재사용할 수 있습니다. 모든 검증기(유형 1)가 이 인터페이스도 구현하는 것이 권장됩니다(RECOMMENDED).
사전 검증 훅(유형 8, 9)
PreValidationHookERC1271(유형 8)은 IPreValidationHookERC1271을 반드시 구현해야 하며 sender, 해시, 데이터를 받아 hookHash와 hookSignature를 돌려주는 view 함수입니다. PreValidationHookERC4337(유형 9)은 IPreValidationHookERC4337을 반드시 구현해야 하며 UserOperation, missingAccountFunds, userOpHash를 받아 역시 hookHash와 hookSignature를 반환합니다. 각각 ERC-1271 서명 검증과 ERC-4337 검증 단계에 앞서 끼워 넣는 모듈 유형입니다.
StatelessValidatorWithSender(유형 10)
IStatelessValidatorWithSender를 반드시 구현해야 합니다. validateSignatureWithDataWithSender는 의무 사항(서명 검증, data와 비교, true/false 반환이 모두 MUST)이 무상태 검증과 같으면서 account.isValidSignature()를 호출한 주소인 sender를 인자로 추가로 받습니다. 모든 검증기(유형 1)가 이 인터페이스도 구현하는 것이 권장됩니다(RECOMMENDED).
초안 단계의 제안
이 제안의 상태는 Draft로, 내용이 아직 바뀔 수 있습니다. 원문의 Rationale(설계 근거)과 Security Considerations(보안 고려 사항) 절은 TBD로 비어 있어 보안 주의점이 아직 문서화되지 않았습니다. 하위 호환성 문제는 발견되지 않았다고 적혀 있습니다.