Stellar transaction simulator usage guide

[truthixify]

Tier: S (½-1 day) Type: writing

Context

Soroban simulateTransaction is powerful but underused. Document how to wire it for safe pre-flight in stealth payment flows.

Scope

Write docs/guides/stellar-tx-simulation.mdx:

• What simulation is (resource estimation, output preview, error decoding)
• When to use (always for Soroban contract calls, especially before signing)
• SDK helpers + raw RPC patterns
• Decoding simulation results (events, return values, fees)
• Handling sim failures (decode contract errors, show actionable user feedback)
• Demo's reference implementation walkthrough

Acceptance criteria

• Page committed
• Working code snippet end-to-end
• Linked from SDK Stellar and demo

Files to start with

• New: docs/guides/stellar-tx-simulation.mdx