Returns a list of transactions submitted by the given ROFL instance.

Changed on
get/{runtime}/rofl_apps/{id}/instances/{rak}/transactions

Request

  • Base URL: https://nexus.oasis.io/v1
  • URL: https://nexus.oasis.io/v1/{runtime}/rofl_apps/{id}/instances/{rak}/transactions
  • Auth: none declared

Path parameters

runtime'emerald' | 'sapphire' | 'pontusxtest' | 'pontusxdev' | 'cipher' required
Example:sapphire

The runtime which to query.

idstring required

The ID of the ROFL app to return transactions for.

rakstring required

The RAK of the ROFL instance to return transactions for.

Query parameters

limitinteger

The maximum numbers of items to return.

offsetinteger

The number of items to skip before starting to collect the result set.

methodstring

A filter on the runtime transaction method.

In addition to the existing method names, the following special values are supported:

  • 'native_transfers': Returns transactions "likely to be native transfers".

    • These include accounts.Transfer transactions and evm.Calls with an empty 'body' field.
  • 'evm.Call_no_native': Returns EVM calls that are "not likely to be native transfers".

Response

A JSON object containing a list of transactions.

total_countinteger required

The total number of records that match the query, i.e. the number of records the query would return with limit=infinity.

is_total_count_clippedboolean required

Whether total_count is clipped for performance reasons.

Example response

{
  "total_count": 412,
  "is_total_count_clipped": true,
  "transactions": [
    {
      "round": 3379702,
      "timestamp": "2022-10-15T00:05:34Z",
      "hash": "8394f682150e5f62b02f197d16b4769d032cb1c1b7a6dcf853ba1b12626e080b",
      "eth_hash": "9e6a5837c6366d4a7e477c71ffe32d40915cdef7ef209792259e5ee70caf2705",
      "signers": [
        {
          "address": "oasis1qpg2xuz46g53737343r20yxeddhlvc2ldqsjh70p",
          "nonce": 114194
        }
      ],
      "sender_0": "oasis1qpg2xuz46g53737343r20yxeddhlvc2ldqsjh70p",
      "nonce_0": 114194,
      "fee": "3000000000000000",
      "gas_limit": 30000,
      "oasis_encryption_envelope": {
        "format": "encrypted/x25519-deoxysii"
      },
      "method": "evm.Call",
      "body": {
        "address": "t1mAPucIdVnrYBpJOcLV2nZoOFo=",
        "data": "RBo+cAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=\"",
        "value": ""
      },
      "is_likely_native_token_transfer": true,
      "to": "oasis1qpg2xuz46g53737343r20yxeddhlvc2ldqsjh70p",
      "amount": "100000001666393459",
      "amount_symbol": "ROSE",
      "encryption_envelope": {
        "format": "encrypted/x25519-deoxysii"
      },
      "evm_fn_name": "acceptTaskResults"
    }
  ]
}

Changes

    • info

      added the required property /////// to the response with the status

    • breaking

      removed the required property /////// from the response with the status