Ingravity Autonomous EVM Security & DeFi Guard (x402 v2)
5-EVM pre-sign firewall, ERC-20 honeypot scanner, DeFi MEV math & Solidity audit via x402.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (14)
- LOWen ingravity_fastPingAddressSafety
- LOWen ingravity_fastPingAddressSafety
- LOWen ingravity_auditSolidityContract
- LOWen ingravity_auditSolidityContract
- LOWen ingravity_inspectEvmTransactionFirewall
- LOWen ingravity_inspectEvmTransactionFirewall
- LOWen ingravity_computeDefiSlippageAndLiquidation
- LOWen ingravity_computeDefiSlippageAndLiquidation
- LOWen ingravity_scanTokenRugpullAndHoneypot
- LOWen ingravity_scanTokenRugpullAndHoneypot
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"ingravity-security": {
"command": "npx",
"args": [
"ingravity-security"
]
}
}
}Paquetes ejecutables
1.3.3stdioPuntos de conexión remotos
https://red-shape-1b3b.daviddelmoral79.workers.dev/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (7)
🟢ingravity_fastPingAddressSafety(address, chainId)
Checks whether a single EVM address (0x...) is SAFE, DANGER, or UNKNOWN_UNVERIFIED_RPC across five chains (chainId: 8453 Base default, 42161 Arbitrum, 10 Optimism, 137 Polygon, 1 Ethereum; unknown IDs fall back to 8453). Strictly read-only, returning only a binary status and PROCEED/ABORT/CAUTION action with zero forensic leakage. Costs $0.01 USDC flat on Base via x402 v2; unpaid calls return isError: true with the payment challenge. Best for <=$0.05 bot budgets; escalate to ingravity_scanTokenRugpullAndHoneypot for tokens or ingravity_inspectEvmTransactionFirewall before signing calldata.
Esquema de entrada
{
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "42-character EVM contract, token, or spender address (0x...) across Base, Arbitrum, Optimism, Polygon, or Ethereum."
},
"chainId": {
"type": "integer",
"enum": [
8453,
42161,
10,
137,
1
],
"default": 8453,
"description": "Target EVM chain ID: 8453 (Base), 42161 (Arbitrum), 10 (Optimism), 137 (Polygon), or 1 (Ethereum). Unsupported values fall back to 8453."
}
},
"required": [
"address"
]
}Esquema de salida
{
"type": "object",
"properties": {
"settled": {
"type": "boolean",
"description": "Whether x402 USDC payment settled cleanly."
},
"status": {
"type": "string",
"enum": [
"SAFE",
"DANGER",
"UNKNOWN_UNVERIFIED_RPC"
],
"description": "Binary address risk classification."
},
"verdict": {
"type": "string",
"enum": [
"SAFE",
"DANGER",
"UNKNOWN_UNVERIFIED_RPC"
],
"description": "Mirror of status for downstream routing."
},
"action": {
"type": "string",
"enum": [
"PROCEED",
"ABORT",
"CAUTION"
],
"description": "Recommended execution directive."
},
"signal": {
"type": "string",
"enum": [
"GREEN_LIGHT",
"RED_LIGHT",
"YELLOW_LIGHT"
],
"description": "Traffic-light risk indicator."
},
"isSafe": {
"type": "boolean",
"description": "True only when address passed deterministic and live RPC checks."
},
"targetAddress": {
"type": "string",
"description": "Normalized lowercase address evaluated."
},
"chainId": {
"type": "integer",
"description": "Resolved EVM chain ID used for evaluation."
},
"forensicDetails": {
"type": "string",
"description": "Fixed sentinel ('LOCKED_IN_FAST_PING_TIER'); upgrade to tx-firewall for forensics."
},
"upgradeForFullForensics": {
"type": "string",
"description": "Upgrade paths for calldata or token forensics."
}
},
"required": [
"settled",
"status",
"verdict",
"action",
"signal",
"isSafe",
"targetAddress",
"chainId",
"forensicDetails"
],
"additionalProperties": true
}🟢ingravity_auditSolidityContract(code, chainId, contractName, contractAddress, ownerTreasury, ...)
Audits a single Solidity file (code, required; optional contractName) across 24 SWC/DeFi rules using a 4-gate filter that excludes dust rounding and trusted-admin paths. Read-only and never broadcasts transactions: optionally supply deployed contractAddress, chainId (default 8453), and ownerTreasury to check live TVL via RPC and generate unsigned EIP-5792/EOA Safe-Harbor rescue calldata (90%-95% to ownerTreasury). Set tier to FULL ($0.85 USDC, default) for findings or ESSENTIAL ($0.35 USDC) for score and counts; unpaid calls return isError: true, and CRITICAL/HIGH patches remain sealed under Anti-Bypass until 0.15% SLA or 5%-10% rescue settlement. Use for single contracts; use ingravity_generateMultiContractProtocolDossier for multi-file protocols.
Esquema de entrada
{
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Raw Solidity (.sol) smart contract source code to audit across 24 SWC/DeFi rules (non-empty string required)."
},
"chainId": {
"type": "integer",
"enum": [
8453,
42161,
10,
137,
1
],
"default": 8453,
"description": "EVM Chain ID used only when contractAddress is supplied for live TVL verification (8453 Base, 42161 Arbitrum, 10 Optimism, 137 Polygon, 1 Ethereum; unknown falls back to 8453)."
},
"contractName": {
"type": "string",
"default": "Contract.sol",
"description": "Optional contract identifier or filename echoed in the report."
},
"contractAddress": {
"type": "string",
"description": "Optional deployed EVM contract address (0x...) on chainId to verify live TVL via RPC and generate unsigned Safe-Harbor rescue calldata."
},
"ownerTreasury": {
"type": "string",
"description": "Optional protocol owner/multisig recipient (0x...) designated to receive 90%-95% of rescued capital in generated unsigned calldata."
},
"tier": {
"type": "string",
"enum": [
"FULL",
"ESSENTIAL"
],
"default": "FULL",
"description": "Billing & output depth: FULL ($0.85 USDC) includes findings and Safe-Harbor calldata (subject to Anti-Bypass sealing on CRITICAL/HIGH until proportional settlement); ESSENTIAL ($0.35 USDC) returns score, grade, status, and severity counts only."
}
},
"required": [
"code"
]
}Esquema de salida
{
"type": "object",
"properties": {
"settled": {
"type": "boolean",
"description": "Whether x402 USDC payment settled cleanly."
},
"action": {
"type": "string",
"enum": [
"PROCEED",
"CAUTION",
"ABORT"
],
"description": "Deployment gate directive."
},
"signal": {
"type": "string",
"enum": [
"GREEN_LIGHT",
"YELLOW_LIGHT",
"RED_LIGHT"
],
"description": "Traffic-light severity indicator."
},
"contractName": {
"type": "string",
"description": "Audited contract label."
},
"chainId": {
"type": "integer",
"description": "Resolved EVM chain ID."
},
"loc": {
"type": "integer",
"description": "Source lines of code analyzed."
},
"securityScore": {
"type": "number",
"description": "Deterministic security score from 0 to 100."
},
"grade": {
"type": "string",
"enum": [
"A",
"B",
"C",
"D",
"F"
],
"description": "Letter grade derived from securityScore."
},
"status": {
"type": "string",
"enum": [
"PRODUCTION_READY",
"ACCEPTABLE_WITH_WARNINGS",
"REMEDIATION_REQUIRED",
"CRITICAL_DO_NOT_DEPLOY"
],
"description": "Overall readiness verdict."
},
"verifiedOnChainTvlUsd": {
"type": "number",
"description": "Live on-chain TVL verified via RPC when contractAddress is supplied (0 otherwise)."
},
"savedCapitalEstimateUsd": {
"type": "string",
"description": "Estimated capital at risk or prevented exploit range."
},
"summary": {
"type": "object",
"description": "Finding counts grouped by severity.",
"properties": {
"CRITICAL": {
"type": "integer"
},
"HIGH": {
"type": "integer"
},
"MEDIUM": {
"type": "integer"
},
"LOW": {
"type": "integer"
},
"GAS": {
"type": "integer"
},
"total": {
"type": "integer"
}
},
"required": [
"CRITICAL",
"HIGH",
"MEDIUM",
"LOW",
"GAS",
"total"
],
"additionalProperties": true
},
"findings": {
"type": "array",
"description": "Per-finding details with line coordinates and fix guidance (FULL tier only; CRITICAL/HIGH coordinates sealed until proportional settlement when applicable).",
"items": {
"type": "object",
"additionalProperties": true
}
},
"capitalSalvageAndSafeHarbor": {
"type": "object",
"description": "Unsigned Safe-Harbor rescue plan or optional pre-deploy circuit-breaker snippet (FULL tier only).",
"additionalProperties": true
},
"proportionalRescueCommissionPolicy": {
"type": "object",
"description": "0.15% Pre-Flight SLA and 5%-10% Safe-Harbor policy metadata (FULL tier only).",
"additionalProperties": true
}
},
"required": [
"settled",
"action",
"signal",
"contractName",
"chainId",
"loc",
"securityScore",
"grade",
"status",
"verifiedOnChainTvlUsd",
"savedCapitalEstimateUsd",
"summary"
],
"additionalProperties": true
}🟢ingravity_inspectEvmTransactionFirewall(to, data, from, value, chainId, ...)
Simulates pre-sign EVM calldata (to, data, optional from and wei value defaulting to '0') across five chains (chainId default 8453 Base) to block drainers before wallet signing. Strictly read-only: decodes ERC-20 approve, NFT setApprovalForAll, EIP-2612/Permit2 signatures, and recursive multicall while reading live RPC bytecode and EIP-1967/1167 slots to return SAFE/WARNING/BLOCK_DRAINER (PROCEED/CAUTION/ABORT) and unsigned revocation calldata. Costs $0.10 USDC on Base via x402 v2 (unpaid returns isError: true); active critical compromises require 0.15% SLA or 5%-10% Safe-Harbor bounty settlement to unmask spender coordinates. Call before signing transactions; use ingravity_scanTokenRugpullAndHoneypot for token due diligence without calldata.
Esquema de entrada
{
"type": "object",
"properties": {
"to": {
"type": "string",
"description": "Target EVM contract, token, or recipient 42-character hex address (0x...)."
},
"data": {
"type": "string",
"description": "Hexadecimal transaction calldata (0x...); pass '0x' for a plain native ETH transfer."
},
"from": {
"type": "string",
"description": "Optional sender wallet address (0x...) also matched against active ZK-EC whale exposure dossiers."
},
"value": {
"type": "string",
"default": "0",
"description": "Optional native ETH value in wei as a decimal string."
},
"chainId": {
"type": "integer",
"enum": [
8453,
42161,
10,
137,
1
],
"default": 8453,
"description": "Target EVM chain ID for live RPC bytecode/EIP-1967 inspection (8453 Base, 42161 Arbitrum, 10 Optimism, 137 Polygon, 1 Ethereum; unknown falls back to 8453)."
},
"ticketId": {
"type": "string",
"description": "Optional ZK-EC blinded exposure ticket ID (TICKET-8453-...) to unseal full remediation coordinates upon x402 rescue settlement."
},
"capitalAtRiskUsd": {
"type": "number",
"description": "Optional protected capital value in USD for +0.15% Pre-Flight SLA / Safe-Harbor rescue quoting."
}
},
"required": [
"to"
]
}Esquema de salida
{
"type": "object",
"properties": {
"settled": {
"type": "boolean",
"description": "Whether x402 USDC payment settled cleanly."
},
"action": {
"type": "string",
"enum": [
"PROCEED",
"CAUTION",
"ABORT"
],
"description": "Pre-sign action recommendation."
},
"signal": {
"type": "string",
"enum": [
"GREEN_LIGHT",
"YELLOW_LIGHT",
"RED_LIGHT"
],
"description": "Traffic-light risk signal."
},
"decision": {
"type": "string",
"enum": [
"SAFE",
"CAUTION_REQUIRED",
"CRITICAL_RISK"
],
"description": "Normalized risk decision."
},
"verdict": {
"type": "string",
"enum": [
"SAFE",
"WARNING",
"BLOCK_DRAINER"
],
"description": "Detailed firewall classification."
},
"riskScore": {
"type": "number",
"description": "Cumulative risk score from 0 to 100."
},
"selector": {
"type": "string",
"description": "4-byte function selector ('0x' for empty calldata, 'INVALID' if malformed hex)."
},
"decodedAction": {
"type": "string",
"description": "Human-readable decoded calldata action."
},
"chainId": {
"type": "integer",
"description": "Resolved EVM chain ID used for live RPC inspection."
},
"savedCapitalEstimateUsd": {
"type": "string",
"description": "Estimated wallet value protected if drainer blocked."
},
"agentDirective": {
"type": "string",
"description": "Execution directive explaining how to proceed or revoke."
},
"decodedParams": {
"type": "object",
"description": "Decoded ABI arguments (e.g., spender, operator, owner, value, deadline).",
"additionalProperties": true
},
"liveOnChainForensics": {
"type": [
"object",
"null"
],
"description": "Live 5-EVM RPC bytecode and EIP-1967 proxy slot inspection (null when unavailable or malformed).",
"additionalProperties": true
},
"executableRemediationTx": {
"type": [
"object",
"null"
],
"description": "Unsigned EIP-5792 wallet_sendCalls and approve(spender, 0) calldata when spender is decoded (or lock notice when masked in pre-flight tier).",
"additionalProperties": true
},
"triggers": {
"type": "array",
"description": "Triggered drainer/permission heuristics and RPC checks.",
"items": {
"type": "object",
"additionalProperties": true
}
}
},
"required": [
"settled",
"action",
"signal",
"decision",
"verdict",
"riskScore",
"selector",
"decodedAction",
"chainId",
"savedCapitalEstimateUsd",
"agentDirective",
"triggers"
],
"additionalProperties": true
}🟢ingravity_computeDefiSlippageAndLiquidation(amm, leverage, tier)
Computes deterministic 18-decimal BigInt AMM swap outputs (amm: exact amount out, price impact, and 48-step MEV sandwich bounds) and/or perp liquidation limits (leverage: liquidation price and health factor). Runs pure off-chain math with zero RPC calls or on-chain side effects; pass amm, leverage, or both (omitting both returns -32602). Set tier to FULL ($0.10 USDC, default) for full metrics or ESSENTIAL ($0.04 USDC) for PROCEED/ABORT signal only; unpaid calls return isError: true with an x402 challenge (0.15%/5%-10% rescue fees apply only when settling exposed live-capital rescues). Use for swap or leverage math; use ingravity_inspectEvmTransactionFirewall for raw calldata.
Esquema de entrada
{
"type": "object",
"properties": {
"amm": {
"type": "object",
"description": "Optional constant-product AMM swap parameters (reserveIn, reserveOut, amountIn required when included; evaluated independently of leverage; supply amm, leverage, or both).",
"properties": {
"reserveIn": {
"type": "string",
"description": "Pool input token reserve in atomic base units as a positive integer string (> 0)."
},
"reserveOut": {
"type": "string",
"description": "Pool output token reserve in atomic base units as a positive integer string (> 0)."
},
"amountIn": {
"type": "string",
"description": "Proposed swap input amount in atomic base units as a positive integer string (> 0)."
},
"feeBps": {
"type": "integer",
"default": 30,
"minimum": 0,
"maximum": 9999,
"description": "Pool fee in basis points (0-9999; 30 = 0.30%)."
},
"userSlippageBps": {
"type": "integer",
"default": 100,
"minimum": 0,
"maximum": 9999,
"description": "Proposed slippage tolerance in basis points (0-9999; 100 = 1.00%)."
},
"estimatedSandwichGasInTokenIn": {
"type": "string",
"default": "0",
"description": "Optional attacker gas cost in input token atomic units (>= 0) used to filter unprofitable sandwich attacks."
}
},
"required": [
"reserveIn",
"reserveOut",
"amountIn"
]
},
"leverage": {
"type": "object",
"description": "Optional perpetual/margin position parameters for exact liquidation price and initial health factor (entryPrice required when included; evaluated independently of amm).",
"properties": {
"entryPrice": {
"type": "string",
"description": "Position entry price as a positive decimal string with up to 18 decimals (e.g., '2500.00')."
},
"leverage": {
"type": "string",
"default": "1",
"description": "Leverage multiplier as a decimal string between '1' and '1000' (e.g., '10')."
},
"side": {
"type": "string",
"enum": [
"LONG",
"SHORT"
],
"default": "LONG",
"description": "Position direction: LONG or SHORT."
},
"maintenanceMarginBps": {
"type": "integer",
"default": 50,
"minimum": 0,
"maximum": 9999,
"description": "Maintenance margin threshold in basis points (0-9999; 50 = 0.50%)."
},
"feeBufferBps": {
"type": "integer",
"default": 10,
"minimum": 0,
"maximum": 9999,
"description": "Fee buffer in basis points deducted from initial margin (0-9999; 10 = 0.10%)."
}
},
"required": [
"entryPrice"
]
},
"tier": {
"type": "string",
"enum": [
"FULL",
"ESSENTIAL"
],
"default": "FULL",
"description": "Billing & output depth: FULL ($0.10 USDC) returns exact amm and leverage structures; ESSENTIAL ($0.04 USDC) returns top-level action, signal, and savedCapitalEstimateUsd only."
}
},
"anyOf": [
{
"required": [
"amm"
]
},
{
"required": [
"leverage"
]
}
]
}Esquema de salida
{
"type": "object",
"properties": {
"settled": {
"type": "boolean",
"description": "Whether x402 USDC payment settled cleanly."
},
"action": {
"type": "string",
"enum": [
"PROCEED",
"ABORT_HIGH_MEV_RISK",
"ABORT_CRITICAL_LIQUIDATION_RISK"
],
"description": "Trade or margin risk gate decision."
},
"signal": {
"type": "string",
"enum": [
"GREEN_LIGHT",
"RED_LIGHT"
],
"description": "Traffic-light execution signal."
},
"savedCapitalEstimateUsd": {
"type": "string",
"description": "Estimated MEV or liquidation loss avoided."
},
"amm": {
"type": "object",
"description": "Exact BigInt swap metrics and optimal MEV sandwich profitability bounds (FULL tier only, when amm supplied).",
"additionalProperties": true
},
"leverage": {
"type": "object",
"description": "Exact liquidation price, distance-to-liquidation %, and health factor (FULL tier only, when leverage supplied).",
"additionalProperties": true
},
"proportionalRescueCommissionPolicy": {
"type": "object",
"description": "0.15% Pre-Flight swap and 5%-10% Safe-Harbor terms (FULL tier only).",
"additionalProperties": true
}
},
"required": [
"settled",
"action",
"signal",
"savedCapitalEstimateUsd"
],
"additionalProperties": true
}🟢ingravity_scanTokenRugpullAndHoneypot(tokenAddress, chainId, code, tokenName, tier)
Audits an ERC-20 token for honeypots, hidden mints, blacklists, abusive taxes, paused swaps, and stealth proxies using deployed tokenAddress (live 5-EVM RPC bytecode scan), pre-deploy Solidity code, or both (omitting both returns -32602). Read-only across chainId (default 8453 Base; tokenName labels the output), returning verdict, canSell, rugProbabilityScore (0-100), and PROCEED/CAUTION/ABORT. Set tier to FULL ($0.12 USDC, default) for evidence and sellSimulation, or ESSENTIAL ($0.04 USDC) for verdict scalars only; unpaid calls return isError: true (0.15% SLA or 5%-10% Safe-Harbor split applies to live-TVL rescue fixes). Use before swapping tokens; use ingravity_auditSolidityContract for general Solidity source.
Esquema de entrada
{
"type": "object",
"properties": {
"tokenAddress": {
"type": "string",
"description": "Deployed 42-char EVM ERC-20 contract address (0x...) inspected via live RPC bytecode & proxy slots (no Solidity source required). Provide tokenAddress, code, or both."
},
"chainId": {
"type": "integer",
"enum": [
8453,
42161,
10,
137,
1
],
"default": 8453,
"description": "EVM Chain ID for RPC lookup when tokenAddress is supplied (8453 Base, 42161 Arbitrum, 10 Optimism, 137 Polygon, 1 Ethereum; unknown falls back to 8453)."
},
"code": {
"type": "string",
"description": "Optional Solidity (.sol) source code for pre-deployment 14-rule rugpull AST scan or hybrid source + bytecode analysis."
},
"tokenName": {
"type": "string",
"description": "Optional token ticker or label echoed in the report."
},
"tier": {
"type": "string",
"enum": [
"FULL",
"ESSENTIAL"
],
"default": "FULL",
"description": "Billing & output depth: FULL ($0.12 USDC) returns sellSimulation, liveOnChainForensics, risk pillars, and forensicEvidence; ESSENTIAL ($0.04 USDC) returns verdict, canSell, score, and action scalars only."
}
},
"anyOf": [
{
"required": [
"tokenAddress"
]
},
{
"required": [
"code"
]
}
]
}Esquema de salida
{
"type": "object",
"properties": {
"settled": {
"type": "boolean",
"description": "Whether x402 USDC payment settled cleanly."
},
"action": {
"type": "string",
"enum": [
"PROCEED",
"CAUTION",
"ABORT"
],
"description": "Trade safety gate recommendation."
},
"signal": {
"type": "string",
"enum": [
"GREEN_LIGHT",
"YELLOW_LIGHT",
"RED_LIGHT"
],
"description": "Traffic-light risk indicator."
},
"decision": {
"type": "string",
"enum": [
"SAFE",
"UNVERIFIED_RPC",
"CRITICAL_HONEYPOT_RISK"
],
"description": "Normalized sellability decision."
},
"canSell": {
"type": "boolean",
"description": "True when no transfer locks, honeypot hooks, or blocking traps were detected."
},
"verdict": {
"type": "string",
"enum": [
"CLEAN",
"CAUTION_CENTRALIZED",
"HIGH_RUG_RISK",
"CRITICAL_HONEYPOT_SCAM",
"UNVERIFIED_RPC"
],
"description": "Overall rugpull/honeypot verdict."
},
"rugProbabilityScore": {
"type": "number",
"description": "Weighted rugpull risk score from 0 to 100."
},
"isHoneypotLikely": {
"type": "boolean",
"description": "True if explicit sell-blocking or honeypot trap signatures matched."
},
"inspectionMode": {
"type": "string",
"description": "Whether inspection used live RPC bytecode, static Solidity AST, or hybrid."
},
"tokenName": {
"type": "string",
"description": "Resolved token name label."
},
"tokenAddress": {
"type": [
"string",
"null"
],
"description": "Inspected token address (null when scanning pre-deploy code only)."
},
"chainId": {
"type": "integer",
"description": "Resolved EVM chain ID."
},
"sellSimulation": {
"type": "object",
"description": "Simulated sellability and liquidity-lock indicators (FULL tier only).",
"additionalProperties": true
},
"liveOnChainForensics": {
"type": [
"object",
"null"
],
"description": "Live RPC bytecode size, proxy implementation, owner status, and pause state (FULL tier only).",
"additionalProperties": true
},
"pillars": {
"type": "object",
"description": "Boolean breakdown across 6 rugpull pillars (FULL tier only).",
"additionalProperties": true
},
"forensicEvidence": {
"type": "array",
"description": "Matched AST and bytecode rules with snippets (FULL tier only).",
"items": {
"type": "object",
"additionalProperties": true
}
}
},
"required": [
"settled",
"action",
"signal",
"decision",
"canSell",
"verdict",
"rugProbabilityScore",
"isHoneypotLikely",
"inspectionMode",
"tokenName",
"chainId"
],
"additionalProperties": true
}🟢ingravity_generateMultiContractProtocolDossier(protocolName, tvlTargetUsd, chainId, contractAddress, ownerTreasury, ...)
Audits 1-20 interdependent Solidity contracts (contracts array of {name, code}, required; optional protocolName and tvlTargetUsd=1000000) for cross-contract read-only reentrancy, centralization, and 6 ERC-4626/oracle invariants. Strictly read-only: pass optional contractAddress, chainId (8453 Base default, 42161, 10, 137, 1), and ownerTreasury to verify live RPC TVL and build unsigned EIP-5792/EOA Safe-Harbor rescue steps (90%-95% to ownerTreasury). Set tier to FULL ($12.00 USDC, default) for call-graph and findings or ESSENTIAL ($3.50 USDC) for score and counts; unpaid returns isError: true, empty contracts throws -32602, and CRITICAL/HIGH patches stay sealed until 0.15% SLA or 5%-10% rescue settlement. Use for multi-file protocols; use ingravity_auditSolidityContract for single files or ingravity_simulateDeepExploitAndWhitehatBounty without source.
Esquema de entrada
{
"type": "object",
"properties": {
"protocolName": {
"type": "string",
"default": "DeFi Protocol",
"description": "DeFi protocol or project name echoed in executiveSummary."
},
"tvlTargetUsd": {
"type": "number",
"default": 1000000,
"minimum": 0,
"description": "Target or declared TVL in USD used for bug bounty reward calibration when live RPC TVL is absent or lower."
},
"chainId": {
"type": "integer",
"enum": [
8453,
42161,
10,
137,
1
],
"default": 8453,
"description": "EVM Chain ID used when optional contractAddress is supplied for live RPC liquidity lookup (8453 Base, 42161 Arbitrum, 10 Optimism, 137 Polygon, 1 Ethereum; unknown falls back to 8453)."
},
"contractAddress": {
"type": "string",
"description": "Optional deployed EVM vault/pool address (0x...) on chainId for live RPC TVL verification and unsigned Safe-Harbor rescue bundle generation."
},
"ownerTreasury": {
"type": "string",
"description": "Optional protocol multisig/treasury recipient (0x...) designated to receive 90%-95% of rescued funds in unsigned Safe-Harbor calldata."
},
"contracts": {
"type": "array",
"minItems": 1,
"maxItems": 20,
"description": "Non-empty array of Solidity contracts belonging to the protocol (1 to 20 {name, code} objects; additional items beyond 20 are ignored).",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Contract filename or identifier (e.g., AegisVault.sol)."
},
"code": {
"type": "string",
"description": "Non-empty Solidity (.sol) source code for this contract."
}
},
"required": [
"name",
"code"
]
}
},
"tier": {
"type": "string",
"enum": [
"FULL",
"ESSENTIAL"
],
"default": "FULL",
"description": "Billing & output depth: FULL ($12.00 USDC) returns callGraphEdges, per-contract findings, invariants, and Safe-Harbor rescue calldata (subject to Anti-Bypass sealing on CRITICAL/HIGH until proportional settlement); ESSENTIAL ($3.50 USDC) returns readiness score, grade, status, and severity counts only."
}
},
"required": [
"contracts"
]
}Esquema de salida
{
"type": "object",
"properties": {
"settled": {
"type": "boolean",
"description": "Whether x402 USDC payment settled cleanly."
},
"action": {
"type": "string",
"enum": [
"PROCEED",
"CAUTION",
"ABORT"
],
"description": "Protocol deployment gate directive."
},
"signal": {
"type": "string",
"enum": [
"GREEN_LIGHT",
"YELLOW_LIGHT",
"RED_LIGHT"
],
"description": "Traffic-light risk indicator."
},
"protocolName": {
"type": "string",
"description": "Evaluated protocol name."
},
"chainId": {
"type": "integer",
"description": "Resolved EVM chain ID."
},
"protocolSecurityScore": {
"type": "number",
"description": "Weighted multi-contract security score from 0 to 100."
},
"grade": {
"type": "string",
"enum": [
"A",
"B",
"C",
"D",
"F"
],
"description": "Letter grade derived from protocolSecurityScore."
},
"deploymentReadiness": {
"type": "string",
"enum": [
"READY_FOR_CONTEST",
"REMEDIATION_REQUIRED",
"BLOCK_LAUNCH"
],
"description": "Launch readiness classification."
},
"verifiedOnChainTvlUsd": {
"type": "number",
"description": "Live on-chain TVL verified via RPC when contractAddress is supplied (0 otherwise)."
},
"summary": {
"type": "object",
"description": "Aggregated finding severity totals and failed invariant count.",
"properties": {
"CRITICAL": {
"type": "integer"
},
"HIGH": {
"type": "integer"
},
"MEDIUM": {
"type": "integer"
},
"LOW": {
"type": "integer"
},
"GAS": {
"type": "integer"
},
"failedInvariantsCount": {
"type": "integer"
}
},
"required": [
"CRITICAL",
"HIGH",
"MEDIUM",
"LOW",
"GAS",
"failedInvariantsCount"
],
"additionalProperties": true
},
"executiveSummary": {
"type": "object",
"description": "Consolidated protocol score, LOC, centralizationRiskIndex, and readiness breakdown (FULL tier only).",
"additionalProperties": true
},
"contractAudits": {
"type": "array",
"description": "Per-contract security audits and findings (FULL tier only).",
"items": {
"type": "object",
"additionalProperties": true
}
},
"crossContractAnalysis": {
"type": "object",
"description": "Cross-contract call graph, read-only reentrancy findings, admin privilege map, and invariant checks (FULL tier only).",
"additionalProperties": true
},
"bugBountyCalibration": {
"type": "object",
"description": "Recommended bounty reward schedule by severity calibrated to TVL (FULL tier only).",
"additionalProperties": true
},
"capitalSalvageAndSafeHarbor": {
"type": "object",
"description": "Unsigned Safe-Harbor rescue bundle or optional pre-deploy circuit breaker (FULL tier only).",
"additionalProperties": true
},
"proportionalRescueCommissionPolicy": {
"type": "object",
"description": "0.15% Pre-Flight SLA and 5%-10% Safe-Harbor settlement metadata (FULL tier only).",
"additionalProperties": true
}
},
"required": [
"settled",
"action",
"signal",
"protocolName",
"chainId",
"protocolSecurityScore",
"grade",
"deploymentReadiness",
"verifiedOnChainTvlUsd",
"summary"
],
"additionalProperties": true
}🟢ingravity_simulateDeepExploitAndWhitehatBounty(protocolName, poolAddress, chainId, ownerTreasury, tvlUsd, ...)
Simulates flash-loan drain vectors, oracle slot0/reserve exposure, and live on-chain TVL across five EVM chains for a target protocol (protocolName required; poolAddress defaults to Base Aerodrome address when omitted, tvlUsd defaults to 250000). Strictly read-only: reads live RPC liquidity and optional Solidity code to compute exploitImmunityScore and unsigned EIP-5792/EOA Safe-Harbor rescue calldata (90%-95% to optional ownerTreasury, 5%-10% whitehat bounty on rescue only) without transferring funds. Set tier to FULL ($45.00 USDC, default) for flashLoanSimulation and rescue bundle or ESSENTIAL ($9.50 USDC) for vulnerabilitySeverity and score; unpaid calls return isError: true and CRITICAL/HIGH PoCs stay sealed under Anti-Bypass. Use for live pool exploitability and rescue planning; use ingravity_generateMultiContractProtocolDossier for multi-file codebase audits.
Esquema de entrada
{
"type": "object",
"properties": {
"protocolName": {
"type": "string",
"description": "Target protocol or pool identifier (non-empty string required)."
},
"poolAddress": {
"type": "string",
"default": "0x420DD381b31aEf6683db6B902084cB0FFECe40Da",
"description": "Target 42-char EVM pool or vault contract address (0x...) inspected via live RPC on chainId."
},
"chainId": {
"type": "integer",
"enum": [
8453,
42161,
10,
137,
1
],
"default": 8453,
"description": "Target EVM chain ID for live RPC bytecode and TVL verification (8453 Base, 42161 Arbitrum, 10 Optimism, 137 Polygon, 1 Ethereum; unknown falls back to 8453)."
},
"ownerTreasury": {
"type": "string",
"description": "Optional protocol owner/multisig recipient (0x...) receiving 90%-95% of assets in the generated unsigned Safe-Harbor calldata."
},
"tvlUsd": {
"type": "number",
"default": 250000,
"minimum": 0,
"description": "Declared pool TVL in USD; automatically overridden upward if live on-chain RPC TVL exceeds it."
},
"code": {
"type": "string",
"description": "Optional Solidity (.sol) contract source code to include static exploit, honeypot, and slot0 manipulation analysis."
},
"tier": {
"type": "string",
"enum": [
"FULL",
"ESSENTIAL"
],
"default": "FULL",
"description": "Billing & output depth: FULL ($45.00 USDC) returns flashLoanSimulation, liveOnChainPoolForensics, and unsigned Safe-Harbor rescue bundle; ESSENTIAL ($9.50 USDC) returns vulnerabilitySeverity, exploitImmunityScore, and summary counts only."
}
},
"required": [
"protocolName"
]
}Esquema de salida
{
"type": "object",
"properties": {
"settled": {
"type": "boolean",
"description": "Whether x402 USDC payment settled cleanly."
},
"action": {
"type": "string",
"enum": [
"PROCEED",
"CAUTION",
"ABORT"
],
"description": "Recommended exploit mitigation action."
},
"signal": {
"type": "string",
"enum": [
"GREEN_LIGHT",
"YELLOW_LIGHT",
"RED_LIGHT"
],
"description": "Traffic-light severity indicator."
},
"tier": {
"type": "string",
"description": "Service classification identifier ('institutional_whale_bounty')."
},
"protocol": {
"type": "string",
"description": "Evaluated protocol identifier."
},
"poolAddress": {
"type": "string",
"description": "Target EVM pool or vault address inspected."
},
"chainId": {
"type": "integer",
"description": "Resolved EVM chain ID."
},
"verifiedOnChainTvlUsd": {
"type": "number",
"description": "Live on-chain TVL verified via RPC (0 if unavailable or undeployed)."
},
"tvlAnalyzedUsd": {
"type": "number",
"description": "Effective TVL used for whitehat bounty calculation."
},
"exploitImmunityScore": {
"type": "number",
"description": "Estimated exploit immunity score from 0 to 100."
},
"vulnerabilitySeverity": {
"type": "string",
"enum": [
"CRITICAL_EXPLOITABLE",
"HIGH_ARBITRAGEABLE",
"LOW_RESILIENT"
],
"description": "Overall exploitability tier."
},
"summary": {
"type": "object",
"description": "Critical/High severity counts, live TVL, and entitled whitehat bounty summary.",
"properties": {
"CRITICAL": {
"type": "integer"
},
"HIGH": {
"type": "integer"
},
"verifiedOnChainTvlUsd": {
"type": "number"
},
"entitledSafeHarborBountyUsdc": {
"type": "number"
}
},
"required": [
"CRITICAL",
"HIGH",
"verifiedOnChainTvlUsd",
"entitledSafeHarborBountyUsdc"
],
"additionalProperties": true
},
"liveOnChainPoolForensics": {
"type": [
"object",
"null"
],
"description": "Live RPC bytecode and proxy storage slot forensics for poolAddress (FULL tier only).",
"additionalProperties": true
},
"whitehatRescuePlan": {
"type": "object",
"description": "90%-95% owner / 5%-10% whitehat split economics and private relay instructions (FULL tier only).",
"additionalProperties": true
},
"capitalSalvageAndSafeHarbor": {
"type": "object",
"description": "Unsigned EIP-5792/EOA Safe-Harbor execution bundle (FULL tier only).",
"additionalProperties": true
},
"flashLoanSimulation": {
"type": "object",
"description": "Spot price oracle manipulation and reentrancy vector assessment (FULL tier only).",
"additionalProperties": true
},
"auditDetails": {
"type": [
"object",
"string"
],
"description": "Detailed static audit findings when code is provided, or RPC summary note (FULL tier only)."
},
"proportionalRescueCommissionPolicy": {
"type": "object",
"description": "Anti-Bypass and Safe-Harbor bounty policy metadata (FULL tier only).",
"additionalProperties": true
}
},
"required": [
"settled",
"action",
"signal",
"tier",
"protocol",
"poolAddress",
"chainId",
"verifiedOnChainTvlUsd",
"tvlAnalyzedUsd",
"exploitImmunityScore",
"vulnerabilitySeverity",
"summary"
],
"additionalProperties": true
}Comunidad
Evidencia