nucypher/tests/unit/test_external_ip_utilities.py

247 lines
8.4 KiB
Python

from pathlib import Path
import pytest
from eth_utils import to_checksum_address
from nucypher_core import Address, NodeMetadata, NodeMetadataPayload
from nucypher_core.ferveo import Keypair
from nucypher_core.umbral import RecoverableSignature, SecretKey, Signer
from nucypher.acumen.perception import FleetSensor
from nucypher.characters.lawful import Ursula
from nucypher.crypto.tls import generate_self_signed_certificate
from nucypher.network.exceptions import NodeSeemsToBeDown
from nucypher.network.middleware import NucypherMiddlewareClient
from nucypher.network.nodes import TEACHER_NODES
from nucypher.network.protocols import InterfaceInfo
from nucypher.utilities.networking import (
CENTRALIZED_IP_ORACLE_URL,
UnknownIPAddress,
determine_external_ip_address,
get_external_ip_from_centralized_source,
get_external_ip_from_default_teacher,
get_external_ip_from_known_nodes,
)
from tests.constants import MOCK_ETH_PROVIDER_URI, MOCK_IP_ADDRESS
MOCK_DOMAIN = "holodeck"
MOCK_PORT = 1111
class Dummy: # Teacher
def __init__(self, canonical_address):
self.canonical_address = canonical_address
self.checksum_address = to_checksum_address(canonical_address)
self.certificate_filepath = None
self.domain = MOCK_DOMAIN
class GoodResponse:
status_code = 200
text = MOCK_IP_ADDRESS
class BadResponse:
status_code = 404
text = None
content = 'DUMMY 404'
def mature(self):
return self
def verify_node(self, *args, **kwargs):
pass
def rest_url(self):
return MOCK_IP_ADDRESS
@property
def rest_interface(self):
return InterfaceInfo(host=MOCK_IP_ADDRESS, port=MOCK_PORT)
def metadata(self):
signer = Signer(SecretKey.random())
# A dummy signature with the recovery byte
dummy_signature = RecoverableSignature.from_be_bytes(
signer.sign(b"whatever").to_be_bytes() + b"\x00"
)
payload = NodeMetadataPayload(
staking_provider_address=Address(self.canonical_address),
domain=":dummy:",
timestamp_epoch=0,
operator_signature=dummy_signature,
verifying_key=signer.verifying_key(),
encrypting_key=SecretKey.random().public_key(),
ferveo_public_key=Keypair.random().public_key(),
certificate_der=b"not a certificate",
host=MOCK_IP_ADDRESS,
port=MOCK_PORT,
)
return NodeMetadata(signer=signer, payload=payload)
@pytest.fixture(autouse=True)
def mock_requests(mocker):
"""prevents making live HTTP requests from this module"""
make_request = 'nucypher.utilities.networking._request'
yield mocker.patch(make_request, return_value=None)
@pytest.fixture(autouse=True)
def mock_client(mocker):
cert, pk = generate_self_signed_certificate(host=MOCK_IP_ADDRESS)
mocker.patch.object(NucypherMiddlewareClient, 'get_certificate', return_value=(cert, Path()))
yield mocker.patch.object(NucypherMiddlewareClient, 'invoke_method', return_value=Dummy.GoodResponse)
@pytest.fixture(autouse=True)
def mock_default_teachers(mocker):
teachers = {MOCK_DOMAIN: (f"{MOCK_IP_ADDRESS}:{MOCK_PORT}",)}
mocker.patch.dict(TEACHER_NODES, teachers, clear=True)
def test_get_external_ip_from_centralized_source(mock_requests):
get_external_ip_from_centralized_source()
mock_requests.assert_called_once_with(url=CENTRALIZED_IP_ORACLE_URL)
def test_get_external_ip_from_empty_known_nodes(mock_requests):
sensor = FleetSensor(domain=MOCK_DOMAIN)
assert len(sensor) == 0
get_external_ip_from_known_nodes(
known_nodes=sensor, eth_endpoint=MOCK_ETH_PROVIDER_URI
)
# skipped because there are no known nodes
mock_requests.assert_not_called()
def test_get_external_ip_from_known_nodes_with_one_known_node(mock_requests):
sensor = FleetSensor(domain=MOCK_DOMAIN)
sensor.record_node(Dummy(b'deadbeefdeadbeefdead'))
sensor.record_fleet_state()
assert len(sensor) == 1
get_external_ip_from_known_nodes(
known_nodes=sensor, eth_endpoint=MOCK_ETH_PROVIDER_URI
)
# skipped because there are too few known nodes
mock_requests.assert_not_called()
def test_get_external_ip_from_known_nodes(mock_client):
# Setup FleetSensor
sensor = FleetSensor(domain=MOCK_DOMAIN)
sample_size = 3
sensor.record_node(Dummy(b'deadbeefdeadbeefdead'))
sensor.record_node(Dummy(b'deadllamadeadllamade'))
sensor.record_node(Dummy(b'deadmousedeadmousede'))
sensor.record_fleet_state()
assert len(sensor) == sample_size
# First sampled node replies
get_external_ip_from_known_nodes(
known_nodes=sensor, sample_size=sample_size, eth_endpoint=MOCK_ETH_PROVIDER_URI
)
assert mock_client.call_count == 1
mock_client.call_count = 0 # reset
# All sampled nodes dont respond
mock_client.return_value = Dummy.BadResponse
get_external_ip_from_known_nodes(
known_nodes=sensor, sample_size=sample_size, eth_endpoint=MOCK_ETH_PROVIDER_URI
)
assert mock_client.call_count == sample_size
def test_get_external_ip_from_known_nodes_client(mocker, mock_client):
# Setup FleetSensor
sensor = FleetSensor(domain=MOCK_DOMAIN)
sample_size = 3
sensor.record_node(Dummy(b'deadbeefdeadbeefdead'))
sensor.record_node(Dummy(b'deadllamadeadllamade'))
sensor.record_node(Dummy(b'deadmousedeadmousede'))
sensor.record_fleet_state()
assert len(sensor) == sample_size
# Setup HTTP Client
mocker.patch.object(Ursula, 'from_teacher_uri', return_value=Dummy(b'deadporkdeadporkdead'))
teacher_uri = TEACHER_NODES[MOCK_DOMAIN][0]
get_external_ip_from_known_nodes(
known_nodes=sensor, sample_size=sample_size, eth_endpoint=MOCK_ETH_PROVIDER_URI
)
assert mock_client.call_count == 1 # first node responded
function, endpoint = mock_client.call_args[0]
assert function.__name__ == 'get'
assert endpoint == f'https://{teacher_uri}/ping'
def test_get_external_ip_default_teacher_unreachable(mocker):
for error in NodeSeemsToBeDown:
# Default seednode is down
mocker.patch.object(Ursula, "from_teacher_uri", side_effect=error)
ip = get_external_ip_from_default_teacher(
domain=MOCK_DOMAIN, eth_endpoint=MOCK_ETH_PROVIDER_URI
)
assert ip is None
def test_get_external_ip_from_default_teacher(mocker, mock_client, mock_requests):
mock_client.return_value = Dummy.GoodResponse
teacher_uri = TEACHER_NODES[MOCK_DOMAIN][0]
mocker.patch.object(Ursula, 'from_teacher_uri', return_value=Dummy(b'deadbeefdeadbeefdead'))
# "Success"
ip = get_external_ip_from_default_teacher(
domain=MOCK_DOMAIN, eth_endpoint=MOCK_ETH_PROVIDER_URI
)
assert ip == MOCK_IP_ADDRESS
# Check that the correct endpoint and function is targeted
mock_requests.assert_not_called()
mock_client.assert_called_once()
function, endpoint = mock_client.call_args[0]
assert function.__name__ == 'get'
assert endpoint == f'https://{teacher_uri}/ping'
def test_get_external_ip_default_unknown_domain():
unknown_domain = 'thisisnotarealdomain'
# Without fleet sensor
with pytest.raises(UnknownIPAddress):
determine_external_ip_address(
domain=unknown_domain, eth_endpoint=MOCK_ETH_PROVIDER_URI
)
# with fleet sensor
sensor = FleetSensor(domain=unknown_domain)
with pytest.raises(UnknownIPAddress):
determine_external_ip_address(
known_nodes=sensor,
domain=unknown_domain,
eth_endpoint=MOCK_ETH_PROVIDER_URI,
)
def test_get_external_ip_cascade_failure(mocker, mock_requests):
first = mocker.patch('nucypher.utilities.networking.get_external_ip_from_known_nodes', return_value=None)
second = mocker.patch('nucypher.utilities.networking.get_external_ip_from_default_teacher', return_value=None)
third = mocker.patch('nucypher.utilities.networking.get_external_ip_from_centralized_source', return_value=None)
sensor = FleetSensor(domain=MOCK_DOMAIN)
sensor.record_node(Dummy(b'deadbeefdeadbeefdead'))
sensor.record_fleet_state()
with pytest.raises(UnknownIPAddress, match="External IP address detection failed"):
determine_external_ip_address(
domain=MOCK_DOMAIN, known_nodes=sensor, eth_endpoint=MOCK_ETH_PROVIDER_URI
)
first.assert_called_once()
second.assert_called_once()
third.assert_called_once()