跳到內容

交易員對接概覽

Jasper Vault 提供命令列工具 jv(npm 套件 jaspervault_cli),可以在終端機、腳本或 AI agent 裡交易永續合約。

功能 指令
查看可交易市場和即時價格 jv market list、jv price
永續合約市價單、限價單,加倉、減倉、平倉 jv order create、jv order close
停利停損 jv tp set、jv sl set
永續合約保護(PP):開倉時附帶 PPO,或為現有倉位單獨加上 --ppo 系列參數、jv order protect
從 Base 充值、提領回 Base:指令提供網頁網址,在網頁上用錢包簽名 jv deposit、jv withdraw
查詢持倉、限價單、停利停損單和市價單執行結果 jv orders、jv limit-order、jv job status

兩種用法共用同一份本機授權,授權一次即可。CLI 預設連線 Jasper Vault 正式環境,這個環境在 CLI 裡叫 beta。

執行 jv enable 後:

  1. CLI 在你的電腦上隨機產生一把新私鑰,稱為委託 key。它和你的錢包私鑰沒有關係。
  2. CLI 提供一個網址。你在瀏覽器裡開啟,連接錢包,簽署一則授權訊息,把委託 key 登記為你錢包的授權簽署者。這一步只是簽名,錢包不會送出轉帳交易,錢包私鑰也始終留在錢包裡。
  3. 之後開倉、平倉、設定停利停損,都由委託 key 在本機簽名,不再彈出錢包。

CLI 用委託 key 簽名的操作包括:

  • 授權時建立你在 Jasper Vault 上的帳戶
  • 開倉、加倉、減倉、平倉,包括限價單和停利停損單
  • 為倉位購買 PPO

合約接受委託 key 簽名的範圍比 CLI 用到的更大,還包括追加保證金、把資金轉入 PP 預付充值餘額、建立選擇權報價(offer)等操作。

這些操作都會動用你帳戶裡的資金,錯誤或惡意的指令可能造成虧損。在授權到期之前,取得這把 key 的人可以用你的帳戶進行這些操作。請把它當作能動用你帳戶資金的憑證來保管。

委託 key 不能簽署提領。合約要求提領簽名來自錢包本人,委託 key 簽署的提領會被拒絕。jv withdraw 也是開啟網頁,讓你在瀏覽器裡用錢包簽名。

  • 授權有到期時間,寫在授權訊息的 deadline 欄位裡,簽名前可以在錢包的簽名請求裡看到。到期後合約不再接受這把 key 的簽名,下單會失敗。目前是簽名後 7 天。
  • 到期後再執行一次 jv enable,用錢包重新簽名即可續期,CLI 會繼續使用同一把 key。
  • CLI 目前沒有撤銷授權的指令。刪除本機的 key 檔案或錢包設定檔只會刪掉本機檔案,不會讓鏈上的授權失效。

委託 key 以明文儲存在 ~/.jaspervault/profiles/<錢包設定檔名稱>/keys.json。CLI 會把檔案權限設為只有目前使用者可讀寫,但在 Windows 上可能設定不成功。

  • 不要把這個檔案或其中的內容傳給任何人,也不要貼進 AI 對話。
  • 不要把 ~/.jaspervault/ 放進 Git 儲存庫、雲端同步資料夾或共用磁碟。
  • 懷疑檔案已經外洩時,盡快在網頁端或用 jv withdraw 把資金提回 Base。提領需要錢包本人簽名,委託 key 簽不了。
  • Node.js 18 或更高版本
  • 瀏覽器錢包,例如 MetaMask、Rabby
  • Base 鏈上用於充值的資產,以及支付 gas 的 ETH

交易前請先閱讀重要風險提示。

  1. 安裝 jv CLI,完成授權
  2. 用 CLI 充值與提領
  3. 用命令列交易,或者用 AI agent 交易
  4. 撰寫程式化交易前先看撰寫腳本和交易機器人,指令和錯誤訊息可以查指令速查