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) 같은 지갑이 여러 체인을 지원하는 과정에서 이 문제로 어려움을 겪었습니다. 그래서 연결된 체인을 바로 확인할 수 있는 전용 메서드가 필요했습니다.

무엇이 바뀌나

지금

EIP-695 이후

누구에게 영향이 있나

심층 설명

메서드 정의와 최신 블록 보장

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)으로 기재되어 있습니다.

EIP 원문 · ← EIPs