2016-06-30 10:11:33 +02:00
|
|
|
# -*- coding: utf-8 -*-
|
2022-09-23 00:54:12 +02:00
|
|
|
"""Protocol structures"""
|
2016-06-30 10:11:33 +02:00
|
|
|
import base64
|
|
|
|
import hashlib
|
2017-05-25 11:47:44 +02:00
|
|
|
import logging
|
2016-06-30 10:11:33 +02:00
|
|
|
import socket
|
2021-03-08 16:06:07 +01:00
|
|
|
import struct
|
2016-06-30 10:11:33 +02:00
|
|
|
import time
|
|
|
|
|
2021-03-09 15:40:59 +01:00
|
|
|
from . import shared
|
2016-06-30 10:11:33 +02:00
|
|
|
|
|
|
|
|
2021-08-01 16:55:08 +02:00
|
|
|
class VarInt():
|
2022-09-23 00:54:12 +02:00
|
|
|
"""varint object"""
|
2016-06-30 10:11:33 +02:00
|
|
|
def __init__(self, n):
|
|
|
|
self.n = n
|
|
|
|
|
|
|
|
def to_bytes(self):
|
|
|
|
if self.n < 0xfd:
|
|
|
|
return struct.pack('>B', self.n)
|
|
|
|
|
|
|
|
if self.n <= 0xffff:
|
|
|
|
return b'\xfd' + struct.pack('>H', self.n)
|
|
|
|
|
|
|
|
if self.n <= 0xffffffff:
|
|
|
|
return b'\xfe' + struct.pack('>I', self.n)
|
|
|
|
|
|
|
|
return b'\xff' + struct.pack('>Q', self.n)
|
|
|
|
|
|
|
|
@staticmethod
|
|
|
|
def length(b):
|
|
|
|
if b == 0xfd:
|
|
|
|
return 3
|
|
|
|
if b == 0xfe:
|
|
|
|
return 5
|
|
|
|
if b == 0xff:
|
|
|
|
return 9
|
|
|
|
return 1
|
|
|
|
|
|
|
|
@classmethod
|
|
|
|
def from_bytes(cls, b):
|
|
|
|
if cls.length(b[0]) > 1:
|
|
|
|
b = b[1:]
|
|
|
|
n = int.from_bytes(b, 'big')
|
|
|
|
return cls(n)
|
|
|
|
|
|
|
|
|
2021-08-01 16:55:08 +02:00
|
|
|
class Object():
|
2023-08-12 02:34:20 +02:00
|
|
|
"""The 'object' message payload"""
|
2021-03-08 16:06:07 +01:00
|
|
|
def __init__(
|
|
|
|
self, nonce, expires_time, object_type, version,
|
|
|
|
stream_number, object_payload
|
|
|
|
):
|
2016-06-30 10:11:33 +02:00
|
|
|
self.nonce = nonce
|
|
|
|
self.expires_time = expires_time
|
|
|
|
self.object_type = object_type
|
|
|
|
self.version = version
|
|
|
|
self.stream_number = stream_number
|
|
|
|
self.object_payload = object_payload
|
2021-03-08 16:06:07 +01:00
|
|
|
self.vector = hashlib.sha512(hashlib.sha512(
|
|
|
|
self.to_bytes()).digest()).digest()[:32]
|
2016-06-30 10:11:33 +02:00
|
|
|
|
|
|
|
def __repr__(self):
|
2021-03-08 16:06:07 +01:00
|
|
|
return 'object, vector: {}'.format(
|
|
|
|
base64.b16encode(self.vector).decode())
|
2016-06-30 10:11:33 +02:00
|
|
|
|
|
|
|
@classmethod
|
|
|
|
def from_message(cls, m):
|
2023-08-12 02:34:20 +02:00
|
|
|
"""Decode message payload"""
|
2016-06-30 10:11:33 +02:00
|
|
|
payload = m.payload
|
|
|
|
nonce, expires_time, object_type = struct.unpack('>8sQL', payload[:20])
|
|
|
|
payload = payload[20:]
|
|
|
|
version_varint_length = VarInt.length(payload[0])
|
|
|
|
version = VarInt.from_bytes(payload[:version_varint_length]).n
|
|
|
|
payload = payload[version_varint_length:]
|
|
|
|
stream_number_varint_length = VarInt.length(payload[0])
|
2021-03-08 16:06:07 +01:00
|
|
|
stream_number = VarInt.from_bytes(
|
|
|
|
payload[:stream_number_varint_length]).n
|
2016-06-30 10:11:33 +02:00
|
|
|
payload = payload[stream_number_varint_length:]
|
2021-03-08 16:06:07 +01:00
|
|
|
return cls(
|
|
|
|
nonce, expires_time, object_type, version, stream_number, payload)
|
2016-06-30 10:11:33 +02:00
|
|
|
|
|
|
|
def to_bytes(self):
|
2023-08-12 02:34:20 +02:00
|
|
|
"""Serialize to bytes"""
|
2016-06-30 10:11:33 +02:00
|
|
|
payload = b''
|
|
|
|
payload += self.nonce
|
|
|
|
payload += struct.pack('>QL', self.expires_time, self.object_type)
|
2021-03-08 16:06:07 +01:00
|
|
|
payload += (
|
|
|
|
VarInt(self.version).to_bytes()
|
|
|
|
+ VarInt(self.stream_number).to_bytes())
|
2016-06-30 10:11:33 +02:00
|
|
|
payload += self.object_payload
|
|
|
|
return payload
|
|
|
|
|
|
|
|
def is_expired(self):
|
2023-08-12 02:34:20 +02:00
|
|
|
"""Check if object's TTL is expired"""
|
2016-06-30 10:11:33 +02:00
|
|
|
return self.expires_time + 3 * 3600 < time.time()
|
|
|
|
|
|
|
|
def is_valid(self):
|
2023-08-12 02:34:20 +02:00
|
|
|
"""Checks the object validity"""
|
2016-06-30 10:11:33 +02:00
|
|
|
if self.is_expired():
|
2021-03-08 16:06:07 +01:00
|
|
|
logging.debug(
|
|
|
|
'Invalid object %s, reason: expired',
|
|
|
|
base64.b16encode(self.vector).decode())
|
2016-06-30 10:11:33 +02:00
|
|
|
return False
|
2017-08-23 18:35:48 +02:00
|
|
|
if self.expires_time > time.time() + 28 * 24 * 3600 + 3 * 3600:
|
2021-03-08 16:06:07 +01:00
|
|
|
logging.warning(
|
|
|
|
'Invalid object %s, reason: end of life too far in the future',
|
|
|
|
base64.b16encode(self.vector).decode())
|
2017-08-23 18:35:48 +02:00
|
|
|
return False
|
2016-06-30 10:11:33 +02:00
|
|
|
if len(self.object_payload) > 2**18:
|
2021-03-08 16:06:07 +01:00
|
|
|
logging.warning(
|
|
|
|
'Invalid object %s, reason: payload is too long',
|
|
|
|
base64.b16encode(self.vector).decode())
|
2016-06-30 10:11:33 +02:00
|
|
|
return False
|
2023-08-11 19:30:50 +02:00
|
|
|
if self.stream_number != shared.stream:
|
2021-03-08 16:06:07 +01:00
|
|
|
logging.warning(
|
2023-08-11 19:30:50 +02:00
|
|
|
'Invalid object %s, reason: not in stream %i',
|
|
|
|
base64.b16encode(self.vector).decode(), shared.stream)
|
2017-05-25 11:37:02 +02:00
|
|
|
return False
|
2023-08-11 19:30:50 +02:00
|
|
|
|
2021-03-08 16:06:07 +01:00
|
|
|
pow_value = int.from_bytes(
|
|
|
|
hashlib.sha512(hashlib.sha512(
|
2023-08-11 19:30:50 +02:00
|
|
|
self.nonce + self.pow_initial_hash()
|
|
|
|
).digest()).digest()[:8], 'big')
|
2017-07-01 15:05:06 +02:00
|
|
|
target = self.pow_target()
|
2016-06-30 10:11:33 +02:00
|
|
|
if target < pow_value:
|
2021-03-08 16:06:07 +01:00
|
|
|
logging.warning(
|
|
|
|
'Invalid object %s, reason: insufficient pow',
|
|
|
|
base64.b16encode(self.vector).decode())
|
2016-06-30 10:11:33 +02:00
|
|
|
return False
|
|
|
|
return True
|
|
|
|
|
2017-07-01 15:05:06 +02:00
|
|
|
def pow_target(self):
|
2023-08-12 02:34:20 +02:00
|
|
|
"""Compute PoW target"""
|
2017-07-01 15:05:06 +02:00
|
|
|
data = self.to_bytes()[8:]
|
|
|
|
length = len(data) + 8 + shared.payload_length_extra_bytes
|
|
|
|
dt = max(self.expires_time - time.time(), 0)
|
2021-03-08 16:06:07 +01:00
|
|
|
return int(
|
|
|
|
2 ** 64 / (
|
|
|
|
shared.nonce_trials_per_byte * (
|
|
|
|
length + (dt * length) / (2 ** 16))))
|
2017-07-01 15:05:06 +02:00
|
|
|
|
|
|
|
def pow_initial_hash(self):
|
2023-08-12 02:34:20 +02:00
|
|
|
"""Compute the initial hash for PoW"""
|
2017-07-01 15:05:06 +02:00
|
|
|
return hashlib.sha512(self.to_bytes()[8:]).digest()
|
|
|
|
|
2016-06-30 10:11:33 +02:00
|
|
|
|
2021-08-01 16:55:08 +02:00
|
|
|
class NetAddrNoPrefix():
|
2022-09-23 00:54:12 +02:00
|
|
|
"""Network address"""
|
2016-06-30 10:11:33 +02:00
|
|
|
def __init__(self, services, host, port):
|
|
|
|
self.services = services
|
|
|
|
self.host = host
|
|
|
|
self.port = port
|
|
|
|
|
|
|
|
def __repr__(self):
|
2021-03-08 16:06:07 +01:00
|
|
|
return 'net_addr_no_prefix, services: {}, host: {}, port {}'.format(
|
|
|
|
self.services, self.host, self.port)
|
2016-06-30 10:11:33 +02:00
|
|
|
|
|
|
|
def to_bytes(self):
|
|
|
|
b = b''
|
|
|
|
b += struct.pack('>Q', self.services)
|
|
|
|
try:
|
|
|
|
host = socket.inet_pton(socket.AF_INET, self.host)
|
|
|
|
b += b'\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\xFF\xFF' + host
|
|
|
|
except socket.error:
|
|
|
|
b += socket.inet_pton(socket.AF_INET6, self.host)
|
2016-08-29 11:34:28 +02:00
|
|
|
b += struct.pack('>H', int(self.port))
|
2016-06-30 10:11:33 +02:00
|
|
|
return b
|
|
|
|
|
|
|
|
@classmethod
|
|
|
|
def from_bytes(cls, b):
|
|
|
|
services, host, port = struct.unpack('>Q16sH', b)
|
2021-03-08 16:06:07 +01:00
|
|
|
if host.startswith(
|
|
|
|
b'\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\xFF\xFF'):
|
2016-06-30 10:11:33 +02:00
|
|
|
host = socket.inet_ntop(socket.AF_INET, host[-4:])
|
|
|
|
else:
|
|
|
|
host = socket.inet_ntop(socket.AF_INET6, host)
|
|
|
|
return cls(services, host, port)
|
|
|
|
|
|
|
|
|
2021-08-01 16:55:08 +02:00
|
|
|
class NetAddr():
|
2022-09-23 00:54:12 +02:00
|
|
|
"""Network address with time and stream"""
|
2016-06-30 10:11:33 +02:00
|
|
|
def __init__(self, services, host, port, stream=shared.stream):
|
|
|
|
self.stream = stream
|
|
|
|
self.services = services
|
|
|
|
self.host = host
|
|
|
|
self.port = port
|
|
|
|
|
|
|
|
def __repr__(self):
|
2021-03-08 16:06:07 +01:00
|
|
|
return 'net_addr, stream: {}, services: {}, host: {}, port {}'.format(
|
|
|
|
self.stream, self.services, self.host, self.port)
|
2016-06-30 10:11:33 +02:00
|
|
|
|
|
|
|
def to_bytes(self):
|
|
|
|
b = b''
|
|
|
|
b += struct.pack('>Q', int(time.time()))
|
|
|
|
b += struct.pack('>I', self.stream)
|
|
|
|
b += NetAddrNoPrefix(self.services, self.host, self.port).to_bytes()
|
|
|
|
return b
|
|
|
|
|
|
|
|
@classmethod
|
|
|
|
def from_bytes(cls, b):
|
2021-03-08 16:06:07 +01:00
|
|
|
stream, net_addr = struct.unpack('>QI26s', b)[1:]
|
2016-06-30 10:11:33 +02:00
|
|
|
n = NetAddrNoPrefix.from_bytes(net_addr)
|
|
|
|
return cls(n.services, n.host, n.port, stream)
|