feat(gnoclient): support fetching blocks, block results, latest block number

gno.land/pkg/gnoclient/client_queries.go

@@ -139,7 +139,7 @@
 
 	block, err := c.RPCClient.Block(&height)
 	if err != nil {
 		return nil, fmt.Errorf("block query failed: %w", err)
 	}
 
 	return block, nil
@@ -158,21 +158,21 @@
 
 	blockResults, err := c.RPCClient.BlockResults(&height)
 	if err != nil {
 		return nil, fmt.Errorf("block query failed: %w", err)
 	}
 
 	return blockResults, nil
 }
 
-// BlockNumber gets the latest block height on the chain
-func (c *Client) BlockNumber() (int64, error) {
+// Head gets the head of the chain (latest block height)
+func (c *Client) Head() (int64, error) {
 	if err := c.validateRPCClient(); err != nil {
 		return 0, ErrMissingRPCClient
 	}
 
 	status, err := c.RPCClient.Status()
 	if err != nil {
 		return 0, fmt.Errorf("block number query failed: %w", err)
 	}
 
 	return status.SyncInfo.LatestBlockHeight, nil

gno.land/pkg/gnoclient/client_test.go

@@ -1132,6 +1132,29 @@ func TestBlockResults(t *testing.T) {
 	assert.Equal(t, height, blockResult.Height)
 }
 
+func TestHead(t *testing.T) {
+	t.Parallel()
+
+	latestHeight := int64(5)
+
+	client := &Client{
+		Signer: &mockSigner{},
+		RPCClient: &mockRPCClient{
+			status: func() (*ctypes.ResultStatus, error) {
+				return &ctypes.ResultStatus{
+					SyncInfo: ctypes.SyncInfo{
+						LatestBlockHeight: latestHeight,
+					},
+				}, nil
+			},
+		},
+	}
+
+	head, err := client.Head()
+	require.NoError(t, err)
+	assert.Equal(t, latestHeight, head)
+}
+
 func TestBlockErrors(t *testing.T) {
 	t.Parallel()
 
@@ -1214,7 +1237,7 @@ func TestBlockResultErrors(t *testing.T) {
 	}
 }
 
-func TestBlockNumberErrors(t *testing.T) {
+func TestHeadErrors(t *testing.T) {
 	t.Parallel()
 
 	testCases := []struct {
@@ -1237,7 +1260,7 @@ func TestBlockNumberErrors(t *testing.T) {
 		t.Run(tc.name, func(t *testing.T) {
 			t.Parallel()
 
-			res, err := tc.client.BlockNumber()
+			res, err := tc.client.Head()
 			assert.Equal(t, int64(0), res)
 			assert.ErrorIs(t, err, tc.expectedError)
 		})