solana_udp_client/nonblocking/
udp_client.rs

1//! Simple UDP client that communicates with the given UDP port with UDP and provides
2//! an interface for sending data
3
4use {
5    async_trait::async_trait, core::iter::repeat,
6    solana_connection_cache::nonblocking::client_connection::ClientConnection,
7    solana_streamer::nonblocking::sendmmsg::batch_send, solana_transaction_error::TransportResult,
8    std::net::SocketAddr, tokio::net::UdpSocket,
9};
10
11pub struct UdpClientConnection {
12    pub socket: UdpSocket,
13    pub addr: SocketAddr,
14}
15
16impl UdpClientConnection {
17    pub fn new_from_addr(socket: std::net::UdpSocket, server_addr: SocketAddr) -> Self {
18        socket.set_nonblocking(true).unwrap();
19        let socket = UdpSocket::from_std(socket).unwrap();
20        Self {
21            socket,
22            addr: server_addr,
23        }
24    }
25}
26
27#[async_trait]
28impl ClientConnection for UdpClientConnection {
29    fn server_addr(&self) -> &SocketAddr {
30        &self.addr
31    }
32
33    async fn send_data(&self, buffer: &[u8]) -> TransportResult<()> {
34        self.socket.send_to(buffer, self.addr).await?;
35        Ok(())
36    }
37
38    async fn send_data_batch(&self, buffers: &[Vec<u8>]) -> TransportResult<()> {
39        let pkts: Vec<_> = buffers.iter().zip(repeat(self.server_addr())).collect();
40        batch_send(&self.socket, &pkts).await?;
41        Ok(())
42    }
43}
44
45#[cfg(test)]
46mod tests {
47    use {
48        super::*,
49        solana_net_utils::{bind_to_async, SocketConfig},
50        solana_packet::{Packet, PACKET_DATA_SIZE},
51        solana_streamer::nonblocking::recvmmsg::recv_mmsg,
52        std::net::{IpAddr, Ipv4Addr},
53        tokio::net::UdpSocket,
54    };
55
56    async fn check_send_one(connection: &UdpClientConnection, reader: &UdpSocket) {
57        let packet = vec![111u8; PACKET_DATA_SIZE];
58        connection.send_data(&packet).await.unwrap();
59        let mut packets = vec![Packet::default(); 32];
60        let recv = recv_mmsg(reader, &mut packets[..]).await.unwrap();
61        assert_eq!(1, recv);
62    }
63
64    async fn check_send_batch(connection: &UdpClientConnection, reader: &UdpSocket) {
65        let packets: Vec<_> = (0..32).map(|_| vec![0u8; PACKET_DATA_SIZE]).collect();
66        connection.send_data_batch(&packets).await.unwrap();
67        let mut packets = vec![Packet::default(); 32];
68        let recv = recv_mmsg(reader, &mut packets[..]).await.unwrap();
69        assert_eq!(32, recv);
70    }
71
72    #[tokio::test]
73    async fn test_send_from_addr() {
74        let addr_str = "0.0.0.0:50100";
75        let addr = addr_str.parse().unwrap();
76        let socket = solana_net_utils::bind_with_any_port_with_config(
77            IpAddr::V4(Ipv4Addr::UNSPECIFIED),
78            SocketConfig::default(),
79        )
80        .unwrap();
81        let connection = UdpClientConnection::new_from_addr(socket, addr);
82        let reader = bind_to_async(
83            addr.ip(),
84            /*port*/ addr.port(),
85            /*reuseport:*/ false,
86        )
87        .await
88        .expect("bind");
89        check_send_one(&connection, &reader).await;
90        check_send_batch(&connection, &reader).await;
91    }
92}