docs: add transaction debugger guide

src/lib/docs-seo-metadata.test.ts

@@ -89,7 +89,7 @@ describe('docs SEO metadata', () => {
           /^seoTitle:/m.test(source) && path.relative(docsRoot, file) !== 'api/reference.mdx',
       )
 
-    expect(auditedPages).toHaveLength(106)
+    expect(auditedPages).toHaveLength(107)
 
     for (const { file, source } of auditedPages) {
       const title = frontmatterString(source, 'title')

src/pages/docs/ecosystem/block-explorers.mdx

@@ -12,6 +12,8 @@ View transactions, blocks, accounts, and token activity on Tempo.
 
 Tempo's official Mainnet block explorer is available at [explore.tempo.xyz](https://explore.tempo.xyz). View transactions, blocks, accounts, and token activity on the Tempo network. Testnet block explorer is available at [explore.testnet.tempo.xyz](https://explore.testnet.tempo.xyz). For more connection information, see [Connect to the Network](/docs/quickstart/connection-details).
 
+The explorer also includes a [transaction debugger](https://explore.tempo.xyz/simulate) that simulates a transaction without broadcasting it. Follow the [transaction debugging guide](/docs/guide/debug-transactions) to inspect execution traces, balance changes, events, gas use, and revert details.
+
 ## Tenderly
 
 [Tenderly](https://tenderly.co) delivers full-stack observability, debugging, and simulation tools for Tempo smart contract development and monitoring. With Tenderly you get real-time error tracking, EVM-level tracing, and off-chain transaction simulation — enabling you to catch bugs, analyze reverts, and inspect gas usage before transactions go live.

src/pages/docs/guide/debug-transactions.mdx

@@ -0,0 +1,39 @@
+---
+title: "Simulate and debug Tempo transactions"
+seoTitle: "Tempo Transaction Debugger and Simulator | Tempo Docs"
+description: Simulate a Tempo transaction before submitting it, then inspect execution traces, balance changes, events, gas use, and revert details.
+---
+
+# Simulate and debug Tempo transactions
+
+Use the [Tempo transaction debugger](https://explore.tempo.xyz/simulate) to test a transaction against current Mainnet state without broadcasting it. Simulate a transaction to diagnose reverts or verify a contract interaction.
+
+:::info[What simulations show]
+- **Gas flame graphs** show which calls consume the most gas.
+- **State changes** show how balances and contract storage would change.
+- **Event logs** show the events the transaction would emit.
+- **Call traces** show the transaction's execution path across contracts.
+- **Revert errors** identify the call and error that caused a failure.
+:::
+
+## Run a transaction simulation
+
+:::::steps
+
+### Enter the transaction
+
+Open [explore.tempo.xyz/simulate](https://explore.tempo.xyz/simulate), then provide the sender, recipient, value, and calldata.
+
+### Simulate the transaction
+
+Run the simulation against current chain state.
+
+### Inspect the execution
+
+Review the decoded calls, balance changes, events, execution trace, gas use, and any revert details.
+
+:::::
+
+## Diagnose a failed transaction
+
+Start with the first reverted call in the execution trace. Its decoded error or return data usually identifies the contract and condition that rejected the transaction.

src/pages/docs/guide/tempo-transaction/index.mdx

@@ -17,6 +17,10 @@ Transaction [SDKs](#integration-guides) are available for TypeScript, Rust, Go,
 
 If you're integrating with Tempo, we **strongly recommend** using Tempo Transactions, and not regular Ethereum transactions. Learn more about the benefits below, or follow the guide on issuance [here](/docs/guide/issuance).
 
+:::tip[Debug failed transactions]
+If a transaction fails, use the [Tempo transaction debugger](/docs/guide/debug-transactions) to reproduce the failure and inspect its execution trace, balance changes, events, gas use, and revert details.
+:::
+
 <Cards>
   <Card
     description="Pay transaction fees with any USD-denominated TIP-20 token via automatic Fee AMM conversion."

src/pages/docs/tools.mdx

@@ -44,6 +44,12 @@ If you are integrating a product, start with the TypeScript SDKs and Tempo API.
 ## Operate and Inspect
 
 <Cards>
+  <Card
+    title="Transaction Debugger"
+    description="Simulate a transaction and inspect calls, balance changes, events, gas use, and reverts before broadcasting."
+    to="/docs/guide/debug-transactions"
+    icon="lucide:bug"
+  />
   <Card
     title="JSON-RPC API"
     description="Browse Tempo RPC methods, request shapes, and protocol-level API behavior."

vocs.config.ts

@@ -599,6 +599,10 @@ export default defineConfig({
             text: 'Use Tempo Transactions',
             link: '/docs/guide/tempo-transaction',
           },
+          {
+            text: 'Debug Transactions',
+            link: '/docs/guide/debug-transactions',
+          },
           {
             text: 'Get Testnet Faucet Funds',
             link: '/docs/quickstart/faucet',
@@ -1216,6 +1220,7 @@ export default defineConfig({
       '/docs/guide/machine-payments': buildSidebar,
       '/docs/quickstart': integrateSidebar,
       '/docs/guide/tempo-transaction': integrateSidebar,
+      '/docs/guide/debug-transactions': integrateSidebar,
       '/docs/guide/bridge-layerzero': integrateSidebar,
       '/docs/guide/bridge-bungee': integrateSidebar,
       '/docs/guide/bridge-relay': integrateSidebar,