cmdutil

type GRPCErrorBody struct {
	Code    int    `json:"code"`
	Message string `json:"message"`
}

type Get struct {
	Use     string
	Short   string
	Aliases []string
	// Args defaults to cobra.NoArgs.
	Args cobra.PositionalArgs
	// Label names the response in decode/gRPC errors, e.g. "milestone params".
	Label string
	// Path is the fixed REST path. Mutually exclusive with Build.
	Path string
	// Build computes the path and query from the CLI args.
	Build func(cmd *cobra.Command, args []string) (string, url.Values, error)
	// L1Hint surfaces render.HintL1NotConfigured when the call fails
	// with gRPC code 13 / a transport-level dial error, and checks the
	// 2xx body for a gRPC error envelope before rendering.
	L1Hint bool
	// FieldsUsage overrides the --field usage string.
	FieldsUsage string
	// Flags registers extra command flags.
	Flags func(fs *pflag.FlagSet)
	// Opts post-processes the render options (e.g. a --base64 sugar flag).
	Opts func(cmd *cobra.Command, opts *render.Options)
	// Render renders the decoded map when --json is NOT set. nil falls
	// back to RenderKV, after unwrapping UnwrapKey if present.
	Render func(cmd *cobra.Command, m map[string]any, opts render.Options) error
	// RenderBody takes over non-JSON rendering before map decoding
	// (e.g. printing one bare field from a typed struct).
	RenderBody func(cmd *cobra.Command, body []byte, opts render.Options) error
	// UnwrapKey names a single-key envelope to unwrap for KV output.
	UnwrapKey string
}

type Pkg struct {
	// Name is the package label used in "not registered" errors.
	Name string
	// Flags is injected by the package's Register call.
	Flags *config.Flags
}

type RPC struct {
	Use     string
	Short   string
	Aliases []string
	// Args defaults to cobra.NoArgs.
	Args cobra.PositionalArgs
	// Method is the CometBFT RPC method, e.g. "abci_info".
	Method string
	// FieldsUsage overrides the --field usage string.
	FieldsUsage string
	// Flags registers extra command flags.
	Flags func(fs *pflag.FlagSet)
	// Render renders the raw RPC result when --json is NOT set.
	Render func(cmd *cobra.Command, raw json.RawMessage, opts render.Options) error
}