安装 jv CLI
需要 Node.js 18 或更高版本。
以后升级到最新版本,运行 jv update,它会执行 npm update -g jaspervault_cli。
jv update 只适用于全局安装。卸载用 npm uninstall -g jaspervault_cli。
下面两条命令不需要授权,装好后可以先运行一遍,确认能连上 Jasper Vault:
能看到市场列表和价格,说明安装和网络都正常。其余命令要先完成下面的授权。
设置 BASE_HTTP_RPC_URL
Section titled “设置 BASE_HTTP_RPC_URL”jv enable 和 jv withdraw 要求设置环境变量 BASE_HTTP_RPC_URL,填一个 Base 主网的 RPC 地址。没有设置时,这两个命令会直接报错退出。可以用 Base 官方的公共节点,也可以用你自己的节点服务商地址:
把这一行写进 ~/.zshrc 或 ~/.bashrc,以后打开的终端都会生效。
授权:jv enable
Section titled “授权:jv enable”- 命令先输出一段 JSON:
url是授权页面的地址,expiresAt是页面的过期时间。 - 在浏览器里打开
url,连接钱包,按页面提示签名。这条授权消息按 Base 链(chainId 8453)签名,钱包提示切换网络时请切到 Base。签名前可以核对两个字段:signer是本机刚生成的委托 key 地址,deadline是授权的到期时间。授权有效期目前是 7 天,从签名时算起。 - 命令会一直等你完成,默认最多等 900 秒,用
--timeout <秒>可以调整。等待期间,stderr 每 10 秒输出一行等待状态。授权页面在创建 15 分钟后过期(即expiresAt),把--timeout调大不会延长页面的有效期。 - 完成后输出结果:
walletAddress:你的钱包地址。delegationAddress:委托 key 的地址。marginAccount:你在 Jasper Vault 上的保证金账户,充值会转到这个地址。vaults:你的仓位账户,用于持有仓位。CLI 下单时自动选用,不需要你指定;充值和提现只涉及保证金账户。
页面过期或签名没有完成时,命令输出 "success": false,退出码为 3,重新运行即可。
授权到期后,用同一个钱包配置再运行一次 jv enable 续期。委托 key 能做什么、不能做什么,见交易员对接概览。
多个钱包:jv wallet
Section titled “多个钱包:jv wallet”每次 jv enable 都会保存一份钱包配置,名字是 <名字>@beta,默认是 default@beta。要再授权一个钱包,用 --name 起一个新名字:
这会创建 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 的授权同样要到期才失效。
~ 指 $HOME,在 Windows 上是 %USERPROFILE%。keys.json 和 profile.json 的权限设为只有当前用户可读写。请像保管密码一样保管 keys.json。
下一步:用 CLI 充值与提现。