Docs: Clear definition of transaction status terminology (pending/success, any other?) and probabilities of success

[ross-spencer]

Searching the Arweave docs it is unclear what each of the transaction statuses mean and what it means to a developer to see one status over another.

Specifically, it would be useful to know all potential transaction statuses, i.e. are there any more than pending and success? (nb. I am not sure if success is an official status or just one we see on viewblock.io).

It may also be useful alongside more documentation about statuses to include information about the likelihood of success of a transaction, e.g. if a transaction is pending is it ever likely it will be dropped? Are there any other potential outcomes of pending one should watch out for?

Are there any other transaction statuses after success? e.g. deleted, removed etc.

Apologies in advance if there is somewhere clearer covering this.

[rosmcmahon]

You could have a look of the arweave-js docs. it's a long read, but there are details pertaining to this area all over the Transactions section.
There's also a short mention of the endpoint in the http-api docs

N.B. Two other good resources for development are the cookbook and Dev Talk discord

[ross-spencer]

Thanks @rosmcmahon that helps. Some useful leads. This is a particularly helpful start from the JS docs:

• https://github.com/ArweaveTeam/arweave-js#get-a-transaction-status

N.B. We strongly advise that you check the status and number of confirmations for a given txid before integrating it elsewhere (for example, if you plan to integrate a txid into an NFT contract), even if you have received a ‘200’ status response.