Quickstart

Decode your first failed transaction in under 60 seconds.

Follow these steps to diagnose a failed Soroban transaction using the Grat CLI.

1. Identify a failed transaction

   Find a transaction hash (tx_hash) that failed with a cryptic error like Error(Contract, #3).

2. Run the decode command

   bash Terminal grat decode abc123def456... --network testnet
3. Review the diagnostic report

   Grat will resolve the error and provide a clear explanation. text Diagnostic Report: ------------------ Error: InsufficientBalance (resolved from #3) Contract: CD...123 (MyTokenContract) Reason: The sender does not have enough XLM to complete the transfer. Suggested Fix: Ensure the account has at least 10 XLM before retrying.

What’s Next?

Trace Execution

See exactly where the budget was spent.

Interactive Debugging

Set breakpoints and step through host calls.