TrackerClient (Javadocs [I2P+ 2.13.0+]

java.lang.Object
- org.klomp.snark.TrackerClient

All Implemented Interfaces:
Runnable
```
public class TrackerClient
extends Object
implements Runnable
```
Handles communication with BitTorrent trackers and DHT to discover new peers.
This class manages tracker announcements and peer discovery by:
- Announcing torrent status to HTTP/HTTPS trackers
- Processing tracker responses and extracting peer information
- Managing UDP tracker communication
- Integrating with DHT for trackerless peer discovery
- Handling Peer Exchange (PEX) when available
- Managing announcement intervals and retry logic
- Processing various tracker events (started, completed, stopped)
Threading Model: The start() method creates a thread that runs one complete announcement cycle through all trackers, PEX, and DHT, then queues a new timed event and exits. This approach prevents thread accumulation while ensuring regular announcements.
The client can be restarted after halt() and handles various tracker responses including registration failures and error conditions.

Field Summary
Fields
Modifier and Type Field and Description
static int PORT
Default BitTorrent tracker port.

Fields
Modifier and Type	Field and Description
`static int`	`PORT` Default BitTorrent tracker port.

Constructor Summary
Constructors
Constructor and Description
TrackerClient(I2PSnarkUtil util, MetaInfo meta, String additionalTrackerURL, PeerCoordinator coordinator, Snark snark)
Call start() to start it.

Constructors
Constructor and Description
`TrackerClient(I2PSnarkUtil util, MetaInfo meta, String additionalTrackerURL, PeerCoordinator coordinator, Snark snark)` Call start() to start it.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`awaitUnannounces(long ms)` Wait, capped at ms, for the unannounces submitted by the last halt() to dispatch.
`void`	`halt(boolean fast)` Interrupts this Thread to stop it.
`boolean`	`halted()` Check if this tracker client has been halted.
`static boolean`	`isValidAnnounce(String ann)` Whether the announce URL is an I2P host.
`void`	`reinitialize()` Call after editing torrent
`void`	`run()` Run the tracker client thread.
`(package private) static String`	`scrapeURL(String announce)` Build the BEP 48 scrape URL from the announce URL: drop any query string and replace the last path segment with "scrape".
`void`	`start()` Start the tracker client thread.
`boolean`	`started()` Check if this tracker client has been started.
`(package private) static long`	`unannounceDispatchWait()` How long a stop should keep its sessions open for unannounces to dispatch: one wave per 32-tracker batch, so small swarms wait ~3s and bigger swarms scale up to UNANNOUNCE_MAX_WAIT.
`static String`	`urlencode(byte[] bs)` Very lazy byte[] to URL encoder.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - PORT
```
public static final int PORT
```
    Default BitTorrent tracker port.
    See Also:
    Constant Field Values
- Constructor Detail
  - TrackerClient
```
public TrackerClient(I2PSnarkUtil util,
                     MetaInfo meta,
                     String additionalTrackerURL,
                     PeerCoordinator coordinator,
                     Snark snark)
```
    Call start() to start it.
    Parameters:
    meta - null if in magnet mode
    additionalTrackerURL - may be null, from the ?tr= param in magnet mode, otherwise ignored
- Method Detail
  - awaitUnannounces
```
public void awaitUnannounces(long ms)
```
    Wait, capped at ms, for the unannounces submitted by the last halt() to dispatch. Returns immediately when nothing was submitted or they are done.
  - halt
```
public void halt(boolean fast)
```
    Interrupts this Thread to stop it.
    Parameters:
    fast - if true, limit the life of the unannounce threads
  - halted
```
public boolean halted()
```
    Check if this tracker client has been halted.
    Returns:
    true if halted
  - isValidAnnounce
```
public static boolean isValidAnnounce(String ann)
```
    Whether the announce URL is an I2P host.
    Parameters:
    ann - an announce URL, may be null, returns false if null
    Returns:
    true for i2p hosts only
  - reinitialize
```
public void reinitialize()
```
    Call after editing torrent
  - run
```
public void run()
```
    Run the tracker client thread.
    Specified by:
    run in interface Runnable
  - scrapeURL
```
static String scrapeURL(String announce)
```
    Build the BEP 48 scrape URL from the announce URL: drop any query string and replace the last path segment with "scrape". A trailing slash is stripped first, so the last non-empty segment is replaced.
    Parameters:
    announce - the announce URL
    Returns:
    the scrape URL
  - start
```
public void start()
```
    Start the tracker client thread.
  - started
```
public boolean started()
```
    Check if this tracker client has been started.
    Returns:
    true if started
  - unannounceDispatchWait
```
static long unannounceDispatchWait()
```
    How long a stop should keep its sessions open for unannounces to dispatch: one wave per 32-tracker batch, so small swarms wait ~3s and bigger swarms scale up to UNANNOUNCE_MAX_WAIT.
  - urlencode
```
public static String urlencode(byte[] bs)
```
    Very lazy byte[] to URL encoder. Just encodes almost everything, even some "normal" chars. By not encoding about 1/4 of the chars, we make random data like hashes about 16% smaller.
    RFC1738: 0-9a-zA-Z$-_.+!*'(), Us: 0-9a-zA-Z
    Parameters:
    bs - the bytes to encode
    Returns:
    the URL-encoded string

Class TrackerClient

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

PORT

Constructor Detail

TrackerClient

Method Detail

awaitUnannounces

halt

halted

isValidAnnounce

reinitialize

run

scrapeURL

start

started

unannounceDispatchWait

urlencode