ERC-8286 프레임 트랜잭션 모듈형 계정 (Modular Accounts for Frame Transactions)

Draft · 계정·지갑 · 2026-06-04 작성

ERC-7579 모듈 체계를 EIP-8141 네이티브 계정추상화로 확장해, 검증자가 승인 범위(결제·실행)를 돌려주고 계정이 APPROVE로 적용하는 검증 흐름과 실행 경로 선언을 정의합니다.

왜 필요한가

EIP-8141은 하드포크로 들어오는 네이티브 계정추상화로, ERC-4337과 검증 방식이 다릅니다. ERC-7579는 검증자·실행자·후크 모듈을 설치하고 관리하는 공통 틀을 정의하지만 ERC-4337의 validateUserOp 검증 흐름만 지원합니다. 이 틀을 EIP-8141에 그대로 적용할 표준이 없으면 EIP-8141 계정을 위한 모듈 생태계를 처음부터 새로 만들어야 하고, 지갑과 모듈 개발자는 ERC-4337용과 EIP-8141용 모듈을 따로 만들어야 합니다. 또한 EIP-8141은 승인(APPROVE)이 한 번 떨어지면 이후 프레임을 다시 검사하지 않으므로, 계정이 실행 경로를 명확히 선언하고 검증 시점에 정책을 강제하는 규칙이 없으면 승인한 범위보다 넓게 임의의 호출이 실행될 위험이 있습니다.

구현해야 하는 것

심층 설명

승인 모드(Approval Mode)의 구조

승인 모드는 uint8 비트마스크로, 두 비트에만 의미가 있습니다. 비트0(결제)은 계정이 트랜잭션 총 가스비 지불을 승인함을, 비트1(실행)은 이후 프레임이 sender로서 계정을 대신해 동작하도록 승인함을 뜻합니다. 그 조합으로 APPROVE_NONE(0x0), APPROVE_PAYMENT(0x1), APPROVE_EXECUTION(0x2), APPROVE_EXECUTION_AND_PAYMENT(0x3) 네 모드가 생깁니다. APPROVE_SCOPE_MASK는 0x3이며, 실행 중인 프레임의 허용 범위는 frame.flags & APPROVE_SCOPE_MASK, 즉 FRAMEPARAM(frameIndex, 0x06)입니다. 계정은 이 허용 범위를 벗어난 모드를 승인해선 안 되고, APPROVE_EXECUTION은 프레임의 해석된 대상이 tx.sender일 때만 유효합니다. 검증이 성공하지 못하면 계정은 APPROVE를 호출하지 않아야 하며, 이 경우 모드는 APPROVE_NONE으로 남아 트랜잭션이 무효가 됩니다.

EIP-8141 프레임 검증자와 module type id 11

프레임 검증자는 트랜잭션이 받을 자격이 있는 승인 모드를 결정하는 모듈로, 새 모듈 타입 id 11(TBD)을 부여받습니다. 하나의 모듈이 ERC-7579의 type id 1(기존 검증자)과 이 타입을 동시에 가질 수 있습니다. IFrameValidator는 ERC-7579의 IERC7579Module을 함께 구현해야 하며, validateFrame은 서명 해시(TXPARAM 0x08), 실행 중인 프레임 번호(TXPARAM 0x0A), 허용 범위(FRAMEPARAM frameIndex 0x06) 등 트랜잭션 맥락을 함수 인자가 아니라 EIP-8141 조회 명령으로만 읽어야 합니다. 이는 계정이나 호출자가 그 값을 조작하지 못하게 막기 위함입니다. validateFrame은 상태를 바꿀 수 없고(STATICCALL 맥락), 검증 실패 시 APPROVE_NONE을 반환해야 하며, 디코딩 오류 등에는 revert할 수 있습니다. 반환값은 허용 범위의 부분집합이어야 하지만, 최종 권한은 계정에 있어 계정이 반드시 allowedScope로 마스킹합니다.

계정이 VERIFY 프레임에서 수행하는 7단계

계정은 자기 자신을 대상으로 하는 VERIFY 프레임에서 다음을 수행합니다. 우선 frameIndex와 allowedScope를 읽습니다. 다음으로 설치된 프레임 검증자(type id 11)를 선택하고 설치 여부를 확인합니다. 이어서 validateFrame을 호출하고 결과를 allowedScope로 마스킹합니다. 실행 비트가 섰으면 트랜잭션의 SENDER 프레임들이 제시하는 실행 모드를 supportsExecutionMode로 검사하고, 지원하지 않으면 실행 비트를 지웁니다. 컨트랙트 디스패치 계정이면 모든 SENDER 프레임의 대상이 계정 자신인지 확인하고, 아니면 실행 비트를 지웁니다. 결과가 APPROVE_NONE이면 APPROVE를 호출하지 않아 프레임이 revert되고 트랜잭션이 무효가 됩니다. 그 외에는 APPROVE(approvalMode)를 호출합니다.

SENDER 프레임 실행 모드 4종

이 표준은 ERC-7579의 모드 인코딩을 확장해 callType에 새 값 0x02(단일 SENDER 프레임)와 0x03(다중 SENDER 프레임)을 추가합니다. execType은 ERC-7579 의미를 그대로 써서 0x00은 원자적 배치(all-or-nothing), 0x01은 개별 revert(try)입니다. 이를 조합해 FRAME_MODE_SINGLE(0x02,0x01), FRAME_MODE_SINGLE_ATOMIC(0x02,0x00), FRAME_MODE_BATCH(0x03,0x01), FRAME_MODE_BATCH_ATOMIC(0x03,0x00) 네 상수가 정의됩니다. 트랜잭션은 SENDER 프레임마다 하나의 모드를 '제시'하며, 한 트랜잭션이 여러 모드를 동시에 제시할 수도 있습니다. 계정은 제시된 모든 모드에 대해 supportsExecutionMode가 true를 반환할 때만 그 트랜잭션의 SENDER 프레임들을 지원하는 것으로 간주합니다. 이 모드들은 execute에 전달되지 않으며 execute 디스패치 동작을 정의하지 않습니다.

계정 인터페이스 IERC8286FrameAccount

이 인터페이스는 ERC-7579의 IERC7579AccountConfig와 IERC7579ModuleConfig를 확장합니다. verify(bytes data)는 VERIFY 프레임의 data에 인코딩되어 호출되도록 의도된 함수로, 검증자를 선택해 승인 모드를 얻고 allowedScope로 마스킹한 뒤 supportsApprovalMode와(필요하면) supportsExecutionMode로 검사해 APPROVE를 호출합니다. 실행 중인 프레임이 VERIFY 모드가 아니면 revert해야 하고, APPROVE 외의 상태 변경은 금지되며, 허용 범위를 벗어난 모드나 검증 실패 시 APPROVE를 호출해선 안 됩니다. supportsApprovalMode(uint8)는 계정이 해당 승인 모드를 부여할 수 있는지, executionRoute()는 계정이 쓰는 실행 경로를 반환합니다.

실행 경로: 프로토콜 디스패치 대 컨트랙트 디스패치

EIP-8141 프레임 트랜잭션은 두 경로로 동작합니다. 프로토콜 디스패치(EXECUTION_ROUTE_PROTOCOL, 0x00)는 SENDER 프레임이 caller=tx.sender로 대상을 직접 호출하며 계정 코드가 개입하지 않아, 정책은 전부 검증 시점에 강제해야 합니다. 컨트랙트 디스패치(EXECUTION_ROUTE_CONTRACT, 0x01)는 모든 SENDER 프레임이 계정 자신을 대상으로 해 ERC-7579의 execute 또는 executeFromExecutor를 caller=tx.sender로 호출하고, ERC-7579 실행 모드·supportsExecutionMode·후크가 그대로 적용됩니다. 프로토콜은 두 경로를 구분하지 않으므로 계정은 반드시 하나를 선택해 executionRoute로 선언해야 하며, 컨트랙트 디스패치 계정은 모든 SENDER 프레임이 계정으로 해석될 때만 실행을 승인해야 합니다. 프로토콜 디스패치 계정은 execute·executeFromExecutor를 아예 구현하지 않아도 됩니다.

ENTRY_POINT 호출자와 DEFAULT 프레임 주의

DEFAULT 프레임은 사전 승인 없이도 caller=ENTRY_POINT로 계정 코드를 호출할 수 있습니다. EIP-8141의 APPROVE는 프레임의 해석된 대상과 플래그만 보고 모드는 보지 않으며, STATICCALL 제약과 실패 시 전체 트랜잭션 무효화는 VERIFY 프레임에만 적용됩니다. 따라서 계정은 msg.sender == ENTRY_POINT라는 사실만으로 자신이 VERIFY 프레임 안에 있다고 가정해서는 안 되며, APPROVE 전에 FRAMEPARAM으로 프레임 모드를 직접 확인해야 합니다. 같은 이유로 execute 같은 실행 진입점도 caller 신원만으로 인가해서는 안 되며, 계정 자신의 VERIFY 프레임 성공 여부(FRAMEPARAM 0x05) 등을 확인해야 합니다.

검증자 선택 방법과 표준의 상태

원문은 EIP-8250의 키드 논스(keyed nonce)가 있을 때, nonce_keys[0](TXPARAM 0x0B)에 검증자 주소를 인코딩해 검증자를 선택하는 방식을 권장 방안으로 제시합니다. 키드 논스는 서명 해시(TXPARAM 0x08)에 포함되므로 검증자 선택이 서명된 트랜잭션에 바인딩됩니다. 다만 module type id 11과 callType 값 0x02·0x03은 원문에서 TBD(추후 확정)로 표시되어 있고, 이 제안 자체가 아직 Draft 상태이므로 세부 수치나 조항이 앞으로 바뀌거나 멈출 수 있습니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs