aboutsummaryrefslogtreecommitdiff
path: root/proto
diff options
context:
space:
mode:
authorjuerg <juerg@google.com>2022-07-26 09:24:13 -0700
committerCopybara-Service <copybara-worker@google.com>2022-07-26 09:26:13 -0700
commitb99bb8c8fce28444bc17cb6d4071eb1e6e24597d (patch)
treecec49a35922aca55008e9b8edf97480f28ef561c /proto
parent899ef50ab467f09513db673cb4a51317e9ca664f (diff)
downloadtink-b99bb8c8fce28444bc17cb6d4071eb1e6e24597d.tar.gz
Rewrite comment about key version.
PiperOrigin-RevId: 463353675
Diffstat (limited to 'proto')
-rw-r--r--proto/tink.proto9
1 files changed, 4 insertions, 5 deletions
diff --git a/proto/tink.proto b/proto/tink.proto
index 61145edf8..17875819a 100644
--- a/proto/tink.proto
+++ b/proto/tink.proto
@@ -94,15 +94,14 @@ enum OutputPrefixType {
}
// Each *Key proto by convention contains a version field, which
-// identifies the version of implementation that can work with this key.
+// identifies the version of the key.
// message SomeInstantiationKey {
// uint32 version = 1;
// ...
// }
-// Version is a monotonic counter: each implementation of a primitive
-// has its associated "current version", which starts at 0 and is incremented
-// upon updates of the code/key proto. A key with version n needs
-// an implementation version n or higher to work.
+// If a key type does not mention anything else, only version 0 is currently
+// specified. An implementation must only accept keys with versions it knows,
+// and must reject all keys with unknown version.
// For public key primitives, the public and private keys are distinct entities
// and represent distinct primitives. However, by convention, the private key