OraclePriceFacet

Manages the configuration of fraction pricing in terms of funding packets (a.k.a input packets) within fractionalization campaigns. It defines the number of funding packets required to obtain a single fraction per campaign.

_This PriceFacet implementation is intended for campaigns where the price of fractions are set by an Oracle and may vary throughout the campaign lifecycle. Each campaign is configured separately.

IMPORTANT:

• Extra care should be taken when setting the oracle address (see setAndCheckPriceFacet()) as it is closely tied to the configuration of the campaign's funding packet (see FundingPackets facets)._

OracleAddressConfigured

event OracleAddressConfigured(address oracleAddress)

Emitted at setAndCheckPriceFacet().

UnauthorizedInitialization

error UnauthorizedInitialization(address account)

Thrown when trying to initialize from non admin account.

initPriceFacet

function initPriceFacet(bytes initPriceData) external

setAndCheckPriceFacet

function setAndCheckPriceFacet(bytes postFractionPriceData) external

Sets the oracle address cappable to set the price of a fraction, in terms of funding packets, for a campaign.

_Defines the oracle address as the address that is allowed to set the price of a fraction in an associated campaign.

Emits a {OracleAddressConfigured} event._

Parameters

setPrice

function setPrice(uint256 campaignId, uint256 price) external

Sets the price of a fraction, in terms of funding packets, for a campaign.

_Defines the price as the number of funding packets required to purchase a single fraction in an associated campaign.

This function is callable only by the oracle address set in setAndCheckPriceFacet().

Emits a {CampaignPriceConfigured} event.

IMPORTANT:

There are two ways to configure price and funding packets at the API level, depending on the decimal precision of tokens in the campaign's funding packet:

1. Uniform Decimal Precision (All funding tokens have the same decimal precision—no mixed ERCs allowed):

   • Either:
     • Set the funding packet's tokenAmount values (see FundingPackets Facets) in whole units (e.g., 2 wei).
     • Set price scaled by the token’s decimal precision (e.g., for 6 decimals, price = 10 * 10^6).
   • Or:
     • Set tokenAmount values already scaled by the decimal precision (e.g., 2 * 10^6).
     • Set price in whole units (e.g., price = 10).

2. Mixed Decimal Precision (Funding tokens have different decimal precision-mixed ERCs allowed):

   • The tokenAmount values in the funding packet must always be scaled to the respective decimal precision.
   • The price must be set in whole units.

Discount & Interest Mechanisms:

• If discount & interest mechanisms are configured, the tokenAmount(s) of funding packet must be defined in whole units (e.g., 2 wei), and price must always be scaled according to the funding token decimal precision (e.g., for 6 decimals, price = 10 * 10^6). This requirement should be enforced at the API level and within front-end applications.

• To prevent truncation, price should be scaled by at least 1e6, considering that percentages are 1e6 scaled.

• This ensures that percentage-based discount & interest mechanisms (e.g., BurnFungibleForDiscount) can correctly compute discounted and interest-adjusted prices without truncation. Percentages are based on 10^6, meaning 10^6 == 100%.

Example:

• If the campaign's funding packet has been configured (see FundingPackets Facets) as 2 wei of $TOKEN (suppose $TOKEN has 18 decimals), and price == 1 * 10^18, then to purchase a single fraction, investors will need to provide 10^18 funding packets which corresponds to 2 $TOKEN per fraction (2 wei * 10^18 == 2 * 10^18)._

Parameters

getPurchasePrice

function getPurchasePrice(uint256 campaignId, uint256, bytes) external view returns (uint256)

getCurrentPrice

function getCurrentPrice(uint256 campaignId) external view returns (uint256)

Retrieves the price of a single fraction within a specified campaign.

Parameters

Return Values