Merge pull request #303 from nspcc-dev/zero-ids

nspcc-dev · Jul 22, 2024 · ec8f1f5 · ec8f1f5
2 parents 62e4ae0 + 20a2515
commit ec8f1f5
Show file tree

Hide file tree

Showing 2 changed files with 8 additions and 4 deletions.
diff --git a/proto-docs/refs.md b/proto-docs/refs.md
@@ -71,7 +71,8 @@ content-addressed.
 
 `ContainerID` is a 32 byte long
 [SHA256](https://csrc.nist.gov/publications/detail/fips/180/4/final) hash of
-stable-marshalled container message.
+stable-marshalled container message. ID consisting of all zero bytes is
+reserved for undefined value and must not be specified as a field.
 
 String presentation is a
 [base58](https://tools.ietf.org/html/draft-msporny-base58-02) encoded string.
@@ -97,7 +98,8 @@ It means `ObjectID` will change if the `header` or the `payload` changes.
 `ObjectID` is a 32 byte long
 [SHA256](https://csrc.nist.gov/publications/detail/fips/180/4/final) hash of
 the object's `header` field, which, in it's turn, contains the hash of the object's
-payload.
+payload. ID consisting of all zero bytes is reserved for undefined value and
+must not be specified as a field.
 
 String presentation is a
 [base58](https://tools.ietf.org/html/draft-msporny-base58-02) encoded string.

diff --git a/refs/types.proto b/refs/types.proto
@@ -22,7 +22,8 @@ message Address {
 // `ObjectID` is a 32 byte long
 // [SHA256](https://csrc.nist.gov/publications/detail/fips/180/4/final) hash of
 // the object's `header` field, which, in it's turn, contains the hash of the object's
-// payload.
+// payload. ID consisting of all zero bytes is reserved for undefined value and
+// must not be specified as a field.
 //
 // String presentation is a
 // [base58](https://tools.ietf.org/html/draft-msporny-base58-02) encoded string.
@@ -42,7 +43,8 @@ message ObjectID {
 //
 // `ContainerID` is a 32 byte long
 // [SHA256](https://csrc.nist.gov/publications/detail/fips/180/4/final) hash of
-// stable-marshalled container message.
+// stable-marshalled container message. ID consisting of all zero bytes is
+// reserved for undefined value and must not be specified as a field.
 //
 // String presentation is a
 // [base58](https://tools.ietf.org/html/draft-msporny-base58-02) encoded string.