ReferenceCurve_v1

Enhanced version of BC_Discrete_Redeeming_VirtualSupply that enforces specific referenceCurve segment rules and provides collateral-based referenceCurve management. Source: src/core/issuance/ReferenceCurve_v1.sol. Interfaces: IReferenceCurve_v1, IBC_Discrete_Redeeming_VirtualSupply_v1, IRedeemingIssuanceBase_v2, IIssuanceBase_v2, IVirtualCollateralSupplyBase_v1.

Functions

buy

function buy(uint depositAmount_, uint minAmountOut_) external returns (uint issuanceTokenAmount_);

Buy tokens for the sender’s address. Parameters

Name	Type	Description
`depositAmount_`	`uint`	The amount of collateral token depoisited.
`minAmountOut_`	`uint`	The minimum acceptable amount the user expects to receive from the transaction.

Returns

Name	Type	Description
`issuanceTokenAmount_`	`uint`	The amount of issuance tokens minted.

IIssuanceBase_v2.sol#L141

buyFor

function buyFor(
    address receiver_,
    uint depositAmount_,
    uint minAmountOut_
) external returns (uint issuanceTokenAmount_);

Buy tokens on behalf of a specified receiver address. Parameters

Name	Type	Description
`receiver_`	`address`	The address that will receive the bought tokens.
`depositAmount_`	`uint`	The amount of collateral token deposited.
`minAmountOut_`	`uint`	The minimum acceptable amount the user expects to receive from the transaction.

Returns

Name	Type	Description
`issuanceTokenAmount_`	`uint`	The amount of issuance tokens minted.

IIssuanceBase_v2.sol#L130

calculatePurchaseReturn

function calculatePurchaseReturn(uint depositAmount_) external returns (uint mintAmount_);

Calculates the amount of tokens to be minted based on a given deposit amount. Parameters

Name	Type	Description
`depositAmount_`	`uint`	The amount of tokens deposited by the user.

Returns

Name	Type	Description
`mintAmount_`	`uint`	The amount of new tokens that will be minted as a result of the deposit.

IIssuanceBase_v2.sol#L112

disableBuy

function disableBuy() external;

Closes the buying functionality for the token. IIssuanceBase_v2.sol#L154

disableSell

function disableSell() external;

Closes the selling functionality for the collateral. IRedeemingIssuanceBase_v2.sol#L136

drawReserves

function drawReserves(uint amount_, address to_) external;

Transfers collateral tokens to to_ without modifying virtual collateral supply. Only the bound ReserveManager may call. Parameters

Name	Type	Description
`amount_`	`uint`	The amount of collateral tokens to transfer.
`to_`	`address`	The recipient of the collateral.

IBC_Discrete_Redeeming_VirtualSupply_v1.sol#L172

elevate

function elevate(uint reserveAmount_) external;

Increases the referenceCurve by injecting collateral and dynamically absorbing premium steps. Parameters

Name	Type	Description
`reserveAmount_`	`uint`	The amount of collateral to inject. Actual amount transferred may be less due to rounding (dust).

IReferenceCurve_v1.sol#L324

enableBuy

function enableBuy() external;

Opens the buying functionality for the token. IIssuanceBase_v2.sol#L150

enableBuy

function enableBuy(uint expectedEpoch_) external;

Opens buying if no disable happened since the call was prepared. Parameters

Name	Type	Description
`expectedEpoch_`	`uint`	The buy disable epoch read when the call was prepared. Reverts unless it equals the current epoch.

IReferenceCurve_v1.sol#L264

enableSell

function enableSell() external;

Opens the selling functionality for the collateral. IRedeemingIssuanceBase_v2.sol#L131

enableSell

function enableSell(uint expectedEpoch_) external;

Opens selling if no disable happened since the call was prepared. Parameters

Name	Type	Description
`expectedEpoch_`	`uint`	The sell disable epoch read when the call was prepared. Reverts unless it equals the current epoch.

IReferenceCurve_v1.sol#L270

reconfigureSegments

function reconfigureSegments(
    PackedSegment[] calldata newSegments_,
    uint suppliedCollateral_,
    bool selfSupplied_
) external;

Reconfigures the segments of the discrete bonding curve. Parameters

Name	Type	Description
`newSegments_`	`PackedSegment[]`	The new array of PackedSegment structs.
`suppliedCollateral_`	`uint`	The amount of collateral to supply to the FM.
`selfSupplied_`	`bool`	If true, collateral must already be in the contract’s balance; if false, pulled from caller.

IBC_Discrete_Redeeming_VirtualSupply_v1.sol#L140

restoreReserves

function restoreReserves(uint amount_, address from_) external;

Pulls collateral tokens from from_ without modifying virtual collateral supply. Only the bound ReserveManager may call. Parameters

Name	Type	Description
`amount_`	`uint`	The amount of collateral tokens to receive.
`from_`	`address`	The source the collateral is pulled from.

IBC_Discrete_Redeeming_VirtualSupply_v1.sol#L188

sell

function sell(uint depositAmount_, uint minAmountOut_) external returns (uint receivedAmount_);

Redeem collateral for the sender’s address. Parameters

Name	Type	Description
`depositAmount_`	`uint`	The amount of issued token deposited.
`minAmountOut_`	`uint`	The minimum acceptable amount the user expects to receive from the transaction.

Returns

Name	Type	Description
`receivedAmount_`	`uint`	The net collateral amount transferred to the sender.

IRedeemingIssuanceBase_v2.sol#L121

sellTo

function sellTo(
    address receiver_,
    uint depositAmount_,
    uint minAmountOut_
) external returns (uint receivedAmount_);

Redeem tokens and direct the proceeds to a specified receiver address. Parameters

Name	Type	Description
`receiver_`	`address`	The address that will receive the redeemed tokens.
`depositAmount_`	`uint`	The amount of tokens to be sold.
`minAmountOut_`	`uint`	The minimum acceptable amount of proceeds that the receiver should receive from the sale.

Returns

Name	Type	Description
`receivedAmount_`	`uint`	The net collateral amount transferred to the receiver.

IRedeemingIssuanceBase_v2.sol#L110

setBuyFee

function setBuyFee(uint fee_) external;

Sets the fee percentage for buying tokens, payed in collateral. Parameters

Name	Type	Description
`fee_`	`uint`	The fee in basis points.

IIssuanceBase_v2.sol#L158

setEndowmentSetupOpen

function setEndowmentSetupOpen(bool open_) external;

Parameters

Name	Type	Description
`open_`	`bool`

IReferenceCurve_v1.sol#L246

setReferenceSellController

function setReferenceSellController(address controller_) external;

Parameters

Name	Type	Description
`controller_`	`address`

IReferenceCurve_v1.sol#L247

setReferenceSellsClosed

function setReferenceSellsClosed(bool closed_) external;

Parameters

Name	Type	Description
`closed_`	`bool`

IReferenceCurve_v1.sol#L248

setSellFee

function setSellFee(uint fee_) external;

Sets the fee percentage for selling collateral, payed in collateral. Parameters

Name	Type	Description
`fee_`	`uint`	The fee in basis points.

IRedeemingIssuanceBase_v2.sol#L144

setVirtualCollateralSupply

function setVirtualCollateralSupply(uint newSupply_) external;

Disabled in this implementation. Manual virtual collateral supply overrides are prohibited in all states, including while trading is closed and before any issuance. The external selector is retained for ABI stability, but every authorized call reverts with Module__BC_Discrete_Redeeming_VirtualSupply__ManualVirtualSupplyOverrideDisabled. Initialization and internal automatic accounting remain intact: buys, sells, elevation, and collateral supplied through segment reconfiguration update virtual collateral supply. ReserveManager drawReserves and restoreReserves intentionally leave it unchanged; reserve liabilities are tracked separately. Parameters

Name	Type	Description
`newSupply_`	`uint`	Ignored; retained for ABI stability.

IBC_Discrete_Redeeming_VirtualSupply_v1.sol#L161

View functions

areReferenceSellsClosed

function areReferenceSellsClosed() external view returns (bool closed_);

Returns

Name	Type	Description
`closed_`	`bool`

IReferenceCurve_v1.sol#L245

calculateSaleReturn

function calculateSaleReturn(uint depositAmount_) external view returns (uint redeemAmount_);

Calculates the amount of tokens to be redeemed based on a given deposit amount. Parameters

Name	Type	Description
`depositAmount_`	`uint`	The amount of tokens deposited by the user.

Returns

Name	Type	Description
`redeemAmount_`	`uint`	The amount of collateral that will be redeemed as a result of the deposit.

IRedeemingIssuanceBase_v2.sol#L89

getBuyFee

function getBuyFee() external view returns (uint buyFee_);

Returns the current buy fee in basis points. Returns

Name	Type	Description
`buyFee_`	`uint`	The current buy fee in basis points.

IIssuanceBase_v2.sol#L86

getCollateralToken

function getCollateralToken() external view returns (address collateralToken_);

Returns the address of the collateral token. Returns

Name	Type	Description
`collateralToken_`	`address`	The address of the collateral token.

IIssuanceBase_v2.sol#L94

getDisableEpochs

function getDisableEpochs() external view returns (uint buyEpoch_, uint sellEpoch_);

Returns the disable epochs. Each {disableBuy} increments the buy epoch and each {disableSell} the sell epoch. {enableBuy} and {enableSell} must pass the current value. Returns

Name	Type	Description
`buyEpoch_`	`uint`	The buy disable epoch.
`sellEpoch_`	`uint`	The sell disable epoch.

IReferenceCurve_v1.sol#L255

getIssuanceToken

function getIssuanceToken() external view returns (address issuanceToken_);

Returns the address of the issuance token. Returns

Name	Type	Description
`issuanceToken_`	`address`	The address of the issuance token.

IIssuanceBase_v2.sol#L90

getPremiumSections

function getPremiumSections() external view returns (PackedSegment[] memory premiumSections_);

Returns all premium sections (segments after the referenceCurve). Returns

Name	Type	Description
`premiumSections_`	`PackedSegment[]`	Array of all segments except the first one.

IReferenceCurve_v1.sol#L281

getReferenceMetrics

function getReferenceMetrics() external view returns (uint referencePrice_, uint referenceSupply_, uint currentSupply_, uint nextPremiumPrice_);

Returns comprehensive referenceCurve metrics. Returns

Name	Type	Description
`referencePrice_`	`uint`	Current reference price.
`referenceSupply_`	`uint`	Supply capacity of referenceCurve segment.
`currentSupply_`	`uint`	Current total supply.
`nextPremiumPrice_`	`uint`	Price of next premium step (0 if none).

IReferenceCurve_v1.sol#L299

getReferencePrice

function getReferencePrice() external view returns (uint referencePrice_);

Returns the reference price of the bonding curve. Returns

Name	Type	Description
`referencePrice_`	`uint`	The reference price (first segment’s initial price) in collateral token (18 decimals).

IReferenceCurve_v1.sol#L292

getReferenceSection

function getReferenceSection() external view returns (PackedSegment referenceSection_);

Returns the referenceCurve section (first segment) of the bonding curve. Returns

Name	Type	Description
`referenceSection_`	`PackedSegment`	The first segment representing the referenceCurve.

IReferenceCurve_v1.sol#L274

getReferenceSellController

function getReferenceSellController() external view returns (address controller_);

Returns

Name	Type	Description
`controller_`	`address`

IReferenceCurve_v1.sol#L241

getSegments

function getSegments() external view returns (PackedSegment[] memory segments_);

Returns the current configuration of the bonding curve segments. Returns

Name	Type	Description
`segments_`	`PackedSegment[]`	The array of PackedSegment structs defining the bonding curve.

IBC_Discrete_Redeeming_VirtualSupply_v1.sol#L102

getSellFee

function getSellFee() external view returns (uint fee_);

Returns the current sell fee in basis points. Returns

Name	Type	Description
`fee_`	`uint`	The current sell fee in basis points.

IRedeemingIssuanceBase_v2.sol#L71

getStaticPriceForBuying

function getStaticPriceForBuying() external view returns (uint price_);

Returns the static price for buying one unit of the issuance token. Returns

Name	Type	Description
`price_`	`uint`	The price to buy one unit.

IBC_Discrete_Redeeming_VirtualSupply_v1.sol#L111

getStaticPriceForSelling

function getStaticPriceForSelling() external view returns (uint price_);

Returns the static price for selling one unit of the issuance token. Returns

Name	Type	Description
`price_`	`uint`	The price to sell one unit.

IBC_Discrete_Redeeming_VirtualSupply_v1.sol#L117

getVirtualCollateralSupply

function getVirtualCollateralSupply() external view returns (uint virtualCollateralSupply_);

Returns the current virtual collateral supply. Returns

Name	Type	Description
`virtualCollateralSupply_`	`uint`	The current virtual collateral supply.

IVirtualCollateralSupplyBase_v1.sol#L64

isBuyOpen

function isBuyOpen() external view returns (bool isOpen_);

Returns whether the buying functionality is open or closed. Returns

Name	Type	Description
`isOpen_`	`bool`	True if buying is open, false if closed.

IIssuanceBase_v2.sol#L82

isEndowmentSetupOpen

function isEndowmentSetupOpen() external view returns (bool open_);

Returns

Name	Type	Description
`open_`	`bool`

IReferenceCurve_v1.sol#L240

isSellOpen

function isSellOpen() external view returns (bool isOpen_);

Returns whether the selling functionality is open or closed. Returns

Name	Type	Description
`isOpen_`	`bool`	True if selling is open, false if closed.

IRedeemingIssuanceBase_v2.sol#L67

maxElevatable

function maxElevatable() external view returns (uint maxReserve_);

The largest collateral budget {elevate} accepts right now without reverting — a bounded chunk (raises the reference price up to, but not into, the final premium step, and across at most a fixed number of steps per call); 0 when no productive elevation is possible. Use the explicit-cap overload for a limited balance: smaller budgets are not necessarily funded. Returns

Name	Type	Description
`maxReserve_`	`uint`	The maximum non-reverting, productive elevate budget.

IReferenceCurve_v1.sol#L333

maxElevatable

function maxElevatable(uint cap_) external view returns (uint maxReserve_);

Selects the greatest funded, productive executable budget at or below cap_, within the same bounded chunk as maxElevatable(). Parameters

Name	Type	Description
`cap_`	`uint`	Maximum collateral budget available for this call.

Returns

Name	Type	Description
`maxReserve_`	`uint`	The selected budget; zero if none is eligible.

IReferenceCurve_v1.sol#L339

Events

BuyFeeUpdated

event BuyFeeUpdated(uint newBuyFee_, uint oldBuyFee_);

Event emitted when buy fee is updated. Parameters

Name	Type	Description
`newBuyFee_`	`uint`	The new buy fee in basis points.
`oldBuyFee_`	`uint`	The old buy fee in basis points.

IIssuanceBase_v2.sol#L52

BuyingDisabled

event BuyingDisabled();

Event emitted when buying is closed. IIssuanceBase_v2.sol#L47

BuyingEnabled

event BuyingEnabled();

Event emitted when buying is opened. IIssuanceBase_v2.sol#L44

CollateralDeposited

event CollateralDeposited(address indexed sender_, uint amount_, uint newVirtualSupply_);

Emitted when collateral is deposited (repaid) to reserves. Parameters

Name	Type	Description
`sender_`	`address indexed`	The address depositing the collateral.
`amount_`	`uint`	The amount of collateral deposited.
`newVirtualSupply_`	`uint`	The virtual collateral supply after deposit.

IBC_Discrete_Redeeming_VirtualSupply_v1.sol#L92

CollateralTokenSet

event CollateralTokenSet(address indexed collateralToken_, uint8 decimals_);

Event emitted when the collateral token is updated. Parameters

Name	Type	Description
`collateralToken_`	`address indexed`	The address of the collateral token.
`decimals_`	`uint8`

IIssuanceBase_v2.sol#L61

CollateralWithdrawn

event CollateralWithdrawn(address indexed recipient_, uint amount_, uint newVirtualSupply_);

Emitted when collateral is withdrawn (lent out) from reserves. Parameters

Name	Type	Description
`recipient_`	`address indexed`	The address receiving the collateral.
`amount_`	`uint`	The amount of collateral withdrawn.
`newVirtualSupply_`	`uint`	The virtual collateral supply after withdrawal.

IBC_Discrete_Redeeming_VirtualSupply_v1.sol#L84

Elevated

event Elevated(
    uint oldReferencePrice_,
    uint newReferencePrice_,
    uint collateralConsumed_,
    uint supplyIncrease_
);

Emitted when the reference price is increased. Parameters

Name	Type	Description
`oldReferencePrice_`	`uint`	The previous reference price.
`newReferencePrice_`	`uint`	The new reference price after increase.
`collateralConsumed_`	`uint`	The actual amount of collateral consumed.
`supplyIncrease_`	`uint`	The increase in referenceCurve segment supply.

IReferenceCurve_v1.sol#L205

ElevationSurplusAbsorbed

event ElevationSurplusAbsorbed(uint surplus_);

Emitted by {elevate} when virtual collateral above the reserve of the current segments (surplus) pays for part of the floor rise. Elevated.collateralConsumed_ stays the amount pulled from the caller. Parameters

Name	Type	Description
`surplus_`	`uint`	The surplus absorbed into the new segments.

IReferenceCurve_v1.sol#L217

EndowmentSetupStateChanged

event EndowmentSetupStateChanged(bool open_);

Parameters

Name	Type	Description
`open_`	`bool`

IReferenceCurve_v1.sol#L44

IssuanceTokenSet

event IssuanceTokenSet(address indexed issuanceToken_, uint8 decimals_);

Event emitted when the issuance token is updated. Parameters

Name	Type	Description
`issuanceToken_`	`address indexed`	The address of the issuance token.
`decimals_`	`uint8`	The number of decimals of the issuance token.

IIssuanceBase_v2.sol#L57

ReferenceAdjustedToSupply

event ReferenceAdjustedToSupply(uint supply_);

Emitted when the referenceCurve is adjusted to fit the supply. Parameters

Name	Type	Description
`supply_`	`uint`	The supply the referenceCurve was adjusted to fit.

IReferenceCurve_v1.sol#L198

ReferencePriceUpdated

event ReferencePriceUpdated(uint referencePrice_);

Emitted when the reference price is updated. Parameters

Name	Type	Description
`referencePrice_`	`uint`	The new reference price.

IReferenceCurve_v1.sol#L221

ReferenceSellControllerSet

event ReferenceSellControllerSet(address indexed controller_);

Parameters

Name	Type	Description
`controller_`	`address indexed`

IReferenceCurve_v1.sol#L45

ReferenceSellsClosed

event ReferenceSellsClosed(address indexed caller_, bool closed_);

Parameters

Name	Type	Description
`caller_`	`address indexed`
`closed_`	`bool`

IReferenceCurve_v1.sol#L46

SegmentsSet

event SegmentsSet(PackedSegment[] segments_);

Emitted when the bonding curve segments are set or updated. Parameters

Name	Type	Description
`segments_`	`PackedSegment[]`	The array of PackedSegment structs defining the bonding curve.

IBC_Discrete_Redeeming_VirtualSupply_v1.sol#L78

SellFeeUpdated

event SellFeeUpdated(uint newSellFee_, uint oldSellFee_);

Event emitted when sell fee is updated. Parameters

Name	Type	Description
`newSellFee_`	`uint`	The new sell fee.
`oldSellFee_`	`uint`	The old sell fee.

IRedeemingIssuanceBase_v2.sol#L46

SellingDisabled

event SellingDisabled();

Event emitted when selling is closed. IRedeemingIssuanceBase_v2.sol#L41

SellingEnabled

event SellingEnabled();

Event emitted when selling is opened. IRedeemingIssuanceBase_v2.sol#L38

SpotToleranceBpsUpdated

event SpotToleranceBpsUpdated(uint oldSpotToleranceBps_, uint newSpotToleranceBps_);

Emitted when the spot tolerance used by rebalances changes. Parameters

Name	Type	Description
`oldSpotToleranceBps_`	`uint`	The previous tolerance in basis points.
`newSpotToleranceBps_`	`uint`	The new tolerance in basis points.

IReferenceCurve_v1.sol#L233

TerminalLeftoverSentToFeeTreasury

event TerminalLeftoverSentToFeeTreasury(uint amount_);

Emitted when a terminal sell (supply 0, every ReserveManager liability 0) clears the virtual collateral supply and sends the collateral left on the curve to the fee treasury. Parameters

Name	Type	Description
`amount_`	`uint`	The collateral sent to the fee treasury.

IReferenceCurve_v1.sol#L228

TokensBought

event TokensBought(
    address indexed receiver_,
    uint depositAmount_,
    uint receivedAmount_,
    address buyer_,
    uint priceAfterBuy_
);

Event emitted when tokens have been succesfully issued. Parameters

Name	Type	Description
`receiver_`	`address indexed`	The address that will receive the issued tokens.
`depositAmount_`	`uint`	The amount of collateral token deposited.
`receivedAmount_`	`uint`	The amount of issued token received.
`buyer_`	`address`	The address that initiated the buy order.
`priceAfterBuy_`	`uint`	The price of the issuance token after the buy order.

IIssuanceBase_v2.sol#L69

TokensSold

event TokensSold(
    address indexed receiver_,
    uint depositAmount_,
    uint receivedAmount_,
    address seller_,
    uint priceAfterSell_
);

Event emitted when tokens have been succesfully redeemed. Parameters

Name	Type	Description
`receiver_`	`address indexed`	The address that will receive the redeemed tokens.
`depositAmount_`	`uint`	The amount of issued token deposited.
`receivedAmount_`	`uint`	The amount of collateral token received.
`seller_`	`address`	The address that initiated the sell order.
`priceAfterSell_`	`uint`	The price of the issuance token after the sell order.

IRedeemingIssuanceBase_v2.sol#L54

VirtualCollateralAmountAdded

event VirtualCollateralAmountAdded(uint amountAdded_, uint newSupply_);

Event emitted when virtual collateral amount has been added. Parameters

Name	Type	Description
`amountAdded_`	`uint`	The amount that was added to the virtual supply.
`newSupply_`	`uint`	The resulting virtual collateral supply value.

IVirtualCollateralSupplyBase_v1.sol#L38

VirtualCollateralAmountSubtracted

event VirtualCollateralAmountSubtracted(uint amountSubtracted_, uint newSupply_);

Event emitted when virtual collateral amount has been subtracted. Parameters

Name	Type	Description
`amountSubtracted_`	`uint`	The amount that was subtracted from the supply.
`newSupply_`	`uint`	The resulting virtual collateral supply value.

IVirtualCollateralSupplyBase_v1.sol#L45

VirtualCollateralSupplySet

event VirtualCollateralSupplySet(uint newSupply_, uint oldSupply_);

Event emitted when virtual collateral supply has been set. Parameters

Name	Type	Description
`newSupply_`	`uint`	The newly set virtual collateral supply value.
`oldSupply_`	`uint`	The previous virtual collateral supply value.

IVirtualCollateralSupplyBase_v1.sol#L33

Errors

Module__BC_Discrete_Redeeming_VirtualSupply__CurveInteractionsOpen

error Module__BC_Discrete_Redeeming_VirtualSupply__CurveInteractionsOpen();

Legacy error retained for ABI compatibility. IBC_Discrete_Redeeming_VirtualSupply_v1.sol#L59

Module__BC_Discrete_Redeeming_VirtualSupply__InsufficientCollateralBalance

error Module__BC_Discrete_Redeeming_VirtualSupply__InsufficientCollateralBalance(
    uint actualBalance_,
    uint requiredBalance_
);

Thrown when selfSupplied reconfiguration claims more collateral than the contract actually holds in excess of the current virtual supply. Parameters

Name	Type	Description
`actualBalance_`	`uint`	The real token balance of the contract.
`requiredBalance_`	`uint`	The minimum balance needed (virtualSupply + suppliedCollateral).

IBC_Discrete_Redeeming_VirtualSupply_v1.sol#L48

Module__BC_Discrete_Redeeming_VirtualSupply__InvarianceCheckFailed

error Module__BC_Discrete_Redeeming_VirtualSupply__InvarianceCheckFailed(
    uint newCalculatedReserve_,
    uint currentVirtualCollateralSupply_
);

Thrown when a curve reconfiguration fails the invariance check. Parameters

Name	Type	Description
`newCalculatedReserve_`	`uint`	The collateral reserve calculated for the new segments.
`currentVirtualCollateralSupply_`	`uint`	The current virtual collateral supply.

IBC_Discrete_Redeeming_VirtualSupply_v1.sol#L38

Module__BC_Discrete_Redeeming_VirtualSupply__ManualVirtualSupplyOverrideDisabled

error Module__BC_Discrete_Redeeming_VirtualSupply__ManualVirtualSupplyOverrideDisabled();

Thrown whenever a manual virtual collateral supply override is attempted. IBC_Discrete_Redeeming_VirtualSupply_v1.sol#L70

Module__BC_Discrete_Redeeming_VirtualSupply__OnlyReserveManager

error Module__BC_Discrete_Redeeming_VirtualSupply__OnlyReserveManager();

Thrown when a reserve-gate selector is called by anyone other than the bound ReserveManager. IBC_Discrete_Redeeming_VirtualSupply_v1.sol#L54

ModuleIssuanceBaseBuyingFunctionaltiesClosed

error Module__IssuanceBase__BuyingFunctionaltiesClosed();

Buying functionalities are set to closed. IIssuanceBase_v2.sol#L18

ModuleIssuanceBaseInsufficientOutputAmount

error Module__IssuanceBase__InsufficientOutputAmount();

Actual buy amount is lower than the minimum acceptable amount. IIssuanceBase_v2.sol#L25

ModuleIssuanceBaseInvalidDepositAmount

error Module__IssuanceBase__InvalidDepositAmount();

Deposit amount has to be larger than zero. IIssuanceBase_v2.sol#L12

ModuleIssuanceBaseInvalidFeePercentage

error Module__IssuanceBase__InvalidFeePercentage();

Percentage amount is bigger than 100%, i.e. 10_000. IIssuanceBase_v2.sol#L9

ModuleIssuanceBaseInvalidIssuanceToken

error Module__IssuanceBase__InvalidIssuanceToken(address issuanceToken_);

The issuance token is not a curve-bound token of this curve. Parameters

Name	Type	Description
`issuanceToken_`	`address`	The rejected issuance token.

IIssuanceBase_v2.sol#L38

ModuleIssuanceBaseInvalidMinAmountOut

error Module__IssuanceBase__InvalidMinAmountOut();

The minimum amount out cannot be zero. IIssuanceBase_v2.sol#L32

ModuleIssuanceBaseInvalidRecipient

error Module__IssuanceBase__InvalidRecipient();

Receiver address can not be zero address or. Bonding Curve Funding Manager itself. IIssuanceBase_v2.sol#L22

ModuleIssuanceBaseInvalidWithdrawAmount

error Module__IssuanceBase__InvalidWithdrawAmount();

Withdraw amount has to be larger than zero. IIssuanceBase_v2.sol#L15

ModuleIssuanceBaseTradeAmountTooLow

error Module__IssuanceBase__TradeAmountTooLow();

Buy amount in relation to fee percentage to small, results in round down fee amount to zero. IIssuanceBase_v2.sol#L29

ModuleRedeemingIssuanceBaseInsufficientCollateralForProjectFee

error Module__RedeemingIssuanceBase__InsufficientCollateralForProjectFee();

Insufficient collateral tokens are held to cover the project collateral fee. IRedeemingIssuanceBase_v2.sol#L32

ModuleRedeemingIssuanceBaseSellingFunctionaltiesClosed

error Module__RedeemingIssuanceBase__SellingFunctionaltiesClosed();

Selling functionalities are set to closed. IRedeemingIssuanceBase_v2.sol#L28

ModuleReferenceCurveCapacityAboveTokenCap

error Module__ReferenceCurve__CapacityAboveTokenCap(uint capacity_, uint cap_);

Thrown when a segment update would give the curve more capacity than the issuance token cap. Parameters

Name	Type	Description
`capacity_`	`uint`	The total capacity of the new segments.
`cap_`	`uint`	The issuance token cap.

IReferenceCurve_v1.sol#L147

ModuleReferenceCurveCollateralTooSmall

error Module__ReferenceCurve__CollateralTooSmall(uint provided_, uint minimum_);

Thrown when collateral amount is too small to cause a price increase. Parameters

Name	Type	Description
`provided_`	`uint`	The collateral amount provided.
`minimum_`	`uint`	The minimum collateral required.

IReferenceCurve_v1.sol#L72

ModuleReferenceCurveCurveInteractionsOpen

error Module__ReferenceCurve__CurveInteractionsOpen();

Thrown when manual segment reconfiguration is attempted while buying or selling remains enabled. IReferenceCurve_v1.sol#L82

ModuleReferenceCurveDisableEpochMismatch

error Module__ReferenceCurve__DisableEpochMismatch(uint expectedEpoch_, uint currentEpoch_);

{enableBuy} or {enableSell} was called with a disable epoch that is not the current one: a disable happened after the call was prepared. Parameters

Name	Type	Description
`expectedEpoch_`	`uint`	The epoch the caller expected.
`currentEpoch_`	`uint`	The current disable epoch.

IReferenceCurve_v1.sol#L165

ModuleReferenceCurveDisableEpochRequired

error Module__ReferenceCurve__DisableEpochRequired();

The no-argument enableBuy() and enableSell() are removed on this curve. Use enableBuy(uint256) or enableSell(uint256) with the current disable epoch. IReferenceCurve_v1.sol#L172

ModuleReferenceCurveInsufficientPremiumSteps

error Module__ReferenceCurve__InsufficientPremiumSteps();

Thrown when attempting to increase the referenceCurve but segment 2 has only 1 step. IReferenceCurve_v1.sol#L52

ModuleReferenceCurveInsufficientSegments

error Module__ReferenceCurve__InsufficientSegments();

Thrown when the segments array has fewer than 2 segments. IReferenceCurve_v1.sol#L55

ModuleReferenceCurveInvalidReferenceSegment

error Module__ReferenceCurve__InvalidReferenceSegment(uint numberOfSteps_, uint priceIncrease_);

Thrown when the first segment doesn’t meet referenceCurve requirements. Parameters

Name	Type	Description
`numberOfSteps_`	`uint`	The number of steps in the first segment (must be 1).
`priceIncrease_`	`uint`	The price increase in the first segment (must be 0).

IReferenceCurve_v1.sol#L60

ModuleReferenceCurveInvalidSpotTolerance

error Module__ReferenceCurve__InvalidSpotTolerance(uint spotToleranceBps_);

Thrown when the spot tolerance is above 100% (10_000 bps). Parameters

Name	Type	Description
`spotToleranceBps_`	`uint`	The rejected tolerance in basis points.

IReferenceCurve_v1.sol#L133

ModuleReferenceCurveNoElevation

error Module__ReferenceCurve__NoElevation();

Thrown when attempting to increase referenceCurve but no collateral is actually needed. IReferenceCurve_v1.sol#L66

ModuleReferenceCurveNoIssuanceSupply

error Module__ReferenceCurve__NoIssuanceSupply();

Thrown when elevate is called before any issuance supply exists (would divide by zero in the absorption algorithm). IReferenceCurve_v1.sol#L78

ModuleReferenceCurveRebalanceCapacityBelowSupply

error Module__ReferenceCurve__RebalanceCapacityBelowSupply(uint supply_, uint capacity_);

Thrown when a rebalance leaves the curve capacity below the current issuance supply. Parameters

Name	Type	Description
`supply_`	`uint`	The current total issuance supply.
`capacity_`	`uint`	The total capacity of the proposed segments.

IReferenceCurve_v1.sol#L104

ModuleReferenceCurveRebalanceCollateralMismatch

error Module__ReferenceCurve__RebalanceCollateralMismatch();

Thrown when virtual collateral does not increase by exactly the supplied collateral during a rebalance. Unreachable through the production path. It is a post-condition guard, so no arguments are carried. IReferenceCurve_v1.sol#L129

ModuleReferenceCurveRebalanceDeadlinePassed

error Module__ReferenceCurve__RebalanceDeadlinePassed(uint deadline_);

{rebalanceSegments} ran after its deadline. Parameters

Name	Type	Description
`deadline_`	`uint`	The deadline of the call.

IReferenceCurve_v1.sol#L176

ModuleReferenceCurveRebalanceReferenceDecreased

error Module__ReferenceCurve__RebalanceReferenceDecreased(
    uint currentReferencePrice_,
    uint newReferencePrice_
);

Thrown when a rebalance lowers the reference price. Applies even when no issuance or reserve liabilities exist. Parameters

Name	Type	Description
`currentReferencePrice_`	`uint`	The current reference price.
`newReferencePrice_`	`uint`	The proposed reference price.

IReferenceCurve_v1.sol#L96

ModuleReferenceCurveRebalanceReserveDecreased

error Module__ReferenceCurve__RebalanceReserveDecreased(uint oldReserve_, uint newReserve_);

Thrown when a rebalance lowers the reserve that backs the current issuance supply (check B6). Parameters

Name	Type	Description
`oldReserve_`	`uint`	The reserve for the current supply before.
`newReserve_`	`uint`	The reserve for the current supply after.

IReferenceCurve_v1.sol#L139

ModuleReferenceCurveRebalanceSpotDecreased

error Module__ReferenceCurve__RebalanceSpotDecreased(uint currentSpotPrice_, uint newSpotPrice_);

Thrown when a rebalance lowers the spot price at the current issuance supply (LRE Stage 1, I3). Parameters

Name	Type	Description
`currentSpotPrice_`	`uint`	The spot price before the rebalance.
`newSpotPrice_`	`uint`	The spot price after the rebalance.

IReferenceCurve_v1.sol#L112

ModuleReferenceCurveRebalanceSpotMoved

error Module__ReferenceCurve__RebalanceSpotMoved(
    uint currentSpotPrice_,
    uint newSpotPrice_,
    uint spotToleranceBps_
);

Thrown when a rebalance raises the spot price at the current supply by more than the spot tolerance (B4). Parameters

Name	Type	Description
`currentSpotPrice_`	`uint`	The spot price before the rebalance.
`newSpotPrice_`	`uint`	The spot price after the rebalance.
`spotToleranceBps_`	`uint`	The configured tolerance in basis points.

IReferenceCurve_v1.sol#L121

ModuleReferenceCurveRebalanceStateMismatch

error Module__ReferenceCurve__RebalanceStateMismatch(
    bytes32 expectedSegmentsHash_,
    bytes32 segmentsHash_,
    uint expectedVirtualCollateral_,
    uint virtualCollateral_
);

The curve state is not the state that {rebalanceSegments} was prepared for. A retried or stale call fails closed before any collateral is pulled. Parameters

Name	Type	Description
`expectedSegmentsHash_`	`bytes32`	The segments hash the caller expected.
`segmentsHash_`	`bytes32`	The current segments hash.
`expectedVirtualCollateral_`	`uint`	The virtual collateral supply the caller expected.
`virtualCollateral_`	`uint`	The current virtual collateral supply.

IReferenceCurve_v1.sol#L186

ModuleReferenceCurveReconfigureReserveDecreased

error Module__ReferenceCurve__ReconfigureReserveDecreased(uint oldReserve_, uint newReserve_);

Thrown when a manual {reconfigureSegments} lowers the reserve that backs the current issuance supply. The keeper rule B6 also applies to manual changes. Parameters

Name	Type	Description
`oldReserve_`	`uint`	The reserve for the current supply before.
`newReserve_`	`uint`	The reserve for the current supply after.

IReferenceCurve_v1.sol#L156

ModuleReferenceCurveReferencePriceCannotDecrease

error Module__ReferenceCurve__ReferencePriceCannotDecrease(
    uint currentReferencePrice_,
    uint newReferencePrice_
);

Thrown when a reconfiguration would lower the reference floor while issuance-token or outstanding-reserve liabilities exist. Parameters

Name	Type	Description
`currentReferencePrice_`	`uint`	The current reference price.
`newReferencePrice_`	`uint`	The proposed reference price.

IReferenceCurve_v1.sol#L88

ModuleVirtualCollateralSupplyBaseAddResultsInOverflow

error Module__VirtualCollateralSupplyBase__AddResultsInOverflow();

Adding would result in and overflow. IVirtualCollateralSupplyBase_v1.sol#L25

ModuleVirtualCollateralSupplyBaseSubtractResultsInUnderflow

error Module__VirtualCollateralSupplyBase__SubtractResultsInUnderflow();

IVirtualCollateralSupplyBase_v1.sol#L22

ModuleVirtualCollateralSupplyBaseVirtualSupplyCannotBeZero

error Module__VirtualCollateralSupplyBase__VirtualSupplyCannotBeZero();

The virtual supply cannot be zero. IVirtualCollateralSupplyBase_v1.sol#L19

ReferenceCurve__ControllerAlreadySet

error ReferenceCurve__ControllerAlreadySet(address controller_);

Parameters

Name	Type	Description
`controller_`	`address`

IReferenceCurve_v1.sol#L30

ReferenceCurve__ControllerMismatch

error ReferenceCurve__ControllerMismatch(address expected_, address actual_);

Parameters

Name	Type	Description
`expected_`	`address`
`actual_`	`address`

IReferenceCurve_v1.sol#L40

ReferenceCurve__ControllerOnly

error ReferenceCurve__ControllerOnly(address caller_, address controller_);

Parameters

Name	Type	Description
`caller_`	`address`
`controller_`	`address`

IReferenceCurve_v1.sol#L34

ReferenceCurve__ControllerZero

error ReferenceCurve__ControllerZero();

IReferenceCurve_v1.sol#L29

ReferenceCurve__EndowmentDrawExceedsReferenceValue

error ReferenceCurve__EndowmentDrawExceedsReferenceValue(uint totalDrawn_, uint candidateValue_);

Parameters

Name	Type	Description
`totalDrawn_`	`uint`
`candidateValue_`	`uint`

IReferenceCurve_v1.sol#L37

ReferenceCurve__OutstandingDrawsOnReopen

error ReferenceCurve__OutstandingDrawsOnReopen(uint totalDrawn_);

Parameters

Name	Type	Description
`totalDrawn_`	`uint`

IReferenceCurve_v1.sol#L36

ReferenceCurve__ReferenceSellsClosed

error ReferenceCurve__ReferenceSellsClosed();

IReferenceCurve_v1.sol#L35

ReferenceCurve__ReserveManagerOnly

error ReferenceCurve__ReserveManagerOnly(address caller_, address reserveManager_);

Parameters

Name	Type	Description
`caller_`	`address`
`reserveManager_`	`address`

IReferenceCurve_v1.sol#L31

ReferenceCurve__SetupStateInvalid

error ReferenceCurve__SetupStateInvalid(bool current_, bool requested_);

Parameters

Name	Type	Description
`current_`	`bool`
`requested_`	`bool`

IReferenceCurve_v1.sol#L28