Skip to content

docs(wallets): add Tenderly debugging documentation page#1182

Merged
Richard-Dang merged 16 commits intomainfrom
richard/ALC-531-docs-tenderly-debugging
Apr 10, 2026
Merged

docs(wallets): add Tenderly debugging documentation page#1182
Richard-Dang merged 16 commits intomainfrom
richard/ALC-531-docs-tenderly-debugging

Conversation

@Richard-Dang
Copy link
Copy Markdown
Contributor

Summary

Adds a new documentation page covering the Tenderly debugging integration for the Transaction Lifecycle Dashboard. The integration provides two workflows: direct Tenderly debugger links for onchain reverts, and one-click Tenderly simulations for offchain user operation failures. Also converts the "Debug transactions" nav entry from a single page to a collapsible section to accommodate the new sub-page.

Key changes

  • content/docs.yml -- Converted "Debug transactions" from a page to a section with collapsed: true, keeping index.mdx as the section overview and adding the new Tenderly page as a child
  • content/wallets/pages/transactions/debug-transactions/debug-with-tenderly.mdx -- New page covering:
    • Onchain failure debugging (Phase 1): Debug button opens Tenderly debugger for reverted transactions
    • Offchain failure debugging (Phase 2): Simulate button runs Tenderly simulation for bundler-rejected user operations
    • Supported networks table (25 networks across 14 chains)
    • Rate limits (10 simulations/team/hour with 24h caching)
    • Troubleshooting section for common issues
    • Links to Tenderly debugger and simulation docs

Technical details

  • Follows the existing section pattern used by "Sponsor gas" and "Send transactions" sections in docs.yml
  • Content derived from the dashboard implementation on richard/alc-528-frontend-phase-2-simulation-flow (separate Debug and Simulate buttons, eligibility conditions, rate limit behavior)
  • Screenshot placeholders ({/* TODO: Screenshot ... */}) are included for 7 key UI states; actual screenshots require Cloudinary uploads after the feature ships
  • References to Tenderly Debugger and Tenderly Simulations docs are included throughout

Testing

  • pnpm run lint passes (pre-existing Prettier issues in 2 unrelated files)
  • Verify nav structure renders correctly in preview
  • Verify all internal doc links resolve
  • Review content accuracy against dashboard implementation

Linear task

ALC-531

Create a new docs page covering both onchain and offchain Tenderly
debugging workflows for the Transaction Lifecycle Dashboard.
Convert the "Debug transactions" nav entry from a single page to a
section with the new "Debug with Tenderly" sub-page.

Linear: ALC-531
@Richard-Dang Richard-Dang requested a review from a team as a code owner April 6, 2026 21:14
@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 6, 2026

🔗 Preview Mode

Name Status Preview Updated (UTC)
Alchemy Docs ✅ Ready 🔗 Visit Preview Apr 10, 2026, 5:43 PM

@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 6, 2026

🔍 Link Check

Status: ❌ Failed

Summary

Status Count
🔍 Total 7350
✅ Successful 6219
⏳ Timeouts 0
🔀 Redirected 395
👻 Excluded 677
❓ Unknown 0
🚫 Errors 58
⛔ Unsupported 1
Broken links (58) — click to expand

Errors per input

Errors in ./content/api-reference/op-mainnet/op-mainnet-api-faq/op-mainnet-api-faq.mdx

Errors in ./content/changelog/2026-03-26.md

Errors in ./content/api-reference/hyperevm/hyperevm-api-overview.mdx

Errors in ./content/api-reference/arbitrum/arbitrum-api-faq/arbitrum-api-faq.mdx

Errors in ./content/wallets/pages/bundler-api/bundler-faqs.mdx

View workflow run

Richard-Dang and others added 15 commits April 6, 2026 17:19
Update links from docs.tenderly.co/simulations to
docs.tenderly.co/simulator-ui to match the actual Tenderly docs page.
…tenderly-debugging

# Conflicts:
#	content/docs.yml
Help developers understand which errors benefit from Tenderly's execution
trace (opaque revert data, generic reverts, third-party contract errors,
batch failures) and update the Simulate button screenshot.
@Richard-Dang Richard-Dang merged commit d2de863 into main Apr 10, 2026
7 of 8 checks passed
@Richard-Dang Richard-Dang deleted the richard/ALC-531-docs-tenderly-debugging branch April 10, 2026 17:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants