Steem Developer Portal
Methods:
This API is intended to evaluate a transaction status after calling condenser_api.broadcast_transaction.
To enable this API for steemd, the following is required in config.ini by specifying:
plugin = transaction_status_api
See: #3060
- Since: The Mysterious Future
- Related
transaction_status_api.find_transaction
Returns the status of a given transaction id. Parameters: trx_id:string; expiration:timestamp (optional)
The result will contain one of the following status values:
| Status | Meaning |
|---|---|
unknown |
Expiration time in future, transaction not included in block or mempool |
within_mempool |
Transaction in mempool |
within_reversible_block |
Transaction has been included in block, block not irreversible |
within_irreversible_block |
Transaction has been included in block, block is irreversible |
expired_reversible |
Transaction has expired, transaction is not irreversible (transaction could be in a fork) |
expired_irreversible |
Transaction has expired, transaction is irreversible (transaction cannot be in a fork) |
too_old |
Transaction is too old, I don’t know about it |
Query Parameters JSON
{
"transaction_id": "0000000000000000000000000000000000000000",
"expiration": "2016-03-24T18:00:21"
}
Expected Response JSON
{"status": "unknown"}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"transaction_status_api.find_transaction", "params": {"transaction_id": "0000000000000000000000000000000000000000"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"transaction_status_api.find_transaction", "params": {"transaction_id": "0000000000000000000000000000000000000000", "expiration":"2016-03-24T18:00:21"}, "id":1}' https://api.steemit.com