download_extrainfo_descriptors

stem_rs::descriptor::remote

Function download_extrainfo_descriptors 

Source 
pub async fn download_extrainfo_descriptors(
    fingerprints: Option<&[&str]>,
    endpoints: Option<&[DirPort]>,
    request_timeout: Option<Duration>,
) -> Result<DownloadResult, Error>
Expand description

Downloads extra-info descriptors.

Extra-info descriptors contain additional relay information not included in server descriptors, such as bandwidth statistics and transport details.

§Arguments

  • fingerprints - Optional list of relay fingerprints to fetch. If None, downloads all extra-info descriptors. Maximum 96 fingerprints per request.
  • endpoints - Optional list of endpoints to try.
  • request_timeout - Optional timeout for each download attempt.

§Returns

A DownloadResult containing the extra-info descriptors.

§Errors

Returns Error::InvalidRequest if more than 96 fingerprints are requested. Returns Error::Download if all endpoints fail.