메타마스크 오류 원인과 해결 방법: JSON-RPC 코드 정리
메타마스크에서 토큰을 전송하거나 교환하고 탈중앙화 애플리케이션을 이용하는 과정에서 Internal JSON-RPC error 메시지가 나타날 수 있습니다. 이 오류는 메타마스크가 블록체인 노드에 요청을 보냈지만 정상적인 응답을 받지 못했다는 의미입니다.
오류의 원인은 네트워크 설정, RPC 서버 상태, 가스 수수료 부족, 보류 중인 거래 및 스마트 계약 실행 실패 등으로 다양합니다. 오류 메시지에 포함된 숫자 코드를 확인하면 문제의 원인을 조금 더 정확하게 구분할 수 있습니다.
메타마스크 JSON-RPC 오류란 무엇일까?
JSON-RPC는 메타마스크와 블록체인 노드가 정보를 주고받는 통신 규칙입니다. 사용자가 잔액을 확인하거나 거래를 요청하면 메타마스크는 RPC 서버를 통해 블록체인에 필요한 데이터를 요청합니다.
RPC 서버는 요청을 분석한 다음 잔액, 거래 상태, 가스 수수료와 같은 정보를 메타마스크에 반환합니다. 이 과정에서 요청 형식이 잘못됐거나 서버가 응답하지 못하면 JSON-RPC 오류가 발생합니다.
Internal JSON-RPC 오류는 메타마스크 지갑 자체가 해킹됐다는 의미가 아닙니다. 대부분 네트워크 연결이나 거래 처리 과정에서 발생한 문제이므로 복구 문구나 개인 키를 다시 입력할 필요가 없습니다.
JSON-RPC 오류가 발생하는 이유
같은 오류 메시지가 나타나더라도 실제 원인은 사용자 환경과 이용 중인 네트워크에 따라 다를 수 있습니다.
JSON-RPC 오류가 발생하는 주요 원인은 다음과 같습니다.
- 잘못된 네트워크 설정: RPC URL이나 체인 ID가 실제 네트워크 정보와 일치하지 않으면 메타마스크가 올바른 노드에 연결되지 않습니다.
- RPC 서버 장애: 이용 중인 RPC 서버가 점검 중이거나 요청이 몰리면 정상적인 응답을 받지 못할 수 있습니다.
- RPC 사용량 제한: 무료 RPC 서버는 일정 시간 동안 처리할 수 있는 요청 수를 제한할 수 있습니다. 요청이 한꺼번에 몰리면 오류가 발생하거나 응답이 늦어질 수 있습니다.
- 가스 수수료 코인 부족: 토큰 잔액이 충분하더라도 해당 네트워크의 기본 코인이 없으면 거래나 스마트 계약을 실행할 수 없습니다.
- 스마트 계약 실행 실패: 교환 수량, 토큰 승인, 슬리피지 또는 계약 조건이 맞지 않으면 거래가 실행되는 과정에서 요청이 거부될 수 있습니다.
- 보류 중인 거래와 논스 충돌: 이전 거래가 처리되지 않은 상태에서 다음 거래를 요청하면 거래 순서를 나타내는 논스가 충돌할 수 있습니다.
- 지원이 종료된 네트워크: 종료되거나 변경된 테스트넷의 기존 RPC 주소를 계속 사용하면 노드가 요청에 응답하지 않을 수 있습니다.
- 메타마스크 또는 하드웨어 지갑 문제: 오래된 메타마스크 버전이나 Ledger·Trezor 연결 오류로 요청이 정상적으로 전달되지 않을 수 있습니다.
메타마스크 JSON-RPC 오류 해결 방법
대부분의 JSON-RPC 오류는 복구 문구를 다시 입력하거나 메타마스크를 삭제하지 않아도 해결할 수 있습니다. 아래 방법을 순서대로 확인하는 것이 좋습니다.
- 네트워크를 전환한 후 다시 연결합니다.
오류가 발생한 네트워크에서 다른 네트워크로 전환한 다음 원래 네트워크로 돌아옵니다. 연결된 웹사이트도 새로고침하고 메타마스크 연결을 해제한 뒤 다시 연결합니다. - RPC URL과 체인 ID를 확인합니다.
메타마스크의 네트워크 설정에서 오류가 발생한 네트워크를 선택합니다. 입력된 RPC URL과 체인 ID를 해당 블록체인의 공식 문서에 표시된 정보와 비교합니다. 출처가 불분명한 RPC 주소는 사용하지 않아야 합니다. - 다른 공식 RPC 주소로 변경합니다.
네트워크에서 여러 RPC 주소를 제공한다면 기존 서버 대신 다른 공식 RPC 서버로 변경할 수 있습니다. 기존 서버가 점검 중이거나 사용량 제한에 도달한 경우 RPC 변경만으로 해결될 수 있습니다. - 가스 수수료 기본 코인을 확인합니다.
이더리움에서는 ETH, BNB 스마트 체인에서는 BNB, 폴리곤에서는 POL처럼 해당 네트워크에서 가스 수수료로 사용하는 기본 코인이 필요합니다. 예상 수수료보다 충분한 잔액을 보유하고 있는지 확인합니다. - 메타마스크와 브라우저를 업데이트합니다.
브라우저 확장 프로그램 또는 모바일 앱이 최신 버전인지 확인합니다. 업데이트가 완료되면 브라우저를 완전히 종료했다가 다시 실행합니다. 인터넷 연결이 불안정하다면 VPN이나 광고 차단 프로그램을 잠시 끈 뒤 다시 시도할 수 있습니다. - 웹사이트 연결과 요청 내용을 확인합니다.
특정 탈중앙화 애플리케이션에서만 오류가 발생한다면 해당 사이트의 연결을 해제한 뒤 공식 주소를 확인하고 다시 연결합니다. 토큰 교환 과정에서는 승인 수량, 슬리피지, 최소 수령 수량과 스마트 계약 상태도 확인해야 합니다. - 보류 중인 거래를 확인합니다.
블록 탐색기에서 지갑 주소나 거래 해시를 검색해 기존 거래가 보류 중인지 확인합니다. 보류된 거래가 있다면 동일한 거래를 반복해서 요청하지 말고 기존 거래가 처리되거나 취소되는지 먼저 확인합니다. - 하드웨어 지갑을 다시 연결합니다.
Ledger나 Trezor를 사용하는 경우 기기 잠금을 해제하고 관련 애플리케이션과 펌웨어를 업데이트합니다. 연결 방식을 다시 설정하고 하드웨어 지갑 화면에 표시되는 주소와 거래 내용을 직접 확인합니다.
메시지에 표시되는 주요 오류 코드
메타마스크의 오류 메시지를 펼쳐보면 숫자로 된 오류 코드를 확인할 수 있습니다. 오류 코드는 크게 JSON-RPC 표준 오류, 메타마스크 공급자 오류와 HTTP 통신 오류로 구분할 수 있습니다.
자주 확인되는 오류 코드와 의미는 다음과 같습니다.
- 오류 코드 -32700: JSON 데이터의 구문을 분석하지 못했다는 의미입니다. 요청 데이터가 손상됐거나 올바른 JSON 형식으로 전달되지 않았을 때 발생할 수 있습니다.
- 오류 코드 -32600: RPC 요청의 형식이 올바르지 않다는 의미입니다. 요청에 필요한 정보가 없거나 구조가 잘못됐을 때 나타납니다.
- 오류 코드 -32601: 요청한 기능이나 메서드를 RPC 서버에서 찾을 수 없다는 의미입니다. 해당 노드가 요청한 기능을 지원하지 않을 때 발생할 수 있습니다.
- 오류 코드 -32602: 요청에 전달된 매개변수가 잘못됐다는 의미입니다. 토큰 수량, 주소, 네트워크 정보 또는 스마트 계약 호출 값이 올바르지 않을 때 나타날 수 있습니다.
- 오류 코드 -32603: 서버가 요청을 처리하는 과정에서 내부 오류가 발생했다는 의미입니다. 메타마스크에서 표시되는 Internal JSON-RPC 오류에 주로 포함되며 RPC 서버, 가스 수수료, 네트워크 설정과 스마트 계약 실행 상태를 함께 확인해야 합니다.
- 오류 코드 -32000~-32099: RPC 서버나 블록체인 노드가 자체적으로 사용하는 서버 오류 범위입니다. 가스 추정 실패, 거래 거부, 논스 충돌 또는 노드 동기화 문제처럼 오류를 반환한 서비스에 따라 원인이 달라질 수 있습니다.
메타마스크와 웹사이트의 연결 과정에서는 다음과 같은 공급자 오류도 나타날 수 있습니다.
- 오류 코드 4001: 사용자가 연결, 서명 또는 거래 요청을 거부했을 때 발생합니다.
- 오류 코드 4100: 연결된 웹사이트가 요청한 계정이나 기능에 접근할 권한이 없다는 의미입니다. 지갑 연결을 해제한 뒤 필요한 계정을 선택해 다시 연결할 수 있습니다.
- 오류 코드 4200: 메타마스크가 해당 요청 방식이나 기능을 지원하지 않는다는 의미입니다.
- 오류 코드 4900: 메타마스크가 모든 블록체인 네트워크와 연결되지 않은 상태라는 의미입니다. 인터넷과 RPC 서버의 연결 상태를 확인해야 합니다.
- 오류 코드 4901: 메타마스크는 다른 네트워크와 연결돼 있지만 웹사이트가 요청한 특정 네트워크에는 연결되지 않았다는 의미입니다.
- 오류 코드 429: 짧은 시간에 너무 많은 요청을 보내 RPC 제공자가 접속을 제한했다는 의미입니다. JSON-RPC 표준 오류가 아닌 HTTP 상태 코드이며 잠시 기다리거나 다른 공식 RPC 서버를 사용하면 해결될 수 있습니다.
오류 코드만으로 모든 원인을 확정할 수는 없습니다. 같은 -32603 오류라도 네트워크 설정, 가스 수수료 부족 또는 스마트 계약 실행 실패처럼 서로 다른 문제로 발생할 수 있습니다.
활동 및 논스 데이터 지우기는 언제 사용할까?
메타마스크 확장 프로그램에는 활동 및 논스 데이터 지우기 기능이 있습니다. 모바일에서는 계정 재설정이라는 이름으로 표시될 수 있습니다.
이 기능은 메타마스크 내부에 저장된 거래 기록과 보류 상태를 초기화합니다. 블록체인에 기록된 거래와 지갑에 보관된 암호화폐를 삭제하는 기능은 아닙니다.
그러나 메타마스크 공식 안내에서는 지원팀이나 MetaMask Activity에서 안내받은 경우에만 사용하도록 권고하고 있습니다. 특히 거래가 블록 탐색기에 정상적으로 표시되고 있다면 해당 기능을 사용하지 않는 것이 좋습니다.
계정 재설정과 지갑 재설정은 서로 다릅니다. 지갑 재설정이나 앱 삭제는 복구 문구가 필요할 수 있으므로 복구 정보를 확인하지 않은 상태에서 진행해서는 안 됩니다.
오류가 해결되지 않을 때 확인할 사항
모든 방법을 시도했는데도 문제가 계속된다면 같은 네트워크의 다른 웹사이트에서도 오류가 발생하는지 확인합니다. 특정 서비스에서만 오류가 발생한다면 해당 애플리케이션의 스마트 계약이나 서버 문제일 가능성이 있습니다.
해당 네트워크의 공식 상태 페이지와 공지를 확인해 RPC 장애나 네트워크 점검 여부를 살펴보는 것도 필요합니다. 테스트넷을 사용하고 있다면 현재 운영 중인 네트워크와 RPC 주소가 맞는지 확인해야 합니다.
메타마스크를 삭제하고 다시 설치하는 방법은 마지막 단계로 고려해야 합니다. 복구 문구와 가져온 계정의 개인 키를 안전하게 보관하지 않은 상태에서 삭제하면 지갑에 다시 접근하지 못할 수 있습니다.
도움이 필요하다면 메타마스크 공식 지원 페이지를 이용해야 합니다. 메신저나 소셜미디어에서 먼저 연락해 복구 문구나 개인 키를 요구하는 계정은 공식 지원 담당자가 아닙니다.
마무리
메타마스크 Internal JSON-RPC 오류는 RPC 서버가 요청을 정상적으로 처리하지 못했을 때 나타나는 메시지입니다. 잘못된 네트워크 설정, 서버 장애, 가스 수수료 부족, 스마트 계약 실행 실패와 보류 중인 거래 등이 주요 원인입니다.
먼저 오류 메시지에 포함된 코드를 확인한 다음 네트워크 연결, RPC URL과 체인 ID, 가스 수수료 기본 코인 및 메타마스크 버전을 순서대로 점검하는 것이 좋습니다.
JSON-RPC 오류가 발생했다는 이유로 복구 문구나 개인 키를 웹사이트에 입력해서는 안 됩니다. 네트워크 정보와 해결 방법은 메타마스크 및 해당 블록체인의 공식 자료를 기준으로 확인해야 합니다.
