ERC-7754 변조 방지 지갑 요청(TWIST) (Tamperproof Extension Wallets API (TWIST))
Draft · 서명·인증 · 2024-07-29 작성
댑이 지갑에 보내는 요청에 전자 서명을 붙여 보내고 지갑이 댑 도메인에 공개된 키로 서명을 검증해 요청이 중간에 변조되지 않았음을 확인할 수 있게 합니다.
왜 필요한가
지금은 댑(블록체인 앱)과 지갑 사이의 통신 경로가 중간자 공격(man in the middle)에 취약합니다. 공격자가 웹페이지의 보안 구멍(XSS)이나 악성 브라우저 확장 프로그램으로 자바스크립트 코드를 끼워 넣으면, 댑이 지갑으로 보내는 요청을 가로채 바꿀 수 있습니다. 예를 들어 거래 내용(콜데이터)을 고쳐 자금을 빼돌리거나, EIP-712 서명 요청의 내용을 바꾸거나, 여러 번 재사용할 수 있는 서명을 받아낼 수 있습니다. 사용자가 변조 가능성을 눈치채더라도 막을 방법이 사실상 없습니다. 댑과 지갑 사이에 신뢰 사슬이 없어서 사용자는 정직한 댑조차 그대로 믿기 어렵고 자금을 잃을 위험에 놓이며 댑 운영자는 공격이 성공하면 평판이 훼손될 위험을 집니다.
구현해야 하는 것
type RequestPayload<Params> = { method: string; params: Params };: 지갑에 전달할 원래 요청으로, RPC 메서드 이름과 그 파라미터를 담습니다.
심층 설명
신뢰 사슬의 구성
댑의 도메인 인증서를 신뢰의 뿌리로 삼아 사슬을 만듭니다. 브라우저가 도메인 인증서를 검증하고 댑의 DNS 레코드에 있는 TXT 필드가 JSON 매니페스트가 호스팅된 URL을 가리킵니다. 매니페스트는 /.well-known/twist.json 같은 잘 알려진 주소에 두는 것이 권장(SHOULD)됩니다. 매니페스트에는 { id, alg, publicKey } 형태의 객체 배열이 들어갑니다. 댑은 보낼 payload를 개인 키로 서명한 뒤 원래 payload, 서명, 공개 키 id를 wallet_signedRequest로 지갑에 보내고 지갑은 서명을 검증한 뒤에 요청을 평소처럼 처리합니다. HTTPS가 웹에서 하는 역할과 비슷한 구조입니다.
키 공개 방식과 지원 알고리즘
공개 키는 DNS 레코드를 통해 찾습니다. 예시는 TXT 레코드에 TWIST=/.well-known/twist.json을 적는 방식입니다. RFC 6376의 DKIM과 비슷하지만 매니페스트 파일을 쓰면 여러 알고리즘과 키 쌍을 지원할 수 있고 앞으로 확장하기도 쉽습니다. 구현체는 RFC 7518 3.1절의 alg 값 중 ES256과 EdDSA를 반드시(MUST) 지원해야 합니다. PS256, RS256, ES384, ES512, PS384, PS512, RS384, RS512는 지원이 권장(SHOULD)됩니다. 공개 키는 X.509 SubjectPublicKeyInfo(SPKI) 구조를 DER 형식으로 인코딩한 뒤 16진수 문자열로 표현해야 합니다. 구현에는 최신 브라우저에서 쓸 수 있는 SubtleCrypto 사용이 권장됩니다.
키 캐시는 2시간 이하로
지갑은 JWT 관행처럼 댑의 키를 미리 받아 캐시할 수 있습니다. 하지만 키 폐기(revocation) 메커니즘이 없기 때문에, 키가 유출되면 캐시가 만료될 때까지 그 키가 계속 쓰일 수 있습니다. 이를 줄이기 위해 지갑은 댑 공개 키를 2시간을 넘겨 캐시하지 않아야(SHOULD NOT) 합니다. 이렇게 하면 취약 기간이 비교적 짧아지고 지갑과 댑 운영자 모두 감당할 만한 수준의 부담이 됩니다.
wallet_signedRequest 파라미터
새 RPC 메서드 wallet_signedRequest의 파라미터는 세 개입니다. requestPayload는 { method, params } 형태로 원래 실행하려는 요청(예: eth_sendTransaction과 그 파라미터)을 담습니다. signature는 0x로 시작하는 16진수 문자열 서명이고 keyId는 매니페스트에서 검증에 쓸 키를 찾는 식별자입니다. 댑은 EIP-1193 제공자의 request 메서드로 { method: 'wallet_signedRequest', params: [requestPayload, signature, keyId] }를 호출합니다.
지갑의 매니페스트 조회 규칙
지갑은 EIP-1193 호출을 받으면 sender.tab.url 도메인에 TWIST 매니페스트가 있는지 확인해야(MUST) 합니다. HTTP는 DNS 스푸핑에 취약하므로 HTTPS를 강제해야 하고 매니페스트가 그 도메인에서 호스팅되는지 검증해야 합니다. 매니페스트 위치는 DNS TXT 레코드에서 찾는 것이 권장되며 /.well-known/twist.json 위치를 먼저 시도해도(MAY) 됩니다. 열린 리다이렉트 공격으로 이어질 수 있으므로 매니페스트를 받을 때 리다이렉트를 따라가면 안 되고(MUST NOT), 응답의 Content-Type 헤더가 application/json인지 확인하는 것이 권장됩니다. TWIST가 설정되지 않은 도메인이면 평소처럼 처리합니다.
서명 검증과 경고 절차
TWIST가 설정된 도메인에서 일반 request 메서드가 쓰이면 지갑은 사용자에게 눈에 띄고 행동 가능한 경고를 보여 주는 것이 권장(SHOULD)됩니다. 사용자가 무시하면 평소처럼 진행하고, 취소하면 호출을 중단해야 합니다. wallet_signedRequest가 쓰이면 지갑은 keyId가 매니페스트에 있는지 확인하고 해당 키 레코드의 alg와 publicKey로 crypto.verify(alg, key, signature, requestPayload)를 호출해 무결성을 검증해야(MUST) 합니다. 서명이 유효하지 않으면 경고를 보여 주고 사용자가 무시하면 requestPayload로 request를 호출하며 취소하면 중단해야 합니다. 서명이 유효하면 requestPayload로 request를 호출해야 합니다. 서명된 상호작용이라는 시각적 표시를 보여 줄 수도(MAY) 있습니다.
경고하되 막지 않는 UX
HTTPS의 자물쇠 아이콘처럼, TWIST가 설정된 도메인에서는 지갑이 눈에 띄는 표시를 보여 주는 것이 좋습니다. 사용자는 댑과 지갑 사이의 상호작용이 안전하다는 것을 바로 알 수 있고 이는 댑 개발자의 TWIST 채택을 유도해 생태계 전체를 더 안전하게 만듭니다. TWIST가 설정된 도메인에서 일반 request가 쓰이거나 서명이 맞지 않는 안전하지 않은 요청에 대해서는, 지갑이 경고하되 차단하지는 않습니다. 잘 쓰인 경고문이 투명성을 높여 사용자가 스스로 취소하거나 위험을 감수하고 진행할 수 있게 합니다.
아직 초안 단계인 제안
이 제안은 EIP-712와 EIP-1193의 기존 기능을 바꾸지 않고 더하기만 하는 방식이라 하위 호환성이 있고 DKIM 같은 기존 해법을 본떠 설계되어 지갑과 댑 모두 구현하기 쉽다고 원문은 설명합니다. 다만 현재 상태가 초안(Draft)이므로 내용이 앞으로 바뀔 수 있는 제안입니다.
쓸 때 주의할 점
- 재전송 공격은 따로 막지 않습니다: payload 서명은 데이터 무결성은 보장하지만 재전송(replay) 공격 자체를 막지는 않습니다. 같은 서명된 payload를 여러 번, 또는 여러 체인에서 재사용할 수 있습니다. 시간상 재전송은 보통 거래 논스로, 체인 간 재전송은 EIP-712 signTypedData로 막을 수 있습니다. 둘 다로 보호되지 않는 읽기 전용 메서드는 공격자에게 가치가 매우 낮아서 원문은 현시점에 특정 재전송 방지 메커니즘을 권장하지 않으며 필요해지면 매니페스트의 확장성으로 JWT 같은 보호 수단을 더할 수 있다고 봅니다.
- 매니페스트 자체가 공격당할 수 있습니다: 공격자가 DNS 항목을 스푸핑해 자신의 매니페스트를 내려 줄 수 있으므로, 지갑은 반드시 'https://${sender.tab.url}/${pathFromDNSRecord}'에서만 매니페스트를 조회해야 합니다. 또 댑의 다른 취약점을 이용해 댑 도메인에 악성 매니페스트를 올릴 수 있는데, 열린 리다이렉트를 악용하는 경우에 대비해 지갑은 리다이렉트를 따라가면 안 되고 파일을 몰래 올리는 경우에 대비해 content-type 헤더가 application/json인지 확인하는 것이 권장됩니다.