jv CLI のインストール
インストール
Section titled “インストール”Node.js 18 以降が必要です。
今後最新バージョンにアップグレードするときは jv update を実行します。このコマンドは npm update -g jaspervault_cli を実行します。
jv update はグローバルインストールの場合にのみ使えます。アンインストールするには npm uninstall -g jaspervault_cli を実行します。
先に接続を確認する
Section titled “先に接続を確認する”次の 2 つのコマンドは認可なしで実行できます。インストール後に実行して、Jasper Vault に接続できることを確認してください。
マーケット一覧と価格が表示されれば、インストールとネットワークは正常です。その他のコマンドは、以下の認可を済ませてから使います。
BASE_HTTP_RPC_URL の設定
Section titled “BASE_HTTP_RPC_URL の設定”jv enable と jv withdraw を使うには環境変数 BASE_HTTP_RPC_URL を設定し、Base メインネットの RPC アドレスを指定する必要があります。設定されていない場合、この 2 つのコマンドはエラーを出してそのまま終了します。Base 公式のパブリックノードでも、ご自身のノードプロバイダーのアドレスでも構いません。
この行を ~/.zshrc または ~/.bashrc に書き込んでおくと、以降に開くすべてのターミナルで有効になります。
認可:jv enable
Section titled “認可:jv enable”- コマンドはまず JSON を出力します。
urlは認可ページのアドレス、expiresAtはページの有効期限です。 - ブラウザーで
urlを開き、ウォレットを接続して、ページの案内に従って署名します。この認可メッセージは Base チェーン(chainId 8453)で署名されるため、ウォレットからネットワークの切り替えを求められたら Base に切り替えてください。署名前に 2 つのフィールドを確認できます。signerはこのコンピューターで生成されたばかりの委任キーのアドレス、deadlineは認可の有効期限です。認可の有効期間は現在、署名時から 7 日間です。 - コマンドは完了するまで待機します。デフォルトの最大待機時間は 900 秒で、
--timeout <秒数>で調整できます。待機中は stderr に 10 秒ごとに待機状況が 1 行出力されます。認可ページは作成から 15 分で期限切れになります(expiresAtがその時刻です)。--timeoutを大きくしてもページの有効期限は延びません。 - 完了すると結果が出力されます。
walletAddress:あなたのウォレットアドレス。delegationAddress:委任キーのアドレス。marginAccount:Jasper Vault 上のあなたの証拠金アカウント。入金はこのアドレスに送られます。vaults:あなたのポジションアカウント。ポジションを保有するためのアカウントです。注文時に CLI が自動で選ぶため、指定する必要はありません。入金と出金に関わるのは証拠金アカウントだけです。
ページの有効期限が切れた場合や署名が完了しなかった場合、コマンドは "success": false を出力し、終了コード 3 で終了します。もう一度実行してください。
認可の有効期限が切れたら、同じウォレットプロファイルで再度 jv enable を実行して更新します。委任キーにできること・できないことはトレーダー向け連携の概要を参照してください。
複数のウォレット:jv wallet
Section titled “複数のウォレット:jv wallet”jv enable を実行するたびにウォレットプロファイルが 1 つ保存されます。名前は <名前>@beta の形式で、デフォルトは default@beta です。別のウォレットを認可するには、--name で新しい名前を付けます。
これで 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 は新しい委任キーを生成して認可し直しますが、古いキーの認可も有効期限が来るまでは失効しません。
ローカルファイル
Section titled “ローカルファイル”~ は $HOME を指し、Windows では %USERPROFILE% です。keys.json と profile.json の権限は、現在のユーザーだけが読み書きできるように設定されます。keys.json はパスワードと同じように大切に保管してください。
次のステップ:CLI で入金・出金する。