ERC-7679 UserOperation 빌더 (UserOperation Builder)

Draft · 계정·지갑 · 2024-04-05 작성

스마트 계정마다 다른 서명·논스·호출 데이터 인코딩 로직을 온체인 컨트랙트로 제공해 계정 전용 SDK 없이도 어떤 스마트 계정의 UserOperation이든 만들 수 있게 하는 표준입니다.

왜 필요한가

ERC-4337 스마트 계정은 구현마다 서명, 논스(nonce), 호출 데이터(calldata)를 다르게 인코딩합니다. 예를 들어 어떤 계정은 executeFoo라는 실행 함수를 쓰고 다른 계정은 executeBar를 쓰기 때문에, 같은 호출을 실행해도 두 계정의 호출 데이터가 달라집니다. 그래서 어떤 계정으로 UserOperation을 보내려면 그 계정이 어떤 구현을 쓰는지 알아내고 그 구현 방식에 맞게 값을 인코딩하거나 계정 전용 SDK를 써야 합니다. 그 결과 지금의 DApp, 지갑, 계정 추상화 도구 대부분은 특정 스마트 계정 구현에 묶여 있고, 이는 생태계 파편화와 공급자 종속(vendor lock-in)으로 이어져 스마트 계정 채택을 가로막습니다. 이 표준은 계정별 인코딩 로직을 체인 위의 빌더 컨트랙트에 올려 이 문제를 풉니다.

구현해야 하는 것

심층 설명

IUserOperationBuilder 인터페이스

표준을 따르는 스마트 계정 구현은 IUserOperationBuilder 인터페이스를 구현한 빌더 컨트랙트를 반드시(MUST) 제공해야 합니다. 인터페이스는 네 가지 view 함수로 구성됩니다. entryPoint는 계정이 지원하는 ERC-4337 EntryPoint 주소를 돌려줍니다. getNonce는 계정 주소와 context를 받아 논스를 돌려줍니다. getCallData는 Execution 구조체(target, value, callData) 배열과 context를 받아 계정 구현에 맞는 호출 데이터를 돌려주며 배열이므로 실행을 배치로 묶을 수 있습니다. formatSignature는 서명 필드를 제외하고 모두 채워진 PackedUserOperation과 context를 받아 올바르게 인코딩된 서명을 돌려줍니다. 모두 view 함수라 작성자는 eth_call로 호출합니다.

작성 절차의 핵심은 두 번의 formatSignature 호출

작성자는 먼저 계정 소유자에게서 UserOpBuilder 주소와 context를 얻습니다. getNonce와 getCallData를 멀티콜로 실행해 논스와 호출 데이터를 얻고 가스값은 임의나 아주 낮게 채운 UserOperation의 해시를 서명한 뒤 formatSignature를 호출해 가스 추정용 더미 서명이 담긴 UserOperation을 만듭니다. 가스 추정이 끝나면 가스값을 추정치로 바꾸고 해시를 다시 서명한 다음 formatSignature를 한 번 더 호출해 완전히 유효한 UserOperation을 얻습니다. UserOperation의 나머지 필드를 어떻게 얻는지는 이 문서의 범위 밖인데, 계정 구현에 크게 의존하는 필드가 논스, 호출 데이터, 서명 세 가지이기 때문입니다.

미배포 계정은 CounterfactualCall로 처리합니다

빌더는 대부분의 경우 계정을 호출해야 정확한 데이터를 줄 수 있는데, 첫 UserOperation을 보내는 시점에는 계정이 아직 배포되지 않았을 수 있습니다. 이때 작성자는 ERC-4337에 정의된 factory와 factoryData를 추가로 얻고 eth_call 안에서 CounterfactualCall 컨트랙트를 배포하는 방식으로 조회할 수 있습니다(MAY). CounterfactualCall은 factory와 factoryData로 계정을 배포하고 배포에 실패하면 되돌리며(revert) 성공하면 UserOpBuilder를 호출해 그 반환값을 작성자에게 돌려줘야 합니다(SHOULD). UserOperation에는 factory와 factoryData를 포함합니다. 이 방식은 미배포 컨트랙트에 isValidSignature를 실행하는 ERC-6492의 메커니즘에서 영감을 받았습니다.

context는 위임 같은 활용을 가능하게 합니다

context는 빌더가 논스, 호출 데이터, 서명을 올바르게 정하는 데 필요한 데이터를 담은 바이트 배열로, 지갑 소프트웨어의 도움을 받아 계정 소유자가 구성하는 것으로 상정합니다. 원문은 위임을 한 가지 활용 예로 듭니다. 소유자가 작성자의 공개키에 서명한 값(authorization)을 context에 넣어 두면, 작성자는 자기 개인키로 서명을 만들고 빌더는 context에서 authorization을 꺼내 작성자의 서명과 이어 붙입니다. 계정은 서명에서 작성자의 공개키를 복원하고 그 공개키가 authorization으로 승인된 것인지 확인한 뒤 실행합니다. 이렇게 하면 작성자가 사용자를 대신해 UserOperation을 실행할 수 있습니다.

더미 서명이 필요한 이유

더미 서명은 번들러에 eth_estimateUserOperationGas로 가스를 추정받을 때 쓰는 서명입니다. 유효한 서명은 UserOperation의 가스값에 의존하는데 가스값은 추정이 끝나야 정해지므로 순환 의존이 생기고 이를 끊기 위해 더미 서명을 씁니다. 다만 더미 서명은 아무 계정이나 쓸 수 있는 고정값이 아닙니다. 실제 서명과 비슷한 양의 가스를 쓰도록 구성해야 하므로 계정의 검증 로직에 따라 달라지고 그래서 계정 구현에 의존합니다. 빌더의 formatSignature가 이 포맷팅을 대신해 주기 때문에 작성자는 검증 로직을 몰라도 됩니다.

EntryPoint 0.7 기준이며 0.6은 구조체 교체가 필요합니다

이 ERC는 EntryPoint 0.7 기준의 모든 ERC-4337 스마트 계정과 하위 호환되도록 설계되었습니다. EntryPoint 0.6으로 배포된 스마트 계정의 경우 IUserOperationBuilder 인터페이스에서 PackedUserOperation 구조체를 EntryPoint 0.6의 해당 구조체로 바꿔야 합니다.

아직 Draft 단계의 제안입니다

이 문서는 2024년 4월 5일에 만들어졌고 상태가 Draft입니다. 내용이 바뀌거나 진행이 멈출 수 있으므로 구현 전에 최신 원문을 확인하는 것이 좋습니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs