infrablockchain-docs
ko
ko
  • 인프라블록체인
    • 배우기
      • 아키텍처
        • 아키텍처
        • 네트워크 참여자
        • 파라체인
          • 시스템 파라체인
      • 프로토콜
        • 시스템 토큰
        • 트랜잭션 수수료
        • Proof of Transaction
      • Substrate
        • 배우기
          • 기초 지식
            • 암호학
            • 블록체인 기본 개념
            • 합의
            • 네트워크와 노드
            • 트랜잭션과 블록 기본 사항
            • 트랜잭션 수명주기
            • 오프체인 작업
            • 라이트 클라이언트
            • Substrate를 위한 Rust
            • 라이브러리 소개
            • 아키텍처와 Rust 라이브러리
            • 파일 구조
            • 계정, 주소 및 키
            • 트랜잭션 형식
            • 난수 생성
          • 프레임
            • FRAME 팔레트
            • FRAME 매크로
            • 커스텀 팔레트
            • 팔레트 커플링
            • Origin
            • 이벤트와 에러
            • 런타임 스토리지 구조
            • 상태 전이와 스토리지
            • SCALE 인코딩
            • 트랜잭션, Weight 및 수수료
            • 런타임 API
            • 런타임 업그레이드
            • 런타임 개발
          • 계정 데이터 구조
          • 주소 형식
          • 용어집
          • cli
            • 아카이브
            • 메모리 프로파일러
            • 노드 템플릿
            • 사이드카
            • srtool
            • 서브키
            • subxt
            • try-runtime
            • tx-wrapper
          • 런타임 개발
            • 기본
              • Genesis 상태 구성하기
              • 런타임 상수 구성
              • 체인 스펙을 커스텀하기
              • 팔레트 가져오기
              • 도우미 함수 사용하기
            • 합의 모델
              • 작업 증명을 사용하는 체인 구성
              • 하이브리드 노드 생성하기
            • 오프체인 워커
              • 오프체인 HTTP 요청하기
              • 오프체인 인덱싱
              • 오프체인 로컬 스토리지
            • 팔레트 설계
              • 크라우드펀딩 구성하기
              • 스토리지 구조체 (struct) 생성하기
              • 잠금 가능한 통화 구현
              • 무작위성 적용하기
              • 느슨한 팔레트 결합 사용하기
              • 타이트한 팔레트 결합 사용하기
            • 파라체인 개발
              • HRMP 채널 추가하기
              • 로컬 파라체인 노드 추가하기
              • 릴레이 체인에 연결하기
              • 솔로 체인을 변환하기
              • 론칭 준비
              • 콜레이터 선택
              • 파라체인 업그레이드
            • 스토리지 마이그레이션
              • 기본 저장소 마이그레이션
              • 스토리지 마이그레이션 트리거
            • 테스트
              • 기본 테스트 설정하기
              • 전송 함수 테스트하기
            • 도구
              • 체인을 위한 txwrapper 생성
              • REST 엔드포인트를 사용하여 체인 데이터 가져오기
              • try-runtime 사용하기
              • Wasm 바이너리 검증하기
            • 가중치
              • 벤치마크 추가
              • 수수료 계산하기
              • 조건부 가중치 사용
              • 사용자 정의 가중치 사용하기
        • 빌드하기
          • 제작할 것을 결정하세요
          • 빌드 프로세스
          • 결정론적 런타임 빌드
          • 체인 스펙
          • Genesis 구성
          • 애플리케이션 개발
          • RPC
          • 문제 해결
        • 튜토리얼
          • 설치하기
            • 개발자 도구
            • 리눅스 개발 환경
            • macOS 개발 환경
            • Rust 툴체인
            • Rust 문제 해결 방법
            • Windows 개발 환경
          • 빠른 시작
            • 코드 탐색하기
            • 런타임 수정하기
            • 노드 시작하기
            • Substrate 한눈에 보기
          • 블록체인 구축
            • 신뢰할 수 있는 노드 추가
            • 특정 노드 승인
            • 로컬 블록체인 구축하기
            • 네트워크 시뮬레이션
            • 실행 중인 네트워크 업그레이드
          • 애플리케이션 로직 구축
            • 런타임에 팔레트 추가하기
            • 오프체인 워커 추가
            • 사용자 정의 팔레트 게시
            • 함수 호출의 출처 지정하기
            • 사용자 정의 팔레트에서 매크로 사용하기
          • 유용한 도구들
            • EVM 계정에 접근하기
            • 이더리움 통합
            • 사이드카 엔드포인트 탐색하기
            • 경량 클라이언트 노드 통합
          • 스마트 컨트랙트
            • 스마트 컨트랙트
            • 토큰 계약 작성하기
            • 스마트 컨트랙트 개발하기
            • 첫 번째 계약 준비하기
            • 스마트 컨트랙트 문제 해결
            • 값 저장을 위한 맵 사용
      • XCM
        • XCM
        • XCM 형식
    • 서비스 체인
      • 인프라DID
      • 인프라EVM
      • URAuth(Universal Resource Auth)
    • 데브 옵스
      • 체인 빌드
      • 배포
      • 모니터링
    • 튜토리얼
      • 기초
        • 시스템 토큰 관리 프로세스
        • 시스템 토큰을 트랜잭션 수수료로 사용해보기
        • 트랜잭션에 투표 포함 시키기
        • 밸리데이터 보상 받기
      • 구축하기
        • 인프라릴레이체인 구축하기
        • 파라체인 구축하기
        • 메시지 전달 채널 열기
        • XCM을 이용하여 토큰 전송하기
        • Asynchronous Backing 적용하기
      • 테스트
        • 벤치마크
        • 런타임 확인
        • 디버그
        • 테스트 네트워크에서 파라체인 시뮬레이션하기
        • 단위 테스트
      • 서비스체인
        • 인프라DID
          • 구축하기
          • 공개키 추가하기
          • 서비스 엔드포인트 등록하기
          • DID 생성하기
        • 인프라EVM
          • 구축하기
          • EVM에 자금 입금 및 인출하기
          • ERC20 토큰 컨트랙트 배포하기
          • ERC721 토큰 컨트랙트 배포하기
          • ERC1155 토큰 컨트랙트 배포하기
  • 뉴날 데이터 마켓
Powered by GitBook
On this page
  • 외부 노드 설정 커스텀하기
  • genesis 구성 커스텀하기
  • 체인 스펙 정보 저장하기
  • 노드 시작에 체인 스펙 제공하기
  • 런타임을 위한 스토리지 항목 선언하기
  • 원시(Raw) 체인 스펙
  • 다음 단계로 넘어가기
  1. 인프라블록체인
  2. 배우기
  3. Substrate
  4. 빌드하기

체인 스펙

Substrate 기반 네트워크에서 체인 스펙의 역할, 노드를 시작할 때 사용할 체인 스펙을 지정하는 방법, 그리고 체인 스펙을 커스텀하고 배포하는 방법에 대해 설명합니다.

Previous결정론적 런타임 빌드NextGenesis 구성

Last updated 1 year ago

Substrate에서 체인 스펙은 Substrate 기반 블록체인 네트워크를 설명하는 정보의 모음입니다. 예를 들어, 체인 스펙은 블록체인 노드가 연결하는 네트워크, 초기 통신을 수행하는 다른 노드, 그리고 노드가 블록을 생성하기 위해 동의해야 하는 genesis(genesis state)를 식별합니다.

체인 스펙은 을 사용하여 정의됩니다. ChainSpec 구조체는 체인에 필요한 정보를 두 부분으로 나누어 제공합니다:

  • 외부 노드가 네트워크 참여자와 통신하고 텔레메트리 엔드포인트로 데이터를 전송하는 데 사용되는 정보를 포함하는 클라이언트 사양입니다. 이러한 체인 스펙 설정 중 많은 부분은 노드를 시작할 때 command-line 옵션으로 재정의하거나 블록체인이 시작된 후에 변경할 수 있습니다.

  • 네트워크의 모든 노드가 동의해야 하는 **genesis(genesis state)**입니다. genesis는 블록체인이 처음 시작될 때 설정되어야 하며, 블록체인을 완전히 새로 시작하지 않고는 변경할 수 없습니다.

외부 노드 설정 커스텀하기

외부 노드에서 체인 스펙은 다음과 같은 정보를 제어합니다:

  • 노드가 통신하는 부트 노드.

  • 노드가 텔레메트리(telemetry) 데이터를 전송하는 서버 엔드포인트.

  • 노드가 연결하는 네트워크의 사람과 기계가 읽을 수 있는 이름.

Substrate 프레임워크는 확장 가능하므로, 체인 스펙을 커스텀하여 추가 정보를 포함시킬 수도 있습니다. 예를 들어, 외부 노드를 구성하여 특정 블록에 특정 높이에서 연결하도록 할 수 있어, genesis에서 새로운 노드를 동기화할 때 장거리 공격을 방지할 수 있습니다.

참고로, genesis 이후에도 외부 노드 설정을 커스텀할 수 있습니다. 하지만 노드는 동일한 protocolId를 사용하는 피어만 추가합니다.

genesis 구성 커스텀하기

네트워크의 모든 노드는 후속 블록에 동의하기 전에 genesis 상태에 동의해야 합니다. 체인 스펙의 genesis 부분에 구성된 정보는 genesis 블록을 생성하는 데 사용됩니다. 이 정보는 command-line 옵션으로 재정의할 수 없으며, 블록체인을 시작할 때 설정되어야 합니다. 하지만 체인 스펙의 genesis 부분에 일부 정보를 구성할 수 있습니다. 예를 들어, 초기 토큰 보유자 잔액, 초기 거버넌스 위원회(Council)에 속하는 계정, sudo 키를 제어하는 관리 계정 등의 정보를 체인 스펙의 genesis 부분에 정의할 수 있습니다.

Substrate 노드는 체인의 런타임 로직을 위한 컴파일된 WebAssembly도 포함하므로, 체인 스펙에 초기 런타임도 제공되어야 합니다.

체인 스펙 정보 저장하기

체인 스펙의 정보는 Rust 코드나 JSON 파일로 저장할 수 있습니다. Substrate 노드는 일반적으로 하나 이상의 하드코딩된 체인 스펙을 포함합니다. 노드 바이너리에 직접 Rust 코드로 이 정보를 포함시키면, 노드 운영자가 추가 정보를 제공하지 않아도 노드가 적어도 하나의 체인에 연결할 수 있습니다. 메인 네트워크를 정의하기 위해 블록체인을 구축하는 경우, 이 메인 네트워크 사양은 일반적으로 외부 노드에 하드코딩됩니다.

또는 build-spec 하위 명령을 사용하여 체인 스펙을 JSON 파일로 직렬화(serialize) 할 수 있습니다. 테스트 네트워크나 개인 체인을 시작할 때, 노드 바이너리와 함께 JSON으로 인코딩된 체인 스펙을 배포하는 것이 일반적입니다.

노드 시작에 체인 스펙 제공하기

노드를 시작할 때마다 노드가 사용할 체인 스펙을 제공해야 합니다. 가장 간단한 경우, 노드는 노드 바이너리에 하드코딩된 기본 체인 스펙을 사용합니다. 노드를 시작할 때 --chain command-line 옵션을 사용하여 대체 하드코딩된 체인 스펙을 선택할 수 있습니다. 예를 들어, --chain local을 command-line 옵션으로 지정하여 노드가 "local" 과 관련된 체인 스펙을 사용하도록 지시할 수 있습니다.

하드코딩된 체인 스펙으로 노드를 시작하고 싶지 않은 경우, JSON 파일로 제공할 수 있습니다. 예를 들어, --chain=someCustomSpec.json을 command-line 옵션으로 지정하여 노드가 someCustomSpec.json 파일의 체인 스펙을 사용하도록 지시할 수 있습니다. JSON 파일을 지정하면, 노드는 제공된 JSON 체인 스펙을 역직렬화(deserialize) 하고 사용합니다.

런타임을 위한 스토리지 항목 선언하기

커스텀 체인 스펙 생성하기

개발, 테스트 또는 데모 목적으로 일회성 네트워크를 생성하려는 경우, 완전히 커스텀된 체인 스펙이 필요할 수 있습니다. 완전히 커스텀된 체인 스펙을 생성하려면, 기본 체인 스펙을 JSON 형식으로 내보내고, 그 후 JSON 파일의 필드를 편집하면 됩니다. 예를 들어, 다음과 같이 build-spec 하위 명령을 사용하여 체인 스펙을 JSON 파일로 내보낼 수 있습니다:

substrate build-spec > myCustomSpec.json

체인 스펙을 내보낸 후에는 텍스트 편집기에서 필드를 수정할 수 있습니다. 예를 들어, 네트워크 이름, 부트노드, 토큰 잔액과 같은 genesis 스토리지 항목을 변경하고 싶을 수 있습니다. JSON 파일을 편집한 후에는 수정된 JSON을 사용하여 노드를 시작할 수 있습니다. 예를 들어:

substrate --chain=myCustomSpec.json

원시(Raw) 체인 스펙

Substrate 노드는 런타임 업그레이드를 지원합니다. 런타임 업그레이드를 통해 블록체인의 런타임은 체인이 시작될 때와 다를 수 있습니다. 체인 스펙은 노드의 런타임이 이해할 수 있는 형식으로 구조화된 정보를 포함합니다. 예를 들어, Substrate 노드 템플릿의 기본 체인 스펙에서 다음과 같은 일부분을 살펴보십시오:

"sudo": {
  "key": "5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY"
}

업그레이드된 런타임을 가진 노드가 genesis부터 체인을 동기화할 수 있도록 하기 위해, 사람이 읽을 수 있는 체인 스펙은 원시(raw) 형식으로 인코딩됩니다. 원시(Raw) 형식을 사용하면 런타임 업그레이드 후에도 모든 노드가 체인을 동기화하는 데 사용할 수 있는 체인 스펙을 배포할 수 있습니다.

Substrate 기반 노드는 --raw command-line 옵션을 지원하여 원시 체인 스펙을 생성할 수 있습니다. 예를 들어, 다음 명령을 실행하여 사람이 읽을 수 있는 myCustomSpec.json 파일에 대한 원시 체인 스펙을 생성할 수 있습니다:

substrate build-spec --chain=myCustomSpec.json --raw > customSpecRaw.json

원시(Raw) 형식으로 변환된 후, sudo key 스니펫은 다음과 같이 보입니다:

"0x50a63a871aced22e88ee6466fe5aa5d9": "0xd43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d",

다음 단계로 넘어가기

대부분의 경우, Substrate 런타임은 genesis에서 구성해야 할 일부 스토리지 항목을 필요로 합니다. 예를 들어, FRAME으로 런타임을 개발하는 경우, 런타임에서 Config 트레이트로 선언된 모든 스토리지 항목은 genesis에서 구성되어야 합니다. 이러한 스토리지 값은 체인 스펙의 genesis 부분에 구성됩니다. 팔렛에서 스토리지 항목에 초기 값을 설정하는 방법에 대한 정보는 을 참조하십시오.

JSON 파일에서 이 키와 관련된 값은 사람이 읽을 수 있는 텍스트입니다. 하지만 이 정보는 Substrate가 사용하는 기본 저장소 구조에 이 형식으로 저장할 수 없습니다. 노드의 genesis 스토리지를 초기화하기 위해 체인 스펙을 사용하려면, 사람이 읽을 수 있는 키를 실제 저장소 키로 변환하여 값이 에 저장될 수 있도록 해야 합니다. 이 변환은 간단하지만, 체인 스펙이 노드 런타임이 읽을 수 있는 형식으로 인코딩되어 있어야 한다는 점에 유의해야 합니다.

ChainSpec 구조체
Genesis configuration
스토리지
신뢰할 수 있는 노드 추가
가이드: genesis 상태 구성
가이드: 체인 스펙 커스텀
노드 템플릿 체인 스펙
ChainSpec 구조체
ProtocolId 구조체