/ 
Net-BitTorrent-v2.0.0-20260209033804-TRIAL
/ Net::BitTorrent::Tracker

NAME

Net::BitTorrent::Tracker - Multi-tier Tracker Manager

SYNOPSIS

use Net::BitTorrent::Tracker;

my $manager = Net::BitTorrent::Tracker->new(
    tiers_raw => [
        ['udp://tracker.openbittorrent.com:80/announce'],
        ['http://tracker.example.com/announce', 'https://another.net/announce']
    ]
);

# Announce presence and get peers
$manager->announce_all({
    infohash   => $bin_ih,
    peer_id    => $my_id,
    port       => 6881,
    downloaded => 0,
    uploaded   => 0,
    left       => 1024,
    event      => 'started'
}, sub ($peers) {
    say "Found " . scalar(@$peers) . " peers!";
});

DESCRIPTION

Net::BitTorrent::Tracker manages communication with external trackers. It implements the Multi-tracker Metadata (BEP 12) specification, handling tiers, retries, and backoff logic.

Protocol Support

The manager automatically detects and handles multiple tracker protocols:

  • UDP (BEP 15): Lightweight, preferred transport.

  • HTTP/HTTPS: Standard bencoded announce protocol.

METHODS

announce_all( \%params, [$callback] )

Announces to all tracker tiers.

Implements BEP 12 logic: iterates through trackers in a tier until one succeeds, then moves to the next tier. Automatically handles tracker-provided interval and min interval, and supports hybrid torrent announces by sending requests for both v1 and v2 infohashes.

scrape_all( \@infohashes, [$callback] )

Performs a scrape (BEP 48) across all trackers to gather swarm statistics (seeders, leechers, completed downloads) without registering as a peer.

trackers( )

Returns a flattened arrayref of all tracker URLs currently managed.

SEE ALSO

Net::BitTorrent::Tracker::HTTP, Net::BitTorrent::Tracker::UDP

AUTHOR

Sanko Robinson <sanko@cpan.org>

COPYRIGHT

Copyright (C) 2008-2026 by Sanko Robinson.

This library is free software; you can redistribute it and/or modify it under the terms of the Artistic License 2.0.