Protocol Banks

Protocol Bank — AI 自動取引

---

概要

Protocol Bank は、AI 自動取引プロダクトです。ユーザーはウォレット（MetaMask）を接続し、Hyperliquid に取引用の予算を入金して、取引専用のエージェントウォレットを承認します。AI エージェントは厳格なリスク管理、完全な透明性、即時の取り消し機能のもと、24 時間体制で無期限市場を取引します。ペーパートレードモードでは、実際の市場データを使い、シミュレーション資金で取引するため、誰でもリスクなしでエージェントの動作を確認できます。

同じ実行レイヤーを、AI エージェント向けのプログラマブル APIとしても提供します。1 つの認証情報と、サーバーが適用する 1 つのポリシー（操作、1 回あたりの上限、1 日あたりの上限、コインの許可リスト）を使用し、操作ごとに監査証跡を記録します。リファレンスについてはdocs/AGENT_API.md、4 つの統合例についてはdocs/AGENT_CASES.mdをご覧ください。

中核となる安全機能：

• AI は取引できますが、出金はできません — エージェントウォレットには、Hyperliquid 上で取引専用の権限が付与されます
• 最悪のケースを画面に明示 — 取引ウォレットの残高が損失の最大額になります
• 設計段階からガード機能を組み込み — 取引ごとの損切り、ポジション上限、日次損失サーキットブレーカー
• いつでも取り消し可能 — Hyperliquid 上でエージェントを一時停止、緊急停止、または取り消せます

プロダクト

領域	説明
AI 取引コックピット (/trading)	ログイン後のランディング画面：残高、エクイティカーブ、平易な言葉で表示する AI のアクティビティフィード、オープンポジション、一時停止／停止／リセットの操作
ペーパーエンジン	Hyperliquid の実際の市場データとシミュレーション約定。モメンタム（24 時間 z スコア）およびファンディングキャリーのシグナル、2.5% の利確／損切り、15% のポジションサイジング、5%／8% の日次サーキットブレーカー
ライブモード	エージェントウォレットの承認フロー（EIP-712 approveAgent）、AES-256-GCM によるキー管理、エージェントキーで署名する実際の IOC 注文執行、注文状況が不確かな場合の安全停止、手動承認モード（オプトイン）、ユーザーごとの分離スキーマ
ウォレット (/balances)	マルチチェーンの残高とアクティビティ（旧ダッシュボードから統合）
ビジネス（折りたたみ）	旧来のエンタープライズ向け決済スイート：一括支払い、請求書、サブスクリプション、決済処理、ベンダー — 利用可能ですが、メイン機能ではなくなりました

アーキテクチャ

┌──────────────────────────────────────────────────────────────┐
│ Frontend — Next.js 15 (App Router, TypeScript, Tailwind)     │
│  Landing → AI Trading cockpit → Wallet → Business (collapsed)│
└──────────────────────────────────────────────────────────────┘
        │
        ▼
┌──────────────────────────────────────────────────────────────┐
│ API Routes (app/api)                                         │
│  /api/trading/overview  — tick-on-demand cockpit state       │
│  /api/trading/actions   — pause / resume / stop / reset      │
│  /api/trading/live/*    — agent wallet lifecycle (SIWE-auth) │
└──────────────────────────────────────────────────────────────┘
        │
        ▼
┌──────────────────────────────────────────────────────────────┐
│ Trading engine (lib/trading)                                 │
│  hyperliquid.ts — market data client (meta/ctxs/candles)     │
│  strategies.ts  — momentum + funding signals (pure)          │
│  risk.ts        — sizing, TP/SL, circuit breakers            │
│  agent.ts       — scan → signal → risk → execute → report    │
│  exchange.ts    — signed live orders (EIP-712)               │
│  keys.ts        — per-user agent key custody (AES-256-GCM)   │
│  store.ts       — paper state (file storage, tmp fallback)  │
└──────────────────────────────────────────────────────────────┘
        │
        ▼
  Hyperliquid (public info API + signed exchange API)

クイックスタート

# Install
pnpm install

# Configure (see .env.example / ENV_SETUP.md)
cp .env.example .env.local

# Develop
pnpm dev                # http://localhost:3000

# Run the trading agent headlessly (paper mode)
pnpm trading:agent

# MCP server — control the agent from Claude / any MCP host
pnpm mcp:stdio           # stdio transport (see docs/MCP.md)
pnpm mcp:test            # smoke-test tools/list + tools/call

テストと品質ゲート

コマンド	実行内容
pnpm test	Jest — ユニットテスト／プロパティテスト 1035 件
pnpm test:ui	Playwright — ブラウザー E2E（独自の開発サーバーを :3100 で起動）
pnpm lint	ESLint 9（エラー 0 件のゲート。既存の課題は警告として扱います）
npx tsc --noEmit	TypeScript の型チェック
pnpm build	本番ビルド（Vercel デプロイのゲート）
go test ./...	Go マイクロサービス（services/* 内）

CI はプッシュごとにフロントエンドの全テストスイート（tsc + jest + lint）と Go テストを実行します。.github/workflows/ci.ymlをご覧ください。

ドキュメント

ドキュメント	説明
PRD v2 — AI Trading	製品仕様：ポジショニング、コックピット、ウォレットアーキテクチャ、戦略とリスクパラメーター
MCP Server	Claude Desktop／Claude Code／任意の MCP ホストからトレーディングエージェントを操作
Usage Guide	製品内ガイド（始め方、コックピット、ライブ取引の開始、FAQ）
Risk Disclosure	ライブ取引の前にお読みください
Threat Model	資産、信頼境界、既知の制限（不確実な注文、台帳のずれ、鍵の管理）
Terms / Privacy	法務情報
ENV_SETUP.md	環境設定
TESTING_GUIDE.md	テストインフラストラクチャの詳細
Agent API	エージェント向けプログラムインターフェイス：ポリシー、エンドポイント、エラー、課金
Agent API contract	5つのエージェントエンドポイント向け OpenAPI 3.1 — ポリシースキーマ、エラー分類、実例
Agent API cases	実際のリクエストとレスポンスを使った4つの統合例
Agent tools	Vercel AI SDK、LangChain、OpenAI、Anthropic 用の単一ツールマニフェスト
Framework starters	実行可能な Vercel AI SDK、Mastra、elizaOS 統合
Partners	パートナー統合ガイド（curl、SDK、サンドボックス、課金）

旧決済機能に関するドキュメントは、Business 機能セット用として引き続き docs/ にあります。

セキュリティモデル

• ウォレットユーザー向け SIWE + JWT 認証（lib/auth/siwe.ts、lib/middleware/api-auth.ts）
• ノンカストディアル：ユーザーの鍵がウォレットの外に出ることはありません。エージェントの鍵は取引専用で、保存時に暗号化されます
• 注文ごとに リスクガードレール を適用（lib/trading/risk.ts）
• ユーザーごとの分離：ウォレットアドレスでスコープを設定した TradingAccount／TradeRecord モデル
• レート制限、CSRF、リプレイ攻撃対策、セキュリティヘッダー（middleware.ts）

ライセンス

GNU General Public License v3.0 only (GPL-3.0-only) — LICENSE および ADDITIONAL_LEGAL_TERMS.md を参照してください。

---

日本語ドキュメント

プロジェクト概要

Protocol Bank は AI 自動取引製品 です。ユーザーはウォレット（MetaMask）を接続し、Hyperliquid に取引予算を入金して、取引権限のみを持つエージェントウォレットを承認します。これにより、AI が厳格なリスク管理と高い透明性のもとで、いつでも取り消し可能な状態で、永続先物市場を24時間取引します。Paper モードでは実際の相場情報とシミュレーション資金を使用するため、誰でもリスクなしで体験できます。

主なセキュリティ特性：

• AI にできるのは取引だけで、出金は決してできません——エージェントウォレットには Hyperliquid 上で取引権限のみがあります
• 最大損失額は常に画面に表示されます——取引ウォレットの残高が最大損失額です
• すべての注文にリスク管理が組み込まれています——損切り、ポジション上限、日次損失による取引停止
• いつでも取り消し可能です——一時停止、緊急停止、または Hyperliquid 上でエージェントを取り消せます

主な機能

モジュール	説明
AI 取引コックピット (/trading)	ログイン後のランディングページ：残高、純資産曲線、自然言語による AI アクティビティフィード、ポジション、一時停止／停止コントロール
Paper エンジン	実際の Hyperliquid 相場情報 + シミュレーション約定。モメンタム（24時間 z-score）+ 資金調達率シグナル、±2.5% の利確・損切り、15% のポジション、5%／8% の日次損失による取引停止
Live モード	エージェントウォレットの承認フロー（EIP-712 approveAgent）、AES-256-GCM による鍵管理、エージェント鍵で署名する実際の IOC 注文、不確実な注文時の安全な停止、手動承認モード（任意）、ユーザーごとのスキーマ分離
ウォレット (/balances)	マルチチェーンの残高と取引履歴（旧 Dashboard から統合）
Business（折りたたみ領域）	企業向け決済スイート：一括決済、請求書、サブスクリプション、加盟店決済、連絡先——維持されていますが、今後の主力機能ではありません

クイックスタート

pnpm install
cp .env.example .env.local   # 见 ENV_SETUP.md
pnpm dev                     # http://localhost:3000
pnpm trading:agent           # 后台常驻运行交易 agent（paper 模式）
pnpm mcp:stdio               # MCP server：在 Claude 里查询/控制 agent（见 docs/MCP.md）

テストと品質ゲート

コマンド	内容
pnpm test	Jest — 1035件の単体／プロパティテスト
pnpm test:ui	Playwright ブラウザー E2E
pnpm lint	ESLint 9（エラー0件のゲート）
npx tsc --noEmit	型チェック
pnpm build	本番ビルド（Vercel デプロイゲート）
go test ./...	Go マイクロサービスのテスト

ドキュメント

ドキュメント	説明
PRD v2 — AI 取引	製品仕様
MCP Server	Claude などの MCP クライアントから取引エージェントを照会／操作
使用ガイド	始め方、コックピット、運用開始の手順、FAQ
リスク開示	ライブ取引の前に必ずお読みください
利用規約 / プライバシー	法務文書

⚠️ リスクに関する注意：自動取引によって取引ウォレットの全額を失う可能性があります。AI はツールであり、利益を保証するものではありません。過去の実績は将来の結果を示すものではありません。Protocol Bank は投資助言を提供しません。