Returns a list of Runtime transactions.

get/{runtime}/transactions

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

Changed in 2 of the 3 revisions of this API.129

    • added the new optional query request parameter method

      new-optional-request-parameter

    • added the optional property allOf[subschema #2]/transactions/items/allOf[RuntimeTransaction]/oasis_encryption_envelope to the response with the 200 status

      response-optional-property-added

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

      response-property-deprecated

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

      response-property-deprecated

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

      response-property-deprecated

    • added the required property allOf[subschema #2]/transactions/items/allOf[RuntimeTransaction]/signers to the response with the 200 status

      response-required-property-added

  • 51ea4d2cd991123See the full diff
    • removed the required property allOf[subschema #2]/transactions/items/allOf[RuntimeTransaction]/signers from the response with the 200 status

      response-required-property-removed

    • deleted the query request parameter method

      request-parameter-removed

    • removed the optional property allOf[subschema #2]/transactions/items/allOf[RuntimeTransaction]/oasis_encryption_envelope from the response with the 200 status

      response-optional-property-removed

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

      response-property-reactivated

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

      response-property-reactivated

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

      response-property-reactivated

    This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog