
一款按次付费的智能合约风险报告服务面向 AI 代理开放
来源标题:Smart-contract risk reports that AI agents buy per call over x402
该服务通过 x402 微支付(USDC)按次向 AI 代理出售链上智能合约风险报告。分析结果确定且仅用公开数据,不依赖 LLM;支持 Base、Base Sepolia、以太坊主网和 Arbitrum One,分析失败不收费。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
一个面向生产环境的小型服务,向 AI agent 出售链上智能合约风险报告,按次通过 x402 微支付(USDC,EIP-3009 exact 方案)收费。一个 express 进程,两个付费接口:
两个付费接口都调用 src/risk/analyze.ts 中同一个 analyzeContract(chainId, address)。分析是确定性的,只使用公开数据(RPC、Blockscout、Sourcify、本地 aderyn 二进制)。不使用 LLM,分析过程也不需要 API key。
未知链或格式错误的地址会在请求支付之前返回 400。如果分析本身失败(目标不是合约、上游错误、超时),响应为错误状态,买方不会被扣费(x402 只对成功的响应进行结算)。
支持的链(v1,src/chains.ts):Base 8453、Base Sepolia 84532、Ethereum 1、Arbitrum One 42161。可通过 RPC_URL_<chainId> 覆盖 RPC。
{ chainId, address, analyzedAt, isContract, bytecodeSize, proxy, erc20, opcodes, selectors: { found }, blockscout, sourcify?, aderyn, score, level, flags, notes }
proxy:来自 EIP-1967(implementation/admin/beacon)、legacy zeppelinos slot、EIP-1822、EIP-1167 clones 或 Blockscout 的检测,格式为 { type, implementation, admin? }。implementation 的字节码也会被分析。
erc20:name、symbol、decimals、totalSupply、owner()(以及它是否为零地址)、paused()。每个探测单独 try/catch。
opcodes:通过真实的 opcode 遍历(跳过 PUSH 数据,不做子串匹配)判断是否存在 SELFDESTRUCT / DELEGATECALL。
selectors.found:风险签名(mint、pause、blacklist、fee/tax setter、upgrade、ownership 等)的 4 字节 selector 是否作为 PUSH4 出现在字节码中。这是启发式判断:出现并不证明可达(notes 中也有说明)。
blockscout / sourcify:验证状态、编译器、合约名、创建者及创建交易。Blockscout 有 5 秒超时;失败时返回 blockscout: { available: false }。仅当 Blockscout 不可达或报告 "unverified" 时,才回退查询 Sourcify。对于代理合约,以 implementation 的验证状态为准。
aderyn:当有已验证的 Solidity 源码时,源码写入临时目录(路径经过清理),aderyn 以 15 秒超时运行:{ ran, counts: { high, low }, top: [{ title, severity, instances }] },否则返回 { ran: false, reason }。它绝不会导致请求失败。
总预算:每次分析硬性截止 24 秒。结果按 chainId+address 在内存中缓存 10 分钟(每次调用仍然会实际支付)。
评分规则(src/risk/score.ts)
分值 0..100,越高风险越大,各项累加,上限 100。
等级:0-24 low,25-49 medium,50-74 high,75-100 critical。非合约地址属于错误,而不是某个分数。分数是分诊信号,不是审计。
主网:Ethereum (1)、OP Mainnet (10)、BNB Smart Chain (56)、Gnosis (100)、Unichain (130)、Polygon (137)、Sonic (146)、World Chain (480)、Mantle (5000)、Base (8453)、Arbitrum One (42161)、Celo (42220)、Avalanche C-Chain (43114)、Linea (59144)、Blast (81457)、Scroll (534352)。测试网:Base Sepolia (84532)、Sepolia (11155111)、OP Sepolia (11155420)、Arbitrum Sepolia (421614)。
没有 Blockscout 实例的链(BNB、Sonic、Mantle、Avalanche)依赖 Sourcify 获取已验证源码。zkSync Era 被有意排除:EraVM 字节码会破坏 opcode 和 selector 启发式判断。来自 Blockscout 或 Sourcify 的编译器 remappings 会写入 remappings.txt,以便 aderyn 能解析 @openzeppelin/... 风格的 import。
机器可读描述:GET /openapi.json(OpenAPI 3.1,免费)。错误响应体是带 error code 的 JSON。只有 200 响应才会结算。通过 MCP 调用时,同样的失败会返回 isError 结果和错误信息,并且不扣费。
买方在 Base(eip155:8453)上以 USDC 支付。当设置了 SOLANA_PAY_TO 时,相同的路由和工具也接受 Solana 主网上的 USDC(solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp),由同一个 Coinbase CDP facilitator 结算,由它支付 Solana 费用。Solana 收款地址必须已拥有 USDC token account(SDK 不会代为创建)。
pnpm buy-once-svm 使用一个 Solana 密钥对(SVM_PRIVATE_KEY,base58 编码的 64 字节私钥)支付一次调用。
免费预览:GET /v1/flags/:chainId/:address 和 MCP 工具 contract_quick_flags 免费返回报告中仅基于字节码的部分(proxy、owner/pause 状态、风险 selector、opcodes、部分分数)。限速为每 IP 每分钟 30 次请求。源码验证和 aderyn 结果只在付费报告中提供。
Agent skill:npx skills add Bosacks/magneta-risk-x402 --skill magneta-contract-risk 会安装 skills/magneta-contract-risk/SKILL.md,它教会 agent 何时以及如何通过 HTTP、MCP 或 Coinbase Agentic Wallet 购买报告。
客户端包:@magnetafinance/contract-risk (npm i @magnetafinance/contract-risk @x402/core@2.28.0 @x402/evm@2.28.0 @x402/fetch@2.28.0 viem@2.57.7,源码在 packages/contract-risk-client)将 x402 支付流程封装为带类型的客户端,并提供面向 LangChain.js、Vercel AI SDK 和 OpenAI/Anthropic function calling 的工具适配器。
ElizaOS 插件:packages/plugin-elizaos(@magnetafinance/plugin-contract-risk)向 Eliza agent 添加 CONTRACT_QUICK_FLAGS(免费)和 CONTRACT_RISK_REPORT(付费,按支付次数限次)两个 action。
ERC-8004 身份:注册文件 erc8004/agent-registration.json 通过 /.well-known/agent-registration.json 提供;scripts/erc8004-register.ts 会打印面向 Base IdentityRegistry 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 的 register(string) 调用。
运行 pnpm install --ignore-scripts cp .env.example .env.local # 填写 PAY_TO、X402_NETWORK、FACILITATOR_URL(使用 cdp 时还需 CDP keys) pnpm dev # tsx,或:pnpm build && pnpm start pnpm type-check && pnpm test # 单元测试,不需要网络 pnpm analyze 84532 0x036CbD53842c5426634e7929541eC2318f3dCF7e # 免费的本地运行,打印报告
购买(需要一个有余额的买方密钥,消费上限 $0.01 即价格;切勿将此密钥放在服务器上): BUYER_PRIVATE_KEY=0x... pnpm buy-once # HTTP;打印报告和 PAYMENT-RESPONSE 交易哈希
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。