adding staking providers and tos (#15)

SUPPORTED_ENDPOINTS.md

@@ -48,8 +48,8 @@
 | GET /staking/positions/summary                             | ✓ |
 | GET /staking/positions/summary/vaults                      | ✗ |
 | GET /staking/positions/{id}                                | ✗ |
-| GET /staking/providers                                     | ✗ |
-| POST /staking/providers/{providerId}/approveTermsOfService | ✗ |
+| GET /staking/providers                                     | ✓ |
+| POST /staking/providers/{providerId}/approveTermsOfService | ✓ |
 
 
 ## Exchange accounts

src/api/staking.rs

@@ -1,4 +1,5 @@
 use crate::client::Client;
+use crate::types::StakingProvider;
 use crate::{
   types::{
     asset::SupportedAsset,
@@ -15,6 +16,34 @@ impl Client {
     self.get(u).await
   }
 
+  /// Get info about available providers
+  ///
+  /// See
+  ///
+  /// * [getProviders](https://docs.fireblocks.com/api/swagger-ui/#/Staking%20(Beta)/getProviders)
+  #[tracing::instrument(level = "debug", skip(self))]
+  pub async fn staking_providers(&self) -> Result<Vec<StakingProvider>> {
+    let u = self.build_url("staking/providers")?.0;
+    self.get(u).await
+  }
+
+  /// Approve TOS for a provider
+  ///
+  /// See
+  ///
+  /// * [approveTermsOfServiceByProviderId](https://docs.fireblocks.com/api/swagger-ui/#/Staking%20(Beta)/approveTermsOfServiceByProviderId)
+  #[tracing::instrument(level = "debug", skip(self))]
+  pub async fn staking_accept_terms(&self, provider_id: &str) -> Result<()> {
+    let u = self.build_url(format!("staking/providers/{provider_id}/approveTermsOfService"))?.0;
+    let id = self.post::<serde_json::Value, ()>(u, None).await?.1;
+    Ok(((), id))
+  }
+
+  /// Get available chains
+  ///
+  /// See
+  ///
+  /// * [getChains](https://docs.fireblocks.com/api/swagger-ui/#/Staking%20(Beta)/getChains)
   #[tracing::instrument(level = "debug", skip(self))]
   pub async fn staking_chains(&self) -> Result<Vec<Asset>> {
     let u = self.build_url("staking/chains")?.0;

src/lib.rs

@@ -438,6 +438,11 @@ mod tests {
     assert!(!chains.is_empty());
     c.staking_positions().await?;
     c.staking_positions_summary().await?;
+    let providers = c.staking_providers().await?.0;
+    assert!(!providers.is_empty());
+    for p in providers {
+      c.staking_accept_terms(&p.id).await?;
+    }
 
     for chain in [ASSET_SOL, ASSET_SOL_TEST, ASSET_ETH, ASSET_ETH_TEST] {
       c.staking_chain_info(&chain).await?;

src/types/staking.rs

@@ -86,17 +86,29 @@ pub struct StakingAmounts {
 #[derive(Debug, Deserialize, Default)]
 #[serde(rename_all = "camelCase")]
 pub struct StakingAdditionalInfo {
-  estimated_annual_reward: BigDecimal,
-  lockup_period: u64,
-  activation_period: u64,
+  pub estimated_annual_reward: BigDecimal,
+  pub lockup_period: u64,
+  pub activation_period: u64,
 }
 
 #[derive(Debug, Deserialize, Default)]
 #[serde(rename_all = "camelCase")]
 pub struct StakingChainInfo {
-  chain_descriptor: Asset,
-  current_epoch: u64,
-  epoch_elapsed: f64,
-  epoch_duration: u64,
-  additional_info: StakingAdditionalInfo,
+  pub chain_descriptor: Asset,
+  pub current_epoch: u64,
+  pub epoch_elapsed: f64,
+  pub epoch_duration: u64,
+  pub additional_info: StakingAdditionalInfo,
+}
+
+#[derive(Debug, Deserialize, Default)]
+#[serde(rename_all = "camelCase")]
+pub struct StakingProvider {
+  pub id: String,
+  #[serde(rename = "providerName")]
+  pub name: String,
+  pub icon_url: String,
+  pub terms_of_service_url: String,
+  #[serde(rename = "isTermsOfServiceApproved")]
+  pub terms_of_service_approved: bool,
 }