aboutsummaryrefslogtreecommitdiffstats
path: root/docs/openapi.yaml
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-18 20:12:04 +0000
committertv <tv@krebsco.de>2026-11-18 21:17:57 +0100
commit7404dcef34dbad11a5ac2a6b8a27836b01c82635 (patch)
tree9f2f55ad01130e454f6c6e9f308b459caadea6e9 /docs/openapi.yaml
parent657765cc512743c248d71b852b4f2e81fa124af7 (diff)
events: why no party's client backs a proposal
`GET /events/counts` gives each proposal on the current version `none`: why a party's client backs it not (`client::backable`), where it is no version as this node reads it, none changing the current one, or one naming the heads of the current one's checkpoint; else `null`. So a node shows that a proposal is none, and why, before it passes: one that passes all the same is never written, or, no version here, the node stops at its version event. The dashboard shows it with the proposal, and `continuum-party proposals` says it by the federation the client knows. Row 48's test checks what a node shows of the proposal.
Diffstat (limited to 'docs/openapi.yaml')
-rw-r--r--docs/openapi.yaml10
1 files changed, 8 insertions, 2 deletions
diff --git a/docs/openapi.yaml b/docs/openapi.yaml
index e1e602a..57ef132 100644
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@@ -1533,7 +1533,11 @@ paths:
(`proposals`) and of the votes on it (`votes`), the parties voting `true` (`yes`)
and `false` (`no`), whether it passed (`passed`: two thirds of the parties voted
`true`) and whether it is dead (`dead`: so many voted `false` that the rest can't
- pass it). A passed proposal is written at once, and lapses with the rest.
+ pass it), and why a party's client backs it not (`none`), where it is no version,
+ none changing the current one, or one naming the heads of the current one's
+ checkpoint, as this node reads it: one that passed all the same is never written,
+ or, no version here, this node stops at its version event. A passed proposal is
+ written at once, and lapses with the rest.
responses:
'200':
description: What counts.
@@ -1559,7 +1563,7 @@ paths:
type: object
additionalProperties:
type: object
- required: [proposals, votes, yes, no, passed, dead]
+ required: [proposals, votes, yes, no, passed, dead, none]
properties:
proposals:
type: array
@@ -1581,6 +1585,8 @@ paths:
type: boolean
dead:
type: boolean
+ none:
+ type: [string, 'null']
'404':
$ref: '#/components/responses/Error'
/events/refused: