Wait for transaction by hash

get https://api.us1.shinami.com/aptos/node/v1/transactions/wait_by_hash/{txn_hash}

Description

Same as /transactions/by_hash, but will wait for a pending transaction to be committed. To be used as a long poll optimization by clients, to reduce latency caused by polling. The "long" poll is generally a second or less but dictated by the server; the client must deal with the result as if the request was a normal /transactions/by_hash request, e.g., by retrying if the transaction is pending.

Authentication

Authentication is via an 'Authorization: Bearer YOUR_API_ACCESS_KEY' header (which you must add to the sample requests).

Responses

Response body

Headers

object

X-APTOS-CHAIN-ID

uint8

Chain ID of the current chain

X-APTOS-LEDGER-VERSION

uint64

Current ledger version of the chain

X-APTOS-LEDGER-OLDEST-VERSION

uint64

Oldest non-pruned ledger version of the chain

X-APTOS-LEDGER-TIMESTAMPUSEC

uint64

Current timestamp of the chain

X-APTOS-EPOCH

uint64

Current epoch of the chain

X-APTOS-BLOCK-HEIGHT

uint64

Current block height of the chain

X-APTOS-OLDEST-BLOCK-HEIGHT

uint64

Oldest non-pruned block height of the chain

X-APTOS-GAS-USED

uint64

The cost of the call in terms of gas

X-APTOS-CURSOR

string

Cursor to be used for endpoints that support cursor-based
pagination. Pass this to the start field of the endpoint
on the next call to get the next page of results.

Language


xxxxxxxxxx
1
curl --request GET \
2
     --url https://api.us1.shinami.com/aptos/node/v1/transactions/wait_by_hash/txn_hash \
3
     --header 'accept: application/json'


xxxxxxxxxx
22
 
1
{
2
  "type": "pending_transaction",
3
  "hash": "0xfa518597d5527bb3240524c47c6afbfc1f52c665bc35616f7eddf72b56bb778e",
4
  "sender": "0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1 ",
5
  "sequence_number": "32425224034",
6
  "max_gas_amount": "32425224034",
7
  "gas_unit_price": "32425224034",
8
  "expiration_timestamp_secs": "32425224034",
9
  "payload": {
10
    "type": "entry_function_payload",
11
    "function": "0x1::aptos_coin::transfer",
12
    "type_arguments": [
13
      "string"
14
    ],
15
    "arguments": []
16
  },
17
  "signature": {
18
    "type": "ed25519_signature",
19
    "public_key": "0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1 ",
20
    "signature": "0x88fbd33f54e1126269769780feb24480428179f552e2313fbe571b72e62a1ca1 "
21
  }
22
}

200

400

403

404

410

500

503