#![cfg(test)] use eth2_libp2p::rpc::methods::*; use eth2_libp2p::{BehaviourEvent, Libp2pEvent, ReportSource, Request, Response}; use slog::{debug, warn, Level}; use ssz_types::VariableList; use std::sync::Arc; use std::time::Duration; use tokio::runtime::Runtime; use tokio::time::sleep; use types::{ BeaconBlock, Epoch, EthSpec, Hash256, MinimalEthSpec, Signature, SignedBeaconBlock, Slot, }; mod common; type E = MinimalEthSpec; // Tests the STATUS RPC message #[test] #[allow(clippy::single_match)] fn test_status_rpc() { // set up the logging. The level and enabled logging or not let log_level = Level::Debug; let enable_logging = false; let rt = Arc::new(Runtime::new().unwrap()); let log = common::build_log(log_level, enable_logging); rt.block_on(async { // get sender/receiver let (mut sender, mut receiver) = common::build_node_pair(Arc::downgrade(&rt), &log).await; // Dummy STATUS RPC message let rpc_request = Request::Status(StatusMessage { fork_digest: [0; 4], finalized_root: Hash256::from_low_u64_be(0), finalized_epoch: Epoch::new(1), head_root: Hash256::from_low_u64_be(0), head_slot: Slot::new(1), }); // Dummy STATUS RPC message let rpc_response = Response::Status(StatusMessage { fork_digest: [0; 4], finalized_root: Hash256::from_low_u64_be(0), finalized_epoch: Epoch::new(1), head_root: Hash256::from_low_u64_be(0), head_slot: Slot::new(1), }); // build the sender future let sender_future = async { loop { match sender.next_event().await { Libp2pEvent::Behaviour(BehaviourEvent::PeerConnectedOutgoing(peer_id)) => { // Send a STATUS message debug!(log, "Sending RPC"); sender.swarm.behaviour_mut().send_request( peer_id, RequestId::Sync(10), rpc_request.clone(), ); } Libp2pEvent::Behaviour(BehaviourEvent::ResponseReceived { peer_id: _, id: RequestId::Sync(10), response, }) => { // Should receive the RPC response debug!(log, "Sender Received"); assert_eq!(response, rpc_response.clone()); debug!(log, "Sender Completed"); return; } _ => {} } } }; // build the receiver future let receiver_future = async { loop { match receiver.next_event().await { Libp2pEvent::Behaviour(BehaviourEvent::RequestReceived { peer_id, id, request, }) => { if request == rpc_request { // send the response debug!(log, "Receiver Received"); receiver.swarm.behaviour_mut().send_successful_response( peer_id, id, rpc_response.clone(), ); } } _ => {} // Ignore other events } } }; tokio::select! { _ = sender_future => {} _ = receiver_future => {} _ = sleep(Duration::from_secs(30)) => { panic!("Future timed out"); } } }) } // Tests a streamed BlocksByRange RPC Message #[test] #[allow(clippy::single_match)] fn test_blocks_by_range_chunked_rpc() { // set up the logging. The level and enabled logging or not let log_level = Level::Trace; let enable_logging = false; let messages_to_send = 10; let log = common::build_log(log_level, enable_logging); let rt = Arc::new(Runtime::new().unwrap()); rt.block_on(async { // get sender/receiver let (mut sender, mut receiver) = common::build_node_pair(Arc::downgrade(&rt), &log).await; // BlocksByRange Request let rpc_request = Request::BlocksByRange(BlocksByRangeRequest { start_slot: 0, count: messages_to_send, step: 0, }); // BlocksByRange Response let spec = E::default_spec(); let empty_block = BeaconBlock::empty(&spec); let empty_signed = SignedBeaconBlock::from_block(empty_block, Signature::empty()); let rpc_response = Response::BlocksByRange(Some(Box::new(empty_signed))); // keep count of the number of messages received let mut messages_received = 0; // build the sender future let sender_future = async { loop { match sender.next_event().await { Libp2pEvent::Behaviour(BehaviourEvent::PeerConnectedOutgoing(peer_id)) => { // Send a STATUS message debug!(log, "Sending RPC"); sender.swarm.behaviour_mut().send_request( peer_id, RequestId::Sync(10), rpc_request.clone(), ); } Libp2pEvent::Behaviour(BehaviourEvent::ResponseReceived { peer_id: _, id: RequestId::Sync(10), response, }) => { warn!(log, "Sender received a response"); match response { Response::BlocksByRange(Some(_)) => { assert_eq!(response, rpc_response.clone()); messages_received += 1; warn!(log, "Chunk received"); } Response::BlocksByRange(None) => { // should be exactly 10 messages before terminating assert_eq!(messages_received, messages_to_send); // end the test return; } _ => panic!("Invalid RPC received"), } } _ => {} // Ignore other behaviour events } } }; // build the receiver future let receiver_future = async { loop { match receiver.next_event().await { Libp2pEvent::Behaviour(BehaviourEvent::RequestReceived { peer_id, id, request, }) => { if request == rpc_request { // send the response warn!(log, "Receiver got request"); for _ in 1..=messages_to_send { receiver.swarm.behaviour_mut().send_successful_response( peer_id, id, rpc_response.clone(), ); } // send the stream termination receiver.swarm.behaviour_mut().send_successful_response( peer_id, id, Response::BlocksByRange(None), ); } } _ => {} // Ignore other events } } }; tokio::select! { _ = sender_future => {} _ = receiver_future => {} _ = sleep(Duration::from_secs(10)) => { panic!("Future timed out"); } } }) } // Tests that a streamed BlocksByRange RPC Message terminates when all expected chunks were received #[test] fn test_blocks_by_range_chunked_rpc_terminates_correctly() { // set up the logging. The level and enabled logging or not let log_level = Level::Debug; let enable_logging = false; let messages_to_send = 10; let extra_messages_to_send = 10; let log = common::build_log(log_level, enable_logging); let rt = Arc::new(Runtime::new().unwrap()); rt.block_on(async { // get sender/receiver let (mut sender, mut receiver) = common::build_node_pair(Arc::downgrade(&rt), &log).await; // BlocksByRange Request let rpc_request = Request::BlocksByRange(BlocksByRangeRequest { start_slot: 0, count: messages_to_send, step: 0, }); // BlocksByRange Response let spec = E::default_spec(); let empty_block = BeaconBlock::empty(&spec); let empty_signed = SignedBeaconBlock::from_block(empty_block, Signature::empty()); let rpc_response = Response::BlocksByRange(Some(Box::new(empty_signed))); // keep count of the number of messages received let mut messages_received: u64 = 0; // build the sender future let sender_future = async { loop { match sender.next_event().await { Libp2pEvent::Behaviour(BehaviourEvent::PeerConnectedOutgoing(peer_id)) => { // Send a STATUS message debug!(log, "Sending RPC"); sender.swarm.behaviour_mut().send_request( peer_id, RequestId::Sync(10), rpc_request.clone(), ); } Libp2pEvent::Behaviour(BehaviourEvent::ResponseReceived { peer_id: _, id: RequestId::Sync(10), response, }) => // Should receive the RPC response { debug!(log, "Sender received a response"); match response { Response::BlocksByRange(Some(_)) => { assert_eq!(response, rpc_response.clone()); messages_received += 1; } Response::BlocksByRange(None) => { // should be exactly 10 messages, as requested assert_eq!(messages_received, messages_to_send); } _ => panic!("Invalid RPC received"), } } _ => {} // Ignore other behaviour events } } }; // determine messages to send (PeerId, RequestId). If some, indicates we still need to send // messages let mut message_info = None; // the number of messages we've sent let mut messages_sent = 0; let receiver_future = async { loop { // this future either drives the sending/receiving or times out allowing messages to be // sent in the timeout match futures::future::select( Box::pin(receiver.next_event()), Box::pin(tokio::time::sleep(Duration::from_secs(1))), ) .await { futures::future::Either::Left(( Libp2pEvent::Behaviour(BehaviourEvent::RequestReceived { peer_id, id, request, }), _, )) => { if request == rpc_request { // send the response warn!(log, "Receiver got request"); message_info = Some((peer_id, id)); } } futures::future::Either::Right((_, _)) => {} // The timeout hit, send messages if required _ => continue, } // if we need to send messages send them here. This will happen after a delay if message_info.is_some() { messages_sent += 1; let (peer_id, stream_id) = message_info.as_ref().unwrap(); receiver.swarm.behaviour_mut().send_successful_response( *peer_id, *stream_id, rpc_response.clone(), ); debug!(log, "Sending message {}", messages_sent); if messages_sent == messages_to_send + extra_messages_to_send { // stop sending messages return; } } } }; tokio::select! { _ = sender_future => {} _ = receiver_future => {} _ = sleep(Duration::from_secs(30)) => { panic!("Future timed out"); } } }) } // Tests an empty response to a BlocksByRange RPC Message #[test] #[allow(clippy::single_match)] fn test_blocks_by_range_single_empty_rpc() { // set up the logging. The level and enabled logging or not let log_level = Level::Trace; let enable_logging = false; let log = common::build_log(log_level, enable_logging); let rt = Arc::new(Runtime::new().unwrap()); rt.block_on(async { // get sender/receiver let (mut sender, mut receiver) = common::build_node_pair(Arc::downgrade(&rt), &log).await; // BlocksByRange Request let rpc_request = Request::BlocksByRange(BlocksByRangeRequest { start_slot: 0, count: 10, step: 0, }); // BlocksByRange Response let spec = E::default_spec(); let empty_block = BeaconBlock::empty(&spec); let empty_signed = SignedBeaconBlock::from_block(empty_block, Signature::empty()); let rpc_response = Response::BlocksByRange(Some(Box::new(empty_signed))); let messages_to_send = 1; // keep count of the number of messages received let mut messages_received = 0; // build the sender future let sender_future = async { loop { match sender.next_event().await { Libp2pEvent::Behaviour(BehaviourEvent::PeerConnectedOutgoing(peer_id)) => { // Send a STATUS message debug!(log, "Sending RPC"); sender.swarm.behaviour_mut().send_request( peer_id, RequestId::Sync(10), rpc_request.clone(), ); } Libp2pEvent::Behaviour(BehaviourEvent::ResponseReceived { peer_id: _, id: RequestId::Sync(10), response, }) => match response { Response::BlocksByRange(Some(_)) => { assert_eq!(response, rpc_response.clone()); messages_received += 1; warn!(log, "Chunk received"); } Response::BlocksByRange(None) => { // should be exactly 10 messages before terminating assert_eq!(messages_received, messages_to_send); // end the test return; } _ => panic!("Invalid RPC received"), }, _ => {} // Ignore other behaviour events } } }; // build the receiver future let receiver_future = async { loop { match receiver.next_event().await { Libp2pEvent::Behaviour(BehaviourEvent::RequestReceived { peer_id, id, request, }) => { if request == rpc_request { // send the response warn!(log, "Receiver got request"); for _ in 1..=messages_to_send { receiver.swarm.behaviour_mut().send_successful_response( peer_id, id, rpc_response.clone(), ); } // send the stream termination receiver.swarm.behaviour_mut().send_successful_response( peer_id, id, Response::BlocksByRange(None), ); } } _ => {} // Ignore other events } } }; tokio::select! { _ = sender_future => {} _ = receiver_future => {} _ = sleep(Duration::from_secs(20)) => { panic!("Future timed out"); } } }) } // Tests a streamed, chunked BlocksByRoot RPC Message // The size of the reponse is a full `BeaconBlock` // which is greater than the Snappy frame size. Hence, this test // serves to test the snappy framing format as well. #[test] #[allow(clippy::single_match)] fn test_blocks_by_root_chunked_rpc() { // set up the logging. The level and enabled logging or not let log_level = Level::Debug; let enable_logging = false; let messages_to_send = 3; let log = common::build_log(log_level, enable_logging); let spec = E::default_spec(); let rt = Arc::new(Runtime::new().unwrap()); // get sender/receiver rt.block_on(async { let (mut sender, mut receiver) = common::build_node_pair(Arc::downgrade(&rt), &log).await; // BlocksByRoot Request let rpc_request = Request::BlocksByRoot(BlocksByRootRequest { block_roots: VariableList::from(vec![ Hash256::from_low_u64_be(0), Hash256::from_low_u64_be(0), Hash256::from_low_u64_be(0), ]), }); // BlocksByRoot Response let full_block = BeaconBlock::full(&spec); let signed_full_block = SignedBeaconBlock::from_block(full_block, Signature::empty()); let rpc_response = Response::BlocksByRoot(Some(Box::new(signed_full_block))); // keep count of the number of messages received let mut messages_received = 0; // build the sender future let sender_future = async { loop { match sender.next_event().await { Libp2pEvent::Behaviour(BehaviourEvent::PeerConnectedOutgoing(peer_id)) => { // Send a STATUS message debug!(log, "Sending RPC"); sender.swarm.behaviour_mut().send_request( peer_id, RequestId::Sync(10), rpc_request.clone(), ); } Libp2pEvent::Behaviour(BehaviourEvent::ResponseReceived { peer_id: _, id: RequestId::Sync(10), response, }) => match response { Response::BlocksByRoot(Some(_)) => { assert_eq!(response, rpc_response.clone()); messages_received += 1; debug!(log, "Chunk received"); } Response::BlocksByRoot(None) => { // should be exactly messages_to_send assert_eq!(messages_received, messages_to_send); // end the test return; } _ => {} // Ignore other RPC messages }, _ => {} // Ignore other behaviour events } } }; // build the receiver future let receiver_future = async { loop { match receiver.next_event().await { Libp2pEvent::Behaviour(BehaviourEvent::RequestReceived { peer_id, id, request, }) => { if request == rpc_request { // send the response debug!(log, "Receiver got request"); for _ in 1..=messages_to_send { receiver.swarm.behaviour_mut().send_successful_response( peer_id, id, rpc_response.clone(), ); debug!(log, "Sending message"); } // send the stream termination receiver.swarm.behaviour_mut().send_successful_response( peer_id, id, Response::BlocksByRange(None), ); debug!(log, "Send stream term"); } } _ => {} // Ignore other events } } }; tokio::select! { _ = sender_future => {} _ = receiver_future => {} _ = sleep(Duration::from_secs(30)) => { panic!("Future timed out"); } } }) } // Tests a streamed, chunked BlocksByRoot RPC Message terminates when all expected reponses have been received #[test] fn test_blocks_by_root_chunked_rpc_terminates_correctly() { // set up the logging. The level and enabled logging or not let log_level = Level::Debug; let enable_logging = false; let messages_to_send: u64 = 10; let extra_messages_to_send: u64 = 10; let log = common::build_log(log_level, enable_logging); let spec = E::default_spec(); let rt = Arc::new(Runtime::new().unwrap()); // get sender/receiver rt.block_on(async { let (mut sender, mut receiver) = common::build_node_pair(Arc::downgrade(&rt), &log).await; // BlocksByRoot Request let rpc_request = Request::BlocksByRoot(BlocksByRootRequest { block_roots: VariableList::from(vec![ Hash256::from_low_u64_be(0), Hash256::from_low_u64_be(0), Hash256::from_low_u64_be(0), Hash256::from_low_u64_be(0), Hash256::from_low_u64_be(0), Hash256::from_low_u64_be(0), Hash256::from_low_u64_be(0), Hash256::from_low_u64_be(0), Hash256::from_low_u64_be(0), Hash256::from_low_u64_be(0), ]), }); // BlocksByRoot Response let full_block = BeaconBlock::full(&spec); let signed_full_block = SignedBeaconBlock::from_block(full_block, Signature::empty()); let rpc_response = Response::BlocksByRoot(Some(Box::new(signed_full_block))); // keep count of the number of messages received let mut messages_received = 0; // build the sender future let sender_future = async { loop { match sender.next_event().await { Libp2pEvent::Behaviour(BehaviourEvent::PeerConnectedOutgoing(peer_id)) => { // Send a STATUS message debug!(log, "Sending RPC"); sender.swarm.behaviour_mut().send_request( peer_id, RequestId::Sync(10), rpc_request.clone(), ); } Libp2pEvent::Behaviour(BehaviourEvent::ResponseReceived { peer_id: _, id: RequestId::Sync(10), response, }) => { debug!(log, "Sender received a response"); match response { Response::BlocksByRoot(Some(_)) => { assert_eq!(response, rpc_response.clone()); messages_received += 1; debug!(log, "Chunk received"); } Response::BlocksByRoot(None) => { // should be exactly messages_to_send assert_eq!(messages_received, messages_to_send); // end the test return; } _ => {} // Ignore other RPC messages } } _ => {} // Ignore other behaviour events } } }; // determine messages to send (PeerId, RequestId). If some, indicates we still need to send // messages let mut message_info = None; // the number of messages we've sent let mut messages_sent = 0; let receiver_future = async { loop { // this future either drives the sending/receiving or times out allowing messages to be // sent in the timeout match futures::future::select( Box::pin(receiver.next_event()), Box::pin(tokio::time::sleep(Duration::from_secs(1))), ) .await { futures::future::Either::Left(( Libp2pEvent::Behaviour(BehaviourEvent::RequestReceived { peer_id, id, request, }), _, )) => { if request == rpc_request { // send the response warn!(log, "Receiver got request"); message_info = Some((peer_id, id)); } } futures::future::Either::Right((_, _)) => {} // The timeout hit, send messages if required _ => continue, } // if we need to send messages send them here. This will happen after a delay if message_info.is_some() { messages_sent += 1; let (peer_id, stream_id) = message_info.as_ref().unwrap(); receiver.swarm.behaviour_mut().send_successful_response( *peer_id, *stream_id, rpc_response.clone(), ); debug!(log, "Sending message {}", messages_sent); if messages_sent == messages_to_send + extra_messages_to_send { // stop sending messages return; } } } }; tokio::select! { _ = sender_future => {} _ = receiver_future => {} _ = sleep(Duration::from_secs(30)) => { panic!("Future timed out"); } } }) } // Tests a Goodbye RPC message #[test] #[allow(clippy::single_match)] fn test_goodbye_rpc() { // set up the logging. The level and enabled logging or not let log_level = Level::Trace; let enable_logging = false; let log = common::build_log(log_level, enable_logging); let rt = Arc::new(Runtime::new().unwrap()); // get sender/receiver rt.block_on(async { let (mut sender, mut receiver) = common::build_node_pair(Arc::downgrade(&rt), &log).await; // build the sender future let sender_future = async { loop { match sender.next_event().await { Libp2pEvent::Behaviour(BehaviourEvent::PeerConnectedOutgoing(peer_id)) => { // Send a goodbye and disconnect debug!(log, "Sending RPC"); sender.swarm.behaviour_mut().goodbye_peer( &peer_id, GoodbyeReason::IrrelevantNetwork, ReportSource::SyncService, ); } Libp2pEvent::Behaviour(BehaviourEvent::PeerDisconnected(_)) => { return; } _ => {} // Ignore other RPC messages } } }; // build the receiver future let receiver_future = async { loop { match receiver.next_event().await { Libp2pEvent::Behaviour(BehaviourEvent::PeerDisconnected(_)) => { // Should receive sent RPC request return; } _ => {} // Ignore other events } } }; let total_future = futures::future::join(sender_future, receiver_future); tokio::select! { _ = total_future => {} _ = sleep(Duration::from_secs(30)) => { panic!("Future timed out"); } } }) }