Returns a list of consensus transactions.

Changed on
get/consensus/transactions

Request

  • Base URL: https://nexus.oasis.io/v1
  • URL: https://nexus.oasis.io/v1/consensus/transactions
  • Auth: none declared

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 height.

method'beacon.PVSSCommit' | 'beacon.PVSSReveal' | 'beacon.VRFProve' | 'consensus.Meta' | 'governance.CastVote' | 'governance.SubmitProposal' | 'keymanager.PublishEphemeralSecret' | 'keymanager.PublishMasterSecret' | 'keymanager.UpdatePolicy' | 'registry.DeregisterEntity' | 'registry.ProveFreshness' | 'registry.RegisterEntity' | 'registry.RegisterNode' | 'registry.RegisterRuntime' | 'registry.UnfreezeNode' | 'roothash.Evidence' | 'roothash.ExecutorCommit' | 'roothash.ExecutorProposerTimeout' | 'roothash.SubmitMsg' | 'staking.AddEscrow' | 'staking.Allow' | 'staking.AmendCommissionSchedule' | 'staking.Burn' | 'staking.ReclaimEscrow' | 'staking.Transfer' | 'staking.Withdraw' | 'keymanager/churp.Apply' | 'keymanager/churp.Confirm' | 'keymanager/churp.Create' | 'keymanager/churp.Update' | 'vault.AuthorizeAction' | 'vault.CancelAction' | 'vault.Create'
Example:staking.Transfer

A filter on transaction method.

senderstring

An Oasis-style (bech32) address.

Example:oasis1qpg2xuz46g53737343r20yxeddhlvc2ldqsjh70p

A filter on transaction sender.

relstring

A filter on related accounts.

afterstring date-time

A filter on minimum transaction time, inclusive.

beforestring date-time

A filter on maximum transaction time, exclusive.

Response

A JSON object containing a list of consensus 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": [
    {
      "block": 8048956,
      "index": 17,
      "timestamp": "2022-10-15T00:05:34Z",
      "hash": "0d0531d6b8a468c07440182b1cdda517f5a076d69fb2199126a83082ecfc0f41",
      "sender": "oasis1qpg2xuz46g53737343r20yxeddhlvc2ldqsjh70p",
      "fee": "1234567890123456789012",
      "gas_limit": 30000,
      "gas_used": 30000,
      "method": "staking.Transfer"
    }
  ]
}

Changes

  • v145e86f2c70b8Revision changes
    • breaking

      the /////// response's property type changed from no type to integer, and format from no format to uint64 for status

    • info

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

    • info

      removed from the /////// response property allOf list for the response status

  • v19d302aadedb6Revision changes
    • breaking

      the /////// response's property type changed from integer to no type, and format from uint64 to no format for status

    • warning

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

    • info

      added to the /////// response property allOf list for the response status