Connexion au nœud JOC
Ce document décrit les étapes pour configurer un nœud Geth dans votre environnement utilisateur et se connecter au Mainnet et Testnet de Japan Open Chain. Si vous souhaitez utiliser les RPC Endpoints pour connecter vos dApps, veuillez vous référer à ceci.
- Mainnet
- Testnet
Connexion au nœud JOC Mainnet
Le flux de connexion est le suivant :
- 1. Installation de Geth
- 2. Configuration initiale
- 3. Initialisation de Geth
- 4. Synchronisation
- 5. Vérification
1. Installation de Geth
Installez Geth sur l'ordinateur source de la connexion. (Testé jusqu'à la version Geth ver1.13.5)
https://geth.ethereum.org/docs/getting-started/installing-geth
2. Configuration initiale
Créez un répertoire de données dans un répertoire de votre choix. Nous l'appellerons "data" ici.
$ mkdir data
Créez un fichier "genesis.json" dans le répertoire data pour y inscrire les informations de bloc.
$ sudo vi data/genesis.json
Le contenu de genesis.json est fourni séparément.
3. Initialisation de Geth
Initialisez Geth. Exécutez la commande suivante en spécifiant le genesis.json que vous avez créé.
$ geth init --datadir data data/genesis.json
4. Synchronisation
Synchronisez avec le nœud de destination. Pour se connecter au node-1, exécutez la commande suivante :
$ 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"
Les paramètres du Mainnet sont les suivants :
| Nœud | ID Réseau | enode |
|---|---|---|
| bootnode-1 | 81 | enode://c387e2b4e5231022ef30144c41fbd883139e9b5f1f4649c3d51c1611adbfaeadfd050c1bd9ac02eec6fa4c234b49a77fb5fb54f739c06d431eabfd981edc51f2@13.56.117.179:30303 |
| bootnode-2 | 81 | enode://db803c26db9dac21e58452646a785b94a466eebffd6038621f78de92ccc6141fcb297650c290487375ab32a6dbc693d5dab49dba9785450002c68944ab0435a2@54.241.98.152:30303 |
5. Vérification
Vous pouvez vérifier l'état de synchronisation comme indiqué ci-dessous. Si le message "Looking for peers" continue d'apparaître, cela signifie que la connexion n'est pas établie correctement. Veuillez vérifier la commande de synchronisation et votre environnement réseau.
Connexion au nœud JOC Testnet
Le flux de connexion est le suivant :
- 1. Installation des paquets requis
- 2. Création des répertoires de données
- 3. Téléchargement des fichiers de configuration
- 4. Installation des clients
- 5. Génération du secret JWT
- 6. Initialisation de Geth
- 7. Lancement de Geth
- 8. Lancement de Lighthouse
- 9. Vérification
1. Installation des paquets requis
# Ubuntu / Debian
sudo apt-get update
sudo apt-get install -y curl openssl
# Amazon Linux 2023 / distributions basées sur RHEL
sudo dnf install -y curl openssl
2. Création des répertoires de données
sudo mkdir -p /data/ethereum
sudo mkdir -p /data/ethereum/consensus/config
3. Téléchargement des fichiers de configuration
Téléchargez les fichiers ci-dessous et copiez-les aux emplacements appropriés :
| Fichier | Lien |
|---|---|
genesis.json | Voir |
config.yaml | Voir |
genesis.ssz | Télécharger |
deposit_contract.txt | Voir |
deposit_contract_block.txt | Voir |
# genesis.json -> /data/ethereum/genesis.json
# config.yaml -> /data/ethereum/consensus/config/config.yaml
# genesis.ssz -> /data/ethereum/consensus/config/genesis.ssz
# deposit_contract_block.txt -> /data/ethereum/consensus/config/deposit_contract_block.txt
4. Installation des clients
Geth (client d'exécution) :
https://geth.ethereum.org/docs/getting-started/installing-geth
Lighthouse (client de consensus) :
https://lighthouse-book.sigmaprime.io/installation.html
5. Génération du secret JWT
Le secret JWT authentifie la communication interne entre Geth et Lighthouse. Générez-le une seule fois :
openssl rand -hex 32 | tr -d "\n" > /data/ethereum/jwtsecret
chmod 644 /data/ethereum/jwtsecret
6. Initialisation de Geth
geth init \
--datadir=/data/ethereum \
/data/ethereum/genesis.json
À exécuter une seule fois.
7. Lancement de Geth
La liste actuelle des BootNodes est récupérée depuis enodes.yaml.
geth --datadir=/data/ethereum \
--networkid=361257328 \
--http \
--authrpc.vhosts="*" \
--authrpc.addr=127.0.0.1 \
--authrpc.jwtsecret=/data/ethereum/jwtsecret \
--bootnodes="$BOOTNODES"
8. Lancement de Lighthouse
La liste actuelle des Boot ENR est récupérée depuis bootstrap_nodes.yaml.
lighthouse beacon_node \
--datadir=/data/ethereum/consensus \
--http \
--execution-endpoint=http://127.0.0.1:8551 \
--execution-jwt=/data/ethereum/jwtsecret \
--testnet-dir=/data/ethereum/consensus/config \
--boot-nodes="$BOOT_ENRS"
9. Vérification
Vérifiez l'état de synchronisation de Geth :
curl -s -X POST http://localhost:8545 \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":1}'
# false → entièrement synchronisé
# object → synchronisation en cours, affiche currentBlock / highestBlock
Vérifiez l'état de synchronisation de Lighthouse :
curl -s http://localhost:5052/eth/v1/node/peer_count
Si le message "Looking for peers" continue de s'afficher, cela signifie que la connexion n'est pas correctement établie. Veuillez vérifier les valeurs des bootnodes/ENR ainsi que les paramètres de votre pare-feu (ports 30303 TCP+UDP pour Geth, port 9000 TCP+UDP pour Lighthouse).