nullclear_simulate_transaction
Dry-run an unsigned Ethereum or Base transaction before signing to confirm success, estimate gas, decode revert reasons, and verify allowance safety.
Instructions
Execute a live eth_call and eth_estimateGas dry-run on Base or Ethereum BEFORE signing or broadcasting an unsigned transaction. Use this immediately before wallet execution when you have target to + data and need to confirm whether the call will succeed, estimate gas, and verify allowance safety (100 free calls/day/IP). Returns simulation success, gas estimate, decoded revert reason if any, and recommendedAgentAction. Do NOT use for standalone hex bytes without to or past mined tx hashes (use nullclear_decode_calldata).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"to": "<to>"
},
"name": "nullclear_simulate_transaction"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | Destination 0x smart contract or recipient address | |
| data | No | 0x-prefixed hex calldata payload for the simulated call | 0x |
| from | No | Sender 0x EVM address whose balance/allowance context will be simulated | |
| chain | No | Target EVM chain ('base' or 'eth', default 'base') | base |
| value | No | Native wei amount as hex ('0x0') or decimal string | 0x0 |