Adding heimdall commands to polycli

README.md

@@ -65,6 +65,8 @@ Note: Do not modify this section! It is auto-generated by `cobra` using `make ge
 
 - [polycli hash](doc/polycli_hash.md) - Provide common crypto hashing functions.
 
+- [polycli heimdall](doc/polycli_heimdall.md) - Query and interact with a Heimdall v2 node.
+
 - [polycli loadtest](doc/polycli_loadtest.md) - Run a generic load test against an Eth/EVM style JSON-RPC endpoint.
 
 - [polycli metrics-to-dash](doc/polycli_metrics-to-dash.md) - Create a dashboard from an Openmetrics / Prometheus response.

cmd/heimdall/chain/age.go

@@ -0,0 +1,46 @@
+package chain
+
+import (
+	"fmt"
+
+	"github.com/spf13/cobra"
+
+	"github.com/0xPolygon/polygon-cli/internal/heimdall/render"
+)
+
+// newAgeCmd builds `age [HEIGHT]`. Prints the block timestamp via
+// the shared timestamp helper, matching `cast age`.
+func newAgeCmd() *cobra.Command {
+	return &cobra.Command{
+		Use:   "age [HEIGHT]",
+		Short: "Show the timestamp of a CometBFT block.",
+		Args:  cobra.MaximumNArgs(1),
+		RunE: func(cmd *cobra.Command, args []string) error {
+			rpc, _, err := newRPCClient(cmd)
+			if err != nil {
+				return err
+			}
+			heightArg := ""
+			if len(args) == 1 {
+				heightArg = args[0]
+			}
+			height, err := resolveHeight(cmd.Context(), rpc, heightArg)
+			if err != nil {
+				return err
+			}
+			blk, raw, err := fetchBlock(cmd.Context(), rpc, height)
+			if err != nil {
+				return err
+			}
+			if raw == nil {
+				return nil
+			}
+			unix, err := unixFromRFC3339Nano(blk.Block.Header.Time)
+			if err != nil {
+				return err
+			}
+			_, err = fmt.Fprintln(cmd.OutOrStdout(), render.AnnotateUnixSeconds(unix))
+			return err
+		},
+	}
+}

cmd/heimdall/chain/block.go

@@ -0,0 +1,83 @@
+package chain
+
+import (
+	"encoding/json"
+	"fmt"
+
+	"github.com/spf13/cobra"
+
+	"github.com/0xPolygon/polygon-cli/internal/heimdall/render"
+)
+
+// newBlockCmd builds the `block [HEIGHT]` command (alias `bl`). The
+// HEIGHT arg accepts an integer, `latest`, or `earliest`. Default
+// output is the summary keys chain_id/height/time/proposer/num_txs;
+// --full includes the tx list.
+func newBlockCmd() *cobra.Command {
+	var full bool
+	var fields []string
+	cmd := &cobra.Command{
+		Use:     "block [HEIGHT]",
+		Aliases: []string{"bl"},
+		Short:   "Show a CometBFT block by height (or latest).",
+		Args:    cobra.MaximumNArgs(1),
+		RunE: func(cmd *cobra.Command, args []string) error {
+			rpc, cfg, err := newRPCClient(cmd)
+			if err != nil {
+				return err
+			}
+			ctx := cmd.Context()
+
+			heightArg := ""
+			if len(args) == 1 {
+				heightArg = args[0]
+			}
+			height, err := resolveHeight(ctx, rpc, heightArg)
+			if err != nil {
+				return err
+			}
+			blk, raw, err := fetchBlock(ctx, rpc, height)
+			if err != nil {
+				return err
+			}
+			if raw == nil {
+				return nil // --curl
+			}
+
+			opts := renderOpts(cmd, cfg, fields)
+
+			// --json passes through the full result with render's
+			// byte-field normalization.
+			if opts.JSON {
+				var generic any
+				if err := json.Unmarshal(raw, &generic); err != nil {
+					return fmt.Errorf("decoding block for json: %w", err)
+				}
+				return render.RenderJSON(cmd.OutOrStdout(), generic, opts)
+			}
+
+			out := map[string]any{
+				"chain_id": blk.Block.Header.ChainID,
+				"height":   blk.Block.Header.Height,
+				"time":     blk.Block.Header.Time,
+				"proposer": "0x" + blk.Block.Header.ProposerAddress,
+				"num_txs":  len(blk.Block.Data.Txs),
+				"hash":     "0x" + blk.BlockID.Hash,
+			}
+			if full {
+				out["txs"] = blk.Block.Data.Txs
+			}
+			if err := render.RenderKV(cmd.OutOrStdout(), out, opts); err != nil {
+				return err
+			}
+			// Hint path: zero-proposer is the only generic trigger
+			// DetectHints can spot on a block summary.
+			hints := render.DetectHints(out)
+			return render.WriteHints(cmd.ErrOrStderr(), hints, opts)
+		},
+	}
+	f := cmd.Flags()
+	f.BoolVar(&full, "full", false, "include the full tx list in output")
+	f.StringArrayVarP(&fields, "field", "f", nil, "pluck one or more fields (repeatable)")
+	return cmd
+}

cmd/heimdall/chain/blocknumber.go

@@ -0,0 +1,37 @@
+package chain
+
+import (
+	"fmt"
+
+	"github.com/spf13/cobra"
+)
+
+// newBlockNumberCmd builds `block-number` (alias `bn`). Prints
+// /status.sync_info.latest_block_height as a bare integer, matching
+// `cast block-number`.
+func newBlockNumberCmd() *cobra.Command {
+	return &cobra.Command{
+		Use:     "block-number",
+		Aliases: []string{"bn"},
+		Short:   "Print the latest CometBFT block height.",
+		Args:    cobra.NoArgs,
+		RunE: func(cmd *cobra.Command, args []string) error {
+			rpc, _, err := newRPCClient(cmd)
+			if err != nil {
+				return err
+			}
+			st, err := fetchStatus(cmd.Context(), rpc)
+			if err != nil {
+				return err
+			}
+			if st == nil {
+				return nil // --curl
+			}
+			if st.SyncInfo.LatestBlockHeight == "" {
+				return fmt.Errorf("status did not contain latest_block_height")
+			}
+			_, err = fmt.Fprintln(cmd.OutOrStdout(), st.SyncInfo.LatestBlockHeight)
+			return err
+		},
+	}
+}