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