Erc1155RewardTransferFacet

This facet handles the configuration of reward packets (output) for staking campaigns and facilitates the transfer of the assets encapsulated within these reward packets.

_This implementation is specifically designed for staking campaigns where the reward packet is constructed solely from ERC1155 tokens, and where the campaign's reward asset handler is expected to hav sufficient balance of the ERC1155 assets specified in the reward packet.

IMPORTANT:

• The campaign's reward asset handler must have sufficient balances of the ERC1155 assets specified in the reward packet, else the campaign will fail to provide the appropriate rewards.
• A reward packet can encapsulate one (e.g., tokenA of ID X) or more (e.g., tokenA of ID X, tokenA of ID Y, ..., tokenX of ID Z) ERC1155 tokens._

CampaignRewardConfigured

event CampaignRewardConfigured(uint256 campaignId, address[] tokenAddresses, uint256[] tokenIds, uint256[] amountOfTokensPerPacket)

Emitted at setCampaignTransferRewards().

CampaignRewardPacketsTransferred

event CampaignRewardPacketsTransferred(uint256 campaignId, address from, address to, uint256 amountOfPackets)

Emitted at transferReward().

setCampaignTransferRewards

function setCampaignTransferRewards(uint256 campaignId, bytes campaignTransferRewardsData) external

Setter function for configuring the reward packet for the specified staking campaign.

_Setter functions are executed during the creation process of campaigns (see CampaignCreationSkeleton.sol).

This setter function configures the reward packet for a campaign, where only ERC1155 tokens should be included.

Requirements:

• The tokenAddresses, tokenIds and amountOfTokensPerPacket arrays must have the same length.
• tokenAddresses must contain valid, non-zero ERC1155 token addresses.
• amountOfTokensPerPacket must contain non-zero values.

Emits a {CampaignRewardConfigured} event.

IMPORTANT:

• The values in amountOfTokensPerPacket should be in whole units, since ERC1155 tokens do not have decimal places.

• When using this facet, the campaign's reward asset handler must have sufficient balances of the ERC1155 assets specified in tokenAddresses, else the campaign will fail to provide the appropriate rewards. ----------------------------------------------------------------------------------------------------------------_

Parameters

transferReward

function transferReward(uint256 campaignId, address from, address to, uint256 amountOfPackets) external

Transfers the specified amount of a given campaign's reward packets from the from address to the to address.

_This function iteratively executes transfer functions for all respective amounts of ERC1155 tokens defined in the campaign's reward packet (see setCampaignTransferRewards()) in a single transaction.

The amounts to be transferred are calculated as amountOfTokensPerPacket[i] * amountOfPackets for each token in the reward packet, where i is the index of the token in the tokenAddresses array. The transfer is performed using the safeTransferFrom method of the ERC1155 token interface.

Emits a {CampaignRewardPacketsTransferred} event._

Parameters