feat(cmd/network): Add nodes info to network show { <id> | entities }

Author: amela

cmd/network/show.go

@@ -10,7 +10,9 @@ import (
 
 	"github.com/spf13/cobra"
 
+	"github.com/oasisprotocol/oasis-core/go/beacon/api"
 	"github.com/oasisprotocol/oasis-core/go/common/crypto/signature"
+	"github.com/oasisprotocol/oasis-core/go/common/entity"
 	consensusPretty "github.com/oasisprotocol/oasis-core/go/common/prettyprint"
 	consensus "github.com/oasisprotocol/oasis-core/go/consensus/api"
 	"github.com/oasisprotocol/oasis-core/go/consensus/api/transaction"
@@ -40,6 +42,80 @@ const (
 	selParameters
 )
 
+func printEntityNodes(ctx context.Context, npa *common.NPASelection, stakingConn staking.Backend, registryConn registry.Backend, beaconConn api.Backend, entity *entity.Entity, height int64) error {
+	epoch, err := beaconConn.GetEpoch(ctx, height)
+	if err != nil {
+		return err
+	}
+
+	fmt.Printf("=== ENTITY ===\n")
+
+	entityAddr := staking.NewAddress(entity.ID)
+	fmt.Printf("Entity Address: %s\n", entityAddr.String())
+
+	fmt.Printf("Entity ID:      %s\n", entity.ID.String())
+
+	account, err := stakingConn.Account(
+		ctx,
+		&staking.OwnerQuery{Height: height, Owner: entityAddr},
+	)
+	if err != nil {
+		return err
+	}
+
+	balance := &account.Escrow.Active.Balance
+	commission := account.Escrow.CommissionSchedule.CurrentRate(epoch)
+
+	fmt.Printf("Stake:          %s %s\n", consensusPretty.QuantityFrac(*balance, uint8(9)), npa.Network.Denomination.Symbol)
+
+	var commissionString string
+	if commission != nil {
+		commissionString = staking.PrettyPrintCommissionRatePercentage(*commission)
+	} else {
+		commissionString = "not set"
+	}
+	fmt.Printf("Commission:     %s\n", commissionString)
+
+	fmt.Println()
+	fmt.Printf("=== NODES ===\n")
+	for i, node := range entity.Nodes {
+		fmt.Printf("Node ID: %s\n", node.String())
+		idQuery2 := &registry.IDQuery{
+			Height: height,
+			ID:     node,
+		}
+
+		nodeStatus, err := registryConn.GetNodeStatus(ctx, idQuery2)
+		if err != nil {
+			fmt.Println("  Node is not active")
+			continue
+		}
+
+		if node, err2 := registryConn.GetNode(ctx, idQuery2); err2 == nil {
+			fmt.Printf("  Node Roles: %s\n", node.Roles.String())
+			fmt.Printf("  Software Version: %s\n", node.SoftwareVersion)
+			if len(node.Runtimes) > 0 {
+				fmt.Printf("  Runtimes:\n")
+			}
+			for _, runtime := range node.Runtimes {
+				fmt.Printf("    Runtime ID: %s\n", runtime.ID)
+				fmt.Printf("      Runtime Version: %s\n", runtime.Version)
+			}
+			fmt.Printf("  Node Status:\n")
+			fmt.Printf("    Expiration Processed: %t\n", nodeStatus.ExpirationProcessed)
+			fmt.Printf("    Freeze End Time: %d\n", nodeStatus.FreezeEndTime)
+			fmt.Printf("    Election Eligible After: %d\n", nodeStatus.ElectionEligibleAfter)
+		} else {
+			return fmt.Errorf("could not get a node: %s", err2)
+		}
+
+		if i < len(entity.Nodes)-1 {
+			fmt.Println()
+		}
+	}
+	return nil
+}
+
 var showCmd = &cobra.Command{
 	Use:     "show { <id> | committees | entities | gas-costs | native-token | nodes | parameters | paratimes | validators }",
 	Short:   "Show network properties",
@@ -63,6 +139,7 @@ var showCmd = &cobra.Command{
 		roothashConn := conn.Consensus().RootHash()
 		schedulerConn := conn.Consensus().Scheduler()
 		stakingConn := conn.Consensus().Staking()
+		beaconConn := conn.Consensus().Beacon()
 
 		// Figure out the height to use if "latest".
 		height, err := common.GetActualHeight(
@@ -92,7 +169,7 @@ var showCmd = &cobra.Command{
 			}
 
 			if entity, err := registryConn.GetEntity(ctx, idQuery); err == nil {
-				err = prettyPrint(entity)
+				err = printEntityNodes(ctx, npa, stakingConn, registryConn, beaconConn, entity, height)
 				cobra.CheckErr(err)
 				return
 			}
@@ -125,7 +202,7 @@ var showCmd = &cobra.Command{
 			cobra.CheckErr(err) // If this doesn't work the other large queries won't either.
 			for _, entity := range entities {
 				if staking.NewAddress(entity.ID).Equal(addr) {
-					err = prettyPrint(entity)
+					err = printEntityNodes(ctx, npa, stakingConn, registryConn, beaconConn, entity, height)
 					cobra.CheckErr(err)
 					return
 				}

docs/network.md

@@ -410,9 +410,9 @@ The provided ID can be one of the following:
 - If the entity ID is provided, Oasis CLI shows information on the entity and
   its corresponding nodes in the network registry. For example:
 
-  ![code shell](../examples/network-show/id-entity.in)
+  ![code shell](../examples/network-show/id-entity.in.static)
 
-  ![code json](../examples/network-show/id-entity.out)
+  ![code json](../examples/network-show/id-entity.out.static)
 
 - If the node ID is provided, Oasis CLI shows detailed information of the node
   such as the Oasis Core software version, the node's role, supported

examples/network-show/id-entity.in.static

@@ -0,0 +1 @@
+oasis network show xQN6ffLSdc51EfEQ2BzltK1iWYAw6Y1CkBAbFzlhhEQ=

examples/network-show/id-entity.out

@@ -0,0 +1,14 @@
+=== ENTITY ===
+Entity Address: oasis1qzp84num6xgspdst65yv7yqegln6ndcxmuuq8s9w
+Entity ID:      xQN6ffLSdc51EfEQ2BzltK1iWYAw6Y1CkBAbFzlhhEQ=
+Stake:          11601040.379679788 ROSE
+Commission:     20.0%
+
+=== NODES ===
+Node ID: Kb6opWKGbJHL0LK2Lto+m5ROIAXLhIr1lxQz0/kAOUM=
+  Node Roles: validator
+  Software Version: 24.1
+  Node Status:
+    Expiration Processed: false
+    Freeze End Time: 0
+    Election Eligible After: 38659