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 上の USDC で x402 決済
• キャッシュ — (chain, address) ごとに 24 時間
• モード — インバウンドのみ。デフォルトで ENABLE=true

このシムはブローカーです。観測データを返します。お客様に代わってブロック、凍結、決済を行うことはなく、規制対象の KYC／AML プロバイダーに代わるものでもありません。

エンドポイント

メソッド	パス	料金	用途
POST	/v1/aml/screen	0.03 ドル	1 つのアドレスをスクリーニング
POST	/v1/aml/bulk	アドレスあたり 0.025 ドル（最低 10 件）	複数のアドレスを 1 回の呼び出しでスクリーニング
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 チェーンでは、シムは getTransactionCount、getCode、getBalance、getBlockNumber の 4 つの Base RPC を実際に読み取り、さらに過去のブロックを二分探索してウォレットの最初期のアクティビティを推定します。flags で返される分類は次のとおりです。

分類	重大度	条件
ofac_sdn_match	critical	アドレスが毎日更新される OFAC SDN リストに含まれている
mixer_contract	high	アドレスが既知のミキサー／制裁対象プロトコルのコントラクトである
very_new_wallet	medium	オンチェーンでの最初のアクティビティが 24 時間以内
high_velocity	medium	ウォレットの全期間で、1 時間あたりの送信 tx が 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 以外のチェーンでは、chain_detail の note とともに SDN の一致シグナルのみが返されます。

設定

環境変数	デフォルト	用途
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	(空)	フラグ付けする追加のミキサーコントラクトアドレスをカンマ区切りで指定
X402_BYPASS	(未設定)	開発時に決済を回避するには、任意の値を設定

永続化

WAL ジャーナリングを使用する /tmp/aml.db の SQLite。

• ofac_sdn — (address PK, sdn_uid, sdn_name, program, list_type, inserted_at) — 更新のたびに消去して再挿入
• ofac_meta — 更新日時、件数、バイトサイズ、直近のエラー
• screenings — 課金済みまたはキャッシュ済みを問わず、すべてのスクリーニング呼び出し
• cache — (chain:address) → JSON payload、有効期間は24時間

運用上の注意

• OFAC リストは起動時と、その後24時間ごとに更新されます
• キャッシュエントリーは1時間ごとに整理されます
• JSON リクエストの本文サイズ上限は256 KBです
• インバウンドのみです。この shim が開始するアウトバウンド通信は、OFAC の取得と Base RPC の読み取りに限られます

ライセンス

MIT — LICENSE を参照してください。

Hive Civilization Directory

エージェントネイティブな金融インフラである Hive Civilization の一部です。

• エンドポイントディレクトリ：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