Nodes.dat file - Revision history

Reorder: /* Script for dumping nodes.dat */

2011-01-12T00:05:50Z

‎Script for dumping nodes.dat

Reorder: /* Script for dumping nodes.dat */ fixed script

2011-01-12T00:04:50Z

‎Script for dumping nodes.dat: fixed script

Reorder: /* Format (version 2) */

2011-01-11T23:36:39Z

‎Format (version 2)

Reorder: /* Example of nodes.dat version 0 file */ Clean up formatting; remove superfluous repetition

2011-01-11T22:34:34Z

‎Example of nodes.dat version 0 file: Clean up formatting; remove superfluous repetition

Reorder: Added Category

2011-01-11T17:38:45Z

Added Category

Marcell: Cleaned the wiki code and improved the python script to view the nodes.dat content.

2009-05-26T19:33:59Z

Cleaned the wiki code and improved the python script to view the nodes.dat content.

Iz0bbz: /* Format (version 2) */

2009-03-17T17:55:40Z

‎Format (version 2)

Iz0bbz: /* Format (version 2) */

2009-03-17T17:40:07Z

‎Format (version 2)

Iz0bbz: /* Format (version 2) */

2009-03-17T11:18:23Z

‎Format (version 2)

Iz0bbz: /* Example of nodes.dat version 1 file */

2009-03-17T11:17:05Z

‎Example of nodes.dat version 1 file

@@ Line 150: / Line 150: @@
              ipaddr = '%d.%d.%d.%d' % (ip1, ip2, ip3, ip4)
              print '%4d %4d %-15s %5d %5d' % (i, type, ipaddr,
-                                              udpport, tcpport)
+                                             udpport, tcpport)
          else :
              (clientid, ip1, ip2, ip3, ip4, udpport, tcpport, type,  kadUDPkey,

@@ Line 116: / Line 116: @@
 #!/usr/bin/env python
 # this code belongs to public domain
 import struct
@@ Line 128: / Line 129: @@
 nodefile = open(sys.argv[1], 'r')
 (count,) = struct.unpack("<I", nodefile.read(4))
-if (count == 0) : (version,) = struct.unpack("<I", nodefile.read(4))
+if (count == 0):
-if (version >= 1) : (count,) = struct.unpack("<I", nodefile.read(4))
+    (version,) = struct.unpack("<I", nodefile.read(4))
-if (version >= 0 & version < 3) :
+    (count,)   = struct.unpack("<I", nodefile.read(4))
      print 'Nodes.dat file version = %d' %(version)
      print 'Node count = %d' %(count)
@@ Line 142: / Line 146: @@
      for i in xrange(count):
          if (version == 0):
-             (clientid, ip1, ip2, ip3, ip4, udpport, tcpport, type) = \
+             (clientid, ip1, ip2, ip3, ip4, udpport, tcpport,
-             struct.unpack("<16s4BHHB", nodefile.read(25))
+             type) = struct.unpack("<16s4BHHB", nodefile.read(25))
-             ipaddr = '%d.%d.%d.%d' % (ip1, ip2, ip3, ip4)
+            ipaddr = '%d.%d.%d.%d' % (ip1, ip2, ip3, ip4)
-             print '%4d %4d %-15s %5d %5d' % (i, type, ipaddr, udpport,   tcpport)
+            print '%4d %4d %-15s %5d %5d' % (i, type, ipaddr,
          else :
-             (clientid, ip1, ip2, ip3, ip4, udpport, tcpport, type,  kadUDPkey, verified) = \
+             (clientid, ip1, ip2, ip3, ip4, udpport, tcpport, type,  kadUDPkey,
-             struct.unpack("<16s4BHHBQB", nodefile.read(34))
+             verified) = struct.unpack("<16s4BHHBQB", nodefile.read(34))
-             ipaddr = '%d.%d.%d.%d' % (ip1, ip2, ip3, ip4)
+            ipaddr = '%d.%d.%d.%d' % (ip1, ip2, ip3, ip4)
-             VV = 'Y'
+            if (verified == 0): verf='N'
-             if (verified == 0): VV='N'
+            else : verf='Y'
-                print '%4d %3d %-15s %5d %5d %16x %s' % (i, type, ipaddr, udpport, tcpport, kadUDPkey,VV)
+            print '%4d %3d %-15s %5d %5d %16x %s' % (i, type, ipaddr, udpport,
 else :

← Older revision		Revision as of 23:36, 11 January 2011
Line 70:		Line 70:

	Once this data is put together, it is stored in little-endian.		Once this data is put together, it is stored in little-endian.
		+
		+	=== Format v2 Details as a Table ===
		+
		+	{\| border="1" cellspacing="5"
		+	\|-
		+	! Bytes !! Value
		+	! align="left" \| Notes
		+	\|-
		+	\| colspan="3" \| Header information
		+	\|-
		+	\| 4 \|\| NULL \|\| Hex: <tt>0x00000000</tt>
		+	\|-
		+	\| 4 \|\| Version \|\| Hex: <tt>0x02000000</tt>
		+	\|-
		+	\| 4 \|\| Number of contacts \|\| Count of nodes in file
		+	\|-
		+	\| colspan="4" \| Each contact's information
		+	\|-
		+	\| 16 \|\| ClientID \|\| Contact's [[ID\|Client ID]]
		+	\|-
		+	\| 4 \|\| [[IP address]] \|\| Not enough bytes for IPv6 addresses
		+	\|-
		+	\| 2 \|\| UDP Port \|\| UDP port to connect to when trying to reach the contact
		+	\|-
		+	\| 2 \|\| TCP Port \|\| TCP port to connect to when trying to reach the contact
		+	\|-
		+	\| 1 \|\| Version \|\| Kademlia protocol version: 0' means a Kad v1 node, any value > 0 means a Kad v2 node and determines what kind of packets can be sent to a node, what features it supports, etc.
		+	\|-
		+	\| 8 \|\| KadUDPKey \|\| Sender's 32-bit key (node version >5), bound to the receiver (local) IP, which is used in encrypted communication to verify node validity (Kad v2)
		+	\|-
		+	\| 1 \|\| Verified \|\| Any value different from 0 indicates the contact has been verified
		+	\|}
		+
		+	* Total bytes for a given contact: <tt>16 + 4 + 2 + 2 + 1 + 8 + 1 = </tt>34 bytes
		+	* All fields are stored as little-endian hexidecimal values.

	== Extra ==		== Extra ==

@@ Line 29: / Line 29: @@
 === Example of nodes.dat version 0 file ===
-The following is a hex dump of an hypothetic ''nodes.dat'' file:
+The following is a hex dump of a hypothetical ''nodes.dat'' file:
-''0200000012257425DBA4EDDBD097150757404486E55E04DE40123612021F64632587A31EC2FC8566C4A9BAB184E6E9B7D44012361202''
+<tt>0200000012257425DBA4EDDBD097150757404486E55E04DE40123612021F64632587A31EC2FC8566C4A9BAB184E6E9B7D44012361202</tt>
 In the above example, the following data can be seen:
-*Number of contacts: ''2'' (In hex: ''02000000'', remember it's in [[little endian]])
+*Number of contacts: ''2'' (In hex: <tt>02000000</tt>, remember it's [[little endian]])
 *Contact #1:
-**ClientID: ''12257425DBA4EDDBD097150757404486''
+**ClientID: <tt>12257425DBA4EDDBD097150757404486</tt>
-**IP: ''222.4.94.229'' (In hex: ''E55E04DE'', remember it's in [[little endian]])
+**IP: 222.4.94.229 (Hex: <tt>E55E04DE</tt>)
-**[http://www.ietf.org/rfc/rfc768.txt UDP] Port: ''1240'' (In hex: ''4012'', remember it's in [[little endian]])
+**UDP Port: 1240 (Hex: <tt>4012</tt>)
-**[http://www.ietf.org/rfc/rfc793.txt TCP] Port: ''1236'' (In hex: ''3612'', remember it's in [[little endian]])
+**TCP Port: 1236 (Hex: <tt>3612</tt>)
-**Type: ''2'' (In hex: ''02'')
+**Type: 2 (Hex: <tt>02</tt>)
 *Contact #2:
-**ClientID: ''1F64632587A31EC2FC8566C4A9BAB184''
+**ClientID: <tt>1F64632587A31EC2FC8566C4A9BAB184</tt>
-**IP: ''212.183.233.230'' (In hex: ''E6E9B7D4'', remember it's in [[little endian]])
+**IP: 212.183.233.230 (Hex: <tt>E6E9B7D4</tt>)
-**[http://www.ietf.org/rfc/rfc768.txt UDP] Port: ''1240'' (In hex: ''4012'', remember it's in [[little endian]])
+**UDP Port: 1240 (Hex: <tt>4012</tt>)
-**[http://www.ietf.org/rfc/rfc793.txt TCP] Port: ''1236'' (In hex: ''3612'', remember it's in [[little endian]])
+**TCP Port: 1236 (Hex: <tt>3612</tt>)
-**Type: ''2'' (In hex: ''02'')
+**Type: 2 (Hex: <tt>02</tt>)
 == Format (version 2) ==

← Older revision		Revision as of 17:38, 11 January 2011
Line 124:		Line 124:
	nodefile.close()		nodefile.close()
	</pre>		</pre>
		+
		+	[[Category:Program Files]]

@@ Line 66: / Line 66: @@
 *''TCP Port'' (2 bytes): The [http://www.ietf.org/rfc/rfc793.txt TCP] [[port]] to [[connect]] to when trying to reach the contact
 *''Version'' (1 byte): Kademlia protocol version. '0' means a Kad v1 node, any value > 0 means a Kad v2 node and determines what kind of packets can be sent to a node, what features it supports, etc.
-*''KadUDPKey'' (8 bytes): Sender's 32-bit key used in encrypted communication to verify node validity.
+*''KadUDPKey'' (8 bytes): In Kad v2, Sender's 32-bit key (node version >5), bound to the receiver (local) IP . It is used in encrypted communication to verify node validity.
 *''Verified'': (1 byte) Any value different from 0 states the contact has been verified.

@@ Line 61: / Line 61: @@
 After specifying the number of contacts that will be listed, the file lists them.
 Each contact takes 34 bytes, splitted into the following fields:
-*''ClientID'': The contact's [[ID|ClientID]] (16 bytes)
+*''ClientID'' (16 bytes): The contact's [[ID|ClientID]]
-*''IP'': The contact's [[IP address|IP]] (4 bytes)
+*''IP'' (4 bytes): The contact's [[IP address|IP]]
-*''UDP Port'': The [http://www.ietf.org/rfc/rfc768.txt UDP] [[port]] to [[connect]] to when trying to reach the contact (2 bytes)
+*''UDP Port'' (2 bytes): The [http://www.ietf.org/rfc/rfc768.txt UDP] [[port]] to [[connect]] to when trying to reach the contact
-*''TCP Port'': The [http://www.ietf.org/rfc/rfc793.txt TCP] [[port]] to [[connect]] to when trying to reach the contact (2 bytes)
+*''TCP Port'' (2 bytes): The [http://www.ietf.org/rfc/rfc793.txt TCP] [[port]] to [[connect]] to when trying to reach the contact
-*''contactVersion'': This indicates the type of the contact
+*''Version'' (1 byte): Kademlia protocol version. '0' means a Kad v1 node, any value > 0 means a Kad v2 node and determines what kind of packets can be sent to a node, what features it supports, etc.
-*''KadUDPKey'': 8 bytes
+*''KadUDPKey'' (8 bytes): Sender's 32-bit key used in encrypted communication to verify node validity.
-*''Verified'': 1 byte, any value different from 0 states the contact has been verified.
+*''Verified'': (1 byte) Any value different from 0 states the contact has been verified.
 Once this data is put together, it is stored in little-endian.