跳到內容

安裝 jv CLI

需要 Node.js 18 或更高版本。

npm i -g jaspervault_cli
jv --version

之後要升級到最新版本,執行 jv update,它會執行 npm update -g jaspervault_cli。

jv update 只適用於全域安裝。解除安裝用 npm uninstall -g jaspervault_cli。

下面兩個指令不需要授權,裝好後可以先執行一遍,確認能連上 Jasper Vault:

jv market list
jv price --symbol JVBTC

能看到市場列表和價格,表示安裝和網路都正常。其餘指令要先完成下面的授權。

jv enable 和 jv withdraw 要求設定環境變數 BASE_HTTP_RPC_URL,填入一個 Base 主網的 RPC 網址。沒有設定時,這兩個指令會直接報錯結束。可以用 Base 官方的公共節點,也可以用你自己的節點服務商網址:

export BASE_HTTP_RPC_URL=https://mainnet.base.org

把這一行寫進 ~/.zshrc 或 ~/.bashrc,之後開啟的終端機都會生效。

jv enable --pretty
  1. 指令先輸出一段 JSON:url 是授權頁面的網址,expiresAt 是頁面的過期時間。
  2. 在瀏覽器裡開啟 url,連接錢包,依頁面提示簽名。這則授權訊息按 Base 鏈(chainId 8453)簽名,錢包提示切換網路時請切到 Base。簽名前可以核對兩個欄位:signer 是本機剛產生的委託 key 地址,deadline 是授權的到期時間。授權有效期目前是 7 天,從簽名時起算。
  3. 指令會一直等你完成,預設最多等 900 秒,用 --timeout <秒數> 可以調整。等待期間,stderr 每 10 秒輸出一行等待狀態。授權頁面在建立 15 分鐘後過期(即 expiresAt),把 --timeout 調大不會延長頁面的有效期。
  4. 完成後輸出結果:
{
  "success": true,
  "message": "Vault setup completed",
  "walletAddress": "0x…",
  "delegationAddress": "0x…",
  "marginAccount": "0x…",
  "vaults": [ … ],
  "transactionHash": "0x…"
}
  • walletAddress:你的錢包地址。
  • delegationAddress:委託 key 的地址。
  • marginAccount:你在 Jasper Vault 上的保證金帳戶,充值會轉到這個地址。
  • vaults:你的倉位帳戶,用於持有倉位。CLI 下單時自動選用,不需要你指定;充值和提現只涉及保證金帳戶。

頁面過期或簽名沒有完成時,指令輸出 "success": false,結束代碼為 3,重新執行即可。

授權到期後,用同一個錢包設定檔再執行一次 jv enable 續期。委託 key 能做什麼、不能做什麼,見交易員對接概覽。

每次 jv enable 都會儲存一份錢包設定檔,名稱是 <名稱>@beta,預設是 default@beta。要再授權一個錢包,用 --name 取一個新名稱:

jv enable --name hedge

這會建立 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 的授權同樣要到期才失效。

~/.jaspervault/
├── active.json              目前使用的錢包設定檔名稱
├── update-check.json        檢查新版本的快取
└── profiles/
    └── default@beta/
        ├── keys.json        委託 key(私鑰明文)
        └── profile.json     錢包地址、委託 key 地址、保證金帳戶和倉位帳戶地址

~ 指 $HOME,在 Windows 上是 %USERPROFILE%。keys.json 和 profile.json 的權限設為只有目前使用者可讀寫。請像保管密碼一樣保管 keys.json。

下一步:用 CLI 充值與提領。