Skip to content

docs(protect): correct the Transaction Status API page - #662

Merged
bakhtin merged 4 commits into
mainfrom
docs/status-api-accuracy
Nov 19, 2026
Merged

bakhtin merged 4 commits into
mainfrom
docs/status-api-accuracy

Conversation

@quintuskilbourn

@quintuskilbourn quintuskilbourn commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

Vibe-coded with an AI agent: please rewrite if you know a better way.

Brings the Transaction Status API page in line with what the API does today, and removes the deprecated Sepolia endpoints. Two files, wording only.

Changes

status-api.md

  • Remove the Sepolia status URL. Sepolia is deprecated and protect-sepolia.flashbots.net/tx/ returns 502.
  • Say that the API covers transactions sent through the Protect RPC and keeps each one for 45 minutes. Update the UNKNOWN description to match.
  • Remove the claim that transaction fields are only disclosed for INCLUDED transactions, and fill in those fields in the PENDING example. The handler returns them for every transaction it finds.
  • Add a sentence and link on the TEE environment to the fast mode paragraph.
  • Use the simError values the API returns: no SimError prefix, InvalidChainIdForSigner in place of InvalidChainId, and a new Other row.

quick-start.mdx

  • Remove the Sepolia RPC row.

How this was checked

Against the code:

  • simError values: protect-status-api/domain/sim.go at 57c5905.
  • transaction fields: protect-status-api/ports/handler.go builds them from the stored transaction for every status.
  • Retention: protect-of-api/adapters/redisstore/redisstore.go at 7e13fde writes each record with a default TTL of one hour (PRIVATE_TXS_REDIS_TTL can override it). The page says 45 minutes to leave a margin.

Against the live API, 2026-11-18, 223 sampled Protect submissions looked up at https://protect.flashbots.net/tx/<hash>:

  • Sent through the Protect RPC and under 60 minutes old: 46 of 49 returned INCLUDED or FAILED.
  • Same, over 60 minutes old: 98 of 98 returned UNKNOWN.
  • All 31 FAILED responses had the transaction fields filled in, 24 of them with fastMode: false.

Please check

  • The PENDING example with filled-in fields follows the handler code. A live pending response was not observed.

  • If production sets PRIVATE_TXS_REDIS_TTL to something other than the default, correct the 45 minutes.

🤖 Generated with Claude Code

…simError names, drop Sepolia)

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@vercel

vercel Bot commented Nov 18, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
flashbots-docs Ready Ready Preview Nov 18, 2026 9:22pm UTC

Request Review

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
…a RPC row

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@bakhtin
bakhtin merged commit 282dcdd into main Nov 19, 2026
3 checks passed
@bakhtin
bakhtin deleted the docs/status-api-accuracy branch November 19, 2026 09:25

This branch was successfully deployed

1 active deployment
Preview — 65a8bb5a Deployed Nov 18, 2026 by vercel[bot]
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.

2 participants