Skip to content
LogoLogo

Get started with Celestia blobs

Post and retrieve your first blob with a transaction client. You can use public or managed endpoints without running your own node. Start on Mocha and use endpoints from the same network for both reading and submission.

There are two transaction clients available:

OptionWhat you needEndpoints to setGuides
GolangLocal keyring handled by the client2 — DA bridge RPC + Core gRPCGo client tutorial
RustLocal signer2 — DA bridge RPC + Core gRPCLumina Rust client and API documentation

Setup checklist

  1. Follow the Go tutorial prerequisites and project setup, including its toolchain and dependency versions. For Rust, use the Lumina client documentation linked above.

  2. Configure a DA bridge JSON-RPC URL for reads and a consensus Core gRPC address for submission. The Go tutorial uses these public Mocha endpoints:

    export CELE_DA_URL=https://public-endpoint.celestia-mocha.quiknode.pro
export CELE_DA_TLS=true
export CELE_CORE_GRPC=public-endpoint.celestia-mocha.quiknode.pro:9090
export CELE_CORE_TLS=true

  3. Check API authentication if using a self-hosted node or managed provider. Endpoint credentials and transaction signing keys serve different purposes. The public endpoints above do not require a provider credential.

  4. Run the Go tutorial to create a signer and print its address. Fund that address through the Mocha faucet, then rerun the same project. An account for signer ... not found error means the new account needs funding.

  5. Confirm that the retrieved data matches the submitted blob. Save the height, namespace, and commitment for later retrieval.

The environment variables above belong to the Go example; configure equivalent endpoints in the Rust client. For connection errors, check the network, TLS settings and endpoint credentials before retrying. The Go tutorial includes troubleshooting.

Costs and agent tools

Reading the docs and using the Celestia documentation MCP server are free. Blob submissions incur network fees; providers may charge separately. See Celestia blobspace fees before choosing a provider. The documentation MCP server searches these guides; it does not submit blobs or manage signing keys.

For Fibre storage on Mocha, follow Submit and retrieve a Fibre blob. That guide covers escrow, on-chain settlement, retrieval and the separate Fibre size limits.

Edit this page