Add filtering to get providers function

[DarkLord017]

Fixes #147

Provider filtering feature:

• Added a new ProviderFilterOptions interface in sp-registry/types.ts to specify filtering criteria such as type, location, piece size, IPNI support, service status, price, proving period, and randomization.
• Implemented the providerFiltering method in SPRegistryService to filter providers according to the given options and optionally randomize the output.
• Added a private _shuffle utility method to randomize provider lists when requested.
  )

[BigLep]

@DarkLord017 : Thank you for contributing. My guess is this PR won't get looked at for a bit because #147 isn't in our GA milestone. Just letting you know to set expectations.

[wjmelements]

I usually write this loop condition like for (let i = arr.length; i-- > 0;)

[wjmelements]

this can be static because it doesn't use this.

[wjmelements]

consider moving it to rand.ts

[DarkLord017]

Okay

[wjmelements]

is the order without randomize well-defined?

[DarkLord017]

They are sorted by ids see this in service provider registry contract

 for (uint256 i = 1; i <= numProviders && resultIndex < limit; i++) {
            if (providers[i].isActive) {
                if (currentIndex >= offset && currentIndex < offset + limit) {
                    providerIds[resultIndex++] = i;
                }
                currentIndex++;
            }
        }

and in synapse

      if (providerIds.length > 0) {
      const ids = providerIds.map((id: bigint) => Number(id))
      providerPromises.push(this.getProviders(ids))
    }

    offset += pageSize
  }

  // Wait for all provider details to be fetched and flatten the results
  const providerBatches = await Promise.all(providerPromises)
  return providerBatches.flat()