Celestia Node v0.25.2 Release Notes

This patch release includes additional API breaking changes that further improve consistency across the node API. Please review these changes carefully before upgrading from v0.25.0 or v0.25.1.

TL;DR

• ⚠ Additional API Breaking Changes

  • Share Samples API now uses height parameter instead of ExtendedHeader
  • Share encoding in Samples response changed to base64 string (was object with data field)
  • Pruner config removed → Use --archival flag exclusively to disable pruning

• Config Update Required (if upgrading from pre-v0.25.0)

  celestia <node_type> config-update

🚨 Breaking Changes (Additional to v0.25.0)

Pruner Configuration Removal

• fix(nodebuilder/pruner)!: Remove pruner config from nodes config by @renaynay in #4482

Changes:

• The pruner configuration field has been completely removed from node config files
• Pruning behavior is now controlled exclusively via command-line flags

Migration:

• Remove any pruner-related configuration from your config files
• To run an archival node (disable pruning): MUST use --archival flag when starting the node
• Default behavior (without flag): Pruning enabled with 30-day retention

Share API Consistency Improvements

Samples Method Signature Change

• !fix(api/share) use height in Samples method by @walldiss in #4481

Changes:

• Samples method now accepts height parameter directly
• No longer requires passing ExtendedHeader
• Brings consistency with other share module methods

Migration:

// Before:
samples, err := client.Share.GetSamples(ctx, header)

// After:
samples, err := client.Share.GetSamples(ctx, height)

Share Encoding in Samples Response

• !fix(api/share) encode share in sample json as base64 by @walldiss in #4480

Changes:

• Shares in GetSamples response now encoded as base64 strings
• Previously encoded as objects with data field
• Matches encoding format used by GetRow and other methods

Migration:

// Before (v0.25.0-v0.25.1):
{
  "share": {
    "data": "AAAAAAA...base64..."
  },
  "proof": { ... }
}

// After (v0.25.2+):
{
  "share": "AAAAAAA...base64...",
  "proof": { ... }
}

Update JSON parsing to expect shares as direct base64 strings rather than nested objects.

Full Changelog: v0.25.1...v0.25.2