/ 
Net-BitTorrent-v2.0.0
River stage zero No dependents
⭐ Starred 13 GitHub stars
/ Net::BitTorrent::Tracker::UDP

NAME

Net::BitTorrent::Tracker::UDP - UDP BitTorrent Tracker Protocol (BEP 15)

SYNOPSIS

use Net::BitTorrent::Tracker::UDP;

my $tracker = Net::BitTorrent::Tracker::UDP->new(
    url => 'udp://tracker.openbittorrent.com:80/announce'
);

# Announce
$tracker->perform_announce({
    infohash   => $bin_ih,
    peer_id    => $my_id,
    port       => 6881,
    downloaded => 0,
    uploaded   => 0,
    left       => 1024
}, sub ($res) {
    say 'Peers: ' . join(', ', map { $_->{ip} } @{$res->{peers}});
});

DESCRIPTION

Net::BitTorrent::Tracker::UDP implements the lightweight UDP Tracker Protocol (BEP 15). UDP is the preferred transport for BitTorrent trackers as it significantly reduces overhead on the tracker server compared to HTTP.

BitTorrent v2 Support

This module is BEP 52 compliant. It handles 32-byte SHA-256 infohashes by dynamically adjusting the binary structure of outgoing messages or by providing truncated/hashed 20-byte identifiers where necessary for legacy compatibility.

METHODS

perform_announce( \%params, [$callback] )

Sends an announce request to the UDP tracker.

$tracker->perform_announce( \%params, sub ($res) { ... } );

This method handles connection ID acquisition and retransmissions automatically.

Expected parameters:

\%params

Standard announce parameters (infohash, peer_id, port, uploaded, downloaded, left, event).

$callback - optional

Called with the parsed response hash containing interval, leechers, seeders, and peers.

perform_scrape( \@infohashes, [$callback] )

Sends a scrape request to the UDP tracker.

$tracker->perform_scrape( \@ihs, sub ($res) { ... } );

Expected parameters:

\@infohashes

List of binary infohashes to scrape.

$callback - optional

Called with the scrape results.

tick( )

Performs periodic maintenance.

$tracker->tick( 0.1 );

This method handles incoming packets and retransmissions for pending requests.

receive_data( $data )

Processes an incoming UDP packet.

$tracker->receive_data( $raw_packet );

Expected parameters:

$data

The raw packet payload.

url( )

Returns the tracker URL.

Specifications

  • BEP 15: UDP Tracker Protocol

  • BEP 52: The BitTorrent Protocol v2 (UDP extensions)

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.