Skip to content

docs(l2): add aligned failure recovery docs#5869

Merged
xqft merged 3 commits into
mainfrom
docs/l2/aligned_failure_recovery
Jan 23, 2026
Merged

docs(l2): add aligned failure recovery docs#5869
xqft merged 3 commits into
mainfrom
docs/l2/aligned_failure_recovery

Conversation

@avilagaston9
Copy link
Copy Markdown
Contributor

@avilagaston9 avilagaston9 commented Jan 15, 2026

Motivation

We are missing docs about how to react when Aligned Layer experiences failures, from temporary outages to permanent shutdown scenarios.

Description

Adds an Aligned failure recovery guide for operators

Checklist

  • Updated STORE_SCHEMA_VERSION (crates/storage/lib.rs) if the PR includes breaking changes to the Store requiring a re-sync.

Closes #5858

@github-actions github-actions Bot added the L2 Rollup client label Jan 15, 2026
@avilagaston9 avilagaston9 marked this pull request as ready for review January 15, 2026 21:43
@avilagaston9 avilagaston9 requested a review from a team as a code owner January 15, 2026 21:43
Copilot AI review requested due to automatic review settings January 15, 2026 21:43
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR adds comprehensive documentation for handling Aligned Layer failure scenarios when operating ethrex L2 in Aligned mode. The documentation covers various failure scenarios from temporary outages to permanent shutdown, providing operators with step-by-step recovery procedures.

Changes:

  • Added a new failure recovery guide with 5 distinct failure scenarios and recovery procedures
  • Added reference links to the failure recovery guide in existing Aligned documentation
  • Included monitoring guidance and troubleshooting steps

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 5 comments.

File Description
docs/l2/deployment/aligned_failure_recovery.md New comprehensive guide covering 5 failure scenarios with detailed recovery procedures, SQL commands, and monitoring guidance
docs/l2/fundamentals/ethrex_l2_aligned_integration.md Added reference link to the new failure recovery guide
docs/l2/deployment/aligned.md Added failure recovery section with link to the new guide

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/l2/deployment/aligned_failure_recovery.md
Comment thread docs/l2/deployment/aligned_failure_recovery.md
Comment thread docs/l2/deployment/aligned_failure_recovery.md
Comment thread docs/l2/deployment/aligned_failure_recovery.md
Comment thread docs/l2/deployment/aligned_failure_recovery.md
Copy link
Copy Markdown
Collaborator

@ilitteri ilitteri left a comment

Choose a reason for hiding this comment

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

Looks good. SQL queries match actual schema, cross-references valid, well-structured.

Minor: consider verifying the exact CLI flag format (--proof-coordinator.proof-send-interval-ms) matches the implementation.

@avilagaston9
Copy link
Copy Markdown
Contributor Author

Minor: consider verifying the exact CLI flag format (--proof-coordinator.proof-send-interval-ms) matches the implementation.
@ilitteri

Done here!

@xqft xqft added this pull request to the merge queue Jan 23, 2026
Merged via the queue into main with commit 6ad50a7 Jan 23, 2026
44 checks passed
@xqft xqft deleted the docs/l2/aligned_failure_recovery branch January 23, 2026 17:57
Oppen pushed a commit that referenced this pull request Jan 27, 2026
**Motivation**

We are missing docs about how to react when Aligned Layer experiences
failures, from temporary outages to permanent shutdown scenarios.

**Description**

Adds an Aligned failure recovery guide for operators

**Checklist**

- [ ] Updated `STORE_SCHEMA_VERSION` (crates/storage/lib.rs) if the PR
includes breaking changes to the `Store` requiring a re-sync.

Closes #5858
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

audit L2 Rollup client

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

L2: Detail in the docs how to act as an operator when Aligned is unresponsive (in Aligned mode)

5 participants