Ingravity Autonomous EVM Security & DeFi Guard (x402 v2)
5-EVM pre-sign firewall, ERC-20 honeypot scanner, DeFi MEV math & Solidity audit via x402.
Should I use this
Quality & Safety
Findings (14)
- LOWin ingravity_fastPingAddressSafety
- LOWin ingravity_fastPingAddressSafety
- LOWin ingravity_auditSolidityContract
- LOWin ingravity_auditSolidityContract
- LOWin ingravity_inspectEvmTransactionFirewall
- LOWin ingravity_inspectEvmTransactionFirewall
- LOWin ingravity_computeDefiSlippageAndLiquidation
- LOWin ingravity_computeDefiSlippageAndLiquidation
- LOWin ingravity_scanTokenRugpullAndHoneypot
- LOWin ingravity_scanTokenRugpullAndHoneypot
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"ingravity-security": {
"command": "npx",
"args": [
"ingravity-security"
]
}
}
}Runnable packages
1.3.3stdioRemote endpoints
https://red-shape-1b3b.daviddelmoral79.workers.dev/mcpstreamable-httpWhat it can do
Tool inventory
Tools (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.
Input Schema
{
"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"
]
}Output Schema
{
"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.
Input Schema
{
"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"
]
}Output Schema
{
"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.
Input Schema
{
"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"
]
}Output Schema
{
"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.
Input Schema
{
"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"
]
}
]
}Output Schema
{
"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.
Input Schema
{
"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"
]
}
]
}Output Schema
{
"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.
Input Schema
{
"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"
]
}Output Schema
{
"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.
Input Schema
{
"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"
]
}Output Schema
{
"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
}Community
Evidence