区块链安全扫描专业版

概述

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

专业版核心优势

核心能力

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

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

输入格式

# 模拟一笔代币交易
curl -s -X POST "https://aegis402.xyz/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文件批量导入地址,一次检查数百个地址,适合机构级筛查.

#!/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://aegis402.xyz/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. 地址信誉查询(兼容免费版)

# 专业版地址查询(带高级参数)
curl -s -H "X-Client-Fingerprint: pro-agent" \
  "https://aegis402.xyz/v1/check-address/0x742d35Cc6634C0532925a3b844Bc454e4438f44e?chain_id=1&include_history=true" | jq

输入: 用户提供地址信誉查询(兼容免费版)所需的指令和必要参数.
处理: 解析地址信誉查询(兼容免费版)的输入参数,完成核心逻辑,返回结构化响应.
输出: 返回地址信誉查询(兼容免费版)的响应数据,包含状态码、结果和日志.
- 执行此能力时使用input_params参数,支持创建/查询/导出操作

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

# 专业版代币检测(包含合约源码分析)
curl -s -H "X-Client-Fingerprint: pro-agent" \
  "https://aegis402.xyz/v1/check-token/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48?chain_id=1&deep_scan=true" | jq

输入: 用户提供代币深度检测(兼容免费版增强)所需的指令和必要参数.
处理: 解析代币深度检测(兼容免费版增强)的输入参数,完成核心逻辑,返回结构化响应.
输出: 返回代币深度检测(兼容免费版增强)的响应数据,包含状态码、结果和日志.
- 执行此能力时使用input_params参数,支持创建/查询/导出操作

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

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

# 生成SARIF报告
curl -s -X POST "https://aegis402.xyz/v1/export" \
  -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报告导出(专业版独有)的输入参数,完成核心逻辑,返回结构化响应.
输出: 返回SARIF报告导出(专业版独有)的响应数据,包含状态码、结果和日志.
能力覆盖范围：本skill的核心能力覆盖以下场景关键词：企业级区块链安全、支持交易模拟、批量地址检查、多链覆盖、风险报告导出与告、警推送、DeFi、团队与机构用户、区块链安全扫描专、团队与机构用户提、供全方位链上安全、核心能力、交易模拟、多链深度扫描、SARIF、报告导出、Webhook、高并发、API、适用场景、协议安全审计、机构级交易风控、批量地址筛查、安全门禁、差异化、专业版兼容免费版、新增交易模拟、批量操作与企业级、报告能力、满足合规与规模化、适用关键词、区块链安全、批量扫描、风险报告、blockchain、simulate、batch等.
- 执行此能力时使用input_params参数,支持创建/查询/导出操作

使用场景

场景一:DeFi协议安全审计

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

#!/bin/bash
# DeFi协议安全审计脚本(专业版)
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" \
        "https://aegis402.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" \
        "https://aegis402.xyz/v1/check-token/${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

场景二:机构级交易风控

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

#!/usr/bin/env python3
"""专业版机构级交易风控示例"""
# ...
import requests
import json
from datetime import datetime
# ...
class BlockchainRiskControl:
    BASE_URL = "https://aegis402.xyz/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):
        """代币安全检测"""
        resp = requests.get(
            f"{self.BASE_URL}/check-token/{token_address}",
            params={"chain_id": chain_id},
            headers=self.headers
        )
        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
        }
        resp = requests.post(
            f"{self.BASE_URL}/simulate-tx",
            json=payload,
            headers=self.headers
        )
        return resp.json()
# ...
    def pre_trade_check(self, from_addr, to_addr, token_addr, value, chain_id=1):
        """交易前全面风控检查"""
        report = {
            "timestamp": datetime.utcnow().isoformat(),
            "checks": []
        }
# ...
        # 1. 地址检查
        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
# ...
        # 2. 代币检查
        if token_addr:
            token_result = self.check_token(token_addr, chain_id)
            report["checks"].append({
                "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
# ...
        # 3. 交易模拟(专业版核心)
        sim_result = self.simulate_transaction(from_addr, to_addr, value, chain_id=chain_id)
        report["checks"].append({
            "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流水线,作为部署前的安全门禁.

# .github/workflows/blockchain-security.yml
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" \
              "https://aegis402.xyz/v1/check-address/${addr}?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"

快速开始

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

从免费版升级

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

# 免费版调用
curl -s "https://aegis402.xyz/v1/check-address/0x..."
# ...
# 专业版调用(更换指纹)
curl -s -H "X-Client-Fingerprint: pro-agent" \
  "https://aegis402.xyz/v1/check-address/0x..."

首次交易模拟

curl -s -X POST "https://aegis402.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

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

配置示例

Webhook告警配置

{
  "webhook": {
    "url": "https://your-alert-server.com/webhook",
    "events": ["CRITICAL", "HIGH"],
    "retry_count": 3,
    "timeout_seconds": 10
  }
}

批量检查CSV格式

address,label,chain_id
0x742d35Cc6634C0532925a3b844Bc454e4438f44e,主要合约,1
0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48,USDC代币,1
0xdAC17F958D2ee523a2206206994597C13D831ec7,USDT代币,1

专业版支持的链(15条)

最佳实践

1. 三层检查:对每笔交易执行地址检查、代币检查、交易模拟三层验证.
2. 批量筛查:使用CSV批量检查功能,定期筛查协议涉及的全部地址.
3. CI/CD集成:将SARIF报告集成到代码扫描流水线,实现自动化安全门禁.
4. 告警配置:配置Webhook告警,在检测到CRITICAL风险时第一时间通知团队.
5. 额度监控:专业版虽然无限制,仍建议监控API使用量,优化调用效率.
6. 报告归档:定期导出HTML/PDF报告,满足合规审计要求.

常见问题

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

完全兼容。专业版使用相同的API端点,仅需在请求头中使用专业版指纹标识即可启用高级功能。已有免费版集成代码无需修改.

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

不会。交易模拟在沙盒环境中执行,不会广播到链上,不消耗真实Gas费用.

已知限制

专业版单次批量检查建议不超过500个地址,超过时可分批执行。API并发限制为10 QPS.

Q4: SARIF报告如何集成到GitHub?

将生成的 .sarif 文件上传为GitHub Actions的代码扫描结果,GitHub会自动在PR中展示安全发现。参考CI/CD集成示例.

Q5: Webhook告警支持哪些事件?

支持 CRITICAL、HIGH、MEDIUM 等风险等级事件,可在配置中自定义订阅的事件类型.

依赖说明

运行环境

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

依赖详情

API Key 配置

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

可用性分类

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

错误处理

示例

基本用法

输入：用户提供操作指令和必要参数

输出：返回执行结果,包含操作状态和输出数据

用户: 执行核心功能
Skill: 正在执行核心功能...
Skill: 执行完成,结果如下: 操作成功