安裝 jv CLI
需要 Node.js 18 或更高版本。
之後要升級到最新版本,執行 jv update,它會執行 npm update -g jaspervault_cli。
jv update 只適用於全域安裝。解除安裝用 npm uninstall -g jaspervault_cli。
下面兩個指令不需要授權,裝好後可以先執行一遍,確認能連上 Jasper Vault:
能看到市場列表和價格,表示安裝和網路都正常。其餘指令要先完成下面的授權。
設定 BASE_HTTP_RPC_URL
Section titled “設定 BASE_HTTP_RPC_URL”jv enable 和 jv withdraw 要求設定環境變數 BASE_HTTP_RPC_URL,填入一個 Base 主網的 RPC 網址。沒有設定時,這兩個指令會直接報錯結束。可以用 Base 官方的公共節點,也可以用你自己的節點服務商網址:
把這一行寫進 ~/.zshrc 或 ~/.bashrc,之後開啟的終端機都會生效。
授權:jv enable
Section titled “授權:jv enable”- 指令先輸出一段 JSON:
url是授權頁面的網址,expiresAt是頁面的過期時間。 - 在瀏覽器裡開啟
url,連接錢包,依頁面提示簽名。這則授權訊息按 Base 鏈(chainId 8453)簽名,錢包提示切換網路時請切到 Base。簽名前可以核對兩個欄位:signer是本機剛產生的委託 key 地址,deadline是授權的到期時間。授權有效期目前是 7 天,從簽名時起算。 - 指令會一直等你完成,預設最多等 900 秒,用
--timeout <秒數>可以調整。等待期間,stderr 每 10 秒輸出一行等待狀態。授權頁面在建立 15 分鐘後過期(即expiresAt),把--timeout調大不會延長頁面的有效期。 - 完成後輸出結果:
walletAddress:你的錢包地址。delegationAddress:委託 key 的地址。marginAccount:你在 Jasper Vault 上的保證金帳戶,充值會轉到這個地址。vaults:你的倉位帳戶,用於持有倉位。CLI 下單時自動選用,不需要你指定;充值和提現只涉及保證金帳戶。
頁面過期或簽名沒有完成時,指令輸出 "success": false,結束代碼為 3,重新執行即可。
授權到期後,用同一個錢包設定檔再執行一次 jv enable 續期。委託 key 能做什麼、不能做什麼,見交易員對接概覽。
多個錢包:jv wallet
Section titled “多個錢包:jv wallet”每次 jv enable 都會儲存一份錢包設定檔,名稱是 <名稱>@beta,預設是 default@beta。要再授權一個錢包,用 --name 取一個新名稱:
這會建立 hedge@beta,並把它設為目前使用的錢包設定檔。所有交易和查詢指令都使用目前的錢包設定檔。beta 是 CLI 對 Jasper Vault 正式環境的稱呼。
| 指令 | 作用 |
|---|---|
jv wallet list |
列出全部錢包設定檔,active 為 * 的是目前使用的 |
jv wallet info |
目前錢包設定檔的錢包地址(eoa)、委託 key 地址、保證金帳戶和倉位帳戶 |
jv wallet switch <名稱> |
切換目前的錢包設定檔;不帶名稱時會以互動方式選擇,腳本裡請帶上名稱 |
jv wallet rename <舊名稱> <新名稱> |
改名;新名稱沒有 @beta 後綴時,下次執行會自動補上 |
jv wallet remove <名稱> |
刪除一份錢包設定檔及其本機 key 檔案,不能刪除目前正在使用的 |
刪除錢包設定檔只會刪除本機檔案,鏈上的授權在到期前仍然有效。遺失 key 檔案後再執行 jv enable,CLI 會產生一把新的委託 key 並重新授權,舊 key 的授權同樣要到期才失效。
~ 指 $HOME,在 Windows 上是 %USERPROFILE%。keys.json 和 profile.json 的權限設為只有目前使用者可讀寫。請像保管密碼一樣保管 keys.json。
下一步:用 CLI 充值與提領。