feat(common): Add GetFirmwareHash message.

common/protob/messages-management.proto

@@ -234,6 +234,24 @@ message Entropy {
     required bytes entropy = 1;     // chunk of random generated bytes
 }
 
+/**
+ * Request: Get a hash of the installed firmware combined with an optional challenge.
+ * @start
+ * @next FirmwareHash
+ * @next Failure
+ */
+message GetFirmwareHash {
+    optional bytes challenge = 1;   // Blake2s key up to 32 bytes in length.
+}
+
+/**
+ * Response: Hash of the installed firmware combined with the optional challenge.
+ * @end
+ */
+message FirmwareHash {
+    required bytes hash = 1;
+}
+
 /**
  * Request: Request device to wipe all sensitive data and settings
  * @start

common/protob/messages.proto

@@ -114,6 +114,8 @@ enum MessageType {
     MessageType_PreauthorizedRequest = 85 [(bitcoin_only) = true, (wire_out) = true];
     MessageType_CancelAuthorization = 86 [(bitcoin_only) = true, (wire_in) = true];
     MessageType_RebootToBootloader = 87 [(bitcoin_only) = true, (wire_in) = true];
+    MessageType_GetFirmwareHash = 88 [(bitcoin_only) = true, (wire_in) = true];
+    MessageType_FirmwareHash = 89 [(bitcoin_only) = true, (wire_out) = true];
 
     MessageType_SetU2FCounter = 63 [(wire_in) = true];
     MessageType_GetNextU2FCounter = 80 [(wire_in) = true];

core/src/trezor/enums/MessageType.py

@@ -41,6 +41,8 @@ DoPreauthorized = 84
 PreauthorizedRequest = 85
 CancelAuthorization = 86
 RebootToBootloader = 87
+GetFirmwareHash = 88
+FirmwareHash = 89
 FirmwareErase = 6
 FirmwareUpload = 7
 FirmwareRequest = 8

core/src/trezor/enums/__init__.py

@@ -58,6 +58,8 @@ if TYPE_CHECKING:
         PreauthorizedRequest = 85
         CancelAuthorization = 86
         RebootToBootloader = 87
+        GetFirmwareHash = 88
+        FirmwareHash = 89
         SetU2FCounter = 63
         GetNextU2FCounter = 80
         NextU2FCounter = 81

core/src/trezor/messages.py

@@ -2190,6 +2190,34 @@ if TYPE_CHECKING:
         def is_type_of(cls, msg: protobuf.MessageType) -> TypeGuard["Entropy"]:
             return isinstance(msg, cls)
 
+    class GetFirmwareHash(protobuf.MessageType):
+        challenge: "bytes | None"
+
+        def __init__(
+            self,
+            *,
+            challenge: "bytes | None" = None,
+        ) -> None:
+            pass
+
+        @classmethod
+        def is_type_of(cls, msg: protobuf.MessageType) -> TypeGuard["GetFirmwareHash"]:
+            return isinstance(msg, cls)
+
+    class FirmwareHash(protobuf.MessageType):
+        hash: "bytes"
+
+        def __init__(
+            self,
+            *,
+            hash: "bytes",
+        ) -> None:
+            pass
+
+        @classmethod
+        def is_type_of(cls, msg: protobuf.MessageType) -> TypeGuard["FirmwareHash"]:
+            return isinstance(msg, cls)
+
     class WipeDevice(protobuf.MessageType):
 
         @classmethod

python/src/trezorlib/messages.py

@@ -66,6 +66,8 @@ class MessageType(IntEnum):
     PreauthorizedRequest = 85
     CancelAuthorization = 86
     RebootToBootloader = 87
+    GetFirmwareHash = 88
+    FirmwareHash = 89
     SetU2FCounter = 63
     GetNextU2FCounter = 80
     NextU2FCounter = 81
@@ -3487,6 +3489,34 @@ class Entropy(protobuf.MessageType):
         self.entropy = entropy
 
 
+class GetFirmwareHash(protobuf.MessageType):
+    MESSAGE_WIRE_TYPE = 88
+    FIELDS = {
+        1: protobuf.Field("challenge", "bytes", repeated=False, required=False),
+    }
+
+    def __init__(
+        self,
+        *,
+        challenge: Optional["bytes"] = None,
+    ) -> None:
+        self.challenge = challenge
+
+
+class FirmwareHash(protobuf.MessageType):
+    MESSAGE_WIRE_TYPE = 89
+    FIELDS = {
+        1: protobuf.Field("hash", "bytes", repeated=False, required=True),
+    }
+
+    def __init__(
+        self,
+        *,
+        hash: "bytes",
+    ) -> None:
+        self.hash = hash
+
+
 class WipeDevice(protobuf.MessageType):
     MESSAGE_WIRE_TYPE = 5