simulate_transaction
Simulate a transaction to preview estimated fees, balance changes, and policy compliance. Avoid side effects.
Instructions
Simulate a transaction without executing it. Returns policy tier, estimated fees, balance changes, and warnings. No side effects.
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>",
"amount": "<amount>"
},
"name": "simulate_transaction"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | Destination address | |
| amount | Yes | Amount in smallest units (wei for EVM, lamports for Solana). Example: "1000000000000000000" = 1 ETH | |
| type | No | Transaction type. Default: TRANSFER | |
| token | No | Required for TOKEN_TRANSFER | |
| calldata | No | Hex-encoded calldata (EVM) | |
| abi | No | ABI fragment (EVM) | |
| value | No | Native token value in smallest units (wei for EVM). Example: "1000000000000000000" = 1 ETH | |
| programId | No | Solana program ID | |
| instructionData | No | Base64-encoded instruction data (Solana) | |
| accounts | No | Solana accounts | |
| spender | No | Spender address (APPROVE type) | |
| instructions | No | Batch instructions array | |
| network | No | Target network (e.g., "polygon-mainnet" or CAIP-2 "eip155:137"). | |
| wallet_id | No | Wallet ID for multi-wallet sessions | |
| gas_condition | No | Gas price condition (included for request compatibility, ignored by simulation) |