i2pd/libi2pd/I2NPProtocol.h

290 lines
13 KiB
C
Raw Normal View History

2013-10-27 15:20:29 +00:00
#ifndef I2NP_PROTOCOL_H__
#define I2NP_PROTOCOL_H__
#include <inttypes.h>
2015-02-05 23:53:43 +00:00
#include <string.h>
2014-01-05 14:53:44 +00:00
#include <set>
2015-02-05 23:53:43 +00:00
#include <memory>
2016-05-11 19:12:38 +00:00
#include "Crypto.h"
2014-02-07 16:26:00 +00:00
#include "I2PEndian.h"
2014-12-30 17:25:08 +00:00
#include "Identity.h"
2013-10-27 15:20:29 +00:00
#include "RouterInfo.h"
2014-07-29 18:31:55 +00:00
#include "LeaseSet.h"
2013-10-27 15:20:29 +00:00
namespace i2p
2018-01-06 03:48:51 +00:00
{
2015-01-01 21:51:15 +00:00
// I2NP header
const size_t I2NP_HEADER_TYPEID_OFFSET = 0;
const size_t I2NP_HEADER_MSGID_OFFSET = I2NP_HEADER_TYPEID_OFFSET + 1;
const size_t I2NP_HEADER_EXPIRATION_OFFSET = I2NP_HEADER_MSGID_OFFSET + 4;
const size_t I2NP_HEADER_SIZE_OFFSET = I2NP_HEADER_EXPIRATION_OFFSET + 8;
const size_t I2NP_HEADER_CHKS_OFFSET = I2NP_HEADER_SIZE_OFFSET + 2;
2015-01-01 23:53:44 +00:00
const size_t I2NP_HEADER_SIZE = I2NP_HEADER_CHKS_OFFSET + 1;
2015-01-02 04:00:33 +00:00
// I2NP short header
const size_t I2NP_SHORT_HEADER_TYPEID_OFFSET = 0;
const size_t I2NP_SHORT_HEADER_EXPIRATION_OFFSET = I2NP_SHORT_HEADER_TYPEID_OFFSET + 1;
const size_t I2NP_SHORT_HEADER_SIZE = I2NP_SHORT_HEADER_EXPIRATION_OFFSET + 4;
2018-01-06 03:48:51 +00:00
2018-07-17 19:17:05 +00:00
// I2NP NTCP2 header
const size_t I2NP_NTCP2_HEADER_SIZE = I2NP_HEADER_EXPIRATION_OFFSET + 4;
2015-01-01 23:53:44 +00:00
// Tunnel Gateway header
const size_t TUNNEL_GATEWAY_HEADER_TUNNELID_OFFSET = 0;
const size_t TUNNEL_GATEWAY_HEADER_LENGTH_OFFSET = TUNNEL_GATEWAY_HEADER_TUNNELID_OFFSET + 4;
const size_t TUNNEL_GATEWAY_HEADER_SIZE = TUNNEL_GATEWAY_HEADER_LENGTH_OFFSET + 2;
2018-01-06 03:48:51 +00:00
// DeliveryStatus
const size_t DELIVERY_STATUS_MSGID_OFFSET = 0;
const size_t DELIVERY_STATUS_TIMESTAMP_OFFSET = DELIVERY_STATUS_MSGID_OFFSET + 4;
const size_t DELIVERY_STATUS_SIZE = DELIVERY_STATUS_TIMESTAMP_OFFSET + 8;
2015-01-03 02:11:40 +00:00
// DatabaseStore
const size_t DATABASE_STORE_KEY_OFFSET = 0;
const size_t DATABASE_STORE_TYPE_OFFSET = DATABASE_STORE_KEY_OFFSET + 32;
const size_t DATABASE_STORE_REPLY_TOKEN_OFFSET = DATABASE_STORE_TYPE_OFFSET + 1;
const size_t DATABASE_STORE_HEADER_SIZE = DATABASE_STORE_REPLY_TOKEN_OFFSET + 4;
2018-01-06 03:48:51 +00:00
// TunnelBuild
const size_t TUNNEL_BUILD_RECORD_SIZE = 528;
//BuildRequestRecordClearText
const size_t BUILD_REQUEST_RECORD_RECEIVE_TUNNEL_OFFSET = 0;
const size_t BUILD_REQUEST_RECORD_OUR_IDENT_OFFSET = BUILD_REQUEST_RECORD_RECEIVE_TUNNEL_OFFSET + 4;
const size_t BUILD_REQUEST_RECORD_NEXT_TUNNEL_OFFSET = BUILD_REQUEST_RECORD_OUR_IDENT_OFFSET + 32;
const size_t BUILD_REQUEST_RECORD_NEXT_IDENT_OFFSET = BUILD_REQUEST_RECORD_NEXT_TUNNEL_OFFSET + 4;
const size_t BUILD_REQUEST_RECORD_LAYER_KEY_OFFSET = BUILD_REQUEST_RECORD_NEXT_IDENT_OFFSET + 32;
const size_t BUILD_REQUEST_RECORD_IV_KEY_OFFSET = BUILD_REQUEST_RECORD_LAYER_KEY_OFFSET + 32;
const size_t BUILD_REQUEST_RECORD_REPLY_KEY_OFFSET = BUILD_REQUEST_RECORD_IV_KEY_OFFSET + 32;
const size_t BUILD_REQUEST_RECORD_REPLY_IV_OFFSET = BUILD_REQUEST_RECORD_REPLY_KEY_OFFSET + 32;
const size_t BUILD_REQUEST_RECORD_FLAG_OFFSET = BUILD_REQUEST_RECORD_REPLY_IV_OFFSET + 16;
const size_t BUILD_REQUEST_RECORD_REQUEST_TIME_OFFSET = BUILD_REQUEST_RECORD_FLAG_OFFSET + 1;
const size_t BUILD_REQUEST_RECORD_SEND_MSG_ID_OFFSET = BUILD_REQUEST_RECORD_REQUEST_TIME_OFFSET + 4;
const size_t BUILD_REQUEST_RECORD_PADDING_OFFSET = BUILD_REQUEST_RECORD_SEND_MSG_ID_OFFSET + 4;
const size_t BUILD_REQUEST_RECORD_CLEAR_TEXT_SIZE = 222;
2018-01-06 03:48:51 +00:00
// BuildRequestRecordEncrypted
const size_t BUILD_REQUEST_RECORD_TO_PEER_OFFSET = 0;
const size_t BUILD_REQUEST_RECORD_ENCRYPTED_OFFSET = BUILD_REQUEST_RECORD_TO_PEER_OFFSET + 16;
2018-01-06 03:48:51 +00:00
// BuildResponseRecord
const size_t BUILD_RESPONSE_RECORD_HASH_OFFSET = 0;
const size_t BUILD_RESPONSE_RECORD_PADDING_OFFSET = 32;
const size_t BUILD_RESPONSE_RECORD_PADDING_SIZE = 495;
const size_t BUILD_RESPONSE_RECORD_RET_OFFSET = BUILD_RESPONSE_RECORD_PADDING_OFFSET + BUILD_RESPONSE_RECORD_PADDING_SIZE;
2013-10-27 15:20:29 +00:00
enum I2NPMessageType
{
eI2NPDummyMsg = 0,
2013-10-27 15:20:29 +00:00
eI2NPDatabaseStore = 1,
eI2NPDatabaseLookup = 2,
eI2NPDatabaseSearchReply = 3,
eI2NPDeliveryStatus = 10,
eI2NPGarlic = 11,
eI2NPTunnelData = 18,
eI2NPTunnelGateway = 19,
eI2NPData = 20,
2014-04-30 18:08:57 +00:00
eI2NPTunnelBuild = 21,
eI2NPTunnelBuildReply = 22,
2013-10-27 15:20:29 +00:00
eI2NPVariableTunnelBuild = 23,
2018-01-06 03:48:51 +00:00
eI2NPVariableTunnelBuildReply = 24
};
2013-10-27 15:20:29 +00:00
2018-01-06 03:48:51 +00:00
const int NUM_TUNNEL_BUILD_RECORDS = 8;
2014-04-30 18:08:57 +00:00
2015-02-02 16:06:36 +00:00
// DatabaseLookup flags
const uint8_t DATABASE_LOOKUP_DELIVERY_FLAG = 0x01;
2018-01-06 03:48:51 +00:00
const uint8_t DATABASE_LOOKUP_ENCRYPTION_FLAG = 0x02;
2015-02-02 16:06:36 +00:00
const uint8_t DATABASE_LOOKUP_TYPE_FLAGS_MASK = 0x0C;
const uint8_t DATABASE_LOOKUP_TYPE_NORMAL_LOOKUP = 0;
const uint8_t DATABASE_LOOKUP_TYPE_LEASESET_LOOKUP = 0x04; // 0100
2018-01-06 03:48:51 +00:00
const uint8_t DATABASE_LOOKUP_TYPE_ROUTERINFO_LOOKUP = 0x08; // 1000
2015-02-02 16:06:36 +00:00
const uint8_t DATABASE_LOOKUP_TYPE_EXPLORATORY_LOOKUP = 0x0C; // 1100
namespace tunnel
2018-01-06 03:48:51 +00:00
{
class InboundTunnel;
2014-10-07 00:18:18 +00:00
class TunnelPool;
}
2018-10-10 15:31:55 +00:00
const size_t I2NP_MAX_MESSAGE_SIZE = 62708;
2018-01-06 03:48:51 +00:00
const size_t I2NP_MAX_SHORT_MESSAGE_SIZE = 4096;
2016-01-19 16:16:50 +00:00
const unsigned int I2NP_MESSAGE_EXPIRATION_TIMEOUT = 8000; // in milliseconds (as initial RTT)
2018-01-06 03:48:51 +00:00
const unsigned int I2NP_MESSAGE_CLOCK_SKEW = 60*1000; // 1 minute in milliseconds
2016-01-19 16:16:50 +00:00
2013-10-27 15:20:29 +00:00
struct I2NPMessage
2018-01-06 03:48:51 +00:00
{
uint8_t * buf;
2014-07-30 22:20:42 +00:00
size_t len, offset, maxLen;
2015-02-05 23:53:43 +00:00
std::shared_ptr<i2p::tunnel::InboundTunnel> from;
2018-01-06 03:48:51 +00:00
I2NPMessage (): buf (nullptr),len (I2NP_HEADER_SIZE + 2),
offset(2), maxLen (0), from (nullptr) {}; // reserve 2 bytes for NTCP header
2018-01-06 03:48:51 +00:00
2015-01-01 21:51:15 +00:00
// header accessors
uint8_t * GetHeader () { return GetBuffer (); };
const uint8_t * GetHeader () const { return GetBuffer (); };
void SetTypeID (uint8_t typeID) { GetHeader ()[I2NP_HEADER_TYPEID_OFFSET] = typeID; };
uint8_t GetTypeID () const { return GetHeader ()[I2NP_HEADER_TYPEID_OFFSET]; };
void SetMsgID (uint32_t msgID) { htobe32buf (GetHeader () + I2NP_HEADER_MSGID_OFFSET, msgID); };
uint32_t GetMsgID () const { return bufbe32toh (GetHeader () + I2NP_HEADER_MSGID_OFFSET); };
void SetExpiration (uint64_t expiration) { htobe64buf (GetHeader () + I2NP_HEADER_EXPIRATION_OFFSET, expiration); };
uint64_t GetExpiration () const { return bufbe64toh (GetHeader () + I2NP_HEADER_EXPIRATION_OFFSET); };
void SetSize (uint16_t size) { htobe16buf (GetHeader () + I2NP_HEADER_SIZE_OFFSET, size); };
uint16_t GetSize () const { return bufbe16toh (GetHeader () + I2NP_HEADER_SIZE_OFFSET); };
2018-01-06 03:48:51 +00:00
void UpdateSize () { SetSize (GetPayloadLength ()); };
void SetChks (uint8_t chks) { GetHeader ()[I2NP_HEADER_CHKS_OFFSET] = chks; };
2018-01-06 03:48:51 +00:00
void UpdateChks ()
2015-01-01 21:51:15 +00:00
{
uint8_t hash[32];
2015-11-03 14:15:49 +00:00
SHA256(GetPayload (), GetPayloadLength (), hash);
GetHeader ()[I2NP_HEADER_CHKS_OFFSET] = hash[0];
2018-01-06 03:48:51 +00:00
}
2015-01-01 21:51:15 +00:00
// payload
2015-01-02 04:00:33 +00:00
uint8_t * GetPayload () { return GetBuffer () + I2NP_HEADER_SIZE; };
const uint8_t * GetPayload () const { return GetBuffer () + I2NP_HEADER_SIZE; };
2013-10-27 15:20:29 +00:00
uint8_t * GetBuffer () { return buf + offset; };
2014-03-20 13:47:02 +00:00
const uint8_t * GetBuffer () const { return buf + offset; };
2018-01-06 03:48:51 +00:00
size_t GetLength () const { return len - offset; };
size_t GetPayloadLength () const { return GetLength () - I2NP_HEADER_SIZE; };
void Align (size_t alignment)
2014-11-26 16:04:49 +00:00
{
2015-03-11 16:17:38 +00:00
if (len + alignment > maxLen) return;
2014-11-26 16:04:49 +00:00
size_t rem = ((size_t)GetBuffer ()) % alignment;
if (rem)
2014-11-26 16:54:35 +00:00
{
2014-11-26 16:04:49 +00:00
offset += (alignment - rem);
2014-11-26 16:54:35 +00:00
len += (alignment - rem);
2018-01-06 03:48:51 +00:00
}
2014-11-26 16:04:49 +00:00
}
2013-11-10 23:23:26 +00:00
2016-01-05 19:29:18 +00:00
size_t Concat (const uint8_t * buf1, size_t len1)
{
// make sure with don't write beyond maxLen
if (len + len1 > maxLen) len1 = maxLen - len;
memcpy (buf + len, buf1, len1);
len += len1;
return len1;
}
2013-11-10 23:23:26 +00:00
I2NPMessage& operator=(const I2NPMessage& other)
{
memcpy (buf + offset, other.buf + other.offset, other.GetLength ());
len = offset + other.GetLength ();
from = other.from;
2013-11-10 23:23:26 +00:00
return *this;
2018-01-06 03:48:51 +00:00
}
2014-02-07 16:26:00 +00:00
// for SSU only
2018-01-06 03:48:51 +00:00
uint8_t * GetSSUHeader () { return buf + offset + I2NP_HEADER_SIZE - I2NP_SHORT_HEADER_SIZE; };
2014-02-07 16:26:00 +00:00
void FromSSU (uint32_t msgID) // we have received SSU message and convert it to regular
{
2015-01-02 04:00:33 +00:00
const uint8_t * ssu = GetSSUHeader ();
GetHeader ()[I2NP_HEADER_TYPEID_OFFSET] = ssu[I2NP_SHORT_HEADER_TYPEID_OFFSET]; // typeid
2015-01-02 04:00:33 +00:00
SetMsgID (msgID);
SetExpiration (bufbe32toh (ssu + I2NP_SHORT_HEADER_EXPIRATION_OFFSET)*1000LL);
SetSize (len - offset - I2NP_HEADER_SIZE);
SetChks (0);
2014-02-07 16:26:00 +00:00
}
2014-02-09 23:28:34 +00:00
uint32_t ToSSU () // return msgID
{
2015-01-02 04:00:33 +00:00
uint8_t header[I2NP_HEADER_SIZE];
memcpy (header, GetHeader (), I2NP_HEADER_SIZE);
2015-01-02 04:00:33 +00:00
uint8_t * ssu = GetSSUHeader ();
ssu[I2NP_SHORT_HEADER_TYPEID_OFFSET] = header[I2NP_HEADER_TYPEID_OFFSET]; // typeid
htobe32buf (ssu + I2NP_SHORT_HEADER_EXPIRATION_OFFSET, bufbe64toh (header + I2NP_HEADER_EXPIRATION_OFFSET)/1000LL);
len = offset + I2NP_SHORT_HEADER_SIZE + bufbe16toh (header + I2NP_HEADER_SIZE_OFFSET);
return bufbe32toh (header + I2NP_HEADER_MSGID_OFFSET);
2018-01-06 03:48:51 +00:00
}
2018-07-17 19:17:05 +00:00
// for NTCP2 only
uint8_t * GetNTCP2Header () { return GetPayload () - I2NP_NTCP2_HEADER_SIZE; };
2018-07-18 15:16:40 +00:00
size_t GetNTCP2Length () const { return GetPayloadLength () + I2NP_NTCP2_HEADER_SIZE; };
2018-07-17 19:17:05 +00:00
void FromNTCP2 ()
{
const uint8_t * ntcp2 = GetNTCP2Header ();
memcpy (GetHeader () + I2NP_HEADER_TYPEID_OFFSET, ntcp2 + I2NP_HEADER_TYPEID_OFFSET, 5); // typeid + msgid
SetExpiration (bufbe32toh (ntcp2 + I2NP_HEADER_EXPIRATION_OFFSET)*1000LL);
SetSize (len - offset - I2NP_HEADER_SIZE);
SetChks (0);
}
void ToNTCP2 ()
{
uint8_t * ntcp2 = GetNTCP2Header ();
htobe32buf (ntcp2 + I2NP_HEADER_EXPIRATION_OFFSET, bufbe64toh (GetHeader () + I2NP_HEADER_EXPIRATION_OFFSET)/1000LL);
memcpy (ntcp2 + I2NP_HEADER_TYPEID_OFFSET, GetHeader () + I2NP_HEADER_TYPEID_OFFSET, 5); // typeid + msgid
}
void FillI2NPMessageHeader (I2NPMessageType msgType, uint32_t replyMsgID = 0);
void RenewI2NPMessageHeader ();
2016-01-19 02:13:43 +00:00
bool IsExpired () const;
2018-01-06 03:48:51 +00:00
};
2014-07-30 20:52:35 +00:00
template<int sz>
struct I2NPMessageBuffer: public I2NPMessage
{
2014-07-30 22:20:42 +00:00
I2NPMessageBuffer () { buf = m_Buffer; maxLen = sz; };
2016-01-01 22:39:12 +00:00
uint8_t m_Buffer[sz + 32]; // 16 alignment + 16 padding
2014-07-30 20:52:35 +00:00
};
2015-11-24 18:09:12 +00:00
std::shared_ptr<I2NPMessage> NewI2NPMessage ();
std::shared_ptr<I2NPMessage> NewI2NPShortMessage ();
2017-04-14 14:19:26 +00:00
std::shared_ptr<I2NPMessage> NewI2NPTunnelMessage ();
2015-11-24 18:09:12 +00:00
std::shared_ptr<I2NPMessage> NewI2NPMessage (size_t len);
2018-01-06 03:48:51 +00:00
std::shared_ptr<I2NPMessage> CreateI2NPMessage (I2NPMessageType msgType, const uint8_t * buf, size_t len, uint32_t replyMsgID = 0);
2016-01-05 19:29:18 +00:00
std::shared_ptr<I2NPMessage> CreateI2NPMessage (const uint8_t * buf, size_t len, std::shared_ptr<i2p::tunnel::InboundTunnel> from = nullptr);
2016-01-31 23:27:47 +00:00
std::shared_ptr<I2NPMessage> CopyI2NPMessage (std::shared_ptr<I2NPMessage> msg);
2015-06-24 14:45:58 +00:00
std::shared_ptr<I2NPMessage> CreateDeliveryStatusMsg (uint32_t msgID);
2018-01-06 03:48:51 +00:00
std::shared_ptr<I2NPMessage> CreateRouterInfoDatabaseLookupMsg (const uint8_t * key, const uint8_t * from,
2015-01-04 22:25:16 +00:00
uint32_t replyTunnelID, bool exploratory = false, std::set<i2p::data::IdentHash> * excludedPeers = nullptr);
2018-01-06 03:48:51 +00:00
std::shared_ptr<I2NPMessage> CreateLeaseSetDatabaseLookupMsg (const i2p::data::IdentHash& dest,
2014-12-30 17:25:08 +00:00
const std::set<i2p::data::IdentHash>& excludedFloodfills,
2016-02-26 21:17:29 +00:00
std::shared_ptr<const i2p::tunnel::InboundTunnel> replyTunnel, const uint8_t * replyKey, const uint8_t * replyTag);
2015-11-03 14:15:49 +00:00
std::shared_ptr<I2NPMessage> CreateDatabaseSearchReply (const i2p::data::IdentHash& ident, std::vector<i2p::data::IdentHash> routers);
2018-01-06 03:48:51 +00:00
2015-11-03 14:15:49 +00:00
std::shared_ptr<I2NPMessage> CreateDatabaseStoreMsg (std::shared_ptr<const i2p::data::RouterInfo> router = nullptr, uint32_t replyToken = 0);
std::shared_ptr<I2NPMessage> CreateDatabaseStoreMsg (const i2p::data::IdentHash& storeHash, std::shared_ptr<const i2p::data::LeaseSet> leaseSet); // for floodfill only
2018-01-06 03:48:51 +00:00
std::shared_ptr<I2NPMessage> CreateDatabaseStoreMsg (std::shared_ptr<const i2p::data::LocalLeaseSet> leaseSet, uint32_t replyToken = 0, std::shared_ptr<const i2p::tunnel::InboundTunnel> replyTunnel = nullptr);
bool IsRouterInfoMsg (std::shared_ptr<I2NPMessage> msg);
2015-01-04 14:33:19 +00:00
bool HandleBuildRequestRecords (int num, uint8_t * records, uint8_t * clearText);
2013-10-27 15:20:29 +00:00
void HandleVariableTunnelBuildMsg (uint32_t replyMsgID, uint8_t * buf, size_t len);
void HandleVariableTunnelBuildReplyMsg (uint32_t replyMsgID, uint8_t * buf, size_t len);
2018-01-06 03:48:51 +00:00
void HandleTunnelBuildMsg (uint8_t * buf, size_t len);
2014-04-30 18:08:57 +00:00
2018-01-06 03:48:51 +00:00
std::shared_ptr<I2NPMessage> CreateTunnelDataMsg (const uint8_t * buf);
std::shared_ptr<I2NPMessage> CreateTunnelDataMsg (uint32_t tunnelID, const uint8_t * payload);
std::shared_ptr<I2NPMessage> CreateEmptyTunnelDataMsg ();
2018-01-06 03:48:51 +00:00
2015-11-24 18:09:12 +00:00
std::shared_ptr<I2NPMessage> CreateTunnelGatewayMsg (uint32_t tunnelID, const uint8_t * buf, size_t len);
2018-01-06 03:48:51 +00:00
std::shared_ptr<I2NPMessage> CreateTunnelGatewayMsg (uint32_t tunnelID, I2NPMessageType msgType,
2013-11-10 23:23:26 +00:00
const uint8_t * buf, size_t len, uint32_t replyMsgID = 0);
std::shared_ptr<I2NPMessage> CreateTunnelGatewayMsg (uint32_t tunnelID, std::shared_ptr<I2NPMessage> msg);
2013-12-14 01:07:35 +00:00
2017-12-01 17:57:05 +00:00
size_t GetI2NPMessageLength (const uint8_t * msg, size_t len);
void HandleI2NPMessage (uint8_t * msg, size_t len);
void HandleI2NPMessage (std::shared_ptr<I2NPMessage> msg);
2015-01-23 03:00:41 +00:00
class I2NPMessagesHandler
{
public:
~I2NPMessagesHandler ();
void PutNextMessage (std::shared_ptr<I2NPMessage> msg);
2015-01-23 03:00:41 +00:00
void Flush ();
2018-01-06 03:48:51 +00:00
2015-01-23 03:00:41 +00:00
private:
std::vector<std::shared_ptr<I2NPMessage> > m_TunnelMsgs, m_TunnelGatewayMsgs;
2015-01-23 03:00:41 +00:00
};
2016-04-20 18:53:50 +00:00
const uint16_t DEFAULT_MAX_NUM_TRANSIT_TUNNELS = 2500;
void SetMaxNumTransitTunnels (uint16_t maxNumTransitTunnels);
2018-01-06 03:48:51 +00:00
}
2013-10-27 15:20:29 +00:00
#endif