Load Balancer Proxy

Description

This project implements a proxy contract that can be used to balance the load between multiple implementations such as Staking, Voting, etc. The proxy contract is responsible for routing the calls to the appropriate implementation contract.

Design

The project is divided into two main components:

1. Load Balancer contract: This is the proxy contract that is responsible for routing the calls to the appropriate implementation contract. The proxy contract uses the registry contract to determine which implementation contract to route the call to.
2. Implementation Contracts: The implementation contracts are the actual contracts that implement the functionality. The implementation contracts are registered in the registry contract.

Actors

1. User: The user is the external entity that interacts with the proxy contract to access the functionality provided by the implementation contracts.
2. Owner: The owner is the entity that deploys the proxy contract and has the ability to add/remove implementation contracts from the registry contract.

Design Pattern

This project is inspired by the Diamond proxy pattern. It has been modified such that instead of storing the function selectors mapped to their implementation contracts, the proxy contract uses an implementation id to determine which implementation contract to route the call to.

Workflow

1. Deployment: The owner deploys the Load Balancer contract.
2. Registration: The owner registers the implementation contracts in the registry and deploys and links the appropriate library contracts.
3. Usage: The user interacts with the proxy contract using low-level calls to access the functionality provided by the implementation contracts.

Project Structure

src/
└── contracts/
    ├── interfaces/
    │   └── ILoadBalancer.sol
    |
    ├── core/
    │   └── LoadBalancer.sol
    |
    ├── implementations/
    │   ├── Staking.sol
    │   └── Voting.sol
    |
    └── libraries/
        ├── LibLoadBalancer.sol
        ├── LibVoting.sol
        └── LibStaking.sol

Deployments

This release of the project has been deployed and verified on the Sepolia blockchain with the following addresses:

1. Staking: 0x91759e69CBF231716CFD524FE818D837F9b2e098
2. ERC20Mock: 0x76EaEFD35d4653450669b7034a7193c9f2F4200d
3. LoadBalancer: 0xDF563FEDcBC2b73b83D44a6402D5B82A4FB654a6

Note: The contracts in this project are not audited and should not be used in production without proper security audits.