MetaMask 스냅 설치 실패를 수정하는 방법은 무엇입니까?

MetaMask 스냅 실패 패턴 이해

1. 브라우저 확장 버전이 v10.24.0 미만인 경우 Snaps 설치가 실패합니다. 이전 빌드에는 타사 모듈에 대한 필수 권한 위임 논리가 부족하기 때문입니다.

2. 충돌하는 브라우저 확장 프로그램(특히 uBlock Origin과 같은 광고 차단기 또는 Privacy Badger와 같은 개인 정보 보호 도구)은 Snap 매니페스트 가져오기 및 스크립트 삽입을 방해합니다.

3. 기업 또는 ISP 관리 환경의 네트워크 수준 필터링은 https://registry.snapcraft.io 에 대한 액세스를 차단하여 다운로드가 시작되기 전에 검색 단계를 중단합니다.

4. 스냅 메타데이터와 관련된 손상된 로컬 IndexedDB 항목으로 인해 초기화 중에 서명 확인이 자동으로 중단됩니다.

5. 운영 체제 시간차가 ±60초를 초과하면 스냅 레지스트리 끝점에서 TLS 인증서 검증 실패가 발생하여 설명적인 오류 코드 없이 "가져오기 실패"가 발생합니다.

브라우저별 구성 조정

1. Chrome에서 chrome://flags/#enable-experimental-web-platform-features 로 이동하여 플래그를 활성화합니다. 나중에 브라우저를 다시 시작하세요.

2. Firefox 사용자의 경우 주소 표시줄에 about:config를 입력하고 dom.webcomComponents.customelements.enabled 를 검색한 후 true 로 설정합니다.

3. Brave에서는 단순히 보호 수준을 낮추는 것이 아니라 Metamask.io 의 사이트 설정에서 Shield를 완전히 비활성화해야 합니다.

4. Edge 사용자는 edge://settings/privacy 에서 "사이트에서 확장 프로그램이 설치되어 있는지 확인하도록 허용"이 활성화되어 있는지 확인해야 합니다.

5. WebKit에 WebAssembly.Global 이 없고 Web Crypto API 구현이 불완전하기 때문에 Safari는 현재 Snap 설치가 지원되지 않습니다.

수동 스냅 레지스트리 우회 절차

1. 대상 스냅의 검증된 GitHub 릴리스 페이지(예: https://github.com/MetaMask/snaps/releases )에서 공식 Snap 번들 ZIP을 다운로드합니다.

2. dist/bundle.js 파일을 추출하고 MetaMask 설정 → 고급 → "실험 기능 표시" → "Snaps 개발자 모드"를 전환합니다.

3. "로컬에 Snaps 설치"를 클릭한 다음 추출된 Bundle.js 파일을 선택합니다. 이 단계에서는 네트워크 호출이 발생하지 않습니다.

4. 표시된 권한을 검토하여 설치를 확인합니다. 계정 액세스 , 트랜잭션 서명 및 네트워크 전환이 모두 명시적으로 나열되어야 합니다.

5. UI에 "잘못된 매니페스트 형식"이 표시되면 ZIP에 올바른 버전 , 제안된 이름 및 설명 필드가 있는 유효한 snaps.manifest.json이 포함되어 있는지 확인하세요.

노드 수준 RPC 간섭 완화

1. MetaMask 설정 → 네트워크 → "네트워크 편집"에서 모든 사용자 정의 RPC를 일시적으로 비활성화하고 "테스트 네트워크 표시"를 선택 취소하고 기본이 아닌 체인을 제거합니다.

2. MetaMask를 이더리움 메인넷으로 전환하고 Snap 설치를 다시 시도하기 전에 거래 내역이 올바르게 로드되는지 확인하세요.

3. MetaMask 개발자 도구를 열고(확장 아이콘 마우스 오른쪽 버튼 클릭 → “확장 관리” → “보기 검사: popup.html”) 콘솔에서 localStorage.removeItem('rpcCache') 을 실행하여 캐시된 RPC 응답을 지웁니다.

4. Snap 설정 중에는 Infura 기반 RPC를 사용하지 마십시오. 대신 Snap 샌드박싱과 호환되는 보다 엄격한 CORS 헤더를 적용하는 MetaMask의 내장 폴백 노드를 사용하세요.

5. 하드웨어 지갑을 사용하는 경우 펌웨어가 v2.5.2 이상으로 업데이트되었는지 확인하세요. 이전 버전은 잘못된 EIP-712 도메인 구분 기호로 인해 Snap에서 시작된 서명 요청을 거부합니다.

자주 묻는 질문

Q: Snap을 설치하려면 선택한 네트워크에 ETH 잔고가 필요합니까? 아니요. Snap 설치는 클라이언트 측 작업이며 온체인 트랜잭션이나 가스 소비를 발생시키지 않습니다.

Q: 여러 개의 Snap을 동시에 설치할 수 있나요? 예, 하지만 한 번에 하나의 Snap만이 활성 거래 서명 권한을 보유할 수 있습니다. 권한이 중복되면 이전 부여가 자동으로 취소됩니다.

Q: 시크릿 모드에서는 Snap 설치가 성공하지만 일반 탐색에서는 실패하는 이유는 무엇입니까? 이는 기본 프로필에 등록된 영구 브라우저 확장 또는 캐시된 서비스 워커의 간섭을 나타냅니다. MetaMask를 제외한 모든 확장을 비활성화하고 DevTools의 애플리케이션 → 서비스 워커를 통해 서비스 워커를 지웁니다.

Q: 로컬에 설치된 Snap에 크기 제한이 있습니까? 예. 번들로 제공되는 JavaScript는 5MB 미만이어야 합니다. 이 값을 초과하면 팝업 UI에 '번들이 너무 큼'이라는 메시지가 표시되면서 즉시 거부됩니다.