v1

latestOpenAPI 3.0.32026-07-173986194.3 KB

Returns a governance proposal.

get/consensus/proposals/{proposal_id}

Path parameters

proposal_idinteger required

The unique identifier of the proposal to return.

Response

A JSON object containing a governance proposal.

idinteger required

The unique identifier of the proposal.

submitterstring required

The staking address of the proposal submitter.

state'active' | 'passed' | 'failed' | 'rejected' required

The state of the proposal.

depositstring bigint required

titlestring

The (optional) title of the proposal.

descriptionstring

The (optional) description of the proposal.

handlerstring

The name of the upgrade handler.

epochinteger

The epoch at which the proposed upgrade will happen.

cancelsinteger

The proposal to cancel, if this proposal proposes cancelling an existing proposal.

parameters_change_modulestring

The name of the module whose parameters are to be changed by this 'parameters_change' proposal.

parameters_changestring

The parameters change proposal body. This spec does not encode the many possible types; instead, see the Go API of oasis-core. This object will conform to one of the ConsensusParameterChanges types, depending on the parameters_change_module.

created_atinteger required

The epoch at which this proposal was created.

closes_atinteger required

The epoch at which voting for this proposal will close.

invalid_votesstring bigint required

Example response

{
  "id": 1,
  "submitter": "oasis1qpg2xuz46g53737343r20yxeddhlvc2ldqsjh70p",
  "state": "active",
  "deposit": "1234567890123456789012",
  "epoch": 13402,
  "parameters_change": "{\"min_validators\":null,\"max_validators\":\"120\",\"voting_power_distribution\":null}",
  "created_at": 13402,
  "closes_at": 13403,
  "invalid_votes": "1234567890123456789012"
}