Locker Protocol Agentic

Locker Protocol Agentic

秘密鍵はどこにもありません。当社のサーバーにも、エージェントのマシンにも、誰の手元にもありません。

エージェントは取引します。何も保有しません。

• 鍵の保管場所： アカウントの秘密鍵は、スマートフォンまたはタブレット上のオフラインアプリ、Locker Vault に保管されます。このコンピューターに保管されるのは、パスワードで封印され、それ自体で有効期限が切れるエージェントキーだけです（デフォルトでは6か月で、Hyperliquid が許可する最長期間です）。
• 出金できる人： 出金できるのはボールトだけです。人が QR コードをスキャンして署名します。Hyperliquid は、出金と送金のたびにエージェントキーを拒否します。その鍵から受け付ける資金移動は、Hyperliquid のボールトへの入金だけで、lpa が署名することはありません（2026-09-28 にメインネットで測定）。
• 送信先： 注文と読み取りは Hyperliquid に、入金と残高の確認は Arbitrum ノードに送信され、それ以外には送信されません。ただし、必要に応じて有効にできます（一覧は以下を参照）。当社のサーバーも、アカウントも、テレメトリーもありません。

ドキュメント： doc.lockerprotocol.com/agent-wallet：インストール、手順に沿ったセットアップ、取引方法、すべてのコマンドを説明しています。ウェブサイト： hyperagentictrader.com。

Locker Protocol Agentic は、Hyperliquid の無期限先物向けエージェントウォレットです。人と AI エージェント向けの lpa コマンド、MCP サーバー、2つの SDK パッケージを備えています。実際のオーダーブック上のシミュレーションアカウント、すべての注文前にチェックされるローカルポリシー、そしてすべての資金移動をスマートフォンで署名する仕組みが含まれています。

このリポジトリには、ドキュメント、変更履歴、すべての tarball の SHA-256 を記載したリリースログ、イシュートラッカーがあります。4つの npm パッケージは、repository フィールドでこのリポジトリを参照しています。ソースは公開されていません。

仕組み

3つの場所と、1つのルール。資金を保有する鍵がスマートフォンの外に出ることはありません。

  PHONE (offline)              THIS COMPUTER                              HYPERLIQUID
 +--------------------+      +-----------------------------------+      +----------------+
 | Locker Vault       |      | lpa   <- you, a script, or an AI  |      |                |
 |                    |      |  |       agent (shell or MCP)     |      |  order book    |
 | holds the ACCOUNT  |      |  |                                |      |                |
 | key; it never      |  QR  |  |  1. quote on the live book     |      |  your account  |
 | leaves the phone   |<---->|  |  2. local policy               |      |                |
 |                    |codes |  |  3. your go                    |      |                |
 | signs: the agent's |      |  v                                |      |                |
 | approval, deposits,|      | guardian (background process)     |      |                |
 | withdrawals, dex   |      |   holds the AGENT key in memory,  |----->|  orders,       |
 | transfers, revoke  |      |   checks the policy again, signs  |      |  cancels,      |
 +--------------------+      |   trading actions only            |      |  leverage,     |
                             +-----------------------------------+      |  TP/SL         |
                                                                        +----------------+

• Locker Vault は、オフライン状態を保つスマートフォンまたはタブレット上のアプリです。アカウントの鍵を保管し、QR コードで署名します。コンピューターにリクエストが表示され、スマートフォンのカメラで読み取ります。人がスマートフォンで内容を確認して署名すると、スマートフォンに署名が表示され、コンピューターのウェブカメラがそれを読み取ります。
• エージェントキー は、lpa init によってコンピューター上で作成され、ボールトによって一度だけ承認され、パスワードで封印されてディスクに保管されます。Hyperliquid はこの鍵による取引を許可しますが、出金と送金はすべて拒否します。鍵はそれ自体で有効期限が切れます。
• ガーディアン は、lpa unlock が起動するバックグラウンドプロセスです。エージェントキーをメモリ内に保持し、すべての注文をポリシーに照らして再チェックします。スマートフォンで一度署名した後は、マンデートにも照らしてチェックし、取引アクションの限定されたリストにのみ署名します。起動時に書き込むトークンを含むリクエストにのみ応答します。このトークンをプラグインが読み取ることはできません。lpa を呼び出すエージェントがパスワードや鍵を見ることはありません。

項目	署名者	場所
市場、気配値、ポジション、残高	なし	公開情報の読み取り
シミュレーション注文	なし	実際のオーダーブック上でコンピューター内でシミュレーション
新規注文、決済、キャンセル、変更	ガーディアン内のエージェントキー	気配値、ポリシー、あなたの承認を得た後
エージェントの承認、取り消し	あなたのウォレット：Locker Vault、またはあなたが選んだ拡張機能やモバイルウォレット	スマートフォンでの QR 手順、またはウォレット内で承認するリクエスト
入金、出金、DEX 間の証拠金移動	あなたのウォレット	同上
マンデート：エージェントの制限。署名は一度だけ	あなたのウォレット	同上
ライブコピーの注文	ガーディアン内のエージェントキー	トレーダーを指定するポリシーとマンデートに従う
プラグインのコマンド	実アカウントに対しては何もなし	自身のフォルダーのみを読み取る別プロセス

アカウントの署名方法は3つあります

上の図では、最も安全で推奨する方法である Locker Vault を使っています。lpa setup では、アカウントの署名方法を尋ねられます。最初に Locker Vault が表示されます。lpa init --with vault|browser|mobile では1行で指定でき、lpa signer show では後から確認できます。

方法	必要なもの	このコンピューターから外部に送られるもの
Locker Vault（最も安全で推奨）	オフラインで保管するスマートフォンまたはタブレット上の Locker Vault、ウェブカメラ	何もありません。リクエストと応答は QR コードでやり取りされます
ブラウザー拡張機能（MetaMask、Rabby）	lpa のローカルページを開くブラウザーにインストールされた拡張機能	これ以上は何もありません。拡張機能はそのページ上で署名します
モバイルウォレット	スマートフォン上のウォレット。WalletConnect の QR コードを一度スキャンし、その後は各リクエストをそこで承認します	エンドツーエンドで暗号化されたリクエストが WalletConnect のリレーを通過します。リレーにはこのコンピューターの IP アドレスと時刻が見えます

拡張機能またはモバイルウォレットでは、資金を動かす前に、何も移動しない署名を1回行ってアカウントを証明します。この署名はここで検証され、どこにも送信されません。コントラクトであるアドレスは拒否されます。この2つはオンラインウォレットであり、型付き署名を生のフィールドとして表示するため、ローカルページには、ウォレットに表示される内容がフィールドごとに示されます。Locker Vault では、キーをオンラインにならないデバイスに保管し、各リクエストを言葉で表示します。lpa signer use では、同じアドレスの署名方法を変更できます。エージェントキーと委任設定はそのまま保持されます。

委任設定、ライブコピー、プラグイン

• パーセントによる停止はありません。 2.4.0 以降、損失の割合によって注文が拒否されることはありません。当日分も開始以降の分も同様です。また、エクイティが下落しても日次パイロットは停止しません。資金を制限するのは、注文サイズ、レバレッジ、市場、注文と1日の想定元本、リスク対リワード、期限、このコンピューターに設定されたその他の制限、委任設定、モデルの予算、連続損失後の一時停止、各戦略が独自に設定するストップです。
• 委任設定は、ウォレットで一度署名するエージェントの制限です。ポリシーの制限、1日に新規で開く想定元本の上限、手数料の受取人、キーの使用目的が含まれます。Locker Vault では各制限がそれぞれ1行に表示されます。2.4.0 以降、バージョン2の EIP-712 ドメインに基づく15個のフィールドが含まれます。2.4.0 より前に署名された委任設定は全体が拒否され（MANDATE_OUTDATED）、lpa mandate sign で再度署名するまで使用できません。ガーディアンは注文を開くたびに委任設定を確認し、ローカルポリシーの制限を広げることはありません。フォルダーには署名済みの委任設定のうち最も新しいものと取り消し状態が記録されます。そのため、ファイルがなくなった場合、古いファイルに戻された場合、または取り消し済みの場合、このガーディアンでも次のガーディアンでも注文は開かれません。lpa mandate revoke を実行すると、再度署名するまで注文を開けなくなります。lpa mandate release（パスワードが必要）を実行すると、ローカルポリシーのみの状態に戻ります。
• ライブコピー（lpa copy start --live）では、実際のアカウント上でトレーダーの取引をコピーします。ユーザーがロックを解除したガーディアンと、そのトレーダーが指定され、コピー予算に余裕がある委任設定が必要です。各注文はユーザーの注文と同様にポリシーと委任設定を通り、アカウントのキーではなくエージェントキーで署名されます。ガーディアンが発注できなかった縮小注文は保持され、再試行されるため、失われることはありません。ポジションが開いている間は、コピーの予算に算入されたままです。ユーザー自身のアカウントがコピーされることはありません。デフォルトはシミュレーションです。
• プラグインはコマンドと MCP ツールを追加します。プラグインは独立した Node プロセスで実行され、自身のフォルダーだけを読み取ります。キー、設定、ガーディアンのトークンにはアクセスしません。ただし、ユーザー名、コンピューター名、ネットワークアドレスは認識します。そのことはインストール画面に表示されます。ウォレットには、宣言してユーザーが承認した機能を通じてのみアクセスできますが、いずれも実際のアカウントの署名には使われません。インストール時にプラグインのファイルのフィンガープリントが記録され、変更されたプラグインは実行されません。

エージェントキーでできること、できないこと

承認済みのエージェントキーを使用し、2026-09-28 に Hyperliquid メインネットで測定しました。

アクション	エージェントキーによる署名
注文の発注、変更、キャンセル、レバレッジの設定	受け入れられる
withdraw3、usdSend、spotSend、sendAsset、usdClassTransfer	拒否される
approveAgent（別のエージェントの承認）、approveBuilderFee	拒否される
vaultTransfer（アカウントの資金をボルトに預け入れる）	受け入れられる

盗まれたエージェントキーでは出金できませんが、資金を失う可能性はあります。流動性の低い市場で共犯者と取引したり、他人が運営するボルトにアカウントの資金を預け入れたりできるためです。lpa は vaultTransfer に署名しません（ガーディアンが署名するのは、取引アクションの許可リストに限られます）。しかし、キーとパスワードを持つ盗人は lpa を必要としません。実質的な制限となるのは、リスクにさらしてもよい金額だけを入れた専用アカウントです。

他のエージェントウォレットとの比較について、引用元と情報源を一つずつ確認するには、COMPARISON.md をご覧ください。

4 つのパッケージ

各パッケージの npm ページが完全なリファレンスです。仕組みの説明に続き、すべてのコマンド、ツール、関数を例とともに掲載しています。

パッケージ	内容	リファレンス
@locker-protocol/agent-wallet-hyperliquid-trader	lpa コマンドです。キーを Locker Vault にオフラインで保管する、Hyperliquid 無期限先物取引用のエージェントウォレットです。ライブラリとしても利用できます。	npm
@locker-protocol/agent-wallet-hyperliquid-trader-mcp	MCP サーバーです。同じコマンドを標準入出力経由で 42 個のツールとして提供し、インストールしたプラグインのツールも利用できます。Claude Code、Cursor、Codex、およびすべての MCP クライアントに対応しています。	npm
@locker-protocol/agent-wallet-hyperliquid-signer	キーを Locker Vault に保管するプログラム向けの、Hyperliquid の署名、注文、アカウント情報の読み取り、ライブデータ機能です。ESM と CommonJS に対応し、型定義も含まれています。	npm
@locker-protocol/agent-wallet-vault	Locker Vault のコーデックです。署名リクエストと署名を QR コードとして扱い、アカウントを同期します。ESM と CommonJS に対応し、型定義も含まれています。	npm

4 つのパッケージのバージョンはリリースごとにそろっており、リリースごとに同じバージョンになります。ウォレットと MCP サーバーには Node 22.13 以降が必要です。2 つの SDK は Node 22 であればどのバージョンでも動作します。

インストール先について：1 行のインストーラーは、パッケージを 1 つコピーして ~/.lpa に lpa と MCP サーバーを配置し、lpa と locker-mcp の 2 つの起動コマンドを用意します。これにより、どちらも常に同じバージョンで動作します。npm install -g では lpa のみがインストールされます。その後、MCP クライアントは npx を使って @latest のサーバーを取得できます。これは起動のたびに最新のリリースを使用します。新しいバージョンがリリースされたら、インストーラーをもう一度実行し、lpa も最新にしてください。どちらの方法でも ~/.lpa フォルダーとガーディアンは共有され、ガーディアンは別バージョンのプログラムには署名しません。

インストール

npm install -g @locker-protocol/agent-wallet-hyperliquid-trader@latest

または、Node がない場合は取得して、管理者権限なしで必要なものをすべて ~/.lpa に配置する 1 行のインストーラーを使用できます。

macOS と Linux の場合：

curl -fsSL https://hyperagentictrader.com/agent-wallet-install.sh | sh

Windows（PowerShell）の場合：

irm https://hyperagentictrader.com/agent-wallet-install.ps1 | iex

シミュレーションを開始する

シミュレーションアカウントでは、Hyperliquid の実際の注文板を使い、実際の手数料で約定します。キーもボルトも必要ありません。次の注文サイズは、既定のポリシー（1 注文あたり 100 ドル、レバレッジ 3）に適合します。

lpa paper init --budget 1000
lpa perps quote --symbol ETH --side long --size 0.03 --leverage 3
lpa perps open  --symbol ETH --side long --size 0.03 --leverage 3 --paper
lpa paper status
lpa perps close --symbol ETH --paper

ターミナルでは、open と close が見積もりを表示し、確認を求めてから約定します。ターミナルを使わない場合（スクリプトやエージェントなど）は、ユーザーの同意を得てから --yes を追加してください。 ## Locker Vault でセットアップ

lpa setup
lpa init
lpa init --with browser
lpa init --with mobile

lpa setup は手順を一つずつ進め、すべてをセットアップします。lpa init はアカウントとその取引用キーだけをセットアップします。--with で拡張機能またはモバイルウォレットを指定しない限り、Locker Vault が使われます。Locker Vault を使う場合、ターミナルからこのコンピューター上のローカルページが開きます。スマートフォンの Locker Vault にアカウントが QR コードで表示され、ページがウェブカメラで読み取ります。次に、新しいエージェントキーの承認内容が QR コードで表示され、スマートフォンで署名します。スマートフォンが署名する前に、ターミナルで入力したパスワードを使って、このコンピューター上でエージェントキーが作成され、暗号化されます。アカウントのキーがスマートフォンから外に出ることはありません。

その後、lpa unlock を実行するとガーディアンが起動します。ガーディアンはエージェントキーをメモリ上に保持し、注文に署名するバックグラウンドプロセスです。エージェントがキーやパスワードを見ることはありません。lpa lock を実行すると、キーがメモリから取り除かれます。

すべてのコマンド

lpa だけを実行すると、インタラクティブセッションが開きます。/ コマンドと同じコマンド、リアルタイムの市場表示、および選択したモデルを使うアシスタントを利用できます。すべてのコマンドはテキストで応答し、--json を指定すると JSON で応答します。拒否する場合は、固定コードと次に行う操作が示されます。フラグと各コマンドの例はリファレンスに記載されています。

分野	コマンド
セットアップ	lpa setup、lpa init、lpa unlock、lpa lock、lpa status、lpa doctor
アカウントの署名方法	lpa signer show、lpa signer use vault、lpa signer use browser、lpa signer use mobile、lpa signer forget
複数のアカウント、それぞれに1つのプロファイル	lpa profile list、add、use、rename、remove；任意のコマンドに --profile <name>
市場データ	lpa perps venues、lpa perps markets、lpa perps quote、lpa perps regime、lpa perps ranges
アカウント情報の読み取り	lpa perps positions、lpa perps balance、lpa perps portfolio、lpa perps orders、lpa perps fills、lpa perps funding、lpa perps fees、lpa perps ledger、lpa wallet address、lpa wallet balances
注文	lpa perps check、lpa perps open、lpa perps close、lpa perps cancel、lpa perps modify；quote、check、open で --tif、--reduce-only、--margin
ウォレットで署名する資金関連操作	lpa perps deposit、lpa perps withdraw、lpa perps transfer、lpa agent revoke
シミュレーション	lpa paper init、lpa paper status、lpa paper on、lpa paper off、lpa paper record、lpa paper replay
ポリシーとジャーナル	lpa policy show、lpa policy set、lpa journal、lpa journal export
ウォレットで署名する委任	lpa mandate sign、lpa mandate show、lpa mandate revoke、lpa mandate release（パスワード）
シミュレーションまたはライブでのコピー	lpa copy start、lpa copy stop、lpa copy status、lpa copy resume
日次パイロット	lpa pilot status、lpa pilot schedule、lpa pilot strategy list、lpa pilot strategy show、lpa pilot model-down、lpa pilot plans、lpa pilot day、lpa pilot end-grid、lpa pilot end-range、およびその他のコマンドはリファレンスを参照
スマートフォンへの通知、デフォルトではオフ	lpa notices、on、off、test
プラグイン	lpa plugins install、list、inspect、remove、disable、enable；続けて lpa <plugin> <command>
アシスタント向けサーバー、このコンピューター上	lpa mcp status、off、on、forget
hyperkeel（任意）	lpa hyperkeel login、status、logout、brief、leaders、follows、follow、unfollow、alerts、off、on
設定	lpa config
サーバー	lpa service install、status、logs、start、stop、restart、uninstall；lpa console、lpa console password
メンテナンス	lpa reset、lpa uninstall

MCP サーバー

Claude Code：

claude mcp add locker -- npx -y --ignore-scripts @locker-protocol/agent-wallet-hyperliquid-trader-mcp@latest

Claude Desktop（claude_desktop_config.json）、Cursor（.cursor/mcp.json）、Antigravity（mcp_config.json）：

{
  "mcpServers": {
    "locker": { "command": "npx", "args": ["-y", "--ignore-scripts", "@locker-protocol/agent-wallet-hyperliquid-trader-mcp@latest"] }
  }
}

Codex（~/.codex/config.toml）：

[mcp_servers.locker]
command = "npx"
args = ["-y", "--ignore-scripts", "@locker-protocol/agent-wallet-hyperliquid-trader-mcp@latest"]

その他の MCP クライアントの場合：コマンド npx -y --ignore-scripts @locker-protocol/agent-wallet-hyperliquid-trader-mcp@latest を使用し、トランスポートには stdio を指定します。Node 22.13 以降が必要です。公式 MCP Registry での名前は io.github.locker-protocol/agentic です。

1 行インストーラーで lpa をインストールした場合は、代わりにクライアントからそのランチャーを指定してください。これは常に lpa と同じバージョンです：claude mcp add locker -- ~/.lpa/bin/locker-mcp。

すべてのツールとその引数、呼び出し例については、MCP リファレンスをご覧ください。注文は最初に見積もりを取得し、その見積もりの quote_id で確定します。資金の移動では、本人が自身のターミナルに入力した内容に応答します。

スキルとサンプル

リポジトリ	内容
locker-protocol/agent-skills	AI エージェントが lpa と MCP サーバーを使う方法を学ぶスキルです。セッション開始フックと評価機能を備え、6 つのホスト向けプラグインとしてパッケージ化されています。
locker-protocol/agentic-examples	そのまま使えるレシピです。既定ではシミュレーションモードです。

ドキュメント

ページ	内容
docs/security-model.md	モデルから見えない情報、メインネットで測定された厳格な上限、ローカルポリシーとリスク対リワードのガード、そしてポリシーで防げないリスクについて説明します。
docs/network.md	lpa が接続するすべてのホストと、その接続タイミングを説明します。
docs/strategies.md	デイリーパイロットの戦略について説明します。4 種類、実装済みの 18 戦略、および読み取り、選択、書き込み、測定を行うコマンドを紹介します。
docs/parity-metamask.md	MetaMask Agent Wallet のコマンドと並べて、1 つずつ紹介します。
COMPARISON.md	主張ごとに 1 行で、URL、引用、最終確認日を記載しています。
CHANGELOG.md	各バージョンで追加、変更、修正された内容を記載しています。
RELEASES.md	公開済みのすべての tarball の SHA-256 と、自分で確認する方法を記載しています。

ネットワーク

lpa が接続するホストと、その接続タイミング：

ホスト	接続タイミング
api.hyperliquid.xyz（HTTPS および WebSocket）	市場、見積もり、注文、アカウントの読み取り、ライブビュー
arb1.arbitrum.io、arbitrum-one-rpc.publicnode.com、arbitrum.drpc.org	Arbitrum の残高と入金。最初に応答したノードを使用します
api.hyperkeel.com	デイリーパイロットの記録と MCP サーバーの概要は、接続なしで hyperkeel のエージェント向け公開ルートを通じて取得します。それ以外は lpa hyperkeel login で接続している間のみ取得します。通知は lpa notices on で有効にした場合のみ取得します（通知の種類と最大 1 つの整数のみで、アカウントの数値は含みません）
api.anthropic.com、api.openai.com、generativelanguage.googleapis.com、openrouter.ai	選択した場合に限り、選択したアシスタントプロバイダーに接続します。ローカルモデル（LM Studio、Ollama）または独自のアドレスを指定した場合は、その指定先にとどまります
nfs.faireconomy.media、api.alternative.me、www.federalreserve.gov、www.ecb.europa.eu、www.coindesk.com	デイリーパイロットが記録を作成するときに限り、1 日 1 回接続します。キー、アカウント、アドレス、ポジションを使わない読み取りのみです
relay.walletconnect.org（WebSocket）	モバイルウォレットでアカウントが署名する場合のみ、署名が求められている間に接続します。リクエストはエンドツーエンドで暗号化されます
127.0.0.1	独自のページ（セレモニー、設定、コンソール）とガーディアンのローカルソケット

それ以外には接続しません。分析情報の送信、クラッシュレポート、更新確認はありません。インストールしたプラグインは独自のプロセスで実行され、独自にネットワークへ接続する場合があります。lpa がプラグインのために接続することはありません。

手数料

Hyperliquid 独自の取引手数料に加えて、各注文の額面の 0.05 % がビルダー手数料として Locker に支払われます。この手数料はすべての見積もりに記載され、合計額は lpa journal に記録されます。lpa init でアカウントが承認した場合にのみ適用され、承認していない場合は適用されません。承認がなければ、手数料なしで注文が送信され、注文がブロックされることはありません。リファラルコード LOCKERPROTOCOL は有効化時に一度だけ設定され、すでにリファラーがいるアカウントではそのまま維持されます。シミュレーションアカウントにも同じ手数料が適用されるため、実際の取引と同じ結果になります。

このリポジトリのチェック

node tests/check.mjs

tests/check.mjs に依存関係はありません。すべての相対リンクが解決できること、COMPARISON.md のすべての主張に URL、引用、最終確認日が記載されていること、すべての箇所で同じバージョンが使われていること、ツリー内に ASCII 以外の文字が含まれていないことをチェックします。

問題の報告

このリポジトリでイシューを作成してください：github.com/locker-protocol/agentic/issues。テンプレートは 2 種類あり、バグ用と質問用が用意されています。

セキュリティ上の問題はイシューで報告しないでください。SECURITY.md を読み、記載されている宛先にメールを送ってください。

ライセンス

LOCKER PROTOCOL PROPRIETARY NON-COMMERCIAL LICENSE。LICENSE を参照してください。