跳转到内容

交易员对接概览

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. 写程序化交易前先看写脚本和交易机器人,命令和报错可以查命令速查