Governance
⚠️ Validado on-chain (com ressalvas de modelo)
Suite adv-write — delegate/propose validados on-chain.cancelsó vale na janela Pending; settersonlyGovernancerevertem por design (só o timelock chama).
Gerada automaticamente do spec OpenAPI da API (fonte de verdade). 45 endpoint(s).
List governance
GET /v1/governance
List all governance instances
Auth: api-key
Respostas: 200, 401
Deploy governance
POST /v1/governance
Deploy a new Governor + Timelock governance system
Auth: api-key
Request body:
| Campo | Tipo | Obrigatório | Descrição |
|---|
Respostas: 201, 400, 401
Get governance
GET /v1/governance/{id}
Get governance instance details
Auth: api-key
Path params: id
Respostas: 200, 401, 404
Get checkpoint
GET /v1/governance/{id}/checkpoints
Get checkpoint data at a specific position for an address
Auth: api-key
Path params: id
Respostas: 200, 401
Get governor clock
GET /v1/governance/{id}/clock
Get the current clock value and mode of the governor
Auth: api-key
Path params: id
Respostas: 200, 401
Get governance config
GET /v1/governance/{id}/config
Get governance configuration parameters
Auth: api-key
Path params: id
Respostas: 200, 401, 404
Get counting mode
GET /v1/governance/{id}/counting_mode
Get the COUNTING_MODE string of the governor
Auth: api-key
Path params: id
Respostas: 200, 401
Delegate voting power
POST /v1/governance/{id}/delegate
Delegate voting power to another address
Auth: api-key
Path params: id
Request body:
| Campo | Tipo | Obrigatório | Descrição |
|---|
Respostas: 201, 400, 401
Delegate by signature
POST /v1/governance/{id}/delegate_by_sig
Delegate voting power using an EIP-712 signature
Auth: api-key
Path params: id
Request body:
| Campo | Tipo | Obrigatório | Descrição |
|---|
Respostas: 201, 400, 401
Get delegate
GET /v1/governance/{id}/delegates
Get who an account has delegated voting power to
Auth: api-key
Path params: id
Respostas: 200, 401
Hash proposal
POST /v1/governance/{id}/hash_proposal
Compute the hash of a proposal
Auth: api-key
Path params: id
Request body:
| Campo | Tipo | Obrigatório | Descrição |
|---|
Respostas: 200, 400, 401
Get number of checkpoints
GET /v1/governance/{id}/num_checkpoints
Get the number of voting checkpoints for an address
Auth: api-key
Path params: id
Respostas: 200, 401
Get past total supply
GET /v1/governance/{id}/past_total_supply
Get historical total voting supply at a specific block
Auth: api-key
Path params: id
Respostas: 200, 401
Check if proposal needs queuing
GET /v1/governance/{id}/proposal_needs_queuing
Check whether a proposal requires timelock queuing
Auth: api-key
Path params: id
Respostas: 200, 401
Set proposal threshold
POST /v1/governance/{id}/proposal_threshold
Update minimum voting power to create a proposal
Auth: api-key
Path params: id
Request body:
| Campo | Tipo | Obrigatório | Descrição |
|---|
Respostas: 201
List proposals
GET /v1/governance/{id}/proposals
List all proposals for a governance instance
Auth: api-key
Path params: id
Respostas: 200, 401
Create proposal
POST /v1/governance/{id}/proposals
Create a new governance proposal
Auth: api-key
Path params: id
Request body:
| Campo | Tipo | Obrigatório | Descrição |
|---|
Respostas: 201, 400, 401
Get proposal
GET /v1/governance/{id}/proposals/{proposalId}
Get proposal details by ID
Auth: api-key
Path params: id, proposalId
Respostas: 200, 401, 404
Cancel proposal
POST /v1/governance/{id}/proposals/{proposalId}/cancel
Cancel a pending proposal
Auth: api-key
Path params: id, proposalId
Request body:
| Campo | Tipo | Obrigatório | Descrição |
|---|
Respostas: 201, 400, 401
Get proposal deadline
GET /v1/governance/{id}/proposals/{proposalId}/deadline
Get the block number deadline for a proposal vote
Auth: api-key
Path params: id, proposalId
Respostas: 200, 401, 404
Get proposal ETA
GET /v1/governance/{id}/proposals/{proposalId}/eta
Get the estimated time of availability for a proposal
Auth: api-key
Path params: id, proposalId
Respostas: 200, 401, 404
Execute proposal
POST /v1/governance/{id}/proposals/{proposalId}/execute
Execute a queued proposal
Auth: api-key
Path params: id, proposalId
Request body:
| Campo | Tipo | Obrigatório | Descrição |
|---|
Respostas: 201, 400, 401
Has voted
GET /v1/governance/{id}/proposals/{proposalId}/has_voted
Check if an address has voted on a proposal
Auth: api-key
Path params: id, proposalId
Respostas: 200, 401, 404
Get proposal proposer
GET /v1/governance/{id}/proposals/{proposalId}/proposer
Get the address of the account that created a proposal
Auth: api-key
Path params: id, proposalId
Respostas: 200, 401, 404
Queue proposal
POST /v1/governance/{id}/proposals/{proposalId}/queue
Queue a successful proposal for execution
Auth: api-key
Path params: id, proposalId
Request body:
| Campo | Tipo | Obrigatório | Descrição |
|---|
Respostas: 201, 400, 401
Get proposal snapshot
GET /v1/governance/{id}/proposals/{proposalId}/snapshot
Get the block number at which a proposal's voting snapshot was taken
Auth: api-key
Path params: id, proposalId
Respostas: 200, 401, 404
Get proposal state
GET /v1/governance/{id}/proposals/{proposalId}/state
Get the current state of a proposal
Auth: api-key
Path params: id, proposalId
Respostas: 200, 401, 404
Cast vote
POST /v1/governance/{id}/proposals/{proposalId}/vote
Cast a vote on a governance proposal
Auth: api-key
Path params: id, proposalId
Request body:
| Campo | Tipo | Obrigatório | Descrição |
|---|
Respostas: 201, 400, 401
Cast vote by signature
POST /v1/governance/{id}/proposals/{proposalId}/vote_by_sig
Cast a vote using an EIP-712 signature
Auth: api-key
Path params: id, proposalId
Request body:
| Campo | Tipo | Obrigatório | Descrição |
|---|
Respostas: 201, 400, 401
Cast vote with params
POST /v1/governance/{id}/proposals/{proposalId}/vote_with_params
Cast a vote with reason and additional parameters
Auth: api-key
Path params: id, proposalId
Request body:
| Campo | Tipo | Obrigatório | Descrição |
|---|
Respostas: 201, 400, 401
Cast vote with params by sig
POST /v1/governance/{id}/proposals/{proposalId}/vote_with_params_by_sig
Cast a vote with reason, params, and EIP-712 signature
Auth: api-key
Path params: id, proposalId
Request body:
| Campo | Tipo | Obrigatório | Descrição |
|---|
Respostas: 201, 400, 401
Get proposal votes
GET /v1/governance/{id}/proposals/{proposalId}/votes
Get vote tallies (for/against/abstain) for a proposal
Auth: api-key
Path params: id, proposalId
Respostas: 200, 401, 404
Get quorum
GET /v1/governance/{id}/quorum
Get quorum requirement at a block number
Auth: api-key
Path params: id
Respostas: 200, 401
Relay call
POST /v1/governance/{id}/relay
Relay a call through the Governor (governance-controlled execution)
Auth: api-key
Path params: id
Request body:
| Campo | Tipo | Obrigatório | Descrição |
|---|
Respostas: 201, 400, 401
Update timelock
POST /v1/governance/{id}/timelock
Update the TimelockController address used for execution delays
Auth: api-key
Path params: id
Request body:
| Campo | Tipo | Obrigatório | Descrição |
|---|
Respostas: 201
Hash timelock operation
POST /v1/governance/{id}/timelock/hash_operation
Compute the hash of a timelock operation
Auth: api-key
Path params: id
Request body:
| Campo | Tipo | Obrigatório | Descrição |
|---|
Respostas: 200, 401
Hash timelock batch operation
POST /v1/governance/{id}/timelock/hash_operation_batch
Compute the hash of a batch timelock operation
Auth: api-key
Path params: id
Request body:
| Campo | Tipo | Obrigatório | Descrição |
|---|
Respostas: 200, 401
Get timelock min delay
GET /v1/governance/{id}/timelock/min_delay
Get the minimum delay of the timelock controller
Auth: api-key
Path params: id
Respostas: 200, 401
Get timelock operation state
GET /v1/governance/{id}/timelock/operation_state
Get the state of a timelock operation
Auth: api-key
Path params: id
Respostas: 200, 401
Update quorum
POST /v1/governance/{id}/update_quorum
Update the quorum numerator on the Governor contract
Auth: api-key
Path params: id
Request body:
| Campo | Tipo | Obrigatório | Descrição |
|---|
Respostas: 201, 400, 401
Get governor version
GET /v1/governance/{id}/version
Get the version string of the governor contract
Auth: api-key
Path params: id
Respostas: 200, 401
Get voting power
GET /v1/governance/{id}/votes
Get voting power for an address at a block number
Auth: api-key
Path params: id
Respostas: 200, 401
Get votes with params
GET /v1/governance/{id}/votes_with_params
Get voting power with custom parameters
Auth: api-key
Path params: id
Respostas: 200, 401
Set voting delay
POST /v1/governance/{id}/voting_delay
Update blocks delay between proposal and voting start
Auth: api-key
Path params: id
Request body:
| Campo | Tipo | Obrigatório | Descrição |
|---|
Respostas: 201
Set voting period
POST /v1/governance/{id}/voting_period
Update duration (in blocks) of voting period
Auth: api-key
Path params: id
Request body:
| Campo | Tipo | Obrigatório | Descrição |
|---|
Respostas: 201