Guide — 08

System Configuration & Settings

The SovereignMind terminal enables administrators and authorized roles to modify risk tolerances, rebalance cycle cooldowns, and execute emergency contract directives.

1. On-Chain Settings Panel

The Settings page acts as a developer console. Instead of querying local state, the terminal queries public contract getters. If you connect an account containing administrative roles (defined in `AgentRegistry.sol`), you can modify parameters directly.

Modifiable Settings Variables

VariableDefault ValueDescription
Risk Threshold65 / 100The maximum risk score computed by the CFO agent before the CEO defaults to asset protection (HOLD/USDC swap).
Rebalance Cooldown15 minutesOn-chain constraint defining the minimum time interval that must elapse between `initiateDecisionCycle()` calls.
Oracle Fixed Fee0.05 STTThe amount of STT deposited as the runner fee for validator computation execution requests.

2. Role-Based Access Control (RBAC)

The guild secures operational calls using OpenZeppelin's AccessControl inside the `AgentRegistry.sol` contract. Roles are granted and revoked cryptographically:

ADMIN_ROLECan add or revoke executive agents, alter parameters, and deploy contract upgrades.
AGENT_ROLEAllows target contract addresses (CEO, CFO, CMO) to invoke specific inter-contract methods (e.g. CEO triggering the vault rebalance).

3. Emergency Stop (Circuit Breakers)

In the event of severe market anomalies or contract issues, the system owner can trigger the Pause action inside `TreasuryVault.sol` or `VaultShares.sol`. While paused, no automated swaps, deposits, or redemptions can occur. This safety circuit breaker prevents loss of capital until unpaused.

Administrative Safety Warnings

Ensure you never share private keys linked to accounts holding administrative permissions on the Somnia Testnet. While gas costs are low, admin transactions still require a funded address.