コンテンツにスキップ

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 を実行します。

次の 2 つのコマンドは認可なしで実行できます。インストール後に実行して、Jasper Vault に接続できることを確認してください。

jv market list
jv price --symbol JVBTC

マーケット一覧と価格が表示されれば、インストールとネットワークは正常です。その他のコマンドは、以下の認可を済ませてから使います。

jv enable と jv withdraw を使うには環境変数 BASE_HTTP_RPC_URL を設定し、Base メインネットの RPC アドレスを指定する必要があります。設定されていない場合、この 2 つのコマンドはエラーを出してそのまま終了します。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 に切り替えてください。署名前に 2 つのフィールドを確認できます。signer はこのコンピューターで生成されたばかりの委任キーのアドレス、deadline は認可の有効期限です。認可の有効期間は現在、署名時から 7 日間です。
  3. コマンドは完了するまで待機します。デフォルトの最大待機時間は 900 秒で、--timeout <秒数> で調整できます。待機中は stderr に 10 秒ごとに待機状況が 1 行出力されます。認可ページは作成から 15 分で期限切れになります(expiresAt がその時刻です)。--timeout を大きくしてもページの有効期限は延びません。
  4. 完了すると結果が出力されます。
{
  "success": true,
  "message": "Vault setup completed",
  "walletAddress": "0x…",
  "delegationAddress": "0x…",
  "marginAccount": "0x…",
  "vaults": [ … ],
  "transactionHash": "0x…"
}
  • walletAddress:あなたのウォレットアドレス。
  • delegationAddress:委任キーのアドレス。
  • marginAccount:Jasper Vault 上のあなたの証拠金アカウント。入金はこのアドレスに送られます。
  • vaults:あなたのポジションアカウント。ポジションを保有するためのアカウントです。注文時に CLI が自動で選ぶため、指定する必要はありません。入金と出金に関わるのは証拠金アカウントだけです。

ページの有効期限が切れた場合や署名が完了しなかった場合、コマンドは "success": false を出力し、終了コード 3 で終了します。もう一度実行してください。

認可の有効期限が切れたら、同じウォレットプロファイルで再度 jv enable を実行して更新します。委任キーにできること・できないことはトレーダー向け連携の概要を参照してください。

jv enable を実行するたびにウォレットプロファイルが 1 つ保存されます。名前は <名前>@beta の形式で、デフォルトは default@beta です。別のウォレットを認可するには、--name で新しい名前を付けます。

jv enable --name hedge

これで hedge@beta が作成され、現在使用するウォレットプロファイルに設定されます。取引と照会のコマンドはすべて現在のウォレットプロファイルを使用します。beta は、CLI での Jasper Vault 本番環境の呼び名です。

コマンド 説明
jv wallet list すべてのウォレットプロファイルを一覧表示します。active が * のものが現在使用中です
jv wallet info 現在のウォレットプロファイルのウォレットアドレス(eoa)、委任キーのアドレス、証拠金アカウント、ポジションアカウント
jv wallet switch <名前> 現在のウォレットプロファイルを切り替えます。名前を省略すると対話形式で選択するため、スクリプトでは名前を指定してください
jv wallet rename <旧名前> <新名前> 名前を変更します。新しい名前に @beta サフィックスがない場合、次回の実行時に自動で付加されます
jv wallet remove <名前> ウォレットプロファイルとそのローカルのキーファイルを削除します。現在使用中のものは削除できません

ウォレットプロファイルを削除しても、このコンピューター上のファイルが削除されるだけで、オンチェーンの認可は有効期限まで有効なままです。キーファイルを紛失した後に jv enable を再実行すると、CLI は新しい委任キーを生成して認可し直しますが、古いキーの認可も有効期限が来るまでは失効しません。

~/.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 で入金・出金する。