2019-09-12 03:36:50 -07:00
|
|
|
//! An address-with-metadata type used in Bitcoin networking.
|
|
|
|
|
2019-09-25 16:20:02 -07:00
|
|
|
use std::io::{Read, Write};
|
2019-09-12 03:36:50 -07:00
|
|
|
use std::net::SocketAddr;
|
|
|
|
|
2019-09-25 16:20:02 -07:00
|
|
|
use byteorder::{LittleEndian, ReadBytesExt, WriteBytesExt};
|
|
|
|
use chrono::{DateTime, TimeZone, Utc};
|
|
|
|
|
|
|
|
use zebra_chain::serialization::{
|
|
|
|
ReadZcashExt, SerializationError, WriteZcashExt, ZcashDeserialize, ZcashSerialize,
|
|
|
|
};
|
|
|
|
|
2019-09-30 11:40:44 -07:00
|
|
|
use crate::protocol::types::PeerServices;
|
2019-09-12 03:36:50 -07:00
|
|
|
|
|
|
|
/// An address with metadata on its advertised services and last-seen time.
|
2019-09-19 09:38:02 -07:00
|
|
|
///
|
2019-09-12 03:36:50 -07:00
|
|
|
/// [Bitcoin reference](https://en.bitcoin.it/wiki/Protocol_documentation#Network_address)
|
2019-09-25 13:31:41 -07:00
|
|
|
// XXX determine whether we will use this struct in *our* networking handling
|
|
|
|
// code, or just in the definitions of the networking protocol (in which case
|
|
|
|
// it should live in the protocol submodule)
|
2019-09-15 12:11:07 -07:00
|
|
|
#[derive(Copy, Clone, Debug, Eq, PartialEq)]
|
2019-09-12 03:36:50 -07:00
|
|
|
pub struct MetaAddr {
|
|
|
|
/// The peer's address.
|
2019-09-14 08:56:43 -07:00
|
|
|
pub addr: SocketAddr,
|
|
|
|
/// The services advertised by the peer.
|
2019-09-30 11:40:44 -07:00
|
|
|
pub services: PeerServices,
|
2019-09-14 08:56:43 -07:00
|
|
|
/// When the peer was last seen.
|
|
|
|
pub last_seen: DateTime<Utc>,
|
2019-09-12 03:36:50 -07:00
|
|
|
}
|
2019-09-25 16:20:02 -07:00
|
|
|
|
|
|
|
impl ZcashSerialize for MetaAddr {
|
|
|
|
fn zcash_serialize<W: Write>(&self, mut writer: W) -> Result<(), SerializationError> {
|
|
|
|
writer.write_u32::<LittleEndian>(self.last_seen.timestamp() as u32)?;
|
|
|
|
writer.write_u64::<LittleEndian>(self.services.0)?;
|
|
|
|
writer.write_socket_addr(self.addr)?;
|
|
|
|
Ok(())
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
impl ZcashDeserialize for MetaAddr {
|
|
|
|
fn zcash_deserialize<R: Read>(mut reader: R) -> Result<Self, SerializationError> {
|
|
|
|
Ok(MetaAddr {
|
|
|
|
last_seen: Utc.timestamp(reader.read_u32::<LittleEndian>()? as i64, 0),
|
2019-09-30 11:40:44 -07:00
|
|
|
services: PeerServices(reader.read_u64::<LittleEndian>()?),
|
2019-09-25 16:20:02 -07:00
|
|
|
addr: reader.read_socket_addr()?,
|
|
|
|
})
|
|
|
|
}
|
|
|
|
}
|