torrent.md

Torrent Data

Torrent event data is generated by our listeners on the DHT, and consist in a series of events indicating which peers are downloading which torrents from which nodes.

Schema

{
   "origin":{
      "type":"string",
      "module":"string",
      "ts":"int"
   },
   "node":{
      "ip":"string",
      "port":"int"
   },
   "peer":{
      "ip":"string",
      "port":"int"
   },
   "torrent":{
      "infohash":"string",
      "name":"string",
      "source":"string",
      "category":"string"
   }
}

Contents of the fields:

• origin: Information about the event origin

  • type: Type of torrent event, can be "peer" or "node"
  • module: Static field, always "torrent", meant to distinguish from other events
  • ts: Timestamp of this event occurrence

• node: Information about the node serving the torrent

  • ip: Node IP address
  • port: Node port

• peer: Information about the peer downloading the torrent

  • ip: Peer IP address
  • port: Peer port

• torrent: Information about the torrent itself

  • infohash: Infohash of this torrent transaction
  • name: Human readable name of the torrent
  • source: Source of the torrent (tracker)
  • category: Category of the torrent content

Event Example

{
   "origin":{
      "type":"peer",
      "module":"torrent",
      "ts":1538666957296
   },
   "node":{
      "ip":"xxx.xxx.xxx.xxx",
      "port":24357
   },
   "peer":{
      "ip":"xxx.xxx.xxx.xxx",
      "port":16138
   },
   "torrent":{
      "infohash":"a7e642b455ba9a2984537526d948f1845f8e0dfc",
      "name":"The Ultimate Fighter S28E06 720p FOX WEB-DL AAC2 0 H 264-BOOP EZTV",
      "source":"EZTV",
      "category":"TV Show"
   }
}