ElevationTreasury_v1

Treasury that accumulates collateral fees and exposes a standalone, keeper-gated {elevate} trigger that raises the reference price on the ReferenceCurve bonding curve once a configurable threshold is reached. Source: src/core/treasuries/ElevationTreasury_v1.sol. Interfaces: IElevationTreasury_v1, ITreasury_v1.

Functions

elevate

function elevate(
    uint maxIssuanceSupply_,
    uint deadline_
) external returns (uint attemptedAmount_, uint consumedAmount_, uint remainingBalance_);

Elevates the reference curve using the treasury’s accumulated collateral, in its own transaction, gated to a trusted keeper. Parameters

Name	Type	Description
`maxIssuanceSupply_`	`uint`	Maximum issuance totalSupply tolerated at execution; abort if the live supply exceeds it (front-run guard).
`deadline_`	`uint`	Latest block timestamp at which the call may execute.

Returns

Name	Type	Description
`attemptedAmount_`	`uint`	The selected budget offered to the curve.
`consumedAmount_`	`uint`	The collateral the curve actually consumed.
`remainingBalance_`	`uint`	The collateral left in the treasury.

IElevationTreasury_v1.sol#L118

fetchFunds

function fetchFunds(address token_, uint amount_) external;

Fetches token funds into the treasury. Parameters

Name	Type	Description
`token_`	`address`	The address of the token to fetch.
`amount_`	`uint`	The amount of tokens to fetch.

ITreasury_v1.sol#L49

setThreshold

function setThreshold(uint threshold_) external;

Sets the minimum accumulated balance {elevate} requires before it will raise the reference curve. Parameters

Name	Type	Description
`threshold_`	`uint`	The new threshold amount (must be non-zero).

IElevationTreasury_v1.sol#L86

View functions

getFunds

function getFunds(address token_) external view returns (uint funds_);

Returns the total funds in the treasury. Parameters

Name	Type	Description
`token_`	`address`	The address of the token to get the funds of.

Returns

Name	Type	Description
`funds_`	`uint`	The funds in the treasury of that specific token.

ITreasury_v1.sol#L41

getThreshold

function getThreshold() external view returns (uint threshold_);

Returns the minimum accumulated balance {elevate} requires before it will raise the reference curve. Returns

Name	Type	Description
`threshold_`	`uint`	The threshold amount.

IElevationTreasury_v1.sol#L76

Events

ElevationExecuted

event ElevationExecuted(uint attemptedAmount_, uint consumedAmount_, uint remainingBalance_);

Emitted on every {elevate} call (including a no-op when the curve has no headroom). Parameters

Name	Type	Description
`attemptedAmount_`	`uint`	The funded budget selected at or below balance by `ReferenceCurve.maxElevatable(balance)`; 0 on a no-op (no headroom), since nothing is offered.
`consumedAmount_`	`uint`	The collateral the curve actually consumed (treasury balance before minus after); 0 on a no-op.
`remainingBalance_`	`uint`	The collateral left in the treasury after.

IElevationTreasury_v1.sol#L61

ThresholdUpdated

event ThresholdUpdated(uint oldThreshold_, uint newThreshold_);

Emitted when the threshold is updated. Parameters

Name	Type	Description
`oldThreshold_`	`uint`	The previous threshold.
`newThreshold_`	`uint`	The new threshold.

IElevationTreasury_v1.sol#L68

Treasury_FundsReceived

event Treasury_FundsReceived(address indexed token, address indexed sender, uint amount);

Emitted when token funds are received. Parameters

Name	Type	Description
`token`	`address indexed`	The address of the token received.
`sender`	`address indexed`	The address of the sender.
`amount`	`uint`	The amount of tokens received.

ITreasury_v1.sol#L31

Errors

ModuleElevationTreasuryDeadlineExpired

error Module__ElevationTreasury__DeadlineExpired(uint deadline_, uint now_);

Thrown when a deadline is invalid or {elevate} runs after either the admin-authorized deadline or the keeper-supplied deadline. Parameters

Name	Type	Description
`deadline_`	`uint`
`now_`	`uint`

IElevationTreasury_v1.sol#L42

ModuleElevationTreasuryInvalidThreshold

error Module__ElevationTreasury__InvalidThreshold();

Thrown when an invalid (zero) threshold is provided. IElevationTreasury_v1.sol#L34

ModuleElevationTreasurySupplyCapExceeded

error Module__ElevationTreasury__SupplyCapExceeded(uint currentSupply_, uint maxIssuanceSupply_);

Thrown when live supply exceeds the lower of the admin cap and keeper cap. Elevation aborts before any funds move. Parameters

Name	Type	Description
`currentSupply_`	`uint`
`maxIssuanceSupply_`	`uint`

IElevationTreasury_v1.sol#L46

ModuleElevationTreasuryThresholdNotReached

error Module__ElevationTreasury__ThresholdNotReached();

Thrown when {elevate} is called but the accumulated balance is below the configured threshold. IElevationTreasury_v1.sol#L38

Overview

How it works

Deployments

Reference