[jdjioe5-cpu]

Summary

Resolves #2344.

Adds a comprehensive cookbook guide (\cookbook/fees-and-resources.mdx) explaining the differences between Stellar inclusion fees and Soroban resource fees, and demonstrating when each CLI fee argument and command should be used.

Contents Included

• Fee Types Overview:
  • Inclusion Fee: Validator inclusion economics, surge pricing, minimum 100 stroops base fee, unit explanation (stroop vs XLM).
  • Resource Fee: Soroban VM compute resources (CPU instructions, memory, ledger read/write bytes/entries) and breakdown into non-refundable vs refundable fees (storage rent, return values, event deposits).
• Quick Reference Table:
  • Comparison of --inclusion-fee, --fee\ (deprecated), --resource-fee, --instruction-leeway, --cost, \stellar fees stats, \stellar fees use, \stellar fees unset, and \stellar tx fetch fee.
• Hands-On Recipes & Examples:
  1. Setting custom inclusion fees for congestion/surge pricing (--inclusion-fee).
  2. Inspecting detailed Soroban resource consumption and cost breakdowns on stderr (--cost).
  3. Adding instruction leeway for contracts with dynamic execution paths (--instruction-leeway).
  4. Manually overriding simulated resource fees (--resource-fee).
  5. Fetching real-time network fee percentiles from RPC (\stellar fees stats).
  6. Setting persistent default inclusion fees globally or dynamically (\stellar fees use\ / \stellar fees unset).
  7. Auditing past transaction fees and refunded storage rent deposits (\stellar tx fetch fee).
• Best Practices & Troubleshooting:
  • Development defaults, Mainnet gas optimization tips, and common error resolution (\ x_insufficient_fee, \ExceededBudget).