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

use async_trait::async_trait;
use candid::{Nat, Principal};
use ex3_blockchain_public_types::{
    BlockHeadResponse, BlockHeadWithHeight, CandidConsensusReport, SnapshotVaultCursor,
};
use ex3_canister_types::{BlockHash, BlockHeight};

use ex3_canister_client::{ActorResult, CanisterResult};

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

#[async_trait]
pub trait Blockchain: Send + Sync {
    async fn get_current_block_height(&self) -> CanisterResult<Option<BlockHeight>>;
    async fn chain_length(&self) -> CanisterResult<Nat>;
    async fn get_genesis_block_hash(&self) -> CanisterResult<BlockHash>;
    async fn get_block_head_by_height(
        &self,
        height: &BlockHeight,
    ) -> CanisterResult<BlockHeadResponse>;
    async fn get_last_block_head(&self) -> CanisterResult<Option<BlockHeadWithHeight>>;
    async fn submit_consensus_report(
        &self,
        block_head: CandidConsensusReport,
    ) -> CanisterResult<ActorResult<()>>;
    async fn get_snapshot_vault_cursor_by_height(
        &self,
        height: BlockHeight,
    ) -> CanisterResult<ActorResult<SnapshotVaultCursor>>;
    #[cfg(feature = "canister")]
    async fn accept_node_provider_update(
        &self,
        providers: Vec<Principal>,
        vote_threshold: u8,
    ) -> CanisterResult<ActorResult<()>>;
}