Struct HttpTracker 

pub struct HttpTracker { /* private fields */ }

HTTP tracker client (BEP 3).

Implementations

impl HttpTracker

pub fn new() -> Self

Creates a new HTTP tracker client with default settings.

pub fn with_anonymous() -> Self

Create an HTTP tracker client for anonymous mode.

Uses an empty user-agent string to avoid identifying the client software.

pub fn with_proxy(proxy_url: Option<&str>) -> Self

Create an HTTP tracker client with an optional proxy.

When proxy_url is provided (e.g. "socks5://host:port"), all HTTP requests are routed through it.

pub fn with_security( proxy_url: Option<&str>, validate_tls: bool, ssrf_mitigation: bool, ) -> Self

Create an HTTP tracker client with URL security features.

When ssrf_mitigation is enabled, a custom redirect policy blocks redirects from global (public) URLs to private/loopback IP addresses. When validate_tls is false, TLS certificate validation is disabled.

pub fn build_announce_url( base_url: &str, req: &AnnounceRequest, ) -> Result<String>

Build the announce URL with query parameters.

Errors

This function is infallible but returns Result for API consistency.

pub async fn announce( &self, base_url: &str, req: &AnnounceRequest, ) -> Result<HttpAnnounceResponse>

Send an announce request to an HTTP tracker.

Errors

Returns an error if the HTTP request fails or the response is malformed.

impl HttpTracker

pub fn build_scrape_url( announce_url: &str, info_hashes: &[Id20], ) -> Result<String>

Build a scrape URL from an announce URL and a list of info_hashes.

Errors

Returns an error if the announce URL cannot be converted to a scrape URL.

pub async fn scrape( &self, announce_url: &str, info_hashes: &[Id20], ) -> Result<HttpScrapeResponse>

Send a scrape request to an HTTP tracker.

Errors

Returns an error if the HTTP request fails or the response is malformed.

Trait Implementations

impl Clone for HttpTracker

fn clone(&self) -> HttpTracker

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for HttpTracker

fn default() -> Self

Returns the “default value” for a type.