运行时依赖
安装命令
点击复制技能文档
Aegis402 Shield 协议 区块链安全 API,适用于 AI 代理。 免费层:每天 100 次检查,然后使用 USDC 在 Base 或 Solana 上按请求付费。
安全默认值 本技能仅为手动使用(disable-model-invocation: true)。 不要要求或存储私钥、种子短语或助记符。 在进行付费调用之前(尤其是模拟事务)确认意图。 仅当用户明确批准了自动化时,才自动执行预签名检查。 此技能所需的环境变量:none。
代理快速入门(扫描前事务) 代理和钱包的默认策略: 为可预测的免费层计费设置 X-Client-Fingerprint: 。 在发送任何事务之前,运行以下命令: GET /v1/check-address/:to POST /v1/simulate-tx (可选)GET /v1/check-token/:token 用于参与的令牌(交换/批准) 如果任何结果表明 HIGH/CRITICAL、isSafe=false 或收件人被标记为有毒/标记,则阻止并要求确认。 否则允许,但仍显示审查摘要 + 原始 JSON。
注意: 免费层是尽力而为的,限制滥用,而不是安全机制。 旋转指纹可以绕过免费层的存储桶。 如果省略 X-Client-Fingerprint,则服务将回退到其他请求信号(IP/User-Agent)进行计费。
代理模式(从零开始) 当用户即将发送事务时: 要求缺失的意图:from、to、value、data(或“本地转账”)、chain_id 检查免费层(始终免费):GET /v1/usage 运行扫描前事务检查(并行): GET /v1/check-address/:to POST /v1/simulate-tx (可选)GET /v1/check-token/:token 使用以下模板回复(先总结,然后是原始 JSON)。
如何回复(模板) 安全(低) 扫描完成 风险:低(安全) 总结:未检测到任何关键警告。 确认可以继续。
警告(中) 扫描完成 风险:中(警告) 总结:检测到一些警告。 建议在继续之前进行审查。 您想让我解释前三个风险吗?
危险(高) 扫描完成 风险:高(危险) 总结:检测到重大风险。 不建议继续。
阻止(关键) 扫描完成 风险:关键(阻止) 总结:请勿继续。 此事务/收件人似乎是恶意或不安全的。
402 支付所需 我尝试运行付费检查,但未设置付款(或钱包中 USDC 不足)。 要启用付费检查:
- 使用少量 USDC 资助一个程序化钱包(Base 默认;Solana 也支持)
- 安装一个 x402 客户端 (@x402/fetch + 链包)
- 配置一个代理管理的钱包签名者(不在提示/环境中使用原始私钥)
参考技能文件 文件 URL SKILL.md(此文件) https://aegis402.xyz/skill.md skill.json(元数据) https://aegis402.xyz/skill.json
基本 URL:https://aegis402.xyz/v1
定价端点 价格 用例 POST /simulate-tx $0.05 事务模拟,DeFi 安全 GET /check-token/:address $0.01 令牌蜜罐检测 GET /check-address/:address $0.005 地址声誉检查 免费层:每天 100 次检查。 通过 GET /v1/usage 跟踪使用情况。
使用情况(免费) curl "https://aegis402.xyz/v1/usage" 示例响应: { "freeTier": { "enabled": true, "dailyLimit": 100, "usedToday": 2, "remainingChecks": 98, "nextResetAt": "2026-02-11T00:00:00.000Z", "resetTimezone": "UTC" }, "_meta": { "requestId": "uuid", "tier": "free", "eventType": "free_tier_call", "latencyMs": 4 } }
check-address curl "https://aegis402.xyz/v1/check-address/0x742d35Cc6634C0532925a3b844Bc454e4438f44e?chain_id=8453"
simulate-tx 请求正文字段: from(必需):发送者地址 to(必需):收件人或合约 value(必需):以 wei 为单位的金额(字符串) data(可选):calldata hex(0x...) chain_id(可选):被模拟的链(默认:Base 8453 是支付的常见选择,但模拟链由您决定) curl -X POST "https://aegis402.xyz/v1/simulate-tx" \ -H "Content-Type: application/json" \ -d '{ "from": "0xYourWallet...", "to": "0xContract...", "value": "0", "data": "0x", "chain_id": 8453 }'
check-token chain_id 是您要扫描的链(Ethereum=1、Base=8453 等)。 支付轨道由 402 挑战驱动(默认:Base 上的 USDC)。 curl "https://aegis402.xyz/v1/check-token/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48?chain_id=1"
付款(x402) 您可以在指纹使用 100 次检查/天之前免费使用 API。 之后,API 返回 402 支付所需,x402 客户端可以自动付款并重试。
网络 代理钱包签名者 Base(EVM) 来自代理钱包提供者的 EVM 签名者 Solana 来自代理钱包提供者的 Solana 签名者 最小节点客户端(代理管理的 EVM 签名者) npm install @x402/fetch@2.2.0 @x402/evm@2.2.0 import { x402Client, wrapFetchWithPayment } from '@x402/fetch'; import { ExactEvmScheme } from '@x402/evm/exact/client'; const fingerprint = 'agent-default'; const signer = yourAgenticEvmSigner; const client = new x402Client() .register('eip155:*', new ExactEvmScheme(signer));