登入 ERPC CLI 並查看金鑰的保存位置

讓本機登入後，ERPC CLI 會將工作階段保存在您的鑰匙圈或 1Password 中。本頁也說明節點金鑰保存在哪裡，以及 erpc 保留哪些檔案。

本頁說明 ERPC CLI v0.1.0-rc.4，這是發行前版本。

erpc signup     # opens the sign-up page
erpc login      # signs this machine in; the session goes to the keychain or 1Password
erpc whoami

erpc signup     # opens the sign-up page
erpc login      # signs this machine in; the session goes to the keychain or 1Password
erpc whoami

erpc login 透過 OAuth 裝置授權許可取得工作階段。在沒有瀏覽器的機器上，erpc login --no-browser 會印出 URL 與代碼，而不是開啟瀏覽器；erpc signup --no-browser 則會印出註冊 URL。erpc whoami 顯示所保存的工作階段屬於誰，erpc logout 則會登出並移除所保存的工作階段。

在終端機中，erpc login 會詢問要使用哪個保存位置：作業系統的鑰匙圈（預設），或 1Password（在其有回應時）。--store 與 --vault 可直接指定而不詢問，所做的選擇會記錄在 config.toml 中，其他命令會從那裡讀取。

若既未指定也未記錄任何選擇，erpc 會在設定了 OP_SERVICE_ACCOUNT_TOKEN 時使用 1Password 服務帳戶；否則在有作業系統鑰匙圈時使用它；再否則使用其狀態目錄中的檔案。erpc doctor 會回報目前使用哪個保存位置及其原因。使用服務帳戶時，erpc 只會將 OP_SERVICE_ACCOUNT_TOKEN 傳給它所啟動的 op 程序，且不會將該權杖寫入任何地方。

1Password 項目以機器的名稱命名，因此兩台機器絕不會共用同一個工作階段。ERPC_HOST_LABEL 可覆寫該名稱。

在有 Secret Service 回應的環境中，鑰匙圈就是 Secret Service。否則就是核心為您的使用者提供的持久金鑰環，它位於記憶體中，絕不會寫入磁碟：工作階段會持續到重啟，或閒置數天為止，之後會再次要求執行 erpc login。未經自身登入而啟動的 shell（不帶 - 的 su、sudo -E）無法使用該金鑰環，erpc 會拒絕，並告知這一點。

erpc 透過 /usr/bin/security 存取鑰匙圈。任何以您的身分執行的其他程式，也同樣能透過執行 security 讀取工作階段；不過鑰匙圈仍會將工作階段以加密形式靜態保存，並使其無法被其他使用者存取。

erpc 在三種情況下會將工作階段寫入其狀態目錄：使用 file 保存位置時、針對暫存的工作階段（無法送達保存位置的已輪替重新整理權杖），以及寫入中斷之後。只要這類檔案存在，erpc doctor 就會逐一回報。在 Unix 上，這些檔案以 0600 模式建立；在 Windows 上，erpc 不會自行設定任何權限。

節點清單，以及各鏈指南所列的原始金鑰備份，都保存在 1Password 中。並非每把金鑰都在 1Password 中，節點也可能持有其執行所需的金鑰。請自行備份主機上的內容：在沒有備份的情況下重建該主機，這些內容就會遺失。此外，活躍的 Sui validator 或已當選的 TRON witness 會拒絕遷移到新主機。

其他 RPC 節點不持有 validator 的簽署金鑰，但其主機會保存用戶端自行建立的內容，例如 engine JWT、對等節點身分或 RPC cookie。

僅有金鑰備份，並不能讓 validator 的恢復變得安全。在更換伺服器或恢復其資料之前，請遵循該鏈的恢復程序；各鏈的指南說明如何恢復其金鑰（節點）。

只有一個命令會將節點金鑰寫入您機器上的磁碟：erpc validator vote-account 在 Solana CLI 執行期間，將身分金鑰與投票金鑰寫入狀態目錄下的 0600 檔案，並在之後清除。若程序中途終止，檔案可能會留存，直到之後某次執行將其清理為止。

erpc worker 應用的交易金鑰與 Secret 與上述金鑰分開保存：金鑰與 Secret。