ERC-7902 계정 추상화 지갑 기능 확장 (Wallet Capabilities for Account Abstraction)
Draft · 계정·지갑 · 2025-03-01 작성
EIP-8141 프레임 트랜잭션의 만료 시한, 논스 키, 페이마스터 후원, 원자적 실행, 최근 루트 검증, 사후 조건 확인을 앱이 EIP-5792 capability로 지갑에 요청할 수 있게 합니다.
왜 필요한가
EIP-8141은 트랜잭션을 여러 프레임으로 나누고 프레임을 몇 개 만들지, 어떤 검증을 할지, 누가 가스비를 낼지, 실행 후 무엇을 확인할지를 지갑이 혼자 정합니다. 그런데 이 선택 중 일부는 앱(dApp)이 가진 정보에 따라 달라집니다. 앱은 서로 독립적인 트랜잭션에 각각 다른 논스 키를 쓰고 싶어하고 온체인 증명에 쓴 특정 루트 값을 이미 알고 있으며 가스비를 대신 내줄 페이마스터와 그 데이터를 알고 어떤 호출들이 함께 성공해야 하는지 압니다. EIP-5792로 연결된 지갑과 앱 사이에는 이런 세부 사항을 전달할 표준 방법이 없어서 앱은 지갑이 임의로 내린 선택에 의존할 수밖에 없고 원하는 보장을 받지 못합니다.
심층 설명
호출 분배(Call Dispatch)
지갑은 기본적으로 어떤 프레임이 각 호출을 담을지 정합니다. SENDER 모드 프레임은 호출을 그대로 감싸 sender 계정이 직접 실행하게 하고 DEFAULT 프레임은 계정의 실행 함수를 calldata로 호출합니다. 코드도 EIP-7702 위임도 없는 계정은 EIP-8141 기본 코드가 DEFAULT 프레임에서 아무 호출도 하지 않으므로, 이런 계정에는 반드시 SENDER 프레임을 써야 합니다. 어느 형태를 쓰든 지갑은 요청에 쓰인 순서를 지키고 atomicRequired가 true면 모든 호출을 원자적으로 실행해야 합니다.
eip7702Auth
delegation으로 지정한 구현(주소 또는 지갑이 아는 이름)으로 계정이 위임되어 있는지 확인하는 capability입니다. 대상이 다르면 지갑이 EIP-7702 set-code 트랜잭션을 별도로 서명해 먼저 제출하며 이 트랜잭션은 atomicRequired의 원자성에 포함되지 않고 그 로그도 호출의 로그로 보고되지 않습니다. account가 사용자가 연결하지 않은 계정이거나 EIP-7702 위임 지정자가 아닌 코드를 가진 계정이면 지갑은 요청을 거부해야 합니다.
validityTimeRange와 recentRoots
validityTimeRange는 validUntil을 8바이트 빅엔디언 정수로 담은 expiry_verify 프레임을 트랜잭션의 첫 프레임으로 추가해 만료 시한을 둡니다. recentRoots는 sourceId, slot, root 튜플들을 묶어 recent_root_verify 프레임 하나로 만들며 각 slot은 현재 슬롯보다 낮고 RECENT_ROOT_USABLE_WINDOW 이내여야 합니다. 둘 다 있으면 expiry_verify가 먼저, recent_root_verify가 그다음입니다.
keyedNonce
EIP-8250의 논스 키를 지정합니다. nonceKeys는 최대 16개, 엄격히 증가하는 순서여야 하고 비어 있으면 거부됩니다. 모든 선택된 키는 하나의 공유 시퀀스 번호를 가져야 하며 nonceSeq를 생략하면 지갑이 현재 시퀀스를 읽어 쓰고 0xffffffffffffffff를 주면 단일사용형이 되어 거래 후 그 키들은 다시 쓸 수 없게 됩니다. 새 키를 쓸 때 드는 상태 가스는 수수료 추정에 포함되어야 합니다.
paymasterFrame
정적 폼은 paymaster, data, executionGasLimit을 앱이 직접 주고 서비스 폼은 url과 context로 지갑이 frame_getPaymasterData(스텁 데이터)와 frame_getPaymasterSignature(최종 서명)를 두 차례 호출합니다. pay 프레임은 mode VERIFY, flags APPROVE_PAYMENT(0x1)로 sender 검증 프레임 다음에 와야 하며 페이마스터 서명은 트랜잭션의 signatures 목록에 별도 항목으로 들어갑니다. 이 capability는 optional로 표시할 수 없고 지갑은 pay 프레임 없이 트랜잭션을 보내면 안 됩니다.
atomicFramesBatch와 callFrame
atomicFramesBatch는 같은 id를 가진 인접 호출들을 ATOMIC_BATCH_FLAG로 묶어 모두 성공하거나 모두 롤백되게 합니다. atomicRequired가 true인 요청에는 이 capability를 함께 쓸 수 없습니다. callFrame은 개별 호출의 프레임을 SENDER 또는 DEFAULT로 직접 지정합니다. DEFAULT는 value가 0이어야 하고 to가 반드시 sender 계정 자신이어야 하며 지갑이 요청된 프레임을 만들 수 없으면 optional 여부와 상관없이 거부해야 합니다.
outcomeAssertions와 프레임 순서
outcomeAssertions는 형식 이름(assertionsFormat)이 정의하는 방식대로 ASSERT 프레임을 호출 뒤에 덧붙입니다. 지갑은 지원하지 않는 형식이 오면 거부해야 하고 요청된 프레임을 빼거나 순서를 바꿀 수 없습니다. 전체 프레임 순서는 [expiry_verify] [recent_root_verify] [deploy] <sender 검증> [pay] <호출 프레임들> [ASSERT 프레임들]로 고정되며 MAX_FRAMES를 넘으면 거부됩니다.
호출 상태 계산과 제안 상태
wallet_getCallsStatus는 프레임별 상태(1 성공, 0 실패, 2 건너뜀)를 모아 배치 상태를 매깁니다. 모든 호출 프레임이 반영되고 ASSERT 실패가 없으면 200, 아무 호출도 반영 안 됐거나 ASSERT가 실패하면 500, 일부만 반영되면 600입니다. 이 제안은 Draft 상태로, 아직 명세가 바뀌거나 멈출 수 있는 초안입니다.
쓸 때 주의할 점
- eip7702Auth는 가장 위험한 capability: 지갑은 delegation으로 허용할 구현의 엄격한 허용목록을 유지해야 하고 이름과 버전은 반드시 그 목록의 주소로 연결되어야 합니다. 위임 대상의 취약점이나 악성 코드는 계정 전체를 비울 수 있습니다. 위임은 별도 트랜잭션이라 호출이 나중에 거부되거나 실패해도 그대로 적용되므로, 지갑은 위임을 호출과 따로 확인받고 현재·새 구현과 버전을 사용자에게 보여줘야 합니다.
- paymasterFrame 서명 재사용 위험: msg가 명시된 페이마스터 서명은 그 digest를 받아들이는 모든 트랜잭션에 유효하므로, digest는 sender, 논스 키와 시퀀스 번호, 만료를 묶어야 합니다. 그러지 않으면 서명을 본 누구나 재사용할 수 있습니다. sponsor 정보는 서비스가 주는 검증되지 않은 값이므로 지갑은 이를 검증된 것처럼 보여주면 안 됩니다.
- keyedNonce의 비용과 단일사용 위험: 논스 키는 공개적이고 영구적이며 새 키마다 상태 가스가 들어 최대 16개까지 비용이 쌓입니다. 단일사용형 키는 결제 승인 시점에 소모되어, 이후 프레임이나 ASSERT가 실패해도 다시 쓸 수 없습니다. 지갑은 단일사용형과 outcomeAssertions를 같이 쓰는 요청에 경고해야 합니다.
- callFrame의 ENTRY_POINT·tx.origin 차이: DEFAULT 프레임은 ENTRY_POINT가 호출자가 되어 sender의 승인 없이 실행되므로, ENTRY_POINT를 권한으로 취급하는 계정은 위험합니다. 또한 SENDER 프레임과 달리 DEFAULT 프레임에서는 호출 트리 전체의 ORIGIN이 ENTRY_POINT가 되어 tx.origin을 읽는 컨트랙트가 다르게 동작할 수 있습니다.
- outcomeAssertions 실패는 가스만 소모: ASSERT 실패는 실행 본문만 롤백하고 가스 결제와 논스 키 소모 같은 검증 프리픽스는 그대로 남습니다. 지갑은 포함할 수 없는 어서션이 있는 요청을 거부해야 하며 자신의 어서션을 앱의 어서션으로 대체해서는 안 됩니다.