… in slots V1 endpoint

Add support for filtering slots up to a maximum slot number (`max_slot`) in the slots V1 API.

This change introduces:
1. Adding `max_slot` to `APISlotsData` struct.
2. Documenting `max_slot` in the OpenAPI specification.
3. Parsing `max_slot` from query parameters and applying it as a filter (`blockFilter.MaxSlot`).
4. Calculating `NextSlot` when results are paginated beyond the limit, using the slot number of the first block on the next page (or the first block excluded from the current page if it exceeds the limit).

This provides a more robust cursor for pagination when dealing with slot numbers, especially when combined with `max_slot` filtering.

…ovided in filter

The `cacheStartSlot` was being initialized to `*filter.MaxSlot + 1`, which caused the query to potentially skip the block at `MaxSlot` when retrieving blocks from the cache.

By changing it to `*filter.MaxSlot`, the query now correctly includes the block corresponding to the maximum slot specified in the filter.

The maximum number of results allowed in a single API response for slots is increased from 100 to 1000. This change allows users to fetch more slots in a single request, reducing the need for excessive pagination when a larger dataset is expected.

…slots

Adds the `min_slot` query parameter to the `/api/v1/slots` endpoint. This allows consumers to specify the minimum slot number (inclusive) they wish to retrieve, improving filtering capabilities for slot data. Documentation is also updated to reflect this new parameter.

…to bbusa/orphaned-pages

This change introduces a step in the shared CI workflow that automatically checks if the generated API documentation files in the `docs/` directory are up-to-date.

It runs `make api-docs` and then uses `git status` to ensure no documentation files have been modified locally but not committed. If the docs are stale, the check fails and outputs the specific changes, forcing contributors to generate and commit updated documentation. This ensures documentation always reflects the current state of the API.