ex3_secret_vault_client/
lib.rs

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
use async_trait::async_trait;
use ex3_canister_client::{ActorResult, CanisterResult};
use ex3_node_types::range::CandidRange;
use ex3_node_types::{secret::SecretPublicKeyPocket, CandidBlockHeight, CandidWalletRegisterId};
use ex3_secret_vault_public_types::{ShardingReportProgressInfo, ShardingSubReport};
use std::collections::HashMap;

#[cfg(feature = "mock")]
pub mod mock;

#[cfg(feature = "canister")]
pub mod canister_impl;
#[cfg(feature = "agent")]
pub mod client_impl;

#[async_trait]
pub trait SecretVault: Send + Sync {
    async fn get_current_block_height(&self) -> CanisterResult<CandidBlockHeight>;
    async fn get_current_snapshot_height(&self) -> CanisterResult<Option<CandidBlockHeight>>;
    async fn apply_to_be_a_submitter(
        &self,
        height: CandidBlockHeight,
    ) -> CanisterResult<ActorResult<()>>;
    async fn submit_sharding_sub_report(
        &self,
        block_height: CandidBlockHeight,
        sub_report: ShardingSubReport,
    ) -> CanisterResult<ActorResult<()>>;
    async fn validate_or_drop_sharding_report(
        &self,
        block_height: CandidBlockHeight,
    ) -> CanisterResult<ActorResult<()>>;
    async fn commit_sharding_report(
        &self,
        block_height: CandidBlockHeight,
    ) -> CanisterResult<ActorResult<bool>>;
    async fn get_wallet_secret_public_key_pocket(
        &self,
        wallet: CandidWalletRegisterId,
        block_height: Option<CandidBlockHeight>,
    ) -> CanisterResult<ActorResult<SecretPublicKeyPocket>>;
    async fn get_wallet_pub_key_pocket_by_range(
        &self,
        wallet_id_range: CandidRange<CandidWalletRegisterId>,
        block_height: Option<CandidBlockHeight>,
    ) -> CanisterResult<ActorResult<HashMap<CandidWalletRegisterId, SecretPublicKeyPocket>>>;

    async fn get_sharding_report_progress_info(&self)
        -> CanisterResult<ShardingReportProgressInfo>;

    #[cfg(feature = "canister")]
    async fn sync_node_provider(
        &self,
        full_sync_request: ex3_core_registry_public_types::NodeProviderFullSyncRequest,
    ) -> CanisterResult<ActorResult<()>>;

    #[cfg(feature = "canister")]
    async fn accept_node_provider_update(
        &self,
        incremental_sync_request: ex3_core_registry_public_types::NodeProviderIncrementalSyncRequest,
    ) -> CanisterResult<ActorResult<()>>;
}