IFactoryFeeManager

Git Source Inherits: IFeeManager Interface that describes the struct and accessor function for the data related to the collection of fees.

Functions

setFeeCollector

FUNCTIONS *Set address of fee collector. Requirements:

msg.sender has to be the owner of the factory.
newFeeCollector can’t be address 0x0.*

function setFeeCollector(address newFeeCollector) external;

Parameters

Name	Type	Description
`newFeeCollector`	`address`	Address of `feeCollector`.

scheduleGlobalCreationFee

Sets a new global creation fee value, to take effect after 1 hour. msg.sender has to be the fee collector of the factory.

function scheduleGlobalCreationFee(uint64 newFeeValue) external;

Parameters

Name	Type	Description
`newFeeValue`	`uint64`	Value for `creationFee` that will be charged on `Raffl`’s deployments.

scheduleGlobalPoolFee

Sets a new global pool fee percentage, to take effect after 1 hour. *Percentages and fees are calculated using 18 decimals where 1 ether is 100%. Requirements:

newFeePercentage must be within minPoolFee and maxPoolFee.
msg.sender has to be the fee collector of the factory.*

function scheduleGlobalPoolFee(uint64 newFeePercentage) external;

Parameters

Name	Type	Description
`newFeePercentage`	`uint64`	Value for `poolFeePercentage` that will be charged on `Raffl`’s pools.

scheduleCustomCreationFee

Sets a new custom creation fee value for a specific User, to be enabled and take effect after 1 hour from the time of this transaction. *Allows the contract owner to modify the creation fee associated with a specific User. The new fee becomes effective after a delay of 1 hour, aiming to provide a buffer for users to be aware of the upcoming fee change. This function updates the fee and schedules its activation, ensuring transparency and predictability in fee adjustments. The fee is specified in wei, allowing for granular control over the fee structure. Emits a CustomCreationFeeChange event upon successful fee update. Requirements:

msg.sender has to be the fee collector of the factory.*

function scheduleCustomCreationFee(address user, uint64 newFeeValue) external;

Parameters

Name	Type	Description
`user`	`address`	Address of the `user`.
`newFeeValue`	`uint64`	The new creation fee amount to be set, in wei, to replace the current fee after the specified delay.

scheduleCustomPoolFee

Sets a new custom pool fee percentage for a specific User, to be enabled and take effect after 1 hour from the time of this transaction. *This function allows the contract owner to adjust the pool fee for a User. The fee adjustment is delayed by 1 hour to provide transparency and predictability. Fees are calculated with precision to 18 decimal places, where 1 ether equals 100% fee. The function enforces fee limits; newFeePercentage must be within the predefined 0-MAX_POOL_FEE bounds. If the custom fee was previously disabled or set to a different value, this operation schedules the new fee to take effect after the delay, enabling it if necessary. Emits a CustomPoolFeeChange event upon successful execution. Requirements:

msg.sender has to be the fee collector of the factory.
newFeePercentage must be within the range limited by MAX_POOL_FEE.*

function scheduleCustomPoolFee(address user, uint64 newFeePercentage) external;

Parameters

Name	Type	Description
`user`	`address`	Address of the `user`.
`newFeePercentage`	`uint64`	The new pool fee percentage to be applied, expressed in ether terms (18 decimal places) where 1 ether represents 100%.

toggleCustomCreationFee

Enables or disables the custom creation fee for a given Raffle, with the change taking effect after 1 hour. msg.sender has to be the fee collector of the factory.

function toggleCustomCreationFee(address user, bool enable) external;

Parameters

Name	Type	Description
`user`	`address`	Address of the `user`.
`enable`	`bool`	True to enable the fee, false to disable it.

toggleCustomPoolFee

Enables or disables the custom pool fee for a given Raffle, to take effect after 1 hour. msg.sender has to be the fee collector of the factory.

function toggleCustomPoolFee(address user, bool enable) external;

Parameters

Name	Type	Description
`user`	`address`	Address of the `user`.
`enable`	`bool`	True to enable the fee, false to disable it.

minPoolFee

Exposes the minimum pool fee.

function minPoolFee() external pure returns (uint64);

maxPoolFee

Exposes the maximum pool fee.

function maxPoolFee() external pure returns (uint64);

feeCollector

Exposes the FeeData.feeCollector to users.

function feeCollector() external view returns (address);

globalCreationFee

Retrieves the current global creation fee to users.

function globalCreationFee() external view returns (uint64);

globalPoolFee

Retrieves the current global pool fee percentage to users.

function globalPoolFee() external view returns (uint64);

creationFeeData

Returns the current creation fee for a specific user, considering any pending updates.

function creationFeeData(address user)
    external
    view
    override
    returns (address feeCollectorAddress, uint64 creationFeeValue);

Parameters

Name	Type	Description
`user`	`address`	Address of the `user`.

poolFeeData

Returns the current pool fee for a specific user, considering any pending updates.

function poolFeeData(address user)
    external
    view
    override
    returns (address feeCollectorAddress, uint64 poolFeePercentage);

Parameters

Name	Type	Description
`user`	`address`	Address of the `user`.

Events

FeeCollectorChange

EVENTS

event FeeCollectorChange(address indexed feeCollector);

Parameters

Name	Type	Description
`feeCollector`	`address`	Address of the new fee collector.

GlobalCreationFeeChange

event GlobalCreationFeeChange(uint64 creationFeeValue);

Parameters

Name	Type	Description
`creationFeeValue`	`uint64`	Value for the new creation fee.

GlobalPoolFeeChange

event GlobalPoolFeeChange(uint64 poolFeePercentage);

Parameters

Name	Type	Description
`poolFeePercentage`	`uint64`	Value for the new pool fee.

CustomCreationFeeChange

event CustomCreationFeeChange(address indexed user, uint64 creationFeeValue);

Parameters

Name	Type	Description
`user`	`address`	Address of the user.
`creationFeeValue`	`uint64`	Value for the new creation fee.

CustomCreationFeeToggle

event CustomCreationFeeToggle(address indexed user, bool enable);

Parameters

Name	Type	Description
`user`	`address`	Address of the user.
`enable`	`bool`	Indicates the enabled state of the fee.

CustomPoolFeeChange

event CustomPoolFeeChange(address indexed user, uint64 poolFeePercentage);

Parameters

Name	Type	Description
`user`	`address`	Address of the user.
`poolFeePercentage`	`uint64`	Value for the new pool fee.

CustomPoolFeeToggle

event CustomPoolFeeToggle(address indexed user, bool enable);

Parameters

Name	Type	Description
`user`	`address`	Address of the user.
`enable`	`bool`	Indicates the enabled state of the fee.

Smart Contracts

Technical

IFactoryFeeManager

IFactoryFeeManager

Functions

setFeeCollector

scheduleGlobalCreationFee

scheduleGlobalPoolFee

scheduleCustomCreationFee

scheduleCustomPoolFee

toggleCustomCreationFee

toggleCustomPoolFee

minPoolFee

maxPoolFee

feeCollector

globalCreationFee

globalPoolFee

creationFeeData

poolFeeData

Events

FeeCollectorChange

GlobalCreationFeeChange

GlobalPoolFeeChange

CustomCreationFeeChange

CustomCreationFeeToggle

CustomPoolFeeChange

CustomPoolFeeToggle

​IFactoryFeeManager

​Functions

​setFeeCollector

​scheduleGlobalCreationFee

​scheduleGlobalPoolFee

​scheduleCustomCreationFee

​scheduleCustomPoolFee

​toggleCustomCreationFee

​toggleCustomPoolFee

​minPoolFee

​maxPoolFee

​feeCollector

​globalCreationFee

​globalPoolFee

​creationFeeData

​poolFeeData

​Events

​FeeCollectorChange

​GlobalCreationFeeChange

​GlobalPoolFeeChange

​CustomCreationFeeChange

​CustomCreationFeeToggle

​CustomPoolFeeChange

​CustomPoolFeeToggle

IFactoryFeeManager

Functions

setFeeCollector

scheduleGlobalCreationFee

scheduleGlobalPoolFee

scheduleCustomCreationFee

scheduleCustomPoolFee

toggleCustomCreationFee

toggleCustomPoolFee

minPoolFee

maxPoolFee

feeCollector

globalCreationFee

globalPoolFee

creationFeeData

poolFeeData

Events

FeeCollectorChange

GlobalCreationFeeChange

GlobalPoolFeeChange

CustomCreationFeeChange

CustomCreationFeeToggle

CustomPoolFeeChange

CustomPoolFeeToggle