simulate: resource population

daemon/algod/api/algod.oas2.json

@@ -3948,6 +3948,10 @@
         "fix-signers": {
           "description": "If true, signers for transactions that are missing signatures will be fixed during evaluation.",
           "type": "boolean"
+        },
+        "populate-resources": {
+          "description": "If true, return populated resource arrays for each transaction based on unnamed resources",
+          "type": "boolean"
         }
       }
     },
@@ -4230,7 +4234,40 @@
         }
       }
     },
-    "SimulateTransactionGroupResult": {
+    "ResourceArrays": {
+      "description": "Resource arrays that are required for a transaction",
+      "type": "object",
+      "properties": {
+        "accounts": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "x-algorand-format": "Address"
+          }
+        },
+        "assets": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "x-algorand-format": "uint64"
+          }
+        },
+        "apps": {
+          "type": "array",
+          "items": {
+            "type": "integer",
+            "x-algorand-format": "uint64"
+          }
+        },
+        "boxes": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/BoxReference"
+          }
+        }
+      }
+    },
+  "SimulateTransactionGroupResult": {
       "description": "Simulation result for an atomic transaction group",
       "type": "object",
       "required": [
@@ -4265,6 +4302,13 @@
         },
         "unnamed-resources-accessed": {
           "$ref": "#/definitions/SimulateUnnamedResourcesAccessed"
+        },
+        "extra-resource-arrays": {
+          "description": "Present if populate-resource-arrays is true in the request and additional tranactions are needed to name all the accessed resources.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ResourceArrays"
+          }
         }
       }
     },
@@ -4296,6 +4340,10 @@
           "description": "The account that needed to sign this transaction when no signature was provided and the provided signer was incorrect.",
           "type": "string",
           "x-algorand-format": "Address"
+        },
+        "populated-resource-arrays": {
+          "description": "Present if populate-resource-arrays is true in the request. In this case, it will be all of the resources this transaction needs to be evaluated.",
+          "$ref": "#/definitions/ResourceArrays"
         }
       }
     },

daemon/algod/api/algod.oas3.yml

@@ -2250,6 +2250,39 @@
         ],
         "type": "object"
       },
+      "ResourceArrays": {
+        "description": "Resource arrays that are required for a transaction",
+        "properties": {
+          "accounts": {
+            "items": {
+              "type": "string",
+              "x-algorand-format": "Address"
+            },
+            "type": "array"
+          },
+          "apps": {
+            "items": {
+              "type": "integer",
+              "x-algorand-format": "uint64"
+            },
+            "type": "array"
+          },
+          "assets": {
+            "items": {
+              "type": "integer",
+              "x-algorand-format": "uint64"
+            },
+            "type": "array"
+          },
+          "boxes": {
+            "items": {
+              "$ref": "#/components/schemas/BoxReference"
+            },
+            "type": "array"
+          }
+        },
+        "type": "object"
+      },
       "ScratchChange": {
         "description": "A write operation into a scratch slot.",
         "properties": {
@@ -2306,6 +2339,10 @@
             "description": "If true, signers for transactions that are missing signatures will be fixed during evaluation.",
             "type": "boolean"
           },
+          "populate-resources": {
+            "description": "If true, return populated resource arrays for each transaction based on unnamed resources",
+            "type": "boolean"
+          },
           "round": {
             "description": "If provided, specifies the round preceding the simulation. State changes through this round will be used to run this simulation. Usually only the 4 most recent rounds will be available (controlled by the node config value MaxAcctLookback). If not specified, defaults to the latest available round.",
             "type": "integer"
@@ -2375,6 +2412,13 @@
             "description": "Total budget consumed during execution of app calls in the transaction group.",
             "type": "integer"
           },
+          "extra-resource-arrays": {
+            "description": "Present if populate-resource-arrays is true in the request and additional transactions with the following resources need to be added to the transaction group.",
+            "items": {
+              "$ref": "#/components/schemas/ResourceArrays"
+            },
+            "type": "array"
+          },
           "failed-at": {
             "description": "If present, indicates which transaction in this group caused the failure. This array represents the path to the failing transaction. Indexes are zero based, the first element indicates the top-level transaction, and successive elements indicate deeper inner transactions.",
             "items": {
@@ -2421,6 +2465,9 @@
             "description": "Budget used during execution of a logic sig transaction.",
             "type": "integer"
           },
+          "populated-resource-arrays": {
+            "$ref": "#/components/schemas/ResourceArrays"
+          },
           "txn-result": {
             "$ref": "#/components/schemas/PendingTransactionResponse"
           },