Evidence

Generated from cosmos/cosmos-sdk@2086680ff8b0 on ref release/v0.55.x.

Queries

A node exposes only the services its application registers:

gRPC on port 9090
REST on port 1317, if the method has an HTTP binding

Run grpcurl -plaintext localhost:9090 list to see what a node serves. Queries are read-only and never pass through consensus. See Queries. Replace <string> placeholders with real values and omit unused filters. Payloads use protobuf JSON, and some string fields accept enum constants listed under Types. Field tables give the encoding each value takes. Examples assume a local node. For TLS endpoints, use port 443 and omit -plaintext. See gRPC services for reflection, address formats, and decimal encoding.

AllEvidence

AllEvidence queries all evidence.


gRPC	`cosmos.evidence.v1beta1.Query/AllEvidence`
REST	`GET /cosmos/evidence/v1beta1/evidence`

Request QueryAllEvidenceRequest:

Field	Type	Description
`pagination`	`PageRequest`	pagination defines an optional pagination for the request.

Response QueryAllEvidenceResponse:

Field	Type	Description
`evidence`	`Any`[]	evidence returns all evidences.
`pagination`	`PageResponse`	pagination defines the pagination in the response.

grpcurl -plaintext -d '{"pagination":{"limit":"1"}}' \
  localhost:9090 cosmos.evidence.v1beta1.Query/AllEvidence

Evidence queries evidence based on evidence hash.


gRPC	`cosmos.evidence.v1beta1.Query/Evidence`
REST	`GET /cosmos/evidence/v1beta1/evidence/{hash}`

Request QueryEvidenceRequest:

Field	Type	Description
`evidence_hash`	`bytes`	evidence_hash defines the hash of the requested evidence. Deprecated: Use hash, a HEX encoded string, instead. Deprecated.
`hash`	`string`	hash defines the evidence hash of the requested evidence.

Response QueryEvidenceResponse:

Field	Type	Description
`evidence`	`Any`	evidence returns the requested evidence.

grpcurl -plaintext -d '{"hash":"<string>"}' \
  localhost:9090 cosmos.evidence.v1beta1.Query/Evidence

Transaction messages

These messages are included in signed transactions, not called as endpoints. See Transactions for the execution model, and Sending transactions for the envelope they go into. Examples use CLI transaction JSON. Decimal fields use values such as "0.05", even when their proto type is bytes. The gRPC TxEncode method instead requires the scaled value "50000000000000000". See scalar encodings.

Handler: Generated client method
Signer: Account that must sign
Amino name: Legacy identifier used by hardware wallets and other Amino signers

SubmitEvidence

SubmitEvidence submits an arbitrary Evidence of misbehavior such as equivocation or counterfactual signing.


Type URL	`/cosmos.evidence.v1beta1.MsgSubmitEvidence`
Handler	`cosmos.evidence.v1beta1.Msg/SubmitEvidence`
Signer	`submitter`
Amino name	`cosmos-sdk/MsgSubmitEvidence`

Field	Type	Description
`submitter`	`string`	submitter is the signer account address of evidence. Encoded as cosmos.AddressString.
`evidence`	`Any`	evidence defines the evidence of misbehavior. Accepts any message implementing cosmos.evidence.v1beta1.Evidence.

In a transaction:

{
  "@type": "/cosmos.evidence.v1beta1.MsgSubmitEvidence",
  "submitter": "<string>",
  "evidence": {
    "@type": "/cosmos.example.v1.MsgExample",
    "...": "the fields of that message, inline"
  }
}

Response MsgSubmitEvidenceResponse:

Field	Type	Description
`hash`	`bytes`	hash defines the hash of the evidence.

Types

Messages referenced by the fields above. Protocol buffers version 3 has no required fields, so every field is optional on the wire, and a [] suffix marks a repeated field.

cosmos.base.query.v1beta1.PageRequest

PageRequest is to be embedded in gRPC request messages for efficient pagination. Ex: message SomeRequest { Foo some_parameter = 1; PageRequest pagination = 2; }

Field	Type	Description
`key`	`bytes`	key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.
`offset`	`uint64`	offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.
`limit`	`uint64`	limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.
`count_total`	`bool`	count_total is set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set.
`reverse`	`bool`	reverse is set to true if results are to be returned in the descending order.

cosmos.base.query.v1beta1.PageResponse

PageResponse is to be embedded in gRPC response messages where the corresponding request message has used PageRequest. message SomeResponse { repeated Bar results = 1; PageResponse page = 2; }

Field	Type	Description
`next_key`	`bytes`	next_key is the key to be passed to PageRequest.key to query the next page most efficiently. It will be empty if there are no more results.
`total`	`uint64`	total is total number of results available if PageRequest.count_total was set, its value is undefined otherwise

Overview

gRPC Services

REST (gRPC Gateway)

Evidence

Queries

AllEvidence

Evidence

Transaction messages

SubmitEvidence

Types

cosmos.base.query.v1beta1.PageRequest

cosmos.base.query.v1beta1.PageResponse

​Queries

​AllEvidence

​Evidence

​Transaction messages

​SubmitEvidence

​Types

​cosmos.base.query.v1beta1.PageRequest

​cosmos.base.query.v1beta1.PageResponse

Queries

AllEvidence

Evidence

Transaction messages

SubmitEvidence

Types

cosmos.base.query.v1beta1.PageRequest

cosmos.base.query.v1beta1.PageResponse