Blockchain Usage

Please note the following:

  • Records submitted to the blockchain are not added to the blockchain immediately. Records are contained within transactions which are collected into blocks. These need to be agreed between several blockchain miners before the blocks are added to the blockchain.

  • GET location status provides the latest confirmation status of a record being added to the blockchain. It is good practice to check the location status for the submit operations (Write, Create, Update and Delete) once every 10 minutes (at the most frequent) until the confirmation status is satisfactory.

  • If GET location status reports that the operation has failed, retry the operation.

  • There is no guarantee that a record will be mined and confirmed within any number of blocks.

  • There is also a minute possibility that a record will not be mined at all. If it is not mined within a reasonable time frame, for example 1 hour, retry the submit operation.

  • Loss of returned locations due to system failures:

    • If a Write record location becomes lost, you will need to resubmit it.

    • If a Create link record location becomes lost, you will need to resubmit it.

    • If an Update or Delete link record location becomes lost, you will need to resubmit it. If the linked record cannot be updated because GET linked location status indicates that it already has been, update the next updateable link instead with information about the issue, and then continue to link further records. You may need to use a third-party tool such as ‘WhatsOnChain’ to find the links if they are not available in the GET linked location status.

  • LinkedRecord update and delete requests are valid only after the preceding record has been mined, otherwise resulting in undefined behaviour.

  • You can read your written records from the blockchain at the returned location using a third-party tool such as ‘WhatsOnChain.’

You will first need to trim off the nChain Event metadata from the transaction output. (Contact nChain for the specification of the metadata). Try writing a test record such as "[test]" to identify where the record resides amongst the transaction output.

  • You can also verify your written records at the returned location using a third-party tool. You will need the original record and will also first need to trim off the nChain Event metadata.

Last updated

Copyright © nChain Licensing AG 2024