Merge pull request #3 from nspcc-dev/documentation

Prepare documentation for NeoFS Proto library

.github/markdown.tmpl

@@ -0,0 +1,83 @@
+# Protocol Documentation
+<a name="top"></a>
+
+## Table of Contents
+{{range .Files}}
+{{$file_name := .Name}}- [{{.Name}}](#{{.Name}})
+{{if .Services}} - Services
+    {{range .Services}}- [{{.Name}}](#{{.FullName}})
+    {{end}}{{end}}
+{{if .Messages}}  - Messages
+    {{range .Messages}}- [{{.LongName}}](#{{.FullName}})
+    {{end}}{{end}}
+{{end}}
+- [Scalar Value Types](#scalar-value-types)
+
+{{range .Files}}
+{{$file_name := .Name}}
+<a name="{{.Name}}"></a>
+<p align="right"><a href="#top">Top</a></p>
+
+## {{.Name}}
+{{.Description}}
+
+{{range .Services}}
+
+<a name="{{.FullName}}"></a>
+
+### Service "{{.FullName}}"
+{{.Description}}
+
+```
+{{range .Methods -}}
+  rpc {{.Name}}({{if .RequestStreaming}}stream {{end}}{{.RequestLongType}}) returns ({{if .ResponseStreaming}}stream {{end}}{{.ResponseLongType}});
+{{end}}
+```
+
+{{range .Methods -}}
+#### Method {{.Name}}
+
+{{.Description}}
+
+| Name | Input | Output |
+| ---- | ----- | ------ |
+| {{.Name}} | [{{.RequestLongType}}](#{{.RequestFullType}}) | [{{.ResponseLongType}}](#{{.ResponseFullType}}) |
+{{end}}{{end}} <!-- end services -->
+
+{{range .Messages}}
+<a name="{{.FullName}}"></a>
+
+### Message {{.LongName}}
+{{.Description}}
+
+{{if .HasFields}}
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+{{range .Fields -}}
+  | {{.Name}} | [{{.LongType}}](#{{.FullType}}) | {{.Label}} | {{nobr .Description}}{{if .DefaultValue}} Default: {{.DefaultValue}}{{end}} |
+{{end}}{{end}}
+{{end}} <!-- end messages -->
+
+{{range .Enums}}
+<a name="{{.FullName}}"></a>
+
+### {{.LongName}}
+{{.Description}}
+
+| Name | Number | Description |
+| ---- | ------ | ----------- |
+{{range .Values -}}
+  | {{.Name}} | {{.Number}} | {{nobr .Description}} |
+{{end}}
+
+{{end}} <!-- end enums -->
+
+{{end}}
+
+## Scalar Value Types
+
+| .proto Type | Notes | C++ Type | Java Type | Python Type |
+| ----------- | ----- | -------- | --------- | ----------- |
+{{range .Scalars -}}
+  | <a name="{{.ProtoType}}" /> {{.ProtoType}} | {{.Notes}} | {{.CppType}} | {{.JavaType}} | {{.PythonType}} |
+{{end}}

Makefile

@@ -1,3 +1,26 @@
+B=\033[0;1m
+G=\033[0;92m
+R=\033[0m
+
+# Reformat code
+format:
+	@[ ! -z `which goimports` ] || (echo "install goimports" && exit 2)
+	@for f in `find . -type f -name '*.go' -not -path './vendor/*' -not -name '*.pb.go' -prune`; do \
+		echo "${B}${G}⇒ Processing $$f ${R}"; \
+		goimports -w $$f; \
+	done
+
+# Regenerate documentation for protot files:
+docgen:
+	@for f in `find . -type f -name '*.proto' -not -path './vendor/*' -exec dirname {} \; | sort -u `; do \
+		echo "${B}${G}⇒ Documentation for $$(basename $$f) ${R}"; \
+		protoc \
+			--doc_opt=.github/markdown.tmpl,$${f}.md \
+			--proto_path=.:./vendor:/usr/local/include \
+			--doc_out=docs/ $${f}/*.proto; \
+	done
+
+# Regenerate proto files:
 protoc:
 	@go mod tidy -v
 	@go mod vendor
@@ -6,7 +29,9 @@ protoc:
 	# Install specific version for protobuf lib
 	@go list -f '{{.Path}}/...@{{.Version}}' -m  github.com/golang/protobuf | xargs go get -v
 	# Protoc generate
-	@find . -type f -name '*.proto' -not -path './vendor/*' \
+	@for f in `find . -type f -name '*.proto' -not -path './vendor/*'`; do \
-		-exec protoc \
+		echo "${B}${G}⇒ Processing $$f ${R}"; \
-		--proto_path=.:./vendor \
+		protoc \
-		--gofast_out=plugins=grpc,paths=source_relative:. '{}' \;
+			--proto_path=.:./vendor:/usr/local/include \
+			--gofast_out=plugins=grpc,paths=source_relative:. $$f; \
+	done

README.md

@@ -9,6 +9,8 @@ Repository contains 13 packages that implement NeoFS core structures. These
 packages mostly contain protobuf files with service and structure definitions 
 or NeoFS core types with complemented functions. 
 
+There is a auto-generated documentation for protobuf files in [docs](docs).
+
 ### Accounting
 
 Accounting package defines services and structures for accounting operations: 
@@ -17,11 +19,22 @@ with inner ring signatures, which approve that user can withdraw requested
 amount of assets. NeoFS smart contract takes binary formatted `cheque` as a 
 parameter in withdraw call. 
 
+#### API
+Accounting package defines: 
+- [Accounting service](docs/accounting.md#accounting.Accounting)
+- [Withdraw service](docs/accounting.md#accounting.Withdraw)
+
+
 ### Bootstrap
 
 Bootstrap package defines bootstrap service which is used by storage nodes to
 connect to the storage network. 
 
+#### API
+Bootstrap package defines:
+- [Bootstrap service](docs/bootstrap.md#bootstrap.Bootstrap)
+
+
 ### Chain
 
 Chain package contains util functions for operations with NEO Blockchain types:
@@ -33,6 +46,10 @@ Container package defines service and structures for operations with containers.
 Objects in NeoFS are stored in containers. Container defines storage 
 policy for the objects. 
 
+#### API
+Bootstrap package defines:
+- [Container service](docs/container.md#container.Service)
+
 ### Decimal
 
 Decimal defines custom decimal implementation which is used in accounting
@@ -53,6 +70,10 @@ Object package defines service and structures for object operations. Object is
 a core storage structure in NeoFS. Package contains detailed information
 about object internal structure.
 
+#### API
+Object package defines:
+- [Object service](docs/object.md#object.Service)
+
 ### Query
 
 Query package defines structure for object search requests. 
@@ -72,10 +93,18 @@ Session package defines service and structures for session obtain. Object
 operations require an established session with pair of session keys signed by 
 owner of the object. 
 
+#### API
+Session package defines:
+- [Session service](docs/session.md#session.Session)
+
 ### State
 
 State package defines service and structures for metrics gathering. 
 
+#### API
+State package defines:
+- [Status service](docs/state.md#state.Status)
+
 ## How to use
 
 NeoFS-proto packages contain godoc documentation. Examples of using most of 

accounting/service.pb.go

@@ -29,7 +29,9 @@ var _ = math.Inf
 const _ = proto.ProtoPackageIsVersion3 // please upgrade the proto package
 
 type BalanceRequest struct {
-	OwnerID              OwnerID  `protobuf:"bytes,1,opt,name=OwnerID,proto3,customtype=OwnerID" json:"OwnerID"`
+	// OwnerID is a wallet address
+	OwnerID OwnerID `protobuf:"bytes,1,opt,name=OwnerID,proto3,customtype=OwnerID" json:"OwnerID"`
+	// TTL must be larger than zero, it decreased in every neofs-node
 	TTL                  uint32   `protobuf:"varint,2,opt,name=TTL,proto3" json:"TTL,omitempty"`
 	XXX_NoUnkeyedLiteral struct{} `json:"-"`
 	XXX_unrecognized     []byte   `json:"-"`
@@ -73,11 +75,14 @@ func (m *BalanceRequest) GetTTL() uint32 {
 }
 
 type BalanceResponse struct {
-	Balance              *decimal.Decimal `protobuf:"bytes,1,opt,name=Balance,proto3" json:"Balance,omitempty"`
+	// Balance contains current account balance state
-	LockAccounts         []*Account       `protobuf:"bytes,2,rep,name=LockAccounts,proto3" json:"LockAccounts,omitempty"`
+	Balance *decimal.Decimal `protobuf:"bytes,1,opt,name=Balance,proto3" json:"Balance,omitempty"`
-	XXX_NoUnkeyedLiteral struct{}         `json:"-"`
+	// LockAccounts contains information about locked funds. Locked funds appear
-	XXX_unrecognized     []byte           `json:"-"`
+	// when user pays for storage or withdraw assets.
-	XXX_sizecache        int32            `json:"-"`
+	LockAccounts         []*Account `protobuf:"bytes,2,rep,name=LockAccounts,proto3" json:"LockAccounts,omitempty"`
+	XXX_NoUnkeyedLiteral struct{}   `json:"-"`
+	XXX_unrecognized     []byte     `json:"-"`
+	XXX_sizecache        int32      `json:"-"`
 }
 
 func (m *BalanceResponse) Reset()         { *m = BalanceResponse{} }
@@ -166,6 +171,7 @@ const _ = grpc.SupportPackageIsVersion4
 //
 // For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream.
 type AccountingClient interface {
+	// Balance returns current balance status of the NeoFS user
 	Balance(ctx context.Context, in *BalanceRequest, opts ...grpc.CallOption) (*BalanceResponse, error)
 }
 
@@ -188,6 +194,7 @@ func (c *accountingClient) Balance(ctx context.Context, in *BalanceRequest, opts
 
 // AccountingServer is the server API for Accounting service.
 type AccountingServer interface {
+	// Balance returns current balance status of the NeoFS user
 	Balance(context.Context, *BalanceRequest) (*BalanceResponse, error)
 }
 

accounting/service.proto

@@ -8,16 +8,24 @@ import "github.com/gogo/protobuf/gogoproto/gogo.proto";
 
 option (gogoproto.stable_marshaler_all) = true;
 
+// Accounting is a service that provides access for accounting balance
+// information
 service Accounting {
+    // Balance returns current balance status of the NeoFS user
     rpc Balance(BalanceRequest) returns (BalanceResponse);
 }
 
 message BalanceRequest {
+    // OwnerID is a wallet address
     bytes OwnerID = 1 [(gogoproto.customtype) = "OwnerID", (gogoproto.nullable) = false];
+    // TTL must be larger than zero, it decreased in every neofs-node
     uint32 TTL    = 2;
 }
 
 message BalanceResponse {
+    // Balance contains current account balance state
     decimal.Decimal Balance       = 1;
+    // LockAccounts contains information about locked funds. Locked funds appear
+    // when user pays for storage or withdraw assets.
     repeated Account LockAccounts = 2;
 }

accounting/types.pb.go

@@ -24,6 +24,7 @@ var _ = math.Inf
 // proto package needs to be updated.
 const _ = proto.ProtoPackageIsVersion3 // please upgrade the proto package
 
+// Unit can be Unlimited, based on NeoFS epoch or Neo block
 type Lifetime_Unit int32
 
 const (
@@ -49,9 +50,10 @@ func (x Lifetime_Unit) String() string {
 }
 
 func (Lifetime_Unit) EnumDescriptor() ([]byte, []int) {
-	return fileDescriptor_437c556d7375b726, []int{6, 0}
+	return fileDescriptor_437c556d7375b726, []int{4, 0}
 }
 
+// Type can be withdrawal, payIO or inner
 type Tx_Type int32
 
 const (
@@ -80,21 +82,27 @@ func (x Tx_Type) String() string {
 }
 
 func (Tx_Type) EnumDescriptor() ([]byte, []int) {
-	return fileDescriptor_437c556d7375b726, []int{7, 0}
+	return fileDescriptor_437c556d7375b726, []int{5, 0}
 }
 
-// Snapshot accounting messages
 type Account struct {
-	OwnerID              OwnerID          `protobuf:"bytes,1,opt,name=OwnerID,proto3,customtype=OwnerID" json:"OwnerID"`
+	// OwnerID is a wallet address
-	Address              string           `protobuf:"bytes,2,opt,name=Address,proto3" json:"Address,omitempty"`
+	OwnerID OwnerID `protobuf:"bytes,1,opt,name=OwnerID,proto3,customtype=OwnerID" json:"OwnerID"`
-	ParentAddress        string           `protobuf:"bytes,3,opt,name=ParentAddress,proto3" json:"ParentAddress,omitempty"`
+	// Address is identifier of accounting record
-	ActiveFunds          *decimal.Decimal `protobuf:"bytes,4,opt,name=ActiveFunds,proto3" json:"ActiveFunds,omitempty"`
+	Address string `protobuf:"bytes,2,opt,name=Address,proto3" json:"Address,omitempty"`
-	Lifetime             Lifetime         `protobuf:"bytes,5,opt,name=Lifetime,proto3" json:"Lifetime"`
+	// ParentAddress is identifier of parent accounting record
-	LockTarget           *LockTarget      `protobuf:"bytes,6,opt,name=LockTarget,proto3" json:"LockTarget,omitempty"`
+	ParentAddress string `protobuf:"bytes,3,opt,name=ParentAddress,proto3" json:"ParentAddress,omitempty"`
-	LockAccounts         []*Account       `protobuf:"bytes,7,rep,name=LockAccounts,proto3" json:"LockAccounts,omitempty"`
+	// ActiveFunds is amount of active (non locked) funds for account
-	XXX_NoUnkeyedLiteral struct{}         `json:"-"`
+	ActiveFunds *decimal.Decimal `protobuf:"bytes,4,opt,name=ActiveFunds,proto3" json:"ActiveFunds,omitempty"`
-	XXX_unrecognized     []byte           `json:"-"`
+	// Lifetime is time until account is valid (used for lock accounts)
-	XXX_sizecache        int32            `json:"-"`
+	Lifetime Lifetime `protobuf:"bytes,5,opt,name=Lifetime,proto3" json:"Lifetime"`
+	// LockTarget is the purpose of lock funds (it might be withdraw or payment for storage)
+	LockTarget *LockTarget `protobuf:"bytes,6,opt,name=LockTarget,proto3" json:"LockTarget,omitempty"`
+	// LockAccounts contains child accounts with locked funds
+	LockAccounts         []*Account `protobuf:"bytes,7,rep,name=LockAccounts,proto3" json:"LockAccounts,omitempty"`
+	XXX_NoUnkeyedLiteral struct{}   `json:"-"`
+	XXX_unrecognized     []byte     `json:"-"`
+	XXX_sizecache        int32      `json:"-"`
 }
 
 func (m *Account) Reset()         { *m = Account{} }
@@ -168,6 +176,7 @@ func (m *Account) GetLockAccounts() []*Account {
 	return nil
 }
 
+// LockTarget must be one of two options
 type LockTarget struct {
 	// Types that are valid to be assigned to Target:
 	//	*LockTarget_WithdrawTarget
@@ -252,8 +261,8 @@ func (*LockTarget) XXX_OneofWrappers() []interface{} {
 	}
 }
 
-// Snapshot balance messages
 type Balances struct {
+	// Accounts contains multiple account snapshots
 	Accounts             []Account `protobuf:"bytes,1,rep,name=Accounts,proto3" json:"Accounts"`
 	XXX_NoUnkeyedLiteral struct{}  `json:"-"`
 	XXX_unrecognized     []byte    `json:"-"`
@@ -296,9 +305,12 @@ func (m *Balances) GetAccounts() []Account {
 	return nil
 }
 
-// PayIn / PayOut messages
 type PayIO struct {
-	BlockID              uint64   `protobuf:"varint,1,opt,name=BlockID,proto3" json:"BlockID,omitempty"`
+	// BlockID contains id of the NEO block where withdraw or deposit
+	// call was invoked
+	BlockID uint64 `protobuf:"varint,1,opt,name=BlockID,proto3" json:"BlockID,omitempty"`
+	// Transactions contains all transactions that founded in block
+	// and used for PayIO
 	Transactions         []Tx     `protobuf:"bytes,2,rep,name=Transactions,proto3" json:"Transactions"`
 	XXX_NoUnkeyedLiteral struct{} `json:"-"`
 	XXX_unrecognized     []byte   `json:"-"`
@@ -348,124 +360,21 @@ func (m *PayIO) GetTransactions() []Tx {
 	return nil
 }
 
-// Clearing messages
-type Clearing struct {
-	Transactions         []Tx     `protobuf:"bytes,1,rep,name=Transactions,proto3" json:"Transactions"`
-	XXX_NoUnkeyedLiteral struct{} `json:"-"`
-	XXX_unrecognized     []byte   `json:"-"`
-	XXX_sizecache        int32    `json:"-"`
-}
-
-func (m *Clearing) Reset()         { *m = Clearing{} }
-func (m *Clearing) String() string { return proto.CompactTextString(m) }
-func (*Clearing) ProtoMessage()    {}
-func (*Clearing) Descriptor() ([]byte, []int) {
-	return fileDescriptor_437c556d7375b726, []int{4}
-}
-func (m *Clearing) XXX_Unmarshal(b []byte) error {
-	return m.Unmarshal(b)
-}
-func (m *Clearing) XXX_Marshal(b []byte, deterministic bool) ([]byte, error) {
-	b = b[:cap(b)]
-	n, err := m.MarshalToSizedBuffer(b)
-	if err != nil {
-		return nil, err
-	}
-	return b[:n], nil
-}
-func (m *Clearing) XXX_Merge(src proto.Message) {
-	xxx_messageInfo_Clearing.Merge(m, src)
-}
-func (m *Clearing) XXX_Size() int {
-	return m.Size()
-}
-func (m *Clearing) XXX_DiscardUnknown() {
-	xxx_messageInfo_Clearing.DiscardUnknown(m)
-}
-
-var xxx_messageInfo_Clearing proto.InternalMessageInfo
-
-func (m *Clearing) GetTransactions() []Tx {
-	if m != nil {
-		return m.Transactions
-	}
-	return nil
-}
-
-// Clearing messages
-type Withdraw struct {
-	ID                   string   `protobuf:"bytes,1,opt,name=ID,proto3" json:"ID,omitempty"`
-	Epoch                uint64   `protobuf:"varint,2,opt,name=Epoch,proto3" json:"Epoch,omitempty"`
-	Transaction          *Tx      `protobuf:"bytes,3,opt,name=Transaction,proto3" json:"Transaction,omitempty"`
-	XXX_NoUnkeyedLiteral struct{} `json:"-"`
-	XXX_unrecognized     []byte   `json:"-"`
-	XXX_sizecache        int32    `json:"-"`
-}
-
-func (m *Withdraw) Reset()         { *m = Withdraw{} }
-func (m *Withdraw) String() string { return proto.CompactTextString(m) }
-func (*Withdraw) ProtoMessage()    {}
-func (*Withdraw) Descriptor() ([]byte, []int) {
-	return fileDescriptor_437c556d7375b726, []int{5}
-}
-func (m *Withdraw) XXX_Unmarshal(b []byte) error {
-	return m.Unmarshal(b)
-}
-func (m *Withdraw) XXX_Marshal(b []byte, deterministic bool) ([]byte, error) {
-	b = b[:cap(b)]
-	n, err := m.MarshalToSizedBuffer(b)
-	if err != nil {
-		return nil, err
-	}
-	return b[:n], nil
-}
-func (m *Withdraw) XXX_Merge(src proto.Message) {
-	xxx_messageInfo_Withdraw.Merge(m, src)
-}
-func (m *Withdraw) XXX_Size() int {
-	return m.Size()
-}
-func (m *Withdraw) XXX_DiscardUnknown() {
-	xxx_messageInfo_Withdraw.DiscardUnknown(m)
-}
-
-var xxx_messageInfo_Withdraw proto.InternalMessageInfo
-
-func (m *Withdraw) GetID() string {
-	if m != nil {
-		return m.ID
-	}
-	return ""
-}
-
-func (m *Withdraw) GetEpoch() uint64 {
-	if m != nil {
-		return m.Epoch
-	}
-	return 0
-}
-
-func (m *Withdraw) GetTransaction() *Tx {
-	if m != nil {
-		return m.Transaction
-	}
-	return nil
-}
-
-// Lifetime of locks
 type Lifetime struct {
-	Unit                 Lifetime_Unit `protobuf:"varint,1,opt,name=unit,proto3,enum=accounting.Lifetime_Unit" json:"unit,omitempty"`
+	// Unit describes how lifetime is measured in account
-	Value                int64         `protobuf:"varint,2,opt,name=Value,proto3" json:"Value,omitempty"`
+	Unit Lifetime_Unit `protobuf:"varint,1,opt,name=unit,proto3,enum=accounting.Lifetime_Unit" json:"unit,omitempty"`
-	XXX_NoUnkeyedLiteral struct{}      `json:"-"`
+	// Value describes how long lifetime will be valid
-	XXX_unrecognized     []byte        `json:"-"`
+	Value                int64    `protobuf:"varint,2,opt,name=Value,proto3" json:"Value,omitempty"`
-	XXX_sizecache        int32         `json:"-"`
+	XXX_NoUnkeyedLiteral struct{} `json:"-"`
+	XXX_unrecognized     []byte   `json:"-"`
+	XXX_sizecache        int32    `json:"-"`
 }
 
 func (m *Lifetime) Reset()         { *m = Lifetime{} }
 func (m *Lifetime) String() string { return proto.CompactTextString(m) }
 func (*Lifetime) ProtoMessage()    {}
 func (*Lifetime) Descriptor() ([]byte, []int) {
-	return fileDescriptor_437c556d7375b726, []int{6}
+	return fileDescriptor_437c556d7375b726, []int{4}
 }
 func (m *Lifetime) XXX_Unmarshal(b []byte) error {
 	return m.Unmarshal(b)
@@ -504,23 +413,27 @@ func (m *Lifetime) GetValue() int64 {
 	return 0
 }
 
-// Transaction messages
 type Tx struct {
-	Type                 Tx_Type          `protobuf:"varint,1,opt,name=type,proto3,enum=accounting.Tx_Type" json:"type,omitempty"`
+	// Type describes target of transaction
-	From                 string           `protobuf:"bytes,2,opt,name=From,proto3" json:"From,omitempty"`
+	Type Tx_Type `protobuf:"varint,1,opt,name=type,proto3,enum=accounting.Tx_Type" json:"type,omitempty"`
-	To                   string           `protobuf:"bytes,3,opt,name=To,proto3" json:"To,omitempty"`
+	// From describes sender of funds
-	Amount               *decimal.Decimal `protobuf:"bytes,4,opt,name=Amount,proto3" json:"Amount,omitempty"`
+	From string `protobuf:"bytes,2,opt,name=From,proto3" json:"From,omitempty"`
-	PublicKeys           []byte           `protobuf:"bytes,5,opt,name=PublicKeys,proto3" json:"PublicKeys,omitempty"`
+	// To describes receiver of funds
-	XXX_NoUnkeyedLiteral struct{}         `json:"-"`
+	To string `protobuf:"bytes,3,opt,name=To,proto3" json:"To,omitempty"`
-	XXX_unrecognized     []byte           `json:"-"`
+	// Amount describes amount of funds
-	XXX_sizecache        int32            `json:"-"`
+	Amount *decimal.Decimal `protobuf:"bytes,4,opt,name=Amount,proto3" json:"Amount,omitempty"`
+	// PublicKeys contains public key of sender
+	PublicKeys           []byte   `protobuf:"bytes,5,opt,name=PublicKeys,proto3" json:"PublicKeys,omitempty"`
+	XXX_NoUnkeyedLiteral struct{} `json:"-"`
+	XXX_unrecognized     []byte   `json:"-"`
+	XXX_sizecache        int32    `json:"-"`
 }
 
 func (m *Tx) Reset()         { *m = Tx{} }
 func (m *Tx) String() string { return proto.CompactTextString(m) }
 func (*Tx) ProtoMessage()    {}
 func (*Tx) Descriptor() ([]byte, []int) {
-	return fileDescriptor_437c556d7375b726, []int{7}
+	return fileDescriptor_437c556d7375b726, []int{5}
 }
 func (m *Tx) XXX_Unmarshal(b []byte) error {
 	return m.Unmarshal(b)
@@ -581,7 +494,9 @@ func (m *Tx) GetPublicKeys() []byte {
 }
 
 type Settlement struct {
-	Epoch                uint64           `protobuf:"varint,1,opt,name=Epoch,proto3" json:"Epoch,omitempty"`
+	// Epoch contains an epoch when settlement was accepted
+	Epoch uint64 `protobuf:"varint,1,opt,name=Epoch,proto3" json:"Epoch,omitempty"`
+	// Transactions is a set of transactions
 	Transactions         []*Settlement_Tx `protobuf:"bytes,2,rep,name=Transactions,proto3" json:"Transactions,omitempty"`
 	XXX_NoUnkeyedLiteral struct{}         `json:"-"`
 	XXX_unrecognized     []byte           `json:"-"`
@@ -592,7 +507,7 @@ func (m *Settlement) Reset()         { *m = Settlement{} }
 func (m *Settlement) String() string { return proto.CompactTextString(m) }
 func (*Settlement) ProtoMessage()    {}
 func (*Settlement) Descriptor() ([]byte, []int) {
-	return fileDescriptor_437c556d7375b726, []int{8}
+	return fileDescriptor_437c556d7375b726, []int{6}
 }
 func (m *Settlement) XXX_Unmarshal(b []byte) error {
 	return m.Unmarshal(b)
@@ -632,7 +547,9 @@ func (m *Settlement) GetTransactions() []*Settlement_Tx {
 }
 
 type Settlement_Receiver struct {
-	To                   string           `protobuf:"bytes,1,opt,name=To,proto3" json:"To,omitempty"`
+	// To is the address of funds recipient
+	To string `protobuf:"bytes,1,opt,name=To,proto3" json:"To,omitempty"`
+	// Amount is the amount of funds that will be sent
 	Amount               *decimal.Decimal `protobuf:"bytes,2,opt,name=Amount,proto3" json:"Amount,omitempty"`
 	XXX_NoUnkeyedLiteral struct{}         `json:"-"`
 	XXX_unrecognized     []byte           `json:"-"`
@@ -643,7 +560,7 @@ func (m *Settlement_Receiver) Reset()         { *m = Settlement_Receiver{} }
 func (m *Settlement_Receiver) String() string { return proto.CompactTextString(m) }
 func (*Settlement_Receiver) ProtoMessage()    {}
 func (*Settlement_Receiver) Descriptor() ([]byte, []int) {
-	return fileDescriptor_437c556d7375b726, []int{8, 0}
+	return fileDescriptor_437c556d7375b726, []int{6, 0}
 }
 func (m *Settlement_Receiver) XXX_Unmarshal(b []byte) error {
 	return m.Unmarshal(b)
@@ -683,7 +600,9 @@ func (m *Settlement_Receiver) GetAmount() *decimal.Decimal {
 }
 
 type Settlement_Container struct {
-	CID                  CID      `protobuf:"bytes,1,opt,name=CID,proto3,customtype=CID" json:"CID"`
+	// CID is container identifier
+	CID CID `protobuf:"bytes,1,opt,name=CID,proto3,customtype=CID" json:"CID"`
+	// SGIDs is a set of storage groups that successfully passed the audit
 	SGIDs                []SGID   `protobuf:"bytes,2,rep,name=SGIDs,proto3,customtype=SGID" json:"SGIDs"`
 	XXX_NoUnkeyedLiteral struct{} `json:"-"`
 	XXX_unrecognized     []byte   `json:"-"`
@@ -694,7 +613,7 @@ func (m *Settlement_Container) Reset()         { *m = Settlement_Container{} }
 func (m *Settlement_Container) String() string { return proto.CompactTextString(m) }
 func (*Settlement_Container) ProtoMessage()    {}
 func (*Settlement_Container) Descriptor() ([]byte, []int) {
-	return fileDescriptor_437c556d7375b726, []int{8, 1}
+	return fileDescriptor_437c556d7375b726, []int{6, 1}
 }
 func (m *Settlement_Container) XXX_Unmarshal(b []byte) error {
 	return m.Unmarshal(b)
@@ -720,8 +639,11 @@ func (m *Settlement_Container) XXX_DiscardUnknown() {
 var xxx_messageInfo_Settlement_Container proto.InternalMessageInfo
 
 type Settlement_Tx struct {
-	From                 string                `protobuf:"bytes,1,opt,name=From,proto3" json:"From,omitempty"`
+	// From is the address of the sender of funds
-	Container            Settlement_Container  `protobuf:"bytes,2,opt,name=Container,proto3" json:"Container"`
+	From string `protobuf:"bytes,1,opt,name=From,proto3" json:"From,omitempty"`
+	// Container that successfully had passed the audit
+	Container Settlement_Container `protobuf:"bytes,2,opt,name=Container,proto3" json:"Container"`
+	// Receivers is a set of addresses of funds recipients
 	Receivers            []Settlement_Receiver `protobuf:"bytes,3,rep,name=Receivers,proto3" json:"Receivers"`
 	XXX_NoUnkeyedLiteral struct{}              `json:"-"`
 	XXX_unrecognized     []byte                `json:"-"`
@@ -732,7 +654,7 @@ func (m *Settlement_Tx) Reset()         { *m = Settlement_Tx{} }
 func (m *Settlement_Tx) String() string { return proto.CompactTextString(m) }
 func (*Settlement_Tx) ProtoMessage()    {}
 func (*Settlement_Tx) Descriptor() ([]byte, []int) {
-	return fileDescriptor_437c556d7375b726, []int{8, 2}
+	return fileDescriptor_437c556d7375b726, []int{6, 2}
 }
 func (m *Settlement_Tx) XXX_Unmarshal(b []byte) error {
 	return m.Unmarshal(b)
@@ -779,6 +701,7 @@ func (m *Settlement_Tx) GetReceivers() []Settlement_Receiver {
 }
 
 type ContainerCreateTarget struct {
+	// CID is container identifier
 	CID                  CID      `protobuf:"bytes,1,opt,name=CID,proto3,customtype=CID" json:"CID"`
 	XXX_NoUnkeyedLiteral struct{} `json:"-"`
 	XXX_unrecognized     []byte   `json:"-"`
@@ -789,7 +712,7 @@ func (m *ContainerCreateTarget) Reset()         { *m = ContainerCreateTarget{} }
 func (m *ContainerCreateTarget) String() string { return proto.CompactTextString(m) }
 func (*ContainerCreateTarget) ProtoMessage()    {}
 func (*ContainerCreateTarget) Descriptor() ([]byte, []int) {
-	return fileDescriptor_437c556d7375b726, []int{9}
+	return fileDescriptor_437c556d7375b726, []int{7}
 }
 func (m *ContainerCreateTarget) XXX_Unmarshal(b []byte) error {
 	return m.Unmarshal(b)
@@ -815,6 +738,7 @@ func (m *ContainerCreateTarget) XXX_DiscardUnknown() {
 var xxx_messageInfo_ContainerCreateTarget proto.InternalMessageInfo
 
 type WithdrawTarget struct {
+	// Cheque is a string representation of cheque id
 	Cheque               string   `protobuf:"bytes,1,opt,name=Cheque,proto3" json:"Cheque,omitempty"`
 	XXX_NoUnkeyedLiteral struct{} `json:"-"`
 	XXX_unrecognized     []byte   `json:"-"`
@@ -825,7 +749,7 @@ func (m *WithdrawTarget) Reset()         { *m = WithdrawTarget{} }
 func (m *WithdrawTarget) String() string { return proto.CompactTextString(m) }
 func (*WithdrawTarget) ProtoMessage()    {}
 func (*WithdrawTarget) Descriptor() ([]byte, []int) {
-	return fileDescriptor_437c556d7375b726, []int{10}
+	return fileDescriptor_437c556d7375b726, []int{8}
 }
 func (m *WithdrawTarget) XXX_Unmarshal(b []byte) error {
 	return m.Unmarshal(b)
@@ -864,8 +788,6 @@ func init() {
 	proto.RegisterType((*LockTarget)(nil), "accounting.LockTarget")
 	proto.RegisterType((*Balances)(nil), "accounting.Balances")
 	proto.RegisterType((*PayIO)(nil), "accounting.PayIO")
-	proto.RegisterType((*Clearing)(nil), "accounting.Clearing")
-	proto.RegisterType((*Withdraw)(nil), "accounting.Withdraw")
 	proto.RegisterType((*Lifetime)(nil), "accounting.Lifetime")
 	proto.RegisterType((*Tx)(nil), "accounting.Tx")
 	proto.RegisterType((*Settlement)(nil), "accounting.Settlement")
@@ -879,62 +801,59 @@ func init() {
 func init() { proto.RegisterFile("accounting/types.proto", fileDescriptor_437c556d7375b726) }
 
 var fileDescriptor_437c556d7375b726 = []byte{
-	// 866 bytes of a gzipped FileDescriptorProto
+	// 821 bytes of a gzipped FileDescriptorProto
-	0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0x8c, 0x55, 0x4d, 0x73, 0x22, 0x45,
+	0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0x84, 0x55, 0x4d, 0x6f, 0xe3, 0x44,
-	0x18, 0xa6, 0x87, 0x09, 0x0c, 0x2f, 0x2c, 0x52, 0xbd, 0xbb, 0x29, 0xa4, 0x4a, 0x82, 0x53, 0x1e,
+	0x18, 0xce, 0x38, 0x69, 0x3e, 0xde, 0x64, 0x83, 0x35, 0xbb, 0x5b, 0x85, 0x48, 0xa4, 0xc1, 0xe2,
-	0xb0, 0xac, 0x80, 0x66, 0xcb, 0xc4, 0x8b, 0x07, 0x3e, 0x8c, 0x4b, 0xb9, 0x95, 0x4d, 0x75, 0x88,
+	0x10, 0x84, 0xea, 0x88, 0xae, 0x68, 0xb9, 0x70, 0x88, 0x13, 0xca, 0x56, 0xac, 0xba, 0xd5, 0xd4,
-	0x96, 0x7a, 0x1a, 0x86, 0x0e, 0xe9, 0x0a, 0x74, 0xe3, 0x4c, 0x93, 0x6c, 0xfe, 0x84, 0x67, 0x2f,
+	0x05, 0x01, 0x27, 0xd7, 0x99, 0xa6, 0x56, 0x93, 0x99, 0x60, 0x8f, 0xfb, 0xf1, 0x27, 0x38, 0x73,
-	0x9e, 0xfc, 0x11, 0xfe, 0x85, 0x3d, 0xea, 0xcd, 0xf2, 0x90, 0xb2, 0xf0, 0x8f, 0x58, 0xdd, 0xd3,
+	0xe1, 0xc4, 0x8f, 0xe0, 0x2f, 0xec, 0x11, 0x6e, 0x88, 0x43, 0x85, 0xc2, 0x1f, 0x41, 0x33, 0x1e,
-	0x33, 0xcc, 0xec, 0x82, 0x7a, 0x81, 0xf7, 0xe3, 0x79, 0x9f, 0x7e, 0xbf, 0xba, 0x07, 0xf6, 0x3d,
+	0x3b, 0x76, 0x95, 0xc0, 0x25, 0x79, 0x3f, 0x9e, 0xf7, 0x99, 0xf7, 0x6b, 0xc6, 0xb0, 0xeb, 0xf9,
-	0xdf, 0x17, 0x2b, 0x2e, 0x19, 0x9f, 0x75, 0xe5, 0xfd, 0x92, 0x86, 0x9d, 0x65, 0x20, 0xa4, 0xc0,
+	0x3e, 0x8f, 0x99, 0x08, 0xd8, 0x6c, 0x28, 0x1e, 0x96, 0x34, 0xb2, 0x97, 0x21, 0x17, 0x1c, 0xc3,
-	0xb0, 0xb1, 0x37, 0x9e, 0x4e, 0xa9, 0xcf, 0x16, 0xde, 0xbc, 0x6b, 0xfe, 0x23, 0x48, 0xe3, 0x70,
+	0xda, 0xde, 0x7d, 0x39, 0xa5, 0x7e, 0xb0, 0xf0, 0xe6, 0x43, 0xfd, 0x9f, 0x40, 0xba, 0xfb, 0xb3,
-	0xc6, 0xe4, 0xf5, 0x6a, 0xd2, 0xf1, 0xc5, 0xa2, 0x3b, 0x13, 0x33, 0xd1, 0xd5, 0xe6, 0xc9, 0xea,
+	0x40, 0x5c, 0xc7, 0x97, 0xb6, 0xcf, 0x17, 0xc3, 0x19, 0x9f, 0xf1, 0xa1, 0x32, 0x5f, 0xc6, 0x57,
-	0x4a, 0x6b, 0x5a, 0xd1, 0x52, 0x04, 0x77, 0x7f, 0xb7, 0xa0, 0xd8, 0x8b, 0x48, 0xf1, 0x87, 0x50,
+	0x4a, 0x53, 0x8a, 0x92, 0x12, 0xb8, 0xf5, 0x87, 0x01, 0xb5, 0x51, 0x42, 0x8a, 0x3f, 0x86, 0xda,
-	0x7c, 0x79, 0xc7, 0x69, 0x30, 0x1a, 0xd6, 0x51, 0x0b, 0xb5, 0x2b, 0xfd, 0x77, 0x5e, 0x3f, 0x1c,
+	0xdb, 0x3b, 0x46, 0xc3, 0x93, 0x49, 0x07, 0xf5, 0xd1, 0xa0, 0xe5, 0xbc, 0xf7, 0xee, 0x71, 0xaf,
-	0xe4, 0xfe, 0x7c, 0x38, 0x88, 0xcd, 0x24, 0x16, 0x70, 0x1d, 0x8a, 0xbd, 0xe9, 0x34, 0xa0, 0x61,
+	0xf4, 0xd7, 0xe3, 0x5e, 0x6a, 0x26, 0xa9, 0x80, 0x3b, 0x50, 0x1b, 0x4d, 0xa7, 0x21, 0x8d, 0xa2,
-	0x58, 0xb7, 0x5a, 0xa8, 0x5d, 0x22, 0xb1, 0x8a, 0x3f, 0x80, 0x47, 0xe7, 0x5e, 0x40, 0xb9, 0x8c,
+	0x8e, 0xd1, 0x47, 0x83, 0x06, 0x49, 0x55, 0xfc, 0x11, 0x3c, 0x3b, 0xf3, 0x42, 0xca, 0x44, 0xea,
-	0xfd, 0x79, 0xed, 0xcf, 0x1a, 0xf1, 0x11, 0x94, 0x7b, 0xbe, 0x64, 0xb7, 0xf4, 0x74, 0xc5, 0xa7,
+	0x2f, 0x2b, 0x7f, 0xd1, 0x88, 0x0f, 0xa0, 0x39, 0xf2, 0x45, 0x70, 0x4b, 0x8f, 0x63, 0x36, 0x8d,
-	0x61, 0xdd, 0x6e, 0xa1, 0x76, 0xf9, 0xa8, 0xd6, 0x89, 0x4b, 0x19, 0x46, 0xff, 0x24, 0x0d, 0xc2,
+	0x3a, 0x95, 0x3e, 0x1a, 0x34, 0x0f, 0x4c, 0x3b, 0x2d, 0x65, 0x92, 0xfc, 0x93, 0x3c, 0x08, 0x1f,
-	0xc7, 0xe0, 0xbc, 0x60, 0x57, 0x54, 0xb2, 0x05, 0xad, 0xef, 0xe9, 0x80, 0x27, 0x9d, 0x4d, 0x3f,
+	0x42, 0xfd, 0x4d, 0x70, 0x45, 0x45, 0xb0, 0xa0, 0x9d, 0x1d, 0x15, 0xf0, 0xc2, 0x5e, 0xf7, 0xc3,
-	0x3a, 0xb1, 0xaf, 0x6f, 0xab, 0xac, 0x49, 0x82, 0xc5, 0xc7, 0x00, 0x2f, 0x84, 0x7f, 0x33, 0xf6,
+	0x4e, 0x7d, 0x4e, 0x45, 0x66, 0x4d, 0x32, 0x2c, 0x3e, 0x04, 0x78, 0xc3, 0xfd, 0x1b, 0xd7, 0x0b,
-	0x82, 0x19, 0x95, 0xf5, 0x82, 0x8e, 0xdc, 0xcf, 0x44, 0x26, 0x5e, 0x92, 0x42, 0xe2, 0x13, 0xa8,
+	0x67, 0x54, 0x74, 0xaa, 0x2a, 0x72, 0xb7, 0x10, 0x99, 0x79, 0x49, 0x0e, 0x89, 0x8f, 0xa0, 0x25,
-	0x28, 0xcd, 0x74, 0x27, 0xac, 0x17, 0x5b, 0xf9, 0x76, 0xf9, 0xe8, 0x71, 0x3a, 0xd2, 0xf8, 0x48,
+	0x35, 0xdd, 0x9d, 0xa8, 0x53, 0xeb, 0x97, 0x07, 0xcd, 0x83, 0xe7, 0xf9, 0x48, 0xed, 0x23, 0x05,
-	0x06, 0xe8, 0xfe, 0x8a, 0xd2, 0x27, 0xe2, 0x21, 0x54, 0xbf, 0x61, 0xf2, 0x7a, 0x1a, 0x78, 0x77,
+	0xa0, 0xf5, 0x1b, 0xca, 0x9f, 0x88, 0x27, 0xd0, 0xfe, 0x36, 0x10, 0xd7, 0xd3, 0xd0, 0xbb, 0xd3,
-	0x26, 0x07, 0xa4, 0x73, 0x68, 0xa4, 0x99, 0xb2, 0x88, 0xe7, 0x39, 0xf2, 0x46, 0x0c, 0xfe, 0x16,
+	0x39, 0x20, 0x95, 0x43, 0x37, 0xcf, 0x54, 0x44, 0xbc, 0x2e, 0x91, 0x27, 0x31, 0xf8, 0x3b, 0x78,
-	0x9e, 0x0e, 0x04, 0x97, 0x1e, 0xe3, 0x34, 0x18, 0x04, 0xd4, 0x93, 0xd4, 0x90, 0x59, 0x9a, 0xec,
+	0x39, 0xe6, 0x4c, 0x78, 0x01, 0xa3, 0xe1, 0x38, 0xa4, 0x9e, 0xa0, 0x9a, 0xcc, 0x50, 0x64, 0x1f,
-	0xfd, 0x34, 0xd9, 0x56, 0xe0, 0xf3, 0x1c, 0xd9, 0xce, 0xd0, 0x77, 0xa0, 0x10, 0x49, 0x6e, 0x0f,
+	0xe6, 0xc9, 0x36, 0x02, 0x5f, 0x97, 0xc8, 0x66, 0x06, 0xa7, 0x0e, 0xd5, 0x44, 0xb2, 0x46, 0x50,
-	0x9c, 0xbe, 0x37, 0xf7, 0xb8, 0x4f, 0x43, 0xfc, 0x29, 0x38, 0x49, 0xe9, 0x68, 0x67, 0xe9, 0x71,
+	0x77, 0xbc, 0xb9, 0xc7, 0x7c, 0x1a, 0xe1, 0xcf, 0xa0, 0x9e, 0x95, 0x8e, 0xb6, 0x96, 0x9e, 0x76,
-	0xb7, 0x93, 0xe2, 0xbf, 0x87, 0xbd, 0x73, 0xef, 0x7e, 0xf4, 0x52, 0xad, 0x48, 0x7f, 0x2e, 0xfc,
+	0x3b, 0x2b, 0xfe, 0x07, 0xd8, 0x39, 0xf3, 0x1e, 0x4e, 0xde, 0xca, 0x15, 0x71, 0xe6, 0xdc, 0xbf,
-	0x1b, 0xb3, 0x4d, 0x36, 0x89, 0x55, 0xfc, 0x19, 0x54, 0xc6, 0x81, 0xc7, 0x43, 0xcf, 0x97, 0x4c,
+	0xd1, 0xdb, 0x54, 0x21, 0xa9, 0x8a, 0x3f, 0x87, 0x96, 0x1b, 0x7a, 0x2c, 0xf2, 0x7c, 0x11, 0x70,
-	0x70, 0xb5, 0x41, 0x8a, 0xbd, 0x9a, 0x66, 0x1f, 0xbf, 0x32, 0xc4, 0x19, 0xa4, 0x3b, 0x04, 0x67,
+	0x26, 0x37, 0x48, 0xb2, 0xb7, 0xf3, 0xec, 0xee, 0xbd, 0x26, 0x2e, 0x20, 0xad, 0x9f, 0xd0, 0x7a,
-	0x30, 0xa7, 0x5e, 0xc0, 0xf8, 0xec, 0x2d, 0x16, 0xf4, 0xbf, 0x59, 0x26, 0xe0, 0xc4, 0xcd, 0xc5,
+	0x07, 0xf0, 0x11, 0x54, 0x62, 0x16, 0x24, 0xdd, 0x6c, 0x1f, 0xbc, 0xbf, 0x69, 0x17, 0xec, 0x0b,
-	0x55, 0xb0, 0x4c, 0x82, 0x25, 0x62, 0x8d, 0x86, 0xf8, 0x09, 0xec, 0x7d, 0xb1, 0x14, 0xfe, 0xb5,
+	0x16, 0x08, 0xa7, 0xbe, 0x7a, 0xdc, 0xab, 0x48, 0x89, 0xa8, 0x00, 0xfc, 0x02, 0x76, 0xbe, 0xf1,
-	0x6e, 0xab, 0x4d, 0x22, 0x05, 0x7f, 0x0c, 0xe5, 0x14, 0x83, 0x5e, 0xe9, 0xb7, 0x8e, 0x22, 0x69,
+	0xe6, 0x31, 0x55, 0xad, 0x2b, 0x93, 0x44, 0xb1, 0x5e, 0x81, 0xc2, 0xe0, 0x67, 0xd0, 0xb8, 0x60,
-	0x88, 0xfb, 0x23, 0xda, 0x6c, 0x2b, 0x3e, 0x01, 0x7b, 0xc5, 0x59, 0x34, 0xf7, 0xea, 0xd1, 0xbb,
+	0xf3, 0x60, 0x11, 0x08, 0x3a, 0x35, 0x4b, 0xb8, 0x0d, 0x70, 0x4a, 0xf9, 0xf1, 0xf9, 0x97, 0x4b,
-	0xdb, 0xb6, 0xb6, 0x73, 0xc9, 0x99, 0xec, 0x3b, 0xeb, 0x87, 0x03, 0x5b, 0x49, 0x44, 0x07, 0xa8,
+	0xee, 0x5f, 0x9b, 0x08, 0xb7, 0xa0, 0x7e, 0x4a, 0xb9, 0x2a, 0xc5, 0x34, 0xac, 0x47, 0x04, 0x86,
-	0x6c, 0xbe, 0xf6, 0xe6, 0x2b, 0xaa, 0xb3, 0xc9, 0x93, 0x48, 0x71, 0x9f, 0x81, 0xc6, 0xe0, 0x47,
+	0x7b, 0x8f, 0x3f, 0x85, 0x8a, 0xbc, 0xa6, 0x3a, 0x95, 0xe7, 0xc5, 0x4a, 0x6c, 0xf7, 0x61, 0x49,
-	0x50, 0xba, 0xe4, 0x73, 0xb6, 0x60, 0x92, 0x4e, 0x6b, 0x39, 0x5c, 0x05, 0x38, 0xa3, 0xe2, 0xf4,
+	0x93, 0x24, 0xa4, 0x44, 0x14, 0x14, 0x63, 0xa8, 0x1c, 0x87, 0x7c, 0xa1, 0xaf, 0x8f, 0x92, 0x71,
-	0x42, 0xa7, 0x5c, 0x43, 0xb8, 0x02, 0xce, 0x19, 0x15, 0xba, 0xe9, 0x35, 0xcb, 0x7d, 0x40, 0x60,
+	0x1b, 0x0c, 0x97, 0xeb, 0x0b, 0x63, 0xb8, 0x1c, 0x0f, 0xa0, 0x3a, 0x5a, 0x48, 0xa2, 0xad, 0x17,
-	0x8d, 0x5f, 0xe1, 0x4f, 0xc0, 0x56, 0x0f, 0x8a, 0x49, 0xe5, 0x71, 0xb6, 0x84, 0xce, 0xf8, 0x7e,
+	0x44, 0xfb, 0x71, 0x0f, 0xe0, 0x2c, 0xbe, 0x9c, 0x07, 0xfe, 0xd7, 0xf4, 0x21, 0x52, 0xb7, 0xa3,
-	0x49, 0xa3, 0x24, 0x94, 0x44, 0x34, 0x14, 0x63, 0xb0, 0x4f, 0x03, 0xb1, 0x30, 0x17, 0x5d, 0xcb,
+	0x45, 0x72, 0x16, 0xeb, 0x08, 0xd4, 0xd9, 0xb8, 0x09, 0xb5, 0x0b, 0x76, 0xc3, 0xf8, 0x1d, 0x33,
-	0xaa, 0x6d, 0x63, 0x61, 0xae, 0xb6, 0x35, 0x16, 0xb8, 0x0d, 0x85, 0xde, 0x42, 0x11, 0xed, 0xbc,
+	0x4b, 0xb2, 0x94, 0x74, 0xc9, 0x4c, 0x84, 0x1b, 0x7a, 0x70, 0xa6, 0x21, 0xc5, 0x13, 0xc6, 0x68,
-	0xca, 0xc6, 0x8f, 0x9b, 0x00, 0xe7, 0xab, 0xc9, 0x9c, 0xf9, 0x5f, 0xd1, 0xfb, 0x50, 0xdf, 0xe3,
+	0x68, 0x96, 0xad, 0x5f, 0xca, 0x00, 0xe7, 0x54, 0x88, 0x39, 0x5d, 0x50, 0xa6, 0x5a, 0xa7, 0x1a,
-	0x0a, 0x49, 0x59, 0xdc, 0x13, 0xd0, 0x67, 0xe3, 0x32, 0x14, 0x2f, 0xf9, 0x0d, 0x17, 0x77, 0xbc,
+	0xa1, 0x47, 0x9a, 0x28, 0xf8, 0x8b, 0x8d, 0x03, 0x2d, 0x4c, 0x64, 0xcd, 0x61, 0xbb, 0xf7, 0xc5,
-	0x96, 0x53, 0xa5, 0xc4, 0x13, 0xab, 0x21, 0x5c, 0x32, 0x2b, 0x56, 0xb3, 0x94, 0x38, 0xe2, 0x9c,
+	0xa9, 0x76, 0x27, 0x50, 0x27, 0xd4, 0xa7, 0xc1, 0x2d, 0x0d, 0x75, 0x0b, 0xd0, 0x86, 0x16, 0x18,
-	0x06, 0xb5, 0xbc, 0xfb, 0x73, 0x1e, 0xe0, 0x82, 0x4a, 0x39, 0xa7, 0x0b, 0xca, 0xe5, 0x66, 0x90,
+	0xff, 0xdd, 0x82, 0xee, 0x29, 0x34, 0xb2, 0xf5, 0xc6, 0x1f, 0x40, 0x79, 0x9c, 0x3d, 0x63, 0x4d,
-	0x28, 0x3d, 0xc8, 0xcf, 0xb7, 0xae, 0x5e, 0x66, 0x22, 0x1b, 0x0e, 0x35, 0xd4, 0x0c, 0xbc, 0x31,
+	0xfd, 0x8c, 0x49, 0x13, 0x91, 0x3f, 0xd8, 0x82, 0x9d, 0xf3, 0xaf, 0x4e, 0x26, 0x49, 0xa6, 0x2d,
-	0x04, 0x87, 0x50, 0x9f, 0xb2, 0x5b, 0x1a, 0x98, 0x16, 0xa0, 0x2d, 0x2d, 0xb0, 0xfe, 0xbd, 0x05,
+	0xa7, 0xa5, 0x01, 0x15, 0x69, 0x24, 0x89, 0xab, 0xfb, 0x6b, 0x32, 0xda, 0x74, 0x4e, 0x28, 0x37,
-	0x8d, 0x33, 0x28, 0x25, 0x17, 0x11, 0xbf, 0x07, 0xf9, 0x41, 0xf2, 0xe0, 0x96, 0xcd, 0x83, 0xab,
+	0xa7, 0x49, 0xee, 0x28, 0x9d, 0x57, 0x7f, 0x4b, 0xb1, 0x19, 0x4e, 0xef, 0x73, 0x2e, 0xc7, 0x31,
-	0x4c, 0x44, 0xfd, 0x60, 0x17, 0xf6, 0x2e, 0xbe, 0x1c, 0x0d, 0xa3, 0x4c, 0x2b, 0xfd, 0x8a, 0x01,
+	0x34, 0xd2, 0xb2, 0xe5, 0x2b, 0x29, 0x5b, 0xb6, 0xb7, 0x85, 0x25, 0xc5, 0xa5, 0x24, 0x59, 0x9c,
-	0xd8, 0xca, 0x48, 0x22, 0x57, 0xe3, 0x97, 0x68, 0xb4, 0xf1, 0x9c, 0x50, 0x6a, 0x4e, 0xc3, 0xd4,
+	0x75, 0xb8, 0xe5, 0x59, 0xf8, 0x9f, 0x0e, 0x58, 0x83, 0xa7, 0x8f, 0x12, 0xde, 0x85, 0xea, 0xf8,
-	0x51, 0x26, 0xaf, 0xd6, 0x8e, 0x62, 0x13, 0x9c, 0xb9, 0x33, 0xa9, 0x1c, 0x07, 0x50, 0x8a, 0xcb,
+	0x9a, 0xfe, 0x18, 0x53, 0x5d, 0xaa, 0xd6, 0x9c, 0xd1, 0xbb, 0x55, 0x0f, 0xfd, 0xbe, 0xea, 0xa1,
-	0x56, 0xef, 0xb9, 0x6a, 0xd9, 0xc1, 0x0e, 0x96, 0x18, 0x17, 0x93, 0x24, 0x71, 0xee, 0xf1, 0x8e,
+	0x3f, 0x57, 0x3d, 0xf4, 0xf7, 0xaa, 0x87, 0x7e, 0xfe, 0xa7, 0x57, 0xfa, 0xfe, 0x93, 0xdc, 0x67,
-	0x07, 0xec, 0x3f, 0x3a, 0xe0, 0xb6, 0xdf, 0x7c, 0x3e, 0xf1, 0x3e, 0x14, 0x06, 0xd7, 0xf4, 0x87,
+	0x86, 0x45, 0x4b, 0xdf, 0xdf, 0x9f, 0xd2, 0xdb, 0x21, 0xa3, 0xfc, 0x2a, 0xda, 0x4f, 0x3e, 0x32,
-	0x15, 0x35, 0xa5, 0x1a, 0xad, 0xdf, 0x7b, 0xbd, 0x6e, 0xa2, 0xdf, 0xd6, 0x4d, 0xf4, 0xc7, 0xba,
+	0xeb, 0x4a, 0x2e, 0xab, 0xca, 0xf2, 0xea, 0xdf, 0x00, 0x00, 0x00, 0xff, 0xff, 0x3c, 0x2d, 0x7e,
-	0x89, 0xfe, 0x5a, 0x37, 0xd1, 0x4f, 0x7f, 0x37, 0x73, 0xdf, 0x7d, 0x94, 0xfa, 0x20, 0xf2, 0x70,
+	0x6b, 0xd7, 0x06, 0x00, 0x00,
-	0xe9, 0xfb, 0x87, 0x53, 0x7a, 0xdb, 0xe5, 0x54, 0x5c, 0x85, 0x87, 0xd1, 0xe7, 0x70, 0x53, 0xc9,
-	0xa4, 0xa0, 0x2d, 0xcf, 0xfe, 0x09, 0x00, 0x00, 0xff, 0xff, 0x66, 0x69, 0x27, 0xa6, 0x81, 0x07,
-	0x00, 0x00,
 }
 
 func (m *Account) Marshal() (dAtA []byte, err error) {
@@ -1201,98 +1120,6 @@ func (m *PayIO) MarshalToSizedBuffer(dAtA []byte) (int, error) {
 	return len(dAtA) - i, nil
 }
 
-func (m *Clearing) Marshal() (dAtA []byte, err error) {
-	size := m.Size()
-	dAtA = make([]byte, size)
-	n, err := m.MarshalToSizedBuffer(dAtA[:size])
-	if err != nil {
-		return nil, err
-	}
-	return dAtA[:n], nil
-}
-
-func (m *Clearing) MarshalTo(dAtA []byte) (int, error) {
-	size := m.Size()
-	return m.MarshalToSizedBuffer(dAtA[:size])
-}
-
-func (m *Clearing) MarshalToSizedBuffer(dAtA []byte) (int, error) {
-	i := len(dAtA)
-	_ = i
-	var l int
-	_ = l
-	if m.XXX_unrecognized != nil {
-		i -= len(m.XXX_unrecognized)
-		copy(dAtA[i:], m.XXX_unrecognized)
-	}
-	if len(m.Transactions) > 0 {
-		for iNdEx := len(m.Transactions) - 1; iNdEx >= 0; iNdEx-- {
-			{
-				size, err := m.Transactions[iNdEx].MarshalToSizedBuffer(dAtA[:i])
-				if err != nil {
-					return 0, err
-				}
-				i -= size
-				i = encodeVarintTypes(dAtA, i, uint64(size))
-			}
-			i--
-			dAtA[i] = 0xa
-		}
-	}
-	return len(dAtA) - i, nil
-}
-
-func (m *Withdraw) Marshal() (dAtA []byte, err error) {
-	size := m.Size()
-	dAtA = make([]byte, size)
-	n, err := m.MarshalToSizedBuffer(dAtA[:size])
-	if err != nil {
-		return nil, err
-	}
-	return dAtA[:n], nil
-}
-
-func (m *Withdraw) MarshalTo(dAtA []byte) (int, error) {
-	size := m.Size()
-	return m.MarshalToSizedBuffer(dAtA[:size])
-}
-
-func (m *Withdraw) MarshalToSizedBuffer(dAtA []byte) (int, error) {
-	i := len(dAtA)
-	_ = i
-	var l int
-	_ = l
-	if m.XXX_unrecognized != nil {
-		i -= len(m.XXX_unrecognized)
-		copy(dAtA[i:], m.XXX_unrecognized)
-	}
-	if m.Transaction != nil {
-		{
-			size, err := m.Transaction.MarshalToSizedBuffer(dAtA[:i])
-			if err != nil {
-				return 0, err
-			}
-			i -= size
-			i = encodeVarintTypes(dAtA, i, uint64(size))
-		}
-		i--
-		dAtA[i] = 0x1a
-	}
-	if m.Epoch != 0 {
-		i = encodeVarintTypes(dAtA, i, uint64(m.Epoch))
-		i--
-		dAtA[i] = 0x10
-	}
-	if len(m.ID) > 0 {
-		i -= len(m.ID)
-		copy(dAtA[i:], m.ID)
-		i = encodeVarintTypes(dAtA, i, uint64(len(m.ID)))
-		i--
-		dAtA[i] = 0xa
-	}
-	return len(dAtA) - i, nil
-}
-
 func (m *Lifetime) Marshal() (dAtA []byte, err error) {
 	size := m.Size()
 	dAtA = make([]byte, size)
@@ -1794,47 +1621,6 @@ func (m *PayIO) Size() (n int) {
 	return n
 }
 
-func (m *Clearing) Size() (n int) {
-	if m == nil {
-		return 0
-	}
-	var l int
-	_ = l
-	if len(m.Transactions) > 0 {
-		for _, e := range m.Transactions {
-			l = e.Size()
-			n += 1 + l + sovTypes(uint64(l))
-		}
-	}
-	if m.XXX_unrecognized != nil {
-		n += len(m.XXX_unrecognized)
-	}
-	return n
-}
-
-func (m *Withdraw) Size() (n int) {
-	if m == nil {
-		return 0
-	}
-	var l int
-	_ = l
-	l = len(m.ID)
-	if l > 0 {
-		n += 1 + l + sovTypes(uint64(l))
-	}
-	if m.Epoch != 0 {
-		n += 1 + sovTypes(uint64(m.Epoch))
-	}
-	if m.Transaction != nil {
-		l = m.Transaction.Size()
-		n += 1 + l + sovTypes(uint64(l))
-	}
-	if m.XXX_unrecognized != nil {
-		n += len(m.XXX_unrecognized)
-	}
-	return n
-}
-
 func (m *Lifetime) Size() (n int) {
 	if m == nil {
 		return 0
@@ -2614,235 +2400,6 @@ func (m *PayIO) Unmarshal(dAtA []byte) error {
 	}
 	return nil
 }
-func (m *Clearing) Unmarshal(dAtA []byte) error {
-	l := len(dAtA)
-	iNdEx := 0
-	for iNdEx < l {
-		preIndex := iNdEx
-		var wire uint64
-		for shift := uint(0); ; shift += 7 {
-			if shift >= 64 {
-				return ErrIntOverflowTypes
-			}
-			if iNdEx >= l {
-				return io.ErrUnexpectedEOF
-			}
-			b := dAtA[iNdEx]
-			iNdEx++
-			wire |= uint64(b&0x7F) << shift
-			if b < 0x80 {
-				break
-			}
-		}
-		fieldNum := int32(wire >> 3)
-		wireType := int(wire & 0x7)
-		if wireType == 4 {
-			return fmt.Errorf("proto: Clearing: wiretype end group for non-group")
-		}
-		if fieldNum <= 0 {
-			return fmt.Errorf("proto: Clearing: illegal tag %d (wire type %d)", fieldNum, wire)
-		}
-		switch fieldNum {
-		case 1:
-			if wireType != 2 {
-				return fmt.Errorf("proto: wrong wireType = %d for field Transactions", wireType)
-			}
-			var msglen int
-			for shift := uint(0); ; shift += 7 {
-				if shift >= 64 {
-					return ErrIntOverflowTypes
-				}
-				if iNdEx >= l {
-					return io.ErrUnexpectedEOF
-				}
-				b := dAtA[iNdEx]
-				iNdEx++
-				msglen |= int(b&0x7F) << shift
-				if b < 0x80 {
-					break
-				}
-			}
-			if msglen < 0 {
-				return ErrInvalidLengthTypes
-			}
-			postIndex := iNdEx + msglen
-			if postIndex < 0 {
-				return ErrInvalidLengthTypes
-			}
-			if postIndex > l {
-				return io.ErrUnexpectedEOF
-			}
-			m.Transactions = append(m.Transactions, Tx{})
-			if err := m.Transactions[len(m.Transactions)-1].Unmarshal(dAtA[iNdEx:postIndex]); err != nil {
-				return err
-			}
-			iNdEx = postIndex
-		default:
-			iNdEx = preIndex
-			skippy, err := skipTypes(dAtA[iNdEx:])
-			if err != nil {
-				return err
-			}
-			if skippy < 0 {
-				return ErrInvalidLengthTypes
-			}
-			if (iNdEx + skippy) < 0 {
-				return ErrInvalidLengthTypes
-			}
-			if (iNdEx + skippy) > l {
-				return io.ErrUnexpectedEOF
-			}
-			m.XXX_unrecognized = append(m.XXX_unrecognized, dAtA[iNdEx:iNdEx+skippy]...)
-			iNdEx += skippy
-		}
-	}
-
-	if iNdEx > l {
-		return io.ErrUnexpectedEOF
-	}
-	return nil
-}
-func (m *Withdraw) Unmarshal(dAtA []byte) error {
-	l := len(dAtA)
-	iNdEx := 0
-	for iNdEx < l {
-		preIndex := iNdEx
-		var wire uint64
-		for shift := uint(0); ; shift += 7 {
-			if shift >= 64 {
-				return ErrIntOverflowTypes
-			}
-			if iNdEx >= l {
-				return io.ErrUnexpectedEOF
-			}
-			b := dAtA[iNdEx]
-			iNdEx++
-			wire |= uint64(b&0x7F) << shift
-			if b < 0x80 {
-				break
-			}
-		}
-		fieldNum := int32(wire >> 3)
-		wireType := int(wire & 0x7)
-		if wireType == 4 {
-			return fmt.Errorf("proto: Withdraw: wiretype end group for non-group")
-		}
-		if fieldNum <= 0 {
-			return fmt.Errorf("proto: Withdraw: illegal tag %d (wire type %d)", fieldNum, wire)
-		}
-		switch fieldNum {
-		case 1:
-			if wireType != 2 {
-				return fmt.Errorf("proto: wrong wireType = %d for field ID", wireType)
-			}
-			var stringLen uint64
-			for shift := uint(0); ; shift += 7 {
-				if shift >= 64 {
-					return ErrIntOverflowTypes
-				}
-				if iNdEx >= l {
-					return io.ErrUnexpectedEOF
-				}
-				b := dAtA[iNdEx]
-				iNdEx++
-				stringLen |= uint64(b&0x7F) << shift
-				if b < 0x80 {
-					break
-				}
-			}
-			intStringLen := int(stringLen)
-			if intStringLen < 0 {
-				return ErrInvalidLengthTypes
-			}
-			postIndex := iNdEx + intStringLen
-			if postIndex < 0 {
-				return ErrInvalidLengthTypes
-			}
-			if postIndex > l {
-				return io.ErrUnexpectedEOF
-			}
-			m.ID = string(dAtA[iNdEx:postIndex])
-			iNdEx = postIndex
-		case 2:
-			if wireType != 0 {
-				return fmt.Errorf("proto: wrong wireType = %d for field Epoch", wireType)
-			}
-			m.Epoch = 0
-			for shift := uint(0); ; shift += 7 {
-				if shift >= 64 {
-					return ErrIntOverflowTypes
-				}
-				if iNdEx >= l {
-					return io.ErrUnexpectedEOF
-				}
-				b := dAtA[iNdEx]
-				iNdEx++
-				m.Epoch |= uint64(b&0x7F) << shift
-				if b < 0x80 {
-					break
-				}
-			}
-		case 3:
-			if wireType != 2 {
-				return fmt.Errorf("proto: wrong wireType = %d for field Transaction", wireType)
-			}
-			var msglen int
-			for shift := uint(0); ; shift += 7 {
-				if shift >= 64 {
-					return ErrIntOverflowTypes
-				}
-				if iNdEx >= l {
-					return io.ErrUnexpectedEOF
-				}
-				b := dAtA[iNdEx]
-				iNdEx++
-				msglen |= int(b&0x7F) << shift
-				if b < 0x80 {
-					break
-				}
-			}
-			if msglen < 0 {
-				return ErrInvalidLengthTypes
-			}
-			postIndex := iNdEx + msglen
-			if postIndex < 0 {
-				return ErrInvalidLengthTypes
-			}
-			if postIndex > l {
-				return io.ErrUnexpectedEOF
-			}
-			if m.Transaction == nil {
-				m.Transaction = &Tx{}
-			}
-			if err := m.Transaction.Unmarshal(dAtA[iNdEx:postIndex]); err != nil {
-				return err
-			}
-			iNdEx = postIndex
-		default:
-			iNdEx = preIndex
-			skippy, err := skipTypes(dAtA[iNdEx:])
-			if err != nil {
-				return err
-			}
-			if skippy < 0 {
-				return ErrInvalidLengthTypes
-			}
-			if (iNdEx + skippy) < 0 {
-				return ErrInvalidLengthTypes
-			}
-			if (iNdEx + skippy) > l {
-				return io.ErrUnexpectedEOF
-			}
-			m.XXX_unrecognized = append(m.XXX_unrecognized, dAtA[iNdEx:iNdEx+skippy]...)
-			iNdEx += skippy
-		}
-	}
-
-	if iNdEx > l {
-		return io.ErrUnexpectedEOF
-	}
-	return nil
-}
 func (m *Lifetime) Unmarshal(dAtA []byte) error {
 	l := len(dAtA)
 	iNdEx := 0

accounting/types.proto

@@ -7,61 +7,63 @@ import "github.com/gogo/protobuf/gogoproto/gogo.proto";
 
 option (gogoproto.stable_marshaler_all) = true;
 
-// Snapshot accounting messages
 message Account {
+    // OwnerID is a wallet address
     bytes OwnerID                 = 1 [(gogoproto.customtype) = "OwnerID",  (gogoproto.nullable) = false];
+    // Address is identifier of accounting record
     string Address                = 2;
+    // ParentAddress is identifier of parent accounting record
     string ParentAddress          = 3;
+    // ActiveFunds is amount of active (non locked) funds for account
     decimal.Decimal ActiveFunds   = 4;
+    // Lifetime is time until account is valid (used for lock accounts)
     Lifetime Lifetime             = 5 [(gogoproto.nullable) = false];
+    // LockTarget is the purpose of lock funds (it might be withdraw or payment for storage)
     LockTarget LockTarget         = 6;
+    // LockAccounts contains child accounts with locked funds
     repeated Account LockAccounts = 7;
 }
 
+// LockTarget must be one of two options
 message LockTarget {
     oneof Target {
+        // WithdrawTarget used when user requested withdraw
         WithdrawTarget WithdrawTarget = 1;
+        // ContainerCreateTarget used when user requested creation of container
         ContainerCreateTarget ContainerCreateTarget = 2;
     }
 }
 
-// Snapshot balance messages
 message Balances {
+    // Accounts contains multiple account snapshots
     repeated Account Accounts = 1 [(gogoproto.nullable) = false];
 }
 
-// PayIn / PayOut messages
 message PayIO {
+    // BlockID contains id of the NEO block where withdraw or deposit
+    // call was invoked
     uint64 BlockID = 1;
+    // Transactions contains all transactions that founded in block
+    // and used for PayIO
     repeated Tx Transactions = 2 [(gogoproto.nullable) = false];
 }
 
-// Clearing messages
-message Clearing {
-    repeated Tx Transactions = 1 [(gogoproto.nullable) = false];
-}
-
-// Clearing messages
-message Withdraw {
-    string ID = 1;
-    uint64 Epoch = 2;
-    Tx Transaction = 3;
-}
-
-// Lifetime of locks
 message Lifetime {
+    // Unit can be Unlimited, based on NeoFS epoch or Neo block
     enum Unit {
         Unlimited = 0;
         NeoFSEpoch = 1;
         NeoBlock = 2;
     }
 
+    // Unit describes how lifetime is measured in account
     Unit unit = 1 [(gogoproto.customname) = "Unit"];
+    // Value describes how long lifetime will be valid
     int64 Value = 2;
 }
 
-// Transaction messages
 message Tx {
+    // Type can be withdrawal, payIO or inner
     enum Type {
         Unknown  = 0;
         Withdraw = 1;
@@ -69,38 +71,54 @@ message Tx {
         Inner    = 3;
     }
 
+    // Type describes target of transaction
     Type type              = 1 [(gogoproto.customname) = "Type"];
+    // From describes sender of funds
     string From            = 2;
+    // To describes receiver of funds
     string To              = 3;
+    // Amount describes amount of funds
     decimal.Decimal Amount = 4;
-    bytes PublicKeys       = 5; // of sender
+    // PublicKeys contains public key of sender
+    bytes PublicKeys       = 5;
 }
 
 message Settlement {
     message Receiver {
+        // To is the address of funds recipient 
         string To              = 1;
+        // Amount is the amount of funds that will be sent
         decimal.Decimal Amount = 2;
     }
 
     message Container {
+        // CID is container identifier
         bytes CID            = 1 [(gogoproto.customtype) = "CID", (gogoproto.nullable) = false];
+        // SGIDs is a set of storage groups that successfully passed the audit
         repeated bytes SGIDs = 2 [(gogoproto.customtype) = "SGID", (gogoproto.nullable) = false];
     }
 
     message Tx {
+        // From is the address of the sender of funds
         string From                 = 1;
+        // Container that successfully had passed the audit
         Container Container         = 2 [(gogoproto.nullable) = false];
+        // Receivers is a set of addresses of funds recipients
         repeated Receiver Receivers = 3 [(gogoproto.nullable) = false];
     }
 
+    // Epoch contains an epoch when settlement was accepted
     uint64 Epoch             = 1;
+    // Transactions is a set of transactions
     repeated Tx Transactions = 2;
 }
 
 message ContainerCreateTarget {
+    // CID is container identifier
     bytes CID = 1 [(gogoproto.customtype) = "CID", (gogoproto.nullable) = false];
 }
 
 message WithdrawTarget {
+    // Cheque is a string representation of cheque id
     string Cheque = 1;
 }

accounting/withdraw.pb.go

@@ -29,14 +29,19 @@ var _ = math.Inf
 const _ = proto.ProtoPackageIsVersion3 // please upgrade the proto package
 
 type Item struct {
-	ID                   ChequeID         `protobuf:"bytes,1,opt,name=ID,proto3,customtype=ChequeID" json:"ID"`
+	// ID is a cheque identifier
-	OwnerID              OwnerID          `protobuf:"bytes,2,opt,name=OwnerID,proto3,customtype=OwnerID" json:"OwnerID"`
+	ID ChequeID `protobuf:"bytes,1,opt,name=ID,proto3,customtype=ChequeID" json:"ID"`
-	Amount               *decimal.Decimal `protobuf:"bytes,3,opt,name=Amount,proto3" json:"Amount,omitempty"`
+	// OwnerID is a wallet address
-	Height               uint64           `protobuf:"varint,4,opt,name=Height,proto3" json:"Height,omitempty"`
+	OwnerID OwnerID `protobuf:"bytes,2,opt,name=OwnerID,proto3,customtype=OwnerID" json:"OwnerID"`
-	Payload              []byte           `protobuf:"bytes,5,opt,name=Payload,proto3" json:"Payload,omitempty"`
+	// Amount of funds
-	XXX_NoUnkeyedLiteral struct{}         `json:"-"`
+	Amount *decimal.Decimal `protobuf:"bytes,3,opt,name=Amount,proto3" json:"Amount,omitempty"`
-	XXX_unrecognized     []byte           `json:"-"`
+	// Height is the neo blockchain height until the cheque is valid
-	XXX_sizecache        int32            `json:"-"`
+	Height uint64 `protobuf:"varint,4,opt,name=Height,proto3" json:"Height,omitempty"`
+	// Payload contains cheque representation in bytes
+	Payload              []byte   `protobuf:"bytes,5,opt,name=Payload,proto3" json:"Payload,omitempty"`
+	XXX_NoUnkeyedLiteral struct{} `json:"-"`
+	XXX_unrecognized     []byte   `json:"-"`
+	XXX_sizecache        int32    `json:"-"`
 }
 
 func (m *Item) Reset()         { *m = Item{} }
@@ -90,8 +95,11 @@ func (m *Item) GetPayload() []byte {
 }
 
 type GetRequest struct {
-	ID                   ChequeID `protobuf:"bytes,1,opt,name=ID,proto3,customtype=ChequeID" json:"ID"`
+	// ID is cheque identifier
-	OwnerID              OwnerID  `protobuf:"bytes,2,opt,name=OwnerID,proto3,customtype=OwnerID" json:"OwnerID"`
+	ID ChequeID `protobuf:"bytes,1,opt,name=ID,proto3,customtype=ChequeID" json:"ID"`
+	// OwnerID is a wallet address
+	OwnerID OwnerID `protobuf:"bytes,2,opt,name=OwnerID,proto3,customtype=OwnerID" json:"OwnerID"`
+	// TTL must be larger than zero, it decreased in every neofs-node
 	TTL                  uint32   `protobuf:"varint,3,opt,name=TTL,proto3" json:"TTL,omitempty"`
 	XXX_NoUnkeyedLiteral struct{} `json:"-"`
 	XXX_unrecognized     []byte   `json:"-"`
@@ -135,6 +143,7 @@ func (m *GetRequest) GetTTL() uint32 {
 }
 
 type GetResponse struct {
+	// Item is cheque with meta information
 	Withdraw             *Item    `protobuf:"bytes,1,opt,name=Withdraw,proto3" json:"Withdraw,omitempty"`
 	XXX_NoUnkeyedLiteral struct{} `json:"-"`
 	XXX_unrecognized     []byte   `json:"-"`
@@ -178,15 +187,21 @@ func (m *GetResponse) GetWithdraw() *Item {
 }
 
 type PutRequest struct {
-	OwnerID              OwnerID          `protobuf:"bytes,1,opt,name=OwnerID,proto3,customtype=OwnerID" json:"OwnerID"`
+	// OwnerID is a wallet address
-	Amount               *decimal.Decimal `protobuf:"bytes,2,opt,name=Amount,proto3" json:"Amount,omitempty"`
+	OwnerID OwnerID `protobuf:"bytes,1,opt,name=OwnerID,proto3,customtype=OwnerID" json:"OwnerID"`
-	Height               uint64           `protobuf:"varint,3,opt,name=Height,proto3" json:"Height,omitempty"`
+	// Amount of funds
-	MessageID            MessageID        `protobuf:"bytes,4,opt,name=MessageID,proto3,customtype=MessageID" json:"MessageID"`
+	Amount *decimal.Decimal `protobuf:"bytes,2,opt,name=Amount,proto3" json:"Amount,omitempty"`
-	Signature            []byte           `protobuf:"bytes,5,opt,name=Signature,proto3" json:"Signature,omitempty"`
+	// Height is the neo blockchain height until the cheque is valid
-	TTL                  uint32           `protobuf:"varint,6,opt,name=TTL,proto3" json:"TTL,omitempty"`
+	Height uint64 `protobuf:"varint,3,opt,name=Height,proto3" json:"Height,omitempty"`
-	XXX_NoUnkeyedLiteral struct{}         `json:"-"`
+	// MessageID is a nonce for uniq request (UUIDv4)
-	XXX_unrecognized     []byte           `json:"-"`
+	MessageID MessageID `protobuf:"bytes,4,opt,name=MessageID,proto3,customtype=MessageID" json:"MessageID"`
-	XXX_sizecache        int32            `json:"-"`
+	// Signature is a signature of the sent request
+	Signature []byte `protobuf:"bytes,5,opt,name=Signature,proto3" json:"Signature,omitempty"`
+	// TTL must be larger than zero, it decreased in every neofs-node
+	TTL                  uint32   `protobuf:"varint,6,opt,name=TTL,proto3" json:"TTL,omitempty"`
+	XXX_NoUnkeyedLiteral struct{} `json:"-"`
+	XXX_unrecognized     []byte   `json:"-"`
+	XXX_sizecache        int32    `json:"-"`
 }
 
 func (m *PutRequest) Reset()         { *m = PutRequest{} }
@@ -247,6 +262,7 @@ func (m *PutRequest) GetTTL() uint32 {
 }
 
 type PutResponse struct {
+	// ID is cheque identifier
 	ID                   ChequeID `protobuf:"bytes,1,opt,name=ID,proto3,customtype=ChequeID" json:"ID"`
 	XXX_NoUnkeyedLiteral struct{} `json:"-"`
 	XXX_unrecognized     []byte   `json:"-"`
@@ -283,7 +299,9 @@ func (m *PutResponse) XXX_DiscardUnknown() {
 var xxx_messageInfo_PutResponse proto.InternalMessageInfo
 
 type ListRequest struct {
-	OwnerID              OwnerID  `protobuf:"bytes,1,opt,name=OwnerID,proto3,customtype=OwnerID" json:"OwnerID"`
+	// OwnerID is a wallet address
+	OwnerID OwnerID `protobuf:"bytes,1,opt,name=OwnerID,proto3,customtype=OwnerID" json:"OwnerID"`
+	// TTL must be larger than zero, it decreased in every neofs-node
 	TTL                  uint32   `protobuf:"varint,2,opt,name=TTL,proto3" json:"TTL,omitempty"`
 	XXX_NoUnkeyedLiteral struct{} `json:"-"`
 	XXX_unrecognized     []byte   `json:"-"`
@@ -327,6 +345,7 @@ func (m *ListRequest) GetTTL() uint32 {
 }
 
 type ListResponse struct {
+	// Item is a set of cheques with meta information
 	Items                []*Item  `protobuf:"bytes,1,rep,name=Items,proto3" json:"Items,omitempty"`
 	XXX_NoUnkeyedLiteral struct{} `json:"-"`
 	XXX_unrecognized     []byte   `json:"-"`
@@ -370,14 +389,19 @@ func (m *ListResponse) GetItems() []*Item {
 }
 
 type DeleteRequest struct {
-	ID                   ChequeID  `protobuf:"bytes,1,opt,name=ID,proto3,customtype=ChequeID" json:"ID"`
+	// ID is cheque identifier
-	OwnerID              OwnerID   `protobuf:"bytes,2,opt,name=OwnerID,proto3,customtype=OwnerID" json:"OwnerID"`
+	ID ChequeID `protobuf:"bytes,1,opt,name=ID,proto3,customtype=ChequeID" json:"ID"`
-	MessageID            MessageID `protobuf:"bytes,3,opt,name=MessageID,proto3,customtype=MessageID" json:"MessageID"`
+	// OwnerID is a wallet address
-	Signature            []byte    `protobuf:"bytes,4,opt,name=Signature,proto3" json:"Signature,omitempty"`
+	OwnerID OwnerID `protobuf:"bytes,2,opt,name=OwnerID,proto3,customtype=OwnerID" json:"OwnerID"`
-	TTL                  uint32    `protobuf:"varint,5,opt,name=TTL,proto3" json:"TTL,omitempty"`
+	// MessageID is a nonce for uniq request (UUIDv4)
-	XXX_NoUnkeyedLiteral struct{}  `json:"-"`
+	MessageID MessageID `protobuf:"bytes,3,opt,name=MessageID,proto3,customtype=MessageID" json:"MessageID"`
-	XXX_unrecognized     []byte    `json:"-"`
+	// Signature is a signature of the sent request
-	XXX_sizecache        int32     `json:"-"`
+	Signature []byte `protobuf:"bytes,4,opt,name=Signature,proto3" json:"Signature,omitempty"`
+	// TTL must be larger than zero, it decreased in every neofs-node
+	TTL                  uint32   `protobuf:"varint,5,opt,name=TTL,proto3" json:"TTL,omitempty"`
+	XXX_NoUnkeyedLiteral struct{} `json:"-"`
+	XXX_unrecognized     []byte   `json:"-"`
+	XXX_sizecache        int32    `json:"-"`
 }
 
 func (m *DeleteRequest) Reset()         { *m = DeleteRequest{} }
@@ -423,6 +447,7 @@ func (m *DeleteRequest) GetTTL() uint32 {
 	return 0
 }
 
+// DeleteResponse is empty
 type DeleteResponse struct {
 	XXX_NoUnkeyedLiteral struct{} `json:"-"`
 	XXX_unrecognized     []byte   `json:"-"`
@@ -523,9 +548,13 @@ const _ = grpc.SupportPackageIsVersion4
 //
 // For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream.
 type WithdrawClient interface {
+	// Get returns cheque if it was signed by inner ring nodes
 	Get(ctx context.Context, in *GetRequest, opts ...grpc.CallOption) (*GetResponse, error)
+	// Put ask inner ring nodes to sign a cheque for withdraw invoke
 	Put(ctx context.Context, in *PutRequest, opts ...grpc.CallOption) (*PutResponse, error)
+	// List shows all user's checks
 	List(ctx context.Context, in *ListRequest, opts ...grpc.CallOption) (*ListResponse, error)
+	// Delete allows user to remove unused cheque
 	Delete(ctx context.Context, in *DeleteRequest, opts ...grpc.CallOption) (*DeleteResponse, error)
 }
 
@@ -575,9 +604,13 @@ func (c *withdrawClient) Delete(ctx context.Context, in *DeleteRequest, opts ...
 
 // WithdrawServer is the server API for Withdraw service.
 type WithdrawServer interface {
+	// Get returns cheque if it was signed by inner ring nodes
 	Get(context.Context, *GetRequest) (*GetResponse, error)
+	// Put ask inner ring nodes to sign a cheque for withdraw invoke
 	Put(context.Context, *PutRequest) (*PutResponse, error)
+	// List shows all user's checks
 	List(context.Context, *ListRequest) (*ListResponse, error)
+	// Delete allows user to remove unused cheque
 	Delete(context.Context, *DeleteRequest) (*DeleteResponse, error)
 }
 

accounting/withdraw.proto

@@ -7,55 +7,88 @@ import "github.com/gogo/protobuf/gogoproto/gogo.proto";
 
 option (gogoproto.stable_marshaler_all) = true;
 
+// Withdraw is a service that provides withdraw assets operations from the NeoFS
 service Withdraw {
+    // Get returns cheque if it was signed by inner ring nodes
     rpc Get(GetRequest) returns (GetResponse);
+    // Put ask inner ring nodes to sign a cheque for withdraw invoke
     rpc Put(PutRequest) returns (PutResponse);
+    // List shows all user's checks
     rpc List(ListRequest) returns (ListResponse);
+    // Delete allows user to remove unused cheque
     rpc Delete(DeleteRequest) returns (DeleteResponse);
 }
 
 message Item {
+    // ID is a cheque identifier
     bytes ID               = 1 [(gogoproto.customtype) = "ChequeID", (gogoproto.nullable) = false];
+    // OwnerID is a wallet address
     bytes OwnerID          = 2 [(gogoproto.customtype) = "OwnerID", (gogoproto.nullable) = false];
+    // Amount of funds
     decimal.Decimal Amount = 3;
+    // Height is the neo blockchain height until the cheque is valid
     uint64 Height          = 4;
+    // Payload contains cheque representation in bytes
     bytes Payload          = 5;
 }
 
 message GetRequest {
+    // ID is cheque identifier
     bytes ID      = 1 [(gogoproto.customtype) = "ChequeID", (gogoproto.nullable) = false];
+    // OwnerID is a wallet address
     bytes OwnerID = 2 [(gogoproto.customtype) = "OwnerID", (gogoproto.nullable) = false];
+    // TTL must be larger than zero, it decreased in every neofs-node
     uint32 TTL    = 3;
 }
+
 message GetResponse {
+    // Item is cheque with meta information
     Item Withdraw = 1;
 }
 
 message PutRequest {
+    // OwnerID is a wallet address
     bytes OwnerID          = 1 [(gogoproto.customtype) = "OwnerID", (gogoproto.nullable) = false];
+    // Amount of funds
     decimal.Decimal Amount = 2;
+    // Height is the neo blockchain height until the cheque is valid
     uint64 Height          = 3;
+    // MessageID is a nonce for uniq request (UUIDv4)
     bytes MessageID        = 4 [(gogoproto.customtype) = "MessageID", (gogoproto.nullable) = false];
+    // Signature is a signature of the sent request
     bytes Signature        = 5;
+    // TTL must be larger than zero, it decreased in every neofs-node
     uint32 TTL             = 6;
 }
 message PutResponse {
+    // ID is cheque identifier
     bytes ID = 1 [(gogoproto.customtype) = "ChequeID", (gogoproto.nullable) = false];
 }
 
 message ListRequest {
+    // OwnerID is a wallet address
     bytes OwnerID = 1 [(gogoproto.customtype) = "OwnerID", (gogoproto.nullable) = false];
+    // TTL must be larger than zero, it decreased in every neofs-node
     uint32 TTL    = 2;
 }
+
 message ListResponse {
+    // Item is a set of cheques with meta information
     repeated Item Items = 1;
 }
 
 message DeleteRequest {
+    // ID is cheque identifier
     bytes ID        = 1 [(gogoproto.customtype) = "ChequeID", (gogoproto.nullable) = false];
+    // OwnerID is a wallet address
     bytes OwnerID   = 2 [(gogoproto.customtype) = "OwnerID", (gogoproto.nullable) = false];
+    // MessageID is a nonce for uniq request (UUIDv4)
     bytes MessageID = 3 [(gogoproto.customtype) = "MessageID", (gogoproto.nullable) = false];
+    // Signature is a signature of the sent request
     bytes Signature = 4;
+    // TTL must be larger than zero, it decreased in every neofs-node
     uint32 TTL      = 5;
 }
+
+// DeleteResponse is empty
 message DeleteResponse {}

bootstrap/service.pb.go

@@ -27,10 +27,12 @@ var _ = math.Inf
 // proto package needs to be updated.
 const _ = proto.ProtoPackageIsVersion3 // please upgrade the proto package
 
-// Request message to communicate between DHT nodes
 type Request struct {
-	Type                 NodeType `protobuf:"varint,1,opt,name=type,proto3,customtype=NodeType" json:"type"`
+	// Type is NodeType, can be InnerRingNode (type=1) or StorageNode (type=2)
-	Info                 NodeInfo `protobuf:"bytes,2,opt,name=info,proto3" json:"info"`
+	Type NodeType `protobuf:"varint,1,opt,name=type,proto3,customtype=NodeType" json:"type"`
+	// Info contains information about node
+	Info NodeInfo `protobuf:"bytes,2,opt,name=info,proto3" json:"info"`
+	// TTL must be larger than zero, it decreased in every neofs-node
 	TTL                  uint32   `protobuf:"varint,3,opt,name=TTL,proto3" json:"TTL,omitempty"`
 	XXX_NoUnkeyedLiteral struct{} `json:"-"`
 	XXX_unrecognized     []byte   `json:"-"`
@@ -120,6 +122,7 @@ const _ = grpc.SupportPackageIsVersion4
 //
 // For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream.
 type BootstrapClient interface {
+	// Process is method that allows to register node in the network and receive actual netmap
 	Process(ctx context.Context, in *Request, opts ...grpc.CallOption) (*SpreadMap, error)
 }
 
@@ -142,6 +145,7 @@ func (c *bootstrapClient) Process(ctx context.Context, in *Request, opts ...grpc
 
 // BootstrapServer is the server API for Bootstrap service.
 type BootstrapServer interface {
+	// Process is method that allows to register node in the network and receive actual netmap
 	Process(context.Context, *Request) (*SpreadMap, error)
 }
 

bootstrap/service.proto

@@ -7,14 +7,19 @@ import "github.com/gogo/protobuf/gogoproto/gogo.proto";
 
 option (gogoproto.stable_marshaler_all) = true;
 
-// The Bootstrap service definition.
+// Bootstrap service allows neofs-node to connect to the network. Node should
+// perform at least one bootstrap request in the epoch to stay in the network
+// for the next epoch.
 service Bootstrap {
+    // Process is method that allows to register node in the network and receive actual netmap
     rpc Process(Request) returns (bootstrap.SpreadMap);
 }
 
-// Request message to communicate between DHT nodes
 message Request {
+    // Type is NodeType, can be InnerRingNode (type=1) or StorageNode (type=2)
     int32              type = 1 [(gogoproto.customname) = "Type" , (gogoproto.nullable) = false, (gogoproto.customtype) = "NodeType"];
+    // Info contains information about node
     bootstrap.NodeInfo info = 2 [(gogoproto.nullable) = false];
+    // TTL must be larger than zero, it decreased in every neofs-node
     uint32 TTL           = 3;
 }

bootstrap/types.pb.go

@@ -24,7 +24,9 @@ var _ = math.Inf
 const _ = proto.ProtoPackageIsVersion3 // please upgrade the proto package
 
 type SpreadMap struct {
-	Epoch                uint64     `protobuf:"varint,1,opt,name=Epoch,proto3" json:"Epoch,omitempty"`
+	// Epoch is current epoch for netmap
+	Epoch uint64 `protobuf:"varint,1,opt,name=Epoch,proto3" json:"Epoch,omitempty"`
+	// NetMap is a set of NodeInfos
 	NetMap               []NodeInfo `protobuf:"bytes,2,rep,name=NetMap,proto3" json:"NetMap"`
 	XXX_NoUnkeyedLiteral struct{}   `json:"-"`
 	XXX_unrecognized     []byte     `json:"-"`
@@ -74,9 +76,13 @@ func (m *SpreadMap) GetNetMap() []NodeInfo {
 }
 
 type NodeInfo struct {
-	Address              string     `protobuf:"bytes,1,opt,name=Address,proto3" json:"address"`
+	// Address is a node [multi-address](https://github.com/multiformats/multiaddr)
-	PubKey               []byte     `protobuf:"bytes,2,opt,name=PubKey,proto3" json:"pubkey,omitempty"`
+	Address string `protobuf:"bytes,1,opt,name=Address,proto3" json:"address"`
-	Options              []string   `protobuf:"bytes,3,rep,name=Options,proto3" json:"options,omitempty"`
+	// PubKey is a compressed public key representation in bytes
+	PubKey []byte `protobuf:"bytes,2,opt,name=PubKey,proto3" json:"pubkey,omitempty"`
+	// Options is set of node optional information, such as storage capacity, node location, price and etc
+	Options []string `protobuf:"bytes,3,rep,name=Options,proto3" json:"options,omitempty"`
+	// Status is bitmap status of the node
 	Status               NodeStatus `protobuf:"varint,4,opt,name=Status,proto3,customtype=NodeStatus" json:"status"`
 	XXX_NoUnkeyedLiteral struct{}   `json:"-"`
 	XXX_unrecognized     []byte     `json:"-"`

bootstrap/types.proto

@@ -10,13 +10,19 @@ option (gogoproto.stringer_all) =  false;
 option (gogoproto.goproto_stringer_all) = false;
 
 message SpreadMap {
+    // Epoch is current epoch for netmap
     uint64 Epoch = 1;
+    // NetMap is a set of NodeInfos
     repeated NodeInfo NetMap = 2 [(gogoproto.nullable) = false];
 }
 
 message NodeInfo {
+    // Address is a node [multi-address](https://github.com/multiformats/multiaddr)
     string Address          = 1 [(gogoproto.jsontag) = "address"];
+    // PubKey is a compressed public key representation in bytes
     bytes PubKey            = 2 [(gogoproto.jsontag) = "pubkey,omitempty"];
+    // Options is set of node optional information, such as storage capacity, node location, price and etc
     repeated string Options = 3 [(gogoproto.jsontag) = "options,omitempty"];
+    // Status is bitmap status of the node
     uint64 Status           = 4 [(gogoproto.jsontag) = "status", (gogoproto.nullable) = false, (gogoproto.customtype) = "NodeStatus"];
 }

container/service.pb.go

@@ -28,17 +28,22 @@ var _ = math.Inf
 // proto package needs to be updated.
 const _ = proto.ProtoPackageIsVersion3 // please upgrade the proto package
 
-// NewRequest message to create new container
 type PutRequest struct {
-	MessageID            MessageID            `protobuf:"bytes,1,opt,name=MessageID,proto3,customtype=MessageID" json:"MessageID"`
+	// MessageID is a nonce for uniq container id calculation
-	Capacity             uint64               `protobuf:"varint,2,opt,name=Capacity,proto3" json:"Capacity,omitempty"`
+	MessageID MessageID `protobuf:"bytes,1,opt,name=MessageID,proto3,customtype=MessageID" json:"MessageID"`
-	OwnerID              OwnerID              `protobuf:"bytes,3,opt,name=OwnerID,proto3,customtype=OwnerID" json:"OwnerID"`
+	// Capacity defines amount of data that can be stored in the container (doesn't used for now).
-	Rules                netmap.PlacementRule `protobuf:"bytes,4,opt,name=rules,proto3" json:"rules"`
+	Capacity uint64 `protobuf:"varint,2,opt,name=Capacity,proto3" json:"Capacity,omitempty"`
-	Signature            []byte               `protobuf:"bytes,5,opt,name=Signature,proto3" json:"Signature,omitempty"`
+	// OwnerID is a wallet address
-	TTL                  uint32               `protobuf:"varint,6,opt,name=TTL,proto3" json:"TTL,omitempty"`
+	OwnerID OwnerID `protobuf:"bytes,3,opt,name=OwnerID,proto3,customtype=OwnerID" json:"OwnerID"`
-	XXX_NoUnkeyedLiteral struct{}             `json:"-"`
+	// Rules define storage policy for the object inside the container.
-	XXX_unrecognized     []byte               `json:"-"`
+	Rules netmap.PlacementRule `protobuf:"bytes,4,opt,name=rules,proto3" json:"rules"`
-	XXX_sizecache        int32                `json:"-"`
+	// Signature of the user (owner id)
+	Signature []byte `protobuf:"bytes,5,opt,name=Signature,proto3" json:"Signature,omitempty"`
+	// TTL must be larger than zero, it decreased in every neofs-node
+	TTL                  uint32   `protobuf:"varint,6,opt,name=TTL,proto3" json:"TTL,omitempty"`
+	XXX_NoUnkeyedLiteral struct{} `json:"-"`
+	XXX_unrecognized     []byte   `json:"-"`
+	XXX_sizecache        int32    `json:"-"`
 }
 
 func (m *PutRequest) Reset()         { *m = PutRequest{} }
@@ -98,8 +103,8 @@ func (m *PutRequest) GetTTL() uint32 {
 	return 0
 }
 
-// PutResponse message to respond about container uuid
 type PutResponse struct {
+	// CID (container id) is a SHA256 hash of the container structure
 	CID                  CID      `protobuf:"bytes,1,opt,name=CID,proto3,customtype=CID" json:"CID"`
 	XXX_NoUnkeyedLiteral struct{} `json:"-"`
 	XXX_unrecognized     []byte   `json:"-"`
@@ -136,8 +141,11 @@ func (m *PutResponse) XXX_DiscardUnknown() {
 var xxx_messageInfo_PutResponse proto.InternalMessageInfo
 
 type DeleteRequest struct {
-	CID                  CID      `protobuf:"bytes,1,opt,name=CID,proto3,customtype=CID" json:"CID"`
+	// CID (container id) is a SHA256 hash of the container structure
-	TTL                  uint32   `protobuf:"varint,2,opt,name=TTL,proto3" json:"TTL,omitempty"`
+	CID CID `protobuf:"bytes,1,opt,name=CID,proto3,customtype=CID" json:"CID"`
+	// TTL must be larger than zero, it decreased in every neofs-node
+	TTL uint32 `protobuf:"varint,2,opt,name=TTL,proto3" json:"TTL,omitempty"`
+	// Signature of the container owner
 	Signature            []byte   `protobuf:"bytes,3,opt,name=Signature,proto3" json:"Signature,omitempty"`
 	XXX_NoUnkeyedLiteral struct{} `json:"-"`
 	XXX_unrecognized     []byte   `json:"-"`
@@ -187,6 +195,8 @@ func (m *DeleteRequest) GetSignature() []byte {
 	return nil
 }
 
+// DeleteResponse is empty because delete operation is asynchronous and done
+// via consensus in inner ring nodes
 type DeleteResponse struct {
 	XXX_NoUnkeyedLiteral struct{} `json:"-"`
 	XXX_unrecognized     []byte   `json:"-"`
@@ -222,9 +232,10 @@ func (m *DeleteResponse) XXX_DiscardUnknown() {
 
 var xxx_messageInfo_DeleteResponse proto.InternalMessageInfo
 
-// GetRequest message to fetch container placement rules
 type GetRequest struct {
-	CID                  CID      `protobuf:"bytes,1,opt,name=CID,proto3,customtype=CID" json:"CID"`
+	// CID (container id) is a SHA256 hash of the container structure
+	CID CID `protobuf:"bytes,1,opt,name=CID,proto3,customtype=CID" json:"CID"`
+	// TTL must be larger than zero, it decreased in every neofs-node
 	TTL                  uint32   `protobuf:"varint,2,opt,name=TTL,proto3" json:"TTL,omitempty"`
 	XXX_NoUnkeyedLiteral struct{} `json:"-"`
 	XXX_unrecognized     []byte   `json:"-"`
@@ -267,8 +278,8 @@ func (m *GetRequest) GetTTL() uint32 {
 	return 0
 }
 
-// GetResponse message with container structure
 type GetResponse struct {
+	// Container is a structure that contains placement rules and owner id
 	Container            *Container `protobuf:"bytes,1,opt,name=Container,proto3" json:"Container,omitempty"`
 	XXX_NoUnkeyedLiteral struct{}   `json:"-"`
 	XXX_unrecognized     []byte     `json:"-"`
@@ -311,9 +322,10 @@ func (m *GetResponse) GetContainer() *Container {
 	return nil
 }
 
-// ListRequest message to list containers for user
 type ListRequest struct {
-	OwnerID              OwnerID  `protobuf:"bytes,1,opt,name=OwnerID,proto3,customtype=OwnerID" json:"OwnerID"`
+	// OwnerID is a wallet address
+	OwnerID OwnerID `protobuf:"bytes,1,opt,name=OwnerID,proto3,customtype=OwnerID" json:"OwnerID"`
+	// TTL must be larger than zero, it decreased in every neofs-node
 	TTL                  uint32   `protobuf:"varint,2,opt,name=TTL,proto3" json:"TTL,omitempty"`
 	XXX_NoUnkeyedLiteral struct{} `json:"-"`
 	XXX_unrecognized     []byte   `json:"-"`
@@ -356,8 +368,8 @@ func (m *ListRequest) GetTTL() uint32 {
 	return 0
 }
 
-// ListResponse message to respond about all user containers
 type ListResponse struct {
+	// CID (container id) is list of SHA256 hashes of the container structures
 	CID                  []CID    `protobuf:"bytes,1,rep,name=CID,proto3,customtype=CID" json:"CID"`
 	XXX_NoUnkeyedLiteral struct{} `json:"-"`
 	XXX_unrecognized     []byte   `json:"-"`
@@ -455,12 +467,16 @@ const _ = grpc.SupportPackageIsVersion4
 //
 // For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream.
 type ServiceClient interface {
-	// Create container
+	// Put request proposes container to the inner ring nodes. They will
+	// accept new container if user has enough deposit. All containers
+	// are accepted by the consensus, therefore it is asynchronous process.
 	Put(ctx context.Context, in *PutRequest, opts ...grpc.CallOption) (*PutResponse, error)
-	// Delete container ... discuss implementation later
+	// Delete container removes it from the inner ring container storage. It
+	// also asynchronous process done by consensus.
 	Delete(ctx context.Context, in *DeleteRequest, opts ...grpc.CallOption) (*DeleteResponse, error)
-	// Get container
+	// Get container returns container instance
 	Get(ctx context.Context, in *GetRequest, opts ...grpc.CallOption) (*GetResponse, error)
+	// List returns all user's containers
 	List(ctx context.Context, in *ListRequest, opts ...grpc.CallOption) (*ListResponse, error)
 }
 
@@ -510,12 +526,16 @@ func (c *serviceClient) List(ctx context.Context, in *ListRequest, opts ...grpc.
 
 // ServiceServer is the server API for Service service.
 type ServiceServer interface {
-	// Create container
+	// Put request proposes container to the inner ring nodes. They will
+	// accept new container if user has enough deposit. All containers
+	// are accepted by the consensus, therefore it is asynchronous process.
 	Put(context.Context, *PutRequest) (*PutResponse, error)
-	// Delete container ... discuss implementation later
+	// Delete container removes it from the inner ring container storage. It
+	// also asynchronous process done by consensus.
 	Delete(context.Context, *DeleteRequest) (*DeleteResponse, error)
-	// Get container
+	// Get container returns container instance
 	Get(context.Context, *GetRequest) (*GetResponse, error)
+	// List returns all user's containers
 	List(context.Context, *ListRequest) (*ListResponse, error)
 }
 

container/service.proto

@@ -8,61 +8,87 @@ import "github.com/gogo/protobuf/gogoproto/gogo.proto";
 
 option (gogoproto.stable_marshaler_all) = true;
 
+// Container service provides API for manipulating with the container.
 service Service {
-    // Create container
+    // Put request proposes container to the inner ring nodes. They will
+    // accept new container if user has enough deposit. All containers
+    // are accepted by the consensus, therefore it is asynchronous process.
     rpc Put(PutRequest) returns (PutResponse);
 
-    // Delete container ... discuss implementation later
+    // Delete container removes it from the inner ring container storage. It
+    // also asynchronous process done by consensus.
     rpc Delete(DeleteRequest) returns (DeleteResponse);
 
-    // Get container
+    // Get container returns container instance
     rpc Get(GetRequest) returns (GetResponse);
 
+    // List returns all user's containers
     rpc List(ListRequest) returns (ListResponse);
 }
 
-// NewRequest message to create new container
 message PutRequest {
+    // MessageID is a nonce for uniq container id calculation
     bytes MessageID            = 1 [(gogoproto.customtype) = "MessageID", (gogoproto.nullable) = false];
-    uint64 Capacity            = 2; // not actual size in megabytes, but probability of storage availability
+
+    // Capacity defines amount of data that can be stored in the container (doesn't used for now).
+    uint64 Capacity            = 2;
+
+    // OwnerID is a wallet address
     bytes OwnerID              = 3 [(gogoproto.customtype) = "OwnerID", (gogoproto.nullable) = false];
+
+    // Rules define storage policy for the object inside the container.
     netmap.PlacementRule rules = 4 [(gogoproto.nullable) = false];
+
+    // Signature of the user (owner id)
     bytes Signature            = 5;
+
+    // TTL must be larger than zero, it decreased in every neofs-node
     uint32 TTL                 = 6;
 }
 
-// PutResponse message to respond about container uuid
 message PutResponse {
+    // CID (container id) is a SHA256 hash of the container structure
     bytes CID = 1 [(gogoproto.customtype) = "CID", (gogoproto.nullable) = false];
 }
 
 message DeleteRequest {
+    // CID (container id) is a SHA256 hash of the container structure
     bytes CID       = 1 [(gogoproto.customtype) = "CID", (gogoproto.nullable) = false];
+
+    // TTL must be larger than zero, it decreased in every neofs-node
     uint32 TTL      = 2;
+
+    // Signature of the container owner
     bytes Signature = 3;
 }
 
+// DeleteResponse is empty because delete operation is asynchronous and done
+// via consensus in inner ring nodes
 message DeleteResponse { }
 
 
-// GetRequest message to fetch container placement rules
 message GetRequest {
+    // CID (container id) is a SHA256 hash of the container structure
     bytes CID  = 1 [(gogoproto.customtype) = "CID", (gogoproto.nullable) = false];
+
+    // TTL must be larger than zero, it decreased in every neofs-node
     uint32 TTL = 2;
 }
 
-// GetResponse message with container structure
 message GetResponse {
+    // Container is a structure that contains placement rules and owner id
     container.Container Container = 1;
 }
 
-// ListRequest message to list containers for user
 message ListRequest {
+    // OwnerID is a wallet address
     bytes OwnerID = 1 [(gogoproto.customtype) = "OwnerID", (gogoproto.nullable) = false];
+
+    // TTL must be larger than zero, it decreased in every neofs-node
     uint32 TTL    = 2;
 }
 
-// ListResponse message to respond about all user containers
 message ListResponse {
+    // CID (container id) is list of SHA256 hashes of the container structures
     repeated bytes CID = 1 [(gogoproto.customtype) = "CID", (gogoproto.nullable) = false];
 }

container/types.proto

@@ -9,8 +9,8 @@ option (gogoproto.stable_marshaler_all) = true;
 
 // The Container service definition.
 message Container {
-    bytes OwnerID              = 1 [(gogoproto.customtype) = "OwnerID", (gogoproto.nullable) = false];
+    bytes OwnerID              = 1 [(gogoproto.customtype) = "OwnerID", (gogoproto.nullable) = false]; // OwnerID is a wallet address.
-    bytes Salt                 = 2 [(gogoproto.customtype) = "UUID",    (gogoproto.nullable) = false];
+    bytes Salt                 = 2 [(gogoproto.customtype) = "UUID",    (gogoproto.nullable) = false]; // Salt is a nonce for unique container id calculation.
-    uint64 Capacity            = 3;
+    uint64 Capacity            = 3; // Capacity defines amount of data that can be stored in the container (doesn't used for now).
-    netmap.PlacementRule Rules = 4 [(gogoproto.nullable) = false];
+    netmap.PlacementRule Rules = 4 [(gogoproto.nullable) = false]; // Rules define storage policy for the object inside the container.
 }

decimal/decimal.pb.go

@@ -23,8 +23,11 @@ var _ = math.Inf
 // proto package needs to be updated.
 const _ = proto.ProtoPackageIsVersion3 // please upgrade the proto package
 
+// Decimal is a structure used for representation of assets amount
 type Decimal struct {
-	Value                int64    `protobuf:"varint,1,opt,name=Value,proto3" json:"Value,omitempty"`
+	// Value is value number
+	Value int64 `protobuf:"varint,1,opt,name=Value,proto3" json:"Value,omitempty"`
+	// Precision is precision number
 	Precision            uint32   `protobuf:"varint,2,opt,name=Precision,proto3" json:"Precision,omitempty"`
 	XXX_NoUnkeyedLiteral struct{} `json:"-"`
 	XXX_unrecognized     []byte   `json:"-"`

decimal/decimal.proto

@@ -6,9 +6,12 @@ import "github.com/gogo/protobuf/gogoproto/gogo.proto";
 
 option (gogoproto.stable_marshaler_all) = true;
 
+// Decimal is a structure used for representation of assets amount
 message Decimal {
     option (gogoproto.goproto_stringer) = false;
 
+    // Value is value number
     int64 Value = 1;
+    // Precision is precision number
     uint32 Precision = 2;
 }

docs/accounting.md

@@ -0,0 +1,488 @@
+# Protocol Documentation
+<a name="top"></a>
+
+## Table of Contents
+
+- [accounting/service.proto](#accounting/service.proto)
+ - Services
+    - [Accounting](#accounting.Accounting)
+    
+  - Messages
+    - [BalanceRequest](#accounting.BalanceRequest)
+    - [BalanceResponse](#accounting.BalanceResponse)
+    
+
+- [accounting/types.proto](#accounting/types.proto)
+
+  - Messages
+    - [Account](#accounting.Account)
+    - [Balances](#accounting.Balances)
+    - [ContainerCreateTarget](#accounting.ContainerCreateTarget)
+    - [Lifetime](#accounting.Lifetime)
+    - [LockTarget](#accounting.LockTarget)
+    - [PayIO](#accounting.PayIO)
+    - [Settlement](#accounting.Settlement)
+    - [Settlement.Container](#accounting.Settlement.Container)
+    - [Settlement.Receiver](#accounting.Settlement.Receiver)
+    - [Settlement.Tx](#accounting.Settlement.Tx)
+    - [Tx](#accounting.Tx)
+    - [WithdrawTarget](#accounting.WithdrawTarget)
+    
+
+- [accounting/withdraw.proto](#accounting/withdraw.proto)
+ - Services
+    - [Withdraw](#accounting.Withdraw)
+    
+  - Messages
+    - [DeleteRequest](#accounting.DeleteRequest)
+    - [DeleteResponse](#accounting.DeleteResponse)
+    - [GetRequest](#accounting.GetRequest)
+    - [GetResponse](#accounting.GetResponse)
+    - [Item](#accounting.Item)
+    - [ListRequest](#accounting.ListRequest)
+    - [ListResponse](#accounting.ListResponse)
+    - [PutRequest](#accounting.PutRequest)
+    - [PutResponse](#accounting.PutResponse)
+    
+
+- [Scalar Value Types](#scalar-value-types)
+
+
+
+<a name="accounting/service.proto"></a>
+<p align="right"><a href="#top">Top</a></p>
+
+## accounting/service.proto
+
+
+
+
+<a name="accounting.Accounting"></a>
+
+### Service "accounting.Accounting"
+Accounting is a service that provides access for accounting balance
+information
+
+```
+rpc Balance(BalanceRequest) returns (BalanceResponse);
+
+```
+
+#### Method Balance
+
+Balance returns current balance status of the NeoFS user
+
+| Name | Input | Output |
+| ---- | ----- | ------ |
+| Balance | [BalanceRequest](#accounting.BalanceRequest) | [BalanceResponse](#accounting.BalanceResponse) |
+ <!-- end services -->
+
+
+<a name="accounting.BalanceRequest"></a>
+
+### Message BalanceRequest
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| OwnerID | [bytes](#bytes) |  | OwnerID is a wallet address |
+| TTL | [uint32](#uint32) |  | TTL must be larger than zero, it decreased in every neofs-node |
+
+
+<a name="accounting.BalanceResponse"></a>
+
+### Message BalanceResponse
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Balance | [decimal.Decimal](#decimal.Decimal) |  | Balance contains current account balance state |
+| LockAccounts | [Account](#accounting.Account) | repeated | LockAccounts contains information about locked funds. Locked funds appear when user pays for storage or withdraw assets. |
+
+ <!-- end messages -->
+
+ <!-- end enums -->
+
+
+
+<a name="accounting/types.proto"></a>
+<p align="right"><a href="#top">Top</a></p>
+
+## accounting/types.proto
+
+
+ <!-- end services -->
+
+
+<a name="accounting.Account"></a>
+
+### Message Account
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| OwnerID | [bytes](#bytes) |  | OwnerID is a wallet address |
+| Address | [string](#string) |  | Address is identifier of accounting record |
+| ParentAddress | [string](#string) |  | ParentAddress is identifier of parent accounting record |
+| ActiveFunds | [decimal.Decimal](#decimal.Decimal) |  | ActiveFunds is amount of active (non locked) funds for account |
+| Lifetime | [Lifetime](#accounting.Lifetime) |  | Lifetime is time until account is valid (used for lock accounts) |
+| LockTarget | [LockTarget](#accounting.LockTarget) |  | LockTarget is the purpose of lock funds (it might be withdraw or payment for storage) |
+| LockAccounts | [Account](#accounting.Account) | repeated | LockAccounts contains child accounts with locked funds |
+
+
+<a name="accounting.Balances"></a>
+
+### Message Balances
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Accounts | [Account](#accounting.Account) | repeated | Accounts contains multiple account snapshots |
+
+
+<a name="accounting.ContainerCreateTarget"></a>
+
+### Message ContainerCreateTarget
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| CID | [bytes](#bytes) |  | CID is container identifier |
+
+
+<a name="accounting.Lifetime"></a>
+
+### Message Lifetime
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| unit | [Lifetime.Unit](#accounting.Lifetime.Unit) |  | Unit describes how lifetime is measured in account |
+| Value | [int64](#int64) |  | Value describes how long lifetime will be valid |
+
+
+<a name="accounting.LockTarget"></a>
+
+### Message LockTarget
+LockTarget must be one of two options
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| WithdrawTarget | [WithdrawTarget](#accounting.WithdrawTarget) |  | WithdrawTarget used when user requested withdraw |
+| ContainerCreateTarget | [ContainerCreateTarget](#accounting.ContainerCreateTarget) |  | ContainerCreateTarget used when user requested creation of container |
+
+
+<a name="accounting.PayIO"></a>
+
+### Message PayIO
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| BlockID | [uint64](#uint64) |  | BlockID contains id of the NEO block where withdraw or deposit call was invoked |
+| Transactions | [Tx](#accounting.Tx) | repeated | Transactions contains all transactions that founded in block and used for PayIO |
+
+
+<a name="accounting.Settlement"></a>
+
+### Message Settlement
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Epoch | [uint64](#uint64) |  | Epoch contains an epoch when settlement was accepted |
+| Transactions | [Settlement.Tx](#accounting.Settlement.Tx) | repeated | Transactions is a set of transactions |
+
+
+<a name="accounting.Settlement.Container"></a>
+
+### Message Settlement.Container
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| CID | [bytes](#bytes) |  | CID is container identifier |
+| SGIDs | [bytes](#bytes) | repeated | SGIDs is a set of storage groups that successfully passed the audit |
+
+
+<a name="accounting.Settlement.Receiver"></a>
+
+### Message Settlement.Receiver
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| To | [string](#string) |  | To is the address of funds recipient |
+| Amount | [decimal.Decimal](#decimal.Decimal) |  | Amount is the amount of funds that will be sent |
+
+
+<a name="accounting.Settlement.Tx"></a>
+
+### Message Settlement.Tx
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| From | [string](#string) |  | From is the address of the sender of funds |
+| Container | [Settlement.Container](#accounting.Settlement.Container) |  | Container that successfully had passed the audit |
+| Receivers | [Settlement.Receiver](#accounting.Settlement.Receiver) | repeated | Receivers is a set of addresses of funds recipients |
+
+
+<a name="accounting.Tx"></a>
+
+### Message Tx
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| type | [Tx.Type](#accounting.Tx.Type) |  | Type describes target of transaction |
+| From | [string](#string) |  | From describes sender of funds |
+| To | [string](#string) |  | To describes receiver of funds |
+| Amount | [decimal.Decimal](#decimal.Decimal) |  | Amount describes amount of funds |
+| PublicKeys | [bytes](#bytes) |  | PublicKeys contains public key of sender |
+
+
+<a name="accounting.WithdrawTarget"></a>
+
+### Message WithdrawTarget
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Cheque | [string](#string) |  | Cheque is a string representation of cheque id |
+
+ <!-- end messages -->
+
+
+<a name="accounting.Lifetime.Unit"></a>
+
+### Lifetime.Unit
+Unit can be Unlimited, based on NeoFS epoch or Neo block
+
+| Name | Number | Description |
+| ---- | ------ | ----------- |
+| Unlimited | 0 |  |
+| NeoFSEpoch | 1 |  |
+| NeoBlock | 2 |  |
+
+
+
+<a name="accounting.Tx.Type"></a>
+
+### Tx.Type
+Type can be withdrawal, payIO or inner
+
+| Name | Number | Description |
+| ---- | ------ | ----------- |
+| Unknown | 0 |  |
+| Withdraw | 1 |  |
+| PayIO | 2 |  |
+| Inner | 3 |  |
+
+
+ <!-- end enums -->
+
+
+
+<a name="accounting/withdraw.proto"></a>
+<p align="right"><a href="#top">Top</a></p>
+
+## accounting/withdraw.proto
+
+
+
+
+<a name="accounting.Withdraw"></a>
+
+### Service "accounting.Withdraw"
+Withdraw is a service that provides withdraw assets operations from the NeoFS
+
+```
+rpc Get(GetRequest) returns (GetResponse);
+rpc Put(PutRequest) returns (PutResponse);
+rpc List(ListRequest) returns (ListResponse);
+rpc Delete(DeleteRequest) returns (DeleteResponse);
+
+```
+
+#### Method Get
+
+Get returns cheque if it was signed by inner ring nodes
+
+| Name | Input | Output |
+| ---- | ----- | ------ |
+| Get | [GetRequest](#accounting.GetRequest) | [GetResponse](#accounting.GetResponse) |
+#### Method Put
+
+Put ask inner ring nodes to sign a cheque for withdraw invoke
+
+| Name | Input | Output |
+| ---- | ----- | ------ |
+| Put | [PutRequest](#accounting.PutRequest) | [PutResponse](#accounting.PutResponse) |
+#### Method List
+
+List shows all user's checks
+
+| Name | Input | Output |
+| ---- | ----- | ------ |
+| List | [ListRequest](#accounting.ListRequest) | [ListResponse](#accounting.ListResponse) |
+#### Method Delete
+
+Delete allows user to remove unused cheque
+
+| Name | Input | Output |
+| ---- | ----- | ------ |
+| Delete | [DeleteRequest](#accounting.DeleteRequest) | [DeleteResponse](#accounting.DeleteResponse) |
+ <!-- end services -->
+
+
+<a name="accounting.DeleteRequest"></a>
+
+### Message DeleteRequest
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| ID | [bytes](#bytes) |  | ID is cheque identifier |
+| OwnerID | [bytes](#bytes) |  | OwnerID is a wallet address |
+| MessageID | [bytes](#bytes) |  | MessageID is a nonce for uniq request (UUIDv4) |
+| Signature | [bytes](#bytes) |  | Signature is a signature of the sent request |
+| TTL | [uint32](#uint32) |  | TTL must be larger than zero, it decreased in every neofs-node |
+
+
+<a name="accounting.DeleteResponse"></a>
+
+### Message DeleteResponse
+DeleteResponse is empty
+
+
+
+<a name="accounting.GetRequest"></a>
+
+### Message GetRequest
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| ID | [bytes](#bytes) |  | ID is cheque identifier |
+| OwnerID | [bytes](#bytes) |  | OwnerID is a wallet address |
+| TTL | [uint32](#uint32) |  | TTL must be larger than zero, it decreased in every neofs-node |
+
+
+<a name="accounting.GetResponse"></a>
+
+### Message GetResponse
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Withdraw | [Item](#accounting.Item) |  | Item is cheque with meta information |
+
+
+<a name="accounting.Item"></a>
+
+### Message Item
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| ID | [bytes](#bytes) |  | ID is a cheque identifier |
+| OwnerID | [bytes](#bytes) |  | OwnerID is a wallet address |
+| Amount | [decimal.Decimal](#decimal.Decimal) |  | Amount of funds |
+| Height | [uint64](#uint64) |  | Height is the neo blockchain height until the cheque is valid |
+| Payload | [bytes](#bytes) |  | Payload contains cheque representation in bytes |
+
+
+<a name="accounting.ListRequest"></a>
+
+### Message ListRequest
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| OwnerID | [bytes](#bytes) |  | OwnerID is a wallet address |
+| TTL | [uint32](#uint32) |  | TTL must be larger than zero, it decreased in every neofs-node |
+
+
+<a name="accounting.ListResponse"></a>
+
+### Message ListResponse
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Items | [Item](#accounting.Item) | repeated | Item is a set of cheques with meta information |
+
+
+<a name="accounting.PutRequest"></a>
+
+### Message PutRequest
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| OwnerID | [bytes](#bytes) |  | OwnerID is a wallet address |
+| Amount | [decimal.Decimal](#decimal.Decimal) |  | Amount of funds |
+| Height | [uint64](#uint64) |  | Height is the neo blockchain height until the cheque is valid |
+| MessageID | [bytes](#bytes) |  | MessageID is a nonce for uniq request (UUIDv4) |
+| Signature | [bytes](#bytes) |  | Signature is a signature of the sent request |
+| TTL | [uint32](#uint32) |  | TTL must be larger than zero, it decreased in every neofs-node |
+
+
+<a name="accounting.PutResponse"></a>
+
+### Message PutResponse
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| ID | [bytes](#bytes) |  | ID is cheque identifier |
+
+ <!-- end messages -->
+
+ <!-- end enums -->
+
+
+
+## Scalar Value Types
+
+| .proto Type | Notes | C++ Type | Java Type | Python Type |
+| ----------- | ----- | -------- | --------- | ----------- |
+| <a name="double" /> double |  | double | double | float |
+| <a name="float" /> float |  | float | float | float |
+| <a name="int32" /> int32 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead. | int32 | int | int |
+| <a name="int64" /> int64 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead. | int64 | long | int/long |
+| <a name="uint32" /> uint32 | Uses variable-length encoding. | uint32 | int | int/long |
+| <a name="uint64" /> uint64 | Uses variable-length encoding. | uint64 | long | int/long |
+| <a name="sint32" /> sint32 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s. | int32 | int | int |
+| <a name="sint64" /> sint64 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s. | int64 | long | int/long |
+| <a name="fixed32" /> fixed32 | Always four bytes. More efficient than uint32 if values are often greater than 2^28. | uint32 | int | int |
+| <a name="fixed64" /> fixed64 | Always eight bytes. More efficient than uint64 if values are often greater than 2^56. | uint64 | long | int/long |
+| <a name="sfixed32" /> sfixed32 | Always four bytes. | int32 | int | int |
+| <a name="sfixed64" /> sfixed64 | Always eight bytes. | int64 | long | int/long |
+| <a name="bool" /> bool |  | bool | boolean | boolean |
+| <a name="string" /> string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode |
+| <a name="bytes" /> bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str |
+

docs/bootstrap.md

@@ -0,0 +1,132 @@
+# Protocol Documentation
+<a name="top"></a>
+
+## Table of Contents
+
+- [bootstrap/service.proto](#bootstrap/service.proto)
+ - Services
+    - [Bootstrap](#bootstrap.Bootstrap)
+    
+  - Messages
+    - [Request](#bootstrap.Request)
+    
+
+- [bootstrap/types.proto](#bootstrap/types.proto)
+
+  - Messages
+    - [NodeInfo](#bootstrap.NodeInfo)
+    - [SpreadMap](#bootstrap.SpreadMap)
+    
+
+- [Scalar Value Types](#scalar-value-types)
+
+
+
+<a name="bootstrap/service.proto"></a>
+<p align="right"><a href="#top">Top</a></p>
+
+## bootstrap/service.proto
+
+
+
+
+<a name="bootstrap.Bootstrap"></a>
+
+### Service "bootstrap.Bootstrap"
+Bootstrap service allows neofs-node to connect to the network. Node should
+perform at least one bootstrap request in the epoch to stay in the network
+for the next epoch.
+
+```
+rpc Process(Request) returns (SpreadMap);
+
+```
+
+#### Method Process
+
+Process is method that allows to register node in the network and receive actual netmap
+
+| Name | Input | Output |
+| ---- | ----- | ------ |
+| Process | [Request](#bootstrap.Request) | [SpreadMap](#bootstrap.SpreadMap) |
+ <!-- end services -->
+
+
+<a name="bootstrap.Request"></a>
+
+### Message Request
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| type | [int32](#int32) |  | Type is NodeType, can be InnerRingNode (type=1) or StorageNode (type=2) |
+| info | [NodeInfo](#bootstrap.NodeInfo) |  | Info contains information about node |
+| TTL | [uint32](#uint32) |  | TTL must be larger than zero, it decreased in every neofs-node |
+
+ <!-- end messages -->
+
+ <!-- end enums -->
+
+
+
+<a name="bootstrap/types.proto"></a>
+<p align="right"><a href="#top">Top</a></p>
+
+## bootstrap/types.proto
+
+
+ <!-- end services -->
+
+
+<a name="bootstrap.NodeInfo"></a>
+
+### Message NodeInfo
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Address | [string](#string) |  | Address is a node [multi-address](https://github.com/multiformats/multiaddr) |
+| PubKey | [bytes](#bytes) |  | PubKey is a compressed public key representation in bytes |
+| Options | [string](#string) | repeated | Options is set of node optional information, such as storage capacity, node location, price and etc |
+| Status | [uint64](#uint64) |  | Status is bitmap status of the node |
+
+
+<a name="bootstrap.SpreadMap"></a>
+
+### Message SpreadMap
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Epoch | [uint64](#uint64) |  | Epoch is current epoch for netmap |
+| NetMap | [NodeInfo](#bootstrap.NodeInfo) | repeated | NetMap is a set of NodeInfos |
+
+ <!-- end messages -->
+
+ <!-- end enums -->
+
+
+
+## Scalar Value Types
+
+| .proto Type | Notes | C++ Type | Java Type | Python Type |
+| ----------- | ----- | -------- | --------- | ----------- |
+| <a name="double" /> double |  | double | double | float |
+| <a name="float" /> float |  | float | float | float |
+| <a name="int32" /> int32 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead. | int32 | int | int |
+| <a name="int64" /> int64 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead. | int64 | long | int/long |
+| <a name="uint32" /> uint32 | Uses variable-length encoding. | uint32 | int | int/long |
+| <a name="uint64" /> uint64 | Uses variable-length encoding. | uint64 | long | int/long |
+| <a name="sint32" /> sint32 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s. | int32 | int | int |
+| <a name="sint64" /> sint64 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s. | int64 | long | int/long |
+| <a name="fixed32" /> fixed32 | Always four bytes. More efficient than uint32 if values are often greater than 2^28. | uint32 | int | int |
+| <a name="fixed64" /> fixed64 | Always eight bytes. More efficient than uint64 if values are often greater than 2^56. | uint64 | long | int/long |
+| <a name="sfixed32" /> sfixed32 | Always four bytes. | int32 | int | int |
+| <a name="sfixed64" /> sfixed64 | Always eight bytes. | int64 | long | int/long |
+| <a name="bool" /> bool |  | bool | boolean | boolean |
+| <a name="string" /> string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode |
+| <a name="bytes" /> bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str |
+

docs/container.md

@@ -0,0 +1,232 @@
+# Protocol Documentation
+<a name="top"></a>
+
+## Table of Contents
+
+- [container/service.proto](#container/service.proto)
+ - Services
+    - [Service](#container.Service)
+    
+  - Messages
+    - [DeleteRequest](#container.DeleteRequest)
+    - [DeleteResponse](#container.DeleteResponse)
+    - [GetRequest](#container.GetRequest)
+    - [GetResponse](#container.GetResponse)
+    - [ListRequest](#container.ListRequest)
+    - [ListResponse](#container.ListResponse)
+    - [PutRequest](#container.PutRequest)
+    - [PutResponse](#container.PutResponse)
+    
+
+- [container/types.proto](#container/types.proto)
+
+  - Messages
+    - [Container](#container.Container)
+    
+
+- [Scalar Value Types](#scalar-value-types)
+
+
+
+<a name="container/service.proto"></a>
+<p align="right"><a href="#top">Top</a></p>
+
+## container/service.proto
+
+
+
+
+<a name="container.Service"></a>
+
+### Service "container.Service"
+Container service provides API for manipulating with the container.
+
+```
+rpc Put(PutRequest) returns (PutResponse);
+rpc Delete(DeleteRequest) returns (DeleteResponse);
+rpc Get(GetRequest) returns (GetResponse);
+rpc List(ListRequest) returns (ListResponse);
+
+```
+
+#### Method Put
+
+Put request proposes container to the inner ring nodes. They will
+accept new container if user has enough deposit. All containers
+are accepted by the consensus, therefore it is asynchronous process.
+
+| Name | Input | Output |
+| ---- | ----- | ------ |
+| Put | [PutRequest](#container.PutRequest) | [PutResponse](#container.PutResponse) |
+#### Method Delete
+
+Delete container removes it from the inner ring container storage. It
+also asynchronous process done by consensus.
+
+| Name | Input | Output |
+| ---- | ----- | ------ |
+| Delete | [DeleteRequest](#container.DeleteRequest) | [DeleteResponse](#container.DeleteResponse) |
+#### Method Get
+
+Get container returns container instance
+
+| Name | Input | Output |
+| ---- | ----- | ------ |
+| Get | [GetRequest](#container.GetRequest) | [GetResponse](#container.GetResponse) |
+#### Method List
+
+List returns all user's containers
+
+| Name | Input | Output |
+| ---- | ----- | ------ |
+| List | [ListRequest](#container.ListRequest) | [ListResponse](#container.ListResponse) |
+ <!-- end services -->
+
+
+<a name="container.DeleteRequest"></a>
+
+### Message DeleteRequest
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| CID | [bytes](#bytes) |  | CID (container id) is a SHA256 hash of the container structure |
+| TTL | [uint32](#uint32) |  | TTL must be larger than zero, it decreased in every neofs-node |
+| Signature | [bytes](#bytes) |  | Signature of the container owner |
+
+
+<a name="container.DeleteResponse"></a>
+
+### Message DeleteResponse
+DeleteResponse is empty because delete operation is asynchronous and done
+via consensus in inner ring nodes
+
+
+
+<a name="container.GetRequest"></a>
+
+### Message GetRequest
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| CID | [bytes](#bytes) |  | CID (container id) is a SHA256 hash of the container structure |
+| TTL | [uint32](#uint32) |  | TTL must be larger than zero, it decreased in every neofs-node |
+
+
+<a name="container.GetResponse"></a>
+
+### Message GetResponse
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Container | [Container](#container.Container) |  | Container is a structure that contains placement rules and owner id |
+
+
+<a name="container.ListRequest"></a>
+
+### Message ListRequest
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| OwnerID | [bytes](#bytes) |  | OwnerID is a wallet address |
+| TTL | [uint32](#uint32) |  | TTL must be larger than zero, it decreased in every neofs-node |
+
+
+<a name="container.ListResponse"></a>
+
+### Message ListResponse
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| CID | [bytes](#bytes) | repeated | CID (container id) is list of SHA256 hashes of the container structures |
+
+
+<a name="container.PutRequest"></a>
+
+### Message PutRequest
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| MessageID | [bytes](#bytes) |  | MessageID is a nonce for uniq container id calculation |
+| Capacity | [uint64](#uint64) |  | Capacity defines amount of data that can be stored in the container (doesn't used for now). |
+| OwnerID | [bytes](#bytes) |  | OwnerID is a wallet address |
+| rules | [netmap.PlacementRule](#netmap.PlacementRule) |  | Rules define storage policy for the object inside the container. |
+| Signature | [bytes](#bytes) |  | Signature of the user (owner id) |
+| TTL | [uint32](#uint32) |  | TTL must be larger than zero, it decreased in every neofs-node |
+
+
+<a name="container.PutResponse"></a>
+
+### Message PutResponse
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| CID | [bytes](#bytes) |  | CID (container id) is a SHA256 hash of the container structure |
+
+ <!-- end messages -->
+
+ <!-- end enums -->
+
+
+
+<a name="container/types.proto"></a>
+<p align="right"><a href="#top">Top</a></p>
+
+## container/types.proto
+
+
+ <!-- end services -->
+
+
+<a name="container.Container"></a>
+
+### Message Container
+The Container service definition.
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| OwnerID | [bytes](#bytes) |  | OwnerID is a wallet address. |
+| Salt | [bytes](#bytes) |  | Salt is a nonce for unique container id calculation. |
+| Capacity | [uint64](#uint64) |  | Capacity defines amount of data that can be stored in the container (doesn't used for now). |
+| Rules | [netmap.PlacementRule](#netmap.PlacementRule) |  | Rules define storage policy for the object inside the container. |
+
+ <!-- end messages -->
+
+ <!-- end enums -->
+
+
+
+## Scalar Value Types
+
+| .proto Type | Notes | C++ Type | Java Type | Python Type |
+| ----------- | ----- | -------- | --------- | ----------- |
+| <a name="double" /> double |  | double | double | float |
+| <a name="float" /> float |  | float | float | float |
+| <a name="int32" /> int32 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead. | int32 | int | int |
+| <a name="int64" /> int64 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead. | int64 | long | int/long |
+| <a name="uint32" /> uint32 | Uses variable-length encoding. | uint32 | int | int/long |
+| <a name="uint64" /> uint64 | Uses variable-length encoding. | uint64 | long | int/long |
+| <a name="sint32" /> sint32 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s. | int32 | int | int |
+| <a name="sint64" /> sint64 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s. | int64 | long | int/long |
+| <a name="fixed32" /> fixed32 | Always four bytes. More efficient than uint32 if values are often greater than 2^28. | uint32 | int | int |
+| <a name="fixed64" /> fixed64 | Always eight bytes. More efficient than uint64 if values are often greater than 2^56. | uint64 | long | int/long |
+| <a name="sfixed32" /> sfixed32 | Always four bytes. | int32 | int | int |
+| <a name="sfixed64" /> sfixed64 | Always eight bytes. | int64 | long | int/long |
+| <a name="bool" /> bool |  | bool | boolean | boolean |
+| <a name="string" /> string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode |
+| <a name="bytes" /> bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str |
+

docs/decimal.md

@@ -0,0 +1,61 @@
+# Protocol Documentation
+<a name="top"></a>
+
+## Table of Contents
+
+- [decimal/decimal.proto](#decimal/decimal.proto)
+
+  - Messages
+    - [Decimal](#decimal.Decimal)
+    
+
+- [Scalar Value Types](#scalar-value-types)
+
+
+
+<a name="decimal/decimal.proto"></a>
+<p align="right"><a href="#top">Top</a></p>
+
+## decimal/decimal.proto
+
+
+ <!-- end services -->
+
+
+<a name="decimal.Decimal"></a>
+
+### Message Decimal
+Decimal is a structure used for representation of assets amount
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Value | [int64](#int64) |  | Value is value number |
+| Precision | [uint32](#uint32) |  | Precision is precision number |
+
+ <!-- end messages -->
+
+ <!-- end enums -->
+
+
+
+## Scalar Value Types
+
+| .proto Type | Notes | C++ Type | Java Type | Python Type |
+| ----------- | ----- | -------- | --------- | ----------- |
+| <a name="double" /> double |  | double | double | float |
+| <a name="float" /> float |  | float | float | float |
+| <a name="int32" /> int32 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead. | int32 | int | int |
+| <a name="int64" /> int64 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead. | int64 | long | int/long |
+| <a name="uint32" /> uint32 | Uses variable-length encoding. | uint32 | int | int/long |
+| <a name="uint64" /> uint64 | Uses variable-length encoding. | uint64 | long | int/long |
+| <a name="sint32" /> sint32 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s. | int32 | int | int |
+| <a name="sint64" /> sint64 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s. | int64 | long | int/long |
+| <a name="fixed32" /> fixed32 | Always four bytes. More efficient than uint32 if values are often greater than 2^28. | uint32 | int | int |
+| <a name="fixed64" /> fixed64 | Always eight bytes. More efficient than uint64 if values are often greater than 2^56. | uint64 | long | int/long |
+| <a name="sfixed32" /> sfixed32 | Always four bytes. | int32 | int | int |
+| <a name="sfixed64" /> sfixed64 | Always eight bytes. | int64 | long | int/long |
+| <a name="bool" /> bool |  | bool | boolean | boolean |
+| <a name="string" /> string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode |
+| <a name="bytes" /> bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str |
+

docs/object.md

@@ -0,0 +1,566 @@
+# Protocol Documentation
+<a name="top"></a>
+
+## Table of Contents
+
+- [object/service.proto](#object/service.proto)
+ - Services
+    - [Service](#object.Service)
+    
+  - Messages
+    - [DeleteRequest](#object.DeleteRequest)
+    - [DeleteResponse](#object.DeleteResponse)
+    - [GetRangeHashRequest](#object.GetRangeHashRequest)
+    - [GetRangeHashResponse](#object.GetRangeHashResponse)
+    - [GetRangeRequest](#object.GetRangeRequest)
+    - [GetRangeResponse](#object.GetRangeResponse)
+    - [GetRequest](#object.GetRequest)
+    - [GetResponse](#object.GetResponse)
+    - [HeadRequest](#object.HeadRequest)
+    - [HeadResponse](#object.HeadResponse)
+    - [PutRequest](#object.PutRequest)
+    - [PutRequest.PutHeader](#object.PutRequest.PutHeader)
+    - [PutResponse](#object.PutResponse)
+    - [SearchRequest](#object.SearchRequest)
+    - [SearchResponse](#object.SearchResponse)
+    
+
+- [object/types.proto](#object/types.proto)
+
+  - Messages
+    - [CreationPoint](#object.CreationPoint)
+    - [Header](#object.Header)
+    - [IntegrityHeader](#object.IntegrityHeader)
+    - [Link](#object.Link)
+    - [Object](#object.Object)
+    - [Range](#object.Range)
+    - [StorageGroup](#object.StorageGroup)
+    - [StorageGroup.Lifetime](#object.StorageGroup.Lifetime)
+    - [SystemHeader](#object.SystemHeader)
+    - [Tombstone](#object.Tombstone)
+    - [Transform](#object.Transform)
+    - [UserHeader](#object.UserHeader)
+    
+
+- [Scalar Value Types](#scalar-value-types)
+
+
+
+<a name="object/service.proto"></a>
+<p align="right"><a href="#top">Top</a></p>
+
+## object/service.proto
+
+
+
+
+<a name="object.Service"></a>
+
+### Service "object.Service"
+Object service provides API for manipulating with the object.
+
+```
+rpc Get(GetRequest) returns (stream GetResponse);
+rpc Put(stream PutRequest) returns (PutResponse);
+rpc Delete(DeleteRequest) returns (DeleteResponse);
+rpc Head(HeadRequest) returns (HeadResponse);
+rpc Search(SearchRequest) returns (SearchResponse);
+rpc GetRange(GetRangeRequest) returns (GetRangeResponse);
+rpc GetRangeHash(GetRangeHashRequest) returns (GetRangeHashResponse);
+
+```
+
+#### Method Get
+
+Get the object from container. Response uses gRPC stream. First response
+message carry object of requested address. Chunk messages are parts of
+the object's payload if it is needed. All messages except first carry
+chunks. Requested object can be restored by concatenation of object
+message payload and all chunks keeping receiving order.
+
+| Name | Input | Output |
+| ---- | ----- | ------ |
+| Get | [GetRequest](#object.GetRequest) | [GetResponse](#object.GetResponse) |
+#### Method Put
+
+Put the object into container. Request uses gRPC stream. First message
+SHOULD BE type of PutHeader. Container id and Owner id of object SHOULD
+BE set. Session token SHOULD BE obtained before put operation (see
+session package). Chunk messages considered by server as part of object
+payload. All messages except first SHOULD BE chunks. Chunk messages
+SHOULD BE sent in direct order of fragmentation.
+
+| Name | Input | Output |
+| ---- | ----- | ------ |
+| Put | [PutRequest](#object.PutRequest) | [PutResponse](#object.PutResponse) |
+#### Method Delete
+
+Delete the object from a container
+
+| Name | Input | Output |
+| ---- | ----- | ------ |
+| Delete | [DeleteRequest](#object.DeleteRequest) | [DeleteResponse](#object.DeleteResponse) |
+#### Method Head
+
+Head returns the object without data payload. Object in the
+response has system header only. If full headers flag is set, extended
+headers are also present.
+
+| Name | Input | Output |
+| ---- | ----- | ------ |
+| Head | [HeadRequest](#object.HeadRequest) | [HeadResponse](#object.HeadResponse) |
+#### Method Search
+
+Search objects in container. Version of query language format SHOULD BE
+set to 1. Search query represented in serialized format (see query
+package).
+
+| Name | Input | Output |
+| ---- | ----- | ------ |
+| Search | [SearchRequest](#object.SearchRequest) | [SearchResponse](#object.SearchResponse) |
+#### Method GetRange
+
+GetRange of data payload. Ranges are set of pairs (offset, length).
+Fragments order in response corresponds to ranges order in request.
+
+| Name | Input | Output |
+| ---- | ----- | ------ |
+| GetRange | [GetRangeRequest](#object.GetRangeRequest) | [GetRangeResponse](#object.GetRangeResponse) |
+#### Method GetRangeHash
+
+GetRangeHash returns homomorphic hash of object payload range after XOR
+operation. Ranges are set of pairs (offset, length). Hashes order in
+response corresponds to ranges order in request. Homomorphic hash is
+calculated for XORed data.
+
+| Name | Input | Output |
+| ---- | ----- | ------ |
+| GetRangeHash | [GetRangeHashRequest](#object.GetRangeHashRequest) | [GetRangeHashResponse](#object.GetRangeHashResponse) |
+ <!-- end services -->
+
+
+<a name="object.DeleteRequest"></a>
+
+### Message DeleteRequest
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Epoch | [uint64](#uint64) |  | Epoch is set by user to 0, node set epoch to the actual value |
+| Address | [refs.Address](#refs.Address) |  | Address of object (container id + object id) |
+| OwnerID | [bytes](#bytes) |  | OwnerID is a wallet address |
+| TTL | [uint32](#uint32) |  | TTL must be larger than zero, it decreased in every neofs-node |
+| Token | [session.Token](#session.Token) |  | Token with session public key and user's signature |
+
+
+<a name="object.DeleteResponse"></a>
+
+### Message DeleteResponse
+DeleteResponse is empty because we cannot guarantee permanent object removal
+in distributed system.
+
+
+
+<a name="object.GetRangeHashRequest"></a>
+
+### Message GetRangeHashRequest
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Epoch | [uint64](#uint64) |  | Epoch is set by user to 0, node set epoch to the actual value |
+| Address | [refs.Address](#refs.Address) |  | Address of object (container id + object id) |
+| Ranges | [Range](#object.Range) | repeated | Ranges of object's payload to calculate homomorphic hash |
+| Salt | [bytes](#bytes) |  | Salt is used to XOR object's payload ranges before hashing, it can be nil |
+| TTL | [uint32](#uint32) |  | TTL must be larger than zero, it decreased in every neofs-node |
+
+
+<a name="object.GetRangeHashResponse"></a>
+
+### Message GetRangeHashResponse
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Hashes | [bytes](#bytes) | repeated | Homomorphic hashes of all ranges |
+
+
+<a name="object.GetRangeRequest"></a>
+
+### Message GetRangeRequest
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Epoch | [uint64](#uint64) |  | Epoch is set by user to 0, node set epoch to the actual value |
+| Address | [refs.Address](#refs.Address) |  | Address of object (container id + object id) |
+| Ranges | [Range](#object.Range) | repeated | Ranges of object's payload to return |
+| TTL | [uint32](#uint32) |  | TTL must be larger than zero, it decreased in every neofs-node |
+
+
+<a name="object.GetRangeResponse"></a>
+
+### Message GetRangeResponse
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Fragments | [bytes](#bytes) | repeated | Fragments of object's payload |
+
+
+<a name="object.GetRequest"></a>
+
+### Message GetRequest
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Epoch | [uint64](#uint64) |  | Epoch is set by user to 0, node set epoch to the actual value |
+| Address | [refs.Address](#refs.Address) |  | Address of object (container id + object id) |
+| TTL | [uint32](#uint32) |  | TTL must be larger than zero, it decreased in every neofs-node |
+
+
+<a name="object.GetResponse"></a>
+
+### Message GetResponse
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| object | [Object](#object.Object) |  | Object header and some payload |
+| Chunk | [bytes](#bytes) |  | Chunk of remaining payload |
+
+
+<a name="object.HeadRequest"></a>
+
+### Message HeadRequest
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Epoch | [uint64](#uint64) |  | Epoch is set by user to 0, node set epoch to the actual value |
+| Address | [refs.Address](#refs.Address) |  | Address of object (container id + object id) |
+| FullHeaders | [bool](#bool) |  | FullHeaders can be set true for extended headers in the object |
+| TTL | [uint32](#uint32) |  | TTL must be larger than zero, it decreased in every neofs-node |
+
+
+<a name="object.HeadResponse"></a>
+
+### Message HeadResponse
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Object | [Object](#object.Object) |  | Object without payload |
+
+
+<a name="object.PutRequest"></a>
+
+### Message PutRequest
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Header | [PutRequest.PutHeader](#object.PutRequest.PutHeader) |  | Header should be the first message in the stream |
+| Chunk | [bytes](#bytes) |  | Chunk should be a remaining message in stream should be chunks |
+
+
+<a name="object.PutRequest.PutHeader"></a>
+
+### Message PutRequest.PutHeader
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Epoch | [uint64](#uint64) |  | Epoch is set by user to 0, node set epoch to the actual value |
+| Object | [Object](#object.Object) |  | Object with at least container id and owner id fields |
+| TTL | [uint32](#uint32) |  | TTL must be larger than zero, it decreased in every neofs-node |
+| Token | [session.Token](#session.Token) |  | Token with session public key and user's signature |
+
+
+<a name="object.PutResponse"></a>
+
+### Message PutResponse
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Address | [refs.Address](#refs.Address) |  | Address of object (container id + object id) |
+
+
+<a name="object.SearchRequest"></a>
+
+### Message SearchRequest
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Epoch | [uint64](#uint64) |  | Epoch is set by user to 0, node set epoch to the actual value |
+| Version | [uint32](#uint32) |  | Version of search query format |
+| ContainerID | [bytes](#bytes) |  | ContainerID for searching the object |
+| Query | [bytes](#bytes) |  | Query in the binary serialized format |
+| TTL | [uint32](#uint32) |  | TTL must be larger than zero, it decreased in every neofs-node |
+
+
+<a name="object.SearchResponse"></a>
+
+### Message SearchResponse
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Addresses | [refs.Address](#refs.Address) | repeated | Addresses of found objects |
+
+ <!-- end messages -->
+
+ <!-- end enums -->
+
+
+
+<a name="object/types.proto"></a>
+<p align="right"><a href="#top">Top</a></p>
+
+## object/types.proto
+
+
+ <!-- end services -->
+
+
+<a name="object.CreationPoint"></a>
+
+### Message CreationPoint
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| UnixTime | [int64](#int64) |  | Date of creation in unixtime format |
+| Epoch | [uint64](#uint64) |  | Date of creation in NeoFS epochs |
+
+
+<a name="object.Header"></a>
+
+### Message Header
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Link | [Link](#object.Link) |  | Link to other objects |
+| Redirect | [refs.Address](#refs.Address) |  | RedirectNot used yet |
+| UserHeader | [UserHeader](#object.UserHeader) |  | UserHeader defined by user |
+| Transform | [Transform](#object.Transform) |  | Transform defines transform operation (e.g. payload split) |
+| Tombstone | [Tombstone](#object.Tombstone) |  | Tombstone header that set up in deleted objects |
+| Verify | [session.VerificationHeader](#session.VerificationHeader) |  | Verify header that contains session public key and user's signature |
+| HomoHash | [bytes](#bytes) |  | Homomorphic hash of original object payload |
+| PayloadChecksum | [bytes](#bytes) |  | PayloadChecksum of actual object's payload |
+| Integrity | [IntegrityHeader](#object.IntegrityHeader) |  | Integrity header with checksum of all above headers in the object |
+| StorageGroup | [StorageGroup](#object.StorageGroup) |  | StorageGroup contains meta information for the data audit |
+
+
+<a name="object.IntegrityHeader"></a>
+
+### Message IntegrityHeader
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| HeadersChecksum | [bytes](#bytes) |  | Checksum of all above headers in the object |
+| ChecksumSignature | [bytes](#bytes) |  | User's signature of checksum to verify if it is correct |
+
+
+<a name="object.Link"></a>
+
+### Message Link
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| type | [Link.Type](#object.Link.Type) |  | Link type |
+| ID | [bytes](#bytes) |  | Object id |
+
+
+<a name="object.Object"></a>
+
+### Message Object
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| SystemHeader | [SystemHeader](#object.SystemHeader) |  | System header |
+| Headers | [Header](#object.Header) | repeated | Extended headers |
+| Payload | [bytes](#bytes) |  | Object's payload |
+
+
+<a name="object.Range"></a>
+
+### Message Range
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Offset | [uint64](#uint64) |  | Offset of the data range |
+| Length | [uint64](#uint64) |  | Length of the data range |
+
+
+<a name="object.StorageGroup"></a>
+
+### Message StorageGroup
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| ValidationDataSize | [uint64](#uint64) |  | Size of the all object's payloads included into storage group |
+| ValidationHash | [bytes](#bytes) |  | Homomorphic hash of all object's payloads included into storage group |
+| lifetime | [StorageGroup.Lifetime](#object.StorageGroup.Lifetime) |  | Time until storage group is valid |
+
+
+<a name="object.StorageGroup.Lifetime"></a>
+
+### Message StorageGroup.Lifetime
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| unit | [StorageGroup.Lifetime.Unit](#object.StorageGroup.Lifetime.Unit) |  | Lifetime type |
+| Value | [int64](#int64) |  | Lifetime value |
+
+
+<a name="object.SystemHeader"></a>
+
+### Message SystemHeader
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Version | [uint64](#uint64) |  | Version of the object structure |
+| PayloadLength | [uint64](#uint64) |  | Object payload length |
+| ID | [bytes](#bytes) |  | ObjectID is a UUID |
+| OwnerID | [bytes](#bytes) |  | OwnerID is a wallet address |
+| CID | [bytes](#bytes) |  | ContainerID is a SHA256 hash of the container structure |
+| CreatedAt | [CreationPoint](#object.CreationPoint) |  | Timestamp of object creation |
+
+
+<a name="object.Tombstone"></a>
+
+### Message Tombstone
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Epoch | [uint64](#uint64) |  | Epoch when tombstone was created |
+
+
+<a name="object.Transform"></a>
+
+### Message Transform
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| type | [Transform.Type](#object.Transform.Type) |  | Type of object transformation |
+
+
+<a name="object.UserHeader"></a>
+
+### Message UserHeader
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Key | [string](#string) |  | Key of the user's header |
+| Value | [string](#string) |  | Value of the user's header |
+
+ <!-- end messages -->
+
+
+<a name="object.Link.Type"></a>
+
+### Link.Type
+
+
+| Name | Number | Description |
+| ---- | ------ | ----------- |
+| Unknown | 0 |  |
+| Parent | 1 | Parent object created during object transformation |
+| Previous | 2 | Previous object in the linked list created during object transformation |
+| Next | 3 | Next object in the linked list created during object transformation |
+| Child | 4 | Child object created during object transformation |
+| StorageGroup | 5 | Object that included into this storage group |
+
+
+
+<a name="object.StorageGroup.Lifetime.Unit"></a>
+
+### StorageGroup.Lifetime.Unit
+
+
+| Name | Number | Description |
+| ---- | ------ | ----------- |
+| Unlimited | 0 | Storage group always valid |
+| NeoFSEpoch | 1 | Storage group is valid until lifetime NeoFS epoch |
+| UnixTime | 2 | Storage group is valid until lifetime unix timestamp |
+
+
+
+<a name="object.Transform.Type"></a>
+
+### Transform.Type
+
+
+| Name | Number | Description |
+| ---- | ------ | ----------- |
+| Unknown | 0 |  |
+| Split | 1 | Object created after payload split |
+| Sign | 2 | Object created after re-signing (doesn't used) |
+| Mould | 3 | Object created after filling missing headers in the object |
+
+
+ <!-- end enums -->
+
+
+
+## Scalar Value Types
+
+| .proto Type | Notes | C++ Type | Java Type | Python Type |
+| ----------- | ----- | -------- | --------- | ----------- |
+| <a name="double" /> double |  | double | double | float |
+| <a name="float" /> float |  | float | float | float |
+| <a name="int32" /> int32 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead. | int32 | int | int |
+| <a name="int64" /> int64 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead. | int64 | long | int/long |
+| <a name="uint32" /> uint32 | Uses variable-length encoding. | uint32 | int | int/long |
+| <a name="uint64" /> uint64 | Uses variable-length encoding. | uint64 | long | int/long |
+| <a name="sint32" /> sint32 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s. | int32 | int | int |
+| <a name="sint64" /> sint64 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s. | int64 | long | int/long |
+| <a name="fixed32" /> fixed32 | Always four bytes. More efficient than uint32 if values are often greater than 2^28. | uint32 | int | int |
+| <a name="fixed64" /> fixed64 | Always eight bytes. More efficient than uint64 if values are often greater than 2^56. | uint64 | long | int/long |
+| <a name="sfixed32" /> sfixed32 | Always four bytes. | int32 | int | int |
+| <a name="sfixed64" /> sfixed64 | Always eight bytes. | int64 | long | int/long |
+| <a name="bool" /> bool |  | bool | boolean | boolean |
+| <a name="string" /> string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode |
+| <a name="bytes" /> bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str |
+

docs/query.md

@@ -0,0 +1,86 @@
+# Protocol Documentation
+<a name="top"></a>
+
+## Table of Contents
+
+- [query/types.proto](#query/types.proto)
+
+  - Messages
+    - [Filter](#query.Filter)
+    - [Query](#query.Query)
+    
+
+- [Scalar Value Types](#scalar-value-types)
+
+
+
+<a name="query/types.proto"></a>
+<p align="right"><a href="#top">Top</a></p>
+
+## query/types.proto
+
+
+ <!-- end services -->
+
+
+<a name="query.Filter"></a>
+
+### Message Filter
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| type | [Filter.Type](#query.Filter.Type) |  | Type of filter |
+| Name | [string](#string) |  | Name of field that should be filtered |
+| Value | [string](#string) |  | Value that should be used for filter |
+
+
+<a name="query.Query"></a>
+
+### Message Query
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Filters | [Filter](#query.Filter) | repeated | Filters is set of filters, should not be empty |
+
+ <!-- end messages -->
+
+
+<a name="query.Filter.Type"></a>
+
+### Filter.Type
+Type can be Exact or Regex
+
+| Name | Number | Description |
+| ---- | ------ | ----------- |
+| Exact | 0 |  |
+| Regex | 1 |  |
+
+
+ <!-- end enums -->
+
+
+
+## Scalar Value Types
+
+| .proto Type | Notes | C++ Type | Java Type | Python Type |
+| ----------- | ----- | -------- | --------- | ----------- |
+| <a name="double" /> double |  | double | double | float |
+| <a name="float" /> float |  | float | float | float |
+| <a name="int32" /> int32 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead. | int32 | int | int |
+| <a name="int64" /> int64 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead. | int64 | long | int/long |
+| <a name="uint32" /> uint32 | Uses variable-length encoding. | uint32 | int | int/long |
+| <a name="uint64" /> uint64 | Uses variable-length encoding. | uint64 | long | int/long |
+| <a name="sint32" /> sint32 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s. | int32 | int | int |
+| <a name="sint64" /> sint64 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s. | int64 | long | int/long |
+| <a name="fixed32" /> fixed32 | Always four bytes. More efficient than uint32 if values are often greater than 2^28. | uint32 | int | int |
+| <a name="fixed64" /> fixed64 | Always eight bytes. More efficient than uint64 if values are often greater than 2^56. | uint64 | long | int/long |
+| <a name="sfixed32" /> sfixed32 | Always four bytes. | int32 | int | int |
+| <a name="sfixed64" /> sfixed64 | Always eight bytes. | int64 | long | int/long |
+| <a name="bool" /> bool |  | bool | boolean | boolean |
+| <a name="string" /> string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode |
+| <a name="bytes" /> bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str |
+

docs/refs.md

@@ -0,0 +1,61 @@
+# Protocol Documentation
+<a name="top"></a>
+
+## Table of Contents
+
+- [refs/types.proto](#refs/types.proto)
+
+  - Messages
+    - [Address](#refs.Address)
+    
+
+- [Scalar Value Types](#scalar-value-types)
+
+
+
+<a name="refs/types.proto"></a>
+<p align="right"><a href="#top">Top</a></p>
+
+## refs/types.proto
+
+
+ <!-- end services -->
+
+
+<a name="refs.Address"></a>
+
+### Message Address
+Address of object (container id + object id)
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| ObjectID | [bytes](#bytes) |  | ObjectID is an object identifier |
+| CID | [bytes](#bytes) |  | CID is container identifier |
+
+ <!-- end messages -->
+
+ <!-- end enums -->
+
+
+
+## Scalar Value Types
+
+| .proto Type | Notes | C++ Type | Java Type | Python Type |
+| ----------- | ----- | -------- | --------- | ----------- |
+| <a name="double" /> double |  | double | double | float |
+| <a name="float" /> float |  | float | float | float |
+| <a name="int32" /> int32 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead. | int32 | int | int |
+| <a name="int64" /> int64 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead. | int64 | long | int/long |
+| <a name="uint32" /> uint32 | Uses variable-length encoding. | uint32 | int | int/long |
+| <a name="uint64" /> uint64 | Uses variable-length encoding. | uint64 | long | int/long |
+| <a name="sint32" /> sint32 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s. | int32 | int | int |
+| <a name="sint64" /> sint64 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s. | int64 | long | int/long |
+| <a name="fixed32" /> fixed32 | Always four bytes. More efficient than uint32 if values are often greater than 2^28. | uint32 | int | int |
+| <a name="fixed64" /> fixed64 | Always eight bytes. More efficient than uint64 if values are often greater than 2^56. | uint64 | long | int/long |
+| <a name="sfixed32" /> sfixed32 | Always four bytes. | int32 | int | int |
+| <a name="sfixed64" /> sfixed64 | Always eight bytes. | int64 | long | int/long |
+| <a name="bool" /> bool |  | bool | boolean | boolean |
+| <a name="string" /> string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode |
+| <a name="bytes" /> bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str |
+

docs/session.md

@@ -0,0 +1,149 @@
+# Protocol Documentation
+<a name="top"></a>
+
+## Table of Contents
+
+- [session/service.proto](#session/service.proto)
+ - Services
+    - [Session](#session.Session)
+    
+  - Messages
+    - [CreateRequest](#session.CreateRequest)
+    - [CreateResponse](#session.CreateResponse)
+    
+
+- [session/types.proto](#session/types.proto)
+
+  - Messages
+    - [Token](#session.Token)
+    - [VerificationHeader](#session.VerificationHeader)
+    
+
+- [Scalar Value Types](#scalar-value-types)
+
+
+
+<a name="session/service.proto"></a>
+<p align="right"><a href="#top">Top</a></p>
+
+## session/service.proto
+
+
+
+
+<a name="session.Session"></a>
+
+### Service "session.Session"
+Open a trusted session to manipulate an object. In order to put or
+delete object client have to obtain session token with trusted node.
+Trusted node will modify client's object (add missing headers, checksums,
+homomorphic hash) and sign id with session key. Session is established
+during 4-step handshake in one gRPC stream
+
+```
+rpc Create(stream CreateRequest) returns (stream CreateResponse);
+
+```
+
+#### Method Create
+
+
+
+| Name | Input | Output |
+| ---- | ----- | ------ |
+| Create | [CreateRequest](#session.CreateRequest) | [CreateResponse](#session.CreateResponse) |
+ <!-- end services -->
+
+
+<a name="session.CreateRequest"></a>
+
+### Message CreateRequest
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Init | [Token](#session.Token) |  | Message to init session opening. Carry: owner of manipulation object; ID of manipulation object; token lifetime bounds. |
+| Signed | [Token](#session.Token) |  | Signed Init message response (Unsigned) from server with user private key |
+
+
+<a name="session.CreateResponse"></a>
+
+### Message CreateResponse
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Unsigned | [Token](#session.Token) |  | Unsigned token with token ID and session public key generated on server side |
+| Result | [Token](#session.Token) |  | Resulting token which can be used for object placing through an trusted intermediary |
+
+ <!-- end messages -->
+
+ <!-- end enums -->
+
+
+
+<a name="session/types.proto"></a>
+<p align="right"><a href="#top">Top</a></p>
+
+## session/types.proto
+
+
+ <!-- end services -->
+
+
+<a name="session.Token"></a>
+
+### Message Token
+User token granting rights for object manipulation
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Header | [VerificationHeader](#session.VerificationHeader) |  | Header carries verification data of session key |
+| OwnerID | [bytes](#bytes) |  | Owner of manipulation object |
+| FirstEpoch | [uint64](#uint64) |  | Initial epoch of token lifetime |
+| LastEpoch | [uint64](#uint64) |  | Last epoch of token lifetime |
+| ObjectID | [bytes](#bytes) | repeated | ID of manipulation object |
+| Signature | [bytes](#bytes) |  | Token signature. Signed by owner of manipulation object |
+| ID | [bytes](#bytes) |  | Token ID (UUID) |
+
+
+<a name="session.VerificationHeader"></a>
+
+### Message VerificationHeader
+
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| PublicKey | [bytes](#bytes) |  | Session public key |
+| KeySignature | [bytes](#bytes) |  | Session public key signature. Signed by trusted side |
+
+ <!-- end messages -->
+
+ <!-- end enums -->
+
+
+
+## Scalar Value Types
+
+| .proto Type | Notes | C++ Type | Java Type | Python Type |
+| ----------- | ----- | -------- | --------- | ----------- |
+| <a name="double" /> double |  | double | double | float |
+| <a name="float" /> float |  | float | float | float |
+| <a name="int32" /> int32 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead. | int32 | int | int |
+| <a name="int64" /> int64 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead. | int64 | long | int/long |
+| <a name="uint32" /> uint32 | Uses variable-length encoding. | uint32 | int | int/long |
+| <a name="uint64" /> uint64 | Uses variable-length encoding. | uint64 | long | int/long |
+| <a name="sint32" /> sint32 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s. | int32 | int | int |
+| <a name="sint64" /> sint64 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s. | int64 | long | int/long |
+| <a name="fixed32" /> fixed32 | Always four bytes. More efficient than uint32 if values are often greater than 2^28. | uint32 | int | int |
+| <a name="fixed64" /> fixed64 | Always eight bytes. More efficient than uint64 if values are often greater than 2^56. | uint64 | long | int/long |
+| <a name="sfixed32" /> sfixed32 | Always four bytes. | int32 | int | int |
+| <a name="sfixed64" /> sfixed64 | Always eight bytes. | int64 | long | int/long |
+| <a name="bool" /> bool |  | bool | boolean | boolean |
+| <a name="string" /> string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode |
+| <a name="bytes" /> bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str |
+

docs/state.md

@@ -0,0 +1,137 @@
+# Protocol Documentation
+<a name="top"></a>
+
+## Table of Contents
+
+- [state/service.proto](#state/service.proto)
+ - Services
+    - [Status](#state.Status)
+    
+  - Messages
+    - [HealthRequest](#state.HealthRequest)
+    - [HealthResponse](#state.HealthResponse)
+    - [MetricsRequest](#state.MetricsRequest)
+    - [MetricsResponse](#state.MetricsResponse)
+    - [NetmapRequest](#state.NetmapRequest)
+    
+
+- [Scalar Value Types](#scalar-value-types)
+
+
+
+<a name="state/service.proto"></a>
+<p align="right"><a href="#top">Top</a></p>
+
+## state/service.proto
+
+
+
+
+<a name="state.Status"></a>
+
+### Service "state.Status"
+Status service provides node's healthcheck and status info
+
+```
+rpc Netmap(NetmapRequest) returns (.bootstrap.SpreadMap);
+rpc Metrics(MetricsRequest) returns (MetricsResponse);
+rpc HealthCheck(HealthRequest) returns (HealthResponse);
+
+```
+
+#### Method Netmap
+
+Netmap request allows to receive current [bootstrap.SpreadMap](bootstrap.md#bootstrap.SpreadMap)
+
+| Name | Input | Output |
+| ---- | ----- | ------ |
+| Netmap | [NetmapRequest](#state.NetmapRequest) | [.bootstrap.SpreadMap](#bootstrap.SpreadMap) |
+#### Method Metrics
+
+Metrics request allows to receive metrics in prometheus format
+
+| Name | Input | Output |
+| ---- | ----- | ------ |
+| Metrics | [MetricsRequest](#state.MetricsRequest) | [MetricsResponse](#state.MetricsResponse) |
+#### Method HealthCheck
+
+HealthCheck request allows to check health status of the node.
+If node unhealthy field Status would contains detailed info.
+
+| Name | Input | Output |
+| ---- | ----- | ------ |
+| HealthCheck | [HealthRequest](#state.HealthRequest) | [HealthResponse](#state.HealthResponse) |
+ <!-- end services -->
+
+
+<a name="state.HealthRequest"></a>
+
+### Message HealthRequest
+HealthRequest message to check current state
+
+
+
+<a name="state.HealthResponse"></a>
+
+### Message HealthResponse
+HealthResponse message with current state
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Healthy | [bool](#bool) |  | Healthy is true when node alive and healthy |
+| Status | [string](#string) |  | Status contains detailed information about health status |
+
+
+<a name="state.MetricsRequest"></a>
+
+### Message MetricsRequest
+MetricsRequest message to request node metrics
+
+
+
+<a name="state.MetricsResponse"></a>
+
+### Message MetricsResponse
+MetricsResponse contains [][]byte,
+every []byte is marshaled MetricFamily proto message
+from github.com/prometheus/client_model/metrics.proto
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Metrics | [bytes](#bytes) | repeated |  |
+
+
+<a name="state.NetmapRequest"></a>
+
+### Message NetmapRequest
+NetmapRequest message to request current node netmap
+
+
+ <!-- end messages -->
+
+ <!-- end enums -->
+
+
+
+## Scalar Value Types
+
+| .proto Type | Notes | C++ Type | Java Type | Python Type |
+| ----------- | ----- | -------- | --------- | ----------- |
+| <a name="double" /> double |  | double | double | float |
+| <a name="float" /> float |  | float | float | float |
+| <a name="int32" /> int32 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead. | int32 | int | int |
+| <a name="int64" /> int64 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead. | int64 | long | int/long |
+| <a name="uint32" /> uint32 | Uses variable-length encoding. | uint32 | int | int/long |
+| <a name="uint64" /> uint64 | Uses variable-length encoding. | uint64 | long | int/long |
+| <a name="sint32" /> sint32 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s. | int32 | int | int |
+| <a name="sint64" /> sint64 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s. | int64 | long | int/long |
+| <a name="fixed32" /> fixed32 | Always four bytes. More efficient than uint32 if values are often greater than 2^28. | uint32 | int | int |
+| <a name="fixed64" /> fixed64 | Always eight bytes. More efficient than uint64 if values are often greater than 2^56. | uint64 | long | int/long |
+| <a name="sfixed32" /> sfixed32 | Always four bytes. | int32 | int | int |
+| <a name="sfixed64" /> sfixed64 | Always eight bytes. | int64 | long | int/long |
+| <a name="bool" /> bool |  | bool | boolean | boolean |
+| <a name="string" /> string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode |
+| <a name="bytes" /> bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str |
+

object/service.pb.go

@@ -434,6 +434,8 @@ func (m *DeleteRequest) GetToken() *session.Token {
 	return nil
 }
 
+// DeleteResponse is empty because we cannot guarantee permanent object removal
+// in distributed system.
 type DeleteResponse struct {
 	XXX_NoUnkeyedLiteral struct{} `json:"-"`
 	XXX_unrecognized     []byte   `json:"-"`
@@ -469,7 +471,6 @@ func (m *DeleteResponse) XXX_DiscardUnknown() {
 
 var xxx_messageInfo_DeleteResponse proto.InternalMessageInfo
 
-// HeadRequest.FullHeader == true, for fetch all headers
 type HeadRequest struct {
 	Epoch                uint64   `protobuf:"varint,1,opt,name=Epoch,proto3" json:"Epoch,omitempty"`
 	Address              Address  `protobuf:"bytes,2,opt,name=Address,proto3,customtype=Address" json:"Address"`
@@ -991,19 +992,36 @@ const _ = grpc.SupportPackageIsVersion4
 //
 // For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream.
 type ServiceClient interface {
-	// Get the object from a container
+	// Get the object from container. Response uses gRPC stream. First response
+	// message carry object of requested address. Chunk messages are parts of
+	// the object's payload if it is needed. All messages except first carry
+	// chunks. Requested object can be restored by concatenation of object
+	// message payload and all chunks keeping receiving order.
 	Get(ctx context.Context, in *GetRequest, opts ...grpc.CallOption) (Service_GetClient, error)
-	// Put the object into a container
+	// Put the object into container. Request uses gRPC stream. First message
+	// SHOULD BE type of PutHeader. Container id and Owner id of object SHOULD
+	// BE set. Session token SHOULD BE obtained before put operation (see
+	// session package). Chunk messages considered by server as part of object
+	// payload. All messages except first SHOULD BE chunks. Chunk messages
+	// SHOULD BE sent in direct order of fragmentation.
 	Put(ctx context.Context, opts ...grpc.CallOption) (Service_PutClient, error)
 	// Delete the object from a container
 	Delete(ctx context.Context, in *DeleteRequest, opts ...grpc.CallOption) (*DeleteResponse, error)
-	// Get MetaInfo
+	// Head returns the object without data payload. Object in the
+	// response has system header only. If full headers flag is set, extended
+	// headers are also present.
 	Head(ctx context.Context, in *HeadRequest, opts ...grpc.CallOption) (*HeadResponse, error)
-	// Search by MetaInfo
+	// Search objects in container. Version of query language format SHOULD BE
+	// set to 1. Search query represented in serialized format (see query
+	// package).
 	Search(ctx context.Context, in *SearchRequest, opts ...grpc.CallOption) (*SearchResponse, error)
-	// Get ranges of object payload
+	// GetRange of data payload. Ranges are set of pairs (offset, length).
+	// Fragments order in response corresponds to ranges order in request.
 	GetRange(ctx context.Context, in *GetRangeRequest, opts ...grpc.CallOption) (*GetRangeResponse, error)
-	// Get hashes of object ranges
+	// GetRangeHash returns homomorphic hash of object payload range after XOR
+	// operation. Ranges are set of pairs (offset, length). Hashes order in
+	// response corresponds to ranges order in request. Homomorphic hash is
+	// calculated for XORed data.
 	GetRangeHash(ctx context.Context, in *GetRangeHashRequest, opts ...grpc.CallOption) (*GetRangeHashResponse, error)
 }
 
@@ -1128,19 +1146,36 @@ func (c *serviceClient) GetRangeHash(ctx context.Context, in *GetRangeHashReques
 
 // ServiceServer is the server API for Service service.
 type ServiceServer interface {
-	// Get the object from a container
+	// Get the object from container. Response uses gRPC stream. First response
+	// message carry object of requested address. Chunk messages are parts of
+	// the object's payload if it is needed. All messages except first carry
+	// chunks. Requested object can be restored by concatenation of object
+	// message payload and all chunks keeping receiving order.
 	Get(*GetRequest, Service_GetServer) error
-	// Put the object into a container
+	// Put the object into container. Request uses gRPC stream. First message
+	// SHOULD BE type of PutHeader. Container id and Owner id of object SHOULD
+	// BE set. Session token SHOULD BE obtained before put operation (see
+	// session package). Chunk messages considered by server as part of object
+	// payload. All messages except first SHOULD BE chunks. Chunk messages
+	// SHOULD BE sent in direct order of fragmentation.
 	Put(Service_PutServer) error
 	// Delete the object from a container
 	Delete(context.Context, *DeleteRequest) (*DeleteResponse, error)
-	// Get MetaInfo
+	// Head returns the object without data payload. Object in the
+	// response has system header only. If full headers flag is set, extended
+	// headers are also present.
 	Head(context.Context, *HeadRequest) (*HeadResponse, error)
-	// Search by MetaInfo
+	// Search objects in container. Version of query language format SHOULD BE
+	// set to 1. Search query represented in serialized format (see query
+	// package).
 	Search(context.Context, *SearchRequest) (*SearchResponse, error)
-	// Get ranges of object payload
+	// GetRange of data payload. Ranges are set of pairs (offset, length).
+	// Fragments order in response corresponds to ranges order in request.
 	GetRange(context.Context, *GetRangeRequest) (*GetRangeResponse, error)
-	// Get hashes of object ranges
+	// GetRangeHash returns homomorphic hash of object payload range after XOR
+	// operation. Ranges are set of pairs (offset, length). Hashes order in
+	// response corresponds to ranges order in request. Homomorphic hash is
+	// calculated for XORed data.
 	GetRangeHash(context.Context, *GetRangeHashRequest) (*GetRangeHashResponse, error)
 }
 

object/service.proto

@@ -9,111 +9,132 @@ import "github.com/gogo/protobuf/gogoproto/gogo.proto";
 
 option (gogoproto.stable_marshaler_all) = true;
 
+// Object service provides API for manipulating with the object.
 service Service {
-    // Get the object from a container
+
+    // Get the object from container. Response uses gRPC stream. First response
+    // message carry object of requested address. Chunk messages are parts of
+    // the object's payload if it is needed. All messages except first carry
+    // chunks. Requested object can be restored by concatenation of object
+    // message payload and all chunks keeping receiving order.
     rpc Get(GetRequest) returns (stream GetResponse);
 
-    // Put the object into a container
+    // Put the object into container. Request uses gRPC stream. First message
+    // SHOULD BE type of PutHeader. Container id and Owner id of object SHOULD
+    // BE set. Session token SHOULD BE obtained before put operation (see
+    // session package). Chunk messages considered by server as part of object
+    // payload. All messages except first SHOULD BE chunks. Chunk messages
+    // SHOULD BE sent in direct order of fragmentation.
     rpc Put(stream PutRequest) returns (PutResponse);
 
     // Delete the object from a container
     rpc Delete(DeleteRequest) returns (DeleteResponse);
 
-    // Get MetaInfo
+    // Head returns the object without data payload. Object in the
+    // response has system header only. If full headers flag is set, extended
+    // headers are also present.
     rpc Head(HeadRequest) returns (HeadResponse);
 
-    // Search by MetaInfo
+    // Search objects in container. Version of query language format SHOULD BE
+    // set to 1. Search query represented in serialized format (see query
+    // package).
     rpc Search(SearchRequest) returns (SearchResponse);
 
-    // Get ranges of object payload
+    // GetRange of data payload. Ranges are set of pairs (offset, length).
+    // Fragments order in response corresponds to ranges order in request.
     rpc GetRange(GetRangeRequest) returns (GetRangeResponse);
 
-    // Get hashes of object ranges
+    // GetRangeHash returns homomorphic hash of object payload range after XOR
+    // operation. Ranges are set of pairs (offset, length). Hashes order in
+    // response corresponds to ranges order in request. Homomorphic hash is
+    // calculated for XORed data.
     rpc GetRangeHash(GetRangeHashRequest) returns (GetRangeHashResponse);
 }
 
 message GetRequest {
-    uint64 Epoch         = 1;
+    uint64 Epoch         = 1; // Epoch is set by user to 0, node set epoch to the actual value
-    refs.Address Address = 2 [(gogoproto.nullable) = false];
+    refs.Address Address = 2 [(gogoproto.nullable) = false]; // Address of object (container id + object id)
-    uint32 TTL           = 3;
+    uint32 TTL           = 3; // TTL must be larger than zero, it decreased in every neofs-node
 }
 
 message GetResponse {
     oneof R {
-        Object object = 1;
+        Object object = 1; // Object header and some payload
-        bytes Chunk   = 2;
+        bytes Chunk   = 2; // Chunk of remaining payload
     }
 }
 
 message PutRequest {
     message PutHeader {
-        uint64 Epoch        = 1;
+        uint64 Epoch        = 1; // Epoch is set by user to 0, node set epoch to the actual value
-        Object Object       = 2;
+        Object Object       = 2; // Object with at least container id and owner id fields
-        uint32 TTL          = 3;
+        uint32 TTL          = 3; // TTL must be larger than zero, it decreased in every neofs-node
-        session.Token Token = 4;
+        session.Token Token = 4; // Token with session public key and user's signature
     }
 
     oneof R {
-        PutHeader Header = 1;
+        PutHeader Header = 1; // Header should be the first message in the stream
-        bytes Chunk      = 2;
+        bytes Chunk      = 2; // Chunk should be a remaining message in stream should be chunks
     }
 }
 
 message PutResponse {
-    refs.Address Address = 1 [(gogoproto.nullable) = false];
+    refs.Address Address = 1 [(gogoproto.nullable) = false]; // Address of object (container id + object id)
 }
 message DeleteRequest {
-    uint64 Epoch         = 1;
+    uint64 Epoch         = 1; // Epoch is set by user to 0, node set epoch to the actual value
-    refs.Address Address = 2 [(gogoproto.nullable) = false];
+    refs.Address Address = 2 [(gogoproto.nullable) = false]; // Address of object (container id + object id)
-    bytes OwnerID        = 3 [(gogoproto.nullable) = false, (gogoproto.customtype) = "OwnerID"];
+    bytes OwnerID        = 3 [(gogoproto.nullable) = false, (gogoproto.customtype) = "OwnerID"]; // OwnerID is a wallet address
-    uint32 TTL           = 4;
+    uint32 TTL           = 4; // TTL must be larger than zero, it decreased in every neofs-node
-    session.Token Token  = 5;
+    session.Token Token  = 5; // Token with session public key and user's signature
 }
+
+// DeleteResponse is empty because we cannot guarantee permanent object removal
+// in distributed system.
 message DeleteResponse {}
 
-// HeadRequest.FullHeader == true, for fetch all headers
 message HeadRequest {
-    uint64 Epoch         = 1;
+    uint64 Epoch         = 1; // Epoch is set by user to 0, node set epoch to the actual value
-    refs.Address Address = 2 [(gogoproto.nullable) = false, (gogoproto.customtype) = "Address"];
+    refs.Address Address = 2 [(gogoproto.nullable) = false, (gogoproto.customtype) = "Address"]; // Address of object (container id + object id)
-    bool FullHeaders     = 3;
+    bool FullHeaders     = 3; // FullHeaders can be set true for extended headers in the object
-    uint32 TTL           = 4;
+    uint32 TTL           = 4; // TTL must be larger than zero, it decreased in every neofs-node
 }
 message HeadResponse {
-    Object Object = 1;
+    Object Object = 1; // Object without payload
 }
 
 message SearchRequest {
-    uint64 Epoch         = 1;
+    uint64 Epoch         = 1; // Epoch is set by user to 0, node set epoch to the actual value
-    uint32 Version       = 2;
+    uint32 Version       = 2; // Version of search query format
-    bytes ContainerID    = 3 [(gogoproto.nullable) = false, (gogoproto.customtype) = "CID"];
+    bytes ContainerID    = 3 [(gogoproto.nullable) = false, (gogoproto.customtype) = "CID"]; // ContainerID for searching the object
-    bytes Query          = 4;
+    bytes Query          = 4; // Query in the binary serialized format
-    uint32 TTL           = 5;
+    uint32 TTL           = 5; // TTL must be larger than zero, it decreased in every neofs-node
 }
 
 message SearchResponse {
-    repeated refs.Address Addresses = 1 [(gogoproto.nullable) = false];
+    repeated refs.Address Addresses = 1 [(gogoproto.nullable) = false]; // Addresses of found objects
 }
 
 message GetRangeRequest {
-    uint64 Epoch          = 1;
+    uint64 Epoch          = 1; // Epoch is set by user to 0, node set epoch to the actual value
-    refs.Address Address  = 2 [(gogoproto.nullable) = false];
+    refs.Address Address  = 2 [(gogoproto.nullable) = false]; // Address of object (container id + object id)
-    repeated Range Ranges = 3 [(gogoproto.nullable) = false];
+    repeated Range Ranges = 3 [(gogoproto.nullable) = false]; // Ranges of object's payload to return
-    uint32 TTL            = 4;
+    uint32 TTL            = 4; // TTL must be larger than zero, it decreased in every neofs-node
 }
 
 message GetRangeResponse {
-    repeated bytes Fragments = 1;
+    repeated bytes Fragments = 1; // Fragments of object's payload
 }
 
 message GetRangeHashRequest {
-    uint64 Epoch          = 1;
+    uint64 Epoch          = 1; // Epoch is set by user to 0, node set epoch to the actual value
-    refs.Address Address  = 2 [(gogoproto.nullable) = false];
+    refs.Address Address  = 2 [(gogoproto.nullable) = false]; // Address of object (container id + object id)
-    repeated Range Ranges = 3 [(gogoproto.nullable) = false];
+    repeated Range Ranges = 3 [(gogoproto.nullable) = false]; // Ranges of object's payload to calculate homomorphic hash
-    bytes Salt            = 4;
+    bytes Salt            = 4; // Salt is used to XOR object's payload ranges before hashing, it can be nil
-    uint32 TTL            = 5;
+    uint32 TTL            = 5; // TTL must be larger than zero, it decreased in every neofs-node
 }
 
 message GetRangeHashResponse {
-    repeated bytes Hashes = 1 [(gogoproto.customtype) = "Hash", (gogoproto.nullable) = false];
+    repeated bytes Hashes = 1 [(gogoproto.customtype) = "Hash", (gogoproto.nullable) = false]; // Homomorphic hashes of all ranges
 }
 

object/types.proto

@@ -9,99 +9,97 @@ import "github.com/gogo/protobuf/gogoproto/gogo.proto";
 option (gogoproto.stable_marshaler_all) = true;
 
 message Range {
-    uint64 Offset = 1;
+    uint64 Offset = 1; // Offset of the data range
-    uint64 Length = 2;
+    uint64 Length = 2; // Length of the data range
 }
 
 message UserHeader {
-    string Key = 1;
+    string Key   = 1; // Key of the user's header
-    string Value = 2;
+    string Value = 2; // Value of the user's header
 }
 
 message Header {
     oneof Value {
-        Link Link                         = 1;
+        Link Link                         = 1;  // Link to other objects
-        refs.Address Redirect             = 2;
+        refs.Address Redirect             = 2;  // RedirectNot used yet
-        UserHeader UserHeader             = 3;
+        UserHeader UserHeader             = 3;  // UserHeader defined by user
-        Transform Transform               = 4;
+        Transform Transform               = 4;  // Transform defines transform operation (e.g. payload split)
-        Tombstone Tombstone               = 5;
+        Tombstone Tombstone               = 5;  // Tombstone header that set up in deleted objects
-        // session-related info: session.VerificationHeader
+        session.VerificationHeader Verify = 6;  // Verify header that contains session public key and user's signature
-        session.VerificationHeader Verify = 6;
+        bytes HomoHash                    = 7 [(gogoproto.customtype) = "Hash"]; // Homomorphic hash of original object payload
-        // integrity-related info
+        bytes PayloadChecksum             = 8;  // PayloadChecksum of actual object's payload
-        bytes HomoHash                    = 7 [(gogoproto.customtype) = "Hash"];
+        IntegrityHeader Integrity         = 9;  // Integrity header with checksum of all above headers in the object
-        bytes PayloadChecksum             = 8;
+        StorageGroup StorageGroup         = 10; // StorageGroup contains meta information for the data audit
-        IntegrityHeader Integrity         = 9;
-        StorageGroup StorageGroup         = 10;
     }
 }
 
 message Tombstone {
-    uint64 Epoch = 1;
+    uint64 Epoch = 1; // Epoch when tombstone was created
 }
 
 message SystemHeader {
-    uint64 Version       = 1;
+    uint64 Version       = 1; // Version of the object structure
-    uint64 PayloadLength = 2;
+    uint64 PayloadLength = 2; // Object payload length
 
-    bytes ID        = 3 [(gogoproto.customtype) = "ID", (gogoproto.nullable) = false];
+    bytes ID        = 3 [(gogoproto.customtype) = "ID", (gogoproto.nullable) = false]; // ObjectID is a UUID
-    bytes OwnerID   = 4 [(gogoproto.customtype) = "OwnerID",  (gogoproto.nullable) = false];
+    bytes OwnerID   = 4 [(gogoproto.customtype) = "OwnerID",  (gogoproto.nullable) = false]; // OwnerID is a wallet address
-    bytes CID       = 5 [(gogoproto.customtype) = "CID",      (gogoproto.nullable) = false];
+    bytes CID       = 5 [(gogoproto.customtype) = "CID",      (gogoproto.nullable) = false]; // ContainerID is a SHA256 hash of the container structure
-    CreationPoint CreatedAt = 6 [(gogoproto.nullable) = false];
+    CreationPoint CreatedAt = 6 [(gogoproto.nullable) = false]; // Timestamp of object creation
 }
 
 message CreationPoint {
-    int64 UnixTime = 1;
+    int64 UnixTime = 1; // Date of creation in unixtime format
-    uint64 Epoch = 2;
+    uint64 Epoch   = 2; // Date of creation in NeoFS epochs
 }
 
 message IntegrityHeader {
-    bytes HeadersChecksum   = 1;
+    bytes HeadersChecksum   = 1; // Checksum of all above headers in the object
-    bytes ChecksumSignature = 2;
+    bytes ChecksumSignature = 2; // User's signature of checksum to verify if it is correct
 }
 
 message Link {
     enum Type {
         Unknown      = 0;
-        Parent       = 1;
+        Parent       = 1; // Parent object created during object transformation
-        Previous     = 2;
+        Previous     = 2; // Previous object in the linked list created during object transformation
-        Next         = 3;
+        Next         = 3; // Next object in the linked list created during object transformation
-        Child        = 4;
+        Child        = 4; // Child object created during object transformation
-        StorageGroup = 5;
+        StorageGroup = 5; // Object that included into this storage group
     }
-    Type type  = 1;
+    Type type  = 1; // Link type
-    bytes ID = 2 [(gogoproto.customtype) = "ID", (gogoproto.nullable) = false];
+    bytes ID = 2 [(gogoproto.customtype) = "ID", (gogoproto.nullable) = false]; // Object id
 }
 
 message Transform {
     enum Type {
         Unknown = 0;
-        Split   = 1;
+        Split   = 1; // Object created after payload split
-        Sign    = 2;
+        Sign    = 2; // Object created after re-signing (doesn't used)
-        Mould   = 3;
+        Mould   = 3; // Object created after filling missing headers in the object
     }
-    Type type  = 1;
+    Type type  = 1; // Type of object transformation
 }
 
 message Object {
-    SystemHeader SystemHeader = 1 [(gogoproto.nullable) = false];
+    SystemHeader SystemHeader = 1 [(gogoproto.nullable) = false]; // System header
-    repeated Header Headers   = 2 [(gogoproto.nullable) = false];
+    repeated Header Headers   = 2 [(gogoproto.nullable) = false]; // Extended headers
-    bytes Payload             = 3;
+    bytes Payload             = 3; // Object's payload
 }
 
 message StorageGroup {
-    uint64 ValidationDataSize = 1;
+    uint64 ValidationDataSize = 1; // Size of the all object's payloads included into storage group
-    bytes ValidationHash = 2 [(gogoproto.customtype) = "Hash", (gogoproto.nullable) = false];
+    bytes ValidationHash = 2 [(gogoproto.customtype) = "Hash", (gogoproto.nullable) = false]; // Homomorphic hash of all object's payloads included into storage group
 
     message Lifetime {
         enum Unit {
-            Unlimited = 0;
+            Unlimited = 0;  // Storage group always valid
-            NeoFSEpoch = 1;
+            NeoFSEpoch = 1; // Storage group is valid until lifetime NeoFS epoch
-            UnixTime = 2;
+            UnixTime = 2;   // Storage group is valid until lifetime unix timestamp
         }
 
-        Unit unit = 1 [(gogoproto.customname) = "Unit"];
+        Unit unit = 1 [(gogoproto.customname) = "Unit"]; // Lifetime type
-        int64 Value = 2;
+        int64 Value = 2; // Lifetime value
     }
 
-    Lifetime lifetime = 3 [(gogoproto.customname) = "Lifetime"];
+    Lifetime lifetime = 3 [(gogoproto.customname) = "Lifetime"]; // Time until storage group is valid
 }

query/types.pb.go

@@ -23,6 +23,7 @@ var _ = math.Inf
 // proto package needs to be updated.
 const _ = proto.ProtoPackageIsVersion3 // please upgrade the proto package
 
+// Type can be Exact or Regex
 type Filter_Type int32
 
 const (
@@ -49,12 +50,15 @@ func (Filter_Type) EnumDescriptor() ([]byte, []int) {
 }
 
 type Filter struct {
-	Type                 Filter_Type `protobuf:"varint,1,opt,name=type,proto3,enum=query.Filter_Type" json:"type,omitempty"`
+	// Type of filter
-	Name                 string      `protobuf:"bytes,2,opt,name=Name,proto3" json:"Name,omitempty"`
+	Type Filter_Type `protobuf:"varint,1,opt,name=type,proto3,enum=query.Filter_Type" json:"type,omitempty"`
-	Value                string      `protobuf:"bytes,3,opt,name=Value,proto3" json:"Value,omitempty"`
+	// Name of field that should be filtered
-	XXX_NoUnkeyedLiteral struct{}    `json:"-"`
+	Name string `protobuf:"bytes,2,opt,name=Name,proto3" json:"Name,omitempty"`
-	XXX_unrecognized     []byte      `json:"-"`
+	// Value that should be used for filter
-	XXX_sizecache        int32       `json:"-"`
+	Value                string   `protobuf:"bytes,3,opt,name=Value,proto3" json:"Value,omitempty"`
+	XXX_NoUnkeyedLiteral struct{} `json:"-"`
+	XXX_unrecognized     []byte   `json:"-"`
+	XXX_sizecache        int32    `json:"-"`
 }
 
 func (m *Filter) Reset()      { *m = Filter{} }
@@ -107,6 +111,7 @@ func (m *Filter) GetValue() string {
 }
 
 type Query struct {
+	// Filters is set of filters, should not be empty
 	Filters              []Filter `protobuf:"bytes,1,rep,name=Filters,proto3" json:"Filters"`
 	XXX_NoUnkeyedLiteral struct{} `json:"-"`
 	XXX_unrecognized     []byte   `json:"-"`

query/types.proto

@@ -9,17 +9,23 @@ option (gogoproto.stable_marshaler_all) = true;
 message Filter {
     option (gogoproto.goproto_stringer) = false;
 
+    // Type can be Exact or Regex
     enum Type {
         Exact = 0;
         Regex = 1;
     }
+
+    // Type of filter
     Type type = 1 [(gogoproto.customname) = "Type"];
+    // Name of field that should be filtered
     string Name = 2;
+    // Value that should be used for filter
     string Value = 3;
 }
 
 message Query {
     option (gogoproto.goproto_stringer) = false;
 
+    // Filters is set of filters, should not be empty
     repeated Filter Filters = 1 [(gogoproto.nullable) = false];
 }

refs/types.pb.go

@@ -23,8 +23,11 @@ var _ = math.Inf
 // proto package needs to be updated.
 const _ = proto.ProtoPackageIsVersion3 // please upgrade the proto package
 
+// Address of object (container id + object id)
 type Address struct {
-	ObjectID             ObjectID `protobuf:"bytes,1,opt,name=ObjectID,proto3,customtype=ObjectID" json:"ObjectID"`
+	// ObjectID is an object identifier
+	ObjectID ObjectID `protobuf:"bytes,1,opt,name=ObjectID,proto3,customtype=ObjectID" json:"ObjectID"`
+	// CID is container identifier
 	CID                  CID      `protobuf:"bytes,2,opt,name=CID,proto3,customtype=CID" json:"CID"`
 	XXX_NoUnkeyedLiteral struct{} `json:"-"`
 	XXX_unrecognized     []byte   `json:"-"`

refs/types.proto

@@ -9,7 +9,10 @@ option (gogoproto.stable_marshaler_all) = true;
 option (gogoproto.stringer_all) =  false;
 option (gogoproto.goproto_stringer_all) = false;
 
+// Address of object (container id + object id)
 message Address {
-    bytes ObjectID = 1[(gogoproto.customtype) = "ObjectID", (gogoproto.nullable) = false]; // UUID
+    // ObjectID is an object identifier
-    bytes CID      = 2[(gogoproto.customtype) = "CID",      (gogoproto.nullable) = false]; // sha256
+    bytes ObjectID = 1[(gogoproto.customtype) = "ObjectID", (gogoproto.nullable) = false];
+    // CID is container identifier
+    bytes CID      = 2[(gogoproto.customtype) = "CID",      (gogoproto.nullable) = false];
 }

session/service.pb.go

@@ -28,6 +28,8 @@ var _ = math.Inf
 const _ = proto.ProtoPackageIsVersion3 // please upgrade the proto package
 
 type CreateRequest struct {
+	// Message should be one of
+	//
 	// Types that are valid to be assigned to Message:
 	//	*CreateRequest_Init
 	//	*CreateRequest_Signed

session/service.proto

@@ -7,21 +7,41 @@ import "github.com/gogo/protobuf/gogoproto/gogo.proto";
 
 option (gogoproto.stable_marshaler_all) = true;
 
+
 service Session {
+    // Open a trusted session to manipulate an object. In order to put or
+    // delete object client have to obtain session token with trusted node.
+    // Trusted node will modify client's object (add missing headers, checksums,
+    // homomorphic hash) and sign id with session key. Session is established
+    // during 4-step handshake in one gRPC stream
+
+    // - First client stream message SHOULD BE type of `CreateRequest_Init`.
+    // - First server stream message SHOULD BE type of `CreateResponse_Unsigned`.
+    // - Second client stream message SHOULD BE type of `CreateRequest_Signed`.
+    // - Second server stream message SHOULD BE type of `CreateResponse_Result`.
+
     rpc Create (stream CreateRequest) returns (stream CreateResponse);
 }
 
 
 message CreateRequest {
+    // Message should be one of
     oneof Message {
+        // Message to init session opening. Carry:
+        // owner of manipulation object;
+        // ID of manipulation object;
+        // token lifetime bounds.
         session.Token Init = 1;
+        // Signed Init message response (Unsigned) from server with user private key
         session.Token Signed = 2;
     }
 }
 
 message CreateResponse {
     oneof Message {
+        // Unsigned token with token ID and session public key generated on server side
         session.Token Unsigned = 1;
+        // Resulting token which can be used for object placing through an trusted intermediary
         session.Token Result = 2;
     }
 }

session/types.pb.go

@@ -24,7 +24,9 @@ var _ = math.Inf
 const _ = proto.ProtoPackageIsVersion3 // please upgrade the proto package
 
 type VerificationHeader struct {
-	PublicKey            []byte   `protobuf:"bytes,1,opt,name=PublicKey,proto3" json:"PublicKey,omitempty"`
+	// Session public key
+	PublicKey []byte `protobuf:"bytes,1,opt,name=PublicKey,proto3" json:"PublicKey,omitempty"`
+	// Session public key signature. Signed by trusted side
 	KeySignature         []byte   `protobuf:"bytes,2,opt,name=KeySignature,proto3" json:"KeySignature,omitempty"`
 	XXX_NoUnkeyedLiteral struct{} `json:"-"`
 	XXX_unrecognized     []byte   `json:"-"`
@@ -74,17 +76,25 @@ func (m *VerificationHeader) GetKeySignature() []byte {
 	return nil
 }
 
+// User token granting rights for object manipulation
 type Token struct {
-	Header               VerificationHeader `protobuf:"bytes,1,opt,name=Header,proto3" json:"Header"`
+	// Header carries verification data of session key
-	OwnerID              OwnerID            `protobuf:"bytes,2,opt,name=OwnerID,proto3,customtype=OwnerID" json:"OwnerID"`
+	Header VerificationHeader `protobuf:"bytes,1,opt,name=Header,proto3" json:"Header"`
-	FirstEpoch           uint64             `protobuf:"varint,3,opt,name=FirstEpoch,proto3" json:"FirstEpoch,omitempty"`
+	// Owner of manipulation object
-	LastEpoch            uint64             `protobuf:"varint,4,opt,name=LastEpoch,proto3" json:"LastEpoch,omitempty"`
+	OwnerID OwnerID `protobuf:"bytes,2,opt,name=OwnerID,proto3,customtype=OwnerID" json:"OwnerID"`
-	ObjectID             []ObjectID         `protobuf:"bytes,5,rep,name=ObjectID,proto3,customtype=ObjectID" json:"ObjectID"`
+	// Initial epoch of token lifetime
-	Signature            []byte             `protobuf:"bytes,6,opt,name=Signature,proto3" json:"Signature,omitempty"`
+	FirstEpoch uint64 `protobuf:"varint,3,opt,name=FirstEpoch,proto3" json:"FirstEpoch,omitempty"`
-	ID                   TokenID            `protobuf:"bytes,7,opt,name=ID,proto3,customtype=TokenID" json:"ID"`
+	// Last epoch of token lifetime
-	XXX_NoUnkeyedLiteral struct{}           `json:"-"`
+	LastEpoch uint64 `protobuf:"varint,4,opt,name=LastEpoch,proto3" json:"LastEpoch,omitempty"`
-	XXX_unrecognized     []byte             `json:"-"`
+	// ID of manipulation object
-	XXX_sizecache        int32              `json:"-"`
+	ObjectID []ObjectID `protobuf:"bytes,5,rep,name=ObjectID,proto3,customtype=ObjectID" json:"ObjectID"`
+	// Token signature. Signed by owner of manipulation object
+	Signature []byte `protobuf:"bytes,6,opt,name=Signature,proto3" json:"Signature,omitempty"`
+	// Token ID (UUID)
+	ID                   TokenID  `protobuf:"bytes,7,opt,name=ID,proto3,customtype=TokenID" json:"ID"`
+	XXX_NoUnkeyedLiteral struct{} `json:"-"`
+	XXX_unrecognized     []byte   `json:"-"`
+	XXX_sizecache        int32    `json:"-"`
 }
 
 func (m *Token) Reset()         { *m = Token{} }

session/types.proto

@@ -7,16 +7,26 @@ import "github.com/gogo/protobuf/gogoproto/gogo.proto";
 option (gogoproto.stable_marshaler_all) = true;
 
 message VerificationHeader {
+    // Session public key
     bytes PublicKey = 1;
+    // Session public key signature. Signed by trusted side
     bytes KeySignature = 2;
 }
 
+// User token granting rights for object manipulation
 message Token {
+    // Header carries verification data of session key
     VerificationHeader Header = 1 [(gogoproto.nullable) = false];
+    // Owner of manipulation object
     bytes OwnerID = 2 [(gogoproto.customtype) = "OwnerID", (gogoproto.nullable) = false];
+    // Initial epoch of token lifetime
     uint64 FirstEpoch = 3;
+    // Last epoch of token lifetime
     uint64 LastEpoch = 4;
+    // ID of manipulation object
     repeated bytes ObjectID = 5 [(gogoproto.customtype) = "ObjectID", (gogoproto.nullable) = false];
+    // Token signature. Signed by owner of manipulation object
     bytes Signature = 6;
+    // Token ID (UUID)
     bytes ID = 7 [(gogoproto.customtype) = "TokenID", (gogoproto.nullable) = false];
 }

state/service.pb.go

@@ -184,7 +184,9 @@ var xxx_messageInfo_HealthRequest proto.InternalMessageInfo
 
 // HealthResponse message with current state
 type HealthResponse struct {
-	Healthy              bool     `protobuf:"varint,1,opt,name=Healthy,proto3" json:"Healthy,omitempty"`
+	// Healthy is true when node alive and healthy
+	Healthy bool `protobuf:"varint,1,opt,name=Healthy,proto3" json:"Healthy,omitempty"`
+	// Status contains detailed information about health status
 	Status               string   `protobuf:"bytes,2,opt,name=Status,proto3" json:"Status,omitempty"`
 	XXX_NoUnkeyedLiteral struct{} `json:"-"`
 	XXX_unrecognized     []byte   `json:"-"`
@@ -280,8 +282,12 @@ const _ = grpc.SupportPackageIsVersion4
 //
 // For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream.
 type StatusClient interface {
+	// Netmap request allows to receive current [bootstrap.SpreadMap](bootstrap.md#bootstrap.SpreadMap)
 	Netmap(ctx context.Context, in *NetmapRequest, opts ...grpc.CallOption) (*bootstrap.SpreadMap, error)
+	// Metrics request allows to receive metrics in prometheus format
 	Metrics(ctx context.Context, in *MetricsRequest, opts ...grpc.CallOption) (*MetricsResponse, error)
+	// HealthCheck request allows to check health status of the node.
+	// If node unhealthy field Status would contains detailed info.
 	HealthCheck(ctx context.Context, in *HealthRequest, opts ...grpc.CallOption) (*HealthResponse, error)
 }
 
@@ -322,8 +328,12 @@ func (c *statusClient) HealthCheck(ctx context.Context, in *HealthRequest, opts
 
 // StatusServer is the server API for Status service.
 type StatusServer interface {
+	// Netmap request allows to receive current [bootstrap.SpreadMap](bootstrap.md#bootstrap.SpreadMap)
 	Netmap(context.Context, *NetmapRequest) (*bootstrap.SpreadMap, error)
+	// Metrics request allows to receive metrics in prometheus format
 	Metrics(context.Context, *MetricsRequest) (*MetricsResponse, error)
+	// HealthCheck request allows to check health status of the node.
+	// If node unhealthy field Status would contains detailed info.
 	HealthCheck(context.Context, *HealthRequest) (*HealthResponse, error)
 }
 

state/service.proto

@@ -7,10 +7,14 @@ import "github.com/gogo/protobuf/gogoproto/gogo.proto";
 
 option (gogoproto.stable_marshaler_all) = true;
 
-// The Status service definition.
+// Status service provides node's healthcheck and status info
 service Status {
+    // Netmap request allows to receive current [bootstrap.SpreadMap](bootstrap.md#bootstrap.SpreadMap)
     rpc Netmap(NetmapRequest) returns (bootstrap.SpreadMap);
+    // Metrics request allows to receive metrics in prometheus format
     rpc Metrics(MetricsRequest) returns (MetricsResponse);
+    // HealthCheck request allows to check health status of the node.
+    // If node unhealthy field Status would contains detailed info.
     rpc HealthCheck(HealthRequest) returns (HealthResponse);
 }
 
@@ -32,6 +36,8 @@ message HealthRequest {}
 
 // HealthResponse message with current state
 message HealthResponse {
+    // Healthy is true when node alive and healthy
     bool Healthy  = 1;
+    // Status contains detailed information about health status
     string Status = 2;
 }