ARK v2.5 is a minor update and backward compatible with v2.5.X. This update removes the legacy public API that was ported from ark-node.

  • Upgrade time: low - upgrading to v2.5 requires no changes.
  • Complexity: low - only legacy code was removed and numerical format issues resolved.
  • Risk: medium - applications that relied on the legacy API will stop working. An announcement was made that the legacy public API will be removed last year so the risk of this should be low.

Migrating from v2.4 to v2.5

Upgrading from v2.4 to v2.5 is fairly straightforward if you follow the instructions. Even though we try to ensure backward compatibility (BC) as much as possible, sometimes it is not possible or very complicated to avoid it and still create a good solution to a problem.


Upgrading a complex software project always comes at the risk of breaking something, so make sure you have a backup.


After upgrading you should check whether your application still works as expected and no plugins are broken. See the following notes on which changes to consider when upgrading from one version to another.

Upgrade Steps


Do not run any of the mentioned commands with sudo unless explicitly stated.

To update to v2.5 run the following command:

This section addresses developers and lists notable changes during this version upgrade. For more details make sure you checkout the CHANGELOG document. The following breaking changes where introduced in v2.5:

1. BigInt values returned as string via Public API

All v2 API endpoints now return BigInt values as string to avoid rounding issues for chains that use very large supplies. This should only affect developers that haven’t properly handled BigInt values already, meaning you treated BigInt values as numbers instead of casting them after receiving them.

Reporting Problems

If you happen to experience any issues please open an issue with a detailed description of the problem, steps to reproduce it and info about your environment.

Last updated 2 years ago
Edit Page