Release Notes

Version 1.4 Zegema

The following improvement will take effect since activation of feature #21 “Cease XTN buy-back”, but not earlier than 100,000 blocks after activation of feature #19 on Mainnet (2000 blocks on Testnet, 1000 blocks on Stagenet):

• The crediting of the block reward share to the XTN buy-back smart contract will cease. Its share will be received by the block generator.

---

The improvements listed below are enabled by feature #20 “Capped XTN buy-back & DAO amounts”.

Protocol Enhancements:

• Block reward distribution is adjusted as follows:

  • If feature #19 is activated and the block reward is greater than 6 WAVES, then Waves DAO and the XTN buy-back smart contract each receive 2 WAVES, and the block generator receives the rest.
  • If feature #19 is activated and the block reward is between 2 and 6 WAVES, then Waves DAO and the XTN buy-back smart contract each receive (R - 2) / 2 WAVES, where R is the block reward (integer division is assumed).
  • If feature #19 is not activated or the block reward is less than 2 WAVES, the block generator receives the entire block reward.

• The period for which the block reward is set is reduced to 50,000 blocks. The block reward voting still takes place in the final 10,000 blocks of that period.

Node REST API:

• Added block reward distribution between addresses to the response of endpoints returning a block or block header.

  Example:

  {
    ...
    "rewardShares": { 
      "3MtmVzUQQj1keBsr3Pq5DYkutZzu5H8wdgA": 200000000, 
      "3Myb6G8DkdBb8YcZzhrky65HrmiNuac3kvS": 100000000, 
      "3N13KQpdY3UU7JkWUBD9kN7t7xuUgeyYMTT": 100000000 
    }
  }
  

---

The improvements listed below are enabled by feature #19 “Block Reward Distribution”.

Protocol Enhancements:

• The block reward is shared between the block generator, Waves DAO, and the XTN buy-back contract. Waves DAO and the XTN buy-back smart contract each receive ⅓ of the total block reward (integer division is assumed), and the block generator receives the rest.

Ride:

• Issued version 7 of the Ride Standard library.
• Added the rewards: List[(Address, Int)] field to the BlockInfo structure which is returned by the blockInfoByHeight built-in function.

Node REST API:

• Added the daoAddress and xtnBuybackAddress fields to the /blockchain/rewards endpoint response.

---

The improvements listed below are enabled by feature #17 “Ride V6, MetaMask support”.

Protocol Enhancements

• Added support for Ethereum-like transactions that perform token transfers or dApp script invocations. Thanks to this, MetaMask users can sign transactions and send them to the Waves blockchain. More details
• Added support for orders with ECDSA signature in Exchange transactions. Thanks to this, users can sign orders with MetaMask. More details
• Added the priceMode parameter of order version 4. The parameter enables price mode similar to order version 3.
• Changed the minimum fee for a Set Script transaction: now the minimum fee depends on the script size.
• Weak public keys can no longer be used to sign transactions.

Ride

• Issued version 6 of the Ride Standard library.

• The maximum complexity of a callable function of a dApp script in Standard library version 6 is changed to 52,000.

• The maximum total complexity of all callable functions and asset scripts within a transaction depends on the version of Standard library in the first dApp script invoked:

  • If the first dApp script uses version 6, the total complexity is limited by 52 000.
  • If the first dApp script uses version 5, the total complexity is limited by 26 000. If script version 6 functions are invoked next, their complexity can exceed 10,000 and is limited only by the total complexity of the transaction.

  The sender's account script complexity is not included in that limit.

• New complexity estimation rules reduce overall script complexity.

• The maximum size of a dApp script is increased to 160 Kbytes regardless of the Standard library version.

• The maximum total number of ScriptTransfer, Lease, LeaseCancel script actions executed by all callable functions in a single transaction is 100.

  The maximum total number of Issue, Reissue, Burn, SponsorFee script actions executed by all callable functions in a single transaction is 30.

• Callable functions no longer accept arguments of type Union.

• Added the following built-in functions:

  • sqrt(Int,Int,Int,Union)
  • sqrt(BigInt,Int,Int,Union)

• Changed the limitation on the second parameter of drop, dropRight, take, takeRight string functions and byte array functions.

• Changed the limitations on input and output data size for the built-in string functions makeString and split; their complexity reduced to 1. Added the range of similar functions with different complexity depending on the data size.

• Changed the complexity of certain built-in functions. The complexity is given in the Built-in functions article.

• Introduced a limit on the total number of payments attached to dApp script invocations in a single transaction: a maximum of 100. The limit does not depend on the Standard library versions used.

Node REST API

• Added CORS settings to the node configuration. The obsolete settings waves.rest-api.cors and waves.rest-api.api-key-different-host are disabled.

Breaking Changes

• Added support for Ethereum-like transactions that perform token transfers or dApp script invocations. JSON representation of a transaction depends on its content:

  Example transfer

  {
    "type": 18,
    "id": "C4Fwdsygb6uL6iZ2dd6dHCdnw5FB2oZNCdpQ1F5kQ7Q9",
    "fee": 210000,
    "feeAssetId": null,
    "timestamp": 1634807137059,
    "version": 1,
    "chainId": 83,
    "bytes": "0xf87486017ca21943238502540be4008303345094ae50afd342b8f397bcd1c2af3fd658d5080674058806f05b59d3b200008081caa0e87f0e273e8ad894ab196198747a0363b66c5bd056f1e09bb6f8b18f6c11dbafa07dd6b2ac30d2d1ac1196a34a8db5adbd8f69b8f349b15f45c6bbf4040de7519d",
    "sender": "3MTPx4QwYZg78QwAw4Pdm3feBpwe9qMzL5X",
    "senderPublicKey": "2ZWaWoMYAdkKfUUYwKng29Dgq1ggBPYtbsrvKBxxKcP3SkpXy1USEJiPPL6U7H7ECD3bD3QcZy2mmtN9EzsK2SHV",
    "height": 1040780,
    "applicationStatus": "succeeded",
    "payload": {
      "type": "transfer",
      "recipient": "3MgUB2QfTH8jMLYwuNrYq2SSUJdGcjvBk6n",
      "asset": null,
      "amount": 50000000
    }
  

  Example script invocation

  {
    "type": 18,
    "id": "2Y67uLthNfzEBpEJFyrP7MKqPYTFYjM5nz2NnETZVUYU",
    "fee": 500000,
    "feeAssetId": null,
    "timestamp": 1634881836984,
    "version": 1,
    "chainId": 83,
    "bytes": "0xf9011186017ca68d17b88502540be4008307a120940ea8e14f313237aac31995f9c19a7e0f78c1cc2b80b8a409abf90e0000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000064672696461790000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000081caa0ecb7124f915bd366186a6451aabdde3fbf0db94caa78a6b8d6115bb5ce6407d8a077ab1e756d343b9927c3c4add5c797915aef2de112576213d6a30ce5e040ba3c",
    "sender": "3MRejoFLZ6FsXRjVEzBpnQ27s61FDLLDGxh",
    "senderPublicKey": "3nFhfAYDSRS4UrU22HaAuFT4YHZD5Et3vy7fBTcTxefuAVXs8pHRR4pvpAzvMbmskwjWB7PxFKqPNsioRVZ9mxaa",
    "height": 1042032,
    "applicationStatus": "succeeded",
    "payload": {
      "type": "invocation",
      "dApp": "3MRuzZVauiiX2DGwNyP8Tv7idDGUy1VG5bJ",
      "call": {
        "function": "saveString",
        "args": [
          {
            "type": "string",
            "value": "Friday"
          }
        ]
      },
      "payment": [],
      "stateChanges": {
        "data": [
          {
            "key": "str_1042032",
            "type": "string",
            "value": "Friday"
          }
        ],
        "transfers": [],
        "issues": [],
        "reissues": [],
        "burns": [],
        "sponsorFees": [],
        "leases": [],
        "leaseCancels": [],
        "invokes": []
      }
    }
  }
  

  Features of the Ethereum-like transaction JSON representation:

  • sender contains Waves address base58 encoded,
  • senderPublicKey is 64 bytes base58 encoded,
  • bytes contains the entire transaction bytes, including the ECDSA signature, HEX encoded.
  • proofs array is missing.

• Added support for Exchange transactions containing an order (or both orders) with an ECDSA signature.

  Example order with ECDSA signature

  .

  "order1": {
     "version": 4,
     "id": "2Wx5ctbaU9GqQYXtEkqsin6drfu6SuADdwAyvuYnwai9",
     "sender": "3FzoJXUesFqzf4nmMYejpUDYmFJvkwEiQG6",
     "senderPublicKey": "5BQPcwDXaZexgonPb8ipDrLRXY3RHn1kFLP9fqp1s6M6xiRhC4LvsAq2HueXCMzkpuXsrLnuBA3SdkJyuhNZXMCd",
     "matcherPublicKey": "9BUoYQYq7K38mkk61q8aMH9kD9fKSVL1Fib7FbH6nUkQ",
     "assetPair": {
        "amountAsset": "5fQPsn8hoaVddFG26cWQ5QFdqxWtUPNaZ9zH2E6LYzFn",
        "priceAsset": null
     },
     "orderType": "buy",
     "amount": 1,
     "price": 100,
     "timestamp": 1,
     "expiration": 123,
     "matcherFee": 100000,
     "signature": "",
     "proofs": [],
     "matcherFeeAssetId": null,
     "eip712Signature": "0xe5ff562bfb0296e95b631365599c87f1c5002597bf56a131f289765275d2580f5344c62999404c37cd858ea037328ac91eca16ad1ce69c345ebb52fde70b66251c"
  }
  

  Features JSON representation of an order with ECDSA signature:

  • sender contains Waves address base58 encoded,
  • senderPublicKey is 64 bytes base58 encoded,
  • eip712Signature contains an ECDSA signature HEX encoded,
  • proofs array is missing.

Version 1.3 Jumeirah

The improvements listed below are enabled by feature #16 “Ride V5, dApp-to-dApp invocations”.

Protocol Enhancements

• dApp-to-dApp invocation. A dApp callable function can invoke a callable function of another dApp, or another callable function of the same dApp, or even itself. All invoked functions are executed within a single Invoke Script transaction. The total complexity is limited. More about dApp-to-dApp invocation
• Amended Invoke Script transaction:
  • Canceled the extra fee of 0.004 WAVES for smart assets in payments and script actions.
  • Transaction can contain up to 10 attached payments.
  • The total complexity for all callable functions and asset scripts involved is limited to 26,000 (the sender's account script complexity is not included in this limit).
  • The maximum complexity of a callable function of a dApp script is changed to 10,000.
• For all types of transactions, canceled the extra fee of 0.004 WAVES for sending a transaction from a smart account or dApp unless the complexity of sender's account script or dApp script verifier function exceeds 200.

Ride

• Issued version 5 of the Ride Standard library.

• Enabled processing up to 10 payments attached to the Invoke Script transaction.

• As of version 5 of the Standard library, when executing a dApp script, the payments attached to the invocation are considered to be already credited to the dApp balance (unlike versions 4 and 3, where payments do not affect the dApp balance until the end of script execution).

• Added the functions for dApp-to-dApp invocation:

  • invoke
  • reentrantInvoke

• Added strict variables that are evaluated before the next expression to ensure executing callable functions and applying their actions in the right order.

• Modified the callable function result by adding a return value.

• Modified the Invocation structure: in case of dApp-to-dApp invocation, the structure contains the address and public key of both the sender of the Invoke Script transaction and the dApp account that invokes the callable function.

• The maximum total number of Issue, Reissue, Burn, SponsorFee, ScriptTransfer, Lease, LeaseCancel script actions executed by all callable functions in a single transaction is 30.

• The maximum total number of BinaryEntry, BooleanEntry, IntegerEntry, StringEntry, DeleteEntry script actions executed by all callable functions in a single transaction is 100.

• Added script actions that the callable function can perform:

  • Lease — leases WAVES.
  • LeaseCancel — cancels a specified lease.

  Using these actions, you can change the amount of the lease, in particular, withdraw a part of the leased funds. If you cancel a lease for a larger amount and create a new lease for a smaller amount with the same recipient in the same script invocation, the recipient's generating balance decreases by the difference. Otherwise, if you send two separate transactions: a Lease Cancel transaction and a Lease transaction, they can be added to a different blocks and therefore generating balance decreases by the amount of the canceled lease immediately and increases by the amount of the new lease after 1000 blocks.

• Added the function calculateLeaseId that calculates ID of the lease formed by the Lease structure.

• Added an arbitrary data type — Any.

• Added the BigInt data type of 64 bytes (512 bits) and functions supporting it:

  • fraction(BigInt, BigInt, BigInt): BigInt
  • fraction(BigInt, BigInt, BigInt, Union): BigInt
  • log(BigInt, Int, BigInt, Int, Int, Union): BigInt
  • max(List[BigInt]): BigInt
  • median(List[BigInt]): BigInt
  • min(List[BigInt]): BigInt
  • pow(BigInt, Int, BigInt, Int, Int, Union): BigInt
  • parseBigInt(String): BigInt|Unit
  • parseBigIntValue(String): BigInt
  • toBigInt(ByteVector): BigInt
  • toBigInt(ByteVector, Int, Int): BigInt
  • toBigInt(Int): BigInt
  • toBytes(BigInt): ByteVector
  • toInt(BigInt): Int
  • toString(BigInt): String

• Added the following built-in functions:

  • isDataStorageUntouched that checks if the data storage of a given account never contained any entries.
  • scriptHash that returns BLAKE2b-256 hash of the script assigned to a given account.
  • fraction(Int, Int, Int, Union): Int that multiplies and divides integers to avoid overflow, applying the specified rounding method.

• Added the following account data storage functions that allow the dApp script to read entries of its own data storage:

  • getBinary(key: String): ByteVector|Unit
  • getBinaryValue(key: String): ByteVector
  • getBoolean(key: String): Boolean|Unit
  • getBooleanValue(key: String): Boolean
  • getInteger(key: String): Int|Unit
  • getIntegerValue(key: String): Int
  • getString(key: String): String|Unit
  • getStringValue(key: String): String

• The maximum complexity of a callable function of a dApp script is changed to 10,000.

Node REST API

Breaking Changes

A lease can be created both as a result of a Lease transaction and as a result of an Invoke Script transaction via a Lease script action. Therefore, the response of the following endpoints has been changed:

• In the response of /transactions/address/{address}/limit/{limit} and /transactions/info/{id} endpoints for a Lease Cancel transaction, the lease structure now contains lease parameters instead of Lease transaction fields.
• /leasing/active/{address} returns an array of structures containing lease parameters instead of array of Lease transactions.

Format

"lease": {
   "id": "7bRbb9DH6V2ztdbmsZhWLdhTPQD14t8W38GjrtW8ug1N",
   "originTransactionId": "7bRbb9DH6V2ztdbmsZhWLdhTPQD14t8W38GjrtW8ug1N",
   "sender": "3MqqqDw65oL423pjsdeAS5vcRyXa9bmruGx",
   "recipient": "3Mz9N7YPfZPWGd4yYaX6H53Gcgrq6ifYiH7",
   "amount": 400000000,
   "height": 1560062,
   "status": "canceled"
}

The originTransactionId field can contain an ID of a Lease Transaction or an Invoke Script transaction.

Semantic Changes

• dApp-to-dApp invocation results are added as the invokes array to the stateChanges structure returned by the following endpoints:

  • /transactions/info/{id}
  • /transactions/address/{address}/limit/{limit}

  Each element of invokes array, in turn, also contains stateChanges.

  Format

  "stateChanges": {
     "data": [
        {
           "key": "test_key_1",
           "type": "integer",
           "value": 14
        },
        {
           "key": "test_key_2",
           "type": "integer",
           "value": 999000000
        }
     ],
     "transfers": [],
     "issues": [],
     "reissues": [],
     "burns": [],
     "sponsorFees": [],
     "leases": [],
     "leaseCancels": [],
     "invokes": [
        {
           "dApp": "3N4o9UGcFTDxcJptFG2yimYpLqLLoD44diX",
           "call": {
              "function": "bar",
              "args": [
                 {
                    "type": "Int",
                    "value": 7
                 }
              ]
           },
           "payments": [
              {
                 "asset": "25FEqEjRkqK6yCkiT7Lz6SAYz7gUFCtxfCChnrVFD5AT",
                 "amount": 1000000
              }
           ],
           "stateChanges": {
              "data": [],
              "transfers": [
                 {
                    "address": "3ND86XoiA9ytxysBCvhkRQez82R3d6wZBzP",
                    "asset": null,
                    "amount": 100000000
                 }
              ],
             "issues": [],
             "reissues": [],
             "burns": [],
             "sponsorFees": [],
             "leases": [],
             "leaseCancels": [],
             "invokes": []
          }
       }
    ]
  }
  

• Results of the Lease and LeaseCancel script actions are added to the stateChanges structure.

  Format

  "stateChanges": {
     "data": [],
     "transfers": [],
     "issues": [],
     "reissues": [],
     "burns": [],
     "sponsorFees": [],
     "leases": [{
        "id": "94PfEzE3yCo1wVrZGubMwqJgNYLHVBxae5psdeZu9c1c",
        "originTransactionId": "Dc5fzXUKVDd22PbJFt2T5RSsNieFCJwwpuWUsGR4YDZs",
        "sender": "3MopBTg99nDNv4gfQf76WnuPrnPq1TppDEp",
        "recipient": "3MT5dAS4Zr2g8MBLSPnbyAM18pf7A2PUuMY",
        "amount": 444444,
        "height": 817572,
        "status": "active"
     }],
     "leaseCancels": [{
        "id": "5NTgkz8rT8RwSSLbBhyE6yev824Ff8NLStzMreGFEpWk",
        "originTransactionId": "Fr8pwXPK81rXRGs9rwpZaQKHPa8irY3GL4bWXUGemvZi",
        "sender": "3MopBTg99nDNv4gfQf76WnuPrnPq1TppDEp",
        "recipient": "3MT5dAS4Zr2g8MBLSPnbyAM18pf7A2PUuMY",
        "amount": 12000000,
        "height": 817540,
        "status": "canceled"
     }],
     "invokes": []
  }
  

• Results of Lease and LeaseCancel script actions are also added to the trace structure returned by the following endpoints:

  • /transactions/broadcast with trace=true input parameter
  • /debug/validate
  Format

  "trace": [
     {
        "id": "3MosFNQAFGskNDnYzRBgMbfod6xXPdG96ME",
        "type": "dApp",
        "vars": [
           {
              "name": "amount",
              "type": "integer",
              "value": 12345
           }
        ],
        "result": {
           "leases": [
              {
                 "id": "F3ZmBbig3gekPu4a8fyrZGiU53MFxtFSWKw5dTyTMvq7",
                 "originTransactionId": "6GLmdBZZeevtbomFYif5ys7Ltf2DuXMGP29bLrSoX9HA",
                 "sender": "3MUAwJP3ThWNrRcxwAB8QHrvo7BEQbRFdu9",
                 "recipient": "3MbwwebM61Y11UFZwkdQ1gXUJjY27ww1r6z",
                 "amount": 200000000,
                 "height": 739442
              },
           ],
           "leaseCancels": [
              {
                 "id": "DH7N1XW7tTNwHBmFsfeArP6hWfzrC4fGcsKPEMfFZpPL",
                 "originTransactionId": "DH7N1XW7tTNwHBmFsfeArP6hWfzrC4fGcsKPEMfFZpPL",
                 "sender": "3MUAwJP3ThWNrRcxwAB8QHrvo7BEQbRFdu9",
                 "recipient": "3MbwwebM61Y11UFZwkdQ1gXUJjY27ww1r6z",
                 "amount": 300000000,
                 "height": 739436
              }
           ]
        }
     }
  ]
  

Improvements

• Added the /leasing/info endpoint that returns lease parameters by lease IDs.

  Format

  [
     {
        "id": "DNZ8tpZt6i9fTRW6b7UmBV9LHNmX4c5EgeTMhcNk3ReB",
        "originTransactionId": "Dc5fzXUKVDd22PbJFt2T5RSsNieFCJwwpuWUsGR4YDZs",
        "sender": "3MgPxT7piLX6u3yqDFNUTPL93b5dhdpuYKH",
        "recipient": "3MT5dAS4Zr2g8MBLSPnbyAM18pf7A2PUuMY",
        "amount": 222222,
        "height": 817572,
        "status": "active",
        "cancelHeight": null,
        "cancelTransactionId": null
     },
     {
        "id": "5NTgkz8rT8RwSSLbBhyE6yev824Ff8NLStzMreGFEpWk",
        "originTransactionId": "Fr8pwXPK81rXRGs9rwpZaQKHPa8irY3GL4bWXUGemvZi",
        "sender": "3MopBTg99nDNv4gfQf76WnuPrnPq1TppDEp",
        "recipient": "3MT5dAS4Zr2g8MBLSPnbyAM18pf7A2PUuMY",
        "amount": 12000000,
        "height": 817540,
        "status": "canceled",
        "cancelHeight": 817572,
        "cancelTransactionId": "Dc5fzXUKVDd22PbJFt2T5RSsNieFCJwwpuWUsGR4YDZs"
     }
  ]
  

  If the blockchain state on the node was not rebuilt after activation of feature #16, the endpoint does not return the leaseCancelTransactionId field for leases that are canceled before activation of feature #16.

• Added the /blocks/heightByTimestamp/{timestamp} endpoint that returns blockchain height at a given timestamp.

Version 1.2 Malibu

The improvements listed below are enabled by feature #15 "Ride V4, VRF, Protobuf, Failed transactions".

Protocol Enhancements

• Improved the mechanism for generating blocks using VRF (Verifiable random function). This improvement allows withstanding stake grinding attacks, which are used by the attackers to try to increase the probability of generating a block.
• Implemented saving failed transactions. Invoke script transactions and exchange transactions are saved on the blockchain and a fee is charged for them even if the dApp script or the asset script failed, provided that the sender's signature or account script verification passed and the complexity of computations performed during script invocation exceeded the threshold for saving failed transactions. More details
• Implemented the feature of changing the asset name and description. For this means, the Update Asset Info transaction is used. Change is possible after 10 or more blocks on Stagenet and after 100,000 or more blocks on Mainnet and Testnet.
• Implemented the feature of deletion of entries from the account data storage. This action can be performed by the data transaction or DeleteEntry structure of the Ride language.
• Reduced the minimum fee from 1 to 0.001 WAVES for the reissue transaction and sponsor fee transaction.
• Implemented transaction binary formats based on protobuf.
• Issue transaction's name and description fields type changed from bytes to string.
• The maximum data size in data transaction increased to 165,890 bytes.
• Exchange transaction may contain buy and sell orders in any order.
• Changed the orders' price calculation formula. Earlier, when determining the price for assets with different numbers of decimal places, there was a price value size issue. The maximum value depended on the difference of decimal digits of assets. For example, the price for an NFT asset could not exceed 1000 WAVES. The modified formula corrects this problem. Decimal places no longer affect the maximum price.
• The minimum interval between blocks is increased from 5 to 15 seconds. Average block time is targeted 60 seconds instead of ~59 seconds.
• Changed the scheme for signing the block transactions by the generating node. Previously, the generating node needed to sign the block header along with all transactions. For now, the transactions root hash is added to the header, so it is enough to sign only the header.
• The BLAKE2b-256 hash of the block header is used as the block unique identifier.
• When a transaction is validated before adding to the UTX pool, the blockchain state changes made by the transactions that were previously added to the block but then returned to the UTX pool due to the appearance of a new key block that refers to one of the previous microblocks, are taken into account.
• dApp can't call itself with Invoke Script transaction with attached payments. Also dApp can't transfer funds to itself by ScriptTransfer script action.

REST API Updates

In the Node 1.2 release, we have some semantic and breaking changes in the API. Please read the following changes very attentively as it can affect your working application when migrating from Node 1.1 API to the Node 1.2 API.

Semantic Changes

• Invoke script transactions and exchange transaction can be failed, so their presence on the blockchain does not mean they are successful. Check the new field applicationStatus which is added to the output of the following endpoints:

  • /blocks/{id}
  • /blocks/address/{address}/{from}/{to}
  • /blocks/at/{height}
  • /blocks/last
  • /blocks/seq/{from}/{to}
  • /debug/stateChanges/address/{address}/limit/{limit}
  • /debug/stateChanges/info/{id}
  • /transactions/address/{address}/limit/{limit}
  • /transactions/info/{id}
  • /transactions/status

  applicationStatus values:

  • succeeded — the transaction is successful
  • script_execution_failed — the dApp script or the asset script failed.

• For failed invoke script transactions, the reason of failure is indicated in the error structure in the following endpoints:

  • /debug/stateChanges/address/{address}/limit/{limit}
  • /debug/stateChanges/info/{id}

  Format:

  "stateChanges": {
     "error": { "code": number, "text": string }
  }
  

  Error codes are as follows:

  1: dApp script error

  2: insufficient fee for script actions

  3: asset script in dApp script actions denied the transaction

  4: asset script in attached payments denied the transaction

• For invoke script transactions, the results of new script actions are represented in the stateChanges structure in the following endpoints:

  • /debug/stateChanges/address/{address}/limit/{limit}
  • /debug/stateChanges/info/{id}

  Format:

  "stateChanges": {
     "data": [],
     "transfers": [],
     "issues": [],
     "reissues": [],
     "burns": [],
     "sponsorFees": []
  }
  

• For block version 5, the reference field corresponds to id of the previous block instead of signature for block version 4.

Breaking Changes

• Retrieve blocks by id instead of signature.

  Deleted endpoints:

  • /blocks/signature/{signature} — use /blocks/{id} instead
  • /blocks/child/{signature}

  Affected endpoints:

  • /blocks/delay/{id}/{blockNum}
  • /blocks/height/{id}
  • /debug/rollback-to/{id}

• Deleted the /consensus/generationsignature endpoint.

• Changed the meta structure format in the /addresses/scriptInfo/{address}/meta endpoint. The argument list is represented as an object array, not the map.

  Before:

  "meta": {
     "callableFuncTypes": {
        "funcName": { 
           "arg1": string,
           "arg2": string
        }
     }
  }
  

  Now:

  "meta": {
     "callableFuncTypes": {
        "funcName": [ 
           { "name": string, "type": string },
           { "name": string, "type": string }
        ]
     }
  }
  

• Added the new transaction type: Update Asset Info.

• Invoke script transaction now can have arguments of List type.

  Example:

  { "call": { "function": string, "args": [ ["arg1-item1", "arg1-item2", "arg1-item3"] ] } }
  

• Account data storage entries can be deleted by data transactions and invoke script transactions. Entry deletion is represented as follows: { "key": string, "value": null }, value is null, no type field. Can be found in:

  • /blocks/{id}
  • /blocks/address/{address}/{from}/{to}
  • /blocks/at/{height}
  • /blocks/last
  • /blocks/seq/{from}/{to}
  • /debug/stateChanges/address/{address}/limit/{limit}
  • /debug/stateChanges/info/{id}
  • /transactions/address/{address}/limit/{limit}
  • /transactions/info/{id}

• Exchange transaction version 3 can include buy and sell orders in any order: buy/sell or sell/buy.

Improvements

• /debug/validate endpoint does not require API-key.

• /assets/details endpoint can provide multiple assets info at once. The originTransactionId field containing the ID of the transaction that issued the asset is added to the response. Also, the endpoint supports POST requests.

• /addresses/balance endpoint can provide balances for several addresses for specific height not more than 2000 from current.

• /assets/nft/{address}/limit/{limit} endpoint returns the assetDetails array containing the list of NFTs belonging to the address. Also, the endpoint supports POST requests.

• Complexity of each annotated function is returned by the following endpoints:

  • /addresses/scriptInfo/{address}
  • /utils/script/compileCode
  • /utils/script/estimate

  Format:

  {
     "complexity": number,
     "callableComplexities": { "funcName1": number, "funcName2": number },
     "verifierComplexity": number
  }
  

• Added the /transactions/merkleProof endpoint that accepts the transaction ID or the array of transactions IDs and returns the array of proofs for checking that the transaction is in a block.

• Added the id and transactionsRoot fields to the following endpoints:

  • /blocks/{id}
  • /blocks/headers/last
  • /blocks/headers/seq/{from}/{to}
  • /blocks/headers/at/{height}
  • /blocks/at/{height}
  • /blocks/address/{address}/{from}/{to}
  • /blocks/last
  • /blocks/seq/{from}/{to}

Ride Improvements

• Issued version 4 of the Ride Standard library.
• Added script actions that the callable function of dApp can perform:
  • Issue
  • Reissue
  • Burn
  • SponsorFee
  • BooleanEntry, BinaryEntry, IntegerEntry, StringEntry that add or update the account data storage entries of the corresponding type. These actions replace DataEntry that is not supported in version 4.
  • DeleteEntry that deletes the account data storage entry.
• The callable function result format is modified. Since version 4 the result is the list of script actions. The ScriptResult, WriteSet and TransferSet structures are not supported.
• Invoke script transaction's fee increased by 1 WAVES for each non-NFT asset issued by the transaction's Issue structure.
• Enabled processing up to two payments attached to the invoke script transaction.
• Added support of list of primitives as a callable function argument.
• Added the following built-in functions:
  • bn256Groth16Verify range of functions that verify the zero-knowledge proof zk-SNARK by groth16 protocol on the bn254 curve. Complexity is 800–1650 depending on the argument size limit.
  • calculateAssetId that calculates ID of asset generated by the Issue structure when executing a dApp script. Complexity is 10.
  • contains that checks whether the second argument (substring) is contained in the first string argument. Complexity is 3.
  • containsElement that checks if the element is in the list. Complexity is 5.
  • createMerkleRoot that calculates transactions root hash. Complexity is 30.
  • ecrecover that recovers public key from the message hash and the ECDSA digital signature. Complexity is 70.
  • makeString that concatenates list strings adding a separator. Complexity is 30.
  • groth16Verify range of functions that verify the zero-knowledge proof zk-SNARK by groth16 protocol on the bls12-381 curve. Complexity is 1200–2700 depending on the argument size limit.
  • indexOf that returns the index of the first occurrence of the element in the list. Complexity is 5.
  • lastIndexOf that returns the index of the last occurrence of the element in the list. Complexity is 5.
  • max that returns the largest element in the list. Complexity is 3.
  • median that calculates a median of the list of integers. Complexity is 20.
  • min that returns the smallest element in the list. Complexity is 3.
  • removeByIndex that removes an element from the list by index. Complexity is 7.
  • transferTransactionFromProto that deserializes a transfer transaction. Complexity is 5.
  • valueOrElse(t: T|Unit, t0 : T) that returns a value from the union type if it's not unit. Complexity is 2.
• The wavesBalance built-in function returns the BalanceDetails structure that contains all types of WAVES balances.
• Added name and description fields to the Asset structure which is returned by the assetInfo built-in function.
• For the built-in hashing functions blakeb256, keccak256, sha256 and the built-in verification functions rsaVerify, sigVerify the complexity is changed in version 4 along with adding the range of similar functions with different complexity depending on the argument size limit. When data size is known in advance, the “cheaper” function can be used.
• Changed the complexity of certain built-in functions and operators. Changes are listed in the Built-in Functions article.
• The following features are no longer supported in version 4:
  • extract — use value instead;
  • checkMerkleProof — use createMerkleRoot instead.
• Added the following list operators:
  • ++ for the concatenation of lists. Example: the result of [1, 2] ++ [3, 4] is [1, 2, 3, 4]. Complexity is 4.
  • :+ for adding an element to the end of the list. Example: the result of ["foo","bar"] :+ "baz" is ["foo", "bar", "baz"]. Complexity is 1.
• Added the Tuple data type.
• The maximum complexity of an account script and verifier function of dApp script is changed to 2000 for new scripts, regardless of the Standard library version. The maximum complexity of an asset script and callable function of dApp script remains 4000.
• The maximum data size is changed:
  • String: 32,767 bytes
  • ByteVector: 32,767 bytes (except the bodyBytes field of the transaction structure)

Waves Explorer

• Failed transactions are now displayed. They are marked with icon in lists of transactions.
• Added support of two payments for invoke script transactions. The dApp script result is displayed as a table.
• Added display of the new transaction type: update asset info transaction.
• Added the link to the issue transaction on the asset information page.
• Added Block ID field to the block information page.