Hive Aml Screen

hive-mcp-aml-screen

A2A 网络的 AML 筛查经纪服务。发送一个地址和一条链，即可获得 0–100 的观察性风险评分、OFAC SDN 匹配标记和链上启发式类别。缓存时间为 24 小时。

Hive 不会拦截、冻结或结算。 这仅提供观察性 AML 数据。客户需自行负责合规决策。

• 数据源 — 每日刷新的 OFAC SDN 名单（treasury.gov）、实时 Base 主网 RPC 读取，以及保守的混币器合约种子列表
• 评分 — 0–100 分，对应等级（minimal、low、medium、high、critical）
• 定价 — 单个地址 $0.03，批量筛查每个地址 $0.025（至少 10 个地址），通过 Base 上的 x402 以 USDC 结算
• 缓存 — 每个 (chain, address) 缓存 24 小时
• 模式 — 仅入站，默认 ENABLE=true

该 shim 是一个经纪服务，会返回观察性数据。它绝不会代表客户拦截、冻结或结算，也绝不会取代受监管的 KYC/AML 服务提供商。

端点

方法	路径	费用	用途
POST	/v1/aml/screen	$0.03	筛查单个地址
POST	/v1/aml/bulk	$0.025/地址（至少 10 个）	在一次调用中筛查多个地址
GET	/v1/aml/today	免费	UTC 当日计数器和 OFAC 名单状态
GET	/health	免费	存活状态、OFAC 名单状态、定价
POST	/mcp	—	MCP 客户端的 JSON-RPC 2.0 入口
GET	/.well-known/mcp.json	免费	MCP 描述文件
POST	/v1/x402/submit	—	结算 402 报价并签发访问令牌

MCP 工具

工具	费用	描述
aml_screen	$0.03	筛查单个地址
aml_bulk_screen	$0.025/地址	批量筛查，至少 10 个地址
aml_today	免费	计数器和 OFAC 名单状态

每个响应——无论是 JSON-RPC 还是 REST——都包含免责声明字段：

"disclaimer": "Hive does not block, freeze, or settle. This is observational AML data only. Customer is responsible for compliance decisions."

快速开始

curl -sX POST https://hive-mcp-aml-screen.onrender.com/v1/aml/screen \
  -H 'content-type: application/json' \
  -d '{"address":"0x8589427373d6d84e98730d7795d8f6f8731fda16","chain":"base"}'

首次调用会返回包含报价的 402 信封。在 Base 上使用 USDC 结算，然后将证明重新提交到 /v1/x402/submit 以签发访问令牌，最后携带 X-Hive-Access: <token> 重放请求。

curl -sX POST https://hive-mcp-aml-screen.onrender.com/v1/x402/submit \
  -H 'content-type: application/json' \
  -d '{"nonce":"...","payer":"0x...","chain":"base","tx_hash":"0x..."}'

响应格式

{
  "ok": true,
  "address": "0x8589427373d6d84e98730d7795d8f6f8731fda16",
  "chain": "base",
  "risk_score": 100,
  "risk_band": "critical",
  "flags": [
    {"category": "ofac_sdn_match", "severity": "critical", "detail": "OFAC SDN list match: program=CYBER2 sdn_uid=12345"},
    {"category": "mixer_contract", "severity": "high", "detail": "address is a known mixer/sanctioned-protocol contract"}
  ],
  "sdn_match": true,
  "sdn_record": {"sdn_uid": "12345", "sdn_name": "TORNADO CASH", "program": "CYBER2"},
  "chain_detail": {"nonce": 0, "is_contract": true, "balance_wei": "0", "head_block": 12345678},
  "sources": {
    "ofac_sdn": {"list_size": 8421, "last_refresh_ms": 1745798400000},
    "heuristics": {"chain": "base", "version": "v1"}
  },
  "cache_hit": false,
  "cache_ttl_seconds": 86400,
  "screened_at": 1745875200000,
  "screening_id": "8a3f...",
  "disclaimer": "Hive does not block, freeze, or settle. This is observational AML data only. Customer is responsible for compliance decisions."
}

启发式规则

对于 EVM 链，该 shim 会执行四次真实的 Base RPC 读取——getTransactionCount、getCode、getBalance、getBlockNumber——并通过对历史区块进行二分搜索，估算钱包最早的活动时间。flags 中返回的类别：

类别	严重程度	触发条件
ofac_sdn_match	critical	地址出现在每日 OFAC SDN 名单中
mixer_contract	high	地址是已知混币器或受制裁协议的合约
very_new_wallet	medium	首次链上活动发生在 24 小时内
high_velocity	medium	钱包生命周期内每小时至少发出 20 笔交易
mixer_adjacent_balance	low	余额恰好为 0.1 / 1 / 10 / 100 ETH（Tornado 池面额）
no_outbound_history	low	地址从未在此链上发送过交易
rpc_unavailable	low	RPC 读取失败；仅返回 SDN 信号
heuristic_error	low	启发式规则内部出错；仅返回 SDN 信号

非 EVM 链仅返回 SDN 匹配信号，并在 chain_detail 中附带 note。

配置

环境变量	默认值	用途
PORT	3000	HTTP 端口
ENABLE	true	总开关。设为 false 可通过短路所有付费端点，返回 503
WALLET_ADDRESS	0x15184bf50b3d3f52b60434f8942b7d52f2eb436e	x402 结算接收方（W1 MONROE）
BASE_RPC_URL	https://mainnet.base.org	用于链上判断的 Base 主网 RPC
OFAC_SDN_URL	https://www.treasury.gov/ofac/downloads/sdn.csv	SDN 名单的来源 URL
DB_PATH	/tmp/aml.db	SQLite 数据库文件
MIXER_ADDRESSES	(empty)	要标记的额外混币器合约地址，以逗号分隔
X402_BYPASS	(unset)	设为任意值即可在开发环境中绕过付款

持久化

SQLite 数据库存储于 /tmp/aml.db，使用 WAL 日志记录。

• ofac_sdn — (address PK, sdn_uid, sdn_name, program, list_type, inserted_at) — 每次刷新时先清空，再重新插入
• ofac_meta — 刷新时间戳、数量、字节大小、最近一次错误
• screenings — 每次筛查调用，无论是否计费或命中缓存
• cache — (chain:address) → JSON payload，有效期 24 小时

运维说明

• OFAC 名单在启动时刷新，此后每 24 小时刷新一次
• 缓存条目每小时清理一次
• JSON 请求的请求体大小上限为 256 KB
• 仅处理入站请求——该适配层除获取 OFAC 名单和读取 Base RPC 外，不会发起其他出站调用

许可证

MIT — 详见 LICENSE。

Hive 文明目录

属于 Hive 文明——面向 Agent 的金融基础设施。

• 端点目录：https://thehiveryiq.com
• 实时排行榜：https://hive-a2amev.onrender.com/leaderboard
• 收入仪表板：https://hivemine-dashboard.onrender.com
• 其他 MCP 服务：https://github.com/srotzin?tab=repositories&q=hive-mcp

品牌色：#C08D23