EIP-695 eth_chainId JSON-RPC 메서드 추가 (Create `eth_chainId` method for JSON-RPC)
최종 확정 · 네트워크·노드 · 원문 상태 Final · 2017-08-21 작성
지갑이나 앱이 이더리움 노드에 "지금 어느 체인에 연결돼 있나요?"라고 물어볼 수 있는 표준 질의 방법인 eth_chainId를 JSON-RPC에 추가합니다.
왜 필요한가
지갑이나 앱은 직접 블록체인에 접속하는 대신 노드가 열어 둔 질의 창구(JSON-RPC)를 거쳐 체인과 통신합니다. 그런데 이 EIP 이전에는 네트워크 ID를 묻는 net_version만 있었고 서명에 실제로 쓰이는 체인 ID(chain ID)를 묻는 방법이 없었습니다. 체인 ID는 EIP-155가 도입한 값으로, 한 체인에서 만든 서명이 다른 체인에서 재사용되는 것(리플레이 공격)을 막는 핵심 재료입니다. 이 값을 확인할 수 없으면 이더리움(ETH)용 앱이 이더리움 클래식(ETC) 노드에 잘못 연결되어도 트랜잭션에 서명해 보기 전까지 알아차릴 수 없습니다. 실제로 메타마스크(MetaMask) 같은 지갑이 여러 체인을 지원하는 과정에서 이 문제로 어려움을 겪었습니다. 그래서 연결된 체인을 바로 확인할 수 있는 전용 메서드가 필요했습니다.
무엇이 바뀌나
지금
- 노드에 네트워크 ID를 묻는 net_version만 있고 체인 ID를 묻는 방법이 없습니다
- 서명을 시도하거나 기존 서명된 트랜잭션을 분석해야 어느 체인인지 알 수 있습니다
- ETH 앱이 ETC 노드에 잘못 연결돼도 바로 알아차리기 어렵습니다
EIP-695 이후
- eth_chainId 한 번 호출로 현재 체인 ID를 바로 확인합니다
- 반환값은 최신 블록 기준이라 그대로 서명에 사용할 수 있습니다
- 지갑과 앱이 연결된 체인을 신뢰성 있게 식별해 다중 체인 지원이 쉬워집니다
누구에게 영향이 있나
- 지갑·앱 개발자: 연결된 노드가 어느 체인인지 표준 방법으로 확인할 수 있어 다중 체인 지원과 리플레이 방지 서명이 쉬워집니다.
- 클라이언트(노드) 팀: eth_chainId를 정확히 구현하고 사용을 권장해야 합니다. Parity, Geth, Geth Classic에 구현 PR이 올라왔습니다.
- 사용자: 지갑이 엉뚱한 체인에 연결된 상태로 서명하는 사고를 예방할 수 있어 자산이 더 안전해집니다.
심층 설명
메서드 정의와 최신 블록 보장
eth_chainId는 현재 설정된 체인 ID를 반환합니다. 이 값은 EIP-155가 도입한 리플레이 보호 트랜잭션 서명에 쓰이는 CHAIN_ID입니다. 명세는 반환되는 체인 ID가 항상 현재 알려진 헤드 블록(head block)의 정보와 일치해야 한다고 요구합니다. 호출자가 받은 값을 그대로 써서 헤드 위에 쌓이는 트랜잭션에 서명할 수 있도록 보장하기 위해서입니다. 만약 현재 헤드 블록에 체인 ID가 지정되어 있지 않다면, 클라이언트는 이 메서드가 지원되지 않는 것처럼 처리하고 적절한 오류를 반환해야 합니다.
파라미터와 반환 형식
파라미터는 없습니다. 반환값은 QUANTITY 타입으로, 현재 체인 ID의 정수를 16진수 문자열 하나로 표현합니다. 인코딩은 이더리움 JSON-RPC의 표준 16진수 값 인코딩 규칙을 따릅니다. 원문 예시에서는 {"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":83} 요청에 대해 result로 "0x3d"(십진수 61)를 돌려줍니다.
왜 net_version으로는 부족한가
net_version은 네트워크 ID를 돌려줄 뿐 체인 ID를 알려 주지 않습니다. 그래서 ETH용 클라이언트가 ETC RPC 엔드포인트에, 또는 그 반대로 잘못 연결되어도 트랜잭션에 서명해 보거나 체인 ID로 서명된 것이 확실한 트랜잭션을 가져와 보기 전까지는 알 수 없습니다. 원문은 이 문제가 메타마스크 같은 애플리케이션 개발자들이 다중 체인 지원을 추가할 때 실제로 어려움을 일으켰다고 밝힙니다.
보안 고려 사항
원문은 소비자(consumer)가 통신 중인 체인을 신뢰성 있게 식별할 수 있도록 net_version보다 eth_chainId를 우선 사용하라고 권고합니다. 체인 ID는 EIP-155에 기술된 대로 리플레이 공격 방지에 핵심적인 값이고 소비자들이 체인 식별을 이 값에 의존하게 되므로, 구현자는 eth_chainId를 정확히 구현하고 그 사용을 적극 알려야 합니다.
상태와 구현 현황
이 EIP는 Interface 카테고리의 Standards Track 제안으로, 상태는 Final입니다. 명세가 확정되어 더 바뀌지 않습니다. 원문에는 Parity, Geth, Geth Classic 세 클라이언트의 구현 PR이 링크되어 있습니다. 하위 호환성 절은 해당 사항 없음(Not relevant)으로 기재되어 있습니다.