トレーダー向け連携の概要
Jasper Vault はコマンドラインツール jv(npm パッケージ jaspervault_cli)を提供しており、ターミナル、スクリプト、AI エージェントから無期限先物を取引できます。
| 機能 | コマンド |
|---|---|
| 取引可能なマーケットとリアルタイム価格の確認 | jv market list、jv price |
| 無期限先物の成行注文・指値注文、ポジションの追加・縮小・決済 | jv order create、jv order close |
| 利確・損切り | jv tp set、jv sl set |
| Perpetual Protect(PP):ポジションのオープン時に PPO を付ける、または既存のポジションに個別に追加する | --ppo 系のパラメーター、jv order protect |
| Base からの入金、Base への出金:コマンドが Web ページの URL を出力し、そのページでウォレットで署名します | jv deposit、jv withdraw |
| 保有ポジション、指値注文、利確・損切り注文、成行注文の執行結果の照会 | jv orders、jv limit-order、jv job status |
2 つの使い方
Section titled “2 つの使い方”- コマンドライン:ターミナルやスクリプトで
jvを直接実行します。結果は JSON で出力されるため、プログラムで処理しやすくなっています。コマンドラインで取引するとスクリプトと取引ボットを書くを参照してください。 - AI エージェント:
jv mcpは MCP サーバーです。Claude Code や Cursor などの AI クライアントに接続すると、自然言語で注文できます。AI エージェントで取引するを参照してください。
どちらの使い方も同じローカルの認可を共有するため、認可は一度だけで済みます。CLI はデフォルトで Jasper Vault の本番環境に接続します。この環境は CLI では beta と呼ばれます。
認可は一度だけ
Section titled “認可は一度だけ”jv enable を実行すると、次のように進みます。
- CLI があなたのコンピューター上でランダムに新しい秘密鍵を生成します。これを委任キーと呼びます。委任キーはあなたのウォレットの秘密鍵とは関係ありません。
- CLI が URL を表示します。ブラウザーで開いてウォレットを接続し、認可メッセージに署名して、委任キーをあなたのウォレットの認可済み署名者として登録します。このステップは署名だけで、ウォレットから送金トランザクションが送信されることはなく、ウォレットの秘密鍵も常にウォレット内に留まります。
- 以降のポジションのオープン、決済、利確・損切りの設定は、すべて委任キーがローカルで署名するため、ウォレットのポップアップは表示されなくなります。
委任キーにできること
Section titled “委任キーにできること”CLI が委任キーで署名する操作は次のとおりです。
- 認可時に Jasper Vault 上のあなたのアカウントを作成する
- ポジションのオープン、追加、縮小、決済(指値注文と利確・損切り注文を含む)
- ポジションに PPO を購入する
コントラクトが委任キーの署名を受け付ける範囲は CLI が使う範囲より広く、証拠金の追加、PPプリペイド残高への資金の振り替え、オプションのオファー(offer)の作成などの操作も含まれます。
これらの操作はいずれもあなたのアカウントの資金を動かすため、誤った指示や悪意のある指示によって損失が生じる可能性があります。認可の有効期限が切れるまでは、このキーを手に入れた人は誰でもあなたのアカウントでこれらの操作を行えます。アカウントの資金を動かせる認証情報として保管してください。
委任キーにできないこと
Section titled “委任キーにできないこと”委任キーは出金に署名できません。コントラクトは出金の署名がウォレット本人によるものであることを求めており、委任キーで署名した出金は拒否されます。jv withdraw も Web ページを開き、ブラウザーでウォレットで署名してもらう仕組みです。
有効期限と取り消し
Section titled “有効期限と取り消し”- 認可には有効期限があり、認可メッセージの
deadlineフィールドに記載されています。署名前にウォレットの署名リクエストで確認できます。有効期限が過ぎるとコントラクトはこのキーの署名を受け付けなくなり、注文は失敗します。現在は署名から 7 日間です。 - 有効期限が切れたら、もう一度
jv enableを実行してウォレットで署名し直せば更新できます。CLI は同じキーを引き続き使用します。 - 現在、CLI には認可を取り消すコマンドがありません。ローカルのキーファイルやウォレットプロファイルを削除しても、このコンピューター上のファイルが削除されるだけで、オンチェーンの認可は無効になりません。
ローカルのキーファイルを安全に保管する
Section titled “ローカルのキーファイルを安全に保管する”委任キーは ~/.jaspervault/profiles/<ウォレットプロファイル名>/keys.json に平文で保存されます。CLI はファイルの権限を現在のユーザーだけが読み書きできるように設定しますが、Windows では設定に失敗する場合があります。
- このファイルやその内容を誰にも送らないでください。AI との会話に貼り付けることもしないでください。
~/.jaspervault/を Git リポジトリ、クラウド同期フォルダー、共有ディスクに置かないでください。- ファイルが漏えいした疑いがある場合は、できるだけ早く Web 版または
jv withdrawで資金を Base に出金してください。出金にはウォレット本人の署名が必要で、委任キーでは署名できません。
- Node.js 18 以降
- MetaMask、Rabby などのブラウザーウォレット
- 入金に使う Base チェーン上の資産と、ガス代を支払うための ETH
取引の前に重要なリスクに関するお知らせをお読みください。
次のステップ
Section titled “次のステップ”- jv CLI をインストールし、認可を完了する
- CLI で入金・出金する
- コマンドラインで取引する、または AI エージェントで取引する
- プログラムによる取引を書く前にスクリプトと取引ボットを書くを確認する。コマンドとエラーはコマンド早見表で調べられます