feat(iota-sdk): add GovernanceApi::{get_timelocked_stakes, get_validators_apy}

crates/iota-sdk/examples/transaction_builder/timelocked_stake.rs

@@ -8,7 +8,6 @@
 #[path = "../utils.rs"]
 mod utils;
 
-use iota_json_rpc_api::GovernanceReadApiClient;
 use iota_json_rpc_types::{IotaObjectDataFilter, IotaObjectDataOptions, IotaObjectResponseQuery};
 use iota_keys::keystore::{AccountKeystore, FileBasedKeystore, Keystore};
 use iota_sdk::{
@@ -115,7 +114,10 @@ async fn main() -> Result<(), anyhow::Error> {
     tokio::time::sleep(std::time::Duration::from_secs(3)).await;
 
     // Check DelegatedTimelockedStake object
-    let staked_iota = client.http().get_timelocked_stakes(address).await?;
+    let staked_iota = client
+        .governance_api()
+        .get_timelocked_stakes(address)
+        .await?;
     println!("Staked: {staked_iota:?}\n\n");
 
     // Unstake timelocked IOTA, if staking for longer than 1 epoch already
@@ -171,7 +173,10 @@ async fn main() -> Result<(), anyhow::Error> {
         tokio::time::sleep(std::time::Duration::from_secs(3)).await;
 
         // Check DelegatedTimelockedStake object
-        let staked_iota = client.http().get_timelocked_stakes(address).await?;
+        let staked_iota = client
+            .governance_api()
+            .get_timelocked_stakes(address)
+            .await?;
         println!("Staked: {staked_iota:?}");
     } else {
         println!("No stake found that can be unlocked (must be staked >= 1 epoch)")

crates/iota-sdk/src/apis/governance.rs

@@ -5,7 +5,7 @@
 use std::sync::Arc;
 
 use iota_json_rpc_api::GovernanceReadApiClient;
-use iota_json_rpc_types::{DelegatedStake, IotaCommittee};
+use iota_json_rpc_types::{DelegatedStake, DelegatedTimelockedStake, IotaCommittee, ValidatorApys};
 use iota_types::{
     base_types::IotaAddress, iota_serde::BigInt,
     iota_system_state::iota_system_state_summary::IotaSystemStateSummary,
@@ -29,6 +29,14 @@ impl GovernanceApi {
         Ok(self.api.http.get_stakes(owner).await?)
     }
 
+    /// Get a list of delegated timelocked stakes for the given address.
+    pub async fn get_timelocked_stakes(
+        &self,
+        owner: IotaAddress,
+    ) -> IotaRpcResult<Vec<DelegatedTimelockedStake>> {
+        Ok(self.api.http.get_timelocked_stakes(owner).await?)
+    }
+
     /// Get committee information for the given epoch.
     ///
     /// The epoch defaults to the current epoch.
@@ -76,4 +84,9 @@ impl GovernanceApi {
     pub async fn get_reference_gas_price(&self) -> IotaRpcResult<u64> {
         Ok(*self.api.http.get_reference_gas_price().await?)
     }
+
+    /// Get the validators APY.
+    pub async fn get_validators_apy(&self) -> IotaRpcResult<ValidatorApys> {
+        Ok(self.api.http.get_validators_apy().await?)
+    }
 }