[Rust SDK] - expose ws ping duration config to SuiClientBuilder (Myst…

…enLabs#13936)

## Description 

expose ws ping duration config to SuiClientBuilder.

User can use this setting to prevent inactive WS subscription got
disconnected due to proxy timeout

## Test Plan 

Manual test

---
If your changes are not user-facing and not a breaking change, you can
skip the following section. Otherwise, please indicate what changed, and
then add to the Release Notes section as highlighted during the release
process.

### Type of Change (Check all that apply)

- [ ] protocol change
- [ ] user-visible impact
- [ ] breaking change for a client SDKs
- [ ] breaking change for FNs (FN binary must upgrade)
- [ ] breaking change for validators or node operators (must upgrade
binaries)
- [ ] breaking change for on-chain data layout
- [ ] necessitate either a data wipe or data migration

### Release notes

Expose WS ping duration config to SuiClientBuilder, user can use this
setting to prevent inactive WS subscription got disconnected due to
proxy timeout.

crates/sui-sdk/src/lib.rs

@@ -104,6 +104,7 @@ pub mod error;
 pub mod json_rpc_error;
 pub mod sui_client_config;
 pub mod wallet_context;
+
 pub const SUI_COIN_TYPE: &str = "0x2::sui::SUI";
 pub const SUI_LOCAL_NETWORK_URL: &str = "http://127.0.0.1:9000";
 pub const SUI_LOCAL_NETWORK_GAS_URL: &str = "http://127.0.0.1:5003/gas";
@@ -115,6 +116,9 @@ pub const SUI_TESTNET_URL: &str = "https://fullnode.testnet.sui.io:443";
 /// By default the `maximum concurrent requests` is set to 256 and
 /// the `request timeout` is set to 60 seconds. These can be adjusted using the
 /// `max_concurrent_requests` function, and the `request_timeout` function.
+/// If you use the WebSocket, consider setting the `ws_ping_interval` field to a
+/// value of your choice to prevent the inactive WS subscription being
+/// disconnected due to proxy timeout.
 ///
 /// # Examples
 ///
@@ -134,6 +138,7 @@ pub struct SuiClientBuilder {
     request_timeout: Duration,
     max_concurrent_requests: usize,
     ws_url: Option<String>,
+    ws_ping_interval: Option<Duration>,
 }
 
 impl Default for SuiClientBuilder {
@@ -142,6 +147,7 @@ impl Default for SuiClientBuilder {
             request_timeout: Duration::from_secs(60),
             max_concurrent_requests: 256,
             ws_url: None,
+            ws_ping_interval: None,
         }
     }
 }
@@ -165,6 +171,12 @@ impl SuiClientBuilder {
         self
     }
 
+    /// Set the WebSocket ping interval
+    pub fn ws_ping_interval(mut self, duration: Duration) -> Self {
+        self.ws_ping_interval = Some(duration);
+        self
+    }
+
     /// Returns a [SuiClient] object connected to the Sui network running at the URI provided.
     ///
     /// # Examples
@@ -197,15 +209,17 @@ impl SuiClientBuilder {
         headers.insert(CLIENT_SDK_TYPE_HEADER, HeaderValue::from_static("rust"));
 
         let ws = if let Some(url) = self.ws_url {
-            Some(
-                WsClientBuilder::default()
-                    .max_request_body_size(2 << 30)
-                    .max_concurrent_requests(self.max_concurrent_requests)
-                    .set_headers(headers.clone())
-                    .request_timeout(self.request_timeout)
-                    .build(url)
-                    .await?,
-            )
+            let mut builder = WsClientBuilder::default()
+                .max_request_body_size(2 << 30)
+                .max_concurrent_requests(self.max_concurrent_requests)
+                .set_headers(headers.clone())
+                .request_timeout(self.request_timeout);
+
+            if let Some(duration) = self.ws_ping_interval {
+                builder = builder.ping_interval(duration)
+            }
+
+            Some(builder.build(url).await?)
         } else {
             None
         };
@@ -391,7 +405,6 @@ impl SuiClientBuilder {
 ///     Ok(())
 /// }
 /// ```
-
 #[derive(Clone)]
 pub struct SuiClient {
     api: Arc<RpcClient>,