feat(rust/rbac-registration): Add provider trait for RegistrationChain (#586)

* initial

* feat: provider

* feat: update chain

* feat: start_new_chain

* feat: merge validation result struct into cip509

* feat: exports

* feat: return new chain

* chore: return success object

* fix: older version

* feat: cat id in payload

* fix: new version

* chore: lintfix

* chore: remove persistent arguments

* tmp

* chore: complete moving to central module

* feat: ref fn

* chore: merge methods

* chore: minor

* feat: export modified chains

* chore: minor comment

* chore: rbac update logic

* chore: isolation

* chore: validation and lintfix

* docs: remove error doc

* chore: minor refactor

* fix: comments

* chore: validation function return

* Update rust/rbac-registration/src/providers.rs

Co-authored-by: Alex Pozhylenkov <[email protected]>

---------

Co-authored-by: Alex Pozhylenkov <[email protected]>

Author: apskhem

rust/rbac-registration/src/cardano/cip509/cip509.rs

@@ -13,7 +13,7 @@ use cardano_blockchain_types::{
     pallas_addresses::{Address, ShelleyAddress},
     pallas_primitives::{conway, Nullable},
     pallas_traverse::MultiEraTx,
-    MetadatumLabel, MultiEraBlock, TxnIndex,
+    MetadatumLabel, MultiEraBlock, StakeAddress, TxnIndex,
 };
 use catalyst_types::{
     catalyst_id::{role_index::RoleId, CatalystId},
@@ -305,6 +305,14 @@ impl Cip509 {
         self.metadata.as_ref()
     }
 
+    /// Returns a set of stake addresses.
+    #[must_use]
+    pub fn stake_addresses(&self) -> HashSet<StakeAddress> {
+        self.certificate_uris()
+            .map(Cip0134UriSet::stake_addresses)
+            .unwrap_or_default()
+    }
+
     /// Returns `Cip509` fields consuming the structure if it was successfully decoded and
     /// validated otherwise return the problem report that contains all the encountered
     /// issues.

rust/rbac-registration/src/lib.rs

@@ -1,6 +1,7 @@
 //! This crate provides functionalities for RBAC registration.
 
 pub mod cardano;
+pub mod providers;
 pub mod registration;
 
 mod utils;

rust/rbac-registration/src/providers.rs

@@ -0,0 +1,47 @@
+//! Providers traits, which are used during different validation procedures.
+
+use std::future::Future;
+
+use cardano_blockchain_types::{hashes::TransactionId, StakeAddress};
+use catalyst_types::catalyst_id::CatalystId;
+use ed25519_dalek::VerifyingKey;
+
+use crate::registration::cardano::RegistrationChain;
+
+/// `RegistrationChain` Provider trait
+pub trait RbacRegistrationProvider {
+    /// Returns registration chain
+    /// for the given Catalyst ID.
+    fn chain(
+        &self,
+        id: CatalystId,
+    ) -> impl Future<Output = anyhow::Result<Option<RegistrationChain>>> + Send;
+
+    /// Returns `true` if a chain with the given Catalyst ID already exists.
+    ///
+    /// This function behaves in the same way as `latest_rbac_chain(...).is_some()` but
+    /// the implementation is more optimized because we don't need to build the whole
+    /// chain.
+    fn is_chain_known(
+        &self,
+        id: CatalystId,
+    ) -> impl Future<Output = anyhow::Result<bool>> + Send;
+
+    /// Returns a Catalyst ID corresponding to the given stake address.
+    fn catalyst_id_from_stake_address(
+        &self,
+        address: &StakeAddress,
+    ) -> impl Future<Output = anyhow::Result<Option<CatalystId>>> + Send;
+
+    /// Returns a Catalyst ID corresponding to the given public key.
+    fn catalyst_id_from_public_key(
+        &self,
+        key: VerifyingKey,
+    ) -> impl Future<Output = anyhow::Result<Option<CatalystId>>> + Send;
+
+    /// Returns a Catalyst ID corresponding to the given transaction hash.
+    fn catalyst_id_from_txn_id(
+        &self,
+        txn_id: TransactionId,
+    ) -> impl Future<Output = anyhow::Result<Option<CatalystId>>> + Send;
+}