Compatibility & Feature support matrix for Optimism components

[seromenho]

Description

It is currently challenging to verify version compatibility between Optimism components and determine which features are supported in each version. Given the frequent updates and evolving feature set, maintaining a clear reference for compatibility could significantly improve the developer experience.

Expected Behavior

A compatibility matrix (or documentation section) that:

• Lists key Optimism components (e.g., op-geth, op-node, op-batcher, op-proposer, op-stack)
• Displays supported versions and their compatibility with one another
• Clearly indicates which features are available in each version

Use Case

For example, while configuring a custom gas token on an Alt-DA mode deployment, verifying whether a specific release supports useCustomGasToken can be difficult. A version matrix would help developers quickly determine:

• Which versions are required to enable a feature
• Whether their current setup is compatible
• If any version mismatches could be causing unexpected behaviour

[tiagorvmartins]

Interested in this as well

[seromenho]

⚠️ Disclaimer: This table is purely a suggestion based on information gathered from the release notes. The versions listed were derived from the available releases and may not be fully accurate. Please take this as an example only, and verify compatibility based on your deployment needs.

🔍 Optimism components compatibility & feature support matrix

This matrix outlines the compatibility between various Optimism components across different versions, along with the support status for specific features like Alt-DA Mode and Span Batches.

📋 Compatibility Matrix

op-node Version	op-geth	op-batcher	op-proposer	op-contracts (L1/L2)	op-deployer	Alt-DA Mode	Span Batches	Notes
v1.11.1	v1.11.1	v1.11.1	v1.11.1	L1: v2.0.0-rc.1 L2: v2.0.0-rc.1	v0.3.0-rc.1	✔️	✔️	Latest release with full feature support
v1.9.1	v1.101408.0	v1.9.1	v1.9.1	L1: v2.0.0 L2: v2.0.0	v0.2.0	✔️	✔️	Stable release with Alt-DA and Span Batches support
v1.7.3	v1.101311.0	v1.7.3	v1.7.3	L1: v1.8.0 L2: v1.8.0	v0.0.11	❌	✔️	Introduced Span Batches; Alt-DA Mode not supported
v1.5.0	v1.101210.0	v1.5.0	v1.5.0	L1: v1.5.0 L2: v1.5.0	v0.0.9	❌	❌	Early release without Alt-DA and Span Batches support

Legend:

• ✔️ : Feature supported
• ❌ : Feature not supported

For detailed release notes and further information, please refer to the Optimism Releases page.

Note: Always ensure compatibility between components and features when planning deployments or upgrades.

[sledro]

Also interested in this. Versioning and supported features are very confusing at the moment.