区块链安全扫描专业版

企业级区块链安全扫描工具，支持交易模拟、批量地址检查、多链覆盖、风险报告导出与告警推送，适合DeFi团队与机构用户。

Install

openclaw skills install @thcjp/aegis-security-tool-pro

核心功能: 本技能提供中文交互、化工作流场景等能力。

区块链安全扫描专业版

总览

专业版为DeFi团队、机构交易者和安全审计人员提供企业级区块链安全检查能力。在免费版地址检查与代币检测的基础上,新增交易模拟、批量地址筛查、多链深度扫描、SARIF/HTML报告导出、Webhook实时告警等高级功能。专业版完全兼容免费版接口,已有免费版集成可无缝升级.

专业版核心优势

优势	说明
交易模拟	在链上执行前模拟交易,检测revert、滑点、授权风险
无限额度	不受每日100次限制,支持高频交易场景
批量操作	CSV批量导入地址,一次检查数百个地址
多链覆盖	支持15条链及测试网,覆盖全部主流生态
报告导出	生成SARIF/HTML/PDF格式合规报告
告警推送	Webhook/邮件实时告警,领先时间发现风险
高并发	10 QPS并发能力,满足批量检查需求
优先支持	专属技术支持通道,SLA保障

主要能力

1. 交易模拟(专业版独有)

在发送真实交易前,模拟交易执行过程,检测潜在revert、异常滑点、恶意授权等风险.

输入参数

参数名	类型	必填	说明
input	string	是	区块链安全扫描专业版处理的输入数据或指令
options	object	否	附加配置选项,如模式选择、格式偏好等
callback_url	string	否	异步处理完成后的回调通知URL

bash

curl -s -X POST "https://api.example.com/v1/simulate-tx" \
  -H "Content-Type: application/json" \
  -H "X-Client-Fingerprint: pro-agent-001" \
  -d '{
    "from": "0xYourWalletAddress",
    "to": "0xContractAddress",
    "value": "0",
    "data": "0x095ea7b3000000000000000000000000router0000000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
    "chain_id": 1
  }' | jq

模拟结果包含:

交易是否成功执行
Gas消耗预估
状态变更详情
授权变更检测
潜在风险标记处理: 解析交易模拟(专业版独有)的输入参数,完成核心逻辑,输出标准化响应数据. 输出: 返回交易模拟(专业版独有)的响应数据,含状态码、结果数据和运行日志.

2. 批量地址检查(专业版独有)

通过CSV文件批量导入地址,一次检查数百个地址,适合机构级筛查.

bash

#!/bin/bash
CHAIN_ID=1
INPUT_FILE="addresses.csv"
OUTPUT_FILE="batch_results.json"
echo "[" > "$OUTPUT_FILE"
FIRST=true
while IFS=',' read -r address label; do
    [ -z "$address" ] && continue
    RESULT=$(curl -s -H "X-Client-Fingerprint: pro-batch" \
        "https://api.example.com/v1/check-address/${address}?chain_id=${CHAIN_ID}")
    RISK=$(echo "$RESULT" | jq -r '.risk_level')
    echo "${label} (${address}): ${RISK}"
    if [ "$FIRST" = true ]; then
        FIRST=false
    else
        echo "," >> "$OUTPUT_FILE"
    fi
    echo "$RESULT" | jq --arg label "$label" '{address: .address, risk: .risk_level, label: $label}' >> "$OUTPUT_FILE"
done < "$INPUT_FILE"
echo "]" >> "$OUTPUT_FILE"
echo "批量检查完成,结果已保存至 ${OUTPUT_FILE}"

处理: 解析批量地址检查(专业版独有)的输入参数,完成核心逻辑,输出标准化响应数据. 输出: 返回批量地址检查(专业版独有)的响应数据,含状态码、结果数据和运行日志.

input_params参数控制执行,支持创建/查询/导出

3. 地址信誉查询(兼容免费版)

bash

curl -s -H "X-Client-Fingerprint: pro-agent" \
  "https://api.example.com/v1/check-address/0x742d35Cc6634C0532925a3b844Bc454e4438f44e?chain_id=1&include_history=true" | jq

处理: 解析地址信誉查询(兼容免费版)的输入参数,完成核心逻辑,输出标准化响应数据. 输出: 返回地址信誉查询(兼容免费版)的响应数据,含状态码、结果数据和运行日志.

input_params参数控制执行,支持创建/查询/导出

4. 代币深度检测(兼容免费版增强)

bash

curl -s -H "X-Client-Fingerprint: pro-agent" \
  "https://api.example.com/v1/check-item/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48?chain_id=1&deep_scan=true" | jq

处理: 解析代币深度检测(兼容免费版增强)的输入参数,完成核心逻辑,输出标准化响应数据. 输出: 返回代币深度检测(兼容免费版增强)的响应数据,含状态码、结果数据和运行日志.

input_params参数控制执行,支持创建/查询/导出

5. SARIF报告导出(专业版独有)

生成符合SARIF标准的报告,可直接集成到GitHub代码扫描与CI/CD流水线.

bash

  -H "Content-Type: application/json" \
  -H "X-Client-Fingerprint: pro-agent" \
  -d '{
    "format": "sarif",
    "checks": [
      {"type": "address", "address": "0x742d35Cc...", "chain_id": 1},
      {"type": "token", "address": "0xA0b86991...", "chain_id": 1}
    ]
  }' -o security_report.sarif
echo "SARIF报告已生成: security_report.sarif"

处理: 解析SARIF报告导出(专业版独有)的输入参数,完成核心逻辑,输出标准化响应数据. 输出: 返回SARIF报告导出(专业版独有)的响应数据,含状态码、结果数据和运行日志. 能力覆盖范围：本技能覆盖以下场景：企业级区块链安全、支持交易模拟、批量地址检查、多链覆盖、风险报告导出与告、警推送、DeFi、团队与机构用户、区块链安全扫描专、团队与机构用户提、供全方位链上安全、核心能力、交易模拟、多链深度扫描、SARIF、报告导出、Webhook、高并发、API、适用场景、协议安全审计、机构级交易风控、批量地址筛查、安全门禁、差异化、专业版兼容免费版、新增交易模拟、批量操作与企业级、报告能力、满足合规与规模化、适用关键词、区块链安全、批量扫描、风险报告、blockchain、simulate、batch等.

input_params参数控制执行,支持创建/查询/导出

使用场景

场景一:DeFi协议安全审计

DeFi协议上线前,对涉及的所有合约地址与代币进行全面安全扫描.

bash

#!/bin/bash
PROTOCOL_NAME="MyDeFiProtocol"
CHAIN_ID=1
CONTRACTS=(
    "0xRouter1...|路由合约"
    "0xPool1...|流动性池"
    "0xToken1...|协议代币"
    "0xOracle1...|价格预言机"
)
echo "============================================"
echo "DeFi协议安全审计: ${PROTOCOL_NAME}"
echo "审计时间: $(date -u '+%Y-%m-%dT%H:%M:%SZ')"
echo "============================================"
CRITICAL_COUNT=0
HIGH_COUNT=0
for entry in "${CONTRACTS[@]}"; do
    IFS='|' read -r addr label <<< "$entry"
    ADDR_RESULT=$(curl -s -H "X-Client-Fingerprint: pro-audit" \
xyz/v1/check-address/${addr}?chain_id=${CHAIN_ID}")
    ADDR_RISK=$(echo "$ADDR_RESULT" | jq -r '.risk_level')
    TOKEN_RESULT=$(curl -s -H "X-Client-Fingerprint: pro-audit" \
xyz/v1/check-item/${addr}?chain_id=${CHAIN_ID}")
    TOKEN_RISK=$(echo "$TOKEN_RESULT" | jq -r '.risk_level // "N/A"')
    echo ""
    echo "--- ${label} (${addr}) ---"
    echo "地址风险: ${ADDR_RISK}"
    echo "代币风险: ${TOKEN_RISK}"
    case $ADDR_RISK in
        CRITICAL) ((CRITICAL_COUNT++)) ;;
        HIGH) ((HIGH_COUNT++)) ;;
    esac
done
echo ""
echo "============================================"
echo "审计摘要"
echo "  CRITICAL: ${CRITICAL_COUNT}"
echo "  HIGH: ${HIGH_COUNT}"
echo "============================================"
if [ "$CRITICAL_COUNT" -gt 0 ]; then
    echo "阻止: 存在极高风险合约,协议不可上线"
    exit 1
fi

场景二:机构级交易风控

机构在执行大额交易前,通过交易模拟与多重检查确保资金安全.

python

#!/usr/bin/env python3
"""专业版机构级交易风控示例"""
import requests
import json
from datetime import datetime
class BlockchainRiskControl:
    BASE_URL = "https://api.example.com/v1"
    def __init__(self, fingerprint="institutional-pro"):
        self.headers = {
            "X-Client-Fingerprint": fingerprint,
            "Content-Type": "application/json"
        }
        self.blocked = False
        self.warnings = []
    def check_address(self, address, chain_id=1):
        """地址信誉检查"""
        resp = requests.get(
            f"{self.BASE_URL}/check-address/{address}",
            params={"chain_id": chain_id},
            headers=self.headers
        )
        return resp.json()
    def check_token(self, token_address, chain_id=1):
        """代币安全检测"""
            f"{self.BASE_URL}/check-item/{token_address}",
            params={"chain_id": chain_id},
        )
        return resp.json()
    def simulate_transaction(self, from_addr, to_addr, value, data="0x", chain_id=1):
        """交易模拟(专业版独有)"""
        payload = {
            "from": from_addr,
            "to": to_addr,
            "value": str(value),
            "data": data,
            "chain_id": chain_id
        }
            f"{self.BASE_URL}/simulate-tx",
            json=payload,
        )
        return resp.json()
    def pre_trade_check(self, from_addr, to_addr, token_addr, value, chain_id=1):
        """交易前全面风控检查"""
        report = {
            "timestamp": datetime.utcnow().isoformat(),
            "checks": []
        }
        addr_result = self.check_address(to_addr, chain_id)
        report["checks"].append({
            "check": "address_reputation",
            "risk": addr_result.get("risk_level", "UNKNOWN"),
            "safe": addr_result.get("is_safe", False)
        })
        if addr_result.get("risk_level") in ["HIGH", "CRITICAL"]:
            self.blocked = True
            report["decision"] = "BLOCKED"
            return report
        if token_addr:
            token_result = self.check_token(token_addr, chain_id)
                "check": "token_safety",
                "risk": token_result.get("risk_level", "UNKNOWN"),
                "honeypot": token_result.get("is_honeypot", False)
            })
            if token_result.get("is_honeypot"):
                self.blocked = True
                report["decision"] = "BLOCKED"
                return report
        sim_result = self.simulate_transaction(from_addr, to_addr, value, chain_id=chain_id)
            "check": "transaction_simulation",
            "success": sim_result.get("success", False),
            "gas_estimate": sim_result.get("gas_estimate", 0),
            "revert_reason": sim_result.get("revert_reason", None)
        })
        if not sim_result.get("success"):
            self.blocked = True
            report["decision"] = "BLOCKED"
            return report
        report["decision"] = "ALLOWED"
        return report
if __name__ == "__main__":
    rc = BlockchainRiskControl()
    report = rc.pre_trade_check(
        from_addr="0xYourWallet",
        to_addr="0xContractAddr",
        token_addr="0xTokenAddr",
        value=0,
        chain_id=1
    )
    print(json.dumps(report, indent=2))

场景三:CI/CD安全门禁

将区块链安全检查集成到CI/CD流水线,作为部署前的安全门禁.

yaml

name: Blockchain Security Gate
on: [push, pull_request]
jobs:
  security-check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Check contract addresses
        run: |
          CRITICAL=0
          for addr in $(cat contracts.txt); do
            RISK=$(curl -s -H "X-Client-Fingerprint: ci-pro" \
chain_id=1" | jq -r '.risk_level')
            echo "${addr}: ${RISK}"
            if [ "$RISK" = "CRITICAL" ]; then
              CRITICAL=$((CRITICAL + 1))
            fi
          done
          if [ "$CRITICAL" -gt 0 ]; then
            echo "Security gate FAILED: ${CRITICAL} critical findings"
            exit 1
          fi
          echo "Security gate PASSED"

实操说明

阅读## 核心能力章节了解skill功能
按## 依赖说明配置环境
执行所需能力对应的命令
参考## 错误处理章节处理异常
查看## FAQ解答常见疑问

从免费版升级

专业版完全兼容免费版接口,仅需更换指纹标识即可启用专业版能力:

bash

curl -s "https://api.example.com/v1/check-address/0x..."
curl -s -H "X-Client-Fingerprint: pro-agent" \
  "https://aegis402..."
```bash
# 在此执行相关操作
echo "操作完成"
```bash
xyz/v1/simulate-tx" \
  -H "Content-Type: application/json" \
  -H "X-Client-Fingerprint: pro-agent" \
  -d '{
    "from": "0xSender...",
    "to": "0xRecipient...",
    "value": "1000000000000000000",
    "data": "0x",
    "chain_id": 1
  }' | jq

响应解析: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤.

快速开始

确认运行环境满足依赖说明中的要求
在AI Agent对话中调用本技能,提供必要的输入参数
检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

配置示例

Webhook告警配置

json

{
  "webhook": {
    "url": "https://your-alert-server.com/webhook",
    "events": ["CRITICAL", "HIGH"],
    "retry_count": 3,
    "timeout_seconds": 10
  }
}
```bash
# 在此执行相关操作
echo "操作完成"
```csv
address,label,chain_id
0x742d35Cc6634C0532925a3b844Bc454e4438f44e,主要合约,1
0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48,USDC代币,1
0xdAC17F958D2ee523a2206206994597C13D831ec7,USDT代币,1

专业版支持的链(15条)

链名称	Chain ID	地址检查	代币检查	交易模拟
Ethereum	1	支持	支持	支持
Base	8453	支持	支持	支持
Polygon	137	支持	支持	支持
Arbitrum	42161	支持	支持	支持
Optimism	10	支持	支持	支持
BSC	56	支持	支持	支持
Avalanche	43114	支持	支持	支持
Solana	solana	支持	支持	不适用
Fantom	250	支持	支持	支持
Linea	59144	支持	支持	支持
Scroll	534352	支持	支持	支持
Mantle	5000	支持	支持	支持
Sepolia(测试网)	11155111	支持	支持	支持
Base Sepolia	84532	支持	支持	支持
Holesky(测试网)	17000	支持	支持	支持

环境要求

运行环境

Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
操作系统: Windows / macOS / Linux
网络: 需可访问 https://api.example.com
Python: 3.8+(使用Python风控脚本时需要)

依赖详情

依赖项	类型	是否必需	获取方式
curl	命令行工具	必需	系统自带或包管理器安装
jq	JSON处理工具	推荐	`apt install jq` / `brew install jq`
python3	运行时环境	可选	python.org 下载
requests	Python库	可选	`pip install requests`
LLM API	API	必需	由Agent内置LLM提供

API Key 配置

专业版使用 X-Client-Fingerprint 头标识专业版身份
建议使用专属指纹标识,如 pro-agent-{team-name}
交易模拟与批量检查功能需专业版指纹

可用性分类

分类: MD+EXEC模式纯Markdown指令,核心功能需要exec命令行执行能力)
说明: 基于Markdown的AI Skill,通过自然语言指令驱动Agent执行企业级区块链安全检查与交易模拟任务
API Key通过环境变量配置: export API_KEY=your_key

异常处理策略

错误场景	原因	处理方式
配置错误	参数缺失或格式错误	检查依赖说明中的配置要求
运行时错误	运行环境不满足	确认运行环境符合依赖说明
网络错误	连接超时或不可达	执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案

安全守则

风险类型	防范措施
API密钥泄露	通过环境变量传入,不在代码中硬编码
命令执行风险	命令执行受白名单约束,避免注入用户输入
网络通信安全	通信使用HTTPS并校验证书有效性
敏感数据暴露	输出不含敏感凭据
使用前请确认已阅读依赖说明章节，确保运行环境满足安全要求。

疑问速答

Q1: 区块链安全扫描专业版支持哪些输入格式？

A1: 企业级区块链安全工具,支持交易模拟、批量地址检查、多链覆盖、风险报告导出与告警推送,适合DeFi团队与机构用户.。支持文本指令和结构化参数输入，具体格式参考使用流程章节。

Q2: 需要配置API Key吗？

A2: 是的，部分功能需要配置对应平台的API Key。请在依赖说明章节查看具体要求，并通过环境变量安全配置。

Q3: 命令行执行失败怎么办？

A3: 检查命令参数是否正确，确认运行环境支持exec能力。如遇权限问题，请参照错误处理章节排查。

即刻上手

配置API密钥: 在环境变量中设置对应的API Key
初始化连接: 使用提供的凭证建立API连接
调用接口: 传入必要参数执行API调用
准备文件: 确认文件路径正确且格式受支持
执行处理: 调用对应的处理函数
查看结果: 检查输出文件或返回数据
检查环境: 确认运行时和依赖已安装
执行命令: 使用正确的参数格式执行
查看输出: 检查命令输出和退出码

前置条件

已安装所需运行环境(参考依赖说明)
已获取必要的API密钥或访问凭证(如适用)
输入数据已准备就绪

区块链安全扫描专业版

Install

区块链安全扫描专业版

总览

专业版核心优势

主要能力

1. 交易模拟(专业版独有)

输入参数

2. 批量地址检查(专业版独有)

3. 地址信誉查询(兼容免费版)

4. 代币深度检测(兼容免费版增强)

5. SARIF报告导出(专业版独有)

使用场景

场景一:DeFi协议安全审计

场景二:机构级交易风控

场景三:CI/CD安全门禁

实操说明

从免费版升级

快速开始

配置示例

Webhook告警配置

专业版支持的链(15条)

推荐做法

热门问题

Q1: 专业版与免费版接口是否兼容?

Q2: 交易模拟会消耗Gas吗?

已知限制

环境要求

运行环境

依赖详情

API Key 配置

可用性分类

异常处理策略

安全守则

疑问速答

Q1: 区块链安全扫描专业版支持哪些输入格式？

Q2: 需要配置API Key吗？

Q3: 命令行执行失败怎么办？

即刻上手

前置条件

区块链安全扫描专业版

Install

区块链安全扫描专业版

总览

专业版核心优势

主要能力

1. 交易模拟(专业版独有)

输入参数

2. 批量地址检查(专业版独有)

3. 地址信誉查询(兼容免费版)

4. 代币深度检测(兼容免费版增强)

5. SARIF报告导出(专业版独有)

使用场景

场景一:DeFi协议安全审计

场景二:机构级交易风控

场景三:CI/CD安全门禁

实操说明

从免费版升级

快速开始

配置示例

Webhook告警配置

专业版支持的链(15条)

推荐做法

热门问题

Q1: 专业版与免费版接口是否兼容?

Q2: 交易模拟会消耗Gas吗?

已知限制

环境要求

运行环境

依赖详情

API Key 配置

可用性分类

异常处理策略

安全守则

疑问速答

Q1: 区块链安全扫描专业版支持哪些输入格式？

Q2: 需要配置API Key吗？

Q3: 命令行执行失败怎么办？

即刻上手

前置条件

Related skills