protocol_version.rs 3.7 KB

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