サーバーとリグで Blocknet をマイニング

このガイドでは、大型マシンやラックに並んだマイニングリグで seine を動かす方法を説明します。多コアサーバーでのスレッドの配置方法、サービスマネージャーの下でのヘッドレス実行、そしてローカルの制御 API、ライブイベントストリーム、Prometheus メトリクスを使ってすべてのリグを起動・停止・監視する方法を紹介します。

seine は大型サーバーをどのように使いますか？

Blocknet の Argon2id プルーフ・オブ・ワークは、ほとんどがメモリのトラフィックです。各スレッドはハッシュごとに専用の 2 GiB アリーナを埋めて読み返すので、ハッシュレートは、スレッドが同時にいくつのメモリコントローラとキャッシュグループを稼働させられるかで決まります。その理由は Argon2id の解説記事で詳しく説明しています。

スレッドが OS の CPU の順番にそのまま従うと、リストの先頭のコアから埋まっていきます。それらはすべて同じノードの、同じ少数のキャッシュグループにあります。2 ノードの EPYC マシンでは、OS の順番に従った 8 スレッドはすべてノード 0 に配置され、合計 16 GiB のアリーナのほぼすべてがそのノードのメモリに置かれました。seine の自動配置では各ノードに 4 スレッドずつ、アリーナも約 8 GiB ずつ配置され、両方のノードのメモリが同時に使われました。L3 グループが 8 つあるシングルノードの EPYC 8434P では、OS の順番に従った 24 スレッドが 4 つのグループに 6 スレッドずつ詰め込まれました。seine は 8 つのグループすべてを 3 スレッドずつ使いました。

配置は、プロセスに与えた制限に従います。プロセスの CPU マスクとメモリマスクを尊重するので、taskset、cgroups、コンテナの中でも動作し、許可したコアだけを使います。ネイティブの Windows でも、同じ auto 設定で SMT の兄弟スレッドより先に物理コアを埋めます。

NUMA を考慮した配置でどれくらい速くなりますか？

seine の開発者は 2026 年 10 月 24 日に、同じバイナリを 2 通りの設定で交互に実行するペア測定を行いました。比べたのは、seine の自動配置と、単純な OS の順番での固定（--cpu-affinity os）です。

すべてのペアで自動配置が上回りました。測定方法と生データの全容は、seine の大型サーバーガイドと CPU 最適化ログにあります。

この効果は、seine がマシンのコア数より少ないスレッドで動くときに現れます。スレッド数がコア数ではなく RAM で決まる場合は、常にそうなります。各スレッドに約 2 GB 必要なので、48 コアのサーバーを埋めるにはアリーナだけで約 96 GB が必要です。配置機能は、用意できるスレッドがすべての NUMA ノードとキャッシュグループに分散されるようにします。

2 行目が示すように、配置とヒュージページの効果は積み重なります。ヒュージページを確保する場合は、スレッドを置くすべてのノードで確保してください。合計が十分でも、ローカルのページが使えるとは限らないからです。ページの設定はヒュージページガイドで説明しています。Linux では、各ノードの 2 MiB プールは /sys/devices/system/node/node<N>/hugepages/hugepages-2048kB/nr_hugepages で設定します。

お使いのマシンで効果を確かめるには、同じスレッド数と同じページ設定で auto と os を比べます。--cpu-affinity off にすると、配置は完全にスケジューラに任されます。

共有サーバーでのメモリの余裕

スレッド数の自動決定では、GPU 用の確保分に加えて、RAM 全体の 5% を空けておきます。これは --cpu-memory-reserve-percent で変更できます。ほかのサービスがメモリを使い始めると、seine の自動スレッドはアリーナを解放し、メモリが空けば戻ってくるので、マイニングはマシンのほかの用途に合わせて動きます。チューニング結果はマシンごとにキャッシュされ、VM のサイズを変更したときなど、許可された CPU セットや NUMA と L3 の構成が変わるとキャッシュはリセットされます。

seine をヘッドレスで動かすには？

デスクトップでは、seine は初回の実行時にアドレスとプールを尋ねます。ターミナルが接続されていないサーバーでは、最初から両方を渡します。

./seine --address '@yourname' \
  --pool-url stratum+tcp://bntpool.com:3333 \
  --pool-worker rack1-node04 \
  --data-dir /var/lib/seine

リグ名（ここでは rack1-node04）は、このマシンがプール上で表示される名前です。seine はアドレス、プール、リグ名をデータディレクトリ（デフォルトは ./seine-data）の seine.config.json に保存するので、同じデータディレクトリを使う次回以降の起動ではほかのフラグは不要です。デフォルトの --ui auto では、ターミナルではダッシュボードを表示し、それ以外ではシンプルなログ行を出力します。--ui plain を指定すると常にシンプルな出力になります。シェルのコマンドでは @name と $name を引用符で囲んでください。

Linux では、systemd のユニットで起動時に seine を開始し、終了した場合は再起動させられます。

[Unit]
Description=seine Blocknet miner
Wants=network-online.target
After=network-online.target

[Service]
ExecStart=/opt/seine/seine --data-dir /var/lib/seine --address @yourname --pool-url stratum+tcp://bntpool.com:3333 --ui plain
DynamicUser=yes
StateDirectory=seine
Restart=always

[Install]
WantedBy=multi-user.target

seine は起動時にショートネームを解決するので、このユニットはネットワークの準備を待ちます。各リグはマイニングしながら自動でチューニングし、その選択を自分のデータディレクトリに保存して次回の起動に使います。

API で seine を制御するには？

seine には、ライブイベントストリームと Prometheus メトリクスを備えたローカルの REST API があり、ダッシュボードやフリート管理ツール向けに作られています。起動方法は 2 つあります。

# API only: seine waits for a start request
./seine --service --api-bind 127.0.0.1:9977

# Mine right away and serve the API
./seine --api-server --api-bind 127.0.0.1:9977

--service モードは API を起動し、コントローラが POST /v1/miner/start を送るまでマイナーを待機させます。このリクエストには、その実行で使うアドレス、プール、スレッド数などの設定を含められます。各マシンがいつ、どの設定でマイニングするかはコントローラが決めます。

API トークン

seine v0.2.23 以降、GET /v1/health を除くすべてのエンドポイントで Authorization: Bearer <token> が必要です。seine は起動のたびにランダムな新しいトークンをデータディレクトリの control-api.cookie に書き込み（Unix では所有者だけが読み取れます）、終了時に削除します。安定した値が必要なフリート管理ツールでは、--api-token で値を設定するか、--api-cookie でファイルの場所を変更します。また API はデフォルトで CORS ヘッダーを送らず、ループバックにバインドしている場合は Host がローカルでないリクエストを拒否します。これにより、閲覧した Web サイトが受け取りアドレスや設定を変更できないようにしています。

API はデフォルトで 127.0.0.1:9977 にバインドします。ほかのインターフェースにバインドするには --api-allow-unsafe-bind が必要なので、自分で選ばない限り API はそのマシンの中にとどまります。

export SEINE_API_TOKEN="$(cat seine-data/control-api.cookie)"

curl -s -X POST http://127.0.0.1:9977/v1/miner/start \
  -H "Authorization: Bearer $SEINE_API_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"mode":"pool","mining_address":"@yourname","pool_url":"stratum+tcp://bntpool.com:3333","pool_worker":"rack1-node04"}'

curl -N -H "Authorization: Bearer $SEINE_API_TOKEN" http://127.0.0.1:9977/v1/events/stream

ライブイベント

GET /v1/events/stream は Server-Sent Events のストリームです。状態の変化、バックエンドのフェーズ、自動チューニングの進行状況と結果、見つかったソリューション、送信結果を発生と同時に通知するので、ダッシュボードにすべてのリグをリアルタイムで表示できます。再接続後は、GET /v1/runtime/state で現在の状態をすべて取得できます。

Prometheus メトリクス

GET /metrics は Prometheus メトリクスを提供します。seine_miner_running、seine_miner_lifecycle_info、seine_miner_submitted_blocks_total、seine_miner_accepted_blocks_total、seine_miner_stale_submits_total などが含まれます。cookie は起動のたびに変わり、seine のユーザーしか読み取れないので、Prometheus には固定のトークンを渡します。--api-token を指定して seine を起動し、同じ値を Prometheus が読み取れるファイルに保存します。同じマシン上のスクレイプジョブは次のようになります。

scrape_configs:
  - job_name: seine
    authorization:
      type: Bearer
      credentials_file: /etc/prometheus/seine-token
    static_configs:
      - targets: ['127.0.0.1:9977']

すべてのエンドポイント、リクエストのスキーマ、イベントの一覧は、seine の制御 API ドキュメントにあります。

リグ用のマシンを選ぶ

配置機能、ヘッドレス実行、API は、タワー型 PC 1 台でもサーバーのラックでも同じように動作します。どのプロセッサが最も速くマイニングできるか、1 スレッドあたりどれくらいの RAM を積むべきかは、Blocknet マイニングハードウェアガイドを参照してください。seine を初めて使う方は、Blocknet のマイニング方法から始めてください。