목적 및 범위
이 페이지는 StableNet의 5개 시스템 컨트랙트와 그 고정 주소, 제네시스 배포·초기화 방식을 개략적으로 설명합니다.이 컨트랙트들은 검증자 관리, 민팅/소각 승인, 네이티브 스테이블코인 ERC-20 호환성을 위한 핵심 거버넌스 메커니즘을 구현합니다. 개별 컨트랙트에 대한 자세한 문서는 다음을 참조하세요:
- NativeCoinAdapter 컨트랙트 - 네이티브 잔액을 위한 ERC20 래퍼
- 검증자 거버넌스 (GovValidator) - 검증자 세트 관리
- 민팅 거버넌스 (GovMasterMinter 및 GovMinter) - 민터 등록 및 제안
- Council 거버넌스 (GovCouncil) - 블랙리스트 및 Authorized 계정 정책
- 민팅 및 번 프로토콜 - 엔드투엔드 민트/소각 워크플로우
5개의 시스템 컨트랙트
StableNet은 제네시스 블록 생성 시 미리 정해진 주소에 5개의 시스템 컨트랙트를 직접 배포합니다.이 컨트랙트들은 소유자 없이 배포되며, 일반적인 업그레이드 패턴(프록시 등)을 사용하지 않고 하드 포크를 통해서만 교체할 수 있습니다.
| Contract Name | Address | Primary Purpose | Version |
|---|---|---|---|
| NativeCoinAdapter | 0x0000000000000000000000000000000000001000 | 네이티브 스테이블코인 잔액에 대한 ERC-20 래퍼, mint/burn 진입점 | v1 |
| GovValidator | 0x0000000000000000000000000000000000001001 | 검증자 세트 관리, BLS 키 등록, 가스 팁(gasTip) 거버넌스 | v1 |
| GovMasterMinter | 0x0000000000000000000000000000000000001002 | 승인된 민터 레지스트리 및 전역 최대 민터 허용량 상한 관리 | v1 |
| GovMinter | 0x0000000000000000000000000000000000001003 | 증명 기반 민트/번 제안 생성·투표·실행 | v1 |
| GovCouncil | 0x0000000000000000000000000000000000001004 | 블랙리스트 및 Authorized 계정 세트 관리, AccountManager 연동 | v1 |
컨트랙트 배포 아키텍처
시스템 컨트랙트는 바이트코드와 초기화된 저장소를 모두 제네시스 상태에 쓰는 상태 전환 메커니즘을 통해 제네시스 블록 생성 중에 배포됩니다.제네시스 구성 구조
시스템 컨트랙트는 제네시스 파일의config.anzeon.systemContracts 섹션에 정의되며, 각 컨트랙트에 대해 주소·버전·초기화 매개변수를 지정합니다.
버전 관리 및 바이트코드 저장
컨트랙트 바이트코드는 컴파일 시 바이너리에 포함되며 컨트랙트 이름과 버전으로 인덱싱됩니다.SystemContractCodes 맵은 배포된 바이트코드에 대한 버전 제어 액세스를 제공합니다.
버전 검증 프로세스는 지원되는 컨트랙트 버전만 배포할 수 있도록 보장합니다.