actions.preview
Simulates a list of transactions in sequence against the latest Base block, as if the wallet sent them one after the other, before anything is signed. Each step sees the state the previous ones left (an approval before a mint works). Accepts steps with target or to, calldata or data, and optional value and gas. Returns, per step, whether it would succeed, the gas it uses, whether the gas limit it carries is enough, and the decoded revert reason when it fails; and the net token and ETH movements for the wallet. State can change before transactions land: a successful preview is evidence, not a guarantee.
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": {
"from": "<from>",
"steps": "<steps>"
},
"name": "actions.preview"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| from | Yes | The wallet that will send the steps. | |
| steps | Yes | The steps, in order: target and calldata (or their send_calls spellings, to and data), value in wei (optional), gas (optional). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| from | No | ||
| note | No | ||
| block | No | The block the simulation ran on. | |
| steps | Yes | Per step: success, gas used, whether the given limit is enough, recommended limit, revert reason. | |
| would_succeed | Yes | True only if every step succeeds in the simulation. | |
| balance_changes | Yes | Net token and ETH movements for the wallet. | |
| first_failing_step | No |