protocol_version.rs 3.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798
  1. use futures::FutureExt;
  2. use log::*;
  3. use smol::Executor;
  4. use std::sync::Arc;
  5. use crate::net::error::{NetError, NetResult};
  6. use crate::net::message_subscriber::MessageSubscription;
  7. use crate::net::messages;
  8. use crate::net::utility::sleep;
  9. use crate::net::{ChannelPtr, SettingsPtr};
  10. /// Protocol for version information handshake between nodes at the start of a connection.
  11. pub struct ProtocolVersion {
  12. channel: ChannelPtr,
  13. version_sub: MessageSubscription<messages::VersionMessage>,
  14. verack_sub: MessageSubscription<messages::VerackMessage>,
  15. settings: SettingsPtr,
  16. }
  17. impl ProtocolVersion {
  18. /// Create a new version protocol. Makes a version and version acknowledgement subscription,
  19. /// then adds them to a version protocol instance.
  20. pub async fn new(channel: ChannelPtr, settings: SettingsPtr) -> Arc<Self> {
  21. // Creates a version subscription.
  22. let version_sub = channel
  23. .clone()
  24. .subscribe_msg::<messages::VersionMessage>()
  25. .await
  26. .expect("Missing version dispatcher!");
  27. // Creates a version acknowledgement subscription.
  28. let verack_sub = channel
  29. .clone()
  30. .subscribe_msg::<messages::VerackMessage>()
  31. .await
  32. .expect("Missing verack dispatcher!");
  33. Arc::new(Self {
  34. channel,
  35. version_sub,
  36. verack_sub,
  37. settings,
  38. })
  39. }
  40. /// Start version information exchange. Start the timer. Send version info and wait for version
  41. /// acknowledgement. Wait for version info and send version acknowledgement.
  42. pub async fn run(self: Arc<Self>, executor: Arc<Executor<'_>>) -> NetResult<()> {
  43. debug!(target: "net", "ProtocolVersion::run() [START]");
  44. // Start timer
  45. // Send version, wait for verack
  46. // Wait for version, send verack
  47. // Fin.
  48. let result = futures::select! {
  49. _ = self.clone().exchange_versions(executor).fuse() => Ok(()),
  50. _ = sleep(self.settings.channel_handshake_seconds).fuse() => Err(NetError::ChannelTimeout)
  51. };
  52. debug!(target: "net", "ProtocolVersion::run() [END]");
  53. result
  54. }
  55. /// Send and recieve version information.
  56. async fn exchange_versions(self: Arc<Self>, executor: Arc<Executor<'_>>) -> NetResult<()> {
  57. debug!(target: "net", "ProtocolVersion::exchange_versions() [START]");
  58. let send = executor.spawn(self.clone().send_version());
  59. let recv = executor.spawn(self.recv_version());
  60. send.await.and(recv.await)?;
  61. debug!(target: "net", "ProtocolVersion::exchange_versions() [END]");
  62. Ok(())
  63. }
  64. /// Send version info and wait for version acknowledgement.
  65. async fn send_version(self: Arc<Self>) -> NetResult<()> {
  66. debug!(target: "net", "ProtocolVersion::send_version() [START]");
  67. let version = messages::VersionMessage {};
  68. self.channel.clone().send(version).await?;
  69. // Wait for version acknowledgement
  70. let _verack_msg = self.verack_sub.receive().await?;
  71. debug!(target: "net", "ProtocolVersion::send_version() [END]");
  72. Ok(())
  73. }
  74. /// Recieve version info, check the message is okay and send version acknowledgement.
  75. async fn recv_version(self: Arc<Self>) -> NetResult<()> {
  76. debug!(target: "net", "ProtocolVersion::recv_version() [START]");
  77. // Rec
  78. let _version_msg = self.version_sub.receive().await?;
  79. // Check the message is OK
  80. // Send version acknowledgement
  81. let verack = messages::VerackMessage {};
  82. self.channel.clone().send(verack).await?;
  83. debug!(target: "net", "ProtocolVersion::recv_version() [END]");
  84. Ok(())
  85. }
  86. }