oskr 1.0.0-rc.5

High performance distributed works collection
Documentation 
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

use serde_derive::{Deserialize, Serialize};

use crate::common::{
    signed::SignedMessage, ClientId, Digest, OpNumber, Opaque, ReplicaId, RequestNumber, ViewNumber,
};

#[derive(Debug, Clone, Serialize, Deserialize)]
pub enum ToReplica {
    // we skip sign/verify request messages, following convention
    // besides performance issue, it is also hard to register client's identity
    // at runtime
    Request(Request),
    RelayedRequest(Request), // remote address ignored

    PrePrepare(SignedMessage<PrePrepare>), // request batch piggybacked
    Prepare(SignedMessage<Prepare>),
    Commit(SignedMessage<Commit>),
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Request {
    pub op: Opaque,
    pub request_number: RequestNumber,
    pub client_id: ClientId,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Reply {
    pub view_number: ViewNumber,
    pub request_number: RequestNumber,
    pub client_id: ClientId, // following pbft paper, but why we need this?
    pub replica_id: ReplicaId,
    pub result: Opaque,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct PrePrepare {
    pub view_number: ViewNumber,
    pub op_number: OpNumber,
    pub digest: Digest,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Prepare {
    pub view_number: ViewNumber,
    pub op_number: OpNumber,
    pub digest: Digest,
    pub replica_id: ReplicaId,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Commit {
    pub view_number: ViewNumber,
    pub op_number: OpNumber,
    pub digest: Digest,
    pub replica_id: ReplicaId,
}