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 상태로, 아직 명세가 바뀌거나 멈출 수 있는 초안입니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs