In Overledger, the concept of "status" refers to the current state of a transaction or block within the blockchain network. The status indicates various stages of the transaction or block lifecycle, providing developers with valuable insights into its progress and outcome. Overledger supports several status values, each representing a different stage of the transaction or block process. These status values include:

PENDING

The transaction or block has been initiated but has not yet been confirmed by the network. Once a sufficient number of blocks have been reached, it will be marked as either successful or failed.

🚧

A Transaction or a Block is not guaranteed to ever move to the successful status.

A transaction could be 'dropped' from the network (i.e. removed from the nodes memory), if for instance, the transaction fee is to low.

Therefore you should wait for a transaction's status to move to successful, before performing any critical program logic.

FAILED

The transaction encountered an error or was rejected by the network.

SUCCESSFUL

The transaction or block has been successfully validated and included on the blockchain.

By monitoring the status of transactions, developers can track their progress and take appropriate actions as needed, such as resubmitting failed transactions or verifying successful completions. This insight into transaction status is essential for building reliable and robust blockchain applications using Overledger.