📄

協議升級

追蹤 Pi Network 歷次協議升級的完整記錄。

2026年7月28日

Pi Network 的主網協議版本不會自動更新，也不是單次操作就能完成的事。每一次升級都遵循一套固定的流程：先是節點軟體的更新截止日，接著才是主網鏈上協議版本的實際切換。這兩件事之間，通常會有幾天到幾週不等的落差。

這篇頁面整理 OrbitWatch 從 V21 到 V25 追蹤過程中，實際觀察到的升級模式與機制。

升級流程的兩個階段

每次 Pi Network 協議升級，都分成兩個獨立的階段：

第一階段：節點軟體更新 官方公告節點截止日，要求所有節點操作者在期限內完成軟體更新。對於使用 Pi Desktop（Windows/macOS）的節點，這個過程是自動的——軟體會自動拉取新版本的 Docker image 並切換到新的 container 運行。節點軟體完成更新，不代表主網協議版本已經切換。

第二階段：主網協議版本切換 在足夠比例的節點都完成軟體更新之後，主網的 protocol_version 才會正式切換。Pi Network 採用 Stellar 共識協議（SCP），節點間透過彼此信任的 quorum slice 達成共識——這套機制決定了協議版本不能由單一節點強制切換，需要等網路整體就緒。

通常的觀察順序是：

節點截止日
  ↓（數天後）
Testnet 2 率先切換到新版本
  ↓（再數天後）
主網 protocol_version 正式切換

Testnet 2 先切換，是技術驗證成功的信號，主網緊接在後。

歷次升級的完整時間軸

OrbitWatch 從 V21 開始追蹤每次升級的完整記錄：

版本   節點截止日   主網切換日   落差   主要內容
V21    —           2026/4/29   —      基礎建設（OrbitWatch 上線前）
V22    2026/4/27   2026/4/30   3 天   PiRC1 框架生效
V23    2026/5/19   2026/5/22   3 天   Soroban 智能合約完整支援
V24    2026/6/2    2026/6/5    3 天   自動遷移系統優化、節點穩定性
V25    2026/6/18   2026/7/22   34 天  BN254 加密、Poseidon 雜湊
V26    TBD         —           —      待定

V22 到 V24 的三次升級，模式非常一致：節點截止日後 3 天內，主網完成切換。

V25 是明顯的例外。截止日過後將近兩週，節點軟體才自動拉取 v25 container（約 6/27-6/28）；主網協議版本的實際切換，則在官方公告預定日期（7/22）才完成，距截止日整整 34 天。官方在 7/15 的 blog 中說明，v25 引入了 BN254 加密和 Poseidon 雜湊，是比前幾次技術複雜度更高的升級。

另外值得注意的是，V24 的節點截止日曾兩度延後：原定 5/25 → 5/31 → 最終定為 6/2。截止日調整在 Pi 的升級過程中並不罕見，OrbitWatch 每次都是從官方節點升級文件直接觀察到這個變更，而不是透過正式公告。

為什麼有時候會拖比較久？

根據 OrbitWatch 的觀察，影響時間差長短的因素至少有兩個：

技術複雜度。 V23 引入完整的 Soroban 智能合約支援，V25 引入 BN254 加密和 Poseidon 雜湊——這類涉及協議層新能力的升級，驗證所需的時間比單純的基礎建設強化（如 V24）長。

節點就緒率。 官方在截止日過後會發出提醒，顯示並非所有節點都會在截止日當天完成更新。主網切換需要等待足夠比例的節點就緒，這個比例沒有官方公開說明。

重要前提： 以上是根據觀察推論的可能原因，官方沒有針對任何一次延遲給出具體的技術說明。不確定的部分，OrbitWatch 不做進一步推測。

節點操作者需要做什麼？

使用 Pi Desktop（Windows/macOS） 的節點操作者：軟體更新通常是自動完成的，不需要手動操作。可以透過 docker images 指令查看目前運行中的 container 版本，確認是否已拉取新版本的 image。

Pi Node 軟體本身（如 0.6.0、0.6.1）的版本更新，與協議版本升級是兩件獨立的事。前者是節點應用程式的功能更新，後者是鏈上協議版本的切換，兩者不會互相干擾。

如何確認目前的主網協議版本？

最直接的方式是查詢 Horizon API：

https://api.mainnet.minepi.com/ledgers?order=desc&limit=1

回傳結果中的 protocol_version 欄位，即為目前主網運行的協議版本號。

也可以直接到 Pi Network Block Explorer 確認： 👉 blockexplorer.minepi.com

OrbitWatch 的 Horizon API 監控每 15 分鐘自動檢查一次，協議版本切換後會第一時間發布更新文章。

各版本升級追蹤紀錄

版本主要內容狀態OrbitWatch 追蹤文章
V21→V22PiRC1 框架生效✓ 已完成節點跑 v22 了，但鏈上還是 v21 · V22 確認切換
V22→V23Soroban 智能合約完整支援✓ 已完成V23 截止日更新 · Testnet 2 已切換 · V23 確認切換
V23→V24自動遷移系統優化、節點穩定性✓ 已完成V24 截止日更新 · Testnet 2 已切換 · V24 確認切換
V24→V25BN254 加密、Poseidon 雜湊（零知識應用基礎）✓ 已完成V25 升級預告 · 截止日觀察 · 節點就緒 · 官方公告 7/22 · V25 確認切換
V25→V26待定截止日 TBD—

數據來源：Pi Network Horizon API（api.mainnet.minepi.com）、Pi Network Block Explorer、Pi Network 節點介面直接觀察、Pi Network 官方公告。所有分析不構成投資建議。 OrbitWatch 是獨立的 Pi Network 生態觀測站，與 Pi Network 官方無任何關聯。