update: signed state response with caught timestamp

Author: mhrynenko

docs/spec/components/schemas/Signature.yaml renamed to docs/spec/components/schemas/State.yaml

@@ -8,8 +8,15 @@ allOf:
         type: object
         required:
           - signature
+          - timestamp
         properties:
           signature:
             example: "0xd0bf2f6c2270874d8870a1081b67fcb0280b61db000778f159ba39c38fb2595639c2e1d81d085916ba6ec77f2bd4c4a2ae6dfbdbaf8703da7d9fe629b2e1218a00"
             type: string
-            pattern: '^0x([0-9a-fA-F]+)$'
+            pattern: '^0x([0-9a-fA-F]+)$'
+            description: Signature of root state signed by relayer private key.
+          timestamp:
+            example: "1733395652"
+            type: integer
+            format: int64
+            description: Time indicates when the event was caught, a.k.a state transition timestamp

docs/spec/paths/integrations@proof-verification-relayer@v1@state.yaml

@@ -36,7 +36,7 @@ get:
               - data
             properties:
               data:
-                $ref: '#/components/schemas/Signature'
+                $ref: '#/components/schemas/State'
     '400':
       description: Bad Request Error
       content:

internal/service/api/handlers/get_signed_state.go

@@ -50,13 +50,14 @@ func GetSignedState(w http.ResponseWriter, r *http.Request) {
 		return
 	}
 
-	ape.Render(w, resources.Signature{
+	ape.Render(w, resources.State{
 		Key: resources.Key{
 			ID:   state.ID,
 			Type: resources.STATE,
 		},
-		Attributes: resources.SignatureAttributes{
+		Attributes: resources.StateAttributes{
 			Signature: hex.EncodeToString(signature),
+			Timestamp: state.CreatedAt.Unix(),
 		},
 	})
 }

resources/model_signature.go

@@ -0,0 +1,31 @@
+/*
+ * GENERATED. Do not modify. Your changes might be overwritten!
+ */
+
+package resources
+
+type State struct {
+	Key
+	Attributes StateAttributes `json:"attributes"`
+}
+type StateResponse struct {
+	Data     State    `json:"data"`
+	Included Included `json:"included"`
+}
+
+type StateListResponse struct {
+	Data     []State  `json:"data"`
+	Included Included `json:"included"`
+	Links    *Links   `json:"links"`
+}
+
+// MustState - returns State from include collection.
+// if entry with specified key does not exist - returns nil
+// if entry with specified key exists but type or ID mismatches - panics
+func (c *Included) MustState(key Key) *State {
+	var state State
+	if c.tryFindEntry(key, &state) {
+		return &state
+	}
+	return nil
+}

resources/model_signature_attributes.go

@@ -0,0 +1,12 @@
+/*
+ * GENERATED. Do not modify. Your changes might be overwritten!
+ */
+
+package resources
+
+type StateAttributes struct {
+	// Signature of root state signed by relayer private key.
+	Signature string `json:"signature"`
+	// Time indicates when the event was caught, a.k.a state transition timestamp
+	Timestamp int64 `json:"timestamp"`
+}