summaryrefslogtreecommitdiff
path: root/core/DHT.h
blob: 68d181e89533e2b323108f3c0a3e334fff3f736b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
/* DHT.h
* 
* An implementation of the DHT as seen in docs/DHT.txt
* 
 
    Copyright (C) 2013 Tox project All Rights Reserved.

    This file is part of Tox.

    Tox is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    Tox is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with Tox.  If not, see <http://www.gnu.org/licenses/>.
    
*/


#ifndef DHT_H 
#define DHT_H 

#include "net_crypto.h"

/* Current time, unix format */
#define unix_time() ((uint32_t)time(NULL))

/* size of the client_id in bytes */
#define CLIENT_ID_SIZE crypto_box_PUBLICKEYBYTES



/* Add a new friend to the friends list
   client_id must be CLIENT_ID_SIZE bytes long.
   returns 0 if success
   returns 1 if failure (friends list is full) */
int DHT_addfriend(uint8_t * client_id);

/* Delete a friend from the friends list
   client_id must be CLIENT_ID_SIZE bytes long.
   returns 0 if success
   returns 1 if failure (client_id not in friends list) */
int DHT_delfriend(uint8_t * client_id);


/* Get ip of friend
   client_id must be CLIENT_ID_SIZE bytes long.
   ip must be 4 bytes long.
   port must be 2 bytes long.
   returns ip if success
   returns ip of 0 if failure (This means the friend is either offline or we have not found him yet.)
   returns ip of 1 if friend is not in list. */
IP_Port DHT_getfriendip(uint8_t * client_id);


/* Run this function at least a couple times per second (It's the main loop) */
void doDHT();

/* if we receive a DHT packet we call this function so it can be handled.
   return 0 if packet is handled correctly.
   return 1 if it didn't handle the packet or if the packet was shit. */
int DHT_handlepacket(uint8_t * packet, uint32_t length, IP_Port source);

/* Use this function to bootstrap the client
   Sends a get nodes request to the given node with ip port and public_key */
void DHT_bootstrap(IP_Port ip_port, uint8_t * public_key);


/* SAVE/LOAD functions */

/* get the size of the DHT (for saving) */
uint32_t DHT_size();


/* save the DHT in data where data is an array of size DHT_size() */
void DHT_save(uint8_t * data);

/* load the DHT from data of size size;
   return -1 if failure
   return 0 if success */
int DHT_load(uint8_t * data, uint32_t size);

/* returns 0 if we are not connected to the DHT
   returns 1 if we are */
int DHT_isconnected();

#endif