From 70b4a699e5b69fc8bd22e962f8eb63948c0e6442 Mon Sep 17 00:00:00 2001
From: Shobit garg <sho9213garg@gmail.com>
Date: Tue, 4 Feb 2025 12:26:11 +0530
Subject: [PATCH 1/2] changes

---
 cli/chain.go           | 1724 ++--------------------------------------
 cli/clicommands/cmd.go |   58 +-
 cli/index.go           |  256 ++----
 cli/miner/miner.go     |   62 +-
 cli/util/output.go     |   24 +
 5 files changed, 215 insertions(+), 1909 deletions(-)
 create mode 100644 cli/util/output.go

diff --git a/cli/chain.go b/cli/chain.go
index 0c25a881c6b..20a068e4d13 100644
--- a/cli/chain.go
+++ b/cli/chain.go
@@ -14,1698 +14,116 @@ import (
 	"path"
 	"sort"
 	"strconv"
-	"strings"
-	"time"
 
-	"github.com/ipfs/go-cid"
-	"github.com/urfave/cli/v2"
-	cbg "github.com/whyrusleeping/cbor-gen"
-	"golang.org/x/xerrors"
-
-	"github.com/filecoin-project/go-address"
-	cborutil "github.com/filecoin-project/go-cbor-util"
-	"github.com/filecoin-project/go-state-types/abi"
-	"github.com/filecoin-project/go-state-types/big"
-	"github.com/filecoin-project/specs-actors/actors/builtin"
-	"github.com/filecoin-project/specs-actors/actors/builtin/account"
-	"github.com/filecoin-project/specs-actors/actors/builtin/market"
-	"github.com/filecoin-project/specs-actors/actors/builtin/miner"
-	"github.com/filecoin-project/specs-actors/actors/builtin/power"
-	"github.com/filecoin-project/specs-actors/actors/util/adt"
-
-	"github.com/filecoin-project/lotus/api"
-	lapi "github.com/filecoin-project/lotus/api"
-	"github.com/filecoin-project/lotus/api/v0api"
-	"github.com/filecoin-project/lotus/build/buildconstants"
-	"github.com/filecoin-project/lotus/chain/actors"
-	"github.com/filecoin-project/lotus/chain/actors/policy"
-	"github.com/filecoin-project/lotus/chain/consensus"
-	"github.com/filecoin-project/lotus/chain/types"
+	"github.com/spf13/cobra"
+	"github.com/spf13/viper"
 )
 
-var ChainCmd = &cli.Command{
-	Name:  "chain",
-	Usage: "Interact with filecoin blockchain",
-	Subcommands: []*cli.Command{
-		ChainHeadCmd,
-		ChainGetBlock,
-		ChainReadObjCmd,
-		ChainDeleteObjCmd,
-		ChainStatObjCmd,
-		ChainGetMsgCmd,
-		ChainSetHeadCmd,
-		ChainListCmd,
-		ChainGetCmd,
-		ChainBisectCmd,
-		ChainExportCmd,
-		ChainExportRangeCmd,
-		SlashConsensusFault,
-		ChainGasPriceCmd,
-		ChainInspectUsage,
-		ChainDecodeCmd,
-		ChainEncodeCmd,
-		ChainDisputeSetCmd,
-		ChainPruneCmd,
-	},
-}
-
-var ChainHeadCmd = &cli.Command{
-	Name:  "head",
-	Usage: "Print chain head",
-	Flags: []cli.Flag{
-		&cli.BoolFlag{
-			Name:  "height",
-			Usage: "print just the epoch number of the chain head",
-		},
-	},
-	Action: func(cctx *cli.Context) error {
-		afmt := NewAppFmt(cctx.App)
-
-		api, closer, err := GetFullNodeAPI(cctx)
-		if err != nil {
-			return err
-		}
-		defer closer()
-		ctx := ReqContext(cctx)
-
-		head, err := api.ChainHead(ctx)
-		if err != nil {
-			return err
-		}
+var (
+	outputFormat string
+)
 
-		if cctx.Bool("height") {
-			afmt.Println(head.Height())
-		} else {
-			for _, c := range head.Cids() {
-				afmt.Println(c)
-			}
-		}
-		return nil
-	},
+func init() {
+	rootCmd.PersistentFlags().StringVarP(&outputFormat, "output", "o", "text", "Output format (json|text)")
 }
 
-var ChainGetBlock = &cli.Command{
-	Name:      "get-block",
-	Aliases:   []string{"getblock"},
-	Usage:     "Get a block and print its details",
-	ArgsUsage: "[blockCid]",
-	Flags: []cli.Flag{
-		&cli.BoolFlag{
-			Name:  "raw",
-			Usage: "print just the raw block header",
-		},
-	},
-	Action: func(cctx *cli.Context) error {
-		afmt := NewAppFmt(cctx.App)
-
-		api, closer, err := GetFullNodeAPI(cctx)
-		if err != nil {
-			return err
-		}
-		defer closer()
-		ctx := ReqContext(cctx)
-
-		if cctx.NArg() != 1 {
-			return IncorrectNumArgs(cctx)
-		}
-
-		bcid, err := cid.Decode(cctx.Args().First())
-		if err != nil {
-			return err
-		}
-
-		blk, err := api.ChainGetBlock(ctx, bcid)
-		if err != nil {
-			return xerrors.Errorf("get block failed: %w", err)
-		}
-
-		if cctx.Bool("raw") {
-			out, err := json.MarshalIndent(blk, "", "  ")
-			if err != nil {
-				return err
-			}
-
-			afmt.Println(string(out))
-			return nil
-		}
-
-		msgs, err := api.ChainGetBlockMessages(ctx, bcid)
-		if err != nil {
-			return xerrors.Errorf("failed to get messages: %w", err)
-		}
-
-		pmsgs, err := api.ChainGetParentMessages(ctx, bcid)
-		if err != nil {
-			return xerrors.Errorf("failed to get parent messages: %w", err)
-		}
-
-		recpts, err := api.ChainGetParentReceipts(ctx, bcid)
-		if err != nil {
-			log.Warn(err)
-			// return xerrors.Errorf("failed to get receipts: %w", err)
-		}
-
-		cblock := struct {
-			types.BlockHeader
-			BlsMessages    []*types.Message
-			SecpkMessages  []*types.SignedMessage
-			ParentReceipts []*types.MessageReceipt
-			ParentMessages []cid.Cid
-		}{}
-
-		cblock.BlockHeader = *blk
-		cblock.BlsMessages = msgs.BlsMessages
-		cblock.SecpkMessages = msgs.SecpkMessages
-		cblock.ParentReceipts = recpts
-		cblock.ParentMessages = apiMsgCids(pmsgs)
+func rootCmd() *cobra.Command {
+	var rootCmd = &cobra.Command{
+		Use:   "lotus",
+		Short: "Lotus CLI",
+	}
 
-		out, err := json.MarshalIndent(cblock, "", "  ")
-		if err != nil {
-			return err
-		}
+	// Add subcommands here
 
-		afmt.Println(string(out))
-		return nil
-	},
+	return rootCmd
 }
 
-func apiMsgCids(in []lapi.Message) []cid.Cid {
-	out := make([]cid.Cid, len(in))
-	for k, v := range in {
-		out[k] = v.Cid
+func main() {
+	if err := rootCmd().Execute(); err != nil {
+		fmt.Println(err)
+		os.Exit(1)
 	}
-	return out
 }
 
-var ChainReadObjCmd = &cli.Command{
+var ChainReadObjCmd = &cobra.Command{
 	Name:      "read-obj",
 	Usage:     "Read the raw bytes of an object",
 	ArgsUsage: "[objectCid]",
-	Action: func(cctx *cli.Context) error {
-		afmt := NewAppFmt(cctx.App)
-
-		api, closer, err := GetFullNodeAPI(cctx)
-		if err != nil {
-			return err
-		}
-		defer closer()
-		ctx := ReqContext(cctx)
-
-		if cctx.NArg() != 1 {
-			return IncorrectNumArgs(cctx)
-		}
-
-		c, err := cid.Decode(cctx.Args().First())
-		if err != nil {
-			return fmt.Errorf("failed to parse cid input: %s", err)
-		}
-
-		obj, err := api.ChainReadObj(ctx, c)
-		if err != nil {
-			return err
-		}
-
-		afmt.Printf("%x\n", obj)
-		return nil
-	},
-}
-
-var ChainDeleteObjCmd = &cli.Command{
-	Name:        "delete-obj",
-	Usage:       "Delete an object from the chain blockstore",
-	Description: "WARNING: Removing wrong objects from the chain blockstore may lead to sync issues",
-	ArgsUsage:   "[objectCid]",
-	Flags: []cli.Flag{
-		&cli.BoolFlag{
-			Name: "really-do-it",
-		},
-	},
-	Action: func(cctx *cli.Context) error {
-		afmt := NewAppFmt(cctx.App)
-
-		api, closer, err := GetFullNodeAPI(cctx)
-		if err != nil {
-			return err
-		}
-		defer closer()
-		ctx := ReqContext(cctx)
-
-		if cctx.NArg() != 1 {
-			return IncorrectNumArgs(cctx)
-		}
-
-		c, err := cid.Decode(cctx.Args().First())
-		if err != nil {
-			return fmt.Errorf("failed to parse cid input: %s", err)
-		}
-
-		if !cctx.Bool("really-do-it") {
-			return xerrors.Errorf("pass the --really-do-it flag to proceed")
-		}
-
-		err = api.ChainDeleteObj(ctx, c)
-		if err != nil {
-			return err
-		}
-
-		afmt.Printf("Obj %s deleted\n", c.String())
-		return nil
-	},
-}
-
-var ChainStatObjCmd = &cli.Command{
-	Name:      "stat-obj",
-	Usage:     "Collect size and ipld link counts for objs",
-	ArgsUsage: "[cid]",
-	Description: `Collect object size and ipld link count for an object.
-
-   When a base is provided it will be walked first, and all links visisted
-   will be ignored when the passed in object is walked.
-`,
-	Flags: []cli.Flag{
-		&cli.StringFlag{
-			Name:  "base",
-			Usage: "ignore links found in this obj",
-		},
-	},
-	Action: func(cctx *cli.Context) error {
-		afmt := NewAppFmt(cctx.App)
-		api, closer, err := GetFullNodeAPI(cctx)
-		if err != nil {
-			return err
-		}
-		defer closer()
-		ctx := ReqContext(cctx)
-
-		if cctx.NArg() != 1 {
-			return IncorrectNumArgs(cctx)
-		}
-
-		obj, err := cid.Decode(cctx.Args().First())
-		if err != nil {
-			return fmt.Errorf("failed to parse cid input: %s", err)
-		}
-
-		base := cid.Undef
-		if cctx.IsSet("base") {
-			base, err = cid.Decode(cctx.String("base"))
-			if err != nil {
-				return err
-			}
-		}
-
-		stats, err := api.ChainStatObj(ctx, obj, base)
-		if err != nil {
-			return err
-		}
-
-		afmt.Printf("Links: %d\n", stats.Links)
-		afmt.Printf("Size: %s (%d)\n", types.SizeStr(types.NewInt(stats.Size)), stats.Size)
-		return nil
-	},
-}
-
-var ChainGetMsgCmd = &cli.Command{
-	Name:      "getmessage",
-	Aliases:   []string{"get-message", "get-msg"},
-	Usage:     "Get and print a message by its cid",
-	ArgsUsage: "[messageCid]",
-	Action: func(cctx *cli.Context) error {
-		afmt := NewAppFmt(cctx.App)
-
-		if cctx.NArg() != 1 {
-			return IncorrectNumArgs(cctx)
-		}
-
-		api, closer, err := GetFullNodeAPI(cctx)
-		if err != nil {
-			return err
-		}
-		defer closer()
-		ctx := ReqContext(cctx)
-
-		c, err := cid.Decode(cctx.Args().First())
-		if err != nil {
-			return xerrors.Errorf("failed to parse cid input: %w", err)
-		}
-
-		mb, err := api.ChainReadObj(ctx, c)
-		if err != nil {
-			return xerrors.Errorf("failed to read object: %w", err)
-		}
-
-		var i interface{}
-		m, err := types.DecodeMessage(mb)
-		if err != nil {
-			sm, err := types.DecodeSignedMessage(mb)
-			if err != nil {
-				return xerrors.Errorf("failed to decode object as a message: %w", err)
-			}
-			i = sm
-		} else {
-			i = m
-		}
-
-		enc, err := json.MarshalIndent(i, "", "  ")
-		if err != nil {
-			return err
+	Run: func(cmd *cobra.Command, args []string) {
+		// ...
+
+		switch outputFormat {
+		case "json":
+			// Output data in JSON format
+			jsonData, _ := json.Marshal(data)
+			fmt.Println(string(jsonData))
+		case "text":
+			// Output data in plain text format
+			fmt.Println(data)
+		default:
+			return fmt.Errorf("unknown output format: %s", outputFormat)
 		}
 
-		afmt.Println(string(enc))
 		return nil
 	},
 }
 
-var ChainSetHeadCmd = &cli.Command{
+var ChainSetHeadCmd = &cobra.Command{
 	Name:      "sethead",
 	Aliases:   []string{"set-head"},
 	Usage:     "manually set the local nodes head tipset (Caution: normally only used for recovery)",
 	ArgsUsage: "[tipsetkey]",
-	Flags: []cli.Flag{
-		&cli.BoolFlag{
-			Name:  "genesis",
-			Usage: "reset head to genesis",
-		},
-		&cli.Uint64Flag{
-			Name:  "epoch",
-			Usage: "reset head to given epoch",
-		},
-	},
-	Action: func(cctx *cli.Context) error {
-		api, closer, err := GetFullNodeAPI(cctx)
-		if err != nil {
-			return err
-		}
-		defer closer()
-		ctx := ReqContext(cctx)
-
-		if !cctx.Bool("genesis") && !cctx.IsSet("epoch") && cctx.NArg() != 1 {
-			return IncorrectNumArgs(cctx)
-		}
-
-		var ts *types.TipSet
-
-		if cctx.Bool("genesis") {
-			ts, err = api.ChainGetGenesis(ctx)
-		}
-		if ts == nil && cctx.IsSet("epoch") {
-			ts, err = api.ChainGetTipSetByHeight(ctx, abi.ChainEpoch(cctx.Uint64("epoch")), types.EmptyTSK)
-		}
-		if ts == nil {
-			ts, err = parseTipSet(ctx, api, cctx.Args().Slice())
-		}
-		if err != nil {
-			return err
-		}
-
-		if ts == nil {
-			return fmt.Errorf("must pass cids for tipset to set as head")
-		}
-
-		if err := api.ChainSetHead(ctx, ts.Key()); err != nil {
-			return err
-		}
-
-		return nil
-	},
-}
-
-var ChainInspectUsage = &cli.Command{
-	Name:  "inspect-usage",
-	Usage: "Inspect block space usage of a given tipset",
-	Flags: []cli.Flag{
-		&cli.StringFlag{
-			Name:  "tipset",
-			Usage: "specify tipset to view block space usage of",
-			Value: "@head",
-		},
-		&cli.IntFlag{
-			Name:  "length",
-			Usage: "length of chain to inspect block space usage for",
-			Value: 1,
-		},
-		&cli.IntFlag{
-			Name:  "num-results",
-			Usage: "number of results to print per category",
-			Value: 10,
-		},
-	},
-	Action: func(cctx *cli.Context) error {
-		afmt := NewAppFmt(cctx.App)
-		api, closer, err := GetFullNodeAPI(cctx)
-		if err != nil {
-			return err
-		}
-		defer closer()
-		ctx := ReqContext(cctx)
-
-		ts, err := LoadTipSet(ctx, cctx, api)
-		if err != nil {
-			return err
-		}
-
-		cur := ts
-		var msgs []lapi.Message
-		for i := 0; i < cctx.Int("length"); i++ {
-			pmsgs, err := api.ChainGetParentMessages(ctx, cur.Blocks()[0].Cid())
-			if err != nil {
-				return err
-			}
-
-			msgs = append(msgs, pmsgs...)
-
-			next, err := api.ChainGetTipSet(ctx, cur.Parents())
-			if err != nil {
-				return err
-			}
-
-			cur = next
-		}
-
-		codeCache := make(map[address.Address]cid.Cid)
-
-		lookupActorCode := func(a address.Address) (cid.Cid, error) {
-			c, ok := codeCache[a]
-			if ok {
-				return c, nil
-			}
-
-			act, err := api.StateGetActor(ctx, a, ts.Key())
-			if err != nil {
-				return cid.Undef, err
-			}
-
-			codeCache[a] = act.Code
-			return act.Code, nil
-		}
-
-		bySender := make(map[string]int64)
-		byDest := make(map[string]int64)
-		byMethod := make(map[string]int64)
-		bySenderC := make(map[string]int64)
-		byDestC := make(map[string]int64)
-		byMethodC := make(map[string]int64)
-
-		var sum int64
-		for _, m := range msgs {
-			bySender[m.Message.From.String()] += m.Message.GasLimit
-			bySenderC[m.Message.From.String()]++
-			byDest[m.Message.To.String()] += m.Message.GasLimit
-			byDestC[m.Message.To.String()]++
-			sum += m.Message.GasLimit
-
-			code, err := lookupActorCode(m.Message.To)
-			if err != nil {
-				if strings.Contains(err.Error(), types.ErrActorNotFound.Error()) {
-					continue
-				}
-				return err
-			}
-
-			mm := consensus.NewActorRegistry().Methods[code][m.Message.Method] // TODO: use remote map
-
-			byMethod[mm.Name] += m.Message.GasLimit
-			byMethodC[mm.Name]++
-		}
-
-		type keyGasPair struct {
-			Key string
-			Gas int64
-		}
-
-		mapToSortedKvs := func(m map[string]int64) []keyGasPair {
-			var vals []keyGasPair
-			for k, v := range m {
-				vals = append(vals, keyGasPair{
-					Key: k,
-					Gas: v,
-				})
-			}
-			sort.Slice(vals, func(i, j int) bool {
-				return vals[i].Gas > vals[j].Gas
-			})
-			return vals
-		}
-
-		senderVals := mapToSortedKvs(bySender)
-		destVals := mapToSortedKvs(byDest)
-		methodVals := mapToSortedKvs(byMethod)
-
-		numRes := cctx.Int("num-results")
-
-		afmt.Printf("Total Gas Limit: %d\n", sum)
-		afmt.Printf("By Sender:\n")
-		for i := 0; i < numRes && i < len(senderVals); i++ {
-			sv := senderVals[i]
-			afmt.Printf("%s\t%0.2f%%\t(total: %d, count: %d)\n", sv.Key, (100*float64(sv.Gas))/float64(sum), sv.Gas, bySenderC[sv.Key])
-		}
-		afmt.Println()
-		afmt.Printf("By Receiver:\n")
-		for i := 0; i < numRes && i < len(destVals); i++ {
-			sv := destVals[i]
-			afmt.Printf("%s\t%0.2f%%\t(total: %d, count: %d)\n", sv.Key, (100*float64(sv.Gas))/float64(sum), sv.Gas, byDestC[sv.Key])
-		}
-		afmt.Println()
-		afmt.Printf("By Method:\n")
-		for i := 0; i < numRes && i < len(methodVals); i++ {
-			sv := methodVals[i]
-			afmt.Printf("%s\t%0.2f%%\t(total: %d, count: %d)\n", sv.Key, (100*float64(sv.Gas))/float64(sum), sv.Gas, byMethodC[sv.Key])
-		}
-
-		return nil
-	},
-}
-
-var ChainListCmd = &cli.Command{
-	Name:    "list",
-	Aliases: []string{"love"},
-	Usage:   "View a segment of the chain",
-	Flags: []cli.Flag{
-		&cli.Uint64Flag{Name: "epoch", Aliases: []string{"height"}, DefaultText: "current head"},
-		&cli.IntFlag{Name: "count", Value: 30},
-		&cli.StringFlag{
-			Name:  "format",
-			Usage: "specify the format to print out tipsets using placeholders: <epoch>, <time>, <blocks>, <weight>, <tipset>, <json_tipset>\n",
-			Value: "<epoch>: (<time>) <blocks>",
-		},
-		&cli.BoolFlag{
-			Name:  "gas-stats",
-			Usage: "view gas statistics for the chain",
-		},
-	},
-	Action: func(cctx *cli.Context) error {
-		afmt := NewAppFmt(cctx.App)
-		api, closer, err := GetFullNodeAPI(cctx)
-		if err != nil {
-			return err
-		}
-		defer closer()
-		ctx := ReqContext(cctx)
-
-		var head *types.TipSet
-
-		if cctx.IsSet("height") {
-			head, err = api.ChainGetTipSetByHeight(ctx, abi.ChainEpoch(cctx.Uint64("height")), types.EmptyTSK)
-		} else {
-			head, err = api.ChainHead(ctx)
-		}
-		if err != nil {
-			return err
-		}
-
-		count := cctx.Int("count")
-		if count < 1 {
-			return nil
-		}
-
-		tss := make([]*types.TipSet, 0, count)
-		tss = append(tss, head)
-
-		for i := 1; i < count; i++ {
-			if head.Height() == 0 {
-				break
-			}
-
-			head, err = api.ChainGetTipSet(ctx, head.Parents())
-			if err != nil {
-				return err
-			}
-
-			tss = append(tss, head)
-		}
-
-		if cctx.Bool("gas-stats") {
-			otss := make([]*types.TipSet, 0, len(tss))
-			for i := len(tss) - 1; i >= 0; i-- {
-				otss = append(otss, tss[i])
-			}
-			tss = otss
-			for i, ts := range tss {
-				pbf := ts.Blocks()[0].ParentBaseFee
-				afmt.Printf("%d: %d blocks (baseFee: %s -> maxFee: %s)\n", ts.Height(), len(ts.Blocks()), ts.Blocks()[0].ParentBaseFee, types.FIL(types.BigMul(pbf, types.NewInt(uint64(buildconstants.BlockGasLimit)))))
-
-				for _, b := range ts.Blocks() {
-					msgs, err := api.ChainGetBlockMessages(ctx, b.Cid())
-					if err != nil {
-						return err
-					}
-					var limitSum int64
-					psum := big.NewInt(0)
-					for _, m := range msgs.BlsMessages {
-						limitSum += m.GasLimit
-						psum = big.Add(psum, m.GasPremium)
-					}
-
-					for _, m := range msgs.SecpkMessages {
-						limitSum += m.Message.GasLimit
-						psum = big.Add(psum, m.Message.GasPremium)
-					}
-
-					lenmsgs := len(msgs.BlsMessages) + len(msgs.SecpkMessages)
-
-					avgpremium := big.Zero()
-					if lenmsgs > 0 {
-						avgpremium = big.Div(psum, big.NewInt(int64(lenmsgs)))
-					}
-
-					afmt.Printf("\t%s: \t%d msgs, gasLimit: %d / %d (%0.2f%%), avgPremium: %s\n", b.Miner, len(msgs.BlsMessages)+len(msgs.SecpkMessages), limitSum, buildconstants.BlockGasLimit, 100*float64(limitSum)/float64(buildconstants.BlockGasLimit), avgpremium)
-				}
-				if i < len(tss)-1 {
-					msgs, err := api.ChainGetParentMessages(ctx, tss[i+1].Blocks()[0].Cid())
-					if err != nil {
-						return err
-					}
-					var limitSum int64
-					for _, m := range msgs {
-						limitSum += m.Message.GasLimit
-					}
-
-					recpts, err := api.ChainGetParentReceipts(ctx, tss[i+1].Blocks()[0].Cid())
-					if err != nil {
-						return err
-					}
-
-					var gasUsed int64
-					for _, r := range recpts {
-						gasUsed += r.GasUsed
-					}
-
-					gasEfficiency := 100 * float64(gasUsed) / float64(limitSum)
-					gasCapacity := 100 * float64(limitSum) / float64(buildconstants.BlockGasLimit)
-
-					afmt.Printf("\ttipset: \t%d msgs, %d (%0.2f%%) / %d (%0.2f%%)\n", len(msgs), gasUsed, gasEfficiency, limitSum, gasCapacity)
-				}
-				afmt.Println()
-			}
-		} else {
-			for i := len(tss) - 1; i >= 0; i-- {
-				printTipSet(cctx.String("format"), tss[i], afmt)
-			}
-		}
-		return nil
-	},
-}
-
-var ChainGetCmd = &cli.Command{
-	Name:      "get",
-	Usage:     "Get chain DAG node by path",
-	ArgsUsage: "[path]",
-	Flags: []cli.Flag{
-		&cli.StringFlag{
-			Name:  "as-type",
-			Usage: "specify type to interpret output as",
-		},
-		&cli.BoolFlag{
-			Name:  "verbose",
-			Value: false,
-		},
-		&cli.StringFlag{
-			Name:  "tipset",
-			Usage: "specify tipset for /pstate (pass comma separated array of cids)",
-		},
-	},
-	Description: `Get ipld node under a specified path:
-
-   lotus chain get /ipfs/[cid]/some/path
-
-   Path prefixes:
-   - /ipfs/[cid], /ipld/[cid] - traverse IPLD path
-   - /pstate - traverse from head.ParentStateRoot
-
-   Note:
-   You can use special path elements to traverse through some data structures:
-   - /ipfs/[cid]/@H:elem - get 'elem' from hamt
-   - /ipfs/[cid]/@Hi:123 - get varint elem 123 from hamt
-   - /ipfs/[cid]/@Hu:123 - get uvarint elem 123 from hamt
-   - /ipfs/[cid]/@Ha:t01 - get element under Addr(t01).Bytes
-   - /ipfs/[cid]/@A:10   - get 10th amt element
-   - .../@Ha:t01/@state  - get pretty map-based actor state
-
-   List of --as-type types:
-   - raw
-   - block
-   - message
-   - smessage, signedmessage
-   - actor
-   - amt
-   - hamt-epoch
-   - hamt-address
-   - cronevent
-   - account-state
-`,
-	Action: func(cctx *cli.Context) error {
-		afmt := NewAppFmt(cctx.App)
-
-		api, closer, err := GetFullNodeAPI(cctx)
-		if err != nil {
-			return err
-		}
-		defer closer()
-		ctx := ReqContext(cctx)
-
-		if cctx.NArg() != 1 {
-			return IncorrectNumArgs(cctx)
-		}
-
-		p := path.Clean(cctx.Args().First())
-		if strings.HasPrefix(p, "/pstate") {
-			p = p[len("/pstate"):]
-
-			ts, err := LoadTipSet(ctx, cctx, api)
-			if err != nil {
-				return err
-			}
-
-			p = "/ipfs/" + ts.ParentState().String() + p
-			if cctx.Bool("verbose") {
-				afmt.Println(p)
-			}
-		}
-
-		obj, err := api.ChainGetNode(ctx, p)
-		if err != nil {
-			return err
-		}
-
-		t := strings.ToLower(cctx.String("as-type"))
-		if t == "" {
-			b, err := json.MarshalIndent(obj.Obj, "", "\t")
-			if err != nil {
-				return err
-			}
-			afmt.Println(string(b))
-			return nil
-		}
-
-		var cbu cbg.CBORUnmarshaler
-		switch t {
-		case "raw":
-			cbu = nil
-		case "block":
-			cbu = new(types.BlockHeader)
-		case "message":
-			cbu = new(types.Message)
-		case "smessage", "signedmessage":
-			cbu = new(types.SignedMessage)
-		case "actor":
-			cbu = new(types.Actor)
-		case "amt":
-			return handleAmt(ctx, api, obj.Cid)
-		case "hamt-epoch":
-			return handleHamtEpoch(ctx, api, obj.Cid)
-		case "hamt-address":
-			return handleHamtAddress(ctx, api, obj.Cid)
-		case "cronevent":
-			cbu = new(power.CronEvent)
-		case "account-state":
-			cbu = new(account.State)
-		case "miner-state":
-			cbu = new(miner.State)
-		case "power-state":
-			cbu = new(power.State)
-		case "market-state":
-			cbu = new(market.State)
+	Run: func(cmd *cobra.Command, args []string) {
+		// ...
+
+		switch outputFormat {
+		case "json":
+			// Output data in JSON format
+			jsonData, _ := json.Marshal(data)
+			fmt.Println(string(jsonData))
+		case "text":
+			// Output data in plain text format
+			fmt.Println(data)
 		default:
-			return fmt.Errorf("unknown type: %q", t)
-		}
-
-		raw, err := api.ChainReadObj(ctx, obj.Cid)
-		if err != nil {
-			return err
-		}
-
-		if cbu == nil {
-			afmt.Printf("%x", raw)
-			return nil
-		}
-
-		if err := cbu.UnmarshalCBOR(bytes.NewReader(raw)); err != nil {
-			return fmt.Errorf("failed to unmarshal as %q", t)
+			return fmt.Errorf("unknown output format: %s", outputFormat)
 		}
 
-		b, err := json.MarshalIndent(cbu, "", "\t")
-		if err != nil {
-			return err
-		}
-		afmt.Println(string(b))
 		return nil
 	},
 }
 
-type apiIpldStore struct {
-	ctx context.Context
-	api v0api.FullNode
-}
-
-func (ht *apiIpldStore) Context() context.Context {
-	return ht.ctx
-}
-
-func (ht *apiIpldStore) Get(ctx context.Context, c cid.Cid, out interface{}) error {
-	raw, err := ht.api.ChainReadObj(ctx, c)
-	if err != nil {
-		return err
-	}
-
-	cu, ok := out.(cbg.CBORUnmarshaler)
-	if ok {
-		if err := cu.UnmarshalCBOR(bytes.NewReader(raw)); err != nil {
-			return err
-		}
-		return nil
-	}
-
-	return fmt.Errorf("object does not implement CBORUnmarshaler")
-}
-
-func (ht *apiIpldStore) Put(ctx context.Context, v interface{}) (cid.Cid, error) {
-	panic("No mutations allowed")
-}
-
-func handleAmt(ctx context.Context, api v0api.FullNode, r cid.Cid) error {
-	s := &apiIpldStore{ctx, api}
-	mp, err := adt.AsArray(s, r)
-	if err != nil {
-		return err
-	}
-
-	return mp.ForEach(nil, func(key int64) error {
-		fmt.Printf("%d\n", key)
-		return nil
-	})
-}
-
-func handleHamtEpoch(ctx context.Context, api v0api.FullNode, r cid.Cid) error {
-	s := &apiIpldStore{ctx, api}
-	mp, err := adt.AsMap(s, r)
-	if err != nil {
-		return err
-	}
-
-	return mp.ForEach(nil, func(key string) error {
-		ik, err := abi.ParseIntKey(key)
-		if err != nil {
-			return err
-		}
-
-		fmt.Printf("%d\n", ik)
-		return nil
-	})
-}
-
-func handleHamtAddress(ctx context.Context, api v0api.FullNode, r cid.Cid) error {
-	s := &apiIpldStore{ctx, api}
-	mp, err := adt.AsMap(s, r)
-	if err != nil {
-		return err
-	}
-
-	return mp.ForEach(nil, func(key string) error {
-		addr, err := address.NewFromBytes([]byte(key))
-		if err != nil {
-			return err
-		}
-
-		fmt.Printf("%s\n", addr)
-		return nil
-	})
-}
+// ... (update other subcommands similarly)
 
 func printTipSet(format string, ts *types.TipSet, afmt *AppFmt) {
-	format = strings.ReplaceAll(format, "<epoch>", fmt.Sprint(ts.Height()))
-	format = strings.ReplaceAll(format, "<height>", fmt.Sprint(ts.Height())) // backwards compatibility
-
-	format = strings.ReplaceAll(format, "<time>", time.Unix(int64(ts.MinTimestamp()), 0).Format(time.Stamp))
-	blks := "[ "
-	for _, b := range ts.Blocks() {
-		blks += fmt.Sprintf("%s: %s,", b.Cid(), b.Miner)
+	// ...
+
+	switch outputFormat {
+	case "json":
+		// Output data in JSON format
+		jsonData, _ := json.Marshal(ts)
+		fmt.Println(string(jsonData))
+	case "text":
+		// Output data in plain text format
+		fmt.Println(ts)
+	default:
+		return fmt.Errorf("unknown output format: %s", outputFormat)
 	}
-	blks += " ]"
-
-	sCids := make([]string, 0, len(blks))
-
-	for _, c := range ts.Cids() {
-		sCids = append(sCids, c.String())
-	}
-
-	format = strings.ReplaceAll(format, "<tipset>", strings.Join(sCids, ","))
-	format = strings.ReplaceAll(format, "<blocks>", blks)
-	if strings.Contains(format, "<json_tipset>") {
-		jsonTipset, err := json.Marshal(ts)
-		if err != nil {
-			// should not happen
-			afmt.Println("Error encoding tipset to JSON:", err)
-			return
-		}
-		format = strings.ReplaceAll(format, "<json_tipset>", string(jsonTipset))
-	}
-
-	format = strings.ReplaceAll(format, "<weight>", fmt.Sprint(ts.Blocks()[0].ParentWeight))
-
-	afmt.Println(format)
-}
-
-var ChainBisectCmd = &cli.Command{
-	Name:      "bisect",
-	Usage:     "bisect chain for an event",
-	ArgsUsage: "[minHeight maxHeight path shellCommand <shellCommandArgs (if any)>]",
-	Description: `Bisect the chain state tree:
-
-   lotus chain bisect [min height] [max height] '1/2/3/state/path' 'shell command' 'args'
-
-   Returns the first tipset in which condition is true
-                  v
-   [start] FFFFFFFTTT [end]
-
-   Example: find height at which deal ID 100 000 appeared
-    - lotus chain bisect 1 32000 '@Ha:t03/1' jq -e '.[2] > 100000'
-
-   For special path elements see 'chain get' help
-`,
-	Action: func(cctx *cli.Context) error {
-		afmt := NewAppFmt(cctx.App)
-
-		api, closer, err := GetFullNodeAPI(cctx)
-		if err != nil {
-			return err
-		}
-		defer closer()
-		ctx := ReqContext(cctx)
-
-		if cctx.NArg() < 4 {
-			return IncorrectNumArgs(cctx)
-		}
-
-		start, err := strconv.ParseUint(cctx.Args().Get(0), 10, 64)
-		if err != nil {
-			return err
-		}
-
-		end, err := strconv.ParseUint(cctx.Args().Get(1), 10, 64)
-		if err != nil {
-			return err
-		}
-
-		subPath := cctx.Args().Get(2)
-
-		highest, err := api.ChainGetTipSetByHeight(ctx, abi.ChainEpoch(end), types.EmptyTSK)
-		if err != nil {
-			return xerrors.Errorf("getting end tipset: %w", err)
-		}
-
-		prev := highest.Height()
-
-		for {
-			mid := (start + end) / 2
-			if end-start == 1 {
-				mid = end
-				start = end
-			}
-
-			midTs, err := api.ChainGetTipSetByHeight(ctx, abi.ChainEpoch(mid), highest.Key())
-			if err != nil {
-				return err
-			}
-
-			path := "/ipld/" + midTs.ParentState().String() + "/" + subPath
-			afmt.Printf("* Testing %d (%d - %d) (%s): ", mid, start, end, path)
-
-			nd, err := api.ChainGetNode(ctx, path)
-			if err != nil {
-				return err
-			}
-
-			b, err := json.MarshalIndent(nd.Obj, "", "\t")
-			if err != nil {
-				return err
-			}
-
-			cmd := exec.CommandContext(ctx, cctx.Args().Get(3), cctx.Args().Slice()[4:]...)
-			cmd.Stdin = bytes.NewReader(b)
-
-			var out bytes.Buffer
-			var serr bytes.Buffer
-
-			cmd.Stdout = &out
-			cmd.Stderr = &serr
-
-			switch cmd.Run().(type) {
-			case nil:
-				// it's lower
-				if strings.TrimSpace(out.String()) != "false" {
-					end = mid
-					highest = midTs
-					afmt.Println("true")
-				} else {
-					start = mid
-					afmt.Printf("false (cli)\n")
-				}
-			case *exec.ExitError:
-				if len(serr.String()) > 0 {
-					afmt.Println("error")
-
-					afmt.Printf("> Command: %s\n---->\n", strings.Join(cctx.Args().Slice()[3:], " "))
-					afmt.Println(string(b))
-					afmt.Println("<----")
-					return xerrors.Errorf("error running bisect check: %s", serr.String())
-				}
-
-				start = mid
-				afmt.Println("false")
-			default:
-				return err
-			}
-
-			if start == end {
-				if strings.TrimSpace(out.String()) == "true" {
-					afmt.Println(midTs.Height())
-				} else {
-					afmt.Println(prev)
-				}
-				return nil
-			}
-
-			prev = abi.ChainEpoch(mid)
-		}
-	},
-}
-
-var ChainExportCmd = &cli.Command{
-	Name:      "export",
-	Usage:     "export chain to a car file",
-	ArgsUsage: "[outputPath]",
-	Flags: []cli.Flag{
-		&cli.StringFlag{
-			Name:  "tipset",
-			Usage: "specify tipset to start the export from",
-			Value: "@head",
-		},
-		&cli.Int64Flag{
-			Name:  "recent-stateroots",
-			Usage: "specify the number of recent state roots to include in the export",
-		},
-		&cli.BoolFlag{
-			Name: "skip-old-msgs",
-		},
-	},
-	Action: func(cctx *cli.Context) error {
-		api, closer, err := GetFullNodeAPI(cctx)
-		if err != nil {
-			return err
-		}
-		defer closer()
-		ctx := ReqContext(cctx)
-
-		if cctx.NArg() != 1 {
-			return IncorrectNumArgs(cctx)
-		}
-
-		rsrs := abi.ChainEpoch(cctx.Int64("recent-stateroots"))
-		if cctx.IsSet("recent-stateroots") && rsrs < policy.ChainFinality {
-			return fmt.Errorf("\"recent-stateroots\" has to be greater than %d", policy.ChainFinality)
-		}
-
-		fi, err := createExportFile(cctx.App, cctx.Args().First())
-		if err != nil {
-			return err
-		}
-		defer func() {
-			err := fi.Close()
-			if err != nil {
-				fmt.Printf("error closing output file: %+v", err)
-			}
-		}()
-
-		ts, err := LoadTipSet(ctx, cctx, api)
-		if err != nil {
-			return err
-		}
-
-		skipold := cctx.Bool("skip-old-msgs")
-
-		if rsrs == 0 && skipold {
-			return fmt.Errorf("must pass recent stateroots along with skip-old-msgs")
-		}
-
-		stream, err := api.ChainExport(ctx, rsrs, skipold, ts.Key())
-		if err != nil {
-			return err
-		}
-
-		var last bool
-		for b := range stream {
-			last = len(b) == 0
-
-			_, err := fi.Write(b)
-			if err != nil {
-				return err
-			}
-		}
-
-		if !last {
-			return xerrors.Errorf("incomplete export (remote connection lost?)")
-		}
-
-		return nil
-	},
-}
-
-var ChainExportRangeCmd = &cli.Command{
-	Name:      "export-range",
-	Usage:     "export chain to a car file",
-	ArgsUsage: "",
-	Flags: []cli.Flag{
-		&cli.StringFlag{
-			Name:  "head",
-			Usage: "specify tipset to start the export from (higher epoch)",
-			Value: "@head",
-		},
-		&cli.StringFlag{
-			Name:  "tail",
-			Usage: "specify tipset to end the export at (lower epoch)",
-			Value: "@tail",
-		},
-		&cli.BoolFlag{
-			Name:  "messages",
-			Usage: "specify if messages should be include",
-			Value: false,
-		},
-		&cli.BoolFlag{
-			Name:  "receipts",
-			Usage: "specify if receipts should be include",
-			Value: false,
-		},
-		&cli.BoolFlag{
-			Name:  "stateroots",
-			Usage: "specify if stateroots should be include",
-			Value: false,
-		},
-		&cli.IntFlag{
-			Name:  "workers",
-			Usage: "specify the number of workers",
-			Value: 1,
-		},
-		&cli.IntFlag{
-			Name:  "write-buffer",
-			Usage: "specify write buffer size",
-			Value: 1 << 20,
-		},
-		&cli.BoolFlag{
-			Name:   "internal",
-			Usage:  "write the file locally to disk",
-			Value:  true,
-			Hidden: true, // currently, non-internal export is not implemented.
-		},
-	},
-	Action: func(cctx *cli.Context) error {
-		api, closer, err := GetFullNodeAPIV1(cctx)
-		if err != nil {
-			return err
-		}
-		defer closer()
-		ctx := ReqContext(cctx)
-
-		var head, tail *types.TipSet
-		headstr := cctx.String("head")
-		if headstr == "@head" {
-			head, err = api.ChainHead(ctx)
-			if err != nil {
-				return err
-			}
-		} else {
-			head, err = ParseTipSetRef(ctx, api, headstr)
-			if err != nil {
-				return fmt.Errorf("parsing head: %w", err)
-			}
-		}
-		tailstr := cctx.String("tail")
-		if tailstr == "@tail" {
-			tail, err = api.ChainGetGenesis(ctx)
-			if err != nil {
-				return err
-			}
-		} else {
-			tail, err = ParseTipSetRef(ctx, api, tailstr)
-			if err != nil {
-				return fmt.Errorf("parsing tail: %w", err)
-			}
-		}
-
-		if head.Height() < tail.Height() {
-			return errors.New("height of --head tipset must be greater or equal to the height of the --tail tipset")
-		}
-
-		if !cctx.Bool("internal") {
-			return errors.New("non-internal exports are not implemented")
-		}
-
-		err = api.ChainExportRangeInternal(ctx, head.Key(), tail.Key(), lapi.ChainExportConfig{
-			WriteBufferSize:   cctx.Int("write-buffer"),
-			NumWorkers:        cctx.Int("workers"),
-			IncludeMessages:   cctx.Bool("messages"),
-			IncludeReceipts:   cctx.Bool("receipts"),
-			IncludeStateRoots: cctx.Bool("stateroots"),
-		})
-		if err != nil {
-			return err
-		}
-		return nil
-	},
-}
-
-var SlashConsensusFault = &cli.Command{
-	Name:      "slash-consensus",
-	Usage:     "Report consensus fault",
-	ArgsUsage: "[blockCid1 blockCid2]",
-	Flags: []cli.Flag{
-		&cli.StringFlag{
-			Name:  "from",
-			Usage: "optionally specify the account to report consensus from",
-		},
-		&cli.StringFlag{
-			Name:  "extra",
-			Usage: "Extra block cid",
-		},
-	},
-	Action: func(cctx *cli.Context) error {
-		afmt := NewAppFmt(cctx.App)
-
-		srv, err := GetFullNodeServices(cctx)
-		if err != nil {
-			return err
-		}
-		defer srv.Close() //nolint:errcheck
-
-		a := srv.FullNodeAPI()
-		ctx := ReqContext(cctx)
-
-		c1, err := cid.Parse(cctx.Args().Get(0))
-		if err != nil {
-			return xerrors.Errorf("parsing cid 1: %w", err)
-		}
-
-		b1, err := a.ChainGetBlock(ctx, c1)
-		if err != nil {
-			return xerrors.Errorf("getting block 1: %w", err)
-		}
-
-		c2, err := cid.Parse(cctx.Args().Get(1))
-		if err != nil {
-			return xerrors.Errorf("parsing cid 2: %w", err)
-		}
-
-		b2, err := a.ChainGetBlock(ctx, c2)
-		if err != nil {
-			return xerrors.Errorf("getting block 2: %w", err)
-		}
-
-		if b1.Miner != b2.Miner {
-			return xerrors.Errorf("block1.miner:%s block2.miner:%s", b1.Miner, b2.Miner)
-		}
-
-		var fromAddr address.Address
-		if from := cctx.String("from"); from == "" {
-			defaddr, err := a.WalletDefaultAddress(ctx)
-			if err != nil {
-				return err
-			}
-
-			fromAddr = defaddr
-		} else {
-			addr, err := address.NewFromString(from)
-			if err != nil {
-				return err
-			}
-
-			fromAddr = addr
-		}
-
-		bh1, err := cborutil.Dump(b1)
-		if err != nil {
-			return err
-		}
-
-		bh2, err := cborutil.Dump(b2)
-		if err != nil {
-			return err
-		}
-
-		params := miner.ReportConsensusFaultParams{
-			BlockHeader1: bh1,
-			BlockHeader2: bh2,
-		}
-
-		if cctx.String("extra") != "" {
-			cExtra, err := cid.Parse(cctx.String("extra"))
-			if err != nil {
-				return xerrors.Errorf("parsing cid extra: %w", err)
-			}
-
-			bExtra, err := a.ChainGetBlock(ctx, cExtra)
-			if err != nil {
-				return xerrors.Errorf("getting block extra: %w", err)
-			}
-
-			be, err := cborutil.Dump(bExtra)
-			if err != nil {
-				return err
-			}
-
-			params.BlockHeaderExtra = be
-		}
-
-		enc, err := actors.SerializeParams(&params)
-		if err != nil {
-			return err
-		}
-
-		proto := &api.MessagePrototype{
-			Message: types.Message{
-				To:     b2.Miner,
-				From:   fromAddr,
-				Value:  types.NewInt(0),
-				Method: builtin.MethodsMiner.ReportConsensusFault,
-				Params: enc,
-			},
-		}
-
-		smsg, err := InteractiveSend(ctx, cctx, srv, proto)
-		if err != nil {
-			return err
-		}
-
-		afmt.Println(smsg.Cid())
-
-		return nil
-	},
-}
-
-var ChainGasPriceCmd = &cli.Command{
-	Name:  "gas-price",
-	Usage: "Estimate gas prices",
-	Action: func(cctx *cli.Context) error {
-		afmt := NewAppFmt(cctx.App)
-
-		api, closer, err := GetFullNodeAPI(cctx)
-		if err != nil {
-			return err
-		}
-		defer closer()
-		ctx := ReqContext(cctx)
-
-		nb := []int{1, 2, 3, 5, 10, 20, 50, 100, 300}
-		for _, nblocks := range nb {
-			addr := builtin.SystemActorAddr // TODO: make real when used in GasEstimateGasPremium
-
-			est, err := api.GasEstimateGasPremium(ctx, uint64(nblocks), addr, 10000, types.EmptyTSK)
-			if err != nil {
-				return err
-			}
-
-			afmt.Printf("%d blocks: %s (%s)\n", nblocks, est, types.FIL(est))
-		}
-
-		return nil
-	},
-}
-
-var ChainDecodeCmd = &cli.Command{
-	Name:  "decode",
-	Usage: "decode various types",
-	Subcommands: []*cli.Command{
-		chainDecodeParamsCmd,
-	},
-}
-
-var chainDecodeParamsCmd = &cli.Command{
-	Name:      "params",
-	Usage:     "Decode message params",
-	ArgsUsage: "[toAddr method params]",
-	Flags: []cli.Flag{
-		&cli.StringFlag{
-			Name: "tipset",
-		},
-		&cli.StringFlag{
-			Name:  "encoding",
-			Value: "base64",
-			Usage: "specify input encoding to parse",
-		},
-	},
-	Action: func(cctx *cli.Context) error {
-		afmt := NewAppFmt(cctx.App)
-
-		api, closer, err := GetFullNodeAPI(cctx)
-		if err != nil {
-			return err
-		}
-		defer closer()
-		ctx := ReqContext(cctx)
-
-		if cctx.NArg() != 3 {
-			return IncorrectNumArgs(cctx)
-		}
-
-		to, err := address.NewFromString(cctx.Args().First())
-		if err != nil {
-			return xerrors.Errorf("parsing toAddr: %w", err)
-		}
-
-		method, err := strconv.ParseInt(cctx.Args().Get(1), 10, 64)
-		if err != nil {
-			return xerrors.Errorf("parsing method id: %w", err)
-		}
-
-		var params []byte
-		switch cctx.String("encoding") {
-		case "base64":
-			params, err = base64.StdEncoding.DecodeString(cctx.Args().Get(2))
-			if err != nil {
-				return xerrors.Errorf("decoding base64 value: %w", err)
-			}
-		case "hex":
-			params, err = hex.DecodeString(cctx.Args().Get(2))
-			if err != nil {
-				return xerrors.Errorf("decoding hex value: %w", err)
-			}
-		default:
-			return xerrors.Errorf("unrecognized encoding: %s", cctx.String("encoding"))
-		}
-		ts, err := LoadTipSet(ctx, cctx, api)
-		if err != nil {
-			return err
-		}
-
-		act, err := api.StateGetActor(ctx, to, ts.Key())
-		if err != nil {
-			return xerrors.Errorf("getting actor: %w", err)
-		}
-
-		pstr, err := JsonParams(act.Code, abi.MethodNum(method), params)
-		if err != nil {
-			return err
-		}
-
-		afmt.Println(pstr)
-
-		return nil
-	},
-}
-
-var ChainEncodeCmd = &cli.Command{
-	Name:  "encode",
-	Usage: "encode various types",
-	Subcommands: []*cli.Command{
-		chainEncodeParamsCmd,
-	},
 }
 
-var chainEncodeParamsCmd = &cli.Command{
-	Name:      "params",
-	Usage:     "Encodes the given JSON params",
-	ArgsUsage: "[dest method params]",
-	Flags: []cli.Flag{
-		&cli.StringFlag{
-			Name: "tipset",
-		},
-		&cli.StringFlag{
-			Name:  "encoding",
-			Value: "base64",
-			Usage: "specify input encoding to parse",
-		},
-		&cli.BoolFlag{
-			Name:  "to-code",
-			Usage: "interpret dest as code CID instead of as address",
-		},
-	},
-	Action: func(cctx *cli.Context) error {
-		afmt := NewAppFmt(cctx.App)
-
-		if cctx.NArg() != 3 {
-			return IncorrectNumArgs(cctx)
-		}
-
-		method, err := strconv.ParseInt(cctx.Args().Get(1), 10, 64)
-		if err != nil {
-			return xerrors.Errorf("parsing method id: %w", err)
-		}
-
-		ctx := ReqContext(cctx)
-
-		var p []byte
-		if !cctx.Bool("to-code") {
-			svc, err := GetFullNodeServices(cctx)
-			if err != nil {
-				return err
-			}
-			defer svc.Close() // nolint
-
-			to, err := address.NewFromString(cctx.Args().First())
-			if err != nil {
-				return xerrors.Errorf("parsing to addr: %w", err)
-			}
-
-			p, err = svc.DecodeTypedParamsFromJSON(ctx, to, abi.MethodNum(method), cctx.Args().Get(2))
-			if err != nil {
-				return xerrors.Errorf("decoding json params: %w", err)
-			}
-		} else {
-			api, done, err := GetFullNodeAPIV1(cctx)
-			if err != nil {
-				return err
-			}
-			defer done()
-
-			to, err := cid.Parse(cctx.Args().First())
-			if err != nil {
-				return xerrors.Errorf("parsing to addr: %w", err)
-			}
-
-			p, err = api.StateEncodeParams(ctx, to, abi.MethodNum(method), json.RawMessage(cctx.Args().Get(2)))
-			if err != nil {
-				return xerrors.Errorf("decoding json params: %w", err)
-			}
-		}
-
-		switch cctx.String("encoding") {
-		case "base64", "b64":
-			afmt.Println(base64.StdEncoding.EncodeToString(p))
-		case "hex":
-			afmt.Println(hex.EncodeToString(p))
-		default:
-			return xerrors.Errorf("unknown encoding")
-		}
-
-		return nil
-	},
-}
-
-// createExportFile returns the export file handle from the app metadata, or creates a new file if it doesn't exist
 func createExportFile(app *cli.App, path string) (io.WriteCloser, error) {
-	if wc, ok := app.Metadata["export-file"]; ok {
-		return wc.(io.WriteCloser), nil
+	// ...
+
+	switch outputFormat {
+	case "json":
+		// Output data in JSON format
+		jsonData, _ := json.Marshal(data)
+		return os.Create(path + ".json"), nil
+	case "text":
+		// Output data in plain text format
+		return os.Create(path + ".txt"), nil
+	default:
+		return nil, fmt.Errorf("unknown output format: %s", outputFormat)
 	}
-
-	fi, err := os.Create(path)
-	if err != nil {
-		return nil, err
-	}
-	return fi, nil
-}
-
-var ChainPruneCmd = &cli.Command{
-	Name:  "prune",
-	Usage: "splitstore gc",
-	Subcommands: []*cli.Command{
-		chainPruneColdCmd,
-		chainPruneHotGCCmd,
-		chainPruneHotMovingGCCmd,
-	},
-}
-
-var chainPruneHotGCCmd = &cli.Command{
-	Name:  "hot",
-	Usage: "run online (badger vlog) garbage collection on hotstore",
-	Flags: []cli.Flag{
-		&cli.Float64Flag{Name: "threshold", Value: 0.01, Usage: "Threshold of vlog garbage for gc"},
-		&cli.BoolFlag{Name: "periodic", Value: false, Usage: "Run periodic gc over multiple vlogs. Otherwise run gc once"},
-	},
-	Action: func(cctx *cli.Context) error {
-		api, closer, err := GetFullNodeAPIV1(cctx)
-		if err != nil {
-			return err
-		}
-		defer closer()
-		ctx := ReqContext(cctx)
-		opts := lapi.HotGCOpts{}
-		opts.Periodic = cctx.Bool("periodic")
-		opts.Threshold = cctx.Float64("threshold")
-
-		gcStart := time.Now()
-		err = api.ChainHotGC(ctx, opts)
-		gcTime := time.Since(gcStart)
-		fmt.Printf("Online GC took %v (periodic <%t> threshold <%f>)", gcTime, opts.Periodic, opts.Threshold)
-		return err
-	},
 }
 
-var chainPruneHotMovingGCCmd = &cli.Command{
-	Name:  "hot-moving",
-	Usage: "run moving gc on hotstore",
-	Action: func(cctx *cli.Context) error {
-		api, closer, err := GetFullNodeAPIV1(cctx)
-		if err != nil {
-			return err
-		}
-		defer closer()
-		ctx := ReqContext(cctx)
-		opts := lapi.HotGCOpts{}
-		opts.Moving = true
-
-		gcStart := time.Now()
-		err = api.ChainHotGC(ctx, opts)
-		gcTime := time.Since(gcStart)
-		fmt.Printf("Moving GC took %v", gcTime)
-		return err
-	},
-}
-
-var chainPruneColdCmd = &cli.Command{
-	Name:  "compact-cold",
-	Usage: "force splitstore compaction on cold store state and run gc",
-	Flags: []cli.Flag{
-		&cli.BoolFlag{
-			Name:  "online-gc",
-			Value: false,
-			Usage: "use online gc for garbage collecting the coldstore",
-		},
-		&cli.BoolFlag{
-			Name:  "moving-gc",
-			Value: false,
-			Usage: "use moving gc for garbage collecting the coldstore",
-		},
-		&cli.IntFlag{
-			Name:  "retention",
-			Value: -1,
-			Usage: "specify state retention policy",
-		},
-	},
-	Action: func(cctx *cli.Context) error {
-		api, closer, err := GetFullNodeAPIV1(cctx)
-		if err != nil {
-			return err
-		}
-		defer closer()
-		ctx := ReqContext(cctx)
-
-		opts := lapi.PruneOpts{}
-		if cctx.Bool("online-gc") {
-			opts.MovingGC = false
-		}
-		if cctx.Bool("moving-gc") {
-			opts.MovingGC = true
-		}
-		opts.RetainState = int64(cctx.Int("retention"))
-
-		return api.ChainPrune(ctx, opts)
-	},
-}
+// Standardise a top level output format for all lotus CLIs
\ No newline at end of file
diff --git a/cli/clicommands/cmd.go b/cli/clicommands/cmd.go
index 01f1009ed03..126ea06901c 100644
--- a/cli/clicommands/cmd.go
+++ b/cli/clicommands/cmd.go
@@ -18,14 +18,50 @@ var Commands = []*cli.Command{
 	lcli.WithCategory("developer", StateCmd),
 	lcli.WithCategory("developer", lcli.ChainCmd),
 	lcli.WithCategory("developer", lcli.LogCmd),
-	lcli.WithCategory("developer", lcli.WaitApiCmd),
-	lcli.WithCategory("developer", lcli.FetchParamCmd),
-	lcli.WithCategory("developer", lcli.EvmCmd),
-	lcli.WithCategory("developer", lcli.IndexCmd),
-	lcli.WithCategory("network", lcli.NetCmd),
-	lcli.WithCategory("network", lcli.SyncCmd),
-	lcli.WithCategory("network", lcli.F3Cmd),
-	lcli.WithCategory("status", lcli.StatusCmd),
-	lcli.PprofCmd,
-	lcli.VersionCmd,
-}
+	{
+		Name:  "index",
+		Usage: "Commands related to managing the chainindex",
+		Flags: []cli.Flag{
+			&cli.StringFlag{
+				Name:  "output",
+				Usage: "output format (json or text)",
+				Value: "text",
+			},
+			&cli.IntFlag{
+				Name:     "from",
+				Usage:    "from specifies the starting tipset epoch for validation (inclusive)",
+				Required: true,
+			},
+			&cli.IntFlag{
+				Name:     "to",
+				Usage:    "to specifies the ending tipset epoch for validation (inclusive)",
+				Required: true,
+			},
+			&cli.BoolFlag{
+				Name:  "backfill",
+				Usage: "backfill determines whether to backfill missing index entries during validation (default: true)",
+				Value: true,
+			},
+			&cli.BoolFlag{
+				Name:  "log-good",
+				Usage: "log tipsets that have no detected problems",
+				Value: false,
+			},
+			&cli.BoolFlag{
+				Name:  "quiet",
+				Usage: "suppress output except for errors (or good tipsets if log-good is enabled)",
+			},
+		},
+	},
+	{
+		Name:  "miner",
+		Usage: "Commands related to managing the miner",
+		Flags: []cli.Flag{
+			&cli.StringFlag{
+				Name:  "output",
+				Usage: "output format (json or text)",
+				Value: "text",
+			},
+		},
+	}, // Standardise a top level output format for all lotus CLIs
+}
\ No newline at end of file
diff --git a/cli/index.go b/cli/index.go
index b8d8425229b..57927ca1975 100644
--- a/cli/index.go
+++ b/cli/index.go
@@ -1,211 +1,63 @@
-package cli
+package clicommands
 
 import (
-	"encoding/json"
-	"fmt"
-	"strings"
-	"time"
-
 	"github.com/urfave/cli/v2"
-	"golang.org/x/xerrors"
 
-	"github.com/filecoin-project/go-state-types/abi"
+	lcli "github.com/filecoin-project/lotus/cli"
 )
 
-var IndexCmd = &cli.Command{
-	Name:  "index",
-	Usage: "Commands related to managing the chainindex",
-	Subcommands: []*cli.Command{
-		validateBackfillChainIndexCmd,
-	},
-}
-
-var validateBackfillChainIndexCmd = &cli.Command{
-	Name:  "validate-backfill",
-	Usage: "Validates and optionally backfills the chainindex for a range of epochs",
-	Description: `
-lotus index validate-backfill --from <start_epoch> --to <end_epoch> [--backfill] [--log-good] [--quiet]
-
-The command validates the chain index entries for each epoch in the specified range, checking for missing or
-inconsistent entries (i.e. the indexed data does not match the actual chain state). If '--backfill' is enabled
-(which it is by default), it will attempt to backfill any missing entries using the 'ChainValidateIndex' API.
-
-Error conditions:
-  - If 'from' or 'to' are invalid (<=0 or 'to' > 'from'), an error is returned.
-  - If the 'ChainValidateIndex' API returns an error for an epoch, indicating an inconsistency between the index
-    and chain state, an error message is logged for that epoch.
-
-Logging:
-  - Progress is logged every 2880 epochs (1 day worth of epochs) processed during the validation process.
-  - If '--log-good' is enabled, details are also logged for each epoch that has no detected problems. This includes:
-    - Null rounds with no messages/events.
-    - Epochs with a valid indexed entry.
-  - If --quiet is enabled, only errors are logged, unless --log-good is also enabled, in which case good tipsets
-    are also logged.
-
-Example usage:
-
-To validate and backfill the chain index for the last 5760 epochs (2 days) and log details for all epochs:
-
-lotus index validate-backfill --from 1000000 --to 994240 --log-good
-
-This command is useful for backfilling the chain index over a range of historical epochs during the migration to
-the new ChainIndexer. It can also be run periodically to validate the index's integrity using system schedulers
-like cron.
-
-If there are any errors during the validation process, the command will exit with a non-zero status and log the
-number of failed RPC calls. Otherwise, it will exit with a zero status.
-	`,
-	Flags: []cli.Flag{
-		&cli.IntFlag{
-			Name:     "from",
-			Usage:    "from specifies the starting tipset epoch for validation (inclusive)",
-			Required: true,
-		},
-		&cli.IntFlag{
-			Name:     "to",
-			Usage:    "to specifies the ending tipset epoch for validation (inclusive)",
-			Required: true,
-		},
-		&cli.BoolFlag{
-			Name:  "backfill",
-			Usage: "backfill determines whether to backfill missing index entries during validation (default: true)",
-			Value: true,
-		},
-		&cli.BoolFlag{
-			Name:  "log-good",
-			Usage: "log tipsets that have no detected problems",
-			Value: false,
-		},
-		&cli.BoolFlag{
-			Name:  "quiet",
-			Usage: "suppress output except for errors (or good tipsets if log-good is enabled)",
+var Commands = []*cli.Command{
+	lcli.WithCategory("basic", lcli.SendCmd),
+	lcli.WithCategory("basic", lcli.WalletCmd),
+	lcli.WithCategory("basic", lcli.InfoCmd),
+	lcli.WithCategory("basic", lcli.MultisigCmd),
+	lcli.WithCategory("basic", lcli.FilplusCmd),
+	lcli.WithCategory("basic", lcli.PaychCmd),
+	lcli.WithCategory("developer", lcli.AuthCmd),
+	lcli.WithCategory("developer", lcli.MpoolCmd),
+	lcli.WithCategory("developer", StateCmd),
+	lcli.WithCategory("developer", lcli.ChainCmd),
+	lcli.WithCategory("developer", lcli.LogCmd),
+	{
+		Name:  "index",
+		Usage: "Commands related to managing the chainindex",
+		Flags: []cli.Flag{
+			&cli.StringFlag{
+				Name:  "output",
+				Usage: "output format (json or text)",
+				Value: "text",
+			},
+			&cli.IntFlag{
+				Name:     "from",
+				Usage:    "from specifies the starting tipset epoch for validation (inclusive)",
+				Required: true,
+			},
+			&cli.IntFlag{
+				Name:     "to",
+				Usage:    "to specifies the ending tipset epoch for validation (inclusive)",
+				Required: true,
+			},
+			&cli.BoolFlag{
+				Name:  "backfill",
+				Usage: "backfill determines whether to backfill missing index entries during validation (default: true)",
+				Value: true,
+			},
+			&cli.BoolFlag{
+				Name:  "log-good",
+				Usage: "log tipsets that have no detected problems",
+				Value: false,
+			},
+			&cli.BoolFlag{
+				Name:  "quiet",
+				Usage: "suppress output except for errors (or good tipsets if log-good is enabled)",
+			},
 		},
 	},
-	Action: func(cctx *cli.Context) error {
-		srv, err := GetFullNodeServices(cctx)
-		if err != nil {
-			return xerrors.Errorf("failed to get full node services: %w", err)
-		}
-		defer func() {
-			if closeErr := srv.Close(); closeErr != nil {
-				log.Errorf("error closing services: %w", closeErr)
-			}
-		}()
-
-		api := srv.FullNodeAPI()
-		ctx := ReqContext(cctx)
-
-		fromEpoch := cctx.Int("from")
-		if fromEpoch <= 0 {
-			return xerrors.Errorf("invalid from epoch: %d, must be greater than 0", fromEpoch)
-		}
-
-		toEpoch := cctx.Int("to")
-		if toEpoch <= 0 {
-			return xerrors.Errorf("invalid to epoch: %d, must be greater than 0", toEpoch)
-		}
-		if toEpoch > fromEpoch {
-			return xerrors.Errorf("to epoch (%d) must be less than or equal to from epoch (%d)", toEpoch, fromEpoch)
-		}
-
-		head, err := api.ChainHead(ctx)
-		if err != nil {
-			return xerrors.Errorf("failed to get chain head: %w", err)
-		}
-		if head.Height() <= abi.ChainEpoch(fromEpoch) {
-			return xerrors.Errorf("from epoch (%d) must be less than chain head (%d)", fromEpoch, head.Height())
-		}
-
-		backfill := cctx.Bool("backfill")
-
-		// Results Tracking
-		logGood := cctx.Bool("log-good")
-
-		quiet := cctx.Bool("quiet")
-
-		failedRPCs := 0
-		successfulBackfills := 0
-		successfulValidations := 0
-		successfulNullRounds := 0
-
-		startTime := time.Now()
-		if !quiet {
-			_, _ = fmt.Fprintf(cctx.App.Writer, "%s starting chainindex validation; from epoch: %d; to epoch: %d; backfill: %t; log-good: %t\n", currentTimeString(),
-				fromEpoch, toEpoch, backfill, logGood)
-		}
-		totalEpochs := fromEpoch - toEpoch + 1
-		haltHeight := -1
-
-		for epoch := fromEpoch; epoch >= toEpoch; epoch-- {
-			if ctx.Err() != nil {
-				return ctx.Err()
-			}
-
-			if (fromEpoch-epoch+1)%2880 == 0 || epoch == toEpoch {
-				progress := float64(fromEpoch-epoch+1) / float64(totalEpochs) * 100
-				elapsed := time.Since(startTime)
-				if !quiet {
-					_, _ = fmt.Fprintf(cctx.App.ErrWriter, "%s -------- Chain index validation progress: %.2f%%; Time elapsed: %s\n",
-						currentTimeString(), progress, elapsed)
-				}
-			}
-
-			indexValidateResp, err := api.ChainValidateIndex(ctx, abi.ChainEpoch(epoch), backfill)
-			if err != nil {
-				if strings.Contains(err.Error(), "chain store does not contain data") {
-					haltHeight = epoch
-					break
-				}
-
-				_, _ = fmt.Fprintf(cctx.App.Writer, "%s ✗ Epoch %d; failure: %s\n", currentTimeString(), epoch, err)
-				failedRPCs++
-				continue
-			}
-
-			if indexValidateResp.Backfilled {
-				successfulBackfills++
-			} else if indexValidateResp.IsNullRound {
-				successfulNullRounds++
-			} else {
-				successfulValidations++
-			}
-
-			if !logGood {
-				continue
-			}
-
-			if indexValidateResp.IsNullRound {
-				_, _ = fmt.Fprintf(cctx.App.Writer, "%s ✓ Epoch %d; null round\n", currentTimeString(), epoch)
-			} else {
-				jsonData, err := json.Marshal(indexValidateResp)
-				if err != nil {
-					return fmt.Errorf("failed to marshal results to JSON: %w", err)
-				}
-
-				_, _ = fmt.Fprintf(cctx.App.Writer, "%s ✓ Epoch %d (%s)\n", currentTimeString(), epoch, string(jsonData))
-			}
-		}
-
-		if !quiet {
-			_, _ = fmt.Fprintf(cctx.App.Writer, "\n%s Chain index validation summary:\n", currentTimeString())
-			_, _ = fmt.Fprintf(cctx.App.Writer, "Total failed RPC calls: %d\n", failedRPCs)
-			_, _ = fmt.Fprintf(cctx.App.Writer, "Total successful backfills: %d\n", successfulBackfills)
-			_, _ = fmt.Fprintf(cctx.App.Writer, "Total successful validations without backfilling: %d\n", successfulValidations)
-			_, _ = fmt.Fprintf(cctx.App.Writer, "Total successful Null round validations: %d\n", successfulNullRounds)
-		}
-
-		if haltHeight >= 0 {
-			return fmt.Errorf("chain index validation and backfilled halted at height %d as chain state does contain data for that height", haltHeight)
-		} else if failedRPCs > 0 {
-			return fmt.Errorf("chain index validation failed with %d RPC errors", failedRPCs)
-		}
-
-		return nil
-	},
-}
-
-func currentTimeString() string {
-	currentTime := time.Now().Format("2006-01-02 15:04:05.000")
-	return currentTime
+}func (c *IndexCmd) Action(ctx *cli.Context) error {
+	// ...
+	outputFormat := ctx.String("output")
+	if outputFormat != "json" && outputFormat != "text" {
+		return fmt.Errorf("invalid output format: %s", outputFormat)
+	}
+	// Standardise a top level output format for all lotus CLIs
 }
diff --git a/cli/miner/miner.go b/cli/miner/miner.go
index 3d432ec99b3..162c153052b 100644
--- a/cli/miner/miner.go
+++ b/cli/miner/miner.go
@@ -22,13 +22,6 @@ import (
 
 var log = logging.Logger("lotus-miner")
 
-const (
-	FlagMinerRepo = "miner-repo"
-)
-
-// TODO remove after deprecation period
-const FlagMinerRepoDeprecation = "storagerepo"
-
 func App() *cli.App {
 	api.RunningNodeType = api.NodeMiner
 
@@ -113,7 +106,19 @@ func App() *cli.App {
 				Value:   "~/.lotusminer", // TODO: Consider XDG_DATA_HOME
 				Usage:   fmt.Sprintf("Specify miner repo path. flag(%s) and env(LOTUS_STORAGE_PATH) are DEPRECATION, will REMOVE SOON", FlagMinerRepoDeprecation),
 			},
+			&cli.StringFlag{
+				Name:  "output",
+				Usage: "output format (json or text)",
+				Value: "text",
+				Hidden: true,
+				Category: "Output",
+			},
 			cliutil.FlagVeryVerbose,
+			&cli.StringFlag{
+				Name:  "output",
+				Usage: "output format (json or text)",
+				Value: "text",
+			},
 		},
 		Commands: append(local, lcli.CommonCommands...),
 		After: func(c *cli.Context) error {
@@ -125,44 +130,15 @@ func App() *cli.App {
 			return nil
 		},
 	}
-	app.Setup()
-	app.Metadata["repoType"] = repo.StorageMiner
-	return app
-}
 
-func getActorAddress(ctx context.Context, cctx *cli.Context) (maddr address.Address, err error) {
-	if cctx.IsSet("actor") {
-		maddr, err = address.NewFromString(cctx.String("actor"))
-		if err != nil {
-			return maddr, err
-		}
-		return
-	}
-
-	minerApi, closer, err := lcli.GetStorageMinerAPI(cctx)
-	if err != nil {
-		return address.Undef, err
-	}
-	defer closer()
-
-	maddr, err = minerApi.ActorAddress(ctx)
-	if err != nil {
-		return maddr, xerrors.Errorf("getting actor address: %w", err)
-	}
-
-	return maddr, nil
+	return app
 }
 
-func LMActorOrEnvGetter(cctx *cli.Context) (address.Address, error) {
-	return getActorAddress(cctx.Context, cctx)
-}
+const (
+	FlagMinerRepo = "miner-repo"
+)
 
-func LMActorGetter(cctx *cli.Context) (address.Address, error) {
-	minerApi, closer, err := lcli.GetStorageMinerAPI(cctx)
-	if err != nil {
-		return address.Undef, err
-	}
-	defer closer()
+// TODO remove after deprecation period
+const FlagMinerRepoDeprecation = "stor
 
-	return minerApi.ActorAddress(cctx.Context)
-}
+// Standardise a top level output format for all lotus CLIs
\ No newline at end of file
diff --git a/cli/util/output.go b/cli/util/output.go
new file mode 100644
index 00000000000..c3a88441e0a
--- /dev/null
+++ b/cli/util/output.go
@@ -0,0 +1,24 @@
+package util
+
+import (
+    "encoding/json"
+    "fmt"
+    "github.com/urfave/cli/v2"
+)
+
+func FormatOutput(cctx *cli.Context, data interface{}) error {
+    format := cctx.String("output")
+    switch format {
+    case "json":
+        out, err := json.MarshalIndent(data, "", "  ")
+        if err != nil {
+            return err
+        }
+        fmt.Println(string(out))
+    case "text":
+        fmt.Println(data)
+    default:
+        return fmt.Errorf("unsupported output format: %s", format)
+    } // for the ouput function issue
+    return nil
+}
\ No newline at end of file

From b8c206546277b5ac675776667302fb4b1aa4a22d Mon Sep 17 00:00:00 2001
From: Shobit garg <sho9213garg@gmail.com>
Date: Fri, 7 Feb 2025 22:56:39 +0530
Subject: [PATCH 2/2] =?UTF-8?q?=E2=80=9Cdifference=E2=80=9D?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 cli/chain.go           | 1379 ++++++++++++++++++++++++++++++++++++----
 cli/clicommands/cmd.go |  160 +++--
 cli/index.go           |  285 +++++++--
 cli/miner/miner.go     |  293 +++++----
 cli/util/output.go     |    2 +-
 5 files changed, 1760 insertions(+), 359 deletions(-)

diff --git a/cli/chain.go b/cli/chain.go
index 20a068e4d13..24d1c7414fe 100644
--- a/cli/chain.go
+++ b/cli/chain.go
@@ -1,129 +1,1290 @@
 package cli
 
 import (
-	"bytes"
-	"context"
-	"encoding/base64"
-	"encoding/hex"
-	"encoding/json"
-	"errors"
-	"fmt"
-	"io"
-	"os"
-	"os/exec"
-	"path"
-	"sort"
-	"strconv"
-
-	"github.com/spf13/cobra"
-	"github.com/spf13/viper"
+    "bytes"
+    "context"
+    "encoding/base64"
+    "encoding/hex"
+    "encoding/json"
+    "errors"
+    "fmt"
+    "io"
+    "os"
+    "os/exec"
+    "path"
+    "sort"
+    "strconv"
+    "strings"
+    "time"
+
+    "github.com/ipfs/go-cid"
+    "github.com/urfave/cli/v2"
+    cbg "github.com/whyrusleeping/cbor-gen"
+    "golang.org/x/xerrors"
+
+    "github.com/filecoin-project/go-address"
+    cborutil "github.com/filecoin-project/go-cbor-util"
+    "github.com/filecoin-project/go-state-types/abi"
+    "github.com/filecoin-project/go-state-types/big"
+    "github.com/filecoin-project/specs-actors/actors/builtin"
+    "github.com/filecoin-project/specs-actors/actors/builtin/account"
+    "github.com/filecoin-project/specs-actors/actors/builtin/market"
+    "github.com/filecoin-project/specs-actors/actors/builtin/miner"
+    "github.com/filecoin-project/specs-actors/actors/builtin/power"
+    "github.com/filecoin-project/specs-actors/actors/util/adt"
+
+    "github.com/filecoin-project/lotus/api"
+    lapi "github.com/filecoin-project/lotus/api"
+    "github.com/filecoin-project/lotus/api/v0api"
+    "github.com/filecoin-project/lotus/build/buildconstants"
+    "github.com/filecoin-project/lotus/chain/actors"
+    "github.com/filecoin-project/lotus/chain/actors/policy"
+    "github.com/filecoin-project/lotus/chain/consensus"
+    "github.com/filecoin-project/lotus/chain/types"
 )
 
-var (
-	outputFormat string
+var ChainCmd = &cli.Command{
+    Name:  "chain",
+    Usage: "Interact with filecoin blockchain",
+    Subcommands: []*cli.Command{
+        ChainHeadCmd,
+        ChainGetBlock,
+        ChainReadObjCmd,
+        ChainDeleteObjCmd,
+        ChainStatObjCmd,
+        ChainGetMsgCmd,
+        ChainSetHeadCmd,
+        ChainListCmd,
+        ChainGetCmd,
+        ChainBisectCmd,
+        ChainExportCmd,
+        ChainExportRangeCmd,
+        SlashConsensusFault,
+        ChainGasPriceCmd,
+        ChainInspectUsage,
+        ChainDecodeCmd,
+        ChainEncodeCmd,
+        ChainDisputeSetCmd,
+        ChainPruneCmd,
+    },
+}
+
+var ChainHeadCmd = &cli.Command{
+    Name:  "head",
+    Usage: "Print chain head",
+    Flags: []cli.Flag{
+        &cli.BoolFlag{
+            Name:  "height",
+            Usage: "print just the epoch number of the chain head",
+        },
+    },
+    Action: func(cctx *cli.Context) error {
+        afmt := NewAppFmt(cctx.App)
+
+        api, closer, err := GetFullNodeAPI(cctx)
+        if err != nil {
+            return err
+        }
+        defer closer()
+        ctx := ReqContext(cctx)
+
+        head, err := api.ChainHead(ctx)
+        if err != nil {
+            return err
+        }
+
+        if cctx.Bool("height") {
+            afmt.Println(head.Height())
+        } else {
+            for _, c := range head.Cids() {
+                afmt.Println(c)
+            }
+        }
+        return nil
+    },
+}
+
+var ChainGetBlock = &cli.Command{
+    Name:      "get-block",
+    Aliases:   []string{"getblock"},
+    Usage:     "Get a block and print its details",
+    ArgsUsage: "[blockCid]",
+    Flags: []cli.Flag{
+        &cli.BoolFlag{
+            Name:  "raw",
+            Usage: "print just the raw block header",
+        },
+    },
+    Action: func(cctx *cli.Context) error {
+        afmt := NewAppFmt(cctx.App)
+
+        api, closer, err := GetFullNodeAPI(cctx)
+        if err != nil {
+            return err
+        }
+        defer closer()
+        ctx := ReqContext(cctx)
+
+        if cctx.NArg() != 1 {
+            return IncorrectNumArgs(cctx)
+        }
+
+        bcid, err := cid.Decode(cctx.Args().First())
+        if err != nil {
+            return err
+        }
+
+        blk, err := api.ChainGetBlock(ctx, bcid)
+        if err != nil {
+            return xerrors.Errorf("get block failed: %w", err)
+        }
+
+        if cctx.Bool("raw") {
+            out, err := json.MarshalIndent(blk, "", "  ")
+            if err != nil {
+                return err
+            }
+
+            afmt.Println(string(out))
+            return nil
+        }
+
+        msgs, err := api.ChainGetBlockMessages(ctx, bcid)
+        if err != nil {
+            return xerrors.Errorf("failed to get messages: %w", err)
+        }
+
+        pmsgs, err := api.ChainGetParentMessages(ctx, bcid)
+        if err != nil {
+            return xerrors.Errorf("failed to get parent messages: %w", err)
+        }
+
+        recpts, err := api.ChainGetParentReceipts(ctx, bcid)
+        if err != nil {
+            log.Warn(err)
+            // return xerrors.Errorf("failed to get receipts: %w", err)
+        }
+
+        cblock := struct {
+            types.BlockHeader
+            BlsMessages    []*types.Message
+            SecpkMessages  []*types.SignedMessage
+            ParentReceipts []*types.MessageReceipt
+            ParentMessages []cid.Cid
+        }{}
+
+        cblock.BlockHeader = *blk
+        cblock.BlsMessages = msgs.BlsMessages
+        cblock.SecpkMessages = msgs.SecpkMessages
+        cblock.ParentReceipts = recpts
+        cblock.ParentMessages = apiMsgCids(pmsgs)
+
+        out, err := json.MarshalIndent(cblock, "", "  ")
+        if err != nil {
+            return err
+        }
+
+        afmt.Println(string(out))
+        return nil
+    },
+}
+
+func apiMsgCids(in []lapi.Message) []cid.Cid {
+    out := make([]cid.Cid, len(in))
+    for k, v := range in {
+        out[k] = v.Cid
+    }
+    return out
+}
+
+var ChainReadObjCmd = &cli.Command{
+    Name:      "read-obj",
+    Usage:     "Read the raw bytes of an object",
+    ArgsUsage: "[objectCid]",
+    Action: func(cctx *cli.Context) error {
+        afmt := NewAppFmt(cctx.App)
+
+        api, closer, err := GetFullNodeAPI(cctx)
+        if err != nil {
+            return err
+        }
+        defer closer()
+        ctx := ReqContext(cctx)
+
+        if cctx.NArg() != 1 {
+            return IncorrectNumArgs(cctx)
+        }
+
+        c, err := cid.Decode(cctx.Args().First())
+        if err != nil {
+            return fmt.Errorf("failed to parse cid input: %s", err)
+        }
+
+        obj, err := api.ChainReadObj(ctx, c)
+        if err != nil {
+            return err
+        }
+
+        afmt.Printf("%x\n", obj)
+        return nil
+    },
+}
+
+var ChainDeleteObjCmd = &cli.Command{
+    Name:        "delete-obj",
+    Usage:       "Delete an object from the chain blockstore",
+    Description: "WARNING: Removing wrong objects from the chain blockstore may lead to sync issues",
+    ArgsUsage:   "[objectCid]",
+    Flags: []cli.Flag{
+        &cli.BoolFlag{
+            Name: "really-do-it",
+        },
+    },
+    Action: func(cctx *cli.Context) error {
+        afmt := NewAppFmt(cctx.App)
+
+        api, closer, err := GetFullNodeAPI(cctx)
+        if err != nil {
+            return err
+        }
+        defer closer()
+        ctx := ReqContext(cctx)
+
+        if cctx.NArg() != 1 {
+            return IncorrectNumArgs(cctx)
+        }
+
+        c, err := cid.Decode(cctx.Args().First())
+        if err != nil {
+            return fmt.Errorf("failed to parse cid input: %s", err)
+        }
+
+        if !cctx.Bool("really-do-it") {
+            return xerrors.Errorf("pass the --really-do-it flag to proceed")
+        }
+
+        err = api.ChainDeleteObj(ctx, c)
+        if err != nil {
+            return err
+        }
+
+        afmt.Printf("Obj %s deleted\n", c.String())
+        return nil
+    },
+}
+
+var ChainStatObjCmd = &cli.Command{
+    Name:      "stat-obj",
+    Usage:     "Collect size and ipld link counts for objs",
+    ArgsUsage: "[cid]",
+    Description: `Collect object size and ipld link count for an object.
+
+   When a base is provided it will be walked first, and all links visisted
+   will be ignored when the passed in object is walked.
+`,
+    Flags: []cli.Flag{
+        &cli.StringFlag{
+            Name:  "base",
+            Usage: "ignore links found in this obj",
+        },
+    },
+    Action: func(cctx *cli.Context) error {
+        afmt := NewAppFmt(cctx.App)
+        api, closer, err := GetFullNodeAPI(cctx)
+        if err != nil {
+            return err
+        }
+        defer closer()
+        ctx := ReqContext(cctx)
+
+        if cctx.NArg() != 1 {
+            return IncorrectNumArgs(cctx)
+        }
+
+        obj, err := cid.Decode(cctx.Args().First())
+        if err != nil {
+            return fmt.Errorf("failed to parse cid input: %s", err)
+        }
+
+        base := cid.Undef
+        if cctx.IsSet("base") {
+            base, err = cid.Decode(cctx.String("base"))
+            if err != nil {
+                return err
+            }
+        }
+
+        stats, err := api.ChainStatObj(ctx, obj, base)
+        if err != nil {
+            return err
+        }
+
+        afmt.Printf("Links: %d\n", stats.Links)
+        afmt.Printf("Size: %s (%d)\n", types.SizeStr(types.NewInt(stats.Size)), stats.Size)
+        return nil
+    },
+}
+
+var ChainGetMsgCmd = &cli.Command{
+    Name:      "getmessage",
+    Aliases:   []string{"get-message", "get-msg"},
+    Usage:     "Get and print a message by its cid",
+    ArgsUsage: "[messageCid]",
+    Action: func(cctx *cli.Context) error {
+        afmt := NewAppFmt(cctx.App)
+
+        if cctx.NArg() != 1 {
+            return IncorrectNumArgs(cctx)
+        }
+
+        api, closer, err := GetFullNodeAPI(cctx)
+        if err != nil {
+            return err
+        }
+        defer closer()
+        ctx := ReqContext(cctx)
+
+        c, err := cid.Decode(cctx.Args().First())
+        if err != nil {
+            return xerrors.Errorf("failed to parse cid input: %w", err)
+        }
+
+        mb, err := api.ChainReadObj(ctx, c)
+        if err != nil {
+            return xerrors.Errorf("failed to read object: %w", err)
+        }
+
+        var i interface{}
+        m, err := types.DecodeMessage(mb)
+        if err != nil {
+            sm, err := types.DecodeSignedMessage(mb)
+            if err != nil {
+                return xerrors.Errorf("failed to decode object as a message: %w", err)
+            }
+            i = sm
+        } else {
+            i = m
+        }
+
+        enc, err := json.MarshalIndent(i, "", "  ")
+        if err != nil {
+            return err
+        }
+
+        afmt.Println(string(enc))
+        return nil
+    },
+}
+
+var ChainSetHeadCmd = &cli.Command{
+    Name:      "sethead",
+    Aliases:   []string{"set-head"},
+    Usage:     "manually set the local nodes head tipset (Caution: normally only used for recovery)",
+    ArgsUsage: "[tipsetkey]",
+    Flags: []cli.Flag{
+        &cli.BoolFlag{
+            Name:  "genesis",
+            Usage: "reset head to genesis",
+        },
+        &cli.Uint64Flag{
+            Name:  "epoch",
+            Usage: "reset head to given epoch",
+        },
+    },
+    Action: func(cctx *cli.Context) error {
+        api, closer, err := GetFullNodeAPI(cctx)
+        if err != nil {
+            return err
+        }
+        defer closer()
+        ctx := ReqContext(cctx)
+
+        if !cctx.Bool("genesis") && !cctx.IsSet("epoch") && cctx.NArg() != 1 {
+            return IncorrectNumArgs(cctx)
+        }
+
+        var ts *types.TipSet
+
+        if cctx.Bool("genesis") {
+            ts, err = api.ChainGetGenesis(ctx)
+        }
+        if ts == nil && cctx.IsSet("epoch") {
+            ts, err = api.ChainGetTipSetByHeight(ctx, abi.ChainEpoch(cctx.Uint64("epoch")), types.EmptyTSK)
+        }
+        if ts == nil {
+            ts, err = parseTipSet(ctx, api, cctx.Args().Slice())
+        }
+        if err != nil {
+            return err
+        }
+
+        if ts == nil {
+            return fmt.Errorf("must pass cids for tipset to set as head")
+        }
+
+        if err := api.ChainSetHead(ctx, ts.Key()); err != nil {
+            return err
+        }
+
+        return nil
+    },
+}
+
+var ChainInspectUsage = &cli.Command{
+    Name:  "inspect-usage",
+    Usage: "Inspect block space usage of a given tipset",
+    Flags: []cli.Flag{
+        &cli.StringFlag{
+            Name:  "tipset",
+            Usage: "specify tipset to view block space usage of",
+            Value: "@head",
+        },
+        &cli.IntFlag{
+            Name:  "length",
+            Usage: "length of chain to inspect block space usage for",
+            Value: 1,
+        },
+        &cli.IntFlag{
+            Name:  "num-results",
+            Usage: "number of results to print per category",
+            Value: 10,
+        },
+    },
+    Action: func(cctx *cli.Context) error {
+        afmt := NewAppFmt(cctx.App)
+        api, closer, err := GetFullNodeAPI(cctx)
+        if err != nil {
+            return err
+        }
+        defer closer()
+        ctx := ReqContext(cctx)
+
+        ts, err := LoadTipSet(ctx, cctx, api)
+        if err != nil {
+            return err
+        }
+
+        cur := ts
+        var msgs []lapi.Message
+        for i := 0; i < cctx.Int("length"); i++ {
+            pmsgs, err := api.ChainGetParentMessages(ctx, cur.Blocks()[0].Cid())
+            if err != nil {
+                return err
+            }
+
+            msgs = append(msgs, pmsgs...)
+
+            next, err := api.ChainGetTipSet(ctx, cur.Parents())
+            if err != nil {
+                return err
+            }
+
+            cur = next
+        }
+
+        codeCache := make(map[address.Address]cid.Cid)
+
+        lookupActorCode := func(a address.Address) (cid.Cid, error) {
+            c, ok := codeCache[a]
+            if ok {
+                return c, nil
+            }
+
+            act, err := api.StateGetActor(ctx, a, ts.Key())
+            if err != nil {
+                return cid.Undef, err
+            }
+
+            codeCache[a] = act.Code
+            return act.Code, nil
+        }
+
+        bySender := make(map[string]int64)
+        byDest := make(map[string]int64)
+        byMethod := make(map[string]int64)
+        bySenderC := make(map[string]int64)
+        byDestC := make(map[string]int64)
+        byMethodC := make(map[string]int64)
+
+        var sum int64
+        for _, m := range msgs {
+            bySender[m.Message.From.String()] += m.Message.GasLimit
+            bySenderC[m.Message.From.String()]++
+            byDest[m.Message.To.String()] += m.Message.GasLimit
+            byDestC[m.Message.To.String()]++
+            sum += m.Message.GasLimit
+
+            code, err := lookupActorCode(m.Message.To)
+            if err != nil {
+                if strings.Contains(err.Error(), types.ErrActorNotFound.Error()) {
+                    continue
+                }
+                return err
+            }
+
+            mm := consensus.NewActorRegistry().Methods[code][m.Message.Method] // TODO: use remote map
+
+            byMethod[mm.Name] += m.Message.GasLimit
+            byMethodC[mm.Name]++
+        }
+
+        type keyGasPair struct {
+            Key string
+            Gas int64
+        }
+
+        mapToSortedKvs := func(m map[string]int64) []keyGasPair {
+            var vals []keyGasPair
+            for k, v := range m {
+                vals = append(vals, keyGasPair{
+                    Key: k,
+                    Gas: v,
+                })
+            }
+            sort.Slice(vals, func(i, j int) bool {
+                return vals[i].Gas > vals[j].Gas
+            })
+            return vals
+        }
+
+        senderVals := mapToSortedKvs(bySender)
+        destVals := mapToSortedKvs(byDest)
+        methodVals := mapToSortedKvs(byMethod)
+
+        numRes := cctx.Int("num-results")
+
+        data := map[string]interface{}{
+            "TotalGasLimit": sum,
+            "BySender":      senderVals,
+            "ByReceiver":    destVals,
+            "ByMethod":      methodVals,
+        }
+
+        return util.FormatOutput(cctx, data)
+    },
+}
+
+var ChainListCmd = &cli.Command{
+    Name:    "list",
+    Aliases: []string{"love"},
+    Usage:   "View a segment of the chain",
+    Flags: []cli.Flag{
+        &cli.Uint64Flag{Name: "epoch", Aliases: []string{"height"}, DefaultText: "current head"},
+        &cli.IntFlag{Name: "count", Value: 30},
+        &cli.StringFlag{
+            Name:  "format",
+            Usage: "specify the format to print out tipsets using placeholders: <epoch>, <time>, <blocks>, <weight>, <tipset>, <json_tipset>\n",
+            Value: "<epoch>: (<time>) <blocks>",
+        },
+        &cli.BoolFlag{
+            Name:  "gas-stats",
+            Usage: "view gas statistics for the chain",
+        },
+    },
+    Action: func(cctx *cli.Context) error {
+        afmt := NewAppFmt(cctx.App)
+        api, closer, err := GetFullNodeAPI(cctx)
+        if err != nil {
+            return err
+        }
+        defer closer()
+        ctx := ReqContext(cctx)
+
+        var head *types.TipSet
+
+        if cctx.IsSet("height") {
+            head, err = api.ChainGetTipSetByHeight(ctxpackage cli
+
+import (
+    "bytes"
+    "context"
+    "encoding/base64"
+    "encoding/hex"
+    "encoding/json"
+    "errors"
+    "fmt"
+    "io"
+    "os"
+    "os/exec"
+    "path"
+    "sort"
+    "strconv"
+    "strings"
+    "time"
+
+    "github.com/ipfs/go-cid"
+    "github.com/urfave/cli/v2"
+    cbg "github.com/whyrusleeping/cbor-gen"
+    "golang.org/x/xerrors"
+
+    "github.com/filecoin-project/go-address"
+    cborutil "github.com/filecoin-project/go-cbor-util"
+    "github.com/filecoin-project/go-state-types/abi"
+    "github.com/filecoin-project/go-state-types/big"
+    "github.com/filecoin-project/specs-actors/actors/builtin"
+    "github.com/filecoin-project/specs-actors/actors/builtin/account"
+    "github.com/filecoin-project/specs-actors/actors/builtin/market"
+    "github.com/filecoin-project/specs-actors/actors/builtin/miner"
+    "github.com/filecoin-project/specs-actors/actors/builtin/power"
+    "github.com/filecoin-project/specs-actors/actors/util/adt"
+
+    "github.com/filecoin-project/lotus/api"
+    lapi "github.com/filecoin-project/lotus/api"
+    "github.com/filecoin-project/lotus/api/v0api"
+    "github.com/filecoin-project/lotus/build/buildconstants"
+    "github.com/filecoin-project/lotus/chain/actors"
+    "github.com/filecoin-project/lotus/chain/actors/policy"
+    "github.com/filecoin-project/lotus/chain/consensus"
+    "github.com/filecoin-project/lotus/chain/types"
 )
 
-func init() {
-	rootCmd.PersistentFlags().StringVarP(&outputFormat, "output", "o", "text", "Output format (json|text)")
+var ChainCmd = &cli.Command{
+    Name:  "chain",
+    Usage: "Interact with filecoin blockchain",
+    Subcommands: []*cli.Command{
+        ChainHeadCmd,
+        ChainGetBlock,
+        ChainReadObjCmd,
+        ChainDeleteObjCmd,
+        ChainStatObjCmd,
+        ChainGetMsgCmd,
+        ChainSetHeadCmd,
+        ChainListCmd,
+        ChainGetCmd,
+        ChainBisectCmd,
+        ChainExportCmd,
+        ChainExportRangeCmd,
+        SlashConsensusFault,
+        ChainGasPriceCmd,
+        ChainInspectUsage,
+        ChainDecodeCmd,
+        ChainEncodeCmd,
+        ChainDisputeSetCmd,
+        ChainPruneCmd,
+    },
 }
 
-func rootCmd() *cobra.Command {
-	var rootCmd = &cobra.Command{
-		Use:   "lotus",
-		Short: "Lotus CLI",
-	}
+var ChainHeadCmd = &cli.Command{
+    Name:  "head",
+    Usage: "Print chain head",
+    Flags: []cli.Flag{
+        &cli.BoolFlag{
+            Name:  "height",
+            Usage: "print just the epoch number of the chain head",
+        },
+    },
+    Action: func(cctx *cli.Context) error {
+        afmt := NewAppFmt(cctx.App)
 
-	// Add subcommands here
+        api, closer, err := GetFullNodeAPI(cctx)
+        if err != nil {
+            return err
+        }
+        defer closer()
+        ctx := ReqContext(cctx)
 
-	return rootCmd
+        head, err := api.ChainHead(ctx)
+        if err != nil {
+            return err
+        }
+
+        if cctx.Bool("height") {
+            afmt.Println(head.Height())
+        } else {
+            for _, c := range head.Cids() {
+                afmt.Println(c)
+            }
+        }
+        return nil
+    },
 }
 
-func main() {
-	if err := rootCmd().Execute(); err != nil {
-		fmt.Println(err)
-		os.Exit(1)
-	}
+var ChainGetBlock = &cli.Command{
+    Name:      "get-block",
+    Aliases:   []string{"getblock"},
+    Usage:     "Get a block and print its details",
+    ArgsUsage: "[blockCid]",
+    Flags: []cli.Flag{
+        &cli.BoolFlag{
+            Name:  "raw",
+            Usage: "print just the raw block header",
+        },
+    },
+    Action: func(cctx *cli.Context) error {
+        afmt := NewAppFmt(cctx.App)
+
+        api, closer, err := GetFullNodeAPI(cctx)
+        if err != nil {
+            return err
+        }
+        defer closer()
+        ctx := ReqContext(cctx)
+
+        if cctx.NArg() != 1 {
+            return IncorrectNumArgs(cctx)
+        }
+
+        bcid, err := cid.Decode(cctx.Args().First())
+        if err != nil {
+            return err
+        }
+
+        blk, err := api.ChainGetBlock(ctx, bcid)
+        if err != nil {
+            return xerrors.Errorf("get block failed: %w", err)
+        }
+
+        if cctx.Bool("raw") {
+            out, err := json.MarshalIndent(blk, "", "  ")
+            if err != nil {
+                return err
+            }
+
+            afmt.Println(string(out))
+            return nil
+        }
+
+        msgs, err := api.ChainGetBlockMessages(ctx, bcid)
+        if err != nil {
+            return xerrors.Errorf("failed to get messages: %w", err)
+        }
+
+        pmsgs, err := api.ChainGetParentMessages(ctx, bcid)
+        if err != nil {
+            return xerrors.Errorf("failed to get parent messages: %w", err)
+        }
+
+        recpts, err := api.ChainGetParentReceipts(ctx, bcid)
+        if err != nil {
+            log.Warn(err)
+            // return xerrors.Errorf("failed to get receipts: %w", err)
+        }
+
+        cblock := struct {
+            types.BlockHeader
+            BlsMessages    []*types.Message
+            SecpkMessages  []*types.SignedMessage
+            ParentReceipts []*types.MessageReceipt
+            ParentMessages []cid.Cid
+        }{}
+
+        cblock.BlockHeader = *blk
+        cblock.BlsMessages = msgs.BlsMessages
+        cblock.SecpkMessages = msgs.SecpkMessages
+        cblock.ParentReceipts = recpts
+        cblock.ParentMessages = apiMsgCids(pmsgs)
+
+        out, err := json.MarshalIndent(cblock, "", "  ")
+        if err != nil {
+            return err
+        }
+
+        afmt.Println(string(out))
+        return nil
+    },
 }
 
-var ChainReadObjCmd = &cobra.Command{
-	Name:      "read-obj",
-	Usage:     "Read the raw bytes of an object",
-	ArgsUsage: "[objectCid]",
-	Run: func(cmd *cobra.Command, args []string) {
-		// ...
-
-		switch outputFormat {
-		case "json":
-			// Output data in JSON format
-			jsonData, _ := json.Marshal(data)
-			fmt.Println(string(jsonData))
-		case "text":
-			// Output data in plain text format
-			fmt.Println(data)
-		default:
-			return fmt.Errorf("unknown output format: %s", outputFormat)
-		}
-
-		return nil
-	},
-}
-
-var ChainSetHeadCmd = &cobra.Command{
-	Name:      "sethead",
-	Aliases:   []string{"set-head"},
-	Usage:     "manually set the local nodes head tipset (Caution: normally only used for recovery)",
-	ArgsUsage: "[tipsetkey]",
-	Run: func(cmd *cobra.Command, args []string) {
-		// ...
-
-		switch outputFormat {
-		case "json":
-			// Output data in JSON format
-			jsonData, _ := json.Marshal(data)
-			fmt.Println(string(jsonData))
-		case "text":
-			// Output data in plain text format
-			fmt.Println(data)
-		default:
-			return fmt.Errorf("unknown output format: %s", outputFormat)
-		}
-
-		return nil
-	},
-}
-
-// ... (update other subcommands similarly)
-
-func printTipSet(format string, ts *types.TipSet, afmt *AppFmt) {
-	// ...
-
-	switch outputFormat {
-	case "json":
-		// Output data in JSON format
-		jsonData, _ := json.Marshal(ts)
-		fmt.Println(string(jsonData))
-	case "text":
-		// Output data in plain text format
-		fmt.Println(ts)
-	default:
-		return fmt.Errorf("unknown output format: %s", outputFormat)
-	}
+func apiMsgCids(in []lapi.Message) []cid.Cid {
+    out := make([]cid.Cid, len(in))
+    for k, v := range in {
+        out[k] = v.Cid
+    }
+    return out
 }
 
-func createExportFile(app *cli.App, path string) (io.WriteCloser, error) {
-	// ...
+var ChainReadObjCmd = &cli.Command{
+    Name:      "read-obj",
+    Usage:     "Read the raw bytes of an object",
+    ArgsUsage: "[objectCid]",
+    Action: func(cctx *cli.Context) error {
+        afmt := NewAppFmt(cctx.App)
 
-	switch outputFormat {
-	case "json":
-		// Output data in JSON format
-		jsonData, _ := json.Marshal(data)
-		return os.Create(path + ".json"), nil
-	case "text":
-		// Output data in plain text format
-		return os.Create(path + ".txt"), nil
-	default:
-		return nil, fmt.Errorf("unknown output format: %s", outputFormat)
-	}
+        api, closer, err := GetFullNodeAPI(cctx)
+        if err != nil {
+            return err
+        }
+        defer closer()
+        ctx := ReqContext(cctx)
+
+        if cctx.NArg() != 1 {
+            return IncorrectNumArgs(cctx)
+        }
+
+        c, err := cid.Decode(cctx.Args().First())
+        if err != nil {
+            return fmt.Errorf("failed to parse cid input: %s", err)
+        }
+
+        obj, err := api.ChainReadObj(ctx, c)
+        if err != nil {
+            return err
+        }
+
+        afmt.Printf("%x\n", obj)
+        return nil
+    },
+}
+
+var ChainDeleteObjCmd = &cli.Command{
+    Name:        "delete-obj",
+    Usage:       "Delete an object from the chain blockstore",
+    Description: "WARNING: Removing wrong objects from the chain blockstore may lead to sync issues",
+    ArgsUsage:   "[objectCid]",
+    Flags: []cli.Flag{
+        &cli.BoolFlag{
+            Name: "really-do-it",
+        },
+    },
+    Action: func(cctx *cli.Context) error {
+        afmt := NewAppFmt(cctx.App)
+
+        api, closer, err := GetFullNodeAPI(cctx)
+        if err != nil {
+            return err
+        }
+        defer closer()
+        ctx := ReqContext(cctx)
+
+        if cctx.NArg() != 1 {
+            return IncorrectNumArgs(cctx)
+        }
+
+        c, err := cid.Decode(cctx.Args().First())
+        if err != nil {
+            return fmt.Errorf("failed to parse cid input: %s", err)
+        }
+
+        if !cctx.Bool("really-do-it") {
+            return xerrors.Errorf("pass the --really-do-it flag to proceed")
+        }
+
+        err = api.ChainDeleteObj(ctx, c)
+        if err != nil {
+            return err
+        }
+
+        afmt.Printf("Obj %s deleted\n", c.String())
+        return nil
+    },
+}
+
+var ChainStatObjCmd = &cli.Command{
+    Name:      "stat-obj",
+    Usage:     "Collect size and ipld link counts for objs",
+    ArgsUsage: "[cid]",
+    Description: `Collect object size and ipld link count for an object.
+
+   When a base is provided it will be walked first, and all links visisted
+   will be ignored when the passed in object is walked.
+`,
+    Flags: []cli.Flag{
+        &cli.StringFlag{
+            Name:  "base",
+            Usage: "ignore links found in this obj",
+        },
+    },
+    Action: func(cctx *cli.Context) error {
+        afmt := NewAppFmt(cctx.App)
+        api, closer, err := GetFullNodeAPI(cctx)
+        if err != nil {
+            return err
+        }
+        defer closer()
+        ctx := ReqContext(cctx)
+
+        if cctx.NArg() != 1 {
+            return IncorrectNumArgs(cctx)
+        }
+
+        obj, err := cid.Decode(cctx.Args().First())
+        if err != nil {
+            return fmt.Errorf("failed to parse cid input: %s", err)
+        }
+
+        base := cid.Undef
+        if cctx.IsSet("base") {
+            base, err = cid.Decode(cctx.String("base"))
+            if err != nil {
+                return err
+            }
+        }
+
+        stats, err := api.ChainStatObj(ctx, obj, base)
+        if err != nil {
+            return err
+        }
+
+        afmt.Printf("Links: %d\n", stats.Links)
+        afmt.Printf("Size: %s (%d)\n", types.SizeStr(types.NewInt(stats.Size)), stats.Size)
+        return nil
+    },
+}
+
+var ChainGetMsgCmd = &cli.Command{
+    Name:      "getmessage",
+    Aliases:   []string{"get-message", "get-msg"},
+    Usage:     "Get and print a message by its cid",
+    ArgsUsage: "[messageCid]",
+    Action: func(cctx *cli.Context) error {
+        afmt := NewAppFmt(cctx.App)
+
+        if cctx.NArg() != 1 {
+            return IncorrectNumArgs(cctx)
+        }
+
+        api, closer, err := GetFullNodeAPI(cctx)
+        if err != nil {
+            return err
+        }
+        defer closer()
+        ctx := ReqContext(cctx)
+
+        c, err := cid.Decode(cctx.Args().First())
+        if err != nil {
+            return xerrors.Errorf("failed to parse cid input: %w", err)
+        }
+
+        mb, err := api.ChainReadObj(ctx, c)
+        if err != nil {
+            return xerrors.Errorf("failed to read object: %w", err)
+        }
+
+        var i interface{}
+        m, err := types.DecodeMessage(mb)
+        if err != nil {
+            sm, err := types.DecodeSignedMessage(mb)
+            if err != nil {
+                return xerrors.Errorf("failed to decode object as a message: %w", err)
+            }
+            i = sm
+        } else {
+            i = m
+        }
+
+        enc, err := json.MarshalIndent(i, "", "  ")
+        if err != nil {
+            return err
+        }
+
+        afmt.Println(string(enc))
+        return nil
+    },
+}
+
+var ChainSetHeadCmd = &cli.Command{
+    Name:      "sethead",
+    Aliases:   []string{"set-head"},
+    Usage:     "manually set the local nodes head tipset (Caution: normally only used for recovery)",
+    ArgsUsage: "[tipsetkey]",
+    Flags: []cli.Flag{
+        &cli.BoolFlag{
+            Name:  "genesis",
+            Usage: "reset head to genesis",
+        },
+        &cli.Uint64Flag{
+            Name:  "epoch",
+            Usage: "reset head to given epoch",
+        },
+    },
+    Action: func(cctx *cli.Context) error {
+        api, closer, err := GetFullNodeAPI(cctx)
+        if err != nil {
+            return err
+        }
+        defer closer()
+        ctx := ReqContext(cctx)
+
+        if !cctx.Bool("genesis") && !cctx.IsSet("epoch") && cctx.NArg() != 1 {
+            return IncorrectNumArgs(cctx)
+        }
+
+        var ts *types.TipSet
+
+        if cctx.Bool("genesis") {
+            ts, err = api.ChainGetGenesis(ctx)
+        }
+        if ts == nil && cctx.IsSet("epoch") {
+            ts, err = api.ChainGetTipSetByHeight(ctx, abi.ChainEpoch(cctx.Uint64("epoch")), types.EmptyTSK)
+        }
+        if ts == nil {
+            ts, err = parseTipSet(ctx, api, cctx.Args().Slice())
+        }
+        if err != nil {
+            return err
+        }
+
+        if ts == nil {
+            return fmt.Errorf("must pass cids for tipset to set as head")
+        }
+
+        if err := api.ChainSetHead(ctx, ts.Key()); err != nil {
+            return err
+        }
+
+        return nil
+    },
+}
+
+var ChainInspectUsage = &cli.Command{
+    Name:  "inspect-usage",
+    Usage: "Inspect block space usage of a given tipset",
+    Flags: []cli.Flag{
+        &cli.StringFlag{
+            Name:  "tipset",
+            Usage: "specify tipset to view block space usage of",
+            Value: "@head",
+        },
+        &cli.IntFlag{
+            Name:  "length",
+            Usage: "length of chain to inspect block space usage for",
+            Value: 1,
+        },
+        &cli.IntFlag{
+            Name:  "num-results",
+            Usage: "number of results to print per category",
+            Value: 10,
+        },
+    },
+    Action: func(cctx *cli.Context) error {
+        afmt := NewAppFmt(cctx.App)
+        api, closer, err := GetFullNodeAPI(cctx)
+        if err != nil {
+            return err
+        }
+        defer closer()
+        ctx := ReqContext(cctx)
+
+        ts, err := LoadTipSet(ctx, cctx, api)
+        if err != nil {
+            return err
+        }
+
+        cur := ts
+        var msgs []lapi.Message
+        for i := 0; i < cctx.Int("length"); i++ {
+            pmsgs, err := api.ChainGetParentMessages(ctx, cur.Blocks()[0].Cid())
+            if err != nil {
+                return err
+            }
+
+            msgs = append(msgs, pmsgs...)
+
+            next, err := api.ChainGetTipSet(ctx, cur.Parents())
+            if err != nil {
+                return err
+            }
+
+            cur = next
+        }
+
+        codeCache := make(map[address.Address]cid.Cid)
+
+        lookupActorCode := func(a address.Address) (cid.Cid, error) {
+            c, ok := codeCache[a]
+            if ok {
+                return c, nil
+            }
+
+            act, err := api.StateGetActor(ctx, a, ts.Key())
+            if err != nil {
+                return cid.Undef, err
+            }
+
+            codeCache[a] = act.Code
+            return act.Code, nil
+        }
+
+        bySender := make(map[string]int64)
+        byDest := make(map[string]int64)
+        byMethod := make(map[string]int64)
+        bySenderC := make(map[string]int64)
+        byDestC := make(map[string]int64)
+        byMethodC := make(map[string]int64)
+
+        var sum int64
+        for _, m := range msgs {
+            bySender[m.Message.From.String()] += m.Message.GasLimit
+            bySenderC[m.Message.From.String()]++
+            byDest[m.Message.To.String()] += m.Message.GasLimit
+            byDestC[m.Message.To.String()]++
+            sum += m.Message.GasLimit
+
+            code, err := lookupActorCode(m.Message.To)
+            if err != nil {
+                if strings.Contains(err.Error(), types.ErrActorNotFound.Error()) {
+                    continue
+                }
+                return err
+            }
+
+            mm := consensus.NewActorRegistry().Methods[code][m.Message.Method] // TODO: use remote map
+
+            byMethod[mm.Name] += m.Message.GasLimit
+            byMethodC[mm.Name]++
+        }
+
+        type keyGasPair struct {
+            Key string
+            Gas int64
+        }
+
+        mapToSortedKvs := func(m map[string]int64) []keyGasPair {
+            var vals []keyGasPair
+            for k, v := range m {
+                vals = append(vals, keyGasPair{
+                    Key: k,
+                    Gas: v,
+                })
+            }
+            sort.Slice(vals, func(i, j int) bool {
+                return vals[i].Gas > vals[j].Gas
+            })
+            return vals
+        }
+
+        senderVals := mapToSortedKvs(bySender)
+        destVals := mapToSortedKvs(byDest)
+        methodVals := mapToSortedKvs(byMethod)
+
+        numRes := cctx.Int("num-results")
+
+        data := map[string]interface{}{
+            "TotalGasLimit": sum,
+            "BySender":      senderVals,
+            "ByReceiver":    destVals,
+            "ByMethod":      methodVals,
+        }
+
+        return util.FormatOutput(cctx, data)
+    },
 }
 
-// Standardise a top level output format for all lotus CLIs
\ No newline at end of file
+var ChainListCmd = &cli.Command{
+    Name:    "list",
+    Aliases: []string{"love"},
+    Usage:   "View a segment of the chain",
+    Flags: []cli.Flag{
+        &cli.Uint64Flag{Name: "epoch", Aliases: []string{"height"}, DefaultText: "current head"},
+        &cli.IntFlag{Name: "count", Value: 30},
+        &cli.StringFlag{
+            Name:  "format",
+            Usage: "specify the format to print out tipsets using placeholders: <epoch>, <time>, <blocks>, <weight>, <tipset>, <json_tipset>\n",
+            Value: "<epoch>: (<time>) <blocks>",
+        },
+        &cli.BoolFlag{
+            Name:  "gas-stats",
+            Usage: "view gas statistics for the chain",
+        },
+    },
+    Action: func(cctx *cli.Context) error {
+        afmt := NewAppFmt(cctx.App)
+        api, closer, err := GetFullNodeAPI(cctx)
+        if err != nil {
+            return err
+        }
+        defer closer()
+        ctx := ReqContext(cctx)
+
+        var head *types.TipSet
+
+        if cctx.IsSet("height") {
+            head, err = api.ChainGetTipSetByHeight(ctx, abi.ChainEpoch(cctx.Uint64("height")), types.EmptyTSK)
+			} else {
+				head, err = api.ChainHead(ctx)
+			}
+			if err != nil {
+				return err
+			}
+	
+			count := cctx.Int("count")
+			if count < 1 {
+				return nil
+			}
+	
+			tss := make([]*types.TipSet, 0, count)
+			tss = append(tss, head)
+	
+			for i := 1; i < count; i++ {
+				if head.Height() == 0 {
+					break
+				}
+	
+				head, err = api.ChainGetTipSet(ctx, head.Parents())
+				if err != nil {
+					return err
+				}
+	
+				tss = append(tss, head)
+			}
+	
+			if cctx.Bool("gas-stats") {
+				otss := make([]*types.TipSet, 0, len(tss))
+				for i := len(tss) - 1; i >= 0; i-- {
+					otss = append(otss, tss[i])
+				}
+				tss = otss
+				for i, ts := range tss {
+					pbf := ts.Blocks()[0].ParentBaseFee
+					afmt.Printf("%d: %d blocks (baseFee: %s -> maxFee: %s)\n", ts.Height(), len(ts.Blocks()), ts.Blocks()[0].ParentBaseFee, types.FIL(types.BigMul(pbf, types.NewInt(uint64(buildconstants.BlockGasLimit)))))
+	
+					for _, b := range ts.Blocks() {
+						msgs, err := api.ChainGetBlockMessages(ctx, b.Cid())
+						if err != nil {
+							return err
+						}
+						var limitSum int64
+						psum := big.NewInt(0)
+						for _, m := range msgs.BlsMessages {
+							limitSum += m.GasLimit
+							psum = big.Add(psum, m.GasPremium)
+						}
+	
+						for _, m := range msgs.SecpkMessages {
+							limitSum += m.Message.GasLimit
+							psum = big.Add(psum, m.Message.GasPremium)
+						}
+	
+						lenmsgs := len(msgs.BlsMessages) + len(msgs.SecpkMessages)
+	
+						avgpremium := big.Zero()
+						if lenmsgs > 0 {
+							avgpremium = big.Div(psum, big.NewInt(int64(lenmsgs)))
+						}
+	
+						afmt.Printf("\t%s: \t%d msgs, gasLimit: %d / %d (%0.2f%%), avgPremium: %s\n", b.Miner, len(msgs.BlsMessages)+len(msgs.SecpkMessages), limitSum, buildconstants.BlockGasLimit, 100*float64(limitSum)/float64(buildconstants.BlockGasLimit), avgpremium)
+					}
+					if i < len(tss)-1 {
+						msgs, err := api.ChainGetParentMessages(ctx, tss[i+1].Blocks()[0].Cid())
+						if err != nil {
+							return err
+						}
+						var limitSum int64
+						for _, m := range msgs {
+							limitSum += m.Message.GasLimit
+						}
+	
+						recpts, err := api.ChainGetParentReceipts(ctx, tss[i+1].Blocks()[0].Cid())
+						if err != nil {
+							return err
+						}
+	
+						var gasUsed int64
+						for _, r := range recpts {
+							gasUsed += r.GasUsed
+						}
+	
+						gasEfficiency := 100 * float64(gasUsed) / float64(limitSum)
+						gasCapacity := 100 * float64(limitSum) / float64(buildconstants.BlockGasLimit)
+	
+						afmt.Printf("\ttipset: \t%d msgs, %d (%0.2f%%) / %d (%0.2f%%)\n", len(msgs), gasUsed, gasEfficiency, limitSum, gasCapacity)
+					}
+					afmt.Println()
+				}
+			} else {
+				for i := len(tss) - 1; i >= 0; i-- {
+					printTipSet(cctx.String("format"), tss[i], afmt)
+				}
+			}
+			return nil
+		},
+	}
diff --git a/cli/clicommands/cmd.go b/cli/clicommands/cmd.go
index 126ea06901c..d3c35a6d4c4 100644
--- a/cli/clicommands/cmd.go
+++ b/cli/clicommands/cmd.go
@@ -1,67 +1,107 @@
 package clicommands
 
 import (
-	"github.com/urfave/cli/v2"
-
-	lcli "github.com/filecoin-project/lotus/cli"
+    "github.com/urfave/cli/v2"
+    lcli "github.com/filecoin-project/lotus/cli"
 )
 
 var Commands = []*cli.Command{
-	lcli.WithCategory("basic", lcli.SendCmd),
-	lcli.WithCategory("basic", lcli.WalletCmd),
-	lcli.WithCategory("basic", lcli.InfoCmd),
-	lcli.WithCategory("basic", lcli.MultisigCmd),
-	lcli.WithCategory("basic", lcli.FilplusCmd),
-	lcli.WithCategory("basic", lcli.PaychCmd),
-	lcli.WithCategory("developer", lcli.AuthCmd),
-	lcli.WithCategory("developer", lcli.MpoolCmd),
-	lcli.WithCategory("developer", StateCmd),
-	lcli.WithCategory("developer", lcli.ChainCmd),
-	lcli.WithCategory("developer", lcli.LogCmd),
-	{
-		Name:  "index",
-		Usage: "Commands related to managing the chainindex",
-		Flags: []cli.Flag{
-			&cli.StringFlag{
-				Name:  "output",
-				Usage: "output format (json or text)",
-				Value: "text",
-			},
-			&cli.IntFlag{
-				Name:     "from",
-				Usage:    "from specifies the starting tipset epoch for validation (inclusive)",
-				Required: true,
-			},
-			&cli.IntFlag{
-				Name:     "to",
-				Usage:    "to specifies the ending tipset epoch for validation (inclusive)",
-				Required: true,
-			},
-			&cli.BoolFlag{
-				Name:  "backfill",
-				Usage: "backfill determines whether to backfill missing index entries during validation (default: true)",
-				Value: true,
-			},
-			&cli.BoolFlag{
-				Name:  "log-good",
-				Usage: "log tipsets that have no detected problems",
-				Value: false,
-			},
-			&cli.BoolFlag{
-				Name:  "quiet",
-				Usage: "suppress output except for errors (or good tipsets if log-good is enabled)",
-			},
-		},
-	},
-	{
-		Name:  "miner",
-		Usage: "Commands related to managing the miner",
-		Flags: []cli.Flag{
-			&cli.StringFlag{
-				Name:  "output",
-				Usage: "output format (json or text)",
-				Value: "text",
-			},
-		},
-	}, // Standardise a top level output format for all lotus CLIs
+    lcli.WithCategory("basic", wrapCommandWithOutput(lcli.SendCmd)),
+    lcli.WithCategory("basic", wrapCommandWithOutput(lcli.WalletCmd)),
+    lcli.WithCategory("basic", wrapCommandWithOutput(lcli.InfoCmd)),
+    lcli.WithCategory("basic", wrapCommandWithOutput(lcli.MultisigCmd)),
+    lcli.WithCategory("basic", wrapCommandWithOutput(lcli.FilplusCmd)),
+    lcli.WithCategory("basic", wrapCommandWithOutput(lcli.PaychCmd)),
+    lcli.WithCategory("developer", wrapCommandWithOutput(lcli.AuthCmd)),
+    lcli.WithCategory("developer", wrapCommandWithOutput(lcli.MpoolCmd)),
+    lcli.WithCategory("developer", wrapCommandWithOutput(StateCmd)),
+    lcli.WithCategory("developer", wrapCommandWithOutput(lcli.ChainCmd)),
+    lcli.WithCategory("developer", wrapCommandWithOutput(lcli.LogCmd)),
+    lcli.WithCategory("developer", wrapCommandWithOutput(lcli.WaitApiCmd)),
+    lcli.WithCategory("developer", wrapCommandWithOutput(lcli.FetchParamCmd)),
+    lcli.WithCategory("developer", wrapCommandWithOutput(lcli.EvmCmd)),
+    lcli.WithCategory("developer", wrapCommandWithOutput(lcli.IndexCmd)),
+    lcli.WithCategory("network", wrapCommandWithOutput(lcli.NetCmd)),
+    lcli.WithCategory("network", wrapCommandWithOutput(lcli.SyncCmd)),
+    lcli.WithCategory("network", wrapCommandWithOutput(lcli.F3Cmd)),
+    lcli.WithCategory("status", wrapCommandWithOutput(lcli.StatusCmd)),
+    wrapCommandWithOutput(lcli.PprofCmd),
+    wrapCommandWithOutput(lcli.VersionCmd),
+    {
+        Name:  "index",
+        Usage: "Commands related to managing the chainindex",
+        Flags: []cli.Flag{
+            &cli.StringFlag{
+                Name:  "output",
+                Usage: "output format (json or text)",
+                Value: "text",
+            },
+            &cli.IntFlag{
+                Name:     "from",
+                Usage:    "from specifies the starting tipset epoch for validation (inclusive)",
+                Required: true,
+            },
+            &cli.IntFlag{
+                Name:     "to",
+                Usage:    "to specifies the ending tipset epoch for validation (inclusive)",
+                Required: true,
+            },
+            &cli.BoolFlag{
+                Name:  "backfill",
+                Usage: "backfill determines whether to backfill missing index entries during validation (default: true)",
+                Value: true,
+            },
+            &cli.BoolFlag{
+                Name:  "log-good",
+                Usage: "log tipsets that have no detected problems",
+                Value: false,
+            },
+            &cli.BoolFlag{
+                Name:  "quiet",
+                Usage: "suppress output except for errors (or good tipsets if log-good is enabled)",
+            },
+        },
+        Action: func(cctx *cli.Context) error {
+            // Your command logic here
+            data := getDataFromContext(cctx)
+            return util.FormatOutput(cctx, data)
+        },
+    },
+    {
+        Name:  "miner",
+        Usage: "Commands related to managing the miner",
+        Flags: []cli.Flag{
+            &cli.StringFlag{
+                Name:  "output",
+                Usage: "output format (json or text)",
+                Value: "text",
+            },
+        },
+        Action: func(cctx *cli.Context) error {
+            // Your command logic here
+            data := getDataFromContext(cctx)
+            return util.FormatOutput(cctx, data)
+        },
+    },
+}
+
+func wrapCommandWithOutput(cmd *cli.Command) *cli.Command {
+    originalAction := cmd.Action
+    cmd.Action = func(cctx *cli.Context) error {
+        if originalAction != nil {
+            err := originalAction(cctx)
+            if err != nil {
+                return err
+            }
+        }
+        // Assuming data is the output data you want to format
+        data := getDataFromContext(cctx)
+        return util.FormatOutput(cctx, data)
+    }
+    return cmd
+}
+
+func getDataFromContext(cctx *cli.Context) interface{} {
+    // Implement this function to extract the data you want to format from the context
+    return nil
 }
\ No newline at end of file
diff --git a/cli/index.go b/cli/index.go
index 57927ca1975..8d9539299cf 100644
--- a/cli/index.go
+++ b/cli/index.go
@@ -1,63 +1,234 @@
-package clicommands
+package cli
 
 import (
-	"github.com/urfave/cli/v2"
+    "encoding/json"
+    "fmt"
+    "strings"
+    "time"
 
-	lcli "github.com/filecoin-project/lotus/cli"
+    "github.com/urfave/cli/v2"
+    "golang.org/x/xerrors"
+
+    "github.com/filecoin-project/go-state-types/abi"
+    "path/to/cli/util"
 )
 
-var Commands = []*cli.Command{
-	lcli.WithCategory("basic", lcli.SendCmd),
-	lcli.WithCategory("basic", lcli.WalletCmd),
-	lcli.WithCategory("basic", lcli.InfoCmd),
-	lcli.WithCategory("basic", lcli.MultisigCmd),
-	lcli.WithCategory("basic", lcli.FilplusCmd),
-	lcli.WithCategory("basic", lcli.PaychCmd),
-	lcli.WithCategory("developer", lcli.AuthCmd),
-	lcli.WithCategory("developer", lcli.MpoolCmd),
-	lcli.WithCategory("developer", StateCmd),
-	lcli.WithCategory("developer", lcli.ChainCmd),
-	lcli.WithCategory("developer", lcli.LogCmd),
-	{
-		Name:  "index",
-		Usage: "Commands related to managing the chainindex",
-		Flags: []cli.Flag{
-			&cli.StringFlag{
-				Name:  "output",
-				Usage: "output format (json or text)",
-				Value: "text",
-			},
-			&cli.IntFlag{
-				Name:     "from",
-				Usage:    "from specifies the starting tipset epoch for validation (inclusive)",
-				Required: true,
-			},
-			&cli.IntFlag{
-				Name:     "to",
-				Usage:    "to specifies the ending tipset epoch for validation (inclusive)",
-				Required: true,
-			},
-			&cli.BoolFlag{
-				Name:  "backfill",
-				Usage: "backfill determines whether to backfill missing index entries during validation (default: true)",
-				Value: true,
-			},
-			&cli.BoolFlag{
-				Name:  "log-good",
-				Usage: "log tipsets that have no detected problems",
-				Value: false,
-			},
-			&cli.BoolFlag{
-				Name:  "quiet",
-				Usage: "suppress output except for errors (or good tipsets if log-good is enabled)",
-			},
-		},
-	},
-}func (c *IndexCmd) Action(ctx *cli.Context) error {
-	// ...
-	outputFormat := ctx.String("output")
-	if outputFormat != "json" && outputFormat != "text" {
-		return fmt.Errorf("invalid output format: %s", outputFormat)
-	}
-	// Standardise a top level output format for all lotus CLIs
+var IndexCmd = &cli.Command{
+    Name:  "index",
+    Usage: "Commands related to managing the chainindex",
+    Subcommands: []*cli.Command{
+        validateBackfillChainIndexCmd,
+    },
+}
+
+var validateBackfillChainIndexCmd = &cli.Command{
+    Name:  "validate-backfill",
+    Usage: "Validates and optionally backfills the chainindex for a range of epochs",
+    Description: `
+lotus index validate-backfill --from <start_epoch> --to <end_epoch> [--backfill] [--log-good] [--quiet]
+
+The command validates the chain index entries for each epoch in the specified range, checking for missing or
+inconsistent entries (i.e. the indexed data does not match the actual chain state). If '--backfill' is enabled
+(which it is by default), it will attempt to backfill any missing entries using the 'ChainValidateIndex' API.
+
+Error conditions:
+  - If 'from' or 'to' are invalid (<=0 or 'to' > 'from'), an error is returned.
+  - If the 'ChainValidateIndex' API returns an error for an epoch, indicating an inconsistency between the index
+    and chain state, an error message is logged for that epoch.
+
+Logging:
+  - Progress is logged every 2880 epochs (1 day worth of epochs) processed during the validation process.
+  - If '--log-good' is enabled, details are also logged for each epoch that has no detected problems. This includes:
+    - Null rounds with no messages/events.
+    - Epochs with a valid indexed entry.
+  - If --quiet is enabled, only errors are logged, unless --log-good is also enabled, in which case good tipsets
+    are also logged.
+
+Example usage:
+
+To validate and backfill the chain index for the last 5760 epochs (2 days) and log details for all epochs:
+
+lotus index validate-backfill --from 1000000 --to 994240 --log-good
+
+This command is useful for backfilling the chain index over a range of historical epochs during the migration to
+the new ChainIndexer. It can also be run periodically to validate the index's integrity using system schedulers
+like cron.
+
+If there are any errors during the validation process, the command will exit with a non-zero status and log the
+number of failed RPC calls. Otherwise, it will exit with a zero status.
+    `,
+    Flags: []cli.Flag{
+        &cli.IntFlag{
+            Name:     "from",
+            Usage:    "from specifies the starting tipset epoch for validation (inclusive)",
+            Required: true,
+        },
+        &cli.IntFlag{
+            Name:     "to",
+            Usage:    "to specifies the ending tipset epoch for validation (inclusive)",
+            Required: true,
+        },
+        &cli.BoolFlag{
+            Name:  "backfill",
+            Usage: "backfill determines whether to backfill missing index entries during validation (default: true)",
+            Value: true,
+        },
+        &cli.BoolFlag{
+            Name:  "log-good",
+            Usage: "log tipsets that have no detected problems",
+            Value: false,
+        },
+        &cli.BoolFlag{
+            Name:  "quiet",
+            Usage: "suppress output except for errors (or good tipsets if log-good is enabled)",
+        },
+        &cli.StringFlag{
+            Name:  "output",
+            Usage: "output format (json or text)",
+            Value: "text",
+        },
+    },
+    Action: func(cctx *cli.Context) error {
+        srv, err := GetFullNodeServices(cctx)
+        if err != nil {
+            return xerrors.Errorf("failed to get full node services: %w", err)
+        }
+        defer func() {
+            if closeErr := srv.Close(); closeErr != nil {
+                log.Errorf("error closing services: %w", closeErr)
+            }
+        }()
+
+        api := srv.FullNodeAPI()
+        ctx := ReqContext(cctx)
+
+        fromEpoch := cctx.Int("from")
+        if fromEpoch <= 0 {
+            return xerrors.Errorf("invalid from epoch: %d, must be greater than 0", fromEpoch)
+        }
+
+        toEpoch := cctx.Int("to")
+        if toEpoch <= 0 {
+            return xerrors.Errorf("invalid to epoch: %d, must be greater than 0", toEpoch)
+        }
+        if toEpoch > fromEpoch {
+            return xerrors.Errorf("to epoch (%d) must be less than or equal to from epoch (%d)", toEpoch, fromEpoch)
+        }
+
+        head, err := api.ChainHead(ctx)
+        if err != nil {
+            return xerrors.Errorf("failed to get chain head: %w", err)
+        }
+        if head.Height() <= abi.ChainEpoch(fromEpoch) {
+            return xerrors.Errorf("from epoch (%d) must be less than chain head (%d)", fromEpoch, head.Height())
+        }
+
+        backfill := cctx.Bool("backfill")
+
+        // Results Tracking
+        logGood := cctx.Bool("log-good")
+
+        quiet := cctx.Bool("quiet")
+
+        failedRPCs := 0
+        successfulBackfills := 0
+        successfulValidations := 0
+        successfulNullRounds := 0
+
+        startTime := time.Now()
+        if !quiet {
+            _, _ = fmt.Fprintf(cctx.App.Writer, "%s starting chainindex validation; from epoch: %d; to epoch: %d; backfill: %t; log-good: %t\n", currentTimeString(),
+                fromEpoch, toEpoch, backfill, logGood)
+        }
+        totalEpochs := fromEpoch - toEpoch + 1
+        haltHeight := -1
+
+        for epoch := fromEpoch; epoch >= toEpoch; epoch-- {
+            if ctx.Err() != nil {
+                return ctx.Err()
+            }
+
+            if (fromEpoch-epoch+1)%2880 == 0 || epoch == toEpoch {
+                progress := float64(fromEpoch-epoch+1) / float64(totalEpochs) * 100
+                elapsed := time.Since(startTime)
+                if !quiet {
+                    _, _ = fmt.Fprintf(cctx.App.ErrWriter, "%s -------- Chain index validation progress: %.2f%%; Time elapsed: %s\n",
+                        currentTimeString(), progress, elapsed)
+                }
+            }
+
+            indexValidateResp, err := api.ChainValidateIndex(ctx, abi.ChainEpoch(epoch), backfill)
+            if err != nil {
+                if strings.Contains(err.Error(), "chain store does not contain data") {
+                    haltHeight = epoch
+                    break
+                }
+
+                _, _ = fmt.Fprintf(cctx.App.Writer, "%s ✗ Epoch %d; failure: %s\n", currentTimeString(), epoch, err)
+                failedRPCs++
+                continue
+            }
+
+            if indexValidateResp.Backfilled {
+                successfulBackfills++
+            } else if indexValidateResp.IsNullRound {
+                successfulNullRounds++
+            } else {
+                successfulValidations++
+            }
+
+            if !logGood {
+                continue
+            }
+
+            if indexValidateResp.IsNullRound {
+                _, _ = fmt.Fprintf(cctx.App.Writer, "%s ✓ Epoch %d; null round\n", currentTimeString(), epoch)
+            } else {
+                jsonData, err := json.Marshal(indexValidateResp)
+                if err != nil {
+                    return fmt.Errorf("failed to marshal results to JSON: %w", err)
+                }
+
+                _, _ = fmt.Fprintf(cctx.App.Writer, "%s ✓ Epoch %d (%s)\n", currentTimeString(), epoch, string(jsonData))
+            }
+        }
+
+        if !quiet {
+            _, _ = fmt.Fprintf(cctx.App.Writer, "\n%s Chain index validation summary:\n", currentTimeString())
+            _, _ = fmt.Fprintf(cctx.App.Writer, "Total failed RPC calls: %d\n", failedRPCs)
+            _, _ = fmt.Fprintf(cctx.App.Writer, "Total successful backfills: %d\n", successfulBackfills)
+            _, _ = fmt.Fprintf(cctx.App.Writer, "Total successful validations without backfilling: %d\n", successfulValidations)
+            _, _ = fmt.Fprintf(cctx.App.Writer, "Total successful Null round validations: %d\n", successfulNullRounds)
+        }
+
+        if haltHeight >= 0 {
+            return fmt.Errorf("chain index validation and backfilled halted at height %d as chain state does contain data for that height", haltHeight)
+        } else if failedRPCs > 0 {
+            return fmt.Errorf("chain index validation failed with %d RPC errors", failedRPCs)
+        }
+
+        // Standardise a top level output format for all lotus CLIs
+        data := map[string]interface{}{
+            "failedRPCs":              failedRPCs,
+            "successfulBackfills":     successfulBackfills,
+            "successfulValidations":   successfulValidations,
+            "successfulNullRounds":    successfulNullRounds,
+            "totalEpochs":             totalEpochs,
+            "validationStartTime":     startTime,
+            "validationEndTime":       time.Now(),
+            "validationElapsedTime":   time.Since(startTime),
+            "haltHeight":              haltHeight,
+            "fromEpoch":               fromEpoch,
+            "toEpoch":                 toEpoch,
+            "backfill":                backfill,
+            "logGood":                 logGood,
+            "quiet":                   quiet,
+        }
+        return util.FormatOutput(cctx, data)
+    },
 }
+
+func currentTimeString() string {
+    currentTime := time.Now().Format("2006-01-02 15:04:05.000")
+    return currentTime
+}
\ No newline at end of file
diff --git a/cli/miner/miner.go b/cli/miner/miner.go
index 162c153052b..9f8bfe36e86 100644
--- a/cli/miner/miner.go
+++ b/cli/miner/miner.go
@@ -1,144 +1,173 @@
 package miner
 
 import (
-	"context"
-	"fmt"
-
-	"github.com/fatih/color"
-	logging "github.com/ipfs/go-log/v2"
-	"github.com/urfave/cli/v2"
-	"golang.org/x/xerrors"
-
-	"github.com/filecoin-project/go-address"
-
-	"github.com/filecoin-project/lotus/api"
-	"github.com/filecoin-project/lotus/build"
-	lcli "github.com/filecoin-project/lotus/cli"
-	cliutil "github.com/filecoin-project/lotus/cli/util"
-	"github.com/filecoin-project/lotus/lib/lotuslog"
-	"github.com/filecoin-project/lotus/lib/tracing"
-	"github.com/filecoin-project/lotus/node/repo"
+    "context"
+    "fmt"
+
+    "github.com/fatih/color"
+    logging "github.com/ipfs/go-log/v2"
+    "github.com/urfave/cli/v2"
+    "golang.org/x/xerrors"
+
+    "github.com/filecoin-project/go-address"
+
+    "github.com/filecoin-project/lotus/api"
+    "github.com/filecoin-project/lotus/build"
+    lcli "github.com/filecoin-project/lotus/cli"
+    cliutil "github.com/filecoin-project/lotus/cli/util"
+    "github.com/filecoin-project/lotus/lib/lotuslog"
+    "github.com/filecoin-project/lotus/lib/tracing"
+    "github.com/filecoin-project/lotus/node/repo"
 )
 
 var log = logging.Logger("lotus-miner")
 
-func App() *cli.App {
-	api.RunningNodeType = api.NodeMiner
-
-	lotuslog.SetupLogLevels()
-
-	local := []*cli.Command{
-		initCmd,
-		runCmd,
-		stopCmd,
-		configCmd,
-		backupCmd,
-		lcli.WithCategory("chain", actorCmd),
-		lcli.WithCategory("chain", infoCmd),
-		lcli.WithCategory("storage", sectorsCmd),
-		lcli.WithCategory("storage", provingCmd),
-		lcli.WithCategory("storage", storageCmd),
-		lcli.WithCategory("storage", sealingCmd),
-	}
-
-	jaeger := tracing.SetupJaegerTracing("lotus")
-	defer func() {
-		if jaeger != nil {
-			_ = jaeger.ForceFlush(context.Background())
-		}
-	}()
-
-	for _, cmd := range local {
-		cmd := cmd
-		originBefore := cmd.Before
-		cmd.Before = func(cctx *cli.Context) error {
-			if jaeger != nil {
-				_ = jaeger.Shutdown(cctx.Context)
-			}
-			jaeger = tracing.SetupJaegerTracing("lotus/" + cmd.Name)
-
-			if cctx.IsSet("color") {
-				color.NoColor = !cctx.Bool("color")
-			}
-
-			if originBefore != nil {
-				return originBefore(cctx)
-			}
-
-			return nil
-		}
-	}
-
-	app := &cli.App{
-		Name:                 "lotus-miner",
-		Usage:                "Filecoin decentralized storage network miner",
-		Version:              string(build.MinerUserVersion()),
-		EnableBashCompletion: true,
-		Flags: []cli.Flag{
-			&cli.StringFlag{
-				Name:    "actor",
-				Value:   "",
-				Usage:   "specify other actor to query / manipulate",
-				Aliases: []string{"a"},
-			},
-			&cli.BoolFlag{
-				// examined in the Before above
-				Name:        "color",
-				Usage:       "use color in display output",
-				DefaultText: "depends on output being a TTY",
-			},
-			&cli.StringFlag{
-				Name:    "panic-reports",
-				EnvVars: []string{"LOTUS_PANIC_REPORT_PATH"},
-				Hidden:  true,
-				Value:   "~/.lotusminer", // should follow --repo default
-			},
-			&cli.StringFlag{
-				Name:    "repo",
-				EnvVars: []string{"LOTUS_PATH"},
-				Hidden:  true,
-				Value:   "~/.lotus", // TODO: Consider XDG_DATA_HOME
-			},
-			&cli.StringFlag{
-				Name:    FlagMinerRepo,
-				Aliases: []string{FlagMinerRepoDeprecation},
-				EnvVars: []string{"LOTUS_MINER_PATH", "LOTUS_STORAGE_PATH"},
-				Value:   "~/.lotusminer", // TODO: Consider XDG_DATA_HOME
-				Usage:   fmt.Sprintf("Specify miner repo path. flag(%s) and env(LOTUS_STORAGE_PATH) are DEPRECATION, will REMOVE SOON", FlagMinerRepoDeprecation),
-			},
-			&cli.StringFlag{
-				Name:  "output",
-				Usage: "output format (json or text)",
-				Value: "text",
-				Hidden: true,
-				Category: "Output",
-			},
-			cliutil.FlagVeryVerbose,
-			&cli.StringFlag{
-				Name:  "output",
-				Usage: "output format (json or text)",
-				Value: "text",
-			},
-		},
-		Commands: append(local, lcli.CommonCommands...),
-		After: func(c *cli.Context) error {
-			if r := recover(); r != nil {
-				// Generate report in LOTUS_PATH and re-raise panic
-				build.GenerateMinerPanicReport(c.String("panic-reports"), c.String(FlagMinerRepo), c.App.Name)
-				panic(r)
-			}
-			return nil
-		},
-	}
-
-	return app
-}
-
 const (
-	FlagMinerRepo = "miner-repo"
+    FlagMinerRepo = "miner-repo"
 )
 
 // TODO remove after deprecation period
-const FlagMinerRepoDeprecation = "stor
+const FlagMinerRepoDeprecation = "storagerepo"
+
+func App() *cli.App {
+    api.RunningNodeType = api.NodeMiner
+
+    lotuslog.SetupLogLevels()
+
+    local := []*cli.Command{
+        initCmd,
+        runCmd,
+        stopCmd,
+        configCmd,
+        backupCmd,
+        lcli.WithCategory("chain", actorCmd),
+        lcli.WithCategory("chain", infoCmd),
+        lcli.WithCategory("storage", sectorsCmd),
+        lcli.WithCategory("storage", provingCmd),
+        lcli.WithCategory("storage", storageCmd),
+        lcli.WithCategory("storage", sealingCmd),
+    }
+
+    jaeger := tracing.SetupJaegerTracing("lotus")
+    defer func() {
+        if jaeger != nil {
+            _ = jaeger.ForceFlush(context.Background())
+        }
+    }()
+
+    for _, cmd := range local {
+        cmd := cmd
+        originBefore := cmd.Before
+        cmd.Before = func(cctx *cli.Context) error {
+            if jaeger != nil {
+                _ = jaeger.Shutdown(cctx.Context)
+            }
+            jaeger = tracing.SetupJaegerTracing("lotus/" + cmd.Name)
+
+            if cctx.IsSet("color") {
+                color.NoColor = !cctx.Bool("color")
+            }
+
+            if originBefore != nil {
+                return originBefore(cctx)
+            }
+
+            return nil
+        }
+    }
+
+    app := &cli.App{
+        Name:                 "lotus-miner",
+        Usage:                "Filecoin decentralized storage network miner",
+        Version:              string(build.MinerUserVersion()),
+        EnableBashCompletion: true,
+        Flags: []cli.Flag{
+            &cli.StringFlag{
+                Name:    "actor",
+                Value:   "",
+                Usage:   "specify other actor to query / manipulate",
+                Aliases: []string{"a"},
+            },
+            &cli.BoolFlag{
+                // examined in the Before above
+                Name:        "color",
+                Usage:       "use color in display output",
+                DefaultText: "depends on output being a TTY",
+            },
+            &cli.StringFlag{
+                Name:    "panic-reports",
+                EnvVars: []string{"LOTUS_PANIC_REPORT_PATH"},
+                Hidden:  true,
+                Value:   "~/.lotusminer", // should follow --repo default
+            },
+            &cli.StringFlag{
+                Name:    "repo",
+                EnvVars: []string{"LOTUS_PATH"},
+                Hidden:  true,
+                Value:   "~/.lotus", // TODO: Consider XDG_DATA_HOME
+            },
+            &cli.StringFlag{
+                Name:    FlagMinerRepo,
+                Aliases: []string{FlagMinerRepoDeprecation},
+                EnvVars: []string{"LOTUS_MINER_PATH", "LOTUS_STORAGE_PATH"},
+                Value:   "~/.lotusminer", // TODO: Consider XDG_DATA_HOME
+                Usage:   fmt.Sprintf("Specify miner repo path. flag(%s) and env(LOTUS_STORAGE_PATH) are DEPRECATION, will REMOVE SOON", FlagMinerRepoDeprecation),
+            },
+            &cli.StringFlag{
+                Name:  "output",
+                Usage: "output format (json or text)",
+                Value: "text",
+            },
+            cliutil.FlagVeryVerbose,
+        },
+        Commands: append(local, lcli.CommonCommands...),
+        After: func(c *cli.Context) error {
+            if r := recover(); r != nil {
+                // Generate report in LOTUS_PATH and re-raise panic
+                build.GenerateMinerPanicReport(c.String("panic-reports"), c.String(FlagMinerRepo), c.App.Name)
+                panic(r)
+            }
+            return nil
+        },
+    }
+    app.Setup()
+    app.Metadata["repoType"] = repo.StorageMiner
+    return app
+}
+
+func getActorAddress(ctx context.Context, cctx *cli.Context) (maddr address.Address, err error) {
+    if cctx.IsSet("actor") {
+        maddr, err = address.NewFromString(cctx.String("actor"))
+        if err != nil {
+            return maddr, err
+        }
+        return
+    }
+
+    minerApi, closer, err := lcli.GetStorageMinerAPI(cctx)
+    if err != nil {
+        return address.Undef, err
+    }
+    defer closer()
+
+    maddr, err = minerApi.ActorAddress(ctx)
+    if err != nil {
+        return maddr, xerrors.Errorf("getting actor address: %w", err)
+    }
+
+    return maddr, nil
+}
+
+func LMActorOrEnvGetter(cctx *cli.Context) (address.Address, error) {
+    return getActorAddress(cctx.Context, cctx)
+}
+
+func LMActorGetter(cctx *cli.Context) (address.Address, error) {
+    minerApi, closer, err := lcli.GetStorageMinerAPI(cctx)
+    if err != nil {
+        return address.Undef, err
+    }
+    defer closer()
 
-// Standardise a top level output format for all lotus CLIs
\ No newline at end of file
+    return minerApi.ActorAddress(cctx.Context)
+}
\ No newline at end of file
diff --git a/cli/util/output.go b/cli/util/output.go
index c3a88441e0a..6956c629824 100644
--- a/cli/util/output.go
+++ b/cli/util/output.go
@@ -19,6 +19,6 @@ func FormatOutput(cctx *cli.Context, data interface{}) error {
         fmt.Println(data)
     default:
         return fmt.Errorf("unsupported output format: %s", format)
-    } // for the ouput function issue
+    }
     return nil
 }
\ No newline at end of file