BLOCKCHAIN_UNAVAILABLE

BLOCKCHAIN_UNAVAILABLE

Description

The context cannot read the registry on the blockchain, because the network does not answer. The document is not verified yet. This response does not mean that the document is not certified: the context never answers verified: false when it cannot read the registry.

HTTP Status

424 Failed Dependency

doc_url Format

The doc_url value is an absolute URL and changes by environment:

<docs-base-url>/errors/blockchain_unavailable

Typical Causes

• The node of the blockchain network does not answer before the timeout.
• The node answers an error to a read.

Example

Request: POST /v1/certification/verifications while the node does not answer.

Response:

{
  "errors": [
    {
      "code": "BLOCKCHAIN_UNAVAILABLE",
      "message": "The blockchain network did not answer: the document is not verified yet, try again later",
      "doc_url": "https://docs.example.com/errors/blockchain_unavailable"
    }
  ]
}

How To Fix

1. Send the request again after some seconds. The endpoint changes no state: a second request is safe.
2. If the error continues, tell the Quarzo Life support.