Skip to main content

@effectstream/celestia

Package: @effectstream/celestia · Source

NPM wrapper around the Celestia node binaries. Installs a pinned version into node_modules/.bin/celestia so the EffectStream orchestrator can boot a local Celestia DA layer (node + bridge) for development and testing.

  • Pinned Celestia node + bridge binaries.
  • Ships start-node and start-bridge convenience scripts.
  • Consumed by @effectstream/sync's CelestiaFetcher.
  • E2E: e2e/celestia/.

Install​

bun add @effectstream/celestia
# or
npm install @effectstream/celestia

Standalone usage​

The package ships two convenience scripts (start-node and start-bridge) plus a raw celestia entrypoint:

# Run a Celestia consensus node
bunx @effectstream/celestia start-node --verbose

# Run a Celestia bridge node (against a running consensus node)
bunx @effectstream/celestia start-bridge --verbose

# Or pass arbitrary args
bunx celestia <celestia-cli args>

On install, the package fetches the pinned binary for your OS/arch.

Inside EffectStream​

The orchestrator's Celestia step uses start-node to bring up a local chain, and the EffectStream runtime consumes it through @effectstream/sync's CelestiaFetcher/CelestiaSyncState. See the e2e/celestia/ suite.