ERC-7521 스마트 컨트랙트 지갑 범용 인텐트 (General Intents for Smart Contract Wallets)
Draft · 계정·지갑 · 2023-09-19 작성
사용자가 원하는 거래 의도(인텐트)를 한 번만 서명하면, 지갑을 업그레이드하지 않고도 새로 등장하는 다양한 인텐트 표준을 골라 쓸 수 있게 하는 공용 진입점 계약 표준입니다.
왜 필요한가
인텐트는 사용자가 거래 과정을 일일이 지정하는 대신 원하는 결과만 서명해 두면 다른 참여자가 이를 실행해 주는 방식입니다. 그런데 인텐트를 표현하는 표준은 계속 새로 생겨나고 바뀝니다. 지갑이 각 표준을 직접 지원하려면 새 표준이 나올 때마다 지갑 코드를 업그레이드해야 하고 새 표준을 만든 개발자는 지갑 개발사들을 일일이 설득해야 합니다. 이 표준이 없으면 사용자는 쓰고 싶은 새 인텐트 방식이 나와도 지갑이 지원할 때까지 기다려야 하고 여러 동작을 묶은 복잡한 의도를 서명 한 번으로 처리하기도 어렵습니다. ERC-7521은 서명 검증을 맡는 공용 진입점 계약 하나를 두고 실제 인텐트 해석과 실행은 사용자가 서명 시점에 지정한 별도의 인텐트 표준 계약에 넘겨 이 문제를 풉니다.
구현해야 하는 것
function handleIntents (IntentSolution calldata solution) external;: 솔버가 만든 해법(IntentSolution)을 받아 각 인텐트의 서명을 검증하고 세그먼트들을 순서대로 실행합니다.function validateIntent (UserIntent calldata intent) external;: 인텐트의 서명과 데이터 형식이 올바른지 확인합니다. 솔버가 인텐트를 받기 전에 로컬에서 호출합니다.function registerIntentStandard (IIntentStandard intentStandard) external returns (bytes32);: 새 인텐트 표준 계약을 허가 없이 등록하고 고유한 표준 ID를 돌려줍니다.function verifyExecutingIntentSegmentForStandard (IIntentStandard intentStandard) external view returns (bool);: 지금 진입점이 해당 표준의 세그먼트를 실행하는 중인지 지갑이 확인할 때 씁니다.function validateIntentSegment (bytes calldata segmentData) external pure;: 인텐트 표준 계약이 자기 세그먼트 데이터의 형식이 올바른지 검사합니다.function executeIntentSegment (IntentSolution calldata solution, uint256 executionIndex, uint256 segmentIndex, bytes calldata context) external returns (bytes memory);: 인텐트 표준 계약이 세그먼트 하나를 실행합니다. 반환한 바이트는 같은 인텐트의 다음 세그먼트 실행 때 context로 다시 전달됩니다.function validateUserIntent (UserIntent calldata intent, bytes32 intentHash) external;: 지갑이 인텐트와 그 해시를 받아 실제로 자신이 보낸 것인지 서명을 검증합니다. 유효하지 않으면 오류를 던집니다.function generalizedIntentDelegateCall (bytes memory data) external;: 지갑이 호출한 인텐트 표준 계약으로 주어진 호출 데이터를 델리게이트콜합니다. 호출 전에 진입점에 실행 상태를 확인해야 합니다.handleIntentsMulti(IntentSolution[] calldata solutions): 여러 해법을 한 트랜잭션에서 실행해 비슷한 저장 공간을 건드리는 인텐트들의 가스를 절약합니다(확장 기능).getNonce(address sender, uint256 key): 진입점 저장소에 보관된 발신자별 논스를 누구나 읽을 수 있게 합니다(확장 기능).setNonce(uint256 key, uint256 nonce): 현재 실행 중인 인텐트 표준만, 그 인텐트의 sender에 대해서만 논스를 기록할 수 있습니다(확장 기능).
심층 설명
UserIntent 구조와 세그먼트
사용자는 ABI 인코딩된 UserIntent 구조체로 인텐트를 담습니다. sender는 인텐트를 만드는 지갑 주소, segments는 여러 인텐트 표준의 데이터를 담는 bytes 배열, signature는 지갑 검증 단계에 전달되는 데이터입니다. segments 배열의 각 항목을 인텐트 세그먼트라 부르고 각 세그먼트의 첫 32바이트는 그 데이터가 속한 인텐트 표준 ID를 지정합니다. 세그먼트 바이트를 어떻게 해석할지는 전적으로 해당 인텐트 표준 계약이 정합니다. 사용자는 사용하는 표준에 맞는 멤풀 전략으로 UserIntent를 내보냅니다.
IntentSolution과 handleIntents의 두 루프
솔버는 인텐트들을 묶어 IntentSolution을 만듭니다. 필드는 평가 기준 시각인 timestamp, 실행할 UserIntent 배열인 intents, 인텐트 간 실행 순서인 order입니다. 진입점의 handleIntents는 두 루프를 돌립니다. 검증 루프에서는 timestamp가 block.timestamp의 허용 범위 안이거나 그 이전인지 확인하고 각 지갑의 validateUserIntent를 호출합니다. 어떤 검증이 실패하면 최소한 그 인텐트의 실행을 건너뛰어야 하고 전체를 되돌릴 수도 있습니다. 실행 루프에서는 각 세그먼트의 표준 ID가 가리키는 계약의 executeIntentSegment를 호출하며 전체 IntentSolution과 executionIndex, segmentIndex, context를 넘깁니다.
실행 순서 규칙과 context 데이터
한 인텐트 안의 세그먼트는 항상 segments 배열 순서대로 실행됩니다. 인텐트 사이의 순서는 order 배열로 지정합니다. 예를 들어 order가 [1,1,0,1]이면 두 번째 인텐트의 세그먼트 1과 2가 먼저 실행되고 첫 번째 인텐트의 세그먼트 1, 다시 두 번째 인텐트의 세그먼트 3이 실행됩니다. 순서를 지정하지 않았거나 order를 다 소진해도 세그먼트가 남으면, 첫 인텐트부터 마지막까지 반복해 도는 기본 순서를 씁니다. 모든 세그먼트를 이미 끝낸 인텐트가 다시 지목되면 그 호출은 건너뜁니다. executeIntentSegment가 반환한 바이트는 진입점이 기억했다가 같은 인텐트의 다음 호출에 context로 넣어 줍니다. 덕분에 표준은 다른 인텐트가 중간에 실행되는 동안에도 상태 변화를 추적할 수 있습니다. 토큰을 내보낸 뒤 다른 토큰을 받았는지 확인하는 표준이 한 예입니다.
인텐트 표준의 허가 없는 등록
진입점의 registerIntentStandard 함수는 새 인텐트 표준 계약의 허가 없는(permissionless) 등록을 허용해야 합니다. 등록 과정에서 진입점은 인텐트 표준 계약, 진입점 계약, 체인 ID 조합에 고유한 표준 ID를 부여합니다. 표준이 지갑에 하드코딩되지 않으므로 사용자는 아무 작업 없이 새로 등록된 표준으로 바로 인텐트를 서명할 수 있습니다. 자주 쓰일 공통 표준은 진입점 생성 시점에 코드에 내장해 외부 호출을 줄이고 가스를 아끼는 확장도 정의되어 있습니다.
지갑의 역할: 검증과 위임 호출
진입점은 각 UserIntent의 sender 지갑에 validateUserIntent를 호출하며 인텐트 전체와 미리 계산한 해시를 넘깁니다. 지갑은 이것이 실제로 sender가 보낸 것인지 분석하고 아니면 오류를 던져야 합니다. 이 함수는 view로 제한되지 않지만 논스 관리 같은 상태 갱신은 인텐트의 개별 세그먼트에서 하는 것이 좋습니다. 실행 중에 표준이 지갑의 동작을 원하면 generalizedIntentDelegateCall을 호출하는데, 지갑은 델리게이트콜을 하기 전에 진입점의 verifyExecutingIntentSegmentForStandard로 두 가지를 확인해야 합니다. 호출자인 msg.sender가 진입점이 지금 executeIntentSegment를 호출 중인 그 표준 계약인지, 그리고 자신이 지금 실행 중인 UserIntent의 sender인지입니다.
솔버의 사전 검증과 시뮬레이션
솔버는 UserIntent를 받기 전에 RPC로 진입점의 validateIntent를 뷰 호출해야 합니다. 이 함수는 서명이 유효한지와 세그먼트 형식이 올바른지 검사하며 어떤 오류로든 되돌아가면 솔버는 그 인텐트를 거부해야 합니다. 시뮬레이션은 일반적인 MEV 작업 흐름대로 솔버가 처리합니다. 현재 블록 높이에서 해법을 드라이런해 결과가 기대대로인지 확인하고 성공한 해법을 번들로 블록 빌더에 제출해 다음 블록에 포함시킵니다. 솔버는 가스비를 대신 부담해 사용자의 부담을 없애는 트랜잭션 발신자 역할도 합니다.
확장 기능: 멀티 해법, 논스, 데이터 블롭
가스 절약을 위한 선택적 확장이 정의되어 있습니다. handleIntentsMulti(IntentSolution[] calldata solutions)는 여러 해법을 한 트랜잭션에서 실행해 비슷한 저장 공간을 건드리는 인텐트들의 가스를 아낍니다. getNonce(address sender, uint256 key)와 setNonce(uint256 key, uint256 nonce)는 논스를 진입점 저장소에 발신자별로 보관하며 쓰기는 현재 실행 중인 인텐트 표준이 지금 실행 중인 인텐트의 sender에 대해서만 할 수 있습니다. 데이터 블롭 확장은 sender가 address(0)이거나 segments가 비어 있는 인텐트의 검증과 실행을 건너뛰고 그 필드를 임의 데이터 주입 통로로 씁니다. 어떤 비밀값을 증명해야 하는 표준이나 주변 인텐트에 따라 동작이 달라지는 인텐트에 쓸 수 있습니다.
ERC-4337과의 관계, 업그레이드, 제안 상태
이 제안은 합의 계층을 바꾸지 않으므로 이더리움 전체의 하위 호환성 문제는 없습니다. 지갑이 이미 ERC-4337을 지원한다면 validateUserIntent 구현은 validateUserOp와 매우 비슷하지만 사용자의 지갑 업그레이드가 필요합니다. 지갑은 가스 효율과 업그레이드 가능성을 위해 DELEGATECALL 포워딩 계약으로 만들고 진입점 주소를 하드코딩하는 것이 권장됩니다. 새 진입점이 나오면 사용자는 셀프 호출로 지갑 코드 주소를 교체하고 인텐트 표준들도 새 진입점에 재등록해야 합니다. 하드코딩 대신 임의 진입점의 서명을 검증하고 트랜지언트 스토리지에 기록해 두는 방식도 참조 구현에 예시가 있습니다. 이 제안은 현재 Draft 상태로, 내용이 아직 바뀔 수 있습니다.
쓸 때 주의할 점
- 진입점 계약에 집중된 신뢰: 진입점 계약은 ERC-7521을 지원하는 모든 지갑의 중앙 신뢰 지점이므로 매우 강도 높은 감사와 형식 검증이 필요합니다. 대신 개별 지갑이 검증할 부분은 validateUserIntent의 서명 확인 로직과 generalizedIntentDelegateCall 호출 게이트로 줄어들어, 생태계 전체의 감사 부담은 감소합니다.
- 임의 탈취에 대한 안전성: 진입점은 UserIntent의 서명을 성공적으로 검증했고 그 인텐트의 segments가 지정한 표준에 executeIntentSegment를 호출하는 중이며 그 인텐트의 sender가 확인을 요청한 msg.sender 지갑과 같을 때에만 verifyExecutingIntentSegmentForStandard에서 true를 반환해야 합니다. 이 주장이 검증의 핵심 대상입니다.
- 인텐트 표준 계약의 감사 필요성: 사용자가 상호작용하기로 한 모든 인텐트 표준 계약에 대해서도 추가적인 강도 높은 감사와 형식 검증이 필요합니다.