JOC에 노드 연결
본 문서는 사용자 환경에서 Geth 노드를 구축하여 Japan Open Chain의 Mainnet 및 Testnet에 연결하는 방법을 설명합니다. RPC Endpoints를 이용하여 dApps에 연결하고자 하는 분은 여기를 참조하십시오.
- Mainnet
- Testnet
JOC Mainnet에 노드 연결하기
연결 과정은 다음과 같습니다.
1. Geth 설치
접속할 PC에 Geth를 설치합니다. (Geth ver1.13.5까지 동작 확인됨)
https://geth.ethereum.org/docs/getting-started/installing-geth
2. 초기 설정
임의의 디렉토리에 데이터 디렉토리를 생성합니다. 여기서는 "data"로 합니다.
$ mkdir data
생성한 data 디렉토리 내에 블록 정보를 기재할 "genesis.json"을 생성합니다.
$ sudo vi data/genesis.json
genesis.json의 기재 내용은 별도 파일로 제공됩니다.
3. Geth 초기화
Geth를 초기화합니다. 생성한 genesis.json을 지정하여 다음 명령어를 실행합니다.
$ geth init --datadir data data/genesis.json
4. 동기화
연결할 노드와 동기화합니다. node-1에 연결하는 경우 다음 명령어를 실행합니다.
$ geth --datadir data --networkid=81 --bootnodes="enode://c387e2b4e5231022ef30144c41fbd883139e9b5f1f4649c3d51c1611adbfaeadfd050c1bd9ac02eec6fa4c234b49a77fb5fb54f739c06d431eabfd981edc51f2@13.56.117.179:30303" --http --http.api="clique,personal,eth,net,web3,miner,admin" --http.corsdomain="*" --http.addr="0.0.0.0" --http.port=8546 --snapshot=false --syncmode="full"
메인넷의 파라미터는 다음과 같습니다.
| Node | Network ID | enode |
|---|---|---|
| bootnode-1 | 81 | enode://c387e2b4e5231022ef30144c41fbd883139e9b5f1f4649c3d51c1611adbfaeadfd050c1bd9ac02eec6fa4c234b49a77fb5fb54f739c06d431eabfd981edc51f2@13.56.117.179:30303 |
| bootnode-2 | 81 | enode://db803c26db9dac21e58452646a785b94a466eebffd6038621f78de92ccc6141fcb297650c290487375ab32a6dbc693d5dab49dba9785450002c68944ab0435a2@54.241.98.152:30303 |
5. 확인
아래와 같이 동기화 상태를 확인할 수 있습니다. "Looking for peers" 메시지가 지속될 경우 정상적으로 연결되지 않았으므로, 동기화 명령이나 네트워크 환경을 확인하시기 바랍니다.
JOC Testnet에 노드 연결하기
연결 과정은 다음과 같습니다.
1. Geth 설치
접속할 PC에 Geth를 설치합니다. (Geth ver1.13.5까지 동작 확인됨) https://geth.ethereum.org/docs/getting-started/installing-geth
2. 초기 설정
임의의 디렉토리에 데이터 디렉토리를 생성합니다. 여기서는 "data"로 합니다.
$ mkdir data
생성한 data 디렉토리 내에 블록 정보를 기재할 "genesis.json"을 생성합니다.
$ sudo vi data/genesis.json
genesis.json의 기재 내용은 별도 파일로 제공됩니다.
3. Geth 초기화
Geth를 초기화합니다. 생성한 genesis.json을 지정하여 다음 명령어를 실행합니다.
$ geth init --datadir data data/genesis.json
4. 동기화
연결할 노드와 동기화합니다. node-1에 연결하는 경우 다음 명령어를 실행합니다.
$ geth --datadir data --networkid=361257328 --bootnodes="enode://f964f94067a851758a3f308831602ca05a374a8a5dcba8ec5f78cde5d31dc809fc0115a84a785bbd1c8024a46d16eee732f4b681cc36cf323e8fab933f92849a@54.248.244.225:30303" --http --http.api="clique,personal,eth,net,web3,miner,admin" --http.corsdomain="*" --http.addr="0.0.0.0" --http.port=8546 --snapshot=false --syncmode="full"
테스트넷의 파라미터는 다음과 같습니다.
As of December 10, 2025, the operation of the previous BootNodes (test-node-1, test-node-2) has ended. Please use the new BootNodes below.
| Node | Network ID | enode |
|---|---|---|
| test-node-1 | 361257328 | enode://f964f94067a851758a3f308831602ca05a374a8a5dcba8ec5f78cde5d31dc809fc0115a84a785bbd1c8024a46d16eee732f4b681cc36cf323e8fab933f92849a@54.248.244.225:30303 |
| test-node-2 | 361257328 | enode://c68340e7daac1eecc3cdfbfc7c68a80ebf91dbc7f63413dae39b75b2738e63965033cefe452f0b50d8f1d2c5df74eba9905e85c223dda9bc0040fb1c06f35dc5@13.158.174.185:30303 |
5. 확인
아래와 같이 동기화 상태를 확인할 수 있습니다. "Looking for peers" 메시지가 지속될 경우 정상적으로 연결되지 않았으므로, 동기화 명령이나 네트워크 환경을 확인하시기 바랍니다.