# Smart Contract Components

### Core Contracts

#### Safe Smart Account

Standard Safe (Gnosis Safe) v1.3.0+ contracts serve as the execution context. Users maintain full custody through:

* Single-owner threshold (1-of-1 signature)
* EIP712TypedDataSafeModule enabled for bundle execution
* Deterministic deployment via SafeDeployment contract

#### SequenceExecutor

Orchestrates atomic execution of action sequences via delegatecall:

* Validates all action IDs against AdminVault registry
* Executes actions in Safe context (address(this) = Safe)
* All-or-nothing transaction semantics
* Gas-optimized for multi-action bundles

```solidity
struct Sequence {
  string name;
  bytes4[] actionIds;  // Registered action identifiers
  bytes[] callData;    // ABI-encoded parameters
}
```

#### Action Contracts

Protocol-specific adapters inheriting from ActionBase:

* **Stateless:** No persistent storage, operate via delegatecall
* **Modular:** Single responsibility per action
* **Upgradeable:** Replace actions via AdminVault proposals
* **Logged:** All events through centralized Logger

#### Action Types

* **DEPOSIT\_ACTION:** Supply assets to protocols
* **WITHDRAW\_ACTION:** Remove assets from protocols
* **SWAP\_ACTION:** Token exchanges via DEX aggregators
* **COVER\_ACTION:** Purchase protocol insurance
* **TRANSFER\_ACTION:** Token movements (PullToken/SendToken)

***

#### AdminVault

Governance and registry with time-delayed proposals:

* Action registry: `actionId => contractAddress`
* Pool registry: `protocolId => poolId => poolAddress`
* Fee configuration and tracking
* Role-based access control with mandatory delays

***

#### Logger

Centralized event emission contract:

* `ActionEvent(caller, logId, data)` - Action executions
* `AdminVaultEvent(logId, data)` - Governance changes
* Structured event IDs for off-chain processing

***

#### BravaGuard

Safe transaction guard enforcing:

* Only approved actions can be called
* Funds stay within Brava ecosystem
* No unauthorized external calls

***

#### EIP712TypedDataSafeModule

Cross-chain execution via signed bundles:

* Single signature authorizes multi-chain sequences
* Per-Safe nonce management prevents replay
* Bundle expiry enforcement
* Gas refund system (optional)

***

#### SafeDeployment

Deterministic Safe creation using:

* EIP-1167 minimal proxies
* CREATE2 for predictable addresses
* SafeSetupRegistry for configuration templates
* Automated module enablement