banking.v1.ConsiliumService

OpenHolderGrant

Seat a new holder of a reserved allocation (Owner only): units of fee or fund minted to a person, with no cash leg, once the quorum carries. The units are frozen into the terms, not a cash figure — what they are worth is the allocation's NAV at execution, as a subscription is priced at its own moment. Refused when the person is not an active user, when the allocation is not reserved, or when the roster is too small. This is the ONLY way a person comes to hold fee or fund other than a seed (BalanceService.SeedCapital) or the book.

post/banking.v1.ConsiliumService/OpenHolderGrant

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

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

No operation changes recorded.