From 3b63d9148006ad161c67574844d9461ee3c58946 Mon Sep 17 00:00:00 2001
From: alexvanin <alexey@nspcc.ru>
Date: Tue, 11 Feb 2020 16:54:43 +0300
Subject: [PATCH 1/4] accounting: Use little endian in number encoding

NeoFS smart-contract uses little endian for number of
signatures, GAS amount and block height. If we encode
these parameters in little endian, smart-contract will not
reverse bytes during execution therefore will be cheaper.
---
 accounting/fixtures/cheque.sh   |   2 +-
 accounting/fixtures/cheque_data | Bin 650 -> 650 bytes
 accounting/types.go             |  12 ++++++------
 accounting/types_test.go        |   2 ++
 4 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/accounting/fixtures/cheque.sh b/accounting/fixtures/cheque.sh
index 93368138..581402a9 100755
--- a/accounting/fixtures/cheque.sh
+++ b/accounting/fixtures/cheque.sh
@@ -1,6 +1,6 @@
 #!/bin/bash
 
-CHEQUE=d6520dabb6cb9b981792608c73670eff14775e9a65bbc189271723ba2703c53263e8d6e522dc32203339dcd8eee9c6b7439a0000000053724e000000000000001e61000603012d47e76210aec73be39ab3d186e0a40fe8d86bfa3d4fabfda57ba13b88f96abe1de4c7ecd46cb32081c0ff199e0b32708d2ce709dd146ce096484073a9b15a259ca799f8d848eb5bea16f6d0842a0181ccd47384af2cdb0fd0af0819e8a08802f7528ce97c9a93558efe7d4f62577aabdf771c931f54a71be6ad21e7d9cc1777686ad19b5dc4b80d7b8decf90054c5aad66c0e6fe63d8473b751cd77c1bd0557516e0f3e7d0ccb485809023b0c08a89f33ae38b2f99ce3f1ebc7905dddf0ed0f023e00f03a16e8707ce045eb42ee80d392451541ee510dc18e1c8befbac54d7426087d37d32d836537d317deafbbd193002a36f80fbdfbf3a730cf011bc6c75c7e6d5724f3adee7015fcb3068d321e2ae555e79107be0c46070efdae2f724dbc9f0340750b92789821683283bcb98e32b7e032b94f267b6964613fc31a7ce5813fddeea47a1db525634237e924178b5c8ea745549ae60aa3570ce6cf52e370e6ab87652bdf8a179176f1acaf48896bef9ab300818a53f410d86241d506a550f4915403fef27f744e829131d0ec980829fafa51db1714c2761d9f78762c008c323e9d6612e4f9efdc609f191fd9ca5431dd9dc037130150107ab8769780d728e9ffdf314019b57c8d2b940b9ec078afa951ed8b06c1bf352edd2037e29b8f24cca3ec700368a6f5829fb2a34fa03d0308ae6b05f433f2904d9a852fed1f5d2eb598ca79475b74ef6394e712d275cd798062c6d8e41fad822ac5a4fcb167f0a2e196f61f9f65a0adef9650f49150e7eb7bb08dd1739fa6e86b341f1b2cf5657fcd200637e8
+CHEQUE=7849b02d01cc7f7734295fa815ea64ec4d2012e45b8781eb891723ba2703c53263e8d6e522dc32203339dcd8eee9c6b7439a00ea56fa00000000611e000000000000060003012d47e76210aec73be39ab3d186e0a40fe8d86bfa3d4fabfda57ba13b88f96a8ebe4360627a1326f13fb9516c0dbc4af90f116e44bd33f4d04a0d1633afa243ad4f2fa9cd933e7631a619b5132cec6983906aba757af5590434124b232a43e302f7528ce97c9a93558efe7d4f62577aabdf771c931f54a71be6ad21e7d9cc177744b4b9781cf0c29adb503f33d2df9f810ebf33a774849848984cf7e2bbebd48ef0cd8592fbf9b6aee1dc74803e31c95a02dbbd5fd9783f9ecbcbf444b5942f830368a6f5829fb2a34fa03d0308ae6b05f433f2904d9a852fed1f5d2eb598ca794770adb1ece9dccd1c7ad98f709cfb890e3bdd5973dcdd838111fae2efa4c3c09ea2133e5d7c6eac6ae24afcce46db7c9f4dc154f123c835adff4e0b7e19bcffda0340750b92789821683283bcb98e32b7e032b94f267b6964613fc31a7ce5813fddad8298f71dfdc4f9b3e353f969727af476d43b12a25727cf6b9c73ae7152266d995bec807068ad2156288c4d946aeb17ebca787d498a1b87b9dae1bcd935763403fef27f744e829131d0ec980829fafa51db1714c2761d9f78762c008c323e9d66db9b5086d355897e52fe065e14f1cc70334248349aa4c7a3e6e3dc8f8693b1511c73dc88e6d6e8b6c6c68de922f351b5b1543917af2f2a3588aebfbd1ff3fac6023e00f03a16e8707ce045eb42ee80d392451541ee510dc18e1c8befbac54d742648b58f379b5337d9b74c5a61afb8ef3db7f3eb0454d6823777b613a3ee22cd6ce47e4fa72170d49267b773cc09c123654e0bcd7278aa2ae1e7c85d049b557a3c
 DIR=$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )
 
 echo $CHEQUE | xxd -p -r > $DIR/cheque_data
diff --git a/accounting/fixtures/cheque_data b/accounting/fixtures/cheque_data
index cd7b286642c3d1fc8d0080985c4d070013761b63..a1530960f321d4d6d1cb7f11f9cf1de82006ffc4 100644
GIT binary patch
delta 485
zcmV<B0UG{_1&RekcuBA=0nC4QG$~)G73yT{O&}8FTZe(`i5DZfCj-SYW9Zi9BHS_{
zGdbMY?&-$2Lz)2UR{8({003bg00000000I6kwhUtj=n=+VtNxM@jtmyYz@3h`416p
zM7=Zg&`J#!Gq0jUtxqqh&67TMF{T-{6D;g$gOF;vb$az#1T+#$BPv7Vk)<I(M6|hh
z9Pq-L+fY9<(%+wf4!<*}bcC2lm`wNLyX(}B@Xdvi`}wx6;oNk9J~7E!0^7Y`*?2#m
z%ggjcwUjS|lPLlrKya<G?CIRi9D3Q0aGd*z4m;ghbKKp7ff4%R@1(=Po}v>zU3_k=
zYT`=#&PLmOpH0D3@gvAJt^ZC7ei^*~+LLDiAwaEynD-t1#QC%1Q~7Cfdh~YGI})N-
zC(mn~bFOhxCT*Ep?0|4+tszz@j7^kk>lf?FczsEV8;7~t;k?;3b~Ka70U<!!n^1<+
zRf&F5{svwY@yu{DLP#{4q{pM?<J^yild(}8bKHpL*66mz#*OJB^HH_2R5=%~FDf;N
zuD`t>^ZLe<1_2>JNVShQn^QO0w@g}Luek3$xAW@+RMvtwceWFw?jp@><bF@5A#l`^
bXSZ|A3Be;}P7BR)c&aMl=g3_In^k%|&H3<N

delta 485
zcmV<B0UG{_1&Rek)=~|tw#%EC7m{F%b7v0!6n9>lWxK(NCl@2SCj-SYW9Zi9BHS_{
zGdbMY?&-$2Lz(~p002{RP5=M^000009$^3mkwhUtz8&Pp?9^<tAc4UD8J-I=aE&bI
z3EdQI;Fd^0bE&afC7h?3_}ED6Tk00}(1a=hfy~r%gs&{y574g&8R(#hk)<I(Xll`$
zUBtKzdyVY*093`Q)@%-M<~@XSw^7Y^!Mz1nQEm@DeGJP;SP23<3<#*7Gp;zY`JChN
z>&K8?-SF)XlPLlrKnQ&|(=CH#H`5p1ue;Hc04g^4554>Ir!da}8^*_6er;DI^R4c1
z75uXXjWQl8<yGgA2fhqO2M+zNFLF)1pOa?+Awce=dL6YTV?sCSBo~WZj;BRbn&t|l
zR}ALQQsZ#utA}MP--;KJcJZvQNQrCjnzI0bic|Cu*kVD|2BlE+kyMk&0U<yV<oWO1
zV4oQu*~(Ng-JQTU69G^VdboC%fY&JL|KBk{8MS<kE0hbKz<95zQSFNc!M`;w-5@vO
zn~x;SqwH{#1_2>JTXgSZl;;xCb<KHzV#e6yAFYBa#iabPXYiuomi8Z?WuUF^mQeJO
bQ0MD=u#M4kpQh+*G#?u*^<{s}AO<(+j9=+2

diff --git a/accounting/types.go b/accounting/types.go
index af883a29..a100cf2f 100644
--- a/accounting/types.go
+++ b/accounting/types.go
@@ -169,10 +169,10 @@ func (b *Cheque) marshalBody() []byte {
 	offset += copy(buf, b.ID.Bytes())
 	offset += copy(buf[offset:], b.Owner.Bytes())
 
-	binary.BigEndian.PutUint64(buf[offset:], uint64(b.Amount.Value))
+	binary.LittleEndian.PutUint64(buf[offset:], uint64(b.Amount.Value))
 	offset += u64size
 
-	binary.BigEndian.PutUint64(buf[offset:], b.Height)
+	binary.LittleEndian.PutUint64(buf[offset:], b.Height)
 
 	return buf
 }
@@ -199,13 +199,13 @@ func (b *Cheque) unmarshalBody(buf []byte) error {
 	}
 
 	{ // unmarshal amount
-		amount := int64(binary.BigEndian.Uint64(buf[offset:]))
+		amount := int64(binary.LittleEndian.Uint64(buf[offset:]))
 		b.Amount = decimal.New(amount)
 		offset += u64size
 	}
 
 	{ // unmarshal height
-		b.Height = binary.BigEndian.Uint64(buf[offset:])
+		b.Height = binary.LittleEndian.Uint64(buf[offset:])
 		offset += u64size
 	}
 
@@ -220,7 +220,7 @@ func (b Cheque) MarshalBinary() ([]byte, error) {
 		offset = copy(buf, b.marshalBody())
 	)
 
-	binary.BigEndian.PutUint16(buf[offset:], uint16(count))
+	binary.LittleEndian.PutUint16(buf[offset:], uint16(count))
 	offset += u16size
 
 	for _, sign := range b.Signatures {
@@ -246,7 +246,7 @@ func (b *Cheque) UnmarshalBinary(buf []byte) error {
 
 	body := buf[:signaturesOffset]
 
-	count := int64(binary.BigEndian.Uint16(buf[signaturesOffset:]))
+	count := int64(binary.LittleEndian.Uint16(buf[signaturesOffset:]))
 	offset := signaturesOffset + u16size
 
 	if ln := count * int64(crypto.PublicKeyCompressedSize+crypto.RFC6979SignatureSize); ln > int64(len(buf[offset:])) {
diff --git a/accounting/types_test.go b/accounting/types_test.go
index 424993a8..14aee3b7 100644
--- a/accounting/types_test.go
+++ b/accounting/types_test.go
@@ -80,5 +80,7 @@ func TestCheque(t *testing.T) {
 		require.Equal(t, expect, actual)
 
 		require.NoError(t, cheque.Verify())
+		require.Equal(t, cheque.Height, uint64(7777))
+		require.Equal(t, cheque.Amount, decimal.NewGAS(42))
 	})
 }

From de09878df18f8f268872e69f45021bd135de10e8 Mon Sep 17 00:00:00 2001
From: Evgeniy Kulikov <kim@nspcc.ru>
Date: Thu, 13 Feb 2020 18:10:46 +0300
Subject: [PATCH 2/4] Response meta header

---
 docs/object.md       |  10 ++++++++++
 docs/service.md      |  14 ++++++++++++++
 object/service.pb.go | Bin 123021 -> 131925 bytes
 object/service.proto |  18 +++++++++++++++++-
 service/meta.pb.go   | Bin 9960 -> 14999 bytes
 service/meta.proto   |  10 ++++++++++
 6 files changed, 51 insertions(+), 1 deletion(-)

diff --git a/docs/object.md b/docs/object.md
index d13b6768..ce9252bc 100644
--- a/docs/object.md
+++ b/docs/object.md
@@ -161,6 +161,10 @@ DeleteResponse is empty because we cannot guarantee permanent object removal
 in distributed system.
 
 
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Meta | [service.ResponseMetaHeader](#service.ResponseMetaHeader) |  | ResponseMetaHeader contains meta information based on request processing by server (should be embedded into message) |
+
 
 <a name="object.GetRangeHashRequest"></a>
 
@@ -186,6 +190,7 @@ in distributed system.
 | Field | Type | Label | Description |
 | ----- | ---- | ----- | ----------- |
 | Hashes | [bytes](#bytes) | repeated | Hashes is a homomorphic hashes of all ranges |
+| Meta | [service.ResponseMetaHeader](#service.ResponseMetaHeader) |  | ResponseMetaHeader contains meta information based on request processing by server (should be embedded into message) |
 
 
 <a name="object.GetRangeRequest"></a>
@@ -211,6 +216,7 @@ in distributed system.
 | Field | Type | Label | Description |
 | ----- | ---- | ----- | ----------- |
 | Fragment | [bytes](#bytes) |  | Fragment of object's payload |
+| Meta | [service.ResponseMetaHeader](#service.ResponseMetaHeader) |  | ResponseMetaHeader contains meta information based on request processing by server (should be embedded into message) |
 
 
 <a name="object.GetRequest"></a>
@@ -237,6 +243,7 @@ in distributed system.
 | ----- | ---- | ----- | ----------- |
 | object | [Object](#object.Object) |  | Object header and some payload |
 | Chunk | [bytes](#bytes) |  | Chunk of remaining payload |
+| Meta | [service.ResponseMetaHeader](#service.ResponseMetaHeader) |  | ResponseMetaHeader contains meta information based on request processing by server (should be embedded into message) |
 
 
 <a name="object.HeadRequest"></a>
@@ -263,6 +270,7 @@ in distributed system.
 | Field | Type | Label | Description |
 | ----- | ---- | ----- | ----------- |
 | Object | [Object](#object.Object) |  | Object without payload |
+| Meta | [service.ResponseMetaHeader](#service.ResponseMetaHeader) |  | ResponseMetaHeader contains meta information based on request processing by server (should be embedded into message) |
 
 
 <a name="object.PutRequest"></a>
@@ -300,6 +308,7 @@ in distributed system.
 | Field | Type | Label | Description |
 | ----- | ---- | ----- | ----------- |
 | Address | [refs.Address](#refs.Address) |  | Address of object (container id + object id) |
+| Meta | [service.ResponseMetaHeader](#service.ResponseMetaHeader) |  | ResponseMetaHeader contains meta information based on request processing by server (should be embedded into message) |
 
 
 <a name="object.SearchRequest"></a>
@@ -326,6 +335,7 @@ in distributed system.
 | Field | Type | Label | Description |
 | ----- | ---- | ----- | ----------- |
 | Addresses | [refs.Address](#refs.Address) | repeated | Addresses of found objects |
+| Meta | [service.ResponseMetaHeader](#service.ResponseMetaHeader) |  | ResponseMetaHeader contains meta information based on request processing by server (should be embedded into message) |
 
  <!-- end messages -->
 
diff --git a/docs/service.md b/docs/service.md
index 454fab42..90e1bd2b 100644
--- a/docs/service.md
+++ b/docs/service.md
@@ -7,6 +7,7 @@
 
   - Messages
     - [RequestMetaHeader](#service.RequestMetaHeader)
+    - [ResponseMetaHeader](#service.ResponseMetaHeader)
     
 
 - [service/verify.proto](#service/verify.proto)
@@ -49,6 +50,19 @@ RequestMetaHeader contains information about request meta headers
 | Epoch | [uint64](#uint64) |  | Epoch for user can be empty, because node sets epoch to the actual value |
 | Version | [uint32](#uint32) |  | Version defines protocol version TODO: not used for now, should be implemented in future |
 
+
+<a name="service.ResponseMetaHeader"></a>
+
+### Message ResponseMetaHeader
+ResponseMetaHeader contains meta information based on request processing by server
+(should be embedded into message)
+
+
+| Field | Type | Label | Description |
+| ----- | ---- | ----- | ----------- |
+| Epoch | [uint64](#uint64) |  | Current NeoFS epoch on server |
+| Version | [uint32](#uint32) |  | Version defines protocol version TODO: not used for now, should be implemented in future |
+
  <!-- end messages -->
 
  <!-- end enums -->
diff --git a/object/service.pb.go b/object/service.pb.go
index 1ecf6d9b34d58a5b9c714504fdc04c3d1274b4ee..46891e2f97ab73398f4f4cf1c3b3fffbfb802000 100644
GIT binary patch
delta 7238
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

delta 5934
zcmZXYU5H&*6~{R-W^N`kowiPz)Y|k;S`rO0Ip^Ga?m1V`hYpBjAT6~h661K!mmk=s
zXu;8!(<%rGRd6f!!9EQ7AhjxmOSuMoXp1iqkt!(GS_>AdQk=YK^CIZl|KDb~Y97v<
z?6dd!{ICC7`~K!Dy(gYudgjd|?z_j{=H5JV$~FCa+)w(qxcg7v;(pLyv-iaPwSV0G
z{Z~h3Pp*FS_)34_pX(povJ)rW1KS(6d)0l({{G(n{;mIx*-uaZaK(N3;iK-}%`@&p
zTW8!;+x^)q+1)F*El9A}GxwFBZmLK7?(w_c?@k^2ul>_s+!Nh2dvWvf%Id<QOPAfo
z!M?li{&S}MJMKqYJ@>~4d+z1!W3$^Ic;m?W!q)z!%jFjyZTepNo$mC<-o2<{_SE)|
zSO3SFOP4<|`P?V9f88`3c3*txylFY%wl+89#Y>+!_svJVvb$XGp_SS8m8|!cA|JZx
z=O6AyXZ!I^Rr}|t@y}-9pV{#2^5J+V8S1k>6xx*N^C0)@x!#*p@7g)hdtLgKLF}JH
zt&gN;toKas^+*c3Lc0o`%k)03bXqIJ!oOG2ld@A*6q1xmQZd&4iFWE8X(bwJi8Fsp
z&^YtYkpwkzp&Lj8{vc^286(MywW)3Wu~H%$)@4x{%LkmR<n&l(52UBku}a!v9mpl3
z(0i@-F2yALPrROqo+jJg8`2PK(^yNj44&w{l}<9oIyuCJLV{SSq#%{?Ey+_-I}3wP
z^Z-fv(kQIC;?`<crDrKCFpoVzqSRMXpOakK7_(kTL9SqM3{w?=ZYM*JPGmaK=zS#X
zGjz(^T-MjD$kMSQX|WJig$zWb5;~F~aFdc4i5Sbs*6-<d2Finh#loFPb}elj%k@5}
z2$GZzNwkiI16rBrYY?Zesh;4y(4JCG4P>^EWcm>|kcL?Q0f(40kzqpx2CO1!sCB+J
z@_ejkI3-(ZodRg1k~Dxr1;!V5XBDb*t(FR%7%5k*3<<izK)T2JnrH=ZC$c)3kOl?1
z)v;XhgaSZ4$4Z&!>(KNA-&R|5S<xtawM-=q6Rl4OQX+$Ki$o7((nQbkf`}n2m?ygs
z4Xvf-tm)?%CK;o7D3Lh8+Q?BVCzb3<X&uNz4#Oq6yn@6^8IR|{J(2#hl>+$7in24*
zjs6cfkW4BWW2Iz5iscC)LS8GWv208PiH1aHI&4`t1w%?qB0v%dGdlG8OL@W*$N(;k
z#5$soU<(yp$?Q_H$8eSe(M;$K0Wp{jPisF8T420>3WTZ;0B95?oHkt9rhy!-36;_S
z%d-w*Qxc%B2!i~E3QsN@>0c9gwJka?yOeC|hiVAXldbpzfkTHN6M9dOD&L3*pbMl#
z?t^GSyip8enoKMGgxeBlwg9C<K5!UH1+sVo0Ifd7+%g~*(qXGahY22i59W-ubE0rk
z-0@(+|Bw^mrj!WlfnEc>13rfQDoJ7md<28#VJ4ulK2ZoWxdt`1`U=tI7JsjS)(U5o
z+KYVy?WLmdkmv!og7nB#Dl;dxs)I_lSPgjvjlu(<1Kf2u>68Z&KsTYA(ZL6NRm7-e
zY^kJ^J{pH0X%o#X(Xm!f4uG4nT&uK>@uN<LwF)|08-1=7Vf4o}KIj8DB*X-4Ag4$8
zqbCy-frKU#)QGr<LaUk>cZ#q9*GCC54K1HEz{(0}jBJ@ob&&?rI?+ysE$Rc!HNnFL
znscG8lvS50l(dBufXdHS?^N_+rCSfMDxuOW^uBuKf^~E60s|Ww;1xD8NYYFwS*Wq&
zKqX1Jd?xgaKfXnnHedxQ*+^zfj25(fCZfPxa)&vSu@RbJrZD!mv#>Qp(-FOt4@9X|
zxLHc&9Ld$dvcpuz{0I3NnVD3E8i+7ZlW2`P#3F-)4-zd!UEAg_xlZF}=%hBoSdT4A
z3AIo6VU(vDv1KUoty5`$YpDhrKjL6F5}=OX?cgV%q?<01AG12352F=nU>0Kjp#mr(
zhR#gJKy^cfA@mQW2TW@6?slNvz;W`{K<uMb%4v9)32V53eMSTb3RWI#KchF{p#m#H
zs4zpB#t%|pNw@ifHV=F%)fin1(hS!M!2mx&=0H-J1#LVv0Kf?}aGQ3OXjNJm<YZn*
z48?DOG5uUFM)EC8lJr9zfRq61SUvzH8~42i*osYrl{C<O_?n_wwosX&jT>%FKi!wZ
zOp>*#A>4fkS*p@xcwtfq;So(R)lnJLd#->{X<>Gg(9pRQyev7p-0deCbaPD@%3}7?
zO#_Q4NH7PpP_9ssq;Ts}HG*XG(+6oH{@_-OBh0fS<}dr>>sL7;48RK16K)a{NLI0+
zXIkBQ4cvrbMOrSCc_v4|KC}Xfz;u>*KYs-%DJGODQv;)&v4PhBL+(%dc5Ecq6JZap
zZ~=TWK`f?<uE;DJI#ewE24b&)PC&JgbgBr=5I7A4G9^i2b`mnV8q#-Y*FfK}Ed`1&
zb3rY96cf!q;H{7h1~Y1TEEXvQ9J(UpPqf42OHDA=#}tlG0`|iFK%2s4jdra)Wi9<s
zcc?>}qYlvhpjWd_i5A`oB5jHAK(%l%0|u$DDPleGdAPs{8S`Jb)@0JaJsuozDWaXz
zX6bnR;$ih;FbGIjkiv~$kf3518X!okFz*7FHEzyrr@eRr$%Nl46ac7!F(+7o9z97I
zFl55E+0ttW<tRrN=Ovmc7zUY5rxa6xY-K)WNTlzQ07gigFuevS05mW#23D3h?y^iX
zOx3Z9i^d8M;AX-66<Cxk5v5S-0t>x{k%P1%iDcka_-RM`slxz0t%UoG!e%3aTu>|Q
z!nmtl)H1^@Z84Wg3>aKBx!sVA#mWfjR*4z(y$0qVo*WC8FI5R_*@M#Ka@K$1`Fp3E
zcSN_&uD$r4Tc^LgIlAUv$$IY9^GojPjs5r8SO5I2rRmLgM@w$?<)d!*#<IJ<x9*<1
z@xtu--d_&6&0qgxwtM4HZ(6=H>QA3pi`JffI=a@IUs#U5c6j=ybJ3kzod0$`T07{f
z*EgouPevpAt$2O@?c1Z}L(_lvqqk0X&qo*COWBHP@6EUR(fba#EC1Y>+t$YpOrJXu
zeb|1%U7NrCRP@4ueHqgey=d8e{3A=#3;pQv`SO|Q*@(R-uH58yKeaS}<ZSf%{{D2n
zcRsr9_<Zj|^x#SVd@Y)<eKz{t(fMnQy}PI1yE^~*_oG*%`R>=Fi|g!gpZQ?VedFSi
n|MI<K^SwVrZ$#6_-W465Z~ZK~deko*xWjL?V^{wbJ$dLq!|xi6

diff --git a/object/service.proto b/object/service.proto
index f208472c..dbd2a809 100644
--- a/object/service.proto
+++ b/object/service.proto
@@ -73,6 +73,9 @@ message GetResponse {
         // Chunk of remaining payload
         bytes Chunk   = 2;
     }
+
+    // ResponseMetaHeader contains meta information based on request processing by server (should be embedded into message)
+    service.ResponseMetaHeader Meta = 99 [(gogoproto.embed) = true, (gogoproto.nullable) = false];
 }
 
 message PutRequest {
@@ -99,6 +102,8 @@ message PutRequest {
 message PutResponse {
     // Address of object (container id + object id)
     refs.Address Address = 1 [(gogoproto.nullable) = false];
+    // ResponseMetaHeader contains meta information based on request processing by server (should be embedded into message)
+    service.ResponseMetaHeader Meta = 99 [(gogoproto.embed) = true, (gogoproto.nullable) = false];
 }
 message DeleteRequest {
     // Address of object (container id + object id)
@@ -115,7 +120,10 @@ message DeleteRequest {
 
 // DeleteResponse is empty because we cannot guarantee permanent object removal
 // in distributed system.
-message DeleteResponse {}
+message DeleteResponse {
+    // ResponseMetaHeader contains meta information based on request processing by server (should be embedded into message)
+    service.ResponseMetaHeader Meta = 99 [(gogoproto.embed) = true, (gogoproto.nullable) = false];
+}
 
 message HeadRequest {
     // Address of object (container id + object id)
@@ -132,6 +140,8 @@ message HeadRequest {
 message HeadResponse {
     // Object without payload
     Object Object = 1;
+    // ResponseMetaHeader contains meta information based on request processing by server (should be embedded into message)
+    service.ResponseMetaHeader Meta = 99 [(gogoproto.embed) = true, (gogoproto.nullable) = false];
 }
 
 message SearchRequest {
@@ -150,6 +160,8 @@ message SearchRequest {
 message SearchResponse {
     // Addresses of found objects
     repeated refs.Address Addresses = 1 [(gogoproto.nullable) = false];
+    // ResponseMetaHeader contains meta information based on request processing by server (should be embedded into message)
+    service.ResponseMetaHeader Meta = 99 [(gogoproto.embed) = true, (gogoproto.nullable) = false];
 }
 
 message GetRangeRequest {
@@ -166,6 +178,8 @@ message GetRangeRequest {
 message GetRangeResponse {
     // Fragment of object's payload
     bytes Fragment = 1;
+    // ResponseMetaHeader contains meta information based on request processing by server (should be embedded into message)
+    service.ResponseMetaHeader Meta = 99 [(gogoproto.embed) = true, (gogoproto.nullable) = false];
 }
 
 message GetRangeHashRequest {
@@ -184,5 +198,7 @@ message GetRangeHashRequest {
 message GetRangeHashResponse {
     // Hashes is a homomorphic hashes of all ranges
     repeated bytes Hashes = 1 [(gogoproto.customtype) = "Hash", (gogoproto.nullable) = false];
+    // ResponseMetaHeader contains meta information based on request processing by server (should be embedded into message)
+    service.ResponseMetaHeader Meta = 99 [(gogoproto.embed) = true, (gogoproto.nullable) = false];
 }
 
diff --git a/service/meta.pb.go b/service/meta.pb.go
index 9b2f430eeb7736b71afbb68ef1c31b7c47c951ff..b4769e228b5a291c967b61288e34e685f667d6ee 100644
GIT binary patch
delta 983
zcmZuvO=}ZT6lIb&%}k1k_9K)ceG#llh<3hBC=?`61gS{02$e2oCNFWo%*2^VO$jmU
zE_Cw*!G-<-(ZcLSEV%G%r><Np{tD;a$!m$axpUsR_ndq0d-H4SY47kr*j`&h4eWPa
z$H!YZFs@>wi9KYwPGH!Mk2(>DY^UXV9V4(^2bqSCn<xSvzTd-sfV!S*Vc)l%HZu2-
zkG(zY5iWUg{U1|5@OoB&1_B>7t@k_+I{~_m-OZZ_cU|i)bsg&qQw2^U^{IE9Oj6Tt
zQ?VEMIDLNgZ`;8T4TV<Eu~4yt%4`=hpSs3W%~Y8|lG<66hQj{@iJ2R$>h{bLgDdF`
z2F>&;gOAed41P}Q45s;GSm!0ie&z2ls0pvG@X>t*?xhB9+kSw(Tl-yHEFO=2@&u)#
zW8W)P&^dY|wuK|b_!7Pe&l9Q|?qzn9BkghpiG8a^V^yP3HEEQqC(#7nj2W>a@M2$S
z(X;_kfrJD_v5{uc>{t+60~1%OfOU!1<W-q|6gXI5A=jb~<j1KJhe$fBC8EPdwv?w;
zabBeg30h;FjIt}V<VBX&f5^%sRe=e0Fpj6HDO6&JG-@E!4T?<+3@mIywg!w2^;KXD
zxF8L91sGL@1~RNsh4sWHHNuq1_I2=!Jyemr&McB=x!FP!rdOb`4Est37)1j|Vo?g;
z=MIvy6aV1P+;{f$N2ec-VYqpw%#km188Vn_gcs&_6O$r+p%K1WcqvS<VJ-igV_wCj
XHiJ)=4#Q8&HI6)3-VS%pKIZ=b^N%qa

delta 315
zcmYk0F$%&!5JfS9kaR{!v@&QVq!`z%(F0go*a{ZWb#EX96s^TVWD6S)A#CMwY{b$d
z==^PLKA-u2-pqCLp5BjvDe80MhZj$fy@iWvpz<`KQjF8YoTHu>_~sGGN@6}yuNnAM
z4kYr7b&2j;8j9P$$}C2I8;gTh$cc4Sux39Zl?oG~**lWbDPsi|<cNcni~I0ckOTH^
zt&ffnJQ)ws!7~J(Lnp-_LJ%$xNKQ3kr#W~-Tp(z^WU5x?88+;xxvSc4TY7fadHJ@L
G?Q37hj8YZ=

diff --git a/service/meta.proto b/service/meta.proto
index 5ca3633d..97017c9d 100644
--- a/service/meta.proto
+++ b/service/meta.proto
@@ -18,3 +18,13 @@ message RequestMetaHeader {
     // TODO: not used for now, should be implemented in future
     uint32 Version = 3;
 }
+
+// ResponseMetaHeader contains meta information based on request processing by server
+// (should be embedded into message)
+message ResponseMetaHeader {
+    // Current NeoFS epoch on server
+    uint64 Epoch   = 1;
+    // Version defines protocol version
+    // TODO: not used for now, should be implemented in future
+    uint32 Version = 2;
+}

From a21e42ea4fed167b90e59d2aa8b9b748f30e0dc6 Mon Sep 17 00:00:00 2001
From: Leonard Lyubich <leonard@nspcc.ru>
Date: Fri, 14 Feb 2020 12:14:19 +0300
Subject: [PATCH 3/4] Implement Epoch and Version setters on ResponseMetaHeader

---
 service/meta.go      |  6 ++++++
 service/meta_test.go | 14 ++++++++++++++
 2 files changed, 20 insertions(+)

diff --git a/service/meta.go b/service/meta.go
index 95c1b13a..dc2cdd36 100644
--- a/service/meta.go
+++ b/service/meta.go
@@ -62,6 +62,12 @@ const (
 	ErrIncorrectTTL = internal.Error("incorrect ttl")
 )
 
+// SetVersion sets protocol version to ResponseMetaHeader.
+func (m *ResponseMetaHeader) SetVersion(v uint32) { m.Version = v }
+
+// SetEpoch sets Epoch to ResponseMetaHeader.
+func (m *ResponseMetaHeader) SetEpoch(v uint64) { m.Epoch = v }
+
 // SetVersion sets protocol version to RequestMetaHeader.
 func (m *RequestMetaHeader) SetVersion(v uint32) { m.Version = v }
 
diff --git a/service/meta_test.go b/service/meta_test.go
index e208dfe1..083ccd66 100644
--- a/service/meta_test.go
+++ b/service/meta_test.go
@@ -88,3 +88,17 @@ func TestMetaRequest(t *testing.T) {
 		})
 	}
 }
+
+func TestRequestMetaHeader_SetEpoch(t *testing.T) {
+	m := new(ResponseMetaHeader)
+	epoch := uint64(3)
+	m.SetEpoch(epoch)
+	require.Equal(t, epoch, m.GetEpoch())
+}
+
+func TestRequestMetaHeader_SetVersion(t *testing.T) {
+	m := new(ResponseMetaHeader)
+	version := uint32(3)
+	m.SetVersion(version)
+	require.Equal(t, version, m.GetVersion())
+}

From 04ead038592aa32eac60e25751c0654033eccb67 Mon Sep 17 00:00:00 2001
From: alexvanin <alexey@nspcc.ru>
Date: Tue, 18 Feb 2020 12:04:09 +0300
Subject: [PATCH 4/4] Update changelog for v0.4.0

---
 CHANGELOG.md | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 124d3495..d8325681 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,13 @@
 # Changelog
-This is the changelog for NeoFS Proto
+This is the changelog for NeoFS API
+
+## [0.4.0] - 2020-02-18
+
+### Added 
+- Meta header for all gRPC responses. It contains epoch stamp and version number.
+### Changed
+- Endianness in accounting cheque. Now it uses little endian for cheaper
+decoding in neofs smart-contract.
 
 ## [0.3.2] - 2020-02-10
 
@@ -189,3 +197,4 @@ Initial public release
 [0.3.0]: https://github.com/nspcc-dev/neofs-api/compare/v0.2.14...v0.3.0
 [0.3.1]: https://github.com/nspcc-dev/neofs-api/compare/v0.3.0...v0.3.1
 [0.3.2]: https://github.com/nspcc-dev/neofs-api/compare/v0.3.1...v0.3.2
+[0.4.0]: https://github.com/nspcc-dev/neofs-api/compare/v0.3.2...v0.4.0