banking.v1.ConsiliumService

GetConsilium

One consilium in full, including per-voter state (Owner only).

post/banking.v1.ConsiliumService/GetConsilium

Request

  • The document declares no server URL.
  • Auth: none required

Headers

Connect-Protocol-Version1 required

Define the version of the Connect protocol

Connect-Timeout-Msnumber

Define the timeout, in ms

Request body

consilium_idstring

Response

Success

idstring
state'CONSILIUM_STATE_UNSPECIFIED' | 'CONSILIUM_STATE_OPEN' | 'CONSILIUM_STATE_APPROVED' | 'CONSILIUM_STATE_REJECTED' | 'CONSILIUM_STATE_EXPIRED' | 'CONSILIUM_STATE_CANCELLED' | 'CONSILIUM_STATE_EXECUTED' | 'CONSILIUM_STATE_EXECUTION_FAILED'

Where a consilium stands. Terminal everywhere except OPEN.

payload_hashstring

Hex SHA-256 over the canonical terms. Shown (short prefix) in the mail so an owner can tell that what they approved is what will execute.

initiator_user_idstring
initiator_emailstring
owner_countinteger

N — owners at open. The threshold is frozen from this, never recomputed later.

thresholdinteger
approvalsinteger

Votes that are still valid: an approver who has since lost ownership does not count.

rejectionsinteger
executed_withdrawal_idstring

Set exactly once, on EXECUTED — and exactly ONE of the effect ids is (executed_withdrawal_id, executed_payment_id, executed_valuation_id, executed_fee_policy_change_id, executed_issuance_id, executed_subscription_id), because a consilium has one effect. consilium_execution_is_recorded states that to the database as num_nonnulls(...) = 1.

failure_reasonstring
executed_payment_idstring

The payment order an executed PAYMENT consilium carried.

executed_valuation_idstring

The fund_valuations row an executed VALUATION-OVERRIDE consilium recorded.

executed_fee_policy_change_idstring

The fee-policy change an executed FEE_POLICY consilium scheduled.

executed_issuance_idstring

The in-kind issuance an executed HOLDER_GRANT consilium minted (AllocationsService.UnitIssuance).

executed_subscription_idstring

The fund subscription an executed SEED_CAPITAL consilium booked (FundsService.Subscription).

Changes

Changes to this operation have not been checked yet.