Returns a list of Runtime transactions.

Changed on
get/{runtime}/transactions

Request

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

Path parameters

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

The runtime which to query.

Query parameters

limitinteger

The maximum numbers of items to return.

offsetinteger

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

blockinteger

A filter on block round.

afterstring date-time

A filter on minimum transaction time, inclusive.

beforestring date-time

A filter on maximum transaction time, exclusive.

relstring

A filter on related accounts. Every returned transaction will refer to this account in a way. For example, for an accounts.Transfer tx, this will be the sender or the recipient of tokens. Nexus detects related accounts inside EVM transactions and events on a best-effort basis. For example, it inspects ERC20 methods inside evm.Call txs.

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 Runtime 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

  • a841981f8ee1Revision changes
    • info

      added the new optional query request parameter method

    • info

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

    • info

      response property allOf[subschema #2]/transactions/items/allOf[RuntimeTransaction]/nonce_0 deprecated

    • info

      response property allOf[subschema #2]/transactions/items/allOf[RuntimeTransaction]/sender_0 deprecated

    • info

      response property allOf[subschema #2]/transactions/items/allOf[RuntimeTransaction]/sender_0_eth deprecated

    • info

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

  • 51ea4d2cd991Revision changes
    • breaking

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

    • warning

      deleted the query request parameter method

    • warning

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

    • info

      response property allOf[subschema #2]/transactions/items/allOf[RuntimeTransaction]/nonce_0 reactivated

    • info

      response property allOf[subschema #2]/transactions/items/allOf[RuntimeTransaction]/sender_0 reactivated

    • info

      response property allOf[subschema #2]/transactions/items/allOf[RuntimeTransaction]/sender_0_eth reactivated