ERC-7405 이동 가능한 스마트 컨트랙트 계정 (Portable Smart Contract Accounts)
Draft · 계정·지갑 · 2023-07-26 작성
스마트 컨트랙트 계정을 쓰던 지갑 서비스에서 다른 지갑 서비스로 옮길 수 있게 하는 표준입니다. 새로 만든 마이그레이션 키 하나로, 일반 계정의 개인키 내보내기와 비슷하게 계정을 이전합니다.
왜 필요한가
컨트랙트 코드로 움직이는 스마트 컨트랙트 계정(Smart Contract Account, SCA)은 ERC-4337 표준 도입 이후 널리 쓰이게 되었지만 개인키 하나로 움직이는 일반 계정(EOA)과 달리 지갑 회사마다 구현 코드가 제각각입니다. 그래서 서로 호환되지 않고 사용자가 계정을 다른 지갑 서비스로 옮기기가 어렵습니다. 계정을 부품처럼 조립하는 모듈형 방식도 제안됐지만 구현 비용이 크고 지갑 구현에 전제 조건이 붙어서 자기 방식의 구현을 선호하거나 컨트랙트를 단순하게 유지하려는 지갑 회사 모두에 맞는 답이 되지 못했습니다. 지금 커뮤니티에는 어떤 구현에든 쓸 수 있는 범용 계정 이전 표준이 없습니다. 이 제안은 프록시(ERC-1967) 계층에서 동작하는 이전 방식을 정의해, 개인키나 니모닉으로 EOA를 내보내는 것과 비슷한 경험을 SCA에도 제공합니다.
구현해야 하는 것
function cancelAccountMigration() external: 진행 중인 계정 이전을 취소합니다. 계정 본인 확인을 반드시 수행합니다.function deleteMigrationData(address randomOperator) external: 이전 기록을 삭제합니다. 기록의 account가 msg.sender인지 반드시 확인해야 합니다.
심층 설명
마이그레이션 키와 랜덤 오퍼레이터
이전할 때마다 반드시 새로 무작위 생성한 니모닉이나 개인키를 씁니다. 이 키의 공개키에 대응하는 주소가 랜덤 오퍼레이터(random operator) 주소이고, 레지스트리에서 계정을 찾는 열쇠 역할을 합니다. 니모닉을 쓰는 경우 파생되는 마이그레이션 개인키는 BIP 44 규격의 m/44'/60'/0'/0/0' 경로를 따릅니다. 사용자 입장에서는 개인키나 니모닉으로 EOA를 내보내는 것과 비슷한 경험이 되고 매번 새 키를 쓰기 때문에 같은 키의 재사용으로 생기는 재전송 공격이나 악의적 서명을 막습니다.
MigrationOp 서명 방식
이전 동작은 반드시 마이그레이션 개인키로 MigrationOp 구조체에 서명해야 합니다. 구조체는 chainID, selector, data 세 필드로 구성됩니다. selector가 prepareAccountMigration(address,bytes)에 해당하면 값은 0x50fe70bd이고 data는 abi.encode(randomOperator)입니다. selector가 handleAccountMigration(address,bytes,bytes)에 해당하면 값은 0xae2828ba이고 data는 abi.encode(randomOperator, setupCalldata)입니다. 서명은 ERC-191 방식으로 만들며 서명 대상인 MigrateOpHash는 abi.encode(chainID, selector, data)로 계산합니다.
프로토콜 계층의 공유 레지스트리
마이그레이션 자격 증명을 단순하게 유지하고 마이그레이션 니모닉이나 개인키만으로 계정을 바로 찾을 수 있도록, 프로토콜 계층에 배포되는 공유 레지스트리를 요구합니다. 레지스트리는 랜덤 오퍼레이터 주소를 키로 MigrationData 구조체(account, createTime, lockUntil)를 보관합니다. setMigrationData는 migrationDataMap[randomOperator]가 비어 있는지 반드시 확인해야 하고 deleteMigrationData는 migrationDataMap[randomOperator].account가 msg.sender인지 반드시 확인해야 합니다. 이 덕분에 다른 계정의 이전 기록을 덮어쓰거나 지우는 일을 막습니다.
이전 절차: 준비, 처리, 취소
준비 단계에서 prepareAccountMigration은 내부 메서드 _requireAccountAuth()로 계정 본인 확인을 하고(예: ERC-4337 구현이면 msg.sender == address(entryPoint)), 서명을 검사하고 레지스트리에 같은 랜덤 오퍼레이터가 없는지 확인한 뒤, 계정을 잠그고 setMigrationData(randomOperator, lockUntil)로 기록을 남깁니다. 잠금은 cancelAccountMigration이나 handleAccountMigration이 성공할 때까지 유지됩니다. 처리 단계에서 handleAccountMigration은 계정 본인 확인을 하지 않아야 하며 서명을 검사하고 migrationData.account == address(this)와 block.timestamp > migrationData.lockUntil을 요구합니다. 이어 _beforeWalletMigration()으로 지갑 A의 사전 정리 로직을 실행하고 ERC-1967 프록시 구현을 지갑 B 구현으로 바꾸고 address(this).call(initData)로 초기화한 뒤 레지스트리 기록을 지우고 AccountMigrated 이벤트를 냅니다. 취소 단계에서 cancelAccountMigration은 본인 확인 후 잠금을 풀고 기록을 지웁니다.
저장소 레이아웃 규칙
서로 다른 지갑 구현 사이를 오갈 때 저장소가 겹쳐 값이 덮어써지는 사고를 막기 위한 규칙입니다. 구현 컨트랙트는 상태 변수를 컨트랙트 머리에 직접 선언해서는 안 되고 모든 상태 변수를 하나의 구조체로 감싸 특정 슬롯에 저장해야 합니다. 슬롯 인덱스는 구현마다 고유해야 합니다. 네임스페이스는 A-Za-z0-9_ 문자만 쓸 수 있고 foo_wallet_v1처럼 지갑 이름과 주 버전 번호를 snake_case로 넣기를 권장합니다. 슬롯 ID는 {namespace}.{customDomain} 형식(예: foo_wallet_v1.config)을 따르고 슬롯 인덱스는 bytes32(uint256(keccak256(slotID) - 1))로 계산합니다.
적용 범위와 모듈형 방식과의 관계
이 제안은 ERC-1967 프록시 기반의 모든 SCA와 하위 호환되고 ERC-4337을 쓰지 않는 SCA에도 적용됩니다. 구현 컨트랙트에 특별한 전제 조건을 두지 않아 다양한 SCA에 널리 쓸 수 있고 기존 구현을 침해하지 않으면서 운영 비용도 낮습니다. 구현(implementation) 계층에서 동작하는 모듈형 시스템과 달리 프록시 계층에서 동작하므로, 두 접근이 서로 보완하면서 계정 추상화 생태계의 상호운용성과 조합성을 더 높일 수 있습니다.
제안 상태
이 문서는 2023년 7월 26일에 만들어진 Draft(초안) 상태의 표준 트랙 ERC이며 ERC-191과 ERC-1967을 전제로 합니다. 초안 단계이므로 인터페이스, 셀렉터 값, 레지스트리 설계 같은 세부 내용이 앞으로 바뀔 수 있고 아직 확정된 표준이 아니라는 점을 감안해야 합니다. 구현을 검토하는 개발자는 원문 저장소에서 최신 상태를 확인하는 것이 좋습니다.
쓸 때 주의할 점
- 이전마다 새 키 생성: 재전송 공격이나 악의적 서명을 막기 위해, 이전할 때마다 반드시 새로 무작위 생성한 마이그레이션 니모닉이나 개인키와 그에 대응하는 랜덤 오퍼레이터 주소를 써야 합니다.
- 저장소 레이아웃 독립성: 지갑 구현마다 저장소 레이아웃의 독립성을 지켜야 합니다. 그렇지 않으면 이전 후 저장소가 충돌할 수 있습니다.
- 타임락과 잠금 중 금지 동작: 악의적 이전으로 소유자가 즉시 접근을 잃지 않도록 타임락을 둡니다. 잠금 기간 동안 사용자는 원래 계정 인증으로 이전을 취소할 수 있습니다. 잠금 상태의 계정은 모든 형태의 자산 이체, 외부 컨트랙트 호출, 계정 인증 요소 변경 시도, 그리고 이 세 가지에 영향을 줄 수 있는 동작을 허용하지 않아야 합니다.
- 이전 사실 통지: 이전을 수행할 때 지갑 제공자는 사용할 수 있는 모든 메시지 채널로 계정 소유자에게 이전 내용을 알리려고 해야 합니다.