forked from TrueCloudLab/frostfs-api
[#143] Add proto definitions of Reputation service
Define `Trust` message structure. Define `ReputationService` service. Add `SendLocalTrust` RPC to `ReputationService`. Define structures of request and response messages. Signed-off-by: Leonard Lyubich <leonard@nspcc.ru>
This commit is contained in:
parent
10278f741a
commit
b334bada34
2 changed files with 79 additions and 0 deletions
61
reputation/service.proto
Normal file
61
reputation/service.proto
Normal file
|
@ -0,0 +1,61 @@
|
|||
syntax = "proto3";
|
||||
|
||||
package neo.fs.v2.reputation;
|
||||
|
||||
option go_package = "github.com/nspcc-dev/neofs-api-go/v2/reputation/grpc;reputation";
|
||||
option csharp_namespace = "Neo.FileStorage.API.Reputation";
|
||||
|
||||
import "reputation/types.proto";
|
||||
import "session/types.proto";
|
||||
|
||||
// `ReputationService` provides mechanisms for exchanging
|
||||
// trust values within NeoFS Reputation system .
|
||||
service ReputationService {
|
||||
// Sends local client trust to any peer from NeoFS network.
|
||||
rpc SendLocalTrust (SendLocalTrustRequest) returns (SendLocalTrustResponse);
|
||||
}
|
||||
|
||||
// Request to send local trust.
|
||||
message SendLocalTrustRequest {
|
||||
// Request body structure.
|
||||
message Body {
|
||||
// The number of the epoch in which the trust was assessed.
|
||||
uint64 epoch = 1;
|
||||
|
||||
// List of normalized local trust values of the client to the NeoFS peers.
|
||||
// The value is calculated according to EigenTrust++ algorithm
|
||||
// and must be in the range [0;1].
|
||||
repeated Trust trusts = 2;
|
||||
}
|
||||
|
||||
// Body of the request message.
|
||||
Body body = 1;
|
||||
|
||||
// Carries request meta information. Header data is used only to regulate
|
||||
// message transport and does not affect request execution.
|
||||
neo.fs.v2.session.RequestMetaHeader meta_header = 2;
|
||||
|
||||
// Carries request verification information. This header is used to
|
||||
// authenticate the nodes of the message route and check the correctness of
|
||||
// transmission.
|
||||
neo.fs.v2.session.RequestVerificationHeader verify_header = 3;
|
||||
}
|
||||
|
||||
// Response to request to send local trust.
|
||||
message SendLocalTrustResponse {
|
||||
// Response body structure.
|
||||
message Body {
|
||||
}
|
||||
|
||||
// Body of the response message.
|
||||
Body body = 1;
|
||||
|
||||
// Carries response meta information. Header data is used only to regulate
|
||||
// message transport and does not affect request execution.
|
||||
neo.fs.v2.session.ResponseMetaHeader meta_header = 2;
|
||||
|
||||
// Carries response verification information. This header is used to
|
||||
// authenticate the nodes of the message route and check the correctness of
|
||||
// transmission.
|
||||
neo.fs.v2.session.ResponseVerificationHeader verify_header = 3;
|
||||
}
|
18
reputation/types.proto
Normal file
18
reputation/types.proto
Normal file
|
@ -0,0 +1,18 @@
|
|||
syntax = "proto3";
|
||||
|
||||
package neo.fs.v2.reputation;
|
||||
|
||||
option go_package = "github.com/nspcc-dev/neofs-api-go/v2/reputation/grpc;reputation";
|
||||
option csharp_namespace = "Neo.FileStorage.API.Reputation";
|
||||
|
||||
// Trust value to NeoFS network peer.
|
||||
message Trust {
|
||||
// Identifier of the trusted peer.
|
||||
//
|
||||
// For storage nodes, it is the node's public key
|
||||
// fixed in the network map.
|
||||
bytes peer = 1 [json_name = "peer"];
|
||||
|
||||
// Trust value.
|
||||
double value = 2 [json_name = "value"];
|
||||
}
|
Loading…
Reference in a new issue