Pre-Sign Calldata Simulator & Stateful Blockchain Transaction Tracker
simulate_evm_transaction_calldataSimulates raw EVM hex calldata (0x...), estimates gas/fees for pre-sign payload assembly, and tracks on-chain transaction execution state, confirmations, and receipts. Use when auditing calldata before signing or tracking execution state and confirmations after broadcast; for inspecting off-chain EIP-712 typed-data signatures, use decode_eip712_permit_signature instead. Stateless read-only edge call (max 32 KB, 60 RPM): accepts 'action' ('network' defaults to 'base_mainnet'), supports '?demo=true' or L402 (20 sats), and returns HTTP 400 if invalid.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "simulate_evm_transaction_calldata"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | No | Operation: 'simulate_calldata' to simulate/decode, 'prepare_transaction' to assemble payload, or 'track_tx_state'. | |
| network | No | Target EVM network for simulation context; defaults to 'base_mainnet' when omitted. | |
| tx_hash | No | Transaction hash (0x...) to track on-chain execution state and confirmation depth. | |
| calldata_hex | No | Hexadecimal EVM transaction data string starting with '0x' (e.g. '0x095ea7b3000000000000000000000000...'). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tx_state | No | On-chain transaction execution state, block height, and confirmation count. | |
| selector_hex | Yes | Extracted 4-byte function selector (e.g. '0x095ea7b3'). | |
| decoded_method | Yes | Human-readable ABI function signature matched to the selector. | |
| prepared_payload | No | Unsigned transaction payload with estimated gas and nonce ready for wallet signing. | |
| simulation_verdict | Yes | Pre-sign safety recommendation ('SAFE_CALLDATA' or 'HIGH_RISK_APPROVAL_DETECTED'). |