Go Ethereumをノード運用と開発用CLIの境界から読む

gethが担う実行レイヤー

READMEはGo EthereumをEthereumプロトコルのGolang execution layer implementationと説明しています。中心となるgethはmainnet、test net、private netの入口になるCLIです。既定ではfull nodeとして動き、archive nodeとして過去状態を保持する形や、データをライブ取得するlight nodeも記載されています。ここで読めるのは実装と起動形態の説明であり、特定の用途での性能や可用性を保証する記述ではありません。

gethはHTTP、WebSocket、IPCの上にJSON-RPCエンドポイントを公開し、別プロセスからネットワークへのゲートウェイとして使えます。アカウント作成、送金、コントラクトのデプロイと操作を行う利用者を想定した説明ですが、秘密鍵の保管方式や外部公開時の構成はREADMEだけでは決まりません。ノードの役割とRPCの接続元を分けて設計する必要があります。

snap syncとarchive nodeの差

mainnetの一般的な入口としてREADMEが示すのはgeth consoleです。この起動では既定のsnap syncが選ばれ、ネットワークの全履歴を最初から処理する代わりに、より少ない処理で現在状態へ近づく説明になっています。--syncmodeで方式を変更できるため、現在状態へのアクセスが目的なのか、過去ブロックの状態を長期間参照したいのかを先に分けるべきです。

archive nodeは履歴状態を保持する一方、READMEはその保存量や同期時間を具体的に示していません。したがってfull nodeの例をarchive nodeの手順として読み替えることはできません。ディスク使用量、再同期時の停止時間、バックアップの方法を、実際に選ぶ同期方式とデータディレクトリに結びつけて検証する必要があります。

GoとCコンパイラでビルドする

ソースからgethを作る要件として、READMEはGo version 1.23 or laterとC compilerを挙げています。依存関係を用意した後はmake gethでgethをビルドでき、全ユーティリティを対象にする場合はmake allを使います。ビルドの入口は明快ですが、OS別の準備、リンカー設定、実行時の配置はInstallation Instructionsへ委ねられています。

cmdディレクトリには複数の実行ファイルがあります。devp2pはブロックチェーン全体を動かさずネットワーク層のノードを扱い、abigenはABIやSolidityソースから型安全なGoパッケージを生成します。evmは設定可能な環境でバイトコード片を実行する開発用ユーティリティ、rlpdumpはRLPダンプを階層的に表示する道具です。ノード本体と開発・解析用の入口が同じリポジトリにある点が構成上の特徴です。

JavaScript consoleとRPCの接点

geth consoleを付けると組み込みの対話型JavaScript consoleからweb3メソッドとgeth固有の管理APIを呼べます。READMEは、同梱web3のバージョンが古く公式ドキュメントと一致しない場合があると明記しています。この差はサンプルをそのまま移植する際の確認点になります。既に起動したプロセスにはgeth attachで接続できます。

HTTP、WebSocket、IPCはいずれも接続経路が違います。READMEは全CLIフラグの説明を範囲外とし、CLI pageを参照するよう案内しています。そのため、RPCをLANへ開ける設定や認証・TLSの有無を本文から推定してはいけません。まずIPCまたは閉じたテストネットで管理APIの応答を確認し、外部接続が必要な場合だけ公式設定文書を照合するのが現実的です。

Mainnetを支える資源条件

最低条件として4コア以上のCPU、8GB RAM、mainnet同期用の空き1TB、8 MBit/secのダウンロード回線がREADMEに挙げられています。推奨条件は8コア以上、16GB以上のRAM、高性能SSDで少なくとも1TB、25 MBit/sec以上の回線です。これはプロジェクトが掲げる目安であり、archive nodeや運用期間を含めた必要量ではありません。

最初の検証では、同期開始から現在状態へ到達するまでのディスク増加、CPU負荷、回線使用量をgethの選択したsyncmodeとともに記録すると、最低条件との差を判断できます。READMEは待受ポート、監視方式、障害復旧の数値を定めていません。運用設計で埋める項目を、実測結果と混同しないことが肝要です。

LGPL-3.0と更新判断

メタデータのライセンスはLGPL-3.0です。再配布や改変を計画する場合はリポジトリのLICENSEと実際に組み込む範囲を確認してください。ライセンス表示があることは、RPC公開や秘密鍵管理の安全性を示すものではありません。READMEにも互換性表、性能基準、長期サポート契約の記載は見当たりません。

既定ブランチはmasterで、素材取得時のreleaseにはv1.17.5が含まれています。更新時はgeth --help、選択したsyncmode、JSON-RPCの呼び出し、abigenで生成したコードを固定したテストネットで再確認します。採用判断はstar数ではなく、必要なノード形態と自組織の保管・監視要件が一致するかで決めるべきです。

Sepoliaで資金を使わずに通す

mainnetへ移る前にREADMEが示すtest netの用途を使い、アカウント作成、送金、コントラクト操作を試します。geth consoleとgeth attachの接続方法を分け、JavaScript consoleで使えるweb3の版も記録します。HTTPとIPCを同時に有効にする場合は接続元を限定し、管理APIが意図しないネットワークから見えないことを確認します。同期方式を変えた時はデータディレクトリを混ぜず、ログ、ディスク使用量、再起動後の現在状態を比較します。実施記録には対象版と入力条件を残し、成功した結果だけでなく失敗した場合の出力も保存します。設定を変更した前後で同じ確認を繰り返せるようにし、READMEに書かれた機能と自分の環境で確認できた事実を分けます。採用判断では、導入できたかだけでなく、更新、障害、切り戻し、権限、ライセンスを同じ担当者が追跡できるかを確かめます。

編集部の結論

gethはEthereumのmainnet、testnet、private netに接続する実行レイヤーを自分で管理したい人に向きます。コントラクト開発だけならabigenやevmの局所的な利用から始める方が扱いやすいでしょう。導入前にGo 1.23以上とCコンパイラ、最低1TBの空き容量を用意し、まずsnap syncのデータ配置とRPC公開範囲を隔離環境で確認してください。

公式情報源

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