1
syntax = "proto3";
2
package protocol;
3
 
4
option optimize_for = SPEED;
5
option go_package = "go.miragespace.co/specter/spec/protocol";
6
 
7
import "spec/proto/node.proto";
8
 
9
service VNodeService {
10
    rpc Identity(IdentityRequest) returns (IdentityResponse);
11
    rpc Ping(PingRequest) returns (PingResponse);
12
 
13
    rpc Notify(NotifyRequest) returns (NotifyResponse);
14
    rpc FindSuccessor(FindSuccessorRequest) returns (FindSuccessorResponse);
15
    rpc GetSuccessors(GetSuccessorsRequest) returns (GetSuccessorsResponse);
16
    rpc GetPredecessor(GetPredecessorRequest) returns (GetPredecessorResponse);
17
 
18
    rpc RequestToJoin(RequestToJoinRequest) returns (RequestToJoinResponse);
19
    rpc FinishJoin(MembershipConclusionRequest) returns (MembershipConclusionResponse);
20
    rpc RequestToLeave(RequestToLeaveRequest) returns (RequestToLeaveResponse);
21
    rpc FinishLeave(MembershipConclusionRequest) returns (MembershipConclusionResponse);
22
}
23
 
24
message Empty {}
25
 
26
message IdentityRequest {}
27
 
28
message IdentityResponse {
29
    Node identity = 1;
30
}
31
 
32
message PingRequest {}
33
 
34
message PingResponse {}
35
 
36
message NotifyRequest {
37
    Node predecessor = 1;
38
}
39
 
40
message NotifyResponse {}
41
 
42
message FindSuccessorRequest {
43
    uint64 key = 1;
44
}
45
 
46
message FindSuccessorResponse {
47
    Node successor = 1;
48
}
49
 
50
message GetPredecessorRequest {}
51
 
52
message GetPredecessorResponse {
53
    Node predecessor = 1;
54
}
55
 
56
message GetSuccessorsRequest {}
57
 
58
message GetSuccessorsResponse {
59
    repeated Node successors = 1;
60
}
61
 
62
message RequestToJoinRequest {
63
    Node joiner = 1;
64
}
65
 
66
message RequestToJoinResponse {
67
    Node predecessor = 1;
68
    repeated Node successors = 2;
69
}
70
 
71
message RequestToLeaveRequest {
72
    Node leaver = 1;
73
}
74
 
75
message RequestToLeaveResponse {}
76
 
77
message MembershipConclusionRequest {
78
    bool stabilize = 1;
79
    bool release = 2;
80
}
81
 
82
message MembershipConclusionResponse {}