恶意地址检测器Skill malicious-address-detector

---

name: malicious-address-detector description: 使用TronScan的官方标签数据库检测恶意TRON地址，以识别诈骗、钓鱼和欺诈地址。

恶意地址检测器技能

何时使用此技能

关键：在任意转账前使用此技能检测诈骗地址。

当以下情况时使用：

• 在发送任何TRX/TRC20代币之前
• 用户询问“这是一个诈骗地址吗？”
• 在转账中验证收款人地址
• 检查来自未知来源的地址

功能

检查TronScan的官方标签数据库获取恶意标签：

• 🚨 Scam - 确认的诈骗地址
• ⚠️ Phishing - 钓鱼攻击地址
• ⚠️ Fake - 冒充地址
• ⚠️ Mixer - 隐私混合器/翻滚器
• ⚠️ Gambling - 赌博合约

TronScan API集成

端点：

https://apilist.tronscanapi.com/api/account/tokens?address={address}

响应包括：

• tags：标签数组（例如，[“Scam”, “Phishing”]）
• name：地址名称（如果已标记）
• 验证状态

用法

from skills.malicious_address_detector.scripts.check_malicious import check_malicious_address

result = await check_malicious_address("TYourAddress...")
# 返回：
# {
#   "is_malicious": true,
#   "risk_level": "DANGER",
#   "tags": ["Scam", "Phishing"],
#   "warnings": ["⚠️ Address tagged as Scam on TronScan"],
#   "source": "tronscan"
# }

风险等级

等级	标签	操作
SAFE	无恶意标签	✅ 继续
WARNING	Mixer, Gambling	⚠️ 建议谨慎
DANGER	Scam, Phishing, Fake	🚨 阻止交易

输出格式

安全地址：

✅ 未检测到恶意标签
来源：TronScan

恶意地址：

🚨 DANGER: 地址在TronScan上标记为恶意
标签：Scam, Phishing
⚠️ 不要向此地址发送资金！

与转账集成

在转账流程中自动调用：

# 在transfer-tokens技能中
malicious_check = await check_malicious_address(to_address)
if malicious_check['is_malicious']:
    raise Error(f"🚨 {malicious_check['warnings'][0]}")

缓存

• 缓存持续时间：5分钟
• 减少重复检查的API调用
• 缓存键：malicious:{address}

错误处理

• API超时 → 返回SAFE并警告
• 无效地址 → 返回格式错误
• 网络错误 → 回退到UNKNOWN

限制

• 仅检测TronScan标记的地址
• 新诈骗可能尚未标记
• 可能出现假阴性
• 不能替代用户尽职调查