api: blocks/{round}/logs endpoint

daemon/algod/api/algod.oas2.json

@@ -787,6 +787,62 @@
         }
       ]
     },
+    "/v2/blocks/{round}/logs": {
+      "get": {
+        "tags": [
+          "public",
+          "nonparticipating"
+        ],
+        "description": "Get all of the logs from outer and inner app calls in the given round",
+        "produces": [
+          "application/json"
+        ],
+        "schemes": [
+          "http"
+        ],
+        "summary": "Get all of the logs from outer and inner app calls in the given round",
+        "operationId": "GetBlockLogs",
+        "parameters": [
+          {
+            "minimum": 0,
+            "type": "integer",
+            "description": "The round from which to fetch block log information.",
+            "name": "round",
+            "in": "path",
+            "required": true
+          }
+        ],
+        "responses": {
+          "200": {
+            "$ref": "#/responses/BlockLogsResponse"
+          },
+          "400": {
+            "description": "Bad Request - Non integer number",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          },
+          "401": {
+            "description": "Invalid API Token",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          },
+          "404": {
+            "description": "Nonexistent block ",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          },
+          "500": {
+            "description": "Internal Error",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
     "/v2/ledger/supply": {
       "get": {
         "tags": [
@@ -4449,6 +4505,33 @@
           }
         }
       }
+    },
+    "AppCallLogs": {
+      "description": "An array of logs for a given application ID and outer transaction ID",
+      "type": "object",
+      "required": [
+        "logs",
+        "application-index",
+        "txid"
+      ],
+      "properties": {
+        "logs": {
+          "description": "An array of logs",
+          "type": "array",
+          "items": {
+            "type": "string",
+            "format": "byte"
+          }
+        },
+        "application-index": {
+          "description": "The application from which the logs were generated",
+          "type": "integer"
+        },
+        "txid": {
+          "description": "The transaction ID of the outer app call that lead to these logs",
+          "type": "string"
+        }
+      }
     }
   },
   "parameters": {
@@ -5106,6 +5189,23 @@
         }
       }
     },
+    "BlockLogsResponse": {
+      "description": "All of the logs from outer and inner app calls in the given round",
+      "schema": {
+        "type": "object",
+        "required": [
+          "logs"
+        ],
+        "properties": {
+          "logs": {
+            "type": "array",
+            "items": {
+              "$ref": "#/definitions/AppCallLogs"
+            }
+          }
+        }
+      }
+    },
     "SupplyResponse": {
       "description": "Supply represents the current supply of MicroAlgos in the system.",
       "schema": {

daemon/algod/api/algod.oas3.yml

@@ -323,6 +323,27 @@
         },
         "description": "Hash of a block header."
       },
+      "BlockLogsResponse": {
+        "content": {
+          "application/json": {
+            "schema": {
+              "properties": {
+                "logs": {
+                  "items": {
+                    "$ref": "#/components/schemas/AppCallLogs"
+                  },
+                  "type": "array"
+                }
+              },
+              "required": [
+                "logs"
+              ],
+              "type": "object"
+            }
+          }
+        },
+        "description": "All of the logs from outer and inner app calls in the given round"
+      },
       "BlockResponse": {
         "content": {
           "application/json": {
@@ -1203,6 +1224,34 @@
         ],
         "type": "object"
       },
+      "AppCallLogs": {
+        "description": "An array of logs for a given application ID and outer transaction ID",
+        "properties": {
+          "application-index": {
+            "description": "The application from which the logs were generated",
+            "type": "integer"
+          },
+          "logs": {
+            "description": "An array of logs",
+            "items": {
+              "format": "byte",
+              "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$",
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "txid": {
+            "description": "The transaction ID of the outer app call that lead to these logs",
+            "type": "string"
+          }
+        },
+        "required": [
+          "application-index",
+          "logs",
+          "txid"
+        ],
+        "type": "object"
+      },
       "Application": {
         "description": "Application index and its parameters",
         "properties": {
@@ -3976,6 +4025,92 @@
         ]
       }
     },
+    "/v2/blocks/{round}/logs": {
+      "get": {
+        "description": "Get all of the logs from outer and inner app calls in the given round",
+        "operationId": "GetBlockLogs",
+        "parameters": [
+          {
+            "description": "The round from which to fetch block log information.",
+            "in": "path",
+            "name": "round",
+            "required": true,
+            "schema": {
+              "minimum": 0,
+              "type": "integer"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "properties": {
+                    "logs": {
+                      "items": {
+                        "$ref": "#/components/schemas/AppCallLogs"
+                      },
+                      "type": "array"
+                    }
+                  },
+                  "required": [
+                    "logs"
+                  ],
+                  "type": "object"
+                }
+              }
+            },
+            "description": "All of the logs from outer and inner app calls in the given round"
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Bad Request - Non integer number"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Invalid API Token"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Nonexistent block "
+          },
+          "500": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Internal Error"
+          }
+        },
+        "summary": "Get all of the logs from outer and inner app calls in the given round",
+        "tags": [
+          "public",
+          "nonparticipating"
+        ]
+      }
+    },
     "/v2/blocks/{round}/transactions/{txid}/proof": {
       "get": {
         "operationId": "GetTransactionProof",

daemon/algod/api/client/restClient.go

@@ -776,3 +776,9 @@ func (client RestClient) GetBlockTimestampOffset() (response model.GetBlockTimeS
 	err = client.get(&response, "/v2/devmode/blocks/offset", nil)
 	return
 }
+
+// BlockLogs returns all the logs in a block for a given round
+func (client RestClient) BlockLogs(round uint64) (response model.BlockLogsResponse, err error) {
+	err = client.get(&response, fmt.Sprintf("/v2/blocks/%d/logs", round), nil)
+	return
+}