Klever Blockchain v1.7.14 – Node API Updates πŸ”§

Dear @Validators and Developers,

As part of the upcoming Klever Blockchain Mainnet Upgrade (v.1.7.14), we’re introducing a series of API enhancements designed to improve integration, monitoring, and interaction with the Klever Blockchain node.

These changes are especially relevant for validators, integrators, and developers using node APIs for automation, monitoring, or smart contract operations. Please review the updates below and adjust your tools accordingly before upgrading your infrastructure.


:new_button: New Endpoints

Empowering better visibility, simulation, and smart contract interaction.

  • /:address/kda β†’ Returns detailed KDA info.

  • /simulate β†’ Simulate a smart contract transaction before broadcasting.

  • /estimate-fee β†’ Estimate the transaction fee dynamically.

  • /heartbeatstatus β†’ Display live information from connected nodes.

  • /vm/hex β†’ Query smart contracts returning results in hex format.

  • /vm/string β†’ Query smart contracts returning string results.

  • /vm/int β†’ Query smart contracts returning integer results.

  • /vm/query β†’ Query smart contracts returning raw results.


:gear: Changes to Existing Endpoints

/set-redundancy

  • Authentication is now mandatory.
    β†’ Ensure your scripts and tools include valid authentication headers.

/node/statistics

  • Simplified response structure for cleaner and more consistent metrics output:

    {
      "liveTPS": 10.5,
      "averageTPS": "15",
      "peakTPS": 50.2,
      "blockNumber": 1000,
      "slotNumber": 1000,
      "slotTime": 4,
      "averageBlockTxCount": "100",
      "totalProcessedTxCount": "1000000",
      "currentBlockTxCount": 50
    }
    
    

/transaction/send

  • Added support for extended transaction and asset operations:

    • klvRoyalties β†’ now supported in transfer operations.

    • adminAddress β†’ added for createAsset operations.

    • limitTransfer β†’ added for createAsset operations.

    • hasRoleDeposit and hasRoleTransfer β†’ supported in asset trigger operations.

    • value β†’ now usable within asset trigger operations.


:puzzle_piece: Action Required
If your validator or node setup, monitoring tools, or integration scripts depend on these endpoints, make sure to update and test them prior to activation of version v.1.7.14 on epoch 4860.

This update brings a more standardized, efficient, and developer-friendly API layer to the Klever ecosystem, paving the way for deeper integrations and improved node operations.

Together, we keep the network Klever, secure, and powerful. :purple_heart:


You can get more details for each endpoint at Swagger UI

3 Likes

What should be returned for /:address/kda ?

Is this query only valid after activation, or is it already valid now?

Hello mate,

You can expect this structure on return for /:address/kda

{
  "code": "successful",
  "data": {
    "address": "string",
    "asset": "string",
    "userKDA": {
      "Balance": 0,
      "Buckets": {
        "additionalProp1": {
          "Delegation": [
            0
          ],
          "StakedAt": 0,
          "StakedEpoch": 0,
          "UnstakedEpoch": 0,
          "Value": 0
        },
        "additionalProp2": {
          "Delegation": [
            0
          ],
          "StakedAt": 0,
          "StakedEpoch": 0,
          "UnstakedEpoch": 0,
          "Value": 0
        },
        "additionalProp3": {
          "Delegation": [
            0
          ],
          "StakedAt": 0,
          "StakedEpoch": 0,
          "UnstakedEpoch": 0,
          "Value": 0
        }
      },
      "FrozenBalance": 0,
      "LastClaim": {
        "Epoch": 0,
        "Timestamp": 0
      },
      "MIME": [
        0
      ],
      "Metadata": [
        0
      ]
    }
  },
  "error": "string"
}

You can get more details at Swagger UI

And yes, the most of these endpoint will be valid after activation.

Thank you for your feedback. Based on the structure you posted and my tests, I can see that it only works for one asset. I will wait until October 28 and see if there are any changes.

1 Like