---

name: misttrack-skills description: 使用 MistTrack OpenAPI 进行加密货币地址风险分析、AML 合规检测和交易追踪。MistTrack 是由 SlowMist 开发的反洗钱追踪工具，支持 BTC、ETH、TRX、BNB 等主流链上地址与交易的风险评分、标签查询、交易调查等功能。

MistTrack OpenAPI 技能

概述

MistTrack 是由 SlowMist 开发的加密货币反洗钱（AML）追踪工具，专注于打击加密货币洗钱活动。

• 收录超过 4 亿个地址（涵盖主要交易平台的各类钱包）
• 提供 50 万条威胁情报地址
• 标记超过 9000 万个与恶意活动相关的地址

API 基本信息

Base URL

https://openapi.misttrack.io

认证方式

所有请求均需在 Query Parameter 中传入 api_key（GET 请求）或 Request Body（POST 请求）。

通用响应结构

字段	类型	说明
success	Boolean	请求是否成功
msg	String	失败时的错误信息
data	Dictionary	响应数据

速率限制（Rate Limits）

套餐	速率	每日限额
Standard	1 次/秒/key	10,000 次/天/key
Compliance	5 次/秒/key	50,000 次/天/key
Enterprise	无限制	无限制

超出限制时返回：

{"success": false, "msg": "ExceededDailyRateLimit", "retry_after": 12345}
{"success": false, "msg": "ExceededRateLimit", "retry_after": 1}

---

常见错误码

HTTP 状态码	原因	解决方案
402	MistTrack 订阅已过期	登录并续订
429	请求速度过快	参考速率限制指南控制请求频率
500	服务端错误	稍后重试

错误消息（msg 字段）

msg 值	说明
ExceededRateLimit	超过每秒速率限制
ExceededDailyRateLimit	超过每日速率限制
InvalidApiKey	API Key 无效
UnsupportedToken	不支持的代币
InvalidAddress	无效地址
PageNotFound	页面未找到
ExpiredPlan	套餐已过期
TaskNotFound	任务不存在（需先创建）
UnsupportedAddressType	不支持的地址类型（如热钱包地址）

---

多链支持

MistTrack 支持以下区块链及代币：

• Bitcoin: BTC
• Ethereum: ETH, USDT-ERC20, USDC-ERC20, WETH-ERC20, PEPE-ERC20, SHIB-ERC20, DAI-ERC20 等
• TRON: TRX, USDT-TRC20, USDC-TRC20, USDD-TRC20
• BNB Smart Chain: BNB, USDT-BEP20, BUSD-BEP20, ETH-BEP20 等
• Polygon: POL-Polygon, USDT-Polygon, USDC-Polygon, WETH-Polygon 等
• Arbitrum One: ETH-Arbitrum, USDT-Arbitrum, USDC-Arbitrum 等
• OP Mainnet: ETH-Optimism, USDT-Optimism, USDC-Optimism 等
• Base: ETH-Base, USDC-Base, USDT-Base 等
• Avalanche: AVAX-Avalanche, USDT-Avalanche, USDC-Avalanche 等
• zkSync Era: ETH-zkSync, ZK-zkSync, USDT-zkSync, USDC-zkSync
• Toncoin: TON, USDT-TON
• Solana: SOL, USDT-Solana, USDC-Solana, Bonk-Solana 等
• Litecoin: LTC
• Dogecoin: DOGE
• Bitcoin Cash: BCH
• Merlin Chain: BTC-Merlin
• HashKey Chain: HSK
• Sui: SUI, wUSDT-SUI, USDC-SUI
• IoTeX: IOTX

完整代币列表请调用 /v1/status 接口获取。

---

API 端点列表

1. 获取 API 状态 (v1/status)

功能：返回 API 状态及支持的代币列表。

GET https://openapi.misttrack.io/v1/status

请求参数：无

响应示例：

{
  "success": true,
  "msg": "",
  "data": {
    "support_api": ["status", "address_labels", "risk_score", "transactions_investigation", "address_overview", "address_action", "address_trace"],
    "support_coin": ["ETH", "USDT-ERC20", "BTC", "TRX", "USDT-TRC20", "..."]
  }
}

---

2. 获取地址标签 (v1/address_labels)

功能：返回指定地址的标签列表，包括实体名称、地址类型、链上标签、链下标签等。

GET https://openapi.misttrack.io/v1/address_labels?coin=ETH&address={address}&api_key={api_key}

请求参数：

参数	类型	必填	说明
coin	string	✅	查询的代币（如 ETH、BTC、TRX）
address	string	✅	查询的地址
api_key	string	✅	API 密钥

响应字段：

字段	类型	说明
label_list	list	地址标签列表，包含实体名称（如 Coinbase、Binance）、地址类型（deposit/hot/cold wallet）、链上标签（ENS、MEV Bots、DeFi Whales）、链下标签（MetaMask Wallet User、Twitter handle）
label_type	string	地址类型分类：exchange（中心化交易所、支付平台）/ defi（DeFi 项目、跨链桥）/ mixer（混币器或无 KYC 即时兑换）/ nft（NFT 市场）/ 空字符串（未分类）

响应示例：

{
  "success": true,
  "msg": "",
  "data": {
    "label_list": ["Binance", "hot"],
    "label_type": "exchange"
  }
}

---

3. 获取地址概览 (v1/address_overview)

功能：返回指定地址的余额及统计数据。

GET https://openapi.misttrack.io/v1/address_overview?coin=ETH&address={address}&api_key={api_key}

请求参数：

参数	类型	必填	说明
coin	string	✅	查询的代币
address	string	✅	查询的地址
api_key	string	✅	API 密钥

响应字段：

字段	类型	说明
balance	float(4)	地址余额
txs_count	int	总交易数
first_seen	int	首次交易时间（Unix 时间戳）
last_seen	int	最近交易时间（Unix 时间戳）
total_received	float(4)	总接收金额
total_spent	float(4)	总支出金额
received_txs_count	int	接收交易总数
spent_txs_count	int	发出交易总数

响应示例：

{
  "success": true,
  "msg": "",
  "data": {
    "balance": 49.8305,
    "txs_count": 1231,
    "first_seen": 1441800674,
    "last_seen": 1670971955,
    "total_received": 916204.8697,
    "total_spent": 916151.0499,
    "received_txs_count": 1018,
    "spent_txs_count": 213
  }
}

---

4. 获取风险评分 - 同步模式 (v2/risk_score)

功能：返回指定地址或交易哈希的 AML 风险评分及风险详情（KYT/KYA）。

⚠️ 注意：风险评分基于地址的所有相关交易计算，因此同一地址下所有代币会获得相同的评分。

GET https://openapi.misttrack.io/v2/risk_score?coin=ETH&address={address}&api_key={api_key}

请求参数：

参数	类型	必填	说明
coin	string	✅	查询的代币
address	string	与 txid 二选一	查询的地址
txid	string	与 address 二选一	查询的交易哈希
api_key	string	✅	API 密钥

address 和 txid 只传其中一个，不能同时传。

响应字段：

字段	类型	说明
score	int	风险评分，范围 3~100
hacking_event	string	相关安全事件名称
detail_list	list	风险描述列表
risk_level	string	风险级别：Low / Moderate / High / Severe
risk_detail	list	风险评分计算详情
risk_report_url	string	MistTrack AML 风险报告 PDF 链接

risk_detail 子字段：

字段	类型	说明
entity	string	风险实体名称（如 garantex.io）
risk_type	string	风险类型：sanctioned_entity / illicit_activity / mixer / gambling / risk_exchange / bridge
exposure_type	string	暴露类型：direct（直接） / indirect（间接）
hop_num	int	到风险实体的跳数（≥1）
volume	float	与风险实体的交易总额（USD）
percent	float	占总交易额的百分比

风险描述（detail_list 可能的值）

描述	含义
Malicious Address	直接参与恶意事件的地址（如 DeFi 攻击者、黑客、被制裁地址）
Suspected Malicious Address	与恶意事件相关的地址
High-risk Tag Address	高风险实体地址（如混币器、某些嵌套交易所）
Medium-risk Tag Address	中风险实体地址（如赌博平台、无 KYC 交易所）
Mixer	混币器地址（如 Tornado Cash）
Sanctioned Entity	被制裁实体地址（如 garantex）
Risk Exchange	无 KYC 要求的交易所
Gambling	赌博平台地址
Involved Theft Activity	参与盗窃事件的地址
Involved Ransom Activity	参与勒索事件的地址
Involved Phishing Activity	参与钓鱼事件的地址
Involved Illicit Activity	参与非法活动的地址（如洗钱）
Interact With Malicious Address	与恶意地址有交互
Interact With Suspected Malicious Address	与疑似恶意地址有交互
Interact With High-risk Tag Address	与高风险地址有交互
Interact With Medium-risk Tag Addresses	与中风险地址有交互

风险级别指南

风险级别	分数范围	建议操作
Severe	91~100	禁止提现和交易，立即上报地址
High	71~90	高度监控，通过 MistTrack AML 平台或 OpenAPI 进行交易分析
Moderate	31~70	需要适度监管
Low	0~30	最低监管要求

响应示例：

{
  "success": true,
  "msg": "",
  "data": {
    "score": 35,
    "hacking_event": "",
    "detail_list": ["Involved Illicit Activity", "Interact With High-risk Tag Address"],
    "risk_level": "Moderate",
    "risk_detail": [
      {
        "entity": "huionepay",
        "risk_type": "sanctioned_entity",
        "volume": 6700352.55,
        "hop_num": 2,
        "exposure_type": "indirect",
        "percent": 3.419
      }
    ],
    "risk_report_url": "https://light.misttrack.io/riskReport/0x..."
  }
}

---

5. 获取风险评分 - 异步模式 (v2/risk_score_create_task & v2/risk_score_query_task)

功能：以异步方式获取地址或交易的风险评分（适用于大批量查询场景）。

5.1 创建任务 (v2/risk_score_create_task)

POST https://openapi.misttrack.io/v2/risk_score_create_task
Content-Type: application/json

请求 Body：

参数	类型	必填	说明
coin	string	✅	查询的代币
address	string	与 txid 二选一	查询的地址
txid	string	与 address 二选一	查询的交易哈希
api_key	string	✅	API 密钥

cURL 示例：

curl --location 'https://openapi.misttrack.io/v2/risk_score_create_task' \
  --header 'Content-Type: application/json' \
  --data '{
    "address": "TNXoiAJ3dct8Fjg4M9fkLFh9S2v9TXc32G",
    "coin": "TRX",
    "api_key": "YourApiKey"
  }'

响应字段：

字段	类型	说明
has_result	bool	是否已有缓存结果
scanned_ts	int	任务结果生成时间戳

• Cache Miss（has_result: false）：等待 1-10 秒后调用 v2/risk_score_query_task
• Cache Hit（has_result: true）：立即调用 v2/risk_score_query_task

5.2 查询任务结果 (v2/risk_score_query_task)

⚠️ 此接口无速率限制。

GET https://openapi.misttrack.io/v2/risk_score_query_task?coin=ETH&address={address}&api_key={api_key}

请求参数：与创建任务接口相同。

响应：

• 任务未完成：{"success": true, "msg": "TaskUnderRunning"}
• 任务完成：与同步 v2/risk_score 响应结构相同（含 score、risk_level、detail_list、risk_detail）

---

6. 交易调查 (v1/transactions_investigation)

功能：返回指定地址的交易调查结果，包含转入/转出交易列表及关联地址信息。

GET https://openapi.misttrack.io/v1/transactions_investigation?coin=ETH&address={address}&api_key={api_key}

请求参数：

参数	类型	必填	说明
coin	string	✅	查询的代币
address	string	✅	查询的地址
api_key	string	✅	API 密钥
start_timestamp	int	❌	开始时间戳（默认为 0）
end_timestamp	int	❌	结束时间戳（默认为当前时间）
type	string	❌	查询类型：in、out、all（默认 all）
page	int	❌	页码（默认为 1）

响应字段：

字段	类型	说明
in	list	转入交易列表
out	list	转出交易列表
page	int	当前页码
total_pages	int	总页数
transactions_on_page	int	当前页交易数量（最多 1000 条）

交易条目子字段：

字段	类型	说明
address	string	与查询地址有转账关系的地址
type	int	地址类型：1=EOA/BTC地址，2=恶意地址，3=实体标签地址，4=合约地址
tx_hash_list	list	相关交易哈希列表
amount	float(4)	总转账金额
label	string	地址标签详情

响应示例：

{
  "success": true,
  "msg": "",
  "data": {
    "out": [
      {
        "address": "0xd90e2f925da726b50c4ed8d0fb90ad053324f31b",
        "tx_hash_list": ["0x48c2601b..."],
        "amount": 743,
        "type": 3,
        "label": "Tornado.Cash: Router"
      }
    ],
    "in": [...],
    "page": 1,
    "total_pages": 1,
    "transactions_on_page": 36
  }
}

---

7. 地址行为分析 (v1/address_action)

功能：返回指定地址的交易行为分析结果（适合以饼图方式展示）。

GET https://openapi.misttrack.io/v1/address_action?coin=ETH&address={address}&api_key={api_key}

请求参数：

参数	类型	必填	说明
coin	string	✅	查询的代币
address	string	✅	查询的地址
api_key	string	✅	API 密钥

响应字段：

字段	类型	说明
received_txs	list	转入交易行为分析结果列表
spent_txs	list	转出交易行为分析结果列表

行为条目子字段：

字段	类型	说明
action	string	行为类型（如 DEX、Exchange、Mixer、Transfer、Swap）
count	int	该类型交易数量
proportion	float	占比（百分比）

响应示例：

{
  "success": true,
  "msg": "",
  "action_dic": {
    "received_txs": [
      {"action": "DEX", "count": 7, "proportion": 70.0},
      {"action": "Mixer", "count": 1, "proportion": 10.0},
      {"action": "Exchange", "count": 1, "proportion": 10.0},
      {"action": "Swap", "count": 1, "proportion": 10.0}
    ],
    "spent_txs": [
      {"action": "Exchange", "count": 15, "proportion": 57.69},
      {"action": "DEX", "count": 2, "proportion": 7.69},
      {"action": "Transfer", "count": 9, "proportion": 34.62}
    ]
  }
}

---

8. 地址画像 / 地址追踪 (v1/address_trace)

功能：追踪地址与哪些平台有过交互（交易所、混币器、DeFi 协议、NFT 平台），识别相关恶意事件，并提供地址附加信息（使用的钱包、ENS 名称、关联 Twitter 账号）。

GET https://openapi.misttrack.io/v1/address_trace?coin=ETH&address={address}&api_key={api_key}

请求参数：

参数	类型	必填	说明
coin	string	✅	查询的代币
address	string	✅	查询的地址
api_key	string	✅	API 密钥

响应字段：

字段	类型	说明
first_address	string	Gas 费用的来源钱包地址或其标签
use_platform	dict	交互平台信息，包含 exchange（交易所）、dex（DEX）、mixer（混币器）、nft（NFT 平台）
malicious_event	dict	恶意事件信息，包含 phishing（钓鱼）、ransom（勒索）、stealing（盗窃）、laundering（洗钱）
relation_info	dict	关联信息，包含 wallet（关联钱包）、ens（ENS 名称）、twitter（Twitter 账号）

响应示例：

{
  "success": true,
  "msg": "",
  "data": {
    "first_address": "sideshift.ai",
    "use_platform": {
      "exchange": {"count": 1, "exchange_list": ["Binance"]},
      "dex": {"count": 3, "dex_list": ["Uniswap", "SushiSwap", "Multichain"]},
      "mixer": {"count": 2, "mixer_list": ["Tornado.Cash", "sideshift.ai"]},
      "nft": {"count": 0, "nft_list": []}
    },
    "malicious_event": {
      "phishing": {"count": 0, "phishing_list": []},
      "ransom": {"count": 0, "ransom_list": []},
      "stealing": {"count": 5, "stealing_list": ["MMFinance Exploiter"]},
      "laundering": {"count": 0, "laundering_list": []}
    },
    "relation_info": {
      "wallet": {"count": 0, "wallet_list": []},
      "ens": {"count": 2, "ens_list": ["destruction.eth", "poma.eth"]},
      "twitter": {"count": 1, "twitter_list": ["@destructioneth"]}
    }
  }
}

---

9. 地址交易对手分析 (v1/address_counterparty)

功能：返回指定地址的交易对手分析结果（适合以饼图方式展示）。

⚠️ 注意：此接口不支持分析热钱包地址，会返回 UnsupportedAddressType 错误。

GET https://openapi.misttrack.io/v1/address_counterparty?coin=ETH&address={address}&api_key={api_key}

请求参数：

参数	类型	必填	说明
coin	string	✅	查询的代币
address	string	✅	查询的地址
api_key	string	✅	API 密钥

响应字段：

字段	类型	说明
address_counterparty_list	list	交易对手列表

交易对手条目子字段：

字段	类型	说明
name	string	实体名称（如 Uniswap、Tornado.Cash、Binance）
amount	float	总交易金额（USD）
percent	float	占比（百分比）

响应示例：

{
  "success": true,
  "msg": "",
  "address_counterparty_list": [
    {"name": "Uniswap", "amount": 4496524.699, "percent": 49.678},
    {"name": "Tornado.Cash", "amount": 2377637.58, "percent": 26.268},
    {"name": "Binance", "amount": 302.008, "percent": 0.003}
  ]
}

---

使用示例

场景 1：快速地址风险检测（KYT）

当需要对提币/充值地址进行快速 AML 检查时：

1. 调用 v2/risk_score 获取风险评分
2. 根据 risk_level 决策：
   • Severe (91-100)：拒绝交易并上报
   • High (71-90)：需人工复核
   • Moderate (31-70)：适度监控
   • Low (0-30)：正常放行

场景 2：批量异步风险检测

当需要批量检测大量地址时使用异步模式：

1. 循环调用 POST v2/risk_score_create_task 创建任务
2. 等待 1-10 秒（如 has_result: false）
3. 调用 GET v2/risk_score_query_task 轮询结果（无速率限制）

场景 3：地址完整画像调查

对可疑地址进行全面调查时，建议依次调用：

1. v1/address_labels → 了解地址实体身份
2. v1/address_overview → 了解地址活跃度和资产规模
3. v2/risk_score → 获取 AML 风险评分
4. v1/address_trace → 了解地址平台交互历史及关联信息
5. v1/transactions_investigation → 深入分析具体交易流向
6. v1/address_counterparty → 分析主要交易对手构成

---

示例脚本

参考 scripts/ 目录中的示例脚本：

• risk_check.py - 单地址风险评分检查
• batch_risk_check.py - 批量异步风险评分
• address_investigation.py - 地址完整调查

---

与 Bitget Wallet Skill 集成 — 转账地址安全检测

适用场景：当 Agent 同时加载了 bitget-wallet-skill 和 misttrack-skills 时，在执行任何转账 / Swap 操作前，必须自动调用本技能对目标地址（recipient / to-address） 进行 AML 风险检测。

为什么需要地址级安全检测？

bitget-wallet-skill 的 Pre-Trade Workflow 已覆盖代币安全（蜜罐、税率、流动性），但未检测收款方地址的 AML 风险。向被制裁地址、混币器出金地址或黑客钱包转账可能导致：

• 资产被链上追踪机构标记
• 触犯 OFAC 制裁合规要求
• 资金被交易所冻结（如目标是洗钱中转地址）

misttrack-skills 专门填补这一缺口。

---

链代码映射表

将 bitget-wallet-skill 的 chain 参数映射为 MistTrack coin 参数：

bitget-wallet-skill chain	MistTrack coin	说明
eth	ETH	Ethereum 原生代币
sol	SOL	Solana 原生代币
bnb	BNB	BNB Chain 原生代币
trx	TRX	TRON 原生代币
base	ETH-Base	Base 链 ETH
arbitrum	ETH-Arbitrum	Arbitrum 链 ETH
optimism	ETH-Optimism	OP Mainnet ETH
matic	POL-Polygon	Polygon 链原生代币
ton	TON	TON 链原生代币
suinet	SUI	Sui 链原生代币

稳定币注意：若转账代币为 USDT/USDC（非原生代币），MistTrack 风险评分对地址是全局计算的（与代币无关），因此使用原生代币的 coin 参数查询即可。

---

决策逻辑

MistTrack 风险等级	分数范围	Agent 决策	操作
Low	0–30	✅ ALLOW	静默通过，正常继续转账流程
Moderate	31–70	⚠️ WARN	向用户展示风险摘要，请求二次确认后方可继续
High	71–90	⚠️ WARN	向用户展示详细风险报告，强烈建议取消，需明确二次确认
Severe	91–100	❌ BLOCK	拒绝执行转账，告知用户目标地址存在严重风险

特例 — 已认证白名单地址：若 v1/address_labels 返回的 label_type 为 exchange（如 Binance、Coinbase 充值地址），且 risk_level 为 Low 或 Moderate，可直接 ALLOW，无需二次确认。

---

Agent 集成工作流

Agent 在执行 swap-calldata 或任何转账指令之前，自动执行以下步骤（对用户透明，不中断流程）：

转账安全检测流程（Agent 后台自动执行）：

1. 提取目标地址（swap --to-address 或用户指定的收款地址）
2. 识别链类型（通过上方映射表 chain → coin）
3. 调用风险评分脚本：
   python3 scripts/transfer_security_check.py --address <to_address> --chain <chain_code>

4. 读取 exit code 和 JSON 输出，按决策逻辑处理：
   - exit 0 (ALLOW)  → 静默继续，在最终确认摘要中显示 "✅ 收款地址安全"
   - exit 1 (WARN)   → 暂停，向用户显示风险摘要，等待用户明确确认
   - exit 2 (BLOCK)  → 终止流程，向用户说明原因，建议放弃转账
   - exit 3 (ERROR)  → API 不可用，显示 "⚠️ 地址安全检测失败（原因：...）"，由用户决定是否继续

集成到 bitget-wallet-skill Pre-Trade Workflow

在原有 bitget-wallet-skill 的 Pre-Trade Workflow 基础上，插入第 0 步：

0. transfer-security  → 检测收款地址 AML 风险（新增，使用 misttrack-skills）
1. security           → 检查代币安全（honeypot、tax）
2. token-info         → 获取价格、市值
3. liquidity          → 检查池深度
4. swap-quote         → 获取报价和路由

---

调用示例

基础调用（推荐 Agent 使用）

# ETH 链地址检测
python3 scripts/transfer_security_check.py \
  --address 0xd90e2f925DA726b50C4Ed8D0Fb90Ad053324F31b \
  --chain eth

# Solana 链地址检测
python3 scripts/transfer_security_check.py \
  --address 5tzFkiKscXHK5B17AoKFdroMRCEVGvSqtPkRSLzprFwN \
  --chain sol

# JSON 输出（便于 Agent 解析）
python3 scripts/transfer_security_check.py \
  --address 0x28C6c06298d514Db089934071355E5743bf21d60 \
  --chain eth --json

JSON 输出格式

{
  "decision": "ALLOW",
  "score": 15,
  "risk_level": "Low",
  "detail_list": [],
  "label_type": "exchange",
  "label_list": ["Binance", "hot"],
  "risk_report_url": "https://light.misttrack.io/riskReport/0x...",
  "address": "0x28C6c06298d514Db089934071355E5743bf21d60",
  "coin": "ETH",
  "chain": "eth"
}

WARN 场景示例输出（展示给用户）

⚠️  收款地址安全警告
────────────────────────────────────
地址：    0xABCD...1234
链：      ETH
风险评分：55 (Moderate)
风险描述：Interact With High-risk Tag Address, Involved Illicit Activity
风险报告：https://light.misttrack.io/riskReport/0xABCD...

建议：该地址存在中等风险，请确认收款方身份后再继续。
是否仍要继续转账？[yes/no]

---

API 不可用时的降级策略

场景	原因	处理方式
MISTTRACK_API_KEY 未设置	未配置	exit 3，警告用户前往设置
InvalidApiKey	Key 无效或过期	exit 3，提示检查 Key
ExceededDailyRateLimit	超出每日限额	exit 3，提示次日重试或升级套餐
网络超时	网络问题	exit 3，重试 1 次后放弃

重要：任何 exit 3 情况下，Agent 必须明确告知用户「地址安全检测失败，无法验证收款地址风险」，并让用户决定是否继续。不得静默忽略检测失败。

---

与 Trust Wallet Skills 集成 — 转账地址安全检测

适用场景：当 Agent 同时加载了 tw-agent-skills（wallet-core 或 trust-web3-provider）和 misttrack-skills 时，在生成任何含收款地址的代码之前，必须自动调用本技能进行 AML 风险检测。

Trust Wallet Skills 的转账场景

Trust Wallet skills 是开发者库（非命令行工具），收款地址通过代码字段传入：

技能	场景	收款地址字段
wallet-core	Swift/Kotlin/TS 签名交易	toAddress（ETH/BTC/Cosmos sendCoinsMessage）
trust-web3-provider	EthereumProvider handler	eth_sendTransaction.to
trust-web3-provider	TonProvider	ton_sendTransaction.to
trust-web3-provider	BitcoinProvider	signPSBT outputs 中的目标地址
trust-web3-provider	TronProvider	sign(transaction) 的目标地址字段

CoinType → MistTrack coin 映射表

wallet-core CoinType	--chain 参数	MistTrack coin
.ethereum	eth	ETH
.bitcoin	bitcoin / btc	BTC
.solana	solana / sol	SOL
.smartChain	smartchain / bsc	BNB
.tron	tron / trx	TRX
.polygon	polygon / matic	POL-Polygon
.ton	ton / tonchain	TON
.cosmos	cosmos / atom	⛔ 不支持，exit 3
.aptos	aptos	⛔ 不支持，exit 3

trust-web3-provider 链映射：EthereumProvider chainId 0x1→eth，0x38→bnb，0x89→polygon，0xa→optimism，0xa4b1→arbitrum，0x2105→base。

Agent 触发规则

Agent 在以下任意时刻应自动调用安全检测：

wallet-core 场景

当 Agent 生成含 toAddress 的签名代码片段时，在给出代码前先检查该地址：

# 示例：用户请求为 Bitcoin 地址生成签名，先检查目标地址
python3 scripts/transfer_security_check.py \
  --address 1MityqAKBEKHPkBpwDCqPMBNbYPxbNbKzr \
  --chain bitcoin --json

# 示例：用户构建 Ethereum 转账，先检查 toAddress
python3 scripts/transfer_security_check.py \
  --address 0xRecipient... \
  --chain eth --json

trust-web3-provider 场景

当 Agent 帮开发者实现处理 eth_sendTransaction / ton_sendTransaction 的 handler 时，在处理逻辑中插入检测点：

# Handler 收到 eth_sendTransaction，目标地址在 params.to
python3 scripts/transfer_security_check.py \
  --address <params.to> --chain eth --json

# Handler 收到 ton_sendTransaction
python3 scripts/transfer_security_check.py \
  --address <params.to> --chain ton --json

决策规则（与 Bitget Wallet 集成相同）

exit	决策	Agent 行为
0	✅ ALLOW	正常生成代码，确认摘要中添加「✅ 收款地址安全」注释
1	⚠️ WARN	向用户展示风险详情，等待明确确认后再生成代码
2	❌ BLOCK	拒绝生成相关代码，向用户说明风险并建议更换地址
3	⚠️ ERROR	通知用户检测失败原因（API 不可用/链不支持），由用户决定是否继续

不支持的链处理

Aptos 和 Cosmos/ATOM 目前 MistTrack 尚未收录，脚本会返回 exit 3 并给出说明：

$ python3 scripts/transfer_security_check.py --address 0xabc --chain aptos --json
{
  "decision": "ERROR",
  "error": "MistTrack 暂不支持 Aptos (APT) 链地址查询。请人工核实收款方身份。"
}
# exit code: 3

Agent 对此类 exit 3 应向用户说明「该链暂无自动安全检测，请通过其他方式核实收款方身份」。

---

参考资料

• MistTrack 官方文档
• MistTrack OpenAPI 概述
• MistTrack 控制台
• 常见错误消息
• Bitget Wallet Skill
• Trust Wallet tw-agent-skills