simulate: resource population

daemon/algod/api/algod.oas2.json

@@ -1864,8 +1864,8 @@
       "get": {
         "description": "Get ledger deltas for a round.",
         "tags": [
-            "public",
-            "nonparticipating"
+          "public",
+          "nonparticipating"
         ],
         "produces": [
           "application/json",
@@ -4106,6 +4106,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"
         }
       }
     },
@@ -4357,6 +4361,39 @@
         }
       }
     },
+    "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",
@@ -4392,6 +4429,13 @@
         },
         "unnamed-resources-accessed": {
           "$ref": "#/definitions/SimulateUnnamedResourcesAccessed"
+        },
+        "extra-resource-arrays": {
+          "description": "Present if populate-resource-arrays is true in the request and additional transactions are needed to name all the accessed resources.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ResourceArrays"
+          }
         }
       }
     },
@@ -4419,10 +4463,14 @@
         "unnamed-resources-accessed": {
           "$ref": "#/definitions/SimulateUnnamedResourcesAccessed"
         },
-        "fixed-signer":{
+        "fixed-signer": {
           "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

@@ -2328,6 +2328,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": {
@@ -2384,6 +2417,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"
@@ -2453,6 +2490,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 are needed to name all the accessed resources.",
+            "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": {
@@ -2499,6 +2543,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"
           },