Summary
celestia-node is introducing versioned API modules (blob_v1, share_v1) with breaking changes to proof structures and method signatures. Apex must track these changes to maintain compatibility.
Upstream issues
Breaking changes to track
blob_v1
Get(height, namespace, commitment) adds a proofs_only option — changes request signature
GetProof is removed as a standalone method (folded into Get with proofs_only=true)
Included is deprecated — replaced by proof validation methods
- Proof structure changes from namespace row proofs to "dataroot" proofs (more efficient)
share_v1
GetRange, GetShare, GetEDS, GetSharesByNamespace — new method signatures
- Index harmonization: EDS vs ODS indexes unified to ODS-only
Deprecation timeline
- v0 gets deprecation warnings in response headers after v1 ships
- Migration guide published
- v0 eventually removed
Action items
Related apex issues
Summary
celestia-node is introducing versioned API modules (
blob_v1,share_v1) with breaking changes to proof structures and method signatures. Apex must track these changes to maintain compatibility.Upstream issues
blob.Included()methodBreaking changes to track
blob_v1
Get(height, namespace, commitment)adds aproofs_onlyoption — changes request signatureGetProofis removed as a standalone method (folded intoGetwithproofs_only=true)Includedis deprecated — replaced by proof validation methodsshare_v1
GetRange,GetShare,GetEDS,GetSharesByNamespace— new method signaturesDeprecation timeline
Action items
GetProofstub to match new proof-via-Get patternIncludedfrom apex APIapp_versionfor downstream consumers (celestiaorg/celestia-node#3977)Related apex issues