evstack / evstack/apex

Track celestia-node API v1 migration (blob_v1, share_v1)

Open
#21 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Go
Stars
4
Forks
0
PR merge metrics
No merged PRs in 30d

Description

## 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

- [celestiaorg/celestia-node#4308](https://github.com/celestiaorg/celestia-node/issues/4308) — EPIC: API v1 release with dataroot proof structure
- [celestiaorg/celestia-node#4306](https://github.com/celestiaorg/celestia-node/issues/4306) — Create share_v1, blob_v1 API modules
- [celestiaorg/celestia-node#4307](https://github.com/celestiaorg/celestia-node/issues/4307) — Deprecate share and blob API v0
- [celestiaorg/celestia-node#3919](https://github.com/celestiaorg/celestia-node/issues/3919) — Deprecate `blob.Included()` method

## 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

- [ ] Monitor upstream progress on #4308
- [ ] When blob_v1 ships, update apex #2 (JSON-RPC layer) to support both v0 and v1
- [ ] Update `GetProof` stub to match new proof-via-Get pattern
- [ ] Plan deprecation of `Included` from apex API
- [ ] Ensure apex response types include `app_version` for downstream consumers ([celestiaorg/celestia-node#3977](https://github.com/celestiaorg/celestia-node/issues/3977))

## Related apex issues

- #2 — JSON-RPC compatibility layer (must support v0 + v1)
- #14 — Subscription improvements (subscribe API may change in v1)

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.