GetTransactionStatus
Returns the status of a specified transaction. This API is available from Zilliqa V7.0.0
onwards and supports all transaction statuses (unconfirmed, confirmed, and rejected).
Example Request
- cURL
curl -d '{
"id": "1",
"jsonrpc": "2.0",
"method": "GetTransactionStatus",
"params": ["1bb178b023f816e950d862f6505cd79a32bb97e71fd78441cbc3486940a2e1b7"]
}' -H "Content-Type: application/json" -X POST "https://api.zilliqa.com/"
Example Response
{
"id": "1",
"jsonrpc": "2.0",
"result": {
"ID": "1bb178b023f816e950d862f6505cd79a32bb97e71fd78441cbc3486940a2e1b7",
"_id": {
"$oid": "5fd053b0d127fe45cc5eea24"
},
"amount": "0",
"data": "{\"_tag\":\"AddAccount\",\"params\":[{\"vname\":\"address\",\"type\":\"ByStr20\",\"value\":\"0x0434cdcf27e2294b3539cb6ffe2cc328d7f9757e\"},{\"vname\":\"datetime_added\",\"type\":\"String\",\"value\":\"1607488428\"}]}",
"epochInserted": "2152402",
"epochUpdated": "2152405",
"gasLimit": "30000",
"gasPrice": "2000000000",
"lastModified": "1607488477842011",
"modificationState": 2,
"nonce": "131",
"senderAddr": "b8fe5ab2e66c71274216688cf852e6d9f10b94e7",
"signature": "0xBAA6964C66AE0608C6CEFBAAB69138E9358A1604C647DFFEF94E7022F2AB33D67F70802F71E934A0690BE4BA81CC3866B2FB668B29C528E6B77B1285533A2E2C",
"status": 3,
"success": true,
"toAddr": "db4955ba4b1a957200ee0a36cf5f84eb4d7447e5",
"version": "21823489"
}
}
Response Fields
Field | Description |
---|---|
_id | Object ID (internal database field) |
epochInserted | Tx epoch when this transaction was first logged |
epochUpdated | Tx epoch when this transaction was last updated |
lastModified | Timestamp for this transaction's last update |
modificationState | See next table below |
status | See next table below |
Other fields | Transaction-related fields |
Status Codes
modificationState | status | Description |
---|---|---|
0 | 0 | Transaction not found |
0 | 1 | Pending - Dispatched |
1 | 2 | Pending - Soft-confirmed (awaiting Tx block generation) |
1 | 4 | Pending - Nonce is higher than expected |
1 | 5 | Pending - Microblock gas limit exceeded |
1 | 6 | Pending - Consensus failure in network |
2 | 3 | Confirmed |
2 | 10 | Rejected - Transaction caused math error |
2 | 11 | Rejected - Scilla invocation error |
2 | 12 | Rejected - Contract account initialization error |
2 | 13 | Rejected - Invalid source account |
2 | 14 | Rejected - Gas limit higher than shard gas limit |
2 | 15 | Rejected - Unknown transaction type |
2 | 16 | Rejected - Transaction sent to wrong shard |
2 | 17 | Rejected - Contract & source account cross-shard issue |
2 | 18 | Rejected - Code size exceeded limit |
2 | 19 | Rejected - Transaction verification failed |
2 | 20 | Rejected - Gas limit too low |
2 | 21 | Rejected - Insufficient balance |
2 | 22 | Rejected - Insufficient gas to invoke Scilla checker |
2 | 23 | Rejected - Duplicate transaction exists |
2 | 24 | Rejected - Transaction with higher gas price exists |
2 | 25 | Rejected - Invalid destination address |
2 | 26 | Rejected - Failed to add contract account to state |
2 | 27 | Rejected - Nonce is lower than expected |
2 | 255 | Rejected - Internal error |
HTTP Request
Chain(s) | URL(s) |
---|---|
Zilliqa mainnet | https://api.zilliqa.com/ |
Developer testnet | https://dev-api.zilliqa.com/ |
Arguments
Parameter | Type | Required | Description |
---|---|---|---|
id | string | Required | "1" |
jsonrpc | string | Required | "2.0" |
method | string | Required | "GetTransactionStatus" |
params | string | Required | Transaction hash of 32 bytes of a specified transaction. |