Wait until the given request has been processed by the node

GET 
//v1/chains/:chainID/requests/:requestID/wait

Wait until the given request has been processed by the node

Request

Path Parameters

chainID stringrequired

ChainID (Bech32)

requestID stringrequired

RequestID (Hex)

Query Parameters

timeoutSeconds int32

The timeout in seconds, maximum 60s

waitForL1Confirmation boolean

Wait for the block to be confirmed on L1

Responses

200

The request receipt

application/json

Schema

Schema

blockIndex int32required

Possible values: >= 1

errorMessage string
gasBudget stringrequired

The gas budget (uint64 as string)

gasBurnLog BurnRecord[]required
Array [
code int32required
gasBurned int64required
]
gasBurned stringrequired

The burned gas (uint64 as string)

gasFeeCharged stringrequired

The charged gas fee (uint64 as string)

rawError UnresolvedVMErrorJSON
code string
params string[]
request RequestJSONrequired
allowance AssetsJSONrequired
baseTokens stringrequired
The base tokens (uint64 as string)
nativeTokens NativeTokenJSON[]required
Array [
amount stringrequired
id stringrequired
]
nfts string[]required
callTarget CallTargetJSONrequired
contractHName stringrequired
The contract name as HName (Hex)
functionHName stringrequired
The function name as HName (Hex)
fungibleTokens AssetsJSONrequired
baseTokens stringrequired
The base tokens (uint64 as string)
nativeTokens NativeTokenJSON[]required
Array [
amount stringrequired
id stringrequired
]
nfts string[]required
gasBudget stringrequired
The gas budget (uint64 as string)
isEVM booleanrequired
isOffLedger booleanrequired
nft NFTJSONrequired
id stringrequired
issuer stringrequired
metadata stringrequired
owner stringrequired
params JSONDictrequired
Items Item[]
Array [
key stringrequired
key (hex-encoded)
value stringrequired
value (hex-encoded)
]
requestId stringrequired
senderAccount stringrequired
targetAddress stringrequired
requestIndex int32required

Possible values: >= 1

storageDepositCharged stringrequired

Storage deposit charged (uint64 as string)

Example (from schema)

{
  "gasBurnLog": [
    {
      "code": 6,
      "gasBurned": 1
    },
    {
      "code": 6,
      "gasBurned": 1
    }
  ],
  "request": {
    "fungibleTokens": {
      "nfts": [
        "nfts",
        "nfts"
      ],
      "baseTokens": "baseTokens",
      "nativeTokens": [
        {
          "amount": "amount",
          "id": "id"
        },
        {
          "amount": "amount",
          "id": "id"
        }
      ]
    },
    "senderAccount": "senderAccount",
    "isOffLedger": true,
    "requestId": "requestId",
    "callTarget": {
      "contractHName": "contractHName",
      "functionHName": "functionHName"
    },
    "gasBudget": "gasBudget",
    "targetAddress": "targetAddress",
    "allowance": {
      "nfts": [
        "nfts",
        "nfts"
      ],
      "baseTokens": "baseTokens",
      "nativeTokens": [
        {
          "amount": "amount",
          "id": "id"
        },
        {
          "amount": "amount",
          "id": "id"
        }
      ]
    },
    "params": {
      "Items": [
        {
          "value": "value",
          "key": "key"
        },
        {
          "value": "value",
          "key": "key"
        }
      ]
    },
    "nft": {
      "owner": "owner",
      "metadata": "metadata",
      "id": "id",
      "issuer": "issuer"
    },
    "isEVM": true
  },
  "blockIndex": 1,
  "rawError": {
    "code": "code",
    "params": [
      "params",
      "params"
    ]
  },
  "requestIndex": 1,
  "storageDepositCharged": "storageDepositCharged",
  "gasFeeCharged": "gasFeeCharged",
  "errorMessage": "errorMessage",
  "gasBudget": "gasBudget",
  "gasBurned": "gasBurned"
}

404

The chain or request id not found

408

The waiting time has reached the defined limit

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L -X GET '/v1/chains/:chainID/requests/:requestID/wait' \
-H 'Accept: application/json'

Request Collapse all

Base URL

Parameters

chainID — pathrequired

requestID — pathrequired

timeoutSeconds — query

waitForL1Confirmation — query

---truefalse

ResponseClear

Click the Send API Request button above and see the response here!