# Genesis JSON

이 페이지는 `genesis.json`의 세부 사항을 설명합니다.

## Genesis JSON 파일 구조 <a href="#genesis-json-file-structure" id="genesis-json-file-structure"></a>

`genesis.json` 파일 구조는 다음 표에 설명되어 있습니다.

| Field Name | Description                                                                                   |
| ---------- | --------------------------------------------------------------------------------------------- |
| config     | 블록 체인 환경설정. [Config](#config) 장을 확인하세요.                                                       |
| nonce      | (더 이상 사용되지 않음) 이 필드는 이더리움으로부터 파생되었지만, Klaytn에서는 사용되지 않습니다.                                    |
| timestamp  | 블록이 생성된 유닉스 시간.                                                                               |
| extraData  | 서명자 베니티(vanity) 그리고 검증자 리스트, 제안자 씰(seal) 및 커밋 씰을 포함하는 RLP-인코딩된 이스탄불 추가 데이터를 위한 서명자 데이터 통합 필드. |
| gasLimit   | 블록에 사용된 최대 가스량.                                                                               |
| difficulty | (deprecated) This field is derived from the Ethereum, but not used in Klaytn.                 |
| mixhash    | (deprecated) This field is derived from the Ethereum, but not used in Klaytn.                 |
| coinbase   | 채굴자가 보상을 받는 주소. 이 필드는 Clique 컨센서스 엔진에서만 사용됩니다.                                                |
| alloc      | 사전 정의된 계정.                                                                                    |
| number     | 블록 번호 필드.                                                                                     |
| gasUsed    | 블록에서 사용된 가스량.                                                                                 |
| parentHash | 이전 블록의 해시값.                                                                                   |

### Config <a href="#config" id="config"></a>

`config` 필드는 체인과 관련된 정보를 저장합니다.

| Field Name              | Description                                  |
| ----------------------- | -------------------------------------------- |
| chainId                 | 현재 체인을 식별하고 리플레이 공격을 방지하는 데 사용됩니다.           |
| istanbulCompatibleBlock | 이스탄불 업그레이드가 적용될 블록 번호.                       |
| istanbul, clique        | 합의 엔진의 유형.                                   |
| unitPrice               | 단가.                                          |
| deriveShaImpl           | 트랜잭션 해시 및 영수증 해시를 생성하는 방법을 정의합니다.            |
| governance              | 네트워크의 거버넌스 정보. [거버넌스](#governance) 장을 참조하세요. |

### extraData <a href="#extradata" id="extradata"></a>

`extraData` 필드는 제안자 베니티와 RLP-인코딩된 이스탄불 추가 데이터의 통합입니다:

* 제안자 베니티는 임의의 제안자 베니티 데이터를 포함하는 32바이트 데이터입니다.
* 나머지 데이터는 다음을 포함하는 RLP-인코딩된 이스탄불 추가 데이터입니다:
  * 검증자: 오름차순의 검증자 리스트.
  * 씰: 헤더의 제안자 서명. `genesis.json`의 경우, 65개의 `0x0`로 초기화된 바이트 배열입니다.
  * 커밋된 씰: 합의 증명으로서의 커밋 서명 씰의 리스트. `genesis.json`의 경우, 빈 배열입니다.

**Example**

| Field         | Type           | Value                                                                                    |
| ------------- | -------------- | ---------------------------------------------------------------------------------------- |
| Vanity        | 32바이트 16진수 문자열 | 0x0000000000000000000000000000000000000000000000000000000000000000                       |
| Validators    | \[]address     | \[0x48009b4e20ec72aadf306577cbe2eaf54b0ebb16,0x089fcc42fd83baeee4831319375413b8bae3aceb] |
| Seal          | 65개 원소의 바이트 배열 | \[0x0,...,0x0]                                                                           |
| CommittedSeal | \[]\[]byte     | \[]                                                                                      |

위의 데이터에서 `extraData`는 다음으로부터 생성됩니다

```
concat('0x',Vanity,RLPEncode({Validators,Seal,CommittedSeal}))
```

여기서 `concat`은 문자열 연결 함수, `RLPEncode`는 주어진 구조체를 RLP-인코딩된 문자열로 변환하는 함수입니다.

이 함수로부터 예제의 출력 `extraData`는 0x0000000000000000000000000000000000000000000000000000000000000000f86fea9448009b4e20ec72aadf306577cbe2eaf54b0ebb1694089fcc42fd83baeee4831319375413b8bae3acebb8410000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c0입니다.

## 합의 엔진 <a href="#consensus-engine" id="consensus-engine"></a>

클레이튼 네트워크에 사용 가능한 합의 엔진은 Clique와 Istanbul입니다. 각 엔진의 설명은 다음과 같습니다.

### Clique <a href="#clique" id="clique"></a>

`clique` 필드는 Proof-Of-Authority(POA) 기반 씰링을 위한 환경설정을 저장합니다.

| 필드     | Description                 |
| ------ | --------------------------- |
| period | 연속된 블록 사이의 최소 시간 간격(단위: 초). |
| epoch  | 투표를 재설정하고 체크포인트로 표시될 블록의 수  |

### Istanbul <a href="#istanbul" id="istanbul"></a>

`istanbul` 필드는 이스탄불 기반 씰링을 위한 환경설정을 저장합니다.

| Fields | Description                                 |
| ------ | ------------------------------------------- |
| epoch  | 체크포인트가 되기 위해 투표를 재설정할 블록 수.                 |
| policy | 블록 제안자 선출 정책. \[0: 라운드 로빈, 1: 고정, 2: 가중 랜덤] |
| sub    | 위원회 규모.                                     |

## Governance <a href="#governance" id="governance"></a>

`governance` 필드는 네트워크를 위한 거버넌스 정보를 저장합니다.

| Fields         | Description                                                             |
| -------------- | ----------------------------------------------------------------------- |
| governanceMode | 세 가지 거버넌스 모드 중 하나입니다. `none`, `single`, `ballot` 등 세 가지 모드 중 하나를 선택합니다. |
| governingNode  | Designated governing node's address. 거버넌스 모드가 `single` 인 경우에만 작동합니다.    |
| reward         | 보상 환경설정을 저장합니다. [Reward](#reward) 장을 확인하세요.                             |

### Reward <a href="#reward" id="reward"></a>

`reward` 필드는 네트워크의 토큰 이코노미에 대한 정보를 저장합니다.

| Fields                 | Description                                                           |
| ---------------------- | --------------------------------------------------------------------- |
| mintingAmount          | 블록이 생성될 때 발행되는 peb의 양. Double quotation marks are needed for a value. |
| ratio                  | `/`으로 구분되는 `CN/KIR/PoC`의 분포율 모든 값의 합은 100이어야 합니다.                     |
| useGiniCoeff           | 지니(GINI) 계수 사용 여부                                                     |
| deferredTxFee          | 블록에 대한 TX 수수료를 분배하는 방법.                                               |
| stakingUpdateInterval  | 스테이킹 정보를 업데이트하기 위한 블록 높이의 시간 간격.                                      |
| proposerUpdateInterval | 제안자 정보를 업데이트하기 위한 블록 높이의 시간 간격.                                       |
| minimumStake           | 코어 셀 운영자에 참여하기 위한 최소량의 peb.                                           |

## Example <a href="#example" id="example"></a>

```
{
    "config": {
        "chainId": 2019,
        "istanbulCompatibleBlock": 0,
        "istanbul": {
            "epoch": 604800,
            "policy": 2,
            "sub": 13
        },
        "unitPrice": 25000000000,
        "deriveShaImpl": 2,
        "governance": {
            "governingNode": "0x46b0bd6380005952759f605d02a6365552c776f3",
            "governanceMode": "single",
            "reward": {
                "mintingAmount": 6400000000000000000,
                "ratio": "50/40/10",
                "useGiniCoeff": true,
                "deferredTxFee": true,
                "stakingUpdateInterval": 86400,
                "proposerUpdateInterval": 3600,
                "minimumStake": 5000000
            }
        }
    },
    "nonce": "0x0",
    "timestamp": "0x5c9af60e",
    "extraData": "0x0000000000000000000000000000000000000000000000000000000000000000f89af85494aeae0ab623d4118ac62a2decc386949b5ce67ce29446b0bd6380005952759f605d02a6365552c776f394699b607851c878e29499672f42a769b71f74be8e94e67598eb5831164574c876994d53f63eab4f36d7b8410000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c0",
    "gasLimit": "0xe8d4a50fff",
    "difficulty": "0x1",
    "mixHash": "0x63746963616c2062797a616e74696e65206661756c7420746f6c6572616e6365",
    "coinbase": "0x0000000000000000000000000000000000000000",
    "alloc": {
        "0000000000000000000000000000000000000400": {
            "code": "0x6080604052600436106101505763ffffffff60e00a165627a7a7230582093756fe617053766b158f7c64998c746eb38f0d5431cc50231cc9fb2cd1fd9950029",
            "balance": "0x0"
        },
        "46b0bd6380005952759f605d02a6365552c776f3": {
            "balance": "0x446c3b15f9926687d2c40534fdb564000000000000"
        },
        "699b607851c878e29499672f42a769b71f74be8e": {
            "balance": "0x446c3b15f9926687d2c40534fdb564000000000000"
        },
        "aeae0ab623d4118ac62a2decc386949b5ce67ce2": {
            "balance": "0x446c3b15f9926687d2c40534fdb564000000000000"
        },
        "e67598eb5831164574c876994d53f63eab4f36d7": {
            "balance": "0x446c3b15f9926687d2c40534fdb564000000000000"
        }
    },
    "number": "0x0",
    "gasUsed": "0x0",
    "parentHash": "0x0000000000000000000000000000000000000000000000000000000000000000"
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://archive-ko.docs.klaytn.foundation/content/installation-guide/deployment/service-chain/references/genesis.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.