EIP-6963 다중 주입 지갑 감지 표준 (Multi Injected Provider Discovery)

최종 확정 · 기타 · 원문 상태 Final · 2023-05-01 작성

브라우저 지갑 확장이 window.ethereum 하나를 두고 경쟁하는 대신, window 이벤트로 각자 자신을 알리게 해 디앱이 설치된 여러 지갑을 모두 발견하고 사용자가 고를 수 있게 합니다.

왜 필요한가

브라우저 확장형 지갑은 지금까지 자신의 이더리움 프로바이더(provider, 디앱과 지갑을 잇는 연결 객체)를 웹페이지의 같은 자리인 window.ethereum에 끼워 넣어야 했습니다. 지갑을 두 개 이상 설치하면 이 자리를 서로 덮어쓰는데, 확장 프로그램이 로드되는 순서는 예측할 수 없어서 보통 마지막에 로드된 지갑이 이깁니다. 사용자는 어떤 지갑이 연결될지 통제할 수 없고 접속할 때마다 다른 지갑이 잡히는 일도 생깁니다. 일부 지갑은 일부러 늦게 끼어들어 다른 지갑을 덮어쓰는 식으로 대응했는데, 그러면서 지갑 간 경쟁은 불공정해지고 상호운용성도 사라졌습니다. 사용자가 지갑을 한 번에 하나만 설치하도록 강요받는 셈이라 새 지갑의 진입 장벽도 높아졌습니다. 이 제안은 공유된 하나의 자리를 두고 다투는 대신 양방향 이벤트 통신으로 지갑들이 각자 자신을 알리게 해서 이 문제를 풉니다.

무엇이 바뀌나

지금

EIP-6963 이후

누구에게 영향이 있나

심층 설명

EIP6963ProviderInfo: 지갑 메타데이터 4개 필드

각 지갑은 uuid, name, icon, rdns 네 필드를 담은 EIP6963ProviderInfo로 자신을 알립니다. uuid는 UUIDv4(RFC-4122) 준수가 MUST이며 페이지 생존 기간 동안 같은 속성을 가진 EIP-1193 프로바이더 세션들을 구분하는 용도입니다. name은 디앱에 표시할 사람이 읽을 수 있는 이름, icon은 이미지를 가리키는 URI입니다. 알 수 없는 추가 속성이 오면 디앱은 무시하는 것이 SHOULD입니다. 실제 발표 시에는 info와 EIP-1193 provider를 묶은 EIP6963ProviderDetail 형태로 전달합니다. 기존 EIP-1193 프로바이더 인터페이스는 하위 호환을 위해 손대지 않았습니다.

rdns: 세션 간 안정적인 역방향 도메인 식별자

rdns는 com.example.MyBrowserWallet처럼 도메인을 역순으로 쓴 식별자로, 세션이 바뀌어도 유지되는 지갑 식별에 쓰입니다. 유효한 RFC-1034 도메인 이름이어야 하고(MUST), DNS 부분은 프로바이더가 실제 통제하는 활성 도메인이어야 합니다(SHOULD). 규칙을 지키지 않는 프로바이더를 디앱이 거부하는 것은 MAY입니다. 다만 이 값은 지갑이 스스로 주장하는 것이라 사칭이 가능하므로, 디앱은 rdns를 기능 감지(feature detection)에 쓰지 말아야 하며(SHOULD NOT) 값이 틀리거나 위조된 경우에도 기능 저하를 최소화해 처리해야 합니다. 검증 메커니즘은 이 명세의 범위 밖입니다.

아이콘: data URI 필수, SVG는 img 태그로만 렌더링

icon 문자열은 RFC-2397에 정의된 data URI여야 합니다(MUST). 이미지는 최소 96x96px 정사각형이 SHOULD이고 렌더링이 쉬운 PNG, WebP, SVG 같은 무손실 또는 벡터 형식이 RECOMMENDED입니다. SVG는 자바스크립트를 실행할 수 있으므로, 애플리케이션과 라이브러리는 신뢰할 수 없는 스크립트 실행을 막기 위해 SVG 이미지를 반드시 img 태그로 렌더링해야 합니다(MUST). 악성 지갑이 아이콘을 통해 페이지나 다른 지갑 정보를 조작하는 것을 막기 위한 조치입니다.

이벤트 오케스트레이션: 실행 순서와 무관한 발견 보장

지갑은 eip6963:announceProvider라는 CustomEvent를 window.dispatchEvent()로 발송해야 하고(MUST), detail 속성의 EIP6963ProviderDetail 객체는 Object.freeze()로 동결하는 것이 SHOULD입니다. 동시에 지갑은 eip6963:requestProvider 이벤트 리스너를 등록해, 요청이 오면 announce 이벤트를 재발송해야 합니다(MUST). 디앱은 announce 리스너를 등록한 뒤 request 이벤트를 발송해야 하며(MUST), 페이지 생존 기간 동안 리스너를 제거하면 안 됩니다(MUST NOT). 이 상호 재알림 구조 덕분에 지갑 코드와 디앱 코드 중 어느 쪽이 먼저 실행되든 발견이 보장됩니다. 디앱은 수신한 ProviderDetail들을 저장해 두거나, 새 request 이벤트로 발견 과정을 다시 시작할 수 있습니다(MAY).

하위 호환: window.ethereum은 남기되 예비 수단으로

이 EIP는 window.ethereum을 대체하라고 요구하지 않으므로 기존 애플리케이션을 직접 깨뜨리지 않습니다. 다만 디앱은 이 EIP를 구현하고 window.ethereum 사용은 발견 실패 시의 예비 수단으로만 두는 것이 권장되며 지갑도 미구현 디앱을 위해 window.ethereum 호환을 유지하는 것이 SHOULD입니다. 네임스페이스 충돌을 피하려면 지갑이 프로바이더 객체를 지갑 고유 네임스페이스에 주입한 뒤 window.ethereum으로 프록시하는 방식이 RECOMMENDED입니다. 레거시 지갑이 여러 개 설치된 환경에서는 이 명세를 따르는 디앱이라도 올바른 지갑이 선택된다고 보장할 수 없습니다.

보안: 객체 동결, 사칭 감지, 핑거프린팅 방지

지갑 프로바이더 객체는 트랜잭션 데이터를 다루는 고신뢰 인터페이스이므로, 발송 전에 EIP1193Provider 객체를 Object.freeze()로 동결하는 것이 최선의 관행입니다. 다만 페이지가 객체를 몽키 패치해야 하는 웹 호환성 문제가 있어 보안과 호환성 사이의 트레이드오프는 지갑 구현자가 판단합니다. 디앱은 두 EIP6963ProviderInfo의 uuid가 일치하는지 확인하는 등 다른 지갑을 사칭하거나 변조하는 행위를 능동적으로 감지해야 합니다. 또 이 설계에서는 디앱 쪽에서 발견을 시작할 수도 있으므로, 지갑이 requestProvider를 받을 때까지 주입을 미루고 사용자 동의 UI를 거치는 식의 '프라이빗 연결' 기능으로 window.ethereum 주입으로 인한 핑거프린팅을 줄이는 선택지도 열립니다.

EIP 원문 · ← EIPs