OCE_ZVE.sol
OCE -> On-Chain Emissions ($ZVE, Exponential Decay)
Introduction
This contract facilitates an exponential decay emissions schedule for $ZVE.
This contract has the following responsibilities:
Handles accounting (with governable variables) to support emissions schedule.
Forwards $ZVE to all ZivoeRewards contracts at will (stZVE, stSTT, stJTT).
State Variables
address
GBL
The ZivoeGlobals contract.
uint256
exponentialDecayPerSecond
The rate of decay per second.
uint256
lastDistribution
The block.timestamp value of last distribution.
uint256[3]
distributionRatioBIPS
Determines distribution between rewards contract, in BIPS.
distributionRatioBIPS[0] => stZVE
distributionRatioBIPS[1] => stSTT
distributionRatioBIPS[2] => stJTT
uint256
BIPS
Private constant, 10000
uint256
RAY
Private constant, 10**27
Sections
canPush() - Permission for owner to call
pushToLocker()
. See ZivoeLocker.solcanPull() - Permission for owner to call
pullFromLocker()
. See ZivoeLocker.solcanPullPartial() - Permission for owner to call
pullFromLockerPartial()
. See ZivoeLocker.soldecay() - Returns the amount remaining after a decay.
rmul() - Multiplies two variables and returns value, truncated by RAY precision.
rpow() -
rpow(uint256 x, uint256 n, uint256 b)
, used for exponentiation in drip
pushToLocker() - Allocates ZVE from the DAO to this locker for emissions.
forwardEmissions() - Forwards $ZVE available for distribution.
updateDistributionRatioBIPS() - Updates the distribution between rewards contract, in BIPS.
updateExponentialDecayPerSecond() - Updates the exponentialDecayPerSecond variable with provided input.
Read Functions
canPush()
canPush()
Permission for owner to call pushToLocker()
. See ZivoeLocker.sol
function canPush() public override pure returns (bool) { return true; }
canPull()
canPull()
Permission for owner to call pullFromLocker()
. See ZivoeLocker.sol
function canPull() public override pure returns (bool) { return true; }
canPullPartial()
canPullPartial()
Permission for owner to call pullFromLockerPartial()
. See ZivoeLocker.sol
function canPullPartial() public override pure returns (bool) { return true; }
decay()
decay()
Returns the amount remaining after a decay.
function decay(
uint256 top,
uint256 dur
) public view returns (uint256);
uint256
top
The amount decaying.
uint256
dur
The seconds of decay.
Returns
uint256
n/a
The amount remaining after a decay.
rmul()
rmul()
Multiplies two variables and returns value, truncated by RAY precision.
function rmul(
uint256 x,
uint256 y
) internal pure returns (uint256 z);
uint256
x
First value to multiply.
uint256
y
Second value to multiply.
Returns
uint256
z
Resulting value of x * y, truncated by RAY precision.
rpow()
rpow()
rpow(uint256 x, uint256 n, uint256 b)
, used for exponentiation in drip, is a fixed-point arithmetic function that raises x to the power n. It is implemented in Solidity assembly as a repeated squaring algorithm. x and the returned value are to be interpreted as fixed-point integers with scaling factor b. For example, if b == 100, this specifies two decimal digits of precision and the normal decimal value 2.1 would be represented as 210; rpow(210, 2, 100) returns 441 (the two-decimal digit fixed-point representation of 2.1^2 = 4.41). In the current implementation, 10^27 is passed for b, making x and the rpow result both of type RAY in standard MCD fixed-point terminology. rpow's formal invariants include "no overflow" as well as constraints on gas usage.
function rpow(
uint256 x,
uint256 n,
uint256 b
) internal pure returns (uint256 z);
uint256
x
The base value.
uint256
n
The power to raise "x" by.
uint256
b
The scaling factor, a.k.a. resulting precision of "z".
Returns
uint256
z
Resulting value of x^n, scaled by factor b.
Write Functions
pushToLocker()
pushToLocker()
Allocates ZVE from the DAO to this locker for emissions.
function pushToLocker(
address asset,
uint256 amount,
bytes calldata data
) external override onlyOwner;
address
asset
The asset to push to this locker (in this case $ZVE).
uint256
amount
The amount of $ZVE to push to this locker.
bytes
data
Accompanying transaction data.
forwardEmissions()
forwardEmissions()
Forwards $ZVE available for distribution.
function forwardEmissions() external nonReentrant;
Emits the EmissionsForwarded() event.
updateDistributionRatioBIPS()
updateDistributionRatioBIPS()
Updates the distribution between rewards contract, in BIPS.
function updateDistributionRatioBIPS(
uint256[3] calldata _distributionRatioBIPS
) external;
uint256[3]
_distributionRatioBIPS
The updated values for the state variable distributionRatioBIPS.
Emits the UpdatedDistributionRatioBIPS() event.
updateExponentialDecayPerSecond()
updateExponentialDecayPerSecond()
Updates the exponentialDecayPerSecond variable with provided input.
function updateExponentialDecayPerSecond(
uint256 _exponentialDecayPerSecond
) external;
uint256
_exponentialDecayPerSecond
The updated value for exponentialDecayPerSecond state variable.
Emits the UpdatedExponentialDecayPerSecond() event.
Events
UpdatedDistributionRatioBIPS()
UpdatedDistributionRatioBIPS()
Emitted during updateDistributionRatioBIPS()
event UpdatedDistributionRatioBIPS(
uint256[3] oldRatios,
uint256[3] newRatios
);
uint256[3]
False
oldRatios
The old distribution ratios.
uint256[3]
False
newRatios
The new distribution ratios.
EmissionsForwarded()
EmissionsForwarded()
Emitted during forwardEmissions()
event EmissionsForwarded(uint256 stZVE, uint256 stJTT, uint256 stSTT);
uint256
False
stZVE
The amount of $ZVE emitted to the $ZVE rewards contract.
uint256
False
stJTT
The amount of $ZVE emitted to the $zJTT rewards contract.
uint256
False
stSTT
The amount of $ZVE emitted to the $zSTT rewards contract.
UpdatedExponentialDecayPerSecond()
UpdatedExponentialDecayPerSecond()
Emitted during updateExponentialDecayPerSecond()
event UpdatedExponentialDecayPerSecond(uint256 oldValue, uint256 newValue);
uint256
False
oldValue
The old value of exponentialDecayPerSecond.
uint256
False
newValue
The new value of exponentialDecayPerSecond.
Last updated