Tastora

Tastora is a testing and development framework for Celestia blockchain applications. It provides Docker-based containerization for different node types (Bridge, Light, Full) and comprehensive testing utilities for blockchain development.

Overview

Tastora simplifies the process of setting up and testing Celestia blockchain nodes by providing:

• Docker-based containerization for different node types.
• Abstractions for working with the Celestia Data Availability (DA) layer.
• Utilities for blockchain testing and development.

The implementation of the docker backend is largely based on the interchaintest framework. It is has been modified and tailored to specifically work within the Celestia ecosystem.

Installation

Prerequisites

• Go 1.23.6 or higher
• Docker
• golangci-lint (for linting)

Installing

# Clone the repository
git clone https://github.com/celestiaorg/tastora.git
cd tastora

# Install dependencies
go mod download

Usage

Tastora provides a framework for testing and developing Celestia blockchain applications. Here are some basic examples:

Basic DA Network Setup

package main

import (
    "context"
    "testing"

    "github.com/celestiaorg/tastora/framework/docker"
)

func TestCelestiaNodes(t *testing.T) {
    ctx := context.Background()

    // Create a basic DA network with default ports
    daNetwork, err := docker.NewDANetwork(ctx, "test-network")
    if err != nil {
        t.Fatal(err)
    }
    defer daNetwork.Cleanup(ctx)

    // Start the network
    err = daNetwork.Start(ctx)
    if err != nil {
        t.Fatal(err)
    }
}

Network Information

All nodes provide standardized network information through GetNetworkInfo():

// Get network info from any node
networkInfo, err := node.GetNetworkInfo(ctx)
if err != nil {
    t.Fatal(err)
}

// Access network details
internalRPCAddr := networkInfo.Internal.RPCAddress()  // "hostname:26657"
externalRPCAddr := networkInfo.External.RPCAddress()  // "0.0.0.0:32145"

DA nodes support custom port configuration:

// Configure DA node with custom ports
customPorts := types.Ports{
    RPC:      "27000",  // DA node RPC port
    P2P:      "3000",   // DA node P2P port  
    CoreRPC:  "26657",  // celestia-app RPC port
    CoreGRPC: "9090",   // celestia-app GRPC port
}

bridgeNodeConfig := da.NewNodeBuilder().
    WithNodeType(types.BridgeNode).
    WithInternalPorts(customPorts).
    Build()

Fine-Grained Wallet Control

Tastora supports creating wallets on specific chain nodes, providing flexibility for testing scenarios that require granular control over wallet placement and key management.

Node-Specific Wallet Creation

Create wallets on specific validators or full nodes:

// Create wallet on a specific validator
wallet1, err := chain.Validators[0].CreateWallet(ctx, "test-key-1", "celestia")
if err != nil {
    t.Fatal(err)
}

// Create wallet on a different validator
wallet2, err := chain.Validators[1].CreateWallet(ctx, "test-key-2", "celestia") 
if err != nil {
    t.Fatal(err)
}

// Create wallet on a full node
wallet3, err := chain.FullNodes[0].CreateWallet(ctx, "test-key-3", "celestia")
if err != nil {
    t.Fatal(err)
}

Faucet Wallet Access

The faucet wallet is accessible on all validator nodes with automatically synchronized keys:

// Access faucet wallet from any validator
faucetWallet := chain.Validators[0].GetFaucetWallet()

// Or from another validator - same wallet, synchronized keys
faucetWallet2 := chain.Validators[1].GetFaucetWallet()

// Chain-level access works (delegates to Validator[0])
chainFaucetWallet := chain.GetFaucetWallet()

Backward Compatibility

Existing chain.CreateWallet() calls continue to work unchanged:

// This works exactly as before
wallet, err := chain.CreateWallet(ctx, "my-wallet")

Project Structure

• framework/ - Core framework code
  • docker/ - Docker-based implementations of nodes and chains
  • testutil/ - Testing utilities
  • types/ - Core type definitions

Testing

To run tests:

make test

Linting

To run linters:

make lint

To automatically fix linting issues:

make lint-fix

Related Projects

• Celestia App - The Celestia Consensus Node.
• Celestia Node - The Celestia DA Nodes.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.