node: lire Everything required to run your own Base node

Un build Docker pour le nœud Base

Le dépôt est un build Docker pour exécuter un nœud Base. Le README décrit Base comme un L2 Ethereum sécurisé, peu coûteux et convivial pour les développeurs, construit sur l'OP Stack d'Optimism. Le build se compose de deux composants clients : base-reth-node pour l'exécution et base-consensus pour le consensus. Aucun autre client n'est listé comme pris en charge dans le README. Le dépôt ne contient pas d'instructions pour compiler depuis les sources ; il suppose que Docker et Docker Compose sont disponibles.

Dans le dépôt base/node, ce point 1 doit être lu avec les éléments réellement nommés par le README. La description du projet indique « Everything required to run your own Base node. This repository contains a Docker build for running a Base node with base-reth-node and base-consensus. ». Elle fixe un périmètre, mais ne prouve ni une compatibilité universelle ni une disponibilité durable. La lecture utile consiste à relier cette section à un fichier, une commande, une classe ou une liste précise de base/node. Les détails absents des sources restent non établis.

Pour vérifier ce passage 1, partez de base/node et observez le résultat propre à ce dépôt: la structure et le point d’entrée documenté. Une équipe peut ainsi distinguer ce que base/node fournit de ce qu’elle devra ajouter elle-même. Le README est suffisamment précis pour orienter un premier essai, toutefois il ne remplace pas l’examen des versions, des permissions et des entrées propres au contexte visé.

Le choix dépend donc du rôle attendu pour base/node. Il peut convenir à une expérimentation ciblée lorsque l’équipe maîtrise Shell et accepte les conditions écrites. Il convient moins à un usage qui exige une garantie que le dépôt ne formule pas. Conservez l’observation liée à base/node et au repère 1, plutôt qu’une promesse générale.

Prérequis et commandes de démarrage rapide

Le démarrage rapide du README nécessite un RPC de nœud complet Ethereum L1 et un endpoint beacon. Vous choisissez entre mainnet et testnet en sélectionnant .env.mainnet ou .env.sepolia. Vous définissez BASE_NODE_L1_ETH_RPC et BASE_NODE_L1_BEACON dans le fichier .env choisi. La commande pour démarrer le mainnet est `docker compose up --build` ; pour le testnet, vous préfixez avec NETWORK_ENV=.env.sepolia. Le README n'explique pas ce que contiennent les fichiers .env au-delà des paramètres requis, ni ne liste d'autres méthodes de démarrage.

Dans le dépôt base/node, ce point 2 doit être lu avec les éléments réellement nommés par le README. La description du projet indique « Everything required to run your own Base node. This repository contains a Docker build for running a Base node with base-reth-node and base-consensus. ». Elle fixe un périmètre, mais ne prouve ni une compatibilité universelle ni une disponibilité durable. La lecture utile consiste à relier cette section à un fichier, une commande, une classe ou une liste précise de base/node. Les détails absents des sources restent non établis.

Pour vérifier ce passage 2, partez de base/node et observez le résultat propre à ce dépôt: la commande ou la configuration citée. Une équipe peut ainsi distinguer ce que base/node fournit de ce qu’elle devra ajouter elle-même. Le README est suffisamment précis pour orienter un premier essai, toutefois il ne remplace pas l’examen des versions, des permissions et des entrées propres au contexte visé.

Le choix dépend donc du rôle attendu pour base/node. Il peut convenir à une expérimentation ciblée lorsque l’équipe maîtrise Shell et accepte les conditions écrites. Il convient moins à un usage qui exige une garantie que le dépôt ne formule pas. Conservez l’observation liée à base/node et au repère 2, plutôt qu’une promesse générale.

Exigences matérielles et spécifications de production

Les exigences minimales sont un CPU multicœur moderne, 32 Go de RAM (64 Go recommandés), un SSD NVMe, et un stockage égal à deux fois la taille actuelle de la chaîne plus la taille du snapshot plus un tampon de 20 %. Le README renvoie à base.org/stats et à un site séparé pour la taille du snapshot afin d'obtenir les chiffres actuels. La spécification de référence pour la production est une instance AWS i7i.12xlarge avec RAID 0 sur les disques NVMe locaux et un système de fichiers ext4, exécutant le nœud d'archive Reth. Le README ne spécifie pas de matériel pour un nœud de consensus en production.

Dans le dépôt base/node, ce point 3 doit être lu avec les éléments réellement nommés par le README. La description du projet indique « Everything required to run your own Base node. This repository contains a Docker build for running a Base node with base-reth-node and base-consensus. ». Elle fixe un périmètre, mais ne prouve ni une compatibilité universelle ni une disponibilité durable. La lecture utile consiste à relier cette section à un fichier, une commande, une classe ou une liste précise de base/node. Les détails absents des sources restent non établis.

Pour vérifier ce passage 3, partez de base/node et observez le résultat propre à ce dépôt: les données, composants ou dépendances explicitement listés. Une équipe peut ainsi distinguer ce que base/node fournit de ce qu’elle devra ajouter elle-même. Le README est suffisamment précis pour orienter un premier essai, toutefois il ne remplace pas l’examen des versions, des permissions et des entrées propres au contexte visé.

Le choix dépend donc du rôle attendu pour base/node. Il peut convenir à une expérimentation ciblée lorsque l’équipe maîtrise Shell et accepte les conditions écrites. Il convient moins à un usage qui exige une garantie que le dépôt ne formule pas. Conservez l’observation liée à base/node et au repère 3, plutôt qu’une promesse générale.

Configuration requise et paramètres réseau

Quatre paramètres sont listés comme requis : BASE_NODE_L1_ETH_RPC, BASE_NODE_L1_BEACON, BASE_NODE_NETWORK et RETH_CHAIN. Pour le mainnet, RETH_CHAIN=base et BASE_NODE_NETWORK=base ; pour Sepolia, les deux sont base-sepolia. Le README liste également les URL de séquenceur pour chaque réseau, mais n'indique pas comment ces URL sont utilisées. Les options de configuration complètes sont dites dans .env.mainnet et .env.sepolia, mais le README ne reproduit pas ces fichiers.

Dans le dépôt base/node, ce point 4 doit être lu avec les éléments réellement nommés par le README. La description du projet indique « Everything required to run your own Base node. This repository contains a Docker build for running a Base node with base-reth-node and base-consensus. ». Elle fixe un périmètre, mais ne prouve ni une compatibilité universelle ni une disponibilité durable. La lecture utile consiste à relier cette section à un fichier, une commande, une classe ou une liste précise de base/node. Les détails absents des sources restent non établis.

Pour vérifier ce passage 4, partez de base/node et observez le résultat propre à ce dépôt: le comportement annoncé dans le README. Une équipe peut ainsi distinguer ce que base/node fournit de ce qu’elle devra ajouter elle-même. Le README est suffisamment précis pour orienter un premier essai, toutefois il ne remplace pas l’examen des versions, des permissions et des entrées propres au contexte visé.

Le choix dépend donc du rôle attendu pour base/node. Il peut convenir à une expérimentation ciblée lorsque l’équipe maîtrise Shell et accepte les conditions écrites. Il convient moins à un usage qui exige une garantie que le dépôt ne formule pas. Conservez l’observation liée à base/node et au repère 4, plutôt qu’une promesse générale.

Fonctionnalités optionnelles : Flashblocks, mode suivi et élagage

Trois fonctionnalités optionnelles sont documentées. Le mode Flashblocks est activé en définissant RETH_FB_WEBSOCKET_URL ; une fois défini, le client d'exécution fonctionne en mode Flashblocks, sinon en mode vanilla. En mode Flashblocks, vous pouvez interroger un bloc en attente via eth_getBlockByNumber avec un exemple curl montré dans le README. Le mode suivi est activé en définissant BASE_NODE_SOURCE_L2_RPC ; le README n'explique pas comment se comporte le mode suivi. L'élagage est activé en définissant RETH_PRUNING_ARGS ; aucune syntaxe n'est donnée.

Dans le dépôt base/node, ce point 5 doit être lu avec les éléments réellement nommés par le README. La description du projet indique « Everything required to run your own Base node. This repository contains a Docker build for running a Base node with base-reth-node and base-consensus. ». Elle fixe un périmètre, mais ne prouve ni une compatibilité universelle ni une disponibilité durable. La lecture utile consiste à relier cette section à un fichier, une commande, une classe ou une liste précise de base/node. Les détails absents des sources restent non établis.

Pour vérifier ce passage 5, partez de base/node et observez le résultat propre à ce dépôt: les limites et prérequis indiqués. Une équipe peut ainsi distinguer ce que base/node fournit de ce qu’elle devra ajouter elle-même. Le README est suffisamment précis pour orienter un premier essai, toutefois il ne remplace pas l’examen des versions, des permissions et des entrées propres au contexte visé.

Le choix dépend donc du rôle attendu pour base/node. Il peut convenir à une expérimentation ciblée lorsque l’équipe maîtrise Shell et accepte les conditions écrites. Il convient moins à un usage qui exige une garantie que le dépôt ne formule pas. Conservez l’observation liée à base/node et au repère 5, plutôt qu’une promesse générale.

Snapshots et réseaux pris en charge

Le README indique que des snapshots sont disponibles pour accélérer la synchronisation et dirige les utilisateurs vers docs.base.org pour les liens et les instructions de restauration. Il ne fournit pas d'URL directe de snapshot ni de somme de contrôle. Le tableau des réseaux pris en charge liste le mainnet et le testnet comme pris en charge, avec des coches. Aucun autre réseau n'est mentionné. Le README ne décrit ni la fréquence des snapshots ni leur taille.

Dans le dépôt base/node, ce point 6 doit être lu avec les éléments réellement nommés par le README. La description du projet indique « Everything required to run your own Base node. This repository contains a Docker build for running a Base node with base-reth-node and base-consensus. ». Elle fixe un périmètre, mais ne prouve ni une compatibilité universelle ni une disponibilité durable. La lecture utile consiste à relier cette section à un fichier, une commande, une classe ou une liste précise de base/node. Les détails absents des sources restent non établis.

Pour vérifier ce passage 6, partez de base/node et observez le résultat propre à ce dépôt: la version, le statut ou l’historique publié. Une équipe peut ainsi distinguer ce que base/node fournit de ce qu’elle devra ajouter elle-même. Le README est suffisamment précis pour orienter un premier essai, toutefois il ne remplace pas l’examen des versions, des permissions et des entrées propres au contexte visé.

Le choix dépend donc du rôle attendu pour base/node. Il peut convenir à une expérimentation ciblée lorsque l’équipe maîtrise Shell et accepte les conditions écrites. Il convient moins à un usage qui exige une garantie que le dépôt ne formule pas. Conservez l’observation liée à base/node et au repère 6, plutôt qu’une promesse générale.

Support, avertissement et licence

Le support est offert via le canal node-operators du Discord Base, ou en ouvrant un issue GitHub. Le README inclut un avertissement selon lequel le logiciel de nœud est fourni tel quel, sans garantie, et ne fait aucune garantie concernant la protection des actifs ou la sécurité. Le dépôt est sous licence MIT, avec les droits d'auteur attribués aux contributeurs de base.org. La licence accorde la permission d'utiliser, copier, modifier, fusionner, publier, distribuer, sous-licencier et vendre des copies, et indique que le logiciel est fourni sans garantie ni responsabilité. Elle ne traite pas du support, de la maintenance ou des garanties de sécurité.

Dans le dépôt base/node, ce point 7 doit être lu avec les éléments réellement nommés par le README. La description du projet indique « Everything required to run your own Base node. This repository contains a Docker build for running a Base node with base-reth-node and base-consensus. ». Elle fixe un périmètre, mais ne prouve ni une compatibilité universelle ni une disponibilité durable. La lecture utile consiste à relier cette section à un fichier, une commande, une classe ou une liste précise de base/node. Les détails absents des sources restent non établis.

Pour vérifier ce passage 7, partez de base/node et observez le résultat propre à ce dépôt: les fichiers de contribution et la licence. Une équipe peut ainsi distinguer ce que base/node fournit de ce qu’elle devra ajouter elle-même. Le README est suffisamment précis pour orienter un premier essai, toutefois il ne remplace pas l’examen des versions, des permissions et des entrées propres au contexte visé.

Le choix dépend donc du rôle attendu pour base/node. Il peut convenir à une expérimentation ciblée lorsque l’équipe maîtrise Shell et accepte les conditions écrites. Il convient moins à un usage qui exige une garantie que le dépôt ne formule pas. Conservez l’observation liée à base/node et au repère 7, plutôt qu’une promesse générale.

Conclusion éditoriale

base/node s’adresse aux personnes dont le besoin correspond exactement à ce que le README décrit et qui peuvent contrôler Shell dans leur environnement. Il convient moins à qui attend un support ou une garantie non écrite. Avant l’adoption, exécutez le scénario propre à base/node, inspectez les fichiers cités et comparez la sortie attendue avec celle obtenue.

Sources officielles

1. Official documentation
2. Official README
3. Project repository
4. Release notes