EIP-5749 window.evmproviders 객체 (The 'window.evmproviders' object)
최종 확정 · 기타 · 원문 상태 Final · 2022-10-04 작성
브라우저 지갑들이 window.ethereum 자리 하나를 놓고 경쟁하는 대신, 각 지갑이 window.evmproviders 객체에 자기 정보를 등록해 여러 지갑이 한 브라우저에서 함께 동작하게 하는 표준입니다.
왜 필요한가
브라우저 확장 지갑은 웹페이지에 자신을 '주입'해서 앱과 연결됩니다. 2015년 미스트(Mist) 지갑 이후 그 자리는 window.ethereum 하나였고, 이 자리는 한 번에 지갑 하나만 차지할 수 있습니다. 메타마스크, 코인베이스 월렛, 엔크립트, 트러스트 월렛, 레인보우처럼 여러 지갑을 같이 설치하면 어느 지갑이 연결될지 알 수 없는 경쟁 상태(race condition)가 생기고 연결 동작이 들쭉날쭉해집니다. 그래서 사용자는 새 지갑을 써 보기 어렵고 시장은 기존 지갑이 대부분을 가져가는 승자독식 구도가 됩니다. 신규 지갑은 자리를 잡기 어렵고 기존 지갑은 혁신할 압력을 덜 받습니다. 지갑마다 자기만의 이름 공간을 따로 주입하는 우회책도 있지만 모든 앱이 세상의 모든 지갑 이름을 알아야 하므로 현실적이지 않습니다. 이 EIP는 지갑들이 공유하는 등록부 하나를 만들어 이 문제를 풉니다.
무엇이 바뀌나
지금
- window.ethereum 자리를 지갑 하나만 차지할 수 있습니다
- 지갑을 여러 개 설치하면 어느 지갑이 연결될지 예측할 수 없습니다
- 사용자가 새 지갑을 시험하기 어려워 승자독식 시장이 굳어집니다
EIP-5749 이후
- 각 지갑이 window.evmproviders에 고유한 키로 자신을 등록합니다
- 앱이 설치된 모든 지갑 목록을 읽어 선택 화면을 보여 줄 수 있습니다
- 지갑 간 경쟁 상태가 사라지고 여러 지갑을 함께 쓸 수 있습니다
누구에게 영향이 있나
- 사용자: 지갑을 여러 개 설치해도 연결이 꼬이지 않고 앱에서 쓸 지갑을 직접 고를 수 있습니다.
- 지갑 개발자: 신규 지갑도 window.ethereum 자리 싸움 없이 등록만 하면 기존 지갑과 나란히 노출됩니다.
- 앱·온보딩 라이브러리 개발자: web3modal, web3onboard 같은 지갑 선택 도구가 설치된 지갑 전부를 표준 방식으로 찾아 표시할 수 있습니다.
심층 설명
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 상태로 명세가 확정되어 있습니다.