go-blockchain/explorer_command.go

// Copyright (c) 2017-2026 Lethean (https://lt.hn)
//
// Licensed under the European Union Public Licence (EUPL) version 1.2.
// SPDX-License-Identifier: EUPL-1.2

package blockchain

import (
	"context"
	"os"
	"os/signal"
	"path/filepath"
	"sync"

	coreerr "dappco.re/go/core/log"

	cli "dappco.re/go/core/cli/pkg/cli"
	store "dappco.re/go/core/store"

	"dappco.re/go/core/blockchain/chain"
	"dappco.re/go/core/blockchain/tui"
	"github.com/spf13/cobra"
)

// newChainExplorerCommand builds the interactive `chain explorer` command.
// Use it alongside `AddChainCommands` to expose the TUI node view.
func newChainExplorerCommand(dataDir, seed *string, testnet *bool) *cobra.Command {
	return &cobra.Command{
		Use:   "explorer",
		Short: "TUI block explorer",
		Long:  "Interactive terminal block explorer with live sync status.",
		RunE: func(cmd *cobra.Command, args []string) error {
			return runChainExplorer(*dataDir, *seed, *testnet)
		},
	}
}

func runChainExplorer(dataDir, seed string, testnet bool) error {
	if err := ensureChainDataDir(dataDir); err != nil {
		return err
	}

	dbPath := filepath.Join(dataDir, "chain.db")
	s, err := store.New(dbPath)
	if err != nil {
		return coreerr.E("runChainExplorer", "open store", err)
	}
	defer s.Close()

	c := chain.New(s)
	cfg, forks := resolveChainConfig(testnet, &seed)

	ctx, cancel := signal.NotifyContext(context.Background(), os.Interrupt)
	defer cancel()

	var wg sync.WaitGroup
	wg.Add(1)
	go func() {
		defer wg.Done()
		runChainSyncLoop(ctx, c, &cfg, forks, seed)
	}()

	node := tui.NewNode(c)
	status := tui.NewStatusModel(node)
	explorer := tui.NewExplorerModel(c)
	hints := tui.NewKeyHintsModel()

	frame := cli.NewFrame("HCF")
	frame.Header(status)
	frame.Content(explorer)
	frame.Footer(hints)
	frame.Run()

	cancel()  // Signal the sync loop to stop.
	wg.Wait() // Wait for it before closing store.
	return nil
}