cli/cmd/chaincmd/chain.go

// Copyright (C) 2022-2025, Lux Industries Inc. All rights reserved.
// See the file LICENSE for licensing terms.

package chaincmd

import (
	"github.com/luxfi/cli/cmd/chaincmd/upgradecmd"
	"github.com/luxfi/cli/pkg/application"
	"github.com/luxfi/cli/pkg/cobrautils"
	"github.com/spf13/cobra"
)

var app *application.Lux

// NetworkTarget represents the target network for chain operations
type NetworkTarget string

const (
	NetworkMainnet NetworkTarget = "mainnet"
	NetworkTestnet NetworkTarget = "testnet"
	NetworkDevnet  NetworkTarget = "devnet"
	NetworkCustom  NetworkTarget = "custom"
)

// Network target flags
var (
	mainnet bool
	testnet bool
	devnet  bool
	custom  bool
)

// GetNetworkTarget returns the selected network target based on flags
func GetNetworkTarget() NetworkTarget {
	switch {
	case mainnet:
		return NetworkMainnet
	case testnet:
		return NetworkTestnet
	case devnet:
		return NetworkDevnet
	case custom:
		return NetworkCustom
	default:
		return NetworkCustom
	}
}

// addNetworkFlags adds network target flags to a command
func addNetworkFlags(cmd *cobra.Command) {
	cmd.Flags().BoolVarP(&mainnet, "mainnet", "m", false, "Target mainnet")
	cmd.Flags().BoolVarP(&testnet, "testnet", "t", false, "Target testnet")
	cmd.Flags().BoolVarP(&devnet, "devnet", "d", false, "Target devnet")
	cmd.Flags().BoolVar(&custom, "custom", false, "Target custom network")
}

// NewCmd creates the unified chain command suite for all blockchain operations
func NewCmd(injectedApp *application.Lux) *cobra.Command {
	app = injectedApp
	cmd := &cobra.Command{
		Use:   "chain",
		Short: "Manage blockchain lifecycle - create, deploy, import, export, validate",
		Long: `The chain command provides unified operations for blockchain management.

OVERVIEW:

  The chain command suite handles the complete blockchain lifecycle from
  configuration creation through deployment and operation. It works with
  chain configurations stored in ~/.lux/chains/.

CHAIN TYPES:

  L1 (Sovereign)  - Independent validator set, own tokenomics
  L2 (Rollup)     - Based on L1 sequencing (Lux, Ethereum, etc.)
  L3 (App Chain)  - Built on L2 for application-specific use

CORE COMMANDS:

  create       Create a new blockchain configuration
  deploy       Deploy to local network, testnet, or mainnet
  list         List all configured blockchains
  describe     Show detailed blockchain information
  delete       Delete a blockchain configuration

DATA OPERATIONS:

  import       Import blocks from RLP file to running chain

NETWORK FLAGS (for deployment):

  --mainnet, -m    Deploy to mainnet (port 9630)
  --testnet, -t    Deploy to testnet (port 9640)
  --devnet, -d     Deploy to devnet (port 9650)
  --custom         Deploy to custom network

EXAMPLES:

  # Create a new L2 blockchain
  lux chain create mychain

  # Create a sovereign L1
  lux chain create mychain --type=l1

  # Deploy to local devnet
  lux chain deploy mychain --devnet

  # Deploy to testnet
  lux chain deploy mychain --testnet

  # List all configured chains
  lux chain list

  # Import historical blocks
  lux chain import c ~/work/lux/state/rlp/mainnet.rlp --mainnet

  # Delete a chain configuration
  lux chain delete mychain

TYPICAL WORKFLOW:

  1. Create configuration:  lux chain create mychain
  2. Start network:         lux network start --devnet
  3. Deploy chain:          lux chain deploy mychain --devnet
  4. Verify deployment:     lux chain list
  5. Check endpoints:       lux network status

NOTES:

  - Chain configurations are stored in ~/.lux/chains/<name>/
  - Each chain has a genesis.json and sidecar.json
  - Chains can be deployed to multiple networks (local, testnet, mainnet)
  - Use 'lux chain delete' to remove configurations
  - Network must be running before deployment`,
		RunE: cobrautils.CommandSuiteUsage,
	}

	// Core lifecycle commands
	createCmd := newCreateCmd()
	addNetworkFlags(createCmd)
	cmd.AddCommand(createCmd)

	deployCmd := newDeployCmd()
	// Note: deploy already has network flags, skip adding duplicates
	cmd.AddCommand(deployCmd)

	listCmd := newListCmd()
	addNetworkFlags(listCmd)
	cmd.AddCommand(listCmd)

	describeCmd := newDescribeCmd()
	addNetworkFlags(describeCmd)
	cmd.AddCommand(describeCmd)

	deleteCmd := newDeleteCmd()
	addNetworkFlags(deleteCmd)
	cmd.AddCommand(deleteCmd)

	// Data operations
	importCmd := newImportCmd()
	addNetworkFlags(importCmd)
	cmd.AddCommand(importCmd)

	// Upgrade
	cmd.AddCommand(upgradecmd.NewCmd(app))

	// Launch — full ecosystem deployment from chain.yaml
	launchCmd := newLaunchCmd()
	cmd.AddCommand(launchCmd)

	return cmd
}