ContinuousVirtualAmountMultiplierFacetStorage

This library manages the storage and logic for the application of amount multipliers (used for scaling rewards) within staking campaigns according to a continuous-based schema.

_Example of a continuous-based schema configuration: If amountsStaked = [100, 200, 300] and amountStakedMultipliers = [2, 3, 4]:

• A position with less than 100 staked packets will receive an amount multiplier of 1 (no multiplier).

• A position with staked packets X, where X is between 100 (inclusive) and 200 (exclusive), will receive an amount multiplier calculated as follows: amountMultiplierForX = 2 + ((X - 100) / (200 - 100)) * (3 - 2)

• A position with staked packets Y, where Y is between 200 (inclusive) and 300 (exclusive), will receive an amount multiplier calculated as follows: amountMultiplierForY = 3 + ((Y - 200) / (300 - 200)) * (4 - 3)

• A position with 300 or more staked packets will receive an amount multiplier of 4.

IMPORTANT:

• Multipliers should be scaled by 1e18, allowing for calculations with up to 18 decimal precision. -amountsStaked and amountStakedMultipliers must be in strictly increasing order._

CampaignNotOnCreationStateForSetting

error CampaignNotOnCreationStateForSetting(uint256 campaignId)

Thrown when a targeted campaign is not "On Creation" state, which is required at configurations.

NoAmountMultiplierDataProvided

error NoAmountMultiplierDataProvided(uint256 campaignId)

Thrown at setter when no data provided for either amountsStaked or amountStakedMultipliers

InvalidAmountMultiplierDataLengths

error InvalidAmountMultiplierDataLengths(uint256 campaignId, uint256 amountsStakedLength, uint256 amountStakedMultipliersLength)

Thrown at setter when the lengths of amountsStaked and amountStakedMultipliers do not match.

InvalidZeroFirstAmountMultiplierData

error InvalidZeroFirstAmountMultiplierData(uint256 campaignId, uint256 amount, uint256 amountMultiplier)

Thrown at setter when the first element of amountsStaked or amountStakedMultipliers is zero.

InvalidAmountMultiplierDataOrder

error InvalidAmountMultiplierDataOrder(uint256 campaignId)

Thrown at setter when the amountsStaked or amountStakedMultipliers are not in strictly increasing order.

STORAGE_SLOT

bytes32 STORAGE_SLOT

Unique identifier for the storage slot where the Layout struct is stored.

DIVIDER

uint256 DIVIDER

Used to normalize values (e.g., multipliers) for calculations with up to 18 decimal precision.

Layout

Struct for managing information related to amount-wise multipliers.

struct Layout {
  mapping(uint256 => struct ContinuousVirtualAmountMultiplierFacetStorage.CampaignInfo) campaignInfoLocal;
  mapping(uint256 => uint256) amountMultiplierForNftId;
}

CampaignInfo

Struct containing the configuration information for amount-wise multipliers in a staking campaign.

struct CampaignInfo {
  uint256[] amountsStaked;
  uint256[] amountStakedMultipliers;
}

layout

function layout() internal pure returns (struct ContinuousVirtualAmountMultiplierFacetStorage.Layout l)

Retrieves a reference to the Layout struct stored at the slot specified by STORAGE_SLOT unique identifier.

setCampaignVirtualAmountMultipliers

function setCampaignVirtualAmountMultipliers(struct ContinuousVirtualAmountMultiplierFacetStorage.Layout l, uint256 campaignId, bytes campaignVirtualAmountMultipliersData) internal returns (uint256[], uint256[])

Setter function for configuring amount multipliers for the specified staking campaign.

_Setter functions are executed during the creation process of campaigns (see CampaignCreationSkeleton.sol). This function allows for the configuration of thresholds and their respective base multipliers for staked amounts.

The lengths of the amountsStaked and amountStakedMultipliers arrays must be equal. Each threshold defined in amountsStaked should correspond to a base multiplier in amountStakedMultipliers._

Parameters

applyVirtualAmountMultiplier

function applyVirtualAmountMultiplier(struct ContinuousVirtualAmountMultiplierFacetStorage.Layout l, uint256 campaignId, uint256 nftId, uint256 totalAmountStaked) internal returns (uint256)

Calculates and applies the respective amount multiplier to the specified position based on the campaign's configuration and the position's total staked amount of input packets.

This function returns the virtual balance of the specified position, calculated as the position's actual raw balance multiplied by the applicable amount multiplier.

Parameters

Return Values