---
title: "Evaluate"
method: POST
path: "/utils/script/evaluate/{address}"
tags: ["utils"]
---

# Evaluate

`POST /utils/script/evaluate/{address}`

Evaluates the provided expression, taking into account the deployed dApp contract

## Path parameters

- `address` string, required

## Query parameters

- `trace` boolean

## Request body

- union
  - RideExprRequest
    - `expr` string — Ride expression
    - `state` BlockchainOverrides
      - `accounts` object — Key is Address
  - RideInvocationRequest
    - `call` object
      - `function` string, nullable
      - `args` RideFunctionCallArg[], nullable
        - union
          - object
            - `type` 'integer'
            - `value` integer
          - object
            - `type` 'boolean'
            - `value` boolean
          - object
            - `type` 'string'
            - `value` string
          - object
            - `type` 'binary'
            - `value` string — Evaluated Ride expression either as a Ride code, or as compiled in base64 representation
          - object
            - `type` 'list'
            - `value` RideFunctionCallArg[]
    - `id` string, nullable
    - `fee` number, nullable
    - `feeAssetId` string, nullable
    - `sender` string, nullable
    - `senderPublicKey` string, nullable
    - `payment` object[]
      - `amount` integer
      - `assetId` string
    - `state` BlockchainOverrides
      - `accounts` object — Key is Address

## Response `200`

successful operation

- object
  - `address` string
  - `expr` string
  - `result` object
    - `type` string
    - `value` unknown
  - `complexity` integer
  - `stateChanges` StateChanges
    - `data` DataAction[], required
      - union
        - union
          - BinaryEntry
            - `key` string, required
            - `type` 'binary', required
            - `value` string, byte, required
          - BooleanEntry
            - `key` string, required
            - `type` 'boolean', required
            - `value` boolean, required
          - IntegerEntry
            - `key` string, required
            - `type` 'integer', required
            - `value` integer, required
          - StringEntry
            - `key` string, required
            - `type` 'string', required
            - `value` string, required
        - DeleteEntry
          - `key` string, required
          - `value` unknown, required
    - `transfers` TransferAction[], required
      - `address` string, required
      - `asset` string
      - `amount` integer, required
    - `issues` IssueAction[], required
      - `assetId` string, required
      - `name` string, required
      - `description` string, required
      - `quantity` integer, required — Total supply of the asset
      - `decimals` integer, required
      - `isReissuable` boolean, required
      - `compiledScript` string, required
    - `reissues` ReissueAction[], required
      - `assetId` string, required
      - `isReissuable` boolean, required
      - `quantity` integer, required
    - `burns` BurnAction[], required
      - `assetId` string, required
      - `quantity` integer, required
    - `sponsorFees` SponsorFeeAction[], required
      - `assetId` string, required
      - `minSponsoredAssetFee` integer, required
    - `leases` LeaseAction[], required
      - `id` string, required
      - `originTransactionId` string, required
      - `sender` string, required
      - `recipient` string, required
      - `amount` integer, required
      - `height` integer, required
      - `status` 'active' | 'canceled', required — * `active`: lease is active; * `canceled`: lease has been canceled
      - `cancelHeight` integer
      - `cancelTransactionId` string
    - `leaseCancel` LeaseCancelAction[], required
    - `invokes` InvokeAction[], required
      - `error` object
      - `stateChanges` StateChanges, required — recursive
  - `vars` object[]
    - `name` string
    - `type` string
    - `value` unknown
    - `error` string

## Other responses

- `400` — Conflicting request structure

## Changes

> 36 revisions in range; 1 could not be searched.

- **2026-03-31** `d9769537f2c3` — 9 breaking, 1 warning, 3 info
  - the request property `oneOf[#/components/schemas/RideInvocationRequest]/call/args` became not nullable
  - the request property `oneOf[#/components/schemas/RideInvocationRequest]/call/function` became not nullable
  - the request property `oneOf[#/components/schemas/RideInvocationRequest]/fee` became not nullable
  - the request property `oneOf[#/components/schemas/RideInvocationRequest]/feeAssetId` became not nullable
  - …9 more
- **2023-10-13** `6d61389e0fa7` — 1 breaking, 7 warning, 2 info
  - the request's body type/format changed from `object`/`` to ``/``
  - removed the request property `expr`
  - removed the request property `fee`
  - removed the request property `feeAssetId`
  - …6 more
- **2023-08-07** `7625bbb16b0e` — 2 breaking, 7 info
  - removed `#/components/schemas/RideExprRequest, #/components/schemas/RideInvocationRequest` from the request body `oneOf` list
  - the request's body type/format changed from ``/`` to `object`/``
  - added the new optional request property `expr`
  - added the new optional request property `fee`
  - …5 more
- **2023-07-05** `de17749baa1c` — 1 breaking, 7 warning, 1 info
  - the request's body type/format changed from `object`/`` to ``/``
  - removed the request property `expr`
  - removed the request property `fee`
  - removed the request property `feeAssetId`
  - …5 more
- …earlier changes not shown

[Full history](https://skmtc.dev/wavesplatform/apis/waves-full-node-chainid/changes/utils/script/evaluate/:address/post.md)

---

[API](https://skmtc.dev/wavesplatform/apis/waves-full-node-chainid.md) · [All operations](https://skmtc.dev/wavesplatform/apis/waves-full-node-chainid/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wavesplatform/waves-full-node-chainid/revisions/09465bcdf6ce/schema)