Dryrun

Provide debugging information for a transaction (or group).

post

Executes TEAL program(s) in context and returns debugging information about the execution. This endpoint is only enabled when a node's configuration file sets EnableDeveloperAPI to true.

Authorizations

Body

application/jsonapplication/msgpack

Request data type for dryrun endpoint. Given the Transactions and simulated ledger state upload, run TEAL scripts and return debugging information.

latest-timestampinteger · int64Required

LatestTimestamp is available to some TEAL scripts. Defaults to the latest confirmed timestamp this algod is attached to.

protocol-versionstringRequired

ProtocolVersion specifies a specific version string to operate under, otherwise whatever the current protocol of the network this algod is running in.

roundintegerRequired

Round is available to some TEAL scripts. Defaults to the current round on the network this algod is attached to.

txnsstring · json[]Required

SignedTxn object. Must be canonically encoded.

Responses

200

DryrunResponse contains per-txn debug information from a dryrun.

application/json

400

Bad Request

application/json

401

Invalid API Token

application/json

404

Developer API not enabled

500

Internal Error

application/json

default

Unknown Error

post

HTTPcURLJavaScriptPython

POST /v2/teal/dryrun HTTP/1.1
Host: algo.nownodes.io
X-Algo-API-Token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 1918

{
  "accounts": [
    {
      "address": "text",
      "amount": 1,
      "amount-without-pending-rewards": 1,
      "apps-local-state": [
        {
          "id": 1,
          "key-value": [
            {
              "key": "text",
              "value": {
                "bytes": "text",
                "type": 1,
                "uint": 1
              }
            }
          ],
          "schema": {
            "num-byte-slice": 1,
            "num-uint": 1
          }
        }
      ],
      "apps-total-extra-pages": 1,
      "apps-total-schema": {
        "num-byte-slice": 1,
        "num-uint": 1
      },
      "assets": [
        {
          "amount": 1,
          "asset-id": 1,
          "is-frozen": true
        }
      ],
      "auth-addr": "text",
      "created-apps": [
        {
          "id": 1,
          "params": {
            "approval-program": "Ynl0ZXM=",
            "clear-state-program": "Ynl0ZXM=",
            "creator": "text",
            "extra-program-pages": 1,
            "global-state": [
              {
                "key": "text",
                "value": {
                  "bytes": "text",
                  "type": 1,
                  "uint": 1
                }
              }
            ],
            "global-state-schema": {
              "num-byte-slice": 1,
              "num-uint": 1
            },
            "local-state-schema": {
              "num-byte-slice": 1,
              "num-uint": 1
            }
          }
        }
      ],
      "created-assets": [
        {
          "index": 1,
          "params": {
            "clawback": "text",
            "creator": "text",
            "decimals": 1,
            "default-frozen": true,
            "freeze": "text",
            "manager": "text",
            "metadata-hash": "Ynl0ZXM=",
            "name": "text",
            "name-b64": "Ynl0ZXM=",
            "reserve": "text",
            "total": 1,
            "unit-name": "text",
            "unit-name-b64": "Ynl0ZXM=",
            "url": "text",
            "url-b64": "Ynl0ZXM="
          }
        }
      ],
      "min-balance": 1,
      "participation": {
        "selection-participation-key": "Ynl0ZXM=",
        "state-proof-key": "Ynl0ZXM=",
        "vote-first-valid": 1,
        "vote-key-dilution": 1,
        "vote-last-valid": 1,
        "vote-participation-key": "Ynl0ZXM="
      },
      "pending-rewards": 1,
      "reward-base": 1,
      "rewards": 1,
      "round": 1,
      "sig-type": "sig",
      "status": "text",
      "total-apps-opted-in": 1,
      "total-assets-opted-in": 1,
      "total-box-bytes": 1,
      "total-boxes": 1,
      "total-created-apps": 1,
      "total-created-assets": 1
    }
  ],
  "apps": [
    {
      "id": 1,
      "params": {
        "approval-program": "Ynl0ZXM=",
        "clear-state-program": "Ynl0ZXM=",
        "creator": "text",
        "extra-program-pages": 1,
        "global-state": [
          {
            "key": "text",
            "value": {
              "bytes": "text",
              "type": 1,
              "uint": 1
            }
          }
        ],
        "global-state-schema": {
          "num-byte-slice": 1,
          "num-uint": 1
        },
        "local-state-schema": {
          "num-byte-slice": 1,
          "num-uint": 1
        }
      }
    }
  ],
  "latest-timestamp": 1,
  "protocol-version": "text",
  "round": 1,
  "sources": [
    {
      "app-index": 1,
      "field-name": "text",
      "source": "text",
      "txn-index": 1
    }
  ],
  "txns": [
    "text"
  ]
}

application/jsonapplication/msgpack

{
  "error": "text",
  "protocol-version": "text",
  "txns": [
    {
      "app-call-messages": [
        "text"
      ],
      "app-call-trace": [
        {
          "error": "text",
          "line": 1,
          "pc": 1,
          "scratch": [
            {
              "bytes": "text",
              "type": 1,
              "uint": 1
            }
          ],
          "stack": [
            {
              "bytes": "text",
              "type": 1,
              "uint": 1
            }
          ]
        }
      ],
      "budget-added": 1,
      "budget-consumed": 1,
      "disassembly": [
        "text"
      ],
      "global-delta": [
        {
          "key": "text",
          "value": {
            "action": 1,
            "bytes": "text",
            "uint": 1
          }
        }
      ],
      "local-deltas": [
        {
          "address": "text",
          "delta": [
            {
              "key": "text",
              "value": {
                "action": 1,
                "bytes": "text",
                "uint": 1
              }
            }
          ]
        }
      ],
      "logic-sig-disassembly": [
        "text"
      ],
      "logic-sig-messages": [
        "text"
      ],
      "logic-sig-trace": [
        {
          "error": "text",
          "line": 1,
          "pc": 1,
          "scratch": [
            {
              "bytes": "text",
              "type": 1,
              "uint": 1
            }
          ],
          "stack": [
            {
              "bytes": "text",
              "type": 1,
              "uint": 1
            }
          ]
        }
      ],
      "logs": [
        "Ynl0ZXM="
      ]
    }
  ]
}