security

用途

Security 是 Trust Wallet 提供的 Agent Skill，用于在与钱包地址或代币交互前进行安全校验与风险分析。其核心目标是：在交易前判断地址是否安全、代币是否存在风险信号，从而降低交互恶意地址或问题代币的风险。

主要能力

1. 地址校验

通过 GET /v1/validate 校验钱包地址或交易的安全风险。

查询参数：

address（字符串，必填）：待校验的地址。
asset_id（字符串，选填）：用于提供上下文的资产 ID，例如以太坊为 c60。
type（字符串，选填）：校验类型，可选 address、transaction。

示例请求：

GET /v1/validate?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&asset_id=c60&type=address

响应示例：

{
  "valid": true,
  "result": "whitelist",
  "details": {
    "is_contract": false,
    "is_sanctioned": false,
    "risk_score": 0,
    "labels": []
  }
}

result 取值含义：

取值	含义
whitelist	已知安全地址
neutral	无风险信号
blacklist	已知恶意地址
unknown	数据不足

2. 代币风险检查

通过 GET /v2/coinstatus/{assetId} 检查代币的安全与风险信息，包括蜜罐检测、审计状态、冻结权限等。

路径参数：

assetId（字符串，必填）：资产 ID，例如 ERC-20 的 c60_t0xA0b8...，Solana 的 c501。

查询参数：

version（字符串，选填）：API 版本，使用 2。
platform（字符串，选填）：平台标识。
include_security_info（布尔，选填）：是否包含 EVM 安全数据，默认 true。
include_solana_security_info（布尔，选填）：是否包含 Solana 专项安全数据，默认 true。

示例请求：

GET /v2/coinstatus/c60_t0xdAC17F958D2ee523a2206206994597C13D831ec7?version=2&include_security_info=true

响应示例：

{
  "asset_id": "c60_t0xdAC17F958D2ee523a2206206994597C13D831ec7",
  "name": "Tether USD",
  "symbol": "USDT",
  "isActive": true,
  "supportsSwap": true,
  "securityInfo": {
    "riskLevel": "low",
    "isHoneypot": false,
    "hasAudit": true,
    "auditProvider": "OpenZeppelin",
    "hasMintFunction": true,
    "canTakeBackOwnership": false,
    "isTradingCooldown": false,
    "warnings": []
  }
}

对 Solana 代币，响应包含 solanaSecurityInfo：

{
  "solanaSecurityInfo": {
    "riskLevel": "medium",
    "hasFreezeAuthority": true,
    "hasMintAuthority": true,
    "isInitialized": true,
    "warnings": ["Token has active freeze authority"]
  }
}

风险等级取值：low、medium、high、critical、unknown。

EVM 安全字段：

字段	类型	说明
riskLevel	string	总体风险等级
isHoneypot	boolean	买入后无法卖出
hasAudit	boolean	智能合约是否经过审计
auditProvider	string	审计机构名称
hasMintFunction	boolean	代币供应量是否可增加
canTakeBackOwnership	boolean	放弃所有权后所有者能否收回
isTradingCooldown	boolean	买入后是否有交易限制
warnings	string[]	可读的风险警告

Solana 安全字段：

字段	类型	说明
riskLevel	string	总体风险等级
hasFreezeAuthority	boolean	代币账户是否可被冻结
hasMintAuthority	boolean	供应量是否可增加
isInitialized	boolean	代币程序是否已初始化
warnings	string[]	可读的风险警告

使用方式

基础地址：https://tws.trustwallet.com。

鉴权方式：HMAC-SHA256（具体配置步骤暂未提供）。

调用流程为：先构造请求地址，携带 HMAC-SHA256 鉴权信息，再调用上述两个接口之一，解析返回的 result、riskLevel、warnings 及各项安全字段进行判断。

适用场景

在向某地址转账或与之交互前，校验该地址是否为已知安全、无风险信号或恶意地址。
在买入、兑换或持有某代币前，检查其是否存在蜜罐、未审计、可增发、可冻结等风险信号。
对 EVM 与 Solana 两类链上资产分别获取对应的安全信息。

限制

鉴权的具体设置步骤在已有资料中暂未提供。
platform 参数的具体取值未在资料中给出。
除 low、medium、high、critical、unknown 风险等级与所列字段外，其他字段含义、接口速率限制、计费与价格信息暂未提供。
地址校验结果中的 labels 字段具体取值未在资料中说明。

技能介绍

用途

主要能力

使用方式

适用场景

限制