GetPendingTxn


Returns the status (code) of a specified unconfirmed Transaction.

Example Request

curl -d '{
"id": "1",
"jsonrpc": "2.0",
"method": "GetPendingTxn",
"params": ["b9e545ab3ed0b61a4d326425569605255e0990da7dda18b4658fdb17b390844e"]
}' -H "Content-Type: application/json" -X POST "https://api.zilliqa.com/"

Example Response

Since Zilliqa V6.3.0

{
"id": "1",
"jsonrpc": "2.0",
"result": {
"code": 24,
"confirmed": false,
"pending": false
}
}

Zilliqa V6.2.0 and before

{
"id": "1",
"jsonrpc": "2.0",
"result": {
"code": 0,
"confirmed": false,
"info": "Txn not pending"
}
}

API Availability

Please note that the status of newly created transactions (using CreateTransaction) may not immediately be available for checking using this API.

A created transaction will be included in this API if:

  1. It has already been dispatched to the network (this may require one transaction epoch)
  2. The network has acknowledged receiving this transaction (this occurs at the end of every transaction epoch)

Hence, we recommend calling GetPendingTxn around 1-2 transaction epochs after transaction creation to get accurate results.

Status Codes

From Zilliqa V6.3.0 onwards

Confirmed Transactions

codeTransaction Status
0Transaction is not pending

Pending Transactions

codeTransaction Status
1Nonce is higher than expected
2Microblock gas limit exceeded
3Consensus failure in network

Unknown Transactions

codeTransaction Status
4Transaction not found

Dropped / Rejected Transactions

codeTransaction Status
10Transaction caused math error
11Scilla invocation error
12Contract account initialization error
13Invalid source account
14Gas limit higher than shard gas limit
15Unknown transaction type
16Transaction sent to wrong shard
17Contract & source account cross-shard issue
18Code size exceeded limit
19Transaction verification failed
20Gas limit too low
21Insufficient balance
22Insufficient gas to invoke Scilla checker
23Duplicate transaction exists
24Transaction with higher gas price exists
25Invalid destination address
26Failed to add contract account to state

Note: Dropped transactions are available for querying for up to 5 transaction epochs only.

Zilliqa V6.2.0

confirmedcodeinfo
false0Txn not pending
false1Nonce too high
false2Could not fit in as microblock gas limit reached
false3Transaction valid but consensus not reached

HTTP Request

Chain(s)URL(s)
Zilliqa mainnethttps://api.zilliqa.com/
Developer testnethttps://dev-api.zilliqa.com/
Local testnethttp://localhost:4201/
Isolated serverhttp://localhost:5555/

Arguments

ParameterTypeRequiredDescription
idstringRequired"1"
jsonrpcstringRequired"2.0"
methodstringRequired"GetPendingTxn"
paramsstringRequiredTransaction hash of 32 bytes of a specified transaction.