mirror of
https://github.com/zoo-apps/fund.git
synced 2026-10-30 14:57:02 +00:00
zeekay
c778d7405b
- Full app extraction from zoo monorepo (source only) - Configured for GitHub Pages deployment - Static export enabled - Custom domain: zoo.fund - Excludes node_modules and build artifacts
90 lines
3.2 KiB
Solidity
90 lines
3.2 KiB
Solidity
// SPDX-License-Identifier: AGPL-3.0
|
|
pragma solidity ^0.8.30;
|
|
|
|
/**
|
|
* @title IFreezeVotingBase
|
|
* @notice Base interface for freeze voting contracts that enable parent DAOs to freeze child DAOs
|
|
* @dev Freeze voting is a critical emergency mechanism in parent-child DAO relationships.
|
|
* It allows token holders of a parent DAO to vote to freeze a child DAO's operations,
|
|
* preventing the child from executing any transactions while frozen.
|
|
*
|
|
* Key mechanics:
|
|
* - Freeze proposals are separate from regular governance proposals
|
|
* - Votes accumulate until the threshold is reached
|
|
* - Once threshold is met, the child DAO is immediately frozen
|
|
* - Freezes are permanent until explicitly unfrozen
|
|
* - Concrete implementations define their own unfreeze mechanism
|
|
*
|
|
* Security features:
|
|
* - Time-limited freeze proposals prevent stale votes
|
|
* - Permanent freezes require explicit unfreeze action
|
|
* - Configurable threshold allows DAOs to set appropriate requirements
|
|
* - Implementations may add ownership or voting-based control
|
|
*
|
|
* This base interface defines the common freeze voting functionality shared by
|
|
* different implementations (Azorius-based and Multisig-based parent DAOs).
|
|
*/
|
|
interface IFreezeVotingBase {
|
|
// --- Errors ---
|
|
|
|
/** @notice Thrown when attempting to cast a freeze vote with zero voting weight */
|
|
error NoVotes();
|
|
|
|
// --- Events ---
|
|
|
|
/**
|
|
* @notice Emitted when a freeze vote is successfully cast
|
|
* @param voter The address that cast the vote
|
|
* @param votesCast The voting weight applied to the freeze proposal
|
|
*/
|
|
event FreezeVoteCast(address indexed voter, uint256 votesCast);
|
|
|
|
/**
|
|
* @notice Emitted when the DAO is frozen
|
|
* @param freezeTimestamp The timestamp when the freeze was activated
|
|
*/
|
|
event DAOFrozen(uint256 freezeTimestamp);
|
|
|
|
// --- View Functions ---
|
|
|
|
/**
|
|
* @notice Returns when the current freeze proposal was created
|
|
* @dev Returns 0 if no freeze proposal exists or it expired
|
|
* @return freezeProposalCreated Timestamp of the current freeze proposal creation
|
|
*/
|
|
function freezeProposalCreated()
|
|
external
|
|
view
|
|
returns (uint48 freezeProposalCreated);
|
|
|
|
/**
|
|
* @notice Returns the accumulated votes for the current freeze proposal
|
|
* @dev Resets to 0 when a new freeze proposal is created
|
|
* @return freezeProposalVoteCount Total voting weight cast for freezing
|
|
*/
|
|
function freezeProposalVoteCount()
|
|
external
|
|
view
|
|
returns (uint256 freezeProposalVoteCount);
|
|
|
|
/**
|
|
* @notice Returns the duration for which freeze proposals remain active
|
|
* @dev After this period, a new freeze proposal must be created
|
|
* @return freezeProposalPeriod Duration in seconds
|
|
*/
|
|
function freezeProposalPeriod()
|
|
external
|
|
view
|
|
returns (uint32 freezeProposalPeriod);
|
|
|
|
/**
|
|
* @notice Returns the voting weight threshold required to freeze the child DAO
|
|
* @dev When vote count reaches this threshold, freeze is activated immediately
|
|
* @return freezeVotesThreshold The required voting weight
|
|
*/
|
|
function freezeVotesThreshold()
|
|
external
|
|
view
|
|
returns (uint256 freezeVotesThreshold);
|
|
}
|