dApp에서 "체인이 지원되지 않음"을 표시하는 MetaMask를 수정하는 방법은 무엇입니까?

체인이 지원되지 않음 오류 이해

1. dApp이 현재 MetaMask의 활성 네트워크 목록에 구성되어 있지 않은 블록체인 네트워크와 상호 작용을 시도할 때 오류가 나타납니다.

2. 이는 체인 ID, RPC URL 또는 블록 탐색기 URL이 수동으로 추가되지 않은 새로운 레이어 2 롤업 또는 사용자 정의 테스트넷의 초기 단계 테스트 중에 자주 발생합니다.

3. MetaMask는 내부 레지스트리에 대해 각 체인의 유효성을 검사합니다. 인식되지 않은 체인은 폴백 로직 없이 즉시 거부를 트리거합니다.

4. 일부 dApp에는 사용자가 선택한 네트워크와 충돌하는 하드코딩된 체인 매개변수가 포함되어 있어 올바른 체인이 선택된 것처럼 보이더라도 자동 불일치가 발생합니다.

5. 브라우저 캐싱은 오래된 체인 메타데이터를 보존하여 현재 dApp 요구 사항에 대한 오래된 유효성 검사를 유발할 수 있습니다.

네트워크 구성 확인

1. MetaMask 설정을 열고 네트워크 → 네트워크 추가 → 사용자 지정 RPC로 이동합니다.

2. 체인 ID가 dApp 문서에 지정된 것과 정확히 일치하는지 확인하세요. 대소문자를 구분하고 숫자만 사용합니다(예: "base"가 아닌 Base Mainnet의 경우 8453).

3. 타사 수집자나 커뮤니티에서 관리하는 목록이 아닌 dApp의 개발자 포털에서 직접 공식 RPC 엔드포인트를 붙여넣습니다.

4. 통화 기호 필드가 체인의 토큰 표준에 의해 정의된 정확한 티커를 사용하는지 확인하십시오(예: Ethereum의 "ETH", Polygon의 "MATIC", "matic" 또는 "Matic"이 아님).

5. 블록 탐색기 URL 형식을 대조 확인합니다. 새 탭에서 열 때 최근 블록을 표시하는 라이브 탐색기 페이지로 확인되어야 합니다.

dApp 측 불일치 처리

1. dApp의 프런트엔드 JavaScript 콘솔에서 "지원되지 않는 체인 ID" 경고를 검사합니다. 이 경고는 앱이 기대하는 정확한 체인 ID를 나타냅니다.

2. 브라우저의 개발자 도구를 사용하여 web3 공급자 초기화 코드를 찾고 올바른 매개변수로 ethereum.request({ method: 'wallet_addEthereumChain' }) 를 호출하는지 확인합니다.

3. dApp이 자동 전환을 시작하는 경우 체인 협상 중 세션 중단을 방지하기 위해 MetaMask의 "자동 잠금" 설정을 일시적으로 비활성화합니다.

4. 다시 연결하기 전에 dApp 도메인에 대한 사이트 쿠키와 로컬 저장소를 지웁니다. 캐시된 공급자 상태는 이전 체인 컨텍스트를 유지할 수 있습니다.

5. 디버깅을 위해 MetaMask의 모바일 앱을 사용하지 마세요. 데스크탑 확장은 설정 → 고급 → RPC 호출 표시를 통해 전체 RPC 검사를 제공합니다.

개발자 도구를 사용한 디버깅

1. Chrome DevTools를 실행하고 네트워크 탭으로 이동한 다음 "rpc" 또는 "json-rpc" 요청을 필터링하여 실패한 페이로드 응답을 관찰합니다.

2. 콘솔 탭에서 ethereum.chainId를 실행하여 현재 감지된 체인 ID를 검색하고 예상 값과 비교합니다.

3. Wait ethereum.request({ method: 'eth_chainId' })를 수동으로 실행하여 MetaMask가 UI에 표시된 것과 동일한 ID를 반환하는지 확인합니다.

4. 애플리케이션 → 스토리지 → IndexedDB에서 "메타마스크" 데이터베이스의 손상된 체인 메타데이터에 대한 IndexedDB 항목을 확인합니다.

5. "공급자 오류" 이벤트 리스너 출력을 모니터링하여 네트워크 시간 초과, 잘못된 응답 구조 또는 지원되지 않는 메서드 오류를 구별합니다.

자주 묻는 질문

Q: 올바른 네트워크를 추가한 후에도 내 dApp에 "체인이 지원되지 않음"이 표시되는 이유는 무엇입니까? A: dApp은 특정 EIP-1559 지원 플래그를 요구하거나 노드의 동기화 상태와 일치하지 않는 엄격한 블록 타임스탬프 창을 시행하는 등 체인 ID 이외의 추가 검증을 시행할 수 있습니다.

Q: 수동으로 전환하지 않고도 여러 체인을 동시에 추가할 수 있나요? 답: 그렇습니다. MetaMask는 모든 사용자 정의 네트워크를 지속적으로 저장합니다. 사용자는 재구성 없이 네트워크 드롭다운을 통해 즉시 전환할 수 있습니다.

Q: 개인정보 보호 모드를 비활성화하면 체인 감지에 영향을 미치나요? 답: 그렇습니다. 개인 정보 보호 모드가 활성화되면 MetaMask는 명시적인 사용자 승인이 있을 때까지 dApp의 체인 정보 액세스를 제한하므로 권한이 부여될 때까지 초기 탐지가 실패합니다.

Q: 두 개의 dApp이 동일한 체인 ID의 다른 버전을 요청하면 어떻게 되나요? A: MetaMask는 RPC 엔드포인트가 다르지 않는 한 이를 동일하게 취급합니다. 블록 탐색기 또는 통화 기호가 충돌하면 UI 불일치가 발생할 수 있지만 연결이 끊어지지는 않습니다.