HashA2A

🤖 HashA2A — エージェント間インテリジェンスレイヤー

HashA2A は、Hedera メインネット上で稼働する、分散型のエージェント間データマーケットプレイスです。AI エージェントは、**HBAR（HIP-991）またはUSDC（x402/AP2）**のマイクロペイメントを利用して、検証済みの複数オラクルによるインテリジェンスを購入できます。

主な機能

• 複数オラクルの価格情報 — 5つのソース（Pyth、CoinGecko、Binance、DeFiLlama、ForexAPI）から36種類の資産情報を取得します。四分位範囲（IQR）の信頼区間を伴う中央値を提供します。
• 予測市場 — 5つのプロバイダー（Polymarket、Kalshi、PredictIt、Manifold、Hyperliquid）を利用します。確率を相互検証します。
• アービトラージスキャン — すべての資産について、複数オラクル間のスプレッドをリアルタイムで検出し、機会の大きさに応じてランク付けします。
• 詳細な調査 — ウェブ検索、ニュース、ソーシャルシグナル、予測市場、AI 分析（LangChain + GPT-5-nano）を組み合わせます。
• エンタープライズプラグイン — 6つのツールを備えた Hedera Agent Kit ブリッジです。アカウント残高、送金、トピック管理、アカウント情報に対応します。

対象ユーザー

検証済みかつ相互検証された市場データを、オンチェーン決済レールで必要とする AI エージェント、トレーディングボット、DeFi プロトコル、エンタープライズチーム向けです。

接続

• サーバー URL： https://hasha2a.com/mcp
• 認証： HBAR（HIP-991 による自動手数料）または USDC（x402/Circle Gateway、ガス代不要）
• トランスポート： Streamable HTTP（リモート）または mcp-remote 経由の stdio
• インストール： npx hasha2a-mcp-client add

信頼性

• 19個の MCP ツール、5つのオラクルソース（36種類の資産）、5つの予測市場プロバイダー
• 115件のテストがすべて成功、Hedera メインネットで稼働中
• HIP-991 による手数料徴収、HIP-1261 によるシンプルな手数料
• x402 の6項目検証：レイアウト、金額、手数料支払者、署名、ノンス、資産

リンク

• ドキュメント：github.com/ymiydev-prog/HashA2A
• エージェントカード：hasha2a.com/.well-known/agent.json
• OpenAPI：hasha2a.com/openapi.json
• インストールスクリプト：raw.githubusercontent.com/.../install-mcp.sh

---

主な機能

機能	説明
🔮 OracleHub v2	36 アセット × 5 ソース — Pyth、CoinGecko、DeFiLlama、Binance、ForexAPI。IQR 信頼区間付きの中央値
📊 アービトラージエンジン	36 アセットすべてを対象に、オラクル間のスプレッドをリアルタイムで検出
🔌 A2A Protocol	Google A2A に完全準拠 — JSON-RPC 2.0、SSE ストリーミング、タスクのライフサイクル、コンテキストの受け渡し、AP2 マンデート
🛠️ MCP Server	Model Context Protocol ツール 18 個 — Smithery レジストリまたはワンコマンドインストールで利用可能
🧠 AI 分析	LangChain + OpenAI（GPT-5-nano）による詳細な市場分析
🔍 詳細調査	ウェブ検索 + ニュース + ソーシャルシグナル + 予測市場 + AI
💳 x402 Triple Rail	Base 上の USDC + Hedera 上の HBAR/HTS + Circle Gateway（Agent Wallet 経由のガス代不要の USDC、6/6 の検証ルール：レイアウト、金額、手数料支払者の安全性、署名、ノンス、アセット）
🔐 JWT 認証	スコープベースの認可に対応したエフェメラルトークン（TTL 60～3600 秒）
🎯 予測市場	Polymarket、Kalshi、PredictIt、Manifold、Hyperliquid — 相互検証済みの確率
⭐ 品質評価	プロバイダーの応答をすべて自動採点 — レイテンシー、完全性、精度、外れ値の検出
🏢 エンタープライズプラグイン	分離された hedera-agent-kit ブリッジ — アカウント／トピック／トランザクション管理用の MCP ツールを 6 個追加
📈 ダッシュボード	オラクル価格、スプレッド履歴、A2A タスク、ウォレット残高／トランザクションをリアルタイム表示
🔄 リバースオークション	プロバイダーがリクエストに入札 — エージェントは最良の価格／品質を得られます
🥩 ステーキングとスラッシング	不正なデータに対するステークベースのスラッシングによるプロバイダーの評価
💚 ヘルスチェック	プロバイダーごとの API 稼働状況をリアルタイムで表示（緑／赤） — 障害を自動検出
🐳 Docker	docker-compose によるワンコマンドデプロイ → メインネットで稼働中

クイックスタート

# One command — any agent, any machine
npx hasha2a-mcp-client add

# Or via shell script (no Node.js needed)
curl -fsSL https://raw.githubusercontent.com/ymiydev-prog/HashA2A/main/scripts/install-mcp.sh | bash

# Or run the server locally
docker compose up -d
curl http://localhost:8080/api/v1/agent/health

アーキテクチャ

Agent Client (Claude, LangChain, Google A2A, MCP)
       │
        ├── MCP  ───── http://localhost:8080/mcp        (19 tools)
       ├── A2A  ───── http://localhost:8080/api/v1/a2a/rpc
       ├── SSE  ───── http://localhost:8080/api/v1/a2a/rpc/stream
       ├── REST ───── http://localhost:8080/api/v1/...
       └── Agent Card ── http://localhost:8080/.well-known/agent.json
                              │
 ┌─────────────────────────────────────────────────────┐
 │                  HashA2A Core                        │
 │                                                      │
 │  OracleHub  ─── Pyth · CoinGecko · DeFiLlama        │
 │                 Binance · ForexAPI (36 assets)       │
 │  Arbitrage  ─── Spread detection + ranking           │
 │  QualityEval ── Latency · completeness · accuracy    │
 │  Research   ─── Web + News + AI Analysis             │
 │  TaskManager ── A2A lifecycle + artifacts            │
 │  ContextManager ── Context IDs + summaries           │
 │  PaymentEngine ── HIP-991 + x402 + AP2               │
 │  AuthService ── JWT + Mandates                       │
 │  AuctionEngine ── Reverse auctions for best price    │
 │  StakingManager ── Provider stake + slashing         │
 │  ConsensusLogger ── HCS audit trail                  │
 │  x402Handler  ── 6-rule verification                 │
 └─────────────────────────────────────────────────────┘
       │
 ┌──────┴──────┐
 │  Plugin      │
 │  Bridge      │
 │  (isolated   │
 │   venv for   │
 │agent-kit)    │
 └──────────────┘

MCP — Model Context Protocol

インストール

npm（推奨） — Claude Desktop、Cursor、Windsurf を自動検出します：

npx hasha2a-mcp-client add
# Or with a remote server URL
npx hasha2a-mcp-client add --url https://hasha2a.com/mcp

シェルスクリプト — Node.js は不要です：

curl -fsSL https://raw.githubusercontent.com/ymiydev-prog/HashA2A/main/scripts/install-mcp.sh | bash

Smithery 経由：smithery.ai で公開されています — 「HashA2A」を検索してください。

手動 — MCP クライアントの設定に追加します：

{
  "mcpServers": {
    "hasha2a": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://hasha2a.com/mcp"]
    }
  }
}

ツール（19 個）

オラクルとデータ

ツール	説明
get_price	複数のオラクルによる価格（Pyth+CoinGecko+Binance+DeFiLlama）
list_assets	サポート対象の全 36 アセットをメタデータとともに一覧表示
get_asset_profile	アセットごとの詳細情報 — ソース、change_24h、出来高
scan_arbitrage	全アセットを対象としたオラクル間のアービトラージ機会
verified_feed	信頼区間付きの相互検証済み価格フィード

予測市場と調査

ツール	説明
list_providers	予測市場プロバイダーの一覧表示
get_market_data	プロバイダーにデータをリクエスト
check_request	リクエスト結果を確認
get_agent_profile	エージェントの識別情報を表示
aggregate_market_data	複数プロバイダーのインテリジェンスを集約
analyze_market	市場データの AI 分析
deep_research	ウェブ + ニュース + AI による包括的な調査

エンタープライズプラグイン（Hedera Agent Kit）

ツール	説明
kit_setup	分離された hedera-agent-kit 環境をセットアップ
kit_account_balance	任意のアカウントの HBAR 残高を取得
kit_transfer_hbar	別のアカウントに HBAR を送金
kit_create_topic	HCS トピックを作成
kit_submit_message	HCS トピックにメッセージを送信
kit_topic_messages	HCS トピックのメッセージを取得（Mirror Node）
kit_get_account_info	アカウントの詳細情報を取得

AI エージェント向け SKILL

HashA2A は、ドキュメントを貼り付けなくても、エンドポイント、ツール、料金、決済レール、ワークフローなど、プラットフォームの使い方をあらゆる AI エージェントに教える、汎用 SKILL ファイルを提供します。

インストール

skills.sh 経由（Claude Code、Gemini CLI、Codex CLI などのあらゆるエージェントに対応）：

npx skills add ymiydev-prog/HashA2A --skill hasha2a -g -y

GitHub 経由（手動）：

git clone https://github.com/ymiydev-prog/HashA2A.git ~/.claude/skills/hasha2a

ソース：skills/hasha2a/SKILL.md + skills/hasha2a/references/core.md

AI プロンプト

docs/ai-prompts.md に、コピーしてすぐに使えるプロンプトがあります。19 個すべての MCP ツール、REST API、決済フロー、Hedera の操作を網羅した 15 個のプロンプトを収録しています。

IDE のセットアップ

ChatGPT（開発者モード）

1. ChatGPT で開発者モードを開きます
2. カスタム MCP コネクターに移動します
3. HashA2A MCP URL を設定します：http://localhost:8080/mcp
4. または、GPT Actions を使い、/openapi.json にある OpenAPI 仕様を追加します

Claude.ai（claude.ai Pro/Team）

1. 設定 → 機能 → コネクターを追加に移動します
2. URL を http://localhost:8080/mcp に設定します
3. または、claude.ai/customize/skills で SKILL をアップロードします：
   • ダウンロード：skills.zip
   • claude.ai/customize/skills で zip ファイルをアップロードします
   • claude.ai/settings/capabilities で localhost:8080 をドメインの許可リストに追加します

Claude Code（ターミナル）

# Via npm package (auto-detects Claude Code)
npx hasha2a-mcp-client add

# Via SKILL
npx skills add ymiydev-prog/HashA2A --skill hasha2a -g -y

Cursor

npx hasha2a-mcp-client add
# Or manually add to .cursor/mcp.json:
# { "mcpServers": { "hasha2a": { "command": "npx", "args": ["-y", "mcp-remote", "https://hasha2a.com/mcp"] } } }

Windsurf

npx hasha2a-mcp-client add
# Or manually add to .windsurf/mcp_config.json

Gemini CLI

npx skills add ymiydev-prog/HashA2A --skill hasha2a -g -y

Codex CLI

npx skills add ymiydev-prog/HashA2A --skill hasha2a -g -y
# Or clone to ~/.claude/skills/hasha2a (Codex shares the Claude skills directory)

Visual Studio Code（VS Code）

.vscode/mcp.json または VS Code の MCP 設定に追加します：

{ "servers": { "hasha2a": { "command": "npx", "args": ["-y", "mcp-remote", "https://hasha2a.com/mcp"] } } }

価格

USDC の価格は固定です。HBAR の価格は Binance から取得したデータに基づいてリアルタイムで更新され、取得できない場合は CoinGecko にフォールバックします。

製品	USDC	HBAR（リアルタイム）
価格フィード（単一アセット、複数オラクル）	$0.25	≈ 2.76 HBAR
アービトラージスキャン（全 36 アセット）	$0.50	≈ 5.52 HBAR
アービトラージ検証（単一ペア）	$0.10	≈ 1.10 HBAR
詳細調査（ウェブ + ニュース + AI）	$0.50	≈ 5.52 HBAR
予測市場（プロバイダーごと）	$0.15	≈ 1.66 HBAR
統合インテリジェンス（全ソース）	$1.00	≈ 11.05 HBAR

すべてのトランザクションで HIP-1261 Simple Fees を使用します：transaction_fee は上限額（基本は 0.05 HBAR、HIP-991 では 0.1 HBAR）です。詳しくは docs/hip-1261-simple-fees.md をご覧ください。

オラクルソース — 36 アセット、5 ソース

ソース	アセット	コスト	種類
Pyth Hermes	BTC、ETH、SOL、XAU、XAG、USD/JPY + 株式（7）	無料	機関による一次データ
CoinGecko	17 種の暗号資産	無料	CEX/DEX の集約
DeFiLlama	BTC、ETH、SOL（DeFiLlama 経由の Chainlink）	無料	Chainlink データフィード
Binance	BTC、ETH、SOL、BNB、XRP、ADA + その他	無料	中央集権型取引所
ForexAPI	EUR/USD、GBP/USD、AUD/USD、CAD/USD、CHF/USD、CNH/USD	無料	オープンな為替レート

アセットの対応状況

カテゴリ	数	例
暗号資産	21	BTC、ETH、SOL、HBAR、BNB、XRP、ADA、DOGE、AVAX、DOT、LINK、UNI、MATIC、LTC、AAVE、ATOM、ARB、APT、OP、SUI、PEPE
株式	7	AAPL、MSFT、NVDA、GOOGL、AMZN、TSLA、META
コモディティ	2	XAU（金）、XAG（銀）
外国為替	6	EUR/USD、GBP/USD、AUD/USD、CAD/USD、CHF/USD、CNH/USD

x402 Hedera レール — 6 項目の検証

HashA2A は、Hedera ネイティブ決済の正確なスキームを実装しています（HIP-1261 に準拠）：

#	ルール	検証内容
1	トランザクションの構成	feePayer が transactionID.accountID と一致すること
2	金額の正確性	payTo への正味支払額が想定額と一致すること
3	手数料支払者の安全性	手数料支払者が正味送金者ではないこと
4	署名の有効性	sigMap 内の Ed25519 署名が bodyBytes に対して有効であること（pynacl 経由）
5	ノンス（リプレイ）	accountID:transactionValidStart のキャッシュ（TTL は 1 時間）
6	アセット／トークン	HTS トークンの tokenTransfers を検証すること

再現可能なフィクスチャ（シークレットなし）：python scripts/x402_flow_fixture.py 詳細なドキュメント：docs/hiero-sdk-compatibility.md

A2A プロトコルへの準拠

HashA2A は、Linux Foundation が管理する Agent-to-Agent（A2A）プロトコルを実装しています：

エージェントカード

/.well-known/agent.json で提供されます：

• 正式な JSON Schema の入出力定義を備えた 5 つのスキル
• JSON-RPC 2.0 と SSE ストリーミングインターフェース
• JWT と認証なしの認証方式
• AP2 マンデートのサポート
• コンテキストの受け渡しとアーティファクトの保存

JSON-RPC 2.0 メソッド

メソッド	RPC エンドポイント	説明
message/send	/api/v1/a2a/rpc	タスクを作成して処理します
message/stream	/api/v1/a2a/rpc/stream	SSE によるリアルタイム更新付きでタスクを作成します
tasks/get	/api/v1/a2a/rpc	タスクの状態と結果を取得します
tasks/list	/api/v1/a2a/rpc	フィルターを指定してタスクを一覧表示します
tasks/cancel	/api/v1/a2a/rpc	実行中のタスクをキャンセルします

タスクのライフサイクル

submitted → working → input-required → completed
                     → failed / canceled / rejected

コンテキストの受け渡し

• contextId は、同じワークフロー内の複数のやり取りをまとめます
• ContextSummary は、全メモリーを共有することなく先行情報を受け渡します
• fork_context() は、履歴を引き継いだ分岐会話を作成します

テスト

# All tests (115 passing)
PYTHONPATH=src python -m pytest tests/ -v

# Smoke tests only (no credentials needed)
PYTHONPATH=src python -m pytest tests/ -m smoke -v

# E2E tests (requires .env)
PYTHONPATH=src python -m pytest tests/ -m e2e -v

API エンドポイント

フィードとデータ

メソッド	パス	説明
POST	/api/v1/feeds/prices	複数オラクルの価格フィード
POST	/api/v1/feeds/arbitrage	オラクル間の裁定取引をスキャンします
GET	/api/v1/feeds/pricing	リアルタイム価格（USDC + HBAR）
GET	/api/v1/feeds/x402/manifest	x402 決済マニフェスト
POST	/api/v1/feeds/x402/hedera/verify	HBAR/HTS の決済を検証します

A2A タスク

メソッド	パス	説明
POST	/api/v1/a2a/rpc	JSON-RPC 2.0（message/send、tasks/get など）
POST	/api/v1/a2a/rpc/stream	SSE ストリーミング RPC
POST	/api/v1/tasks	タスクを作成します（REST）
GET	/api/v1/tasks/{id}	タスクを取得します
GET	/api/v1/tasks	タスクを一覧表示します
POST	/api/v1/tasks/{id}/complete	アーティファクトを添えてタスクを完了します
POST	/api/v1/tasks/{id}/artifacts	アーティファクトをアップロードします
GET	/api/v1/tasks/{id}/artifacts	アーティファクトを一覧表示します
POST	/api/v1/tasks/context	コンテキストを作成します
GET	/api/v1/tasks/context/{id}/summary	コンテキストの概要
POST	/api/v1/tasks/context/{id}/fork	コンテキストを分岐します

認証

メソッド	パス	説明
POST	/api/v1/auth/token	一時的な JWT をリクエストします
POST	/api/v1/auth/verify	Bearer トークンを検証します
POST	/api/v1/auth/mandates	AP2 マンデートを作成します
POST	/api/v1/auth/mandates/{id}/authorize	支出を承認します

予測市場

メソッド	パス	説明
POST	/api/v1/requests	予測データを購入します
POST	/api/v1/requests/aggregate	複数プロバイダーの集約
POST	/api/v1/research	詳細なリサーチ

エージェントの検出

パス	説明
/.well-known/agent.json	A2A エージェントカード
/.well-known/x402.json	x402 決済マニフェスト
/llms.txt	LLM が読み取れるドキュメント
/mcp/	MCP サーバー情報（GET）+ Streamable HTTP（POST）

ダッシュボード

パス	説明
/	BTC のリアルタイム価格を表示するランディングページ
/dashboard	メインの管理ダッシュボード — プロバイダーカード、ウォレット、ヘルスステータス
/dashboard/oracles	オラクル価格とスプレッド履歴のチャート
/dashboard/tasks	A2A タスク管理ダッシュボード
/dashboard/wallet	ウォレット残高、米ドル換算額、取引
/dashboard/health	プロバイダーのヘルスチェック API（JSON）

クイックスタート（ローカル開発）

# Docker (recommended)
docker compose up -d
curl http://localhost:8080/api/v1/agent/health

# Or Python directly
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env  # configure your credentials
python runner.py

# Or with custom port
PORT=8082 python runner.py

技術スタック

• Python 3.12 + FastAPI + Uvicorn
• Hiero SDK 0.2.6（Hedera HCS + HIP-991 + HIP-1261）
• MCP（Model Context Protocol、19 個のツール）
• A2A（Google の Agent-to-Agent プロトコル）
• LangChain + OpenAI（GPT-5-nano）
• x402（Base USDC + Hedera HBAR/HTS、6 ルール検証）
• Hedera Agent Kit（分離されたプラグインブリッジ）
• pynacl（ed25519 署名検証）
• Docker + Docker Compose
• Chart.js（ダッシュボード）
• HyperFrames（プロモーション動画）
• tweepy（Twitter/X 自動プロモーション @hasha2a）

デプロイ

HashA2A は Docker 経由で Hedera mainnet 上で動作します。MCP サーバーは以下から見つけられます。

• Smithery：smithery.ai — 「HashA2A」を検索
• mcp.so：公開 MCP ディレクトリへの掲載
• インストールスクリプト：curl -fsSL https://raw.githubusercontent.com/ymiydev-prog/HashA2A/main/scripts/install-mcp.sh | bash

ドキュメント

ドキュメント	説明
skills/hasha2a/SKILL.md	AI エージェント向けの汎用 SKILL（Claude Code、Gemini、Codex など）
skills/hasha2a/references/core.md	ツール、エンドポイント、料金、アセット、決済レールのリファレンス
docs/ai-prompts.md	エージェント向けのコピーしてすぐ使える15個のプロンプト
docs/hip-1261-simple-fees.md	HIP-1261 の transaction_fee 最大上限の解説
docs/hiero-sdk-compatibility.md	hiero-sdk-python 0.2.0 から 0.2.6 への移行
docs/client-examples.md	統合例（cURL、Python、LangChain）
scripts/x402_flow_fixture.py	再生可能な x402 フローのデモ

ライセンス

MIT — 自由に使用、フォークし、これを使ってデータを販売できます。