{"uid":"cap_yJXd7GezvUHed01oetuvF","slug":"evm-contract-call-simulator-eth-call-with-revert-decoding-e4c2883f","name":"EVM Contract Call Simulator (eth_call with Revert Decoding)","description":"Read-only EVM contract call (eth_call) with decoded revert reason and optional gas estimate — simulate before you sign","url":"https://agent.connskill.com/chain/v1/chain-call","method":"POST","headers":{},"bodySchema":{"type":"object","required":["chain","to"],"properties":{"to":{"type":"string","description":"Contract address to call (0x…)"},"data":{"type":"string","description":"ABI-encoded calldata (0x…), e.g. 0x70a08231… for balanceOf"},"from":{"type":"string","description":"Caller address — when set, a gas estimate is included"},"block":{"type":"string","description":"latest (default), safe, finalized, earliest, or hex block number"},"chain":{"type":"string","description":"One of: base, ethereum, arbitrum, optimism, polygon"},"value":{"type":"string","description":"Value in wei (hex or decimal string)"}}},"responseSchema":{"type":"object","properties":{"result":{"type":"string"},"status":{"type":"string"},"reverted":{"type":"boolean"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dy1bMELZwQ_DYcWJCsaxy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Executes a read-only EVM smart contract call (eth_call) on supported chains, returning the decoded result, revert reason, and optional gas estimate — without broadcasting a transaction.","exampleAgentPrompt":"Can you simulate calling the balanceOf function on the USDC contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 — use the latest block and also give me the gas estimate?","exampleUseCases":[{"title":"Check token balance via contract call","prompt":"Simulate a balanceOf call on the USDC contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum for address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 using calldata 0x70a08231000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045 — tell me the raw result."},{"title":"Debug a reverting contract call","prompt":"I'm getting a revert when calling my contract at 0x1234567890abcdef1234567890abcdef12345678 on Base with calldata 0xabcdef01 — can you simulate it at the latest block and tell me why it's reverting?"},{"title":"Gas estimate before DeFi transaction","prompt":"Before I sign anything, can you simulate calling 0xDefiContractAddress on Arbitrum with calldata 0x38ed1739 from my wallet 0xMySenderAddress and give me the gas estimate so I know what to expect?"}],"resultDescription":"Returns a JSON object with: `result` (hex-encoded return data from the call), `status` (success or failure string), and `reverted` (boolean indicating whether the call reverted). When a `from` address is provided, a gas estimate is also included. If the call reverts, the decoded revert reason is surfaced in the response.","failureModes":["Invalid or non-existent contract address returns reverted: true with an error message","Malformed ABI-encoded calldata causes a revert or empty result","Unsupported chain name returns a validation error","Block tag referencing a pruned or unavailable block may return an error","Network timeout or RPC provider unavailability returns a 5xx error","Missing required fields (chain or to) return a 400-level validation error"],"whenToPreferThis":"Choose this endpoint when you need to read on-chain EVM contract state or simulate a transaction before signing, especially when you want decoded revert reasons rather than raw hex errors. It supports 5 major EVM chains (Base, Ethereum, Arbitrum, Optimism, Polygon) and includes optional gas estimation in a single call. Prefer it over raw RPC calls when you need human-readable revert decoding and a clean JSON response without managing your own RPC provider.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:40:01.488Z","isFirstParty":false}