Create the builder pool

Pool creation

In the protocol, any user can create a builder pool by calling the createBuilderPool function. During creation, the user must specify a unique project name that will be used to generate the pool’s identifier using keccak256. Additionally, the creator must provide the builder’s address (the admin of the pool), who will be responsible for managing it. The builder must also define key parameters: the start time of the pool (poolStart), the withdrawal lock period after deposit (withdrawLockPeriodAfterDeposit), the reward claim unlock time (claimLockEnd), and the minimum allowed deposit amount (minimalDeposit). All of these parameters are validated by the contract before being accepted.

Pool params

Each field in the BuilderPool struct plays a crucial role in defining the behavior of the pool. The name is the project label, used both for user identification and as the input for generating the unique pool ID.

The admin field is the builder’s address, responsible for performing reward claims and pool management.

The poolStart defines the timestamp from which users can begin depositing; any deposits made before this time will be rejected.

withdrawLockPeriodAfterDeposit specifies the minimum time (in seconds) that must elapse after a user deposits before they are allowed to withdraw their tokens. This helps maintain deposit stability.

The claimLockEnd field defines when the admin can start claiming rewards and apply lock multiplier for all stakes until this timestamp.

The minimalDeposit parameter ensures that any deposit (or remaining balance after a partial withdrawal) must meet or exceed a minimum threshold unless the user is fully withdrawing.

Pool edit

Editing an existing pool is allowed only until the pool’s start time (poolStart). Only the builder (admin) who created the pool can perform edits. The editBuilderPool function accepts the same struct as the creation call, allowing modification of lock periods and start time. However, the new poolStart must not be earlier than the previously set one — this prevents time-based manipulation or rollback of the pool’s launch.

Pool ID

The pool receives a unique builderPoolId derived from the project name using the following Solidity expression:

bytes32 builderPoolId = keccak256(abi.encodePacked(builderPool.name));

This ID is then used in all pool-related operations including deposits, withdrawals, reward claiming, and internal data storage for builder configuration, user stakes, and reward accounting.