跳到內容

用 CLI 充值與提領

jv deposit 和 jv withdraw 會產生一個網頁網址,你在瀏覽器裡開啟,用錢包簽名確認,指令等待結果。資產經跨鏈橋在 Base 和 Jasper Vault 之間轉移。

不要在執行 jv 的終端機環境裡設定任何錢包私鑰。

使用前先完成授權。第一次使用時,建議先用小額走一遍完整流程。也可以在網頁端充值和提領,見充值與提領。

jv deposit --token usdc --amount 100
  1. 指令先輸出一行 JSON:url 是充值頁面,recipient 是入帳地址,也就是你的保證金帳戶(和 jv wallet info 裡的 marginAccount 相同),expiresAt 是頁面的過期時間。
  2. 在瀏覽器裡開啟 url,連接授權時用的錢包,依頁面提示在 Base 上確認交易,通常是一筆代幣授權(approve)加一筆跨鏈轉帳。錢包裡需要有 Base 上的 ETH 支付 gas。
  3. Base 上的交易確認後,CLI 再最多等 60 秒查詢入帳情況,然後輸出結果:
{"success":true,"message":"Deposit transaction confirmed on Base","transactionHash":"0x…","recipient":"0x…","token":"USDC","amount":"100","arrived":true,"arrivalTimeMs":12345}

"arrived": true 表示已經入帳。"arrived": false 表示資產還在跨鏈途中,過幾分鐘到網頁端查看餘額。

參數 說明
--token 填 usdc,必填。充值的 USDC 可以用作永續合約的保證金
--amount 數量,按 USDC 填寫,例如 100 表示 100 USDC,必填
--timeout 等你在網頁上完成操作的最長時間,單位秒,預設 900
--no-wait Base 上確認後直接回傳,不再等待入帳
jv withdraw --token usdc --amount 100
  • 執行前要設定 BASE_HTTP_RPC_URL,見安裝 jv CLI。
  • 資金從你的保證金帳戶提出,即輸出裡的 vault。
  • 在瀏覽器裡開啟 url,用錢包簽署這次提領,再依頁面提示完成跨鏈和在 Base 上的領取。
  • 提領簽名只能由錢包本人完成,委託 key 不能代簽。
  • 指令預設最多等 900 秒,完成後輸出 {"success":true,"message":"Withdrawal completed","transactionHash":"0x…",…}。
參數 說明
--token 填 usdc,必填
--amount 數量,按 USDC 填寫,必填
--timeout 等你在網頁上完成操作的最長時間,單位秒,預設 900

頁面過期或流程失敗時,指令輸出 "success": false,結束代碼為 3。確認錢包裡沒有已經送出的交易後,重新執行指令。