Skip to content

docs(security): add reliability and liveness page - #2089

Merged
soheimam merged 7 commits into
masterfrom
docs/kb-gaps-devrel-815-security-reliability
Oct 9, 2026
Merged

docs(security): add reliability and liveness page#2089
soheimam merged 7 commits into
masterfrom
docs/kb-gaps-devrel-815-security-reliability

Conversation

@youssefea

@youssefea youssefea commented Oct 8, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

What changed? Why?

  • Adds a "Reliability and Liveness" page under Specifications → Security: status page and incident history, a table of third-party audits (base/contracts, base/base, Immunefi, OP Stack), censorship resistance via L1 deposits and the sequencing window, and the open-source sequencer components.
  • Links "Transaction Ordering" to the open-source component list.
  • Regenerates AGENTS.md, llms.txt and llms-full.txt.

Notes to reviewers

Audit dates and scopes are taken from the audit READMEs and report cover pages in base/contracts and base/base.

How has it been tested?

node scripts/lint-mdx.js on changed files, node scripts/validate-docs-structure.js, npm test; external links checked.

Screenshots

Not captured.

Generated with Toshi

@mintlify

mintlify Bot commented Oct 8, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
base 🟢 Ready View Preview Oct 9, 2026, 1:44 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

@cb-heimdall

cb-heimdall commented Oct 8, 2026 •
edited
Loading

Copy link
Copy Markdown
Collaborator

✅ Heimdall Review Status

Requirement Status More Info
Reviews ✅ 1/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
Sum 1

@linear

linear Bot commented Oct 8, 2026

Copy link
Copy Markdown

DEVREL-815

@youssefea youssefea changed the title docs(security): add security and reliability page docs(security): add reliability and liveness page Oct 8, 2026
leopoldjoy
leopoldjoy reviewed Oct 9, 2026
View reviewed changes
Comment thread docs/specifications/security/reliability-and-liveness.mdx Outdated
Comment thread docs/specifications/security/reliability-and-liveness.mdx Outdated
Comment thread docs/docs.json
"group": "Security",
"pages": [
"specifications/security/security-council-for-base",
"specifications/security/reliability-and-liveness",

@leopoldjoy leopoldjoy Oct 9, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could we confirm this audit catalog belongs under Security, given that docs/ia-guidelines.md:134 explicitly excludes audit reports from that section?

@youssefea youssefea Oct 9, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good catch. The page no longer hosts audit reports or a catalog. It has one short section pointing to the canonical audit indexes in the source repos, which I read as navigation rather than audit content under ia-guidelines.md:134. If you'd rather drop that pointer from Security altogether, I'm happy to remove it.

🤖 Reply generated with Toshi

Comment thread docs/llms.txt Outdated
@cb-heimdall

cb-heimdall commented Oct 9, 2026

Copy link
Copy Markdown
Collaborator

Review Error for b40150650-design @ 2026-10-09 03:47:35 UTC
User failed mfa authentication, either user does not exist or public email is not set on your github profile. \ see go/mfa-help

@youssefea Toshi
docs(security): address review on reliability and liveness page
e023d4e 
- Link canonical audit indexes instead of duplicating their catalogs
- Reword verification claim to derivation from L1-published data
- Regenerate llms.txt and llms-full.txt

Co-authored-by: Toshi <toshi-noreply@coinbase.com>
@soheimam
soheimam merged commit 9228350 into master Oct 9, 2026
15 checks passed
@soheimam
soheimam deleted the docs/kb-gaps-devrel-815-security-reliability branch October 9, 2026 14:29

This branch was successfully deployed

1 active deployment
staging - docs — 6f845559 Deployed Oct 9, 2026 by mintlify[bot]
View deployment
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@leopoldjoy leopoldjoy leopoldjoy left review comments
@soheimam soheimam soheimam approved these changes
+1 more reviewer
@b40150650-design b40150650-design b40150650-design approved these changes
Reviewers whose approvals may not affect merge requirements

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

5 participants

@youssefea @cb-heimdall @leopoldjoy @soheimam @b40150650-design