simulate_transaction
Simulate unsigned Xahau transactions by executing hook bytecode against live ledger state. Reports per-hook results, state writes, and scam score to predict outcomes before signing.
Instructions
THE PRE-SIGN FLIGHT SIMULATOR — predict what Xahau will do with an UNSIGNED transaction before you sign it. Every hook the tx would trigger (originator chain first, then strong/weak transactional stakeholders — order canonical from xahaud Transactor.cpp/applyHook.cpp) runs as REAL bytecode against LIVE ledger state in the local VM (measured 100% agreement on 30 real mainnet hook executions — all accept-direction; rollback direction proven separately on real genesis bytecode). Reports per-hook accept/rollback + return strings, simulated state writes, decoded emitted transactions, labeled STATIC engine preflights (sequence/balance/destination/expiry), an APPROXIMATE transactor prediction (the stand-in for Xahau's missing simulate RPC — predicted engine_result + balance/reserve/trustline deltas for Payment/TrustSet against live state, labeled APPROXIMATE; other tx types UNSUPPORTED), and a scam score. Never signs, never submits. Slow but thorough (iterative state resolution, ~1.1s per read).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tx | Yes | unsigned transaction JSON (TransactionType, Account, ...) | |
| network | No | mainnet |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | ||
| notes | No | ||
| caveat | No | ||
| summary | No | ||
| verdict | No | ||
| hookRuns | No | ||
| scamScore | No | ||
| baseTxHash | No | ||
| historical | No | ||
| transactor | No | ||
| ledgerIndex | No | ||
| staticChecks | No | ||
| overriddenFields | No |