EIP-5749 window.evmproviders 객체 (The 'window.evmproviders' object)

최종 확정 · 기타 · 원문 상태 Final · 2022-10-04 작성

브라우저 지갑들이 window.ethereum 자리 하나를 놓고 경쟁하는 대신, 각 지갑이 window.evmproviders 객체에 자기 정보를 등록해 여러 지갑이 한 브라우저에서 함께 동작하게 하는 표준입니다.

왜 필요한가

브라우저 확장 지갑은 웹페이지에 자신을 '주입'해서 앱과 연결됩니다. 2015년 미스트(Mist) 지갑 이후 그 자리는 window.ethereum 하나였고, 이 자리는 한 번에 지갑 하나만 차지할 수 있습니다. 메타마스크, 코인베이스 월렛, 엔크립트, 트러스트 월렛, 레인보우처럼 여러 지갑을 같이 설치하면 어느 지갑이 연결될지 알 수 없는 경쟁 상태(race condition)가 생기고 연결 동작이 들쭉날쭉해집니다. 그래서 사용자는 새 지갑을 써 보기 어렵고 시장은 기존 지갑이 대부분을 가져가는 승자독식 구도가 됩니다. 신규 지갑은 자리를 잡기 어렵고 기존 지갑은 혁신할 압력을 덜 받습니다. 지갑마다 자기만의 이름 공간을 따로 주입하는 우회책도 있지만 모든 앱이 세상의 모든 지갑 이름을 알아야 하므로 현실적이지 않습니다. 이 EIP는 지갑들이 공유하는 등록부 하나를 만들어 이 문제를 풉니다.

무엇이 바뀌나

지금

EIP-5749 이후

누구에게 영향이 있나

심층 설명

ProviderInfo 타입

지갑 선택 화면을 그리는 데 필요한 정보를 담는 타입입니다. 네 필드 모두 읽기 전용입니다. uuid는 지갑 제공자별 UUIDv4로, 버전이 바뀌어도 같아야 하고 채널(지갑 제품)마다 달라야 합니다. 예를 들어 MetaMask 10.22.2와 9.8.1은 같은 uuid를, MetaMask·Trust wallet·Enkrypt는 서로 다른 uuid를 가져야 합니다. name은 지갑 이름(예: MetaMask, Enkrypt), icon은 data:image/svg+xml;base64, 로 시작하는 base64 인코딩 SVG 이미지(base64는 RFC 4648 정의), description은 지갑 설명입니다.

ProviderWithInfo와 EVMProviders

ProviderWithInfo는 EIP-1193의 EIP1193Provider를 확장해 info: ProviderInfo 필드를 추가한 타입입니다. 즉 기존 프로바이더 인터페이스는 그대로 두고 표시용 메타데이터만 얹습니다. window.evmproviders의 타입인 EVMProviders는 문자열 키로 ProviderWithInfo를 담는 맵입니다. 키는 확장 프로그램 이름의 snake_case가 권장(RECOMMENDED)되며 소문자, 숫자, 밑줄만 포함해야 합니다(MUST).

주입과 조회 구현

주입 쪽은 window.evmproviders = window.evmproviders || {} 로 객체가 없으면 만들고 window.evmproviders[name] = provider 로 자신을 등록합니다. 먼저 로드된 지갑이 뒤에 오는 지갑을 덮어쓰거나 막지 않습니다. 조회 쪽은 Object.values(window.evmproviders) 로 설치된 모든 프로바이더 배열을 얻습니다. 이 단순한 구조 덕분에 web3modal, web3onboard 같은 라이브러리가 사용자가 설치한 지갑 전부를 보여 줄 수 있습니다.

이름과 아이콘 형식을 고른 이유

ProviderInfo 타입을 표준화하면 지갑 선택 팝업을 채우는 데 필요한 정보를 바로 알 수 있습니다. Web3Modal, Web3React, Web3Onboard 같은 web3 온보딩 라이브러리에 특히 유용합니다. 객체 이름을 ethereumproviders가 아니라 evmproviders로 정한 것은 다른 EVM 호환 체인까지 포괄하기 위해서입니다. 아이콘을 SVG로 정한 것은 유연하고 가벼우며 크기를 자유롭게 바꿀 수 있기 때문입니다.

하위 호환성

이 EIP 자체는 window.ethereum을 없애라고 요구하지 않으므로 기존 앱을 직접 깨뜨리지 않습니다. 지갑은 두 방식을 함께 지원할 수 있습니다. 다만 제목과 설명에 담긴 권장 방향, 즉 장기적으로 window.ethereum을 대체하는 쪽으로 가면 window.ethereum에 의존하는 기존 앱은 동작이 깨집니다.

보안 고려 사항

EIP-1193의 보안 고려 사항이 그대로 적용됩니다. 추가로 SVG 이미지는 내부에 JavaScript 코드를 포함할 수 있어 크로스 사이트 스크립팅(XSS) 위험이 있습니다. 앱과 라이브러리는 지갑 아이콘 SVG를 반드시 <img> 태그로 렌더링해서 스크립트가 실행되지 않게 해야 합니다. 이 EIP는 Final 상태로 명세가 확정되어 있습니다.

EIP 원문 · ← EIPs