Roles and permissions

A vault has governance, a primary trading delegate, a share mint, policy and custody accounts. Depositors own shares and sign their own capital requests.

Roles

RoleResponsibility
Protocol cold authorityCreates vaults. Registers price routes and swap venues through the timelock. Freezes, unfreezes and starts emergency unwind.
Protocol guardianFreezes vaults.
Vault governanceSets policy and delegation. Runs vault shutdown.
Primary delegateTrades and processes capital under its active on-chain grant.
DepositorRequests, cancels or processes capital actions on their own shares and escrow.
Public processorProcesses requests under the fallback rules. Gets no governance authority.

Governance can use the same wallet as the primary delegate.

Delegate permissions

PermissionBitOperation
OPEN_AS_WRITER1Write an option from vault collateral, requesting the RFQ as taker.
SIGN_HOLDER_QUOTES2Sign holder-side quotes on sell RFQs on behalf of the vault.
FUND_HOLDER4Deposit settlement funds for a bought option.
REBALANCE8Rebalance vault assets.
PROCESS_CAPITAL16Process capital requests.
SET_DEPOSIT_WINDOW32Open or close the deposit window.
SIGN_WRITER_QUOTES64Sign writer-side quotes on buy RFQs: the signature alone commits vault collateral to a wallet's buy.

Opening positions and rebalancing also check strategy capabilities and policy. Under the fallback rules, anyone can process capital. Governance, or a delegate with SET_DEPOSIT_WINDOW, can change the deposit window. Phase and safety mode apply to both.

Swap and staging authority

REBALANCE does not permit arbitrary external calls. Every hop must use a registered venue and one of its allowed instruction selectors. Governance can propose a timelocked second-leg roll; the contract checks its capital boundary and route compatibility.

A rebalance actor can drain staged tokens into main while safety is normal. After 300 seconds, governance can drain the slot into main in any safety mode, subject to the applicable pause and price checks. RecoveryStage is governance-only and follows recovery eligibility. Neither public capital processing nor its fallback delay grants swap authority.

Shared governance and delegate key

Quotes need an active primary-delegate grant with the matching quote bit (SIGN_HOLDER_QUOTES on sells, SIGN_WRITER_QUOTES on buys) that matches the signer, even when the signer is governance. Revoking or expiring the grant stops quotes. Governance keeps its other powers.

Operator auth can return operator_kind: "governance" with maker permission. The backend and the contract check authorization again on every execution.

See Vault API, SDKs and swaps for signing and operator sessions, and Governance and security for protocol authorities and timelocks.