Contract States

Reference for all contract states and transitions

State Enum

enum ContractState {
    NOT_DEPLOYED,        // 0
    NEW_DEPLOYMENT,      // 1
    ATTACK_REQUESTED,    // 2
    UNDER_ATTACK,        // 3
    PROMOTION_REQUESTED, // 4
    PRODUCTION,          // 5
    CORRUPTED            // 6
}

State Details

State	Value	Attackable	Terminal	Description
NOT_DEPLOYED	0	No	No	Not registered or rejected
NEW_DEPLOYMENT	1	No	No	Deployed via BattleChainDeployer
ATTACK_REQUESTED	2	No	No	Awaiting DAO approval
UNDER_ATTACK	3	Yes	No	Open for whitehats
PROMOTION_REQUESTED	4	Yes	No	3-day promotion countdown
PRODUCTION	5	No	Yes	Protected like mainnet
CORRUPTED	6	No	Yes	Successfully exploited

Querying State

// Check if contract is attackable (UNDER_ATTACK or PROMOTION_REQUESTED)
bool attackable = attackRegistry.isTopLevelContractUnderAttack(contractAddress);

// Get exact state
IAttackRegistry.ContractState state = attackRegistry.getAgreementState(agreementAddress);

// Get full info
IAttackRegistry.AgreementInfo memory info = attackRegistry.getAgreementInfo(agreementAddress);

State Transitions

From NOT_DEPLOYED

• → NEW_DEPLOYMENT: Deploy via BattleChainDeployer

From NEW_DEPLOYMENT

• → ATTACK_REQUESTED: Call requestUnderAttack()
• → PRODUCTION: Call goToProduction()

From ATTACK_REQUESTED

• → UNDER_ATTACK: DAO calls approveAttack()
• → NOT_DEPLOYED: DAO calls rejectAttackRequest()
• → PRODUCTION: DAO calls instantPromote() or auto after 14 days

From UNDER_ATTACK

• → PROMOTION_REQUESTED: Attack moderator calls promote()
• → CORRUPTED: Attack moderator calls markCorrupted()
• → PRODUCTION: DAO calls instantPromote()

From PROMOTION_REQUESTED

• → PRODUCTION: After 3 days automatically
• → UNDER_ATTACK: Attack moderator calls cancelPromotion()
• → CORRUPTED: Attack moderator calls markCorrupted()
• → PRODUCTION: DAO calls instantPromote()

From PRODUCTION

None (terminal state)

From CORRUPTED

None (terminal state)

Time Constants

uint256 public constant PROMOTION_WINDOW = 14 days;
uint256 public constant PROMOTION_DELAY = 3 days;
uint256 public constant MIN_COMMITMENT = 7 days;