Reticulum/RNS/Packet.py

285 lines
7.8 KiB
Python
Raw Normal View History

2016-06-03 19:02:02 +02:00
import struct
2018-03-20 12:32:41 +01:00
import time
import RNS
2016-06-03 19:02:02 +02:00
class Packet:
2018-03-19 16:39:08 +01:00
# Constants
2018-04-18 23:31:17 +02:00
DATA = 0x00
ANNOUNCE = 0x01
LINKREQUEST = 0x02
PROOF = 0x03
2018-04-16 22:09:23 +02:00
types = [DATA, ANNOUNCE, LINKREQUEST, PROOF]
2016-06-03 19:02:02 +02:00
2018-04-18 23:31:17 +02:00
HEADER_1 = 0x00 # Normal header format
HEADER_2 = 0x01 # Header format used for link packets in transport
HEADER_3 = 0x02 # Reserved
HEADER_4 = 0x03 # Reserved
2018-03-19 16:39:08 +01:00
header_types = [HEADER_1, HEADER_2, HEADER_3, HEADER_4]
2016-06-03 19:02:02 +02:00
2018-04-18 23:31:17 +02:00
# Context types
NONE = 0x00
RESOURCE = 0x01
RESOURCE_ADV = 0x02
RESOURCE_REQ = 0x03
RESOURCE_HMU = 0x04
RESOURCE_PRF = 0x05
RESOURCE_ICL = 0x06
RESOURCE_RCL = 0x07
REQUEST = 0x08
RESPONSE = 0x09
COMMAND = 0x0A
COMMAND_STAT = 0x0B
LRPROOF = 0xFF
HEADER_MAXSIZE = 23
2018-04-17 17:46:48 +02:00
# Defaults
2018-04-18 23:31:17 +02:00
TIMEOUT = 60
2018-04-17 17:46:48 +02:00
2018-04-18 23:31:17 +02:00
def __init__(self, destination, data, packet_type = DATA, context = NONE, transport_type = RNS.Transport.BROADCAST, header_type = HEADER_1, transport_id = None):
2018-03-19 16:39:08 +01:00
if destination != None:
if transport_type == None:
transport_type = RNS.Transport.BROADCAST
2016-06-03 19:02:02 +02:00
2018-03-19 16:39:08 +01:00
self.header_type = header_type
self.packet_type = packet_type
self.transport_type = transport_type
2018-04-18 23:31:17 +02:00
self.context = context
2016-06-03 19:02:02 +02:00
2018-03-19 16:39:08 +01:00
self.hops = 0;
self.destination = destination
self.transport_id = transport_id
self.data = data
self.flags = self.getPackedFlags()
2018-04-16 17:13:39 +02:00
self.MTU = RNS.Reticulum.MTU
2018-03-19 16:39:08 +01:00
self.raw = None
self.packed = False
self.sent = False
2018-04-17 17:46:48 +02:00
self.receipt = None
2018-03-20 12:32:41 +01:00
self.fromPacked = False
2018-03-19 16:39:08 +01:00
else:
2018-03-20 12:32:41 +01:00
self.raw = data
self.packed = True
self.fromPacked = True
self.sent_at = None
self.packet_hash = None
2018-03-19 16:39:08 +01:00
def getPackedFlags(self):
2018-04-18 23:31:17 +02:00
if self.context == Packet.LRPROOF:
2018-04-16 17:13:39 +02:00
packed_flags = (self.header_type << 6) | (self.transport_type << 4) | RNS.Destination.LINK | self.packet_type
else:
packed_flags = (self.header_type << 6) | (self.transport_type << 4) | (self.destination.type << 2) | self.packet_type
2018-03-19 16:39:08 +01:00
return packed_flags
def pack(self):
self.header = ""
self.header += struct.pack("!B", self.flags)
self.header += struct.pack("!B", self.hops)
2018-04-17 17:46:48 +02:00
2018-04-18 23:31:17 +02:00
if self.context == Packet.LRPROOF:
2018-04-16 17:13:39 +02:00
self.header += self.destination.link_id
2018-03-19 18:11:50 +01:00
self.ciphertext = self.data
2018-04-18 23:31:17 +02:00
else:
if self.header_type == Packet.HEADER_1:
self.header += self.destination.hash
if self.packet_type == Packet.ANNOUNCE:
# Announce packets are not encrypted
self.ciphertext = self.data
elif self.packet_type == Packet.PROOF and self.context == Packet.RESOURCE_PRF:
# Resource proofs are not encrypted
self.ciphertext = self.data
elif self.context == Packet.RESOURCE:
# A resource takes care of symmetric
# encryption by itself
self.ciphertext = self.data
else:
# In all other cases, we encrypt the packet
# with the destination's public key
self.ciphertext = self.destination.encrypt(self.data)
if self.header_type == Packet.HEADER_2:
if t_destination != None:
self.header += self.t_destination
else:
raise IOError("Packet with header type 2 must have a transport ID")
self.header += chr(self.context)
2018-03-19 18:11:50 +01:00
2018-03-19 16:39:08 +01:00
self.raw = self.header + self.ciphertext
if len(self.raw) > self.MTU:
raise IOError("Packet size of "+str(len(self.raw))+" exceeds MTU of "+str(self.MTU)+" bytes")
self.packed = True
def unpack(self):
self.flags = ord(self.raw[0])
self.hops = ord(self.raw[1])
self.header_type = (self.flags & 0b11000000) >> 6
self.transport_type = (self.flags & 0b00110000) >> 4
self.destination_type = (self.flags & 0b00001100) >> 2
self.packet_type = (self.flags & 0b00000011)
if self.header_type == Packet.HEADER_2:
self.transport_id = self.raw[2:12]
self.destination_hash = self.raw[12:22]
2018-04-18 23:31:17 +02:00
self.context = ord(self.raw[22:23])
self.data = self.raw[23:]
2018-03-19 16:39:08 +01:00
else:
self.transport_id = None
self.destination_hash = self.raw[2:12]
2018-04-18 23:31:17 +02:00
self.context = ord(self.raw[12:13])
self.data = self.raw[13:]
2018-03-19 16:39:08 +01:00
self.packed = False
def send(self):
if not self.sent:
2018-04-16 17:13:39 +02:00
if not self.packed:
self.pack()
2018-04-17 17:46:48 +02:00
if RNS.Transport.outbound(self):
return self.receipt
else:
# TODO: Don't raise error here, handle gracefully
raise IOError("Packet could not be sent! Do you have any outbound interfaces configured?")
2016-06-03 19:02:02 +02:00
else:
raise IOError("Packet was already sent")
def resend(self):
if self.sent:
Transport.outbound(self.raw)
else:
2018-03-20 12:32:41 +01:00
raise IOError("Packet was not sent yet")
2018-04-17 17:46:48 +02:00
def prove(self, destination=None):
2018-03-20 12:32:41 +01:00
if self.fromPacked and self.destination:
if self.destination.identity and self.destination.identity.prv:
self.destination.identity.prove(self, destination)
2018-04-17 17:46:48 +02:00
# Generates a special destination that allows Reticulum
# to direct the proof back to the proved packet's sender
def generateProofDestination(self):
return ProofDestination(self)
2018-03-20 12:32:41 +01:00
def validateProofPacket(self, proof_packet):
2018-04-17 17:46:48 +02:00
return self.receipt.validateProofPacket(proof_packet)
2018-03-20 12:32:41 +01:00
def validateProof(self, proof):
2018-04-17 17:46:48 +02:00
return self.receipt.validateProof(proof)
def updateHash(self):
self.packet_hash = self.getHash()
def getHash(self):
return RNS.Identity.fullHash(self.getHashablePart())
def getHashablePart(self):
return self.raw[0:1]+self.raw[2:]
2018-03-20 12:32:41 +01:00
2018-04-17 17:46:48 +02:00
class ProofDestination:
def __init__(self, packet):
self.hash = packet.getHash()[:10];
self.type = RNS.Destination.SINGLE
2018-03-20 12:32:41 +01:00
2018-04-17 17:46:48 +02:00
def encrypt(self, plaintext):
return plaintext
2018-03-20 12:32:41 +01:00
2018-04-18 23:31:17 +02:00
class PacketReceipt:
# Receipt status constants
FAILED = 0x00
SENT = 0x01
DELIVERED = 0x02
EXPL_LENGTH = RNS.Identity.HASHLENGTH/8+RNS.Identity.SIGLENGTH/8
IMPL_LENGTH = RNS.Identity.SIGLENGTH/8
# Creates a new packet receipt from a sent packet
def __init__(self, packet):
self.hash = packet.getHash()
self.sent = True
self.sent_at = time.time()
self.timeout = Packet.TIMEOUT
self.proved = False
self.status = PacketReceipt.SENT
self.destination = packet.destination
self.callbacks = PacketReceiptCallbacks()
self.concluded_at = None
# Validate a proof packet
def validateProofPacket(self, proof_packet):
return self.validateProof(proof_packet.data)
# Validate a raw proof
def validateProof(self, proof):
if len(proof) == PacketReceipt.EXPL_LENGTH:
# This is an explicit proof
proof_hash = proof[:RNS.Identity.HASHLENGTH/8]
signature = proof[RNS.Identity.HASHLENGTH/8:RNS.Identity.HASHLENGTH/8+RNS.Identity.SIGLENGTH/8]
if proof_hash == self.hash:
proof_valid = self.destination.identity.validate(signature, self.hash)
if proof_valid:
self.status = PacketReceipt.DELIVERED
self.proved = True
if self.callbacks.delivery != None:
self.callbacks.delivery(self)
return True
else:
return False
else:
return False
elif len(proof) == PacketReceipt.IMPL_LENGTH:
# This is an implicit proof
signature = proof[:RNS.Identity.SIGLENGTH/8]
proof_valid = self.destination.identity.validate(signature, self.hash)
if proof_valid:
self.status = PacketReceipt.DELIVERED
self.proved = True
if self.callbacks.delivery != None:
self.callbacks.delivery(self)
return True
else:
return False
else:
return False
def isTimedOut(self):
return (self.sent_at+self.timeout < time.time())
def checkTimeout(self):
if self.isTimedOut():
self.status = PacketReceipt.FAILED
self.concluded_at = time.time()
if self.callbacks.timeout:
self.callbacks.timeout(self)
# Set the timeout in seconds
def setTimeout(self, timeout):
self.timeout = float(timeout)
# Set a function that gets called when
# a successfull delivery has been proved
def delivery_callback(self, callback):
self.callbacks.delivery = callback
# Set a function that gets called if the
# delivery times out
def timeout_callback(self, callback):
self.callbacks.timeout = callback
class PacketReceiptCallbacks:
def __init__(self):
self.delivery = None
self.timeout = None