[#55] refs: add signature scheme description

Signed-off-by: Evgenii Stratonikov <evgeniy@nspcc.ru>
This commit is contained in:
Evgenii Stratonikov 2022-02-07 15:46:39 +03:00 committed by LeL
parent 2743e4ba11
commit 3302a530f2
2 changed files with 26 additions and 0 deletions

View file

@ -148,6 +148,7 @@ Signature of something in NeoFS.
| ----- | ---- | ----- | ----------- | | ----- | ---- | ----- | ----------- |
| key | [bytes](#bytes) | | Public key used for signing | | key | [bytes](#bytes) | | Public key used for signing |
| sign | [bytes](#bytes) | | Signature | | sign | [bytes](#bytes) | | Signature |
| scheme | [SignatureScheme](#neo.fs.v2.refs.SignatureScheme) | | Scheme contains digital signature scheme identifier. |
<a name="neo.fs.v2.refs.SubnetID"></a> <a name="neo.fs.v2.refs.SubnetID"></a>
@ -194,6 +195,19 @@ Checksum algorithm type.
| SHA256 | 2 | SHA-256 | | SHA256 | 2 | SHA-256 |
<a name="neo.fs.v2.refs.SignatureScheme"></a>
### SignatureScheme
Signature scheme describes digital signing scheme used for (key, signature) pair.
| Name | Number | Description |
| ---- | ------ | ----------- |
| UNSPECIFIED | 0 | Unknown. The default interpretation depends on a particular structure type. |
| ECDSA_SHA512 | 1 | ECDSA with SHA-512 hashing (FIPS 186-3). |
| ECDSA_RFC6979_SHA256 | 2 | Deterministic ECDSA with SHA-256 hashing (RFC 6979) |
<!-- end enums --> <!-- end enums -->

View file

@ -105,6 +105,18 @@ message Signature {
bytes key = 1 [json_name = "key"]; bytes key = 1 [json_name = "key"];
// Signature // Signature
bytes sign = 2 [json_name = "signature"]; bytes sign = 2 [json_name = "signature"];
// Scheme contains digital signature scheme identifier.
SignatureScheme scheme = 3 [json_name = "scheme"];
}
// Signature scheme describes digital signing scheme used for (key, signature) pair.
enum SignatureScheme {
// Unknown. The default interpretation depends on a particular structure type.
UNSPECIFIED = 0;
// ECDSA with SHA-512 hashing (FIPS 186-3).
ECDSA_SHA512 = 1;
// Deterministic ECDSA with SHA-256 hashing (RFC 6979)
ECDSA_RFC6979_SHA256 = 2;
} }
// Checksum algorithm type. // Checksum algorithm type.