HashA2A

🤖 HashA2A — Agent 间智能层

HashA2A 是一个运行在 Hedera 主网上的去中心化Agent 间数据市场。AI Agent 通过 **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）。
• 企业插件 — Hedera Agent Kit 桥接，包含 6 个工具：账户余额、转账、主题管理、账户信息。

适用对象

需要经过验证和交叉验证的市场数据及链上支付通道的 AI Agent、交易机器人、DeFi 协议和企业团队。

连接

• 服务 URL： https://hasha2a.com/mcp
• 身份验证： HBAR（HIP-991 自动费用）或 USDC（x402/Circle Gateway，无 Gas 费）
• 传输方式： Streamable HTTP（远程）或通过 mcp-remote 使用 stdio
• 安装： npx hasha2a-mcp-client add

可信度

• 19 个 MCP 工具、5 个预言机数据源（36 种资产）、5 个预测市场提供方
• 115 项测试全部通过，已在 Hedera 主网上线
• HIP-991 费用收取、HIP-1261 简单费用
• x402 六项规则验证：布局、金额、费用支付方、签名、随机数、资产

链接

• 文档：github.com/ymiydev-prog/HashA2A
• Agent 卡片：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 服务	18 个 Model Context Protocol 工具 — 可通过 Smithery 注册表或一键安装使用
🧠 AI 分析	使用 LangChain + OpenAI (GPT-5-nano) 进行深入市场分析
🔍 深度研究	网络搜索 + 新闻 + 社交信号 + 预测市场 + AI
💳 x402 三轨支付	Base 上的 USDC + Hedera 上的 HBAR/HTS + Circle Gateway（通过 Agent Wallet 实现免 Gas USDC，符合 6/6 项验证规则：布局、金额、费用支付方安全性、签名、随机数、资产）
🔐 JWT 身份验证	临时令牌（TTL 为 60s-3600s），支持基于范围的授权
🎯 预测市场	Polymarket、Kalshi、PredictIt、Manifold、Hyperliquid — 经交叉验证的概率
⭐ 质量评估	自动为每个提供商的响应评分 — 延迟、完整性、准确性、异常值检测
🏢 企业插件	隔离的 hedera-agent-kit 桥接服务 — 额外提供 6 个 MCP 工具，用于管理账户/主题/交易
📈 仪表板	实时预言机价格、价差历史记录、A2A 任务、钱包余额/交易
🔄 反向拍卖	提供商竞价响应请求 — Agent 可获得最佳价格/质量
🥩 质押与罚没	基于质押的罚没机制，管理提供商声誉并惩罚不良数据
💚 运行状况检查	按提供商显示实时 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

Shell 脚本 — 无需 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	查看 Agent 身份信息
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 Agent 技能

HashA2A 提供通用的 SKILL 文件，帮助任何 AI Agent 学会使用该平台 — 包括端点、工具、定价、支付方式和工作流 — 无需粘贴文档。

安装

通过 skills.sh（任何 Agent——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——15 条提示词，涵盖全部 19 个 MCP 工具、REST API、支付流程和 Hedera 操作。

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 简易费用：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	签名有效性	Ed25519 签名可通过 sigMap 验证 bodyBytes（使用 pynacl）
5	Nonce（重放）	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）协议：

Agent 名片

托管于 /.well-known/agent.json：

• 5 项技能，包含正式的 JSON Schema 输入/输出定义
• JSON-RPC 2.0 + SSE 流式接口
• JWT + 无需身份验证的身份验证方案
• 支持 AP2 mandate
• 上下文传递和制品存储

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 mandate
POST	/api/v1/auth/mandates/{id}/authorize	授权支出

预测市场

方法	路径	说明
POST	/api/v1/requests	购买预测数据
POST	/api/v1/requests/aggregate	多提供方聚合
POST	/api/v1/research	深度研究

Agent 发现

路径	说明
/.well-known/agent.json	A2A Agent 名片
/.well-known/x402.json	x402 支付清单
/llms.txt	面向大模型的文档
/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（模型上下文协议，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 主网上。可通过以下方式发现 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 Agent 的通用 SKILL（Claude Code、Gemini、Codex 等）
skills/hasha2a/references/core.md	工具、端点、定价、资产和支付渠道参考
docs/ai-prompts.md	供 Agent 复制粘贴的 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 — 随意使用、分叉，也可用它出售数据。