跳转到内容

安装 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 充值与提现。