ノード運用者向け: v3.2.8チェックリスト
リリースv3.2.8は、2026年11月12日(高さ9,929,500)からテストネットqorechain-dianaで稼働しています。メインネットqorechain-vladiは2026年11月12日(高さ4,164,600、ガバナンス提案16)からv3.2.7を実行しており、v3.2.8は適用していないため、このページの内容は現時点ではメインネットのノードには適用されません。
このページは、v3.2.8でノード運用者が確認・変更すべき事項の短いリストです。バンドルに含まれる共有ライブラリ、コントラクトランタイムの設定、app.tomlの新しいデフォルト値、新しいREST経路1つ、そしてまだv3.2.7のノードをアップグレードする手順を扱います。ノードガイドの全体については、ノードの運用を参照してください。
なぜ重要か。 v3.2.8は、新しいコントラクトランタイムライブラリ上でスマートコントラクトを実行し、コントラクト呼び出しが使用するメモリとコードのロードに対して課金します。古いライブラリフォルダを使い続けるノードや、コントラクト用メモリが少なすぎる状態で動かすノードは、起動しないか、遅れをとります。チェックリストの残りは、小さな設定作業です。
1. lib/フォルダ全体をコピーする
リリースバンドルには、qorechaindと、4つの共有ライブラリを含むlib/フォルダが入っています。
| ライブラリ | 役割 |
|---|---|
libqorepqc.so | ポスト量子署名の検証 |
libqoresvm.so | SVMランタイム |
libwasmvm.x86_64.so | アップストリームのコントラクトランタイムライブラリ |
libwasmvmqore_v1.x86_64.so | v3.2.8で新規追加: QoreChainのコントラクトランタイムライブラリ |
個別のファイルではなく、フォルダ全体をコピーしてください。DockerfileのCOPY lib/ ...行や、ベアメタルホストでのcp -r lib/* ...は、後のリリースでライブラリが追加されても動き続けますが、ファイル名を列挙する方法では動きません。
tar -xzf qorechaind-v3.2.8-b3-linux-amd64.tar.gz
sudo cp qorechaind /usr/local/bin/qorechaind
sudo cp -r lib/. /opt/qorechain/lib/
ローダーが、コピー先のフォルダ(すでに使用しているLD_LIBRARY_PATHまたはld.so.conf.dのエントリ)を指すようにして、再起動してください。上記のコマンドは一例です。ご自身の環境のパスを使用してください。
2. コントラクトのメモリキャッシュ: 256 MiB以上
コントラクトランタイムは、コンパイル済みのコントラクトをメモリに保持します。app.tomlの[wasm]セクションにあるmemory_cache_sizeは、256 MiB以上でなければなりません。
[wasm]
memory_cache_size = 256
256未満の値は、ノードの起動時に256に引き上げられ、ノードは警告をログに出力します。小規模なマシンでは、追加のメモリを見込んでおいてください。
3. コントラクトのディレクトリは<home>/wasmになりました
コンパイル済みのコントラクトコードは、<home>/wasmに置かれるようになりました。<home>は、ノードを起動するときのディレクトリ(--home)です。コントラクトコードが古い場所にあるノードは、引き続きそれを使用し、警告をログに出力します。都合のよいときにフォルダを移動できます。その際は、先にノードを停止してください。
4. app.tomlの新しいデフォルト値
v3.2.8で初期化したノードは、これらのデフォルト値を書き込みます。既存のapp.tomlは書き換えられないため、アップグレードしたノードは、変更するまで古い値のままです。
| 設定 | 新しいデフォルト | 内容 |
|---|---|---|
simulation_gas_limit | 50000000 | このノードでシミュレーションされるトランザクションのガス上限。ウォレットとSDKは送信前にシミュレーションを行い、高い上限により大きなコントラクト呼び出しもシミュレーションできます |
JSON-RPCのapi名前空間 | eth,net,web3 | txpool名前空間は、ノードの保留中トランザクションを公開してしまうため、デフォルトでは提供されません。必要な場合にのみ、ご自身でtxpoolを追加してください |
simulation_gas_limit = 50000000
[json-rpc]
api = "eth,net,web3"
5. クエリのガス上限
コントラクトのクエリは、app.tomlの[wasm]セクションで制御されるノードローカルのガス上限の下で実行されます。チェーンチームは、バリデーターではこれを0(上限なし)に設定することを推奨しています。
[wasm]
query_gas_limit = 0
この設定が変えるのは、ご自身のノードがコントラクトのクエリに対して返す内容だけです。ブロックに含まれなければならない内容は変わりません。これはバリデーター向けのチェーンチームの推奨であり、公開クエリを提供するノードでは、有限の上限のほうが適している場合があります。
6. 新しい経路: GET /qorechain/svm/v1/params
v3.2.8は、SVMモジュールのパラメーターを読み取る専用の経路を追加します。v3.2.8のノード(テストネット)で提供され、リリースが適用されていないメインネットではHTTP 501を返します。
curl -s https://api-testnet.qore.host/qorechain/svm/v1/params
2026年11月12日のテストネットからの応答:
{"params":{"max_program_size":"10485760","max_account_data_size":"10485760","compute_budget_max":"1400000","lamports_per_byte":"3480","rent_exemption_multi":"2.000000000000000000","enabled":false,"svm_slot_offset":"0","default_sig_scheme":0,"max_cpi":4,"max_custody_uqor":"10000000000","max_custody_hard_uqor":"1000000000000","max_account_excess_uqor":"10000000000"}}
| フィールド | 意味 |
|---|---|
enabled | SVMトランザクションレーンが開いているかどうか。アップグレード以降、テストネットではfalseであり、ガバナンスが再度開くまでSVMへの書き込みは拒否されます |
max_program_size, max_account_data_size | バイト単位のサイズ上限(それぞれ10,485,760) |
compute_budget_max | トランザクションが要求できる最大のコンピュートバジェット(1,400,000) |
lamports_per_byte, rent_exemption_multi | ストレージ価格の入力値 |
svm_slot_offset, default_sig_scheme, max_cpi | スロット番号のオフセット、デフォルトの署名スキーム、プログラム間呼び出しの深さの上限 |
max_custody_uqor, max_custody_hard_uqor, max_account_excess_uqor | SVMアカウントが保有できるネイティブQORの上限(uqor単位) |
SVMの送信ボタンを表示する前にenabledを読み取ってください。SVM開発を参照してください。経路GET /qorechain/svm/v1/cluster_infoは別の経路で、クラスターのIDを返します。
7. マニフェストを確認する
マニフェストは、どのバイナリをインストールするかを示す唯一の情報源です。
curl -s https://download.qore.host/testnet/latest.json | jq '{version, minCompatible, upgradeType, upgradeHeight, binary: .binary.url}'
2026年11月12日には、versionが3.2.8、minCompatibleが3.2.8、upgradeTypeがheight、upgradeHeightが9929500、バイナリがqorechaind-v3.2.8-b3-linux-amd64.tar.gzと応答しました。binary.urlを信頼する前に、versionがminCompatibleと等しいことを確認し、同じファイル内のsha256でアーカイブを検証してください。メインネットのマニフェストはhttps://download.qore.host/mainnet/latest.jsonにあり、メインネットのアップグレードが告知されるまでv3.2.6を示します。
8. まだv3.2.7のノードをアップグレードする
テストネットのアップグレード高さはすでに過ぎているため、まだv3.2.7のノードは、高さ9,929,500でUPGRADE "v3.2.8" NEEDEDと表示して停止します。状態は保持されており、再同期は不要です。
- マニフェストに記載されたアーカイブをダウンロードし、SHA-256を検証します。
- ノードを停止します。
qorechaindを置き換え、lib/フォルダ全体をコピーします(ステップ1)。[wasm] memory_cache_size(ステップ2)を確認し、simulation_gas_limit、JSON-RPCの名前空間、query_gas_limitについて決定します(ステップ4と5)。- ノードを起動し、ログを監視します。コントラクトのディレクトリまたはメモリキャッシュについての警告は、変更していなければ想定どおりです。
- チェーンに追従していることを確認します。
curl -s localhost:26657/status | jq '.result.sync_info.catching_up'
curl -s https://api-testnet.qore.host/qorechain/svm/v1/params | jq '.params.enabled'
テストネットに新しく参加するノードは、v3.2.8のバイナリから直接開始します。ステートシンクとピアについてはテストネットへの接続を、アップグレードの履歴についてはノードの運用を参照してください。
制限とエラー
| 表示される内容 | 意味 | 対処 |
|---|---|---|
UPGRADE "v3.2.8" NEEDEDが表示され、ノードが高さ9,929,500で停止する | ノードがまだv3.2.7のバイナリである | セクション8 |
| 共有ライブラリが見つからないという起動エラー | lib/が全体としてコピーされていないか、ローダーがそこを指していない | セクション1 |
memory_cache_sizeが引き上げられたという警告 | 設定値が256 MiB未満である | 256以上に設定する |
| コントラクトのディレクトリについての警告 | コントラクトコードがまだ古い場所にある | 都合のよいときに<home>/wasmへ移動する |
/qorechain/svm/v1/paramsからの501 | ノードがv3.2.8ではない(メインネットはv3.2.7) | メインネットでは想定どおり |