ERC-7836 지갑 호출 준비 API (Wallet Call Preparation API)
Draft · 계정·지갑 · 2024-12-06 작성
앱이 지갑에서 서명할 다이제스트를 받아 세션 키로 직접 서명한 뒤 실행을 맡길 수 있게 하는 JSON-RPC 메서드 두 개를 정의합니다. 지갑이 아니라 앱이 호출 번들에 서명하는 흐름을 표준화합니다.
왜 필요한가
앱이 사용자를 대신해 거래를 보내려는 수요가 늘고 있습니다. 예를 들어 탈중앙 거래소 매매를 자동화하는 앱은 세션 키(session key)와 범위가 제한된 권한을 써서 사용자가 거래할 때마다 지갑 화면에서 승인하고 서명하는 과정을 생략하고 싶어 합니다. 그런데 스마트 컨트랙트 계정(Smart Contract Account)마다 실행 인터페이스가 제각각이라, 서명해야 할 호출 데이터의 형식도 계정 구현마다 다르다는 문제가 있습니다. 앱이 임의의 계정 구현에 맞춰 서명하려면 계정 구현별 서명 로직의 대응표를 직접 만들어 유지해야 하는데, 이는 사실상 불가능합니다. 그래서 앱이 실행하고 싶은 호출을 지갑에 알려 주면 세션 키로 서명할 페이로드를 돌려받고 서명을 마치면 그 서명과 함께 실행을 맡길 수 있는 간단한 방법이 필요합니다.
구현해야 하는 것
wallet_prepareCalls: 실행할 호출 목록을 받아 계정 구현에 맞게 호출 번들을 준비하고 서명 대상인 digest와 실행 요청에 필요한 값(capabilities, chainId, context, version)을 돌려줍니다.wallet_sendPreparedCalls: 준비된 호출 번들과 서명(signature)을 받아 실행하고 wallet_sendCalls와 같은 형식으로 번들 id를 돌려줍니다.
심층 설명
wallet_prepareCalls 요청 형식
요청은 EIP-5792의 wallet_sendCalls와 동일합니다. params에는 실행할 호출 배열 calls(각 항목은 to와 선택 필드 data, value, capabilities), 번들 수준의 capabilities, 제출 대상 체인의 chainId, 보내는 주소 from(선택), 서명에 쓸 키 힌트 key(선택), 메서드 버전 version을 담습니다. key에는 공개키 publicKey, 키 종류 type(secp256k1, p256, webauthn-p256 중 하나), 그리고 키가 다이제스트를 미리 해시하는지 나타내는 prehash(WebCrypto API의 기본 동작)를 넣습니다.
wallet_prepareCalls 응답과 digest
지갑은 서명 대상인 digest와 함께, wallet_sendPreparedCalls 요청을 채우는 데 필요한 값인 capabilities, chainId, context, version, key를 돌려줍니다. context는 지갑마다 다른 내부 데이터로, 원문은 ERC-4337 UserOperation 또는 그 대안을 예로 듭니다. 응답의 key.type에는 요청에 없던 webcrypto-p256이 추가로 올 수 있습니다. 호출자는 digest에 서명한 뒤, digest를 제외한 나머지 응답을 그대로 wallet_sendPreparedCalls에 전달합니다.
wallet_sendPreparedCalls
요청은 wallet_prepareCalls의 응답과 동일하되 signature 필드가 추가됩니다. 즉 capabilities, chainId, context, 서명에 실제로 쓴 key, 호출 번들에 대한 signature, version을 담습니다. 응답은 wallet_sendCalls와 동일하게 번들 식별자 id와 capabilities를 담습니다. 예시 코드에서는 prepareCalls 응답에서 digest를 구조 분해로 빼낸 뒤 p256 키로 서명하고 나머지 요청에 signature만 더해 보내는 흐름을 보여 줍니다.
설계 근거
이 두 메서드는 EIP-5792가 세운 인터페이스를 앱 개발자의 새로운 수요에 맞춰 확장한 것입니다. 이 용도를 위해 wallet_sendCalls에 옵션을 더하는 것보다 별도 엔드포인트를 추가하는 쪽이 더 단순합니다. 지갑은 wallet_sendCalls를 지원하기 위해 이미 내부에서 호출 준비를 하고 서명된 호출을 체인에 제출하고 있으므로, 준비된 호출을 밖으로 드러내는 일은 지갑 입장에서 비교적 간단합니다.
하위 호환성
기존 EIP-5792 흐름을 깨뜨리지 않습니다. wallet_sendCalls를 수정하거나 폐기하지 않으므로 EIP-5792를 따르는 지갑은 그대로 동작합니다. wallet_prepareCalls는 wallet_sendCalls의 요청 형태를 그대로 따르고 capabilities, chainId, context, version 같은 필드 형식을 유지한 채 wallet_sendPreparedCalls로 전달할 값을 돌려줍니다. wallet_sendPreparedCalls는 지갑이 내부적으로 만들던 데이터에 외부에서 만든 signature만 더해 받습니다. WebCrypto나 WebAuthn 계열의 추가 키 종류는 선택 사항이며 EIP-5792 동작에 영향을 주지 않습니다.
아직 초안 단계입니다
이 제안의 상태는 Draft입니다. 아직 논의 중인 초안이므로 메서드 이름, 필드 구성, 키 종류 목록 등이 앞으로 바뀔 수 있습니다. 구현할 때는 최신 원문을 확인하는 것이 안전합니다.
쓸 때 주의할 점
- 키 권한과 범위 확인: 지갑은 요청에 담긴 key.publicKey가 해당 계정에 승인된 키인지, 요청한 capabilities가 그 키의 권한 범위(스코프, 한도, 유효 기간) 안에 있는지 반드시 확인해야 합니다.
- prehash 처리 일관성: 서명자와 검증자가 key.prehash를 다르게 처리하면(이중 해시와 미리 해시된 입력의 불일치 등) 검증이 실패할 수 있습니다. 지갑은 키 종류별로 해시 함수를 고정하는 것이 좋습니다.
- 준비와 실행의 연결: 지갑은 wallet_sendPreparedCalls가 자신이 만들 수 있었던 digest에 대응하는지(예: 다시 계산해 확인) 확인하는 것이 좋고 오래 살아남은 요청의 재사용을 막기 위해 준비 식별자나 유효 기간을 둘 수 있습니다.
- WebAuthn과 출처 바인딩: webauthn-p256 키에는 사용자 검증과 출처(origin)에 묶인 자격 증명을 쓰는 것이 좋습니다. 앱은 세션 키를 추출 불가능하게 유지하고 가능하면 하드웨어로 보호하며 의미를 알 수 없는 다이제스트를 최종 사용자 승인 화면에 그대로 보여 주지 않아야 합니다.
- 자원 소모와 서비스 거부 대비: 지갑은 wallet_prepareCalls에 속도 제한을 두고 번들 크기에 상한을 두며 입력을 일찍 검증해, 잘못되었거나 악의적인 요청 때문에 비용이 큰 context 생성을 반복하지 않도록 할 수 있습니다.