API Data Quality Issue - Missing Required Field in listBlockchains Response

[thibogue]

Hello Fireblocks Support Team,

We are experiencing a deserialization error when calling the listBlockchains API endpoint using the official Fireblocks Java SDK (version 12.1.3). The error occurs because one of the blockchain objects in the response is missing the required signingAlgo field.

API Endpoint:
Method: GET /v1/supported_assets
Documentation: https://developers.fireblocks.com/reference/list-supported-assets
SDK Method: fireblocks.blockchainsAssets().listBlockchains()
Environment:
Fireblocks SDK Version: 12.1.3 (Java)
API Base URL: https://sandbox-api.fireblocks.io/v1
Environment: Sandbox

Error Details:
❌ FAILED: Exception when calling BlockchainsAssetsApi#listBlockchains
Status code: 0
Response headers: null
Reason: null

java.util.concurrent.ExecutionException: com.fireblocks.sdk.ApiException: com.fasterxml.jackson.databind.exc.MismatchedInputException: Missing required creator property 'signingAlgo' (index 2)
at [Source: REDACTED (StreamReadFeature.INCLUDE_SOURCE_IN_LOCATION disabled); line: 1, column: 10273] (through reference chain: com.fireblocks.sdk.model.ListBlockchainsResponse["data"]->java.util.ArrayList[19]->com.fireblocks.sdk.model.BlockchainResponse["onchain"]->com.fireblocks.sdk.model.BlockchainOnchain["signingAlgo"])
at java.base/java.util.concurrent.CompletableFuture.reportGet(CompletableFuture.java:396)
at java.base/java.util.concurrent.CompletableFuture.get(CompletableFuture.java:2073)
at service.payment.gateway.fireblocks.clients.FireblocksListBlockchainsTest.main(FireblocksListBlockchainsTest.java:43)
Caused by: com.fireblocks.sdk.ApiException: com.fasterxml.jackson.databind.exc.MismatchedInputException: Missing required creator property 'signingAlgo' (index 2)
at [Source: REDACTED (StreamReadFeature.INCLUDE_SOURCE_IN_LOCATION disabled); line: 1, column: 10273] (through reference chain: com.fireblocks.sdk.model.ListBlockchainsResponse["data"]->java.util.ArrayList[19]->com.fireblocks.sdk.model.BlockchainResponse["onchain"]->com.fireblocks.sdk.model.BlockchainOnchain["signingAlgo"])
at com.fireblocks.sdk.api.BlockchainsAssetsApi.lambda$listBlockchains$5(BlockchainsAssetsApi.java:479)
at java.base/java.util.concurrent.CompletableFuture$UniCompose.tryFire(CompletableFuture.java:1150)
at java.base/java.util.concurrent.CompletableFuture$Completion.exec(CompletableFuture.java:483)
at java.base/java.util.concurrent.ForkJoinTask.doExec(ForkJoinTask.java:387)
at java.base/java.util.concurrent.ForkJoinPool$WorkQueue.topLevelExec(ForkJoinPool.java:1312)
at java.base/java.util.concurrent.ForkJoinPool.scan(ForkJoinPool.java:1843)
at java.base/java.util.concurrent.ForkJoinPool.runWorker(ForkJoinPool.java:1808)
at java.base/java.util.concurrent.ForkJoinWorkerThread.run(ForkJoinWorkerThread.java:188)
Caused by: com.fasterxml.jackson.databind.exc.MismatchedInputException: Missing required creator property 'signingAlgo' (index 2)
at [Source: REDACTED (StreamReadFeature.INCLUDE_SOURCE_IN_LOCATION disabled); line: 1, column: 10273] (through reference chain: com.fireblocks.sdk.model.ListBlockchainsResponse["data"]->java.util.ArrayList[19]->com.fireblocks.sdk.model.BlockchainResponse["onchain"]->com.fireblocks.sdk.model.BlockchainOnchain["signingAlgo"])
at com.fasterxml.jackson.databind.exc.MismatchedInputException.from(MismatchedInputException.java:59)
at com.fasterxml.jackson.databind.DeserializationContext.reportInputMismatch(DeserializationContext.java:1781)
at com.fasterxml.jackson.databind.deser.impl.PropertyValueBuffer._findMissing(PropertyValueBuffer.java:192)
at com.fasterxml.jackson.databind.deser.impl.PropertyValueBuffer.getParameters(PropertyValueBuffer.java:158)
at com.fasterxml.jackson.databind.deser.ValueInstantiator.createFromObjectWith(ValueInstantiator.java:301)
at com.fasterxml.jackson.databind.deser.impl.PropertyBasedCreator.build(PropertyBasedCreator.java:202)
at com.fasterxml.jackson.databind.deser.BeanDeserializer._deserializeUsingPropertyBased(BeanDeserializer.java:526)
at com.fasterxml.jackson.databind.deser.BeanDeserializerBase.deserializeFromObjectUsingNonDefault(BeanDeserializerBase.java:1493)
at com.fasterxml.jackson.databind.deser.BeanDeserializer.deserializeFromObject(BeanDeserializer.java:348)
at com.fasterxml.jackson.databind.deser.BeanDeserializer.deserialize(BeanDeserializer.java:185)
at com.fasterxml.jackson.databind.deser.SettableBeanProperty.deserialize(SettableBeanProperty.java:545)
at com.fasterxml.jackson.databind.deser.BeanDeserializer._deserializeWithErrorWrapping(BeanDeserializer.java:570)
at com.fasterxml.jackson.databind.deser.BeanDeserializer._deserializeUsingPropertyBased(BeanDeserializer.java:440)
at com.fasterxml.jackson.databind.deser.BeanDeserializerBase.deserializeFromObjectUsingNonDefault(BeanDeserializerBase.java:1493)
at com.fasterxml.jackson.databind.deser.BeanDeserializer.deserializeFromObject(BeanDeserializer.java:348)
at com.fasterxml.jackson.databind.deser.BeanDeserializer.deserialize(BeanDeserializer.java:185)
at com.fasterxml.jackson.databind.deser.std.CollectionDeserializer._deserializeFromArray(CollectionDeserializer.java:359)
at com.fasterxml.jackson.databind.deser.std.CollectionDeserializer.deserialize(CollectionDeserializer.java:244)
at com.fasterxml.jackson.databind.deser.std.CollectionDeserializer.deserialize(CollectionDeserializer.java:28)
at com.fasterxml.jackson.databind.deser.SettableBeanProperty.deserialize(SettableBeanProperty.java:545)
at com.fasterxml.jackson.databind.deser.BeanDeserializer._deserializeWithErrorWrapping(BeanDeserializer.java:570)
at com.fasterxml.jackson.databind.deser.BeanDeserializer._deserializeUsingPropertyBased(BeanDeserializer.java:440)
at com.fasterxml.jackson.databind.deser.BeanDeserializerBase.deserializeFromObjectUsingNonDefault(BeanDeserializerBase.java:1493)
at com.fasterxml.jackson.databind.deser.BeanDeserializer.deserializeFromObject(BeanDeserializer.java:348)
at com.fasterxml.jackson.databind.deser.BeanDeserializer.deserialize(BeanDeserializer.java:185)
at com.fasterxml.jackson.databind.deser.DefaultDeserializationContext.readRootValue(DefaultDeserializationContext.java:342)
at com.fasterxml.jackson.databind.ObjectMapper._readMapAndClose(ObjectMapper.java:4899)
at com.fasterxml.jackson.databind.ObjectMapper.readValue(ObjectMapper.java:3846)
at com.fasterxml.jackson.databind.ObjectMapper.readValue(ObjectMapper.java:3829)
at com.fireblocks.sdk.api.BlockchainsAssetsApi.lambda$listBlockchains$5(BlockchainsAssetsApi.java:474)
... 7 more

Problem Description:
The error indicates that the blockchain object at index 19 in the response array is missing the required signingAlgo field in its onchain property. According to the SDK's model definition (BlockchainOnchain), this field is marked as required, but it's not present in the API response.

I also tested your code documented here and I have the same issue.
https://developers.fireblocks.com/reference/list-supported-assets

Please let me know if you have a solution or when you will fix it.
Best,
Thibault

[github-actions]

Your issue is important to us. We will look into it shortly.

[thibogue]

I also wanted to update to the last version to check if this solved the issue but on your documentation there is an issue.
There is no version.
https://developers.fireblocks.com/reference/java-sdk

[LianSetter]

Thanks for reporting this with all the details.
We’ve confirmed that signingAlgo is defined as required in the OpenAPI spec but is missing in at least one /v1/supported_assets response, which is causing the Java SDK deserialization error. We’re working to fix the backend response or update the schema and we’ll update here once it’s resolved.

[thibogue]

Thanks a lot!
Please let me know when it is fixed :)

[LianSetter]

Sure:)
Also important to mention: this is a legacy endpoint.
The newer GET /v1/assets endpoint provides more detailed asset information and improved performance, so we recommend transitioning to it for better results.

[thibogue]

Thanks for the info! @LianSetter

I just double checked and I'm already using /v1/assets.
In the initial description, I have written the correct failing sdk method but wrong url.

The SDK Method failing is: fireblocks.blockchainsAssets().listBlockchains()
which is using GET /v1/blockchains.

Error executing Fireblocks API call to list blockchains
 java.util.concurrent.ExecutionException: com.fireblocks.sdk.ApiException: com.fasterxml.jackson.databind.exc.MismatchedInputException: Missing required creator property 'signingAlgo' (index 2)
 at [Source: REDACTED (`StreamReadFeature.INCLUDE_SOURCE_IN_LOCATION` disabled); line: 1, column: 10273] (through reference chain: com.fireblocks.sdk.model.ListBlockchainsResponse["data"]->java.util.ArrayList[19]->com.fireblocks.sdk.model.BlockchainResponse["onchain"]->com.fireblocks.sdk.model.BlockchainOnchain["signingAlgo"])

The code i'm using is

fireblocks.blockchainsAssets().listBlockchains(null,
                            null,
                            null,
                            null,
                            null,
                            null);