AdminProxy

The AdminProxy contract manages upgrade proposals and administrative changes for a smart contract system using a transparent upgradeable proxy pattern. It handles role assignments and modifications, such as proposer, acceptor, and emergency operator roles, and enables controlled upgrading of contract implementations.

Key Features

• Role-Based Access Control: Uses roles like proposer, acceptor, and emergency operator to manage different levels of access and control.

• Proposal Management: Facilitates the proposing and acceptance of new contract implementations.

• Emergency Controls: Allows the emergency operator to reset the contract to a known stable implementation in case of issues.

Constructor

• Initializes the contract with roles and the initial base implementation.

  • Parameters:

    • proxy_: Address of the transparent upgradeable proxy.

    • proxyAdmin_: Address of the proxy admin.

    • acceptor_: Initial acceptor's address.

    • proposer_: Initial proposer's address.

    • emergencyOperator_: Initial emergency operator's address.

    • baseImplementation_: Initial base implementation.

Core Methods

1. Role Management

   • upgradeEmergencyOperator(address): Updates the emergency operator.

   • upgradeProposer(address): Updates the proposer.

   • upgradeAcceptor(address): Updates the acceptor.

2. Proposal Functions

   • proposeBaseImplementation(address, bytes): Proposes a new base implementation.

   • propose(address, bytes): Proposes a new contract implementation.

   • acceptBaseImplementation(): Accepts the proposed base implementation.

   • acceptProposal(uint256): Accepts a specified proposal.

   • rejectAllProposals(): Rejects all outstanding proposals.

3. Emergency Functions

   • resetToBaseImplementation(): Resets the contract to the base implementation in case of an emergency.

Modifiers

• requireProposerOrAcceptor: Ensures the caller is either the proposer or the acceptor.

• onlyAcceptor: Ensures the caller is the acceptor.

• onlyEmergencyOperator: Ensures the caller is the emergency operator.

Events

• EmergencyOperatorUpgraded: Emitted when the emergency operator is upgraded.

• ProposerUpgraded: Emitted when the proposer is upgraded.

• AcceptorUpgraded: Emitted when the acceptor is upgraded.

• BaseImplementationProposed: Emitted when a new base implementation is proposed.

• ImplementationProposed: Emitted when a new implementation is proposed.

• BaseImplementationAccepted: Emitted when the base implementation is accepted.

• ProposalAccepted: Emitted when a proposal is accepted.

• AllProposalsRejected: Emitted when all proposals are rejected.

• ResetToBaseImplementation: Emitted when the contract is reset to the base implementation.