ForceUnlockOnNonFundedSubSkeleton

Implementation of the ForceUnlockOnNonFunded sub-skeleton facet for the TMI-Fraction Protocol.

_This facet serves as a sub-core component (sub-skeleton) of a TMI-Fraction Platform, enabling eligible users (e.g., campaign issuers) to forcibly unlock and claim all wrapped assets from unsuccessful campaigns that have settled into a NON_FUNDED state.

IMPORTANT:

• This implementation is intended only for Platforms that issue campaigns capable of reaching a NON_FUNDED state.
• The wrapped assets can be any type supported by the Protocol (i.e., fungible, semi-fungible, or non-fungible).

The process of forcibly unlocking all wrapped assets from an unsuccessful campaign (i.e., in the NON_FUNDED state) is triggered when forceUnlockWrappedAssetsOnNonFunded() is called, following a sequential pipeline with three phases:

• State Check: The Platform interacts with its NonFundedState sub-internal facet to verify that the current state of the targeted campaign allows the action. This is permissible only in the NON_FUNDED state, indicating that the campaign ended unsuccessfully (e.g., failed to reach the softCap within its purchase period).

• Eligibility Check: The Platform interacts with its ForceUnlockOnNonFundedEligibility sub-internal facet to verify that the user (caller) meets the campaign's eligibility criteria (e.g., campaign creator only).

• Force Unlock Action: The Platform interacts with its DoForceUnlockOnNonFunded sub-internal facet to burn any remaining fractions of the campaign from the Platform (not owned by investors), forcibly unlock and unwrap all assets held in the campaign's Vault (i.e., the amount(s) wrapped at the campaign's creation), and transfer them to the eligible user._

ForceUnlockOnNonFundedHappened

event ForceUnlockOnNonFundedHappened(uint256 campaignId, address receiver)

Emitted at forceUnlockWrappedAssetsOnNonFunded().

forceUnlockWrappedAssetsOnNonFunded

function forceUnlockWrappedAssetsOnNonFunded(uint256 campaignId) external

Forcibly unlocks and transfers all the wrapped assets of a failed campaign to the caller (user) while burning all unpurchased fractions (i.e., those not owned by the campaign's investors).

_Users must meet eligibility criteria (see forceUnlockOnNonFunded Eligibility sub-internal facets).

This action is only permissible after the campaign's purchase period has ended unsuccessfully (i.e., when the campaign is in the NON_FUNDED state)._

Parameters