ERC-7876 DApp용 통합 네트워크 설정 (Ethereum Network Configuration for DApps)

Draft · 기타 · 2025-01-03 작성

DApp이 이더리움 호환 네트워크의 RPC, 네이티브 화폐, 컨트랙트 주소, 블록 탐색기 정보를 하나의 JSON 포맷으로 통일해 관리하도록 하는 설정 표준입니다.

왜 필요한가

DApp은 여러 이더리움 호환 네트워크를 지원하지만, 네트워크 설정을 각자 다른 형식으로 정의하는 경우가 많습니다. 이 때문에 네트워크 간 상호운용성과 설정 공유가 어려워집니다. 네트워크 운영자가 자신의 체인을 여러 DApp에 일관되게 지원시키려 해도, 스마트컨트랙트 개발자가 주소나 ABI 변경을 여러 플랫폼에 전달하려 해도, 조직 내부에서 iOS와 Android 등 여러 플랫폼의 설정을 통일하려 해도 표준이 없으면 매번 새로운 포맷을 설계해야 합니다. 또한 체인마다 고유한 기능을 표현할 표준 필드가 없으면 네트워크는 외부 저장소에 별도로 커스텀 설정을 보관해야 하므로 통합 관리가 더 어려워집니다.

심층 설명

최상위 Configuration 구조

최상위 Configuration 객체는 version(semver 형식 버전), timestamp(ISO 8601 형식 갱신 시각), summary(설정에 대한 짧은 요약), description(상세 설명), abiRoot(ABI가 외부에 호스팅된 경우의 루트 URL, 없으면 null), networks(체인ID를 키로 하는 NetworkConfig 레코드)로 구성됩니다. 설정 전체는 JSON 객체를 사용해야 하며(MUST), 들여쓰기는 공백 2칸을 권장합니다(RECOMMENDED).

NetworkConfig 필드

각 네트워크는 NetworkConfig로 표현됩니다. name(네트워크 이름), testnet(테스트넷 여부를 나타내는 불리언), nativeCurrency(name, symbol, decimals로 구성된 네이티브 화폐 정보), relations(다른 네트워크와의 관계), rpcs(노드 이름을 키로 하는 RpcConfig 레코드), explorers(블록 탐색기 레코드), contracts(컨트랙트 이름을 키로 하는 ContractConfig 레코드, 값은 미배포 시 null)를 포함합니다. 네트워크의 고유 식별자로는 네트워크 이름이 아니라 체인ID를 키로 사용합니다.

ContractConfig와 컨트랙트 규칙

ContractConfig는 address(체크섬 주소, MUST), abiUrl(ABI JSON 파일 경로, abiRoot 기준 상대경로 또는 절대경로 가능, 없거나 null이면 ABI 불명), blockCreated(배포된 블록 번호)로 구성됩니다. 설정에 나열하는 컨트랙트는 필요한 범위로 한정해야 하며(SHOULD), 같은 이름의 컨트랙트는 모든 네트워크에서 이름이 일관되어야 합니다(MUST). 바이트코드는 네트워크마다 다를 수 있지만 같은 컨트랙트의 다른 버전을 나타내야 하며(SHOULD), 차이는 커스텀 속성이나 다른 abiUrl로 전달합니다. ABI를 설정 안에 직접 인라인하는 것은 금지되며(MUST NOT), 컨트랙트가 미배포된 네트워크는 값을 null로 명시해야 합니다(MUST). 블록 탐색기에서 바이트코드가 검증된 경우 컨트랙트 이름은 Solidity 소스 코드의 이름과 일치시키는 것이 권장됩니다(RECOMMENDED).

ExplorerConfig와 RpcConfig

ExplorerConfig는 root(탐색기 루트 URL), block, address, tx, nft(각각 root에 대한 상대 경로, 해당 기능이 없으면 null)로 구성됩니다. 상대 경로에는 :block, :address, :tx, :token 같은 자리표시자를 포함해야 하며(MUST), 이를 실제 값으로 치환해 링크를 만듭니다. RpcConfig는 url 하나만 가진 단순한 구조로, 여러 노드를 rpcs 레코드의 서로 다른 키(예: main, backup)로 등록할 수 있습니다.

확장(Extensions) 규칙

문서화되지 않은 속성은 구현체가 무시하거나 가능한 경우 해석을 지원해야 합니다(MUST). 이를 통해 호환성을 깨지 않고 설정을 확장할 수 있습니다. 새 속성은 새로운 기능을 지원하는 데 쓰여야 하지만(SHOULD) 기존 속성의 기본 타입을 바꾸거나 확장해서는 안 됩니다(MUST NOT). 확장에서 유니온 타입은 쓰지 않아야 하며(SHOULD NOT), blockCreated를 숫자 대신 16진수 문자열로 바꾸는 것이 잘못된 확장의 예로 제시됩니다. 확장은 모든 설정 레이어에서 속성을 추가할 수 있는 유연한 구조(예: documentationUrls: string[] 대신 documentation: { url: string }[])를 사용해야 합니다(SHOULD).

체인ID 사용과 EIP-3085 호환성

이 표준은 네트워크의 고유 식별자로 임의의 이름 대신 체인ID를 사용합니다. 체인ID는 이더리움 명세에 포함되어 전역적으로 인식되고 충돌이 없어 기존 툴링과의 상호운용성을 높이기 때문입니다. 또한 이 표준은 지갑의 Add Ethereum Chain 요청을 다루는 EIP-3085와 가능한 한 호환되도록 설계되었지만, EIP-3085의 경직된 구조가 향후 확장을 제한하는 지점에서는 확장성을 우선해 다르게 설계되었습니다.

표준의 현재 상태

이 표준은 현재 Draft 상태이며 requires로 EIP-55(체크섬 주소)를 명시하고 있습니다. Draft 상태이므로 세부 필드나 규칙이 앞으로 바뀌거나 논의가 중단될 수 있는 제안입니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs