Governance and Security Model

Acta separates cold governance from hot operations. The cold authority controls protocol configuration and the timelock; the hot wallet runs routine market and oracle operations within those limits. The guardian is an emergency canceller/pause key.

Roles

Cold authority (ACTA_ADMIN)

The cold authority is the hardcoded public key CLSYf1AL9rXYjGbSjvexMRegriqpLR37kmLkcqvAgBnN. Squads v4 supplies the vault PDA's signature after its configured approvals. Acta verifies the ACTA_ADMIN signature; membership, approval thresholds and Squads execution delays are enforced by Squads.

Cold authority operations:

  • initialize the global config
  • initialize, update, and close premium configs through the timelock
  • register makers through the timelock
  • create and update oracle sources through the timelock
  • raise or keep the global timelock delay immediately
  • lower the global timelock delay only through the timelock
  • rotate the hot wallet immediately
  • set, rotate, or clear the guardian immediately
  • set, rotate, or revoke the settlement attestor through the timelock
  • set or close vault price routes and enable or disable vault swap venues through the timelock
  • toggle pause immediately
  • correct an already published settlement price immediately (CorrectOraclePrice)
  • create vaults (CreateVault)
  • freeze and unfreeze vaults, and start a vault's emergency unwind, immediately
  • queue pending actions
  • cancel pending actions

The cold authority is separate from the program upgrade authority.

Hot wallet (GlobalConfig.hot_authority)

The hot wallet is the online key used by backend services. It is stored in GlobalConfig.hot_authority and can be rotated by the cold authority without a redeploy.

Hot wallet operations:

  • create, finalize, and close markets
  • create and close concrete oracle accounts from already-approved oracle sources
  • publish a post-expiry scalar settlement price to an oracle account. UpdateOraclePrice checks the live hot_authority, and works for the hot wallet only while no settlement attestor is configured: once GlobalConfig.settlement_attestor is set, direct hot publication is rejected on-chain (SettlementAttestationRequired) and settlement requires UpdateOraclePriceAttested with an Ed25519 attestation from that key — a 2-of-2 of hot key and attestor key. The cold authority retains a break-glass direct path
  • co-sign every position open (OpenPosition, OpenSpread and the vault open instructions)
  • withdraw collected protocol fees

The hot wallet cannot modify cold configuration, rotate itself, bypass maker quote signatures, or bypass taker transaction signatures.

Guardian (GlobalConfig.guardian)

The guardian is an optional emergency key. It defaults to unset; the default public key does not authorize anyone. The cold authority sets, rotates, or clears it with SetGuardian.

Guardian operations:

  • cancel any queued pending action before execution
  • engage the emergency pause (releasing it / unpause is cold-only)
  • freeze a vault (FreezeVault; unfreezing is cold-only)

The guardian cannot queue pending actions, rotate itself, rotate the hot wallet, unpause, unfreeze vaults, or authorize hot/cold configuration changes. A guardian is a single trusted key: if compromised it can only grief (veto-spam queued actions, re-engage the pause, freeze vaults) and the cold authority recovers by rotating it with SetGuardian (immediate).

Permissionless exits

Settlement and liquidation are permissionless. Any signer may settle a position once its market is finalized. Any signer may liquidate an ITM, unfunded physical position (covered call or cash-secured put) after finalization. Call spreads, put spreads and cash puts settle in cash and have no liquidation path. Pause does not block exits.

Authority Matrix

ActionAuthorityTiming
Program upgradeSeparate program-upgrade authorityIts configured Squads approvals and delay
Initialize global configColdImmediate
Rotate hot walletColdImmediate
Set / rotate / clear guardian (SetGuardian, op 27)ColdImmediate
Engage emergency pause (SetPause, op 28)Cold or guardianImmediate
Release emergency pause / unpause (SetPause, op 28)ColdImmediate
Queue pending action (QueuePendingAction, op 23)ColdImmediate queue
Execute pending action (ExecutePendingAction, op 25)Any signerAfter the cold-approved action's delay
Cancel pending action (CancelPendingAction, op 24)Cold or guardianBefore execute
Raise / keep timelock delay (UpdateActionTimelock, op 26)ColdImmediate
Lower timelock delay (UpdateActionTimelock, op 26)ColdTimelocked by current delay
Initialize / update / close premium configColdTimelocked
Register maker (stores its quote_signing key)ColdTimelocked
Rotate a maker's quote_signing key (UpdateMakerQuoteSigning)Maker ownerImmediate
Create / update oracle sourceColdTimelocked
Create / finalize / close marketHot walletImmediate
Create / close concrete oracleHot walletImmediate
Publish settlement price (UpdateOraclePrice, op 16)Hot wallet (only while no attestor is set) or coldImmediate after expiry
Publish attested settlement price (UpdateOraclePriceAttested, op 31)Hot wallet + attestor Ed25519 proof (2-of-2)After expiry, attestor set
Correct a published settlement price (CorrectOraclePrice, op 72)ColdImmediate (not timelocked)
Set / rotate settlement attestor (SetSettlementAttestor, op 29)ColdTimelocked
Revoke settlement attestor (RevokeSettlementAttestor, op 30)ColdTimelocked
Vault manager-stake floor, capital fallback delay (SetVaultManagerStakeMinBps, SetVaultCapitalFallbackDelay)ColdTimelocked
Vault price route per mint (SetPriceRoute op 73, ClosePriceRoute op 74); applies to every vault holding that mintColdTimelocked
Vault swap venue allowlist (SetSwapVenue, op 75)ColdTimelocked
Create vault (CreateVault)ColdImmediate
Freeze vault (FreezeVault)Cold or guardianImmediate
Unfreeze vault (UnfreezeVault)ColdImmediate
Start vault emergency unwind (EmergencyStartUnwind, irreversible)ColdImmediate
Withdraw protocol feesHot walletImmediate
Open position (OpenPosition op 7, OpenSpread op 77; vault variants ops 41, 42, 61, 78, 79, 80)Hot wallet + taker tx signer + maker Ed25519 quoteImmediate; rejected while paused
Settle position (all products)PermissionlessAfter market finalization
Liquidate position (physical only)PermissionlessAfter finalization; ITM + unfunded

Timelock

Acta uses one global delay for timelocked actions: GlobalConfig.timelock_secs, from 0 to 604,800 seconds (7 days). Its initial value is 0. Zero permits immediate execution of a queued action; cold authorization and the instruction commitment still apply.

The timelock uses a generic store-and-replay model. Queue stores a commitment to the exact wrapped instruction; execute replays the same wrapped instruction after execute_at.

Cold authorizes the action when queueing it. Once its delay has elapsed, any signer can execute that exact action. The executor pays transaction costs and funds accounts created during execution; closing the pending-action account returns its rent to the original proposer.

Supported premium mints are configured through premium config PDAs. InitializeConfig creates a premium config, UpdateConfig updates it, and CloseConfig closes that premium config.

Timelockable wrapped opcodes:

OpcodeInstruction
0InitializeConfig
1UpdateConfig
2RegisterMaker
17CreateOracleSource
18UpdateOracleSource
20CloseConfig
29SetSettlementAttestor
30RevokeSettlementAttestor
26UpdateActionTimelock
73SetPriceRoute
74ClosePriceRoute
75SetSwapVenue
70SetVaultManagerStakeMinBps
71SetVaultCapitalFallbackDelay

In production, all listed operations except the immediate raise/keep form of UpdateActionTimelock reject direct calls with DirectCallDisabled; they must go through queue -> execute. UpdateActionTimelock is special: raising or keeping the delay is immediate; lowering it must be queued and waited out under the current delay.

Wire Shape

QueuePendingAction data is [23, wrapped_opcode, ...wrapped_args] and accounts are [admin, pending_action_pda, system_program, global_config_pda, ...wrapped_accounts].

ExecutePendingAction data is [25, wrapped_opcode, ...wrapped_args] and accounts are [executor, pending_action_pda, proposed_by, ...wrapped_accounts].

The commitment binds:

sha256(
  "acta:pend.v2"
  || wrapped_opcode
  || ordered wrapped account keys
  || full wrapped instruction data
)

Client note: generated Codama builders for QueuePendingAction and ExecutePendingAction expose only the wrapped opcode, so they are not sufficient for real generic timelock payloads. Use the SDK flow helpers or manually build the full wrapped wire layout above.

Emergency Pause

SetPause sets the PAUSED bit in GlobalConfig.flags. Engaging the pause is immediate for cold or guardian; releasing it (unpause) is cold-only, so a compromised guardian cannot unpause to resume an attack.

While paused, OpenPosition, the vault position opens, VaultSpotRebalance and ClosingConvertToMain fail with ProtocolPaused. Settlement, liquidation, vault deposits and withdrawals, governance recovery conversion and the cold-only emergency conversion remain available.

Settlement Attestation

GlobalConfig.settlement_attestor optionally names an independent Ed25519 second signer for hot settlement publication. The attestor signs a price it computes itself from Pyth Benchmarks history; the contract verifies the signature and message binding, not the computation. The policy is described in Protocol flow. While it is unset (all-zero), UpdateOraclePrice behaves as described above. Once set (SetSettlementAttestor, cold-only), the hot wallet's direct call fails with SettlementAttestationRequired; settlement then requires UpdateOraclePriceAttested, where an Ed25519 verify instruction signed by the attestor over a domain-separated message must immediately precede the update in the same transaction. The message binds the program, global config, oracle, price, expiry, issued_at, valid_until and calculation version. issued_at must be at or after the expiry, the window may not exceed 300 s, and the current time must lie inside it. The cold authority keeps the direct path as break-glass (Ed25519 precompile instructions cannot be produced through Squads CPI). RevokeSettlementAttestor (cold-only) clears the key and deliberately returns hot settlement to direct mode; the 32-byte replay domain is retained so signatures can never be replayed across deployments.

CorrectOraclePrice (cold-only, immediate, not timelocked) overwrites a settlement price that has already been published. It fails if no price is set yet (OraclePriceNotSet) and rejects a zero, out-of-range or unchanged price (OracleInvalidPrice). Markets copy the price when they are finalized, so a correction only affects markets on that oracle that are not yet finalized. Once a price is published, by any path, further hot or attested publication fails with OracleAlreadyUpdated, so this is the only way to change it.

Squads Integration

Squads handles approvals and member rotation; Acta checks the cold vault signature. The approval threshold and Squads delay are stored in the multisig account. The Acta timelock separately controls when queued protocol actions become executable, and the guardian can cancel them before execution.

Program Upgrade

Program upgrades use a separate Squads vault and its configured approvals and execution delay. The program's upgrade authority authorizes deployment of the program buffer. GlobalConfig.timelock_secs applies to Acta's queued instructions, not to program upgrades.