064 d freeze txn use instant (#67)

* Added start, end timestamp and deprecate start and end hours/mins

Signed-off-by: ljianghedera <[email protected]>

* Add freeze start timestamp and deprecate start/end hour/min.

Signed-off-by: ljianghedera <[email protected]>

* Tweak comments and variable names for stylistic consistency (#66)

* Tweak comments and variable names for stylistic consistency

Signed-off-by: tinker-michaelj <[email protected]>

* Backwards compatibility

Signed-off-by: tinker-michaelj <[email protected]>

Co-authored-by: Michael Tinker <[email protected]>

services/Freeze.proto

@@ -29,12 +29,13 @@ import "Duration.proto";
 import "Timestamp.proto";
 import "BasicTypes.proto";
 
-/* Set the freezing period in which the platform will stop creating events and accepting transactions. This is used before safely shut down the platform for maintenance. */
+/* At consensus, sets the consensus time at which the platform should stop creating events and accepting transactions, and enter a maintenance window. */
 message FreezeTransactionBody {
-    int32 startHour = 1; // The start hour (in UTC time), a value between 0 and 23
-    int32 startMin = 2; // The start minute (in UTC time), a value between 0 and 59
-    int32 endHour = 3; // The end hour (in UTC time), a value between 0 and 23
-    int32 endMin = 4; // The end minute (in UTC time), a value between 0 and 59
-    FileID updateFile = 5; // The ID of the file needs to be updated during a freeze transaction
-    bytes fileHash = 6; // The hash value of the file, used to verify file content before performing freeze and update
+    int32 startHour = 1 [deprecated=true]; // The start hour (in UTC time), a value between 0 and 23
+    int32 startMin = 2 [deprecated=true]; // The start minute (in UTC time), a value between 0 and 59
+    int32 endHour = 3 [deprecated=true]; // The end hour (in UTC time), a value between 0 and 23
+    int32 endMin = 4 [deprecated=true]; // The end minute (in UTC time), a value between 0 and 59
+    FileID update_file = 5; // If set, the file whose contents should be used for a network software update during the maintenance window
+    bytes file_hash = 6; // If set, the expected hash of the contents of the update file (used to verify the update)
+    Timestamp start_time = 7; // The consensus time at which the maintenance window should begin
 }