Skip to content

docs(eigenda): remove outdated v1 documentation and Blazar release notes#248

Open
mmurrs wants to merge 4 commits intomainfrom
cleanup/remove-eigenda-v1-docs
Open

docs(eigenda): remove outdated v1 documentation and Blazar release notes#248
mmurrs wants to merge 4 commits intomainfrom
cleanup/remove-eigenda-v1-docs

Conversation

@mmurrs
Copy link
Contributor

@mmurrs mmurrs commented Feb 2, 2026

Summary

  • Removes outdated EigenDA V1 documentation since Blazar (V2) is now the production standard
  • Removes Blazar release notes and migration guide (June 2025 migration deadline has passed)
  • Flattens API directory structure (no need for disperser-v2-API subfolder now that V1 is gone)
  • Cleans up broken internal links, outdated timeline references, and deprecated content

Changes

Removed (17 files, -1,569 lines)

  • docs/eigenda/releases/ - Blazar release notes (migration timeline completed)
  • docs/eigenda/operator-guides/blazar-migration.md - V1→V2 migration guide
  • docs/eigenda/api/disperser-v1-API/ - Complete V1 API documentation
  • docs/eigenda/integrations-guides/v1/ - V1 proxy and golang client guides
  • docs/eigenda/integrations-guides/quick-start/v1/ - V1 quick start
  • docs/eigenda/operator-guides/requirements/system-requirements-deprecated.md
  • static/img/integrations/proxy/proxy-v1.png
  • static/img/releases/v2-1.png

Restructured

  • api/disperser-v2-API/api/ (flattened, removed v2 subfolder)
  • Removed "v2" naming from API docs text since it's now the only version

Updated (6 files)

  • operator-guides/overview.md - Removed V1 migration section
  • networks/mainnet.md - Removed deprecated V1 specs
  • networks/hoodi.md - Simplified to V2-only batch interval
  • eigenda-proxy.md - Fixed broken V1 docs link
  • integrations-overview.md - Fixed broken blazar.md link
  • api/overview.md - Removed "v2" qualifier, updated proto links to master

Retained

V1 references in rollup guides (OP Stack, Orbit) that document migration paths for existing deployments needing to retrieve legacy V1 blobs.

Test plan

  • Verified no broken internal links to deleted files
  • Verified no broken internal links to moved files
  • Build verification (local build env has dependency issue unrelated to these changes)

🤖 Generated with Claude Code

EigenDA V2 (Blazar) has been live on mainnet since June 2025, with V1
now fully deprecated. This cleanup removes:

**Removed Files:**
- Blazar release notes and migration guide (migration timeline passed)
- Disperser API v1 documentation (4 files)
- V1 integration guides (proxy v1, golang client v1)
- V1 quick-start guide
- Deprecated system requirements
- Orphaned static assets (proxy-v1.png, v2-1.png)

**Updated Files:**
- operator-guides/overview.md: Removed v1 migration section
- networks/mainnet.md: Removed deprecated V1 specs section
- networks/hoodi.md: Simplified to V2-only specs
- eigenda-proxy.md: Removed broken v1 docs link
- integrations-overview.md: Removed broken blazar.md link

V1 references in rollup guides (OP Stack, Orbit) are retained as they
document migration paths for existing deployments that still need to
retrieve legacy V1 blobs.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@vercel
Copy link

vercel bot commented Feb 2, 2026

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

Project Deployment Actions Updated (UTC)
eigencloud-docs Ready Ready Preview Feb 16, 2026 10:29pm

Request Review

Remove "later 2025" permissionless dispersal timeline reference since
we are now in 2026. Also remove stale TODO comment.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Since V1 has been removed, the disperser-v2-API subfolder is no longer
needed. This flattens the structure:

  api/disperser-v2-API/overview.md -> api/overview.md
  api/disperser-v2-API/data-structures.md -> api/data-structures.md

Also removes "v2" qualifier from text since there's now only one API
version, and updates proto links to point to master branch.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
EigenDA V1 has been fully deprecated and removed from the codebase.
This PR updates the documentation to reflect that V2 is now simply
"EigenDA" - there's no need for version qualifiers.

Changes:
- networks/mainnet.md: "Blazar (V2) Specs" → "Network Specs"
- networks/sepolia.md: "Blob Explorer Blazar (V2)" → "Blob Explorer"
- operator-guides/requirements/system-requirements.md: Remove "Blazar (V2) upgrade" reference
- integrations-guides/rollup-guides/op-stack/README.md:
  - Remove V1 Settings dropdown
  - Remove "Migrating from V1" section (no longer needed)
  - "EigenDA V2 dispersals" → "EigenDA dispersals"
  - Fix capitalization: "eigenda-powered" → "EigenDA-powered"
  - Fix env var names to match actual config file
- integrations-guides/quick-start/v2/index.md: "V2 Guide" → "Guide" in sidebar
- api/overview.md: Fix broken relative links (pre-existing bug)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Copy link
Contributor

@bxue-l2 bxue-l2 left a comment

Choose a reason for hiding this comment

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

I got a bit verbose on the if-to-remove-files. But generally looks good to me

}
```

[1]: https://github.com/Layr-Labs/eigenda/blob/master/encoding/utils/codec/codec.go#L12
Copy link
Contributor

Choose a reason for hiding this comment

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

good to remove, very old doc


This table summarizes all the current status codes and their mappings to HTTP codes.

| Status | gRPC Error Code | HTTP Error Code | Use cases |
Copy link
Contributor

Choose a reason for hiding this comment

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

I don't think we have other places discussing error code. Maybe just move it under V2. What do you think @ethenotethan

Copy link
Contributor Author

Choose a reason for hiding this comment

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

any thoughts @ethenotethan ?

held by adversarial nodes before the availability of a blob is affected.


## Rate Limits
Copy link
Contributor

Choose a reason for hiding this comment

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

maybe good to move it under V2, given we still have rate limit there

<!-- TODO: Update to point to master, not a specific commit -->

Eigen Labs hosts one disperser endpoint for each EigenDA network. These endpoints are documented in respective network pages for [mainnet](../../networks/mainnet.md) and [testnet sepolia](../../networks/sepolia.md).

Copy link
Contributor

Choose a reason for hiding this comment

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

good to remove

title: V1 Guide
---

# Quick Start
Copy link
Contributor

Choose a reason for hiding this comment

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

good to remove

---

# Using the Golang Client for Authenticated Dispersal

Copy link
Contributor

Choose a reason for hiding this comment

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

good to remove


## About

EigenDA proxy is a sidecar server run as part of a rollup node cluster for communication with the EigenDA network. Information about
Copy link
Contributor

Choose a reason for hiding this comment

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

good to remove

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