Source Code
Overview
ETH Balance
0 ETH
Eth Value
$0.00View more zero value Internal Transactions in Advanced View mode
Advanced mode:
Loading...
Loading
Loading...
Loading
Cross-Chain Transactions
Loading...
Loading
This contract may be a proxy contract. Click on More Options and select Is this a proxy? to confirm and enable the "Read as Proxy" & "Write as Proxy" tabs.
Contract Name:
TermAuction
Compiler Version
v0.8.18+commit.87f61d96
Optimization Enabled:
Yes with 50 runs
Other Settings:
default evmVersion
Contract Source Code (Solidity Standard Json-Input format)
//SPDX-License-Identifier: CC-BY-NC-ND-4.0
pragma solidity ^0.8.18;
import {ITermAuctionBidLocker} from "./interfaces/ITermAuctionBidLocker.sol";
import {ITermAuctionErrors} from "./interfaces/ITermAuctionErrors.sol";
import {ITermAuctionOfferLocker} from "./interfaces/ITermAuctionOfferLocker.sol";
import {ITermController} from "./interfaces/ITermController.sol";
import {ITermEventEmitter} from "./interfaces/ITermEventEmitter.sol";
import {ITermRepoCollateralManager} from "./interfaces/ITermRepoCollateralManager.sol";
import {ITermRepoRolloverManager} from "./interfaces/ITermRepoRolloverManager.sol";
import {ITermRepoServicer} from "./interfaces/ITermRepoServicer.sol";
import {CompleteAuctionInput} from "./lib/CompleteAuctionInput.sol";
import {ExponentialNoError} from "./lib/ExponentialNoError.sol";
import {TermAuctionBid} from "./lib/TermAuctionBid.sol";
import {TermAuctionOffer} from "./lib/TermAuctionOffer.sol";
import {TermAuctionRevealedBid} from "./lib/TermAuctionRevealedBid.sol";
import {TermAuctionRevealedOffer} from "./lib/TermAuctionRevealedOffer.sol";
import {AccessControlUpgradeable} from "@openzeppelin/contracts-upgradeable/access/AccessControlUpgradeable.sol";
import {IERC20MetadataUpgradeable} from "@openzeppelin/contracts-upgradeable/interfaces/IERC20MetadataUpgradeable.sol";
import {UUPSUpgradeable} from "@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol";
import {ReentrancyGuardUpgradeable} from "@openzeppelin/contracts-upgradeable/security/ReentrancyGuardUpgradeable.sol";
import {Versionable} from "./lib/Versionable.sol";
/// @author TermLabs
/// @title Term Auction
/// @notice This contract calculates a clearing price in a blind double auction and manages auction clearing and settlement
/// @dev This contract belongs to the Term Auction group of contracts and is specific to a Term Repo deployment
contract TermAuction is
ITermAuctionErrors,
UUPSUpgradeable,
AccessControlUpgradeable,
ReentrancyGuardUpgradeable,
ExponentialNoError,
Versionable
{
// ========================================================================
// = Structs =============================================================
// ========================================================================
/// State used during the `calculateClearingPrice` function
/// @dev Used to reduce the number of stack variables
struct ClearingPriceState {
// Variables describing current loop iteration
uint256 offerPrice; // p^o_i
uint256 offerIndex; // idxo(p^o_i)
uint256 bidIndex; // idxb(p^o_i)
uint256 cumSumOffers; // cso(p^o_i)
uint256 cumSumBids; // csb(p^o_i)
uint256 maxClearingVolume; // maxcv_i
// Variables describing next loop iteration
uint256 nextOfferIndex;
uint256 nextBidIndex;
uint256 nextCumSumOffers;
uint256 nextCumSumBids;
uint256 nextOfferPrice;
uint256 nextMaxClearingVolume;
// Auxiliary variables
bool minCumSumCorrection; // Minimisation correction indicator
uint256 nextBidPrice; // Next bid price in minimisation
// Principal quantities of interest
uint256 clearingPrice; // p_c
}
// ========================================================================
// = Constants ===========================================================
// ========================================================================
uint256 public constant THREESIXTY_DAYCOUNT_SECONDS = 360 days;
// ========================================================================
// = Access Roles ========================================================
// ========================================================================
bytes32 public constant ADMIN_ROLE = keccak256("ADMIN_ROLE");
bytes32 public constant DEVOPS_ROLE = keccak256("DEVOPS_ROLE");
bytes32 public constant INITIALIZER_ROLE = keccak256("INITIALIZER_ROLE");
// ========================================================================
// = State Variables =====================================================
// ========================================================================
// Auction configuration.
bytes32 public termRepoId;
bytes32 public termAuctionId;
uint256 public auctionEndTime;
uint256 public dayCountFractionMantissa;
ITermRepoServicer public termRepoServicer;
ITermAuctionBidLocker public termAuctionBidLocker;
ITermAuctionOfferLocker public termAuctionOfferLocker;
IERC20MetadataUpgradeable public purchaseToken;
ITermEventEmitter internal emitter;
ITermController public controller;
// Completed auction state
uint256 public clearingPrice;
uint256 public clearingPricePostProcessingOffset;
bool public auctionCompleted;
bool public auctionCancelledForWithdrawal;
bool public completeAuctionPaused;
bool internal termContractPaired;
// ========================================================================
// = Modifiers ===========================================================
// ========================================================================
/// @notice This only runs if the auction is closed (after auction end time)
/// @dev This uses the block timestamp to determine if the auction is closed
modifier onlyWhileAuctionClosed() {
// solhint-disable-next-line not-rely-on-time
if (block.timestamp <= auctionEndTime) {
revert AuctionNotClosed();
}
_;
}
modifier whenCompleteAuctionNotPaused() {
if (completeAuctionPaused) {
revert CompleteAuctionPaused();
}
_;
}
modifier notTermContractPaired() {
if (termContractPaired) {
revert AlreadyTermContractPaired();
}
termContractPaired = true;
_;
}
// ========================================================================
// = Deploy (https://docs.openzeppelin.com/contracts/4.x/upgradeable) =
// ========================================================================
/// @custom:oz-upgrades-unsafe-allow constructor
constructor() {
_disableInitializers();
}
/// Initializes the contract
/// @dev See: https://docs.openzeppelin.com/contracts/4.x/upgradeable
function initialize(
string calldata termRepoId_,
string calldata auctionId_,
uint256 auctionEndTime_,
uint256 termStart_,
uint256 redemptionTimestamp_,
IERC20MetadataUpgradeable purchaseToken_,
address termAuctionInitializer_,
uint256 clearingPricePostProcessingOffset_
) external initializer {
UUPSUpgradeable.__UUPSUpgradeable_init();
AccessControlUpgradeable.__AccessControl_init();
ReentrancyGuardUpgradeable.__ReentrancyGuard_init();
_grantRole(INITIALIZER_ROLE, termAuctionInitializer_);
termRepoId = keccak256(abi.encodePacked(termRepoId_));
termAuctionId = keccak256(abi.encodePacked(auctionId_));
auctionEndTime = auctionEndTime_;
dayCountFractionMantissa =
((redemptionTimestamp_ - termStart_) * expScale) /
THREESIXTY_DAYCOUNT_SECONDS;
purchaseToken = purchaseToken_;
auctionCompleted = false;
termContractPaired = false;
auctionCancelledForWithdrawal = false;
clearingPricePostProcessingOffset = clearingPricePostProcessingOffset_;
}
function pairTermContracts(
ITermEventEmitter emitter_,
ITermController controller_,
ITermRepoServicer termRepoServicer_,
ITermAuctionBidLocker termAuctionBidLocker_,
ITermAuctionOfferLocker termAuctionOfferLocker_,
address devopsMultisigAddress_,
address adminWallet_,
string calldata version_
) external onlyRole(INITIALIZER_ROLE) notTermContractPaired {
emitter = emitter_;
controller = controller_;
termRepoServicer = termRepoServicer_;
termAuctionBidLocker = termAuctionBidLocker_;
termAuctionOfferLocker = termAuctionOfferLocker_;
_grantRole(DEVOPS_ROLE, devopsMultisigAddress_);
_grantRole(ADMIN_ROLE, adminWallet_);
emitter.emitTermAuctionInitialized(
termRepoId,
termAuctionId,
address(this),
auctionEndTime,
version_
);
}
// ========================================================================
// = Interface/API ========================================================
// ========================================================================
/// @notice Calculates an auction's clearing price, assigns bids/offers, and returns unassigned funds
/// @param completeAuctionInput A struct containing all revealed and unrevealed bids and offers and expired rollover bids
function completeAuction(
CompleteAuctionInput calldata completeAuctionInput
) external onlyWhileAuctionClosed whenCompleteAuctionNotPaused {
if (auctionCompleted) {
revert AuctionAlreadyCompleted();
}
if (auctionCancelledForWithdrawal) {
revert AuctionCancelledForWithdrawal();
}
auctionCompleted = true;
// Sort bids/offers by price. Orders right on the price
// edge will be partially filled.
if (!hasRole(ADMIN_ROLE, msg.sender)) {
if (
completeAuctionInput.unrevealedBidSubmissions.length > 0 ||
completeAuctionInput.unrevealedOfferSubmissions.length > 0
) {
revert InvalidParameters(
"All tender prices must be revealed for auction to be complete"
);
}
}
(
TermAuctionRevealedBid[] memory sortedBids,
TermAuctionBid[] memory unrevealedBids
) = termAuctionBidLocker.getAllBids(
completeAuctionInput.revealedBidSubmissions,
completeAuctionInput.expiredRolloverBids,
completeAuctionInput.unrevealedBidSubmissions
);
(
TermAuctionRevealedOffer[] memory sortedOffers,
TermAuctionOffer[] memory unrevealedOffers
) = termAuctionOfferLocker.getAllOffers(
completeAuctionInput.revealedOfferSubmissions,
completeAuctionInput.unrevealedOfferSubmissions
);
// Calculate a clearing price only if both bids and offers exist and market intersects
if (
sortedBids.length > 0 &&
sortedOffers.length > 0 &&
sortedBids[sortedBids.length - 1].bidPriceRevealed >=
sortedOffers[0].offerPriceRevealed
) {
(
,
// uint256 clearingPrice_
uint256 maxAssignable
) = _calculateAndStoreClearingPrice(sortedBids, sortedOffers);
uint256 purchaseTokenDecimals = purchaseToken.decimals();
// Process revealed bids/offers
uint256 totalAssignedBids = _assignBids(
sortedBids,
maxAssignable,
purchaseTokenDecimals
);
uint256 totalAssignedOffers = _assignOffers(
sortedOffers,
maxAssignable,
purchaseTokenDecimals
);
emitter.emitAuctionCompleted(
termAuctionId, // solhint-disable-next-line not-rely-on-time
block.timestamp,
block.number,
totalAssignedBids,
totalAssignedOffers,
clearingPrice
);
controller.recordAuctionResult(termRepoId, termAuctionId, clearingPrice);
} else {
// Return sorted bid funds.
for (uint256 i = 0; i < sortedBids.length; ++i) {
if (sortedBids[i].isRollover) {
_markRolloverAsProcessed(
sortedBids[i].rolloverPairOffTermRepoServicer,
sortedBids[i].bidder
);
} else {
termAuctionBidLocker.auctionUnlockBid(
sortedBids[i].id,
sortedBids[i].bidder,
sortedBids[i].collateralTokens,
sortedBids[i].collateralAmounts
);
}
}
// Return sorted offer funds.
for (uint256 i = 0; i < sortedOffers.length; ++i) {
termAuctionOfferLocker.unlockOfferPartial(
sortedOffers[i].id,
sortedOffers[i].offeror,
sortedOffers[i].amount
);
}
if (
sortedBids.length > 0 &&
sortedOffers.length > 0 &&
sortedBids[sortedBids.length - 1].bidPriceRevealed <
sortedOffers[0].offerPriceRevealed
) {
emitter.emitAuctionCancelled(termAuctionId, true, false);
} else {
emitter.emitAuctionCancelled(termAuctionId, false, false);
}
}
// Return unrevealed bid funds.
for (uint256 i = 0; i < unrevealedBids.length; ++i) {
if (unrevealedBids[i].isRollover) {
_markRolloverAsProcessed(
unrevealedBids[i].rolloverPairOffTermRepoServicer,
unrevealedBids[i].bidder
);
} else {
termAuctionBidLocker.auctionUnlockBid(
unrevealedBids[i].id,
unrevealedBids[i].bidder,
unrevealedBids[i].collateralTokens,
unrevealedBids[i].collateralAmounts
);
}
}
// Return unrevealed offer funds.
for (uint256 i = 0; i < unrevealedOffers.length; ++i) {
termAuctionOfferLocker.unlockOfferPartial(
unrevealedOffers[i].id,
unrevealedOffers[i].offeror,
unrevealedOffers[i].amount
);
}
assert(termRepoServicer.isTermRepoBalanced());
}
// ========================================================================
// = Admin ================================================================
// ========================================================================
/// @notice Cancels an auction and returns all funds to bidders and fulfillBiders
/// @param completeAuctionInput A struct containing all revealed and unrevealed bids and offers and expired rollover bids
function cancelAuction(
CompleteAuctionInput calldata completeAuctionInput
) public onlyWhileAuctionClosed onlyRole(ADMIN_ROLE) {
// Sort bids/offers by price. Orders right on the price
// edge will be partially filled.
(
TermAuctionRevealedBid[] memory sortedBids,
TermAuctionBid[] memory unrevealedBids
) = termAuctionBidLocker.getAllBids(
completeAuctionInput.revealedBidSubmissions,
completeAuctionInput.expiredRolloverBids,
completeAuctionInput.unrevealedBidSubmissions
);
(
TermAuctionRevealedOffer[] memory sortedOffers,
TermAuctionOffer[] memory unrevealedOffers
) = termAuctionOfferLocker.getAllOffers(
completeAuctionInput.revealedOfferSubmissions,
completeAuctionInput.unrevealedOfferSubmissions
);
// Return revealed bid funds.
uint256 i = 0;
for (i = 0; i < sortedBids.length; ++i) {
if (sortedBids[i].isRollover) {
_markRolloverAsProcessed(
sortedBids[i].rolloverPairOffTermRepoServicer,
sortedBids[i].bidder
);
} else {
termAuctionBidLocker.auctionUnlockBid(
sortedBids[i].id,
sortedBids[i].bidder,
sortedBids[i].collateralTokens,
sortedBids[i].collateralAmounts
);
}
}
// Return revealed offer funds.
for (i = 0; i < sortedOffers.length; ++i) {
termAuctionOfferLocker.unlockOfferPartial(
sortedOffers[i].id,
sortedOffers[i].offeror,
sortedOffers[i].amount
);
}
// Return unrevealed bid funds.
for (i = 0; i < unrevealedBids.length; ++i) {
if (unrevealedBids[i].isRollover) {
_markRolloverAsProcessed(
unrevealedBids[i].rolloverPairOffTermRepoServicer,
unrevealedBids[i].bidder
);
} else {
termAuctionBidLocker.auctionUnlockBid(
unrevealedBids[i].id,
unrevealedBids[i].bidder,
unrevealedBids[i].collateralTokens,
unrevealedBids[i].collateralAmounts
);
}
}
// Return unrevealed offer funds.
for (i = 0; i < unrevealedOffers.length; ++i) {
termAuctionOfferLocker.unlockOfferPartial(
unrevealedOffers[i].id,
unrevealedOffers[i].offeror,
unrevealedOffers[i].amount
);
}
emitter.emitAuctionCancelled(termAuctionId, false, false);
assert(termRepoServicer.isTermRepoBalanced());
}
/// @notice Cancels an auction and sets auctionCancelledForWithdrawal to true to open unlocking tenders
function cancelAuctionForWithdrawal(
address[] calldata rolloverBorrowers,
address[] calldata rolloverPairOffTermRepoServicer
) public onlyWhileAuctionClosed onlyRole(ADMIN_ROLE) {
for (uint256 i = 0; i < rolloverBorrowers.length; ++i) {
_markRolloverAsProcessed(
rolloverPairOffTermRepoServicer[i],
rolloverBorrowers[i]
);
}
auctionCancelledForWithdrawal = true;
emitter.emitAuctionCancelled(
termAuctionId,
false,
auctionCancelledForWithdrawal
);
}
// ========================================================================
// = Helpers ==============================================================
// ========================================================================
function _increaseCumSumBids(
TermAuctionRevealedBid[] memory sortedBids,
uint256 startIndex,
uint256 previousCumSumBids,
uint256 currentPrice
) internal pure returns (uint256, uint256) {
uint256 cumsumBids = previousCumSumBids;
uint256 i;
for (
i = startIndex;
sortedBids[i].bidPriceRevealed >= currentPrice;
--i
) {
cumsumBids += sortedBids[i].amount;
if (i == 0) break;
}
return (
cumsumBids,
sortedBids[i].bidPriceRevealed < currentPrice ? i + 1 : i
);
}
function _decreaseCumSumBids(
TermAuctionRevealedBid[] memory sortedBids,
uint256 startIndex,
uint256 previousCumSumBids,
uint256 currentPrice
) internal pure returns (uint256, uint256) {
uint256 cumsumBids = previousCumSumBids;
uint256 i;
for (
i = startIndex;
i < sortedBids.length &&
sortedBids[i].bidPriceRevealed < currentPrice;
i++
) cumsumBids -= sortedBids[i].amount;
return (cumsumBids, i);
}
/// Returns the min of two `uint256` values
/// @param a The first value to compare
/// @param b The second value to compare
/// @return The min of the two values
function _minUint256(uint256 a, uint256 b) internal pure returns (uint256) {
if (a >= b) {
return b;
} else {
return a;
}
}
/// Calculates the intersection between bid/offer schedules to arrive at a clearing price
/// @dev Imagine a graph with price along the X-axis and cumsum(bid/offerAmount*price) along the Y-axis. This function finds the point where the supply line crosses the demand line using binary search
/// @param sortedBids A sorted array of bids used to arrive at a demand schedule
/// @param sortedOffers A sorted array of offers used to arrive at a supply schedule
/// @param clearingOffset The offset to apply to the marginal bid and offer indexes when calculating the final clearing price
/// @return clearingPrice The price at which Term Auction will be cleared
function _calculateClearingPrice(
TermAuctionRevealedBid[] memory sortedBids,
TermAuctionRevealedOffer[] memory sortedOffers,
uint256 clearingOffset
) internal pure returns (uint256, uint256) {
if (clearingOffset != 1 && clearingOffset != 0) {
revert ClearingOffsetNot0Or1(clearingOffset);
}
// Local function variables are kept in memory
ClearingPriceState memory state = ClearingPriceState({
offerPrice: sortedOffers[0].offerPriceRevealed, // p^o_i
offerIndex: 1, // idxo(offerPrice)
cumSumOffers: sortedOffers[0].amount, // cso(offerPrice)
bidIndex: sortedBids.length,
cumSumBids: 0,
maxClearingVolume: 0,
nextOfferIndex: 0,
nextBidIndex: 0,
nextCumSumOffers: 0,
nextCumSumBids: 0,
nextOfferPrice: 0,
nextMaxClearingVolume: 0,
minCumSumCorrection: false,
nextBidPrice: 0,
clearingPrice: 0
});
// Calculate bidIndex = idxb(offerPrice) and cumSumBids = csb(offerPrice)
(state.cumSumBids, state.bidIndex) = _increaseCumSumBids(
sortedBids,
state.bidIndex - 1,
0,
state.offerPrice
);
// Calculate initial maximal clearing volume
state.maxClearingVolume = _minUint256(
state.cumSumBids,
state.cumSumOffers
);
// Calculate the pre-clearance price: maximise the clearing volume
while (
state.offerIndex < sortedOffers.length &&
state.bidIndex < sortedBids.length
) {
// Initialise the next iteration of the relevant variables
state.nextOfferIndex = state.offerIndex;
state.nextBidIndex = state.bidIndex;
state.nextCumSumOffers = state.cumSumOffers;
state.nextCumSumBids = state.cumSumBids;
state.nextOfferPrice = sortedOffers[state.offerIndex]
.offerPriceRevealed;
// Obtain next offer index, increase cumulative sum
while (
state.nextOfferIndex < sortedOffers.length &&
sortedOffers[state.nextOfferIndex].offerPriceRevealed ==
state.nextOfferPrice
)
state.nextCumSumOffers += sortedOffers[state.nextOfferIndex++]
.amount;
// Obtain next bid index, decrease cumulative sum
(state.nextCumSumBids, state.nextBidIndex) = _decreaseCumSumBids(
sortedBids,
state.nextBidIndex,
state.nextCumSumBids,
state.nextOfferPrice
);
state.nextMaxClearingVolume = _minUint256(
state.nextCumSumBids,
state.nextCumSumOffers
);
if (state.nextMaxClearingVolume > state.maxClearingVolume) {
state.offerIndex = state.nextOfferIndex;
state.bidIndex = state.nextBidIndex;
state.cumSumOffers = state.nextCumSumOffers;
state.cumSumBids = state.nextCumSumBids;
state.offerPrice = state.nextOfferPrice;
state.maxClearingVolume = state.nextMaxClearingVolume;
} else {
break;
}
}
// Get next offer price: first offer price higher than the pre-clearance price
state.nextOfferPrice = (state.offerIndex < sortedOffers.length)
? sortedOffers[state.offerIndex].offerPriceRevealed
: type(uint256).max;
// Minimise css by minimising csb as long as bid price is smaller than next offer price
while (state.bidIndex < sortedBids.length) {
state.nextBidIndex = state.bidIndex;
state.nextBidPrice = sortedBids[state.bidIndex].bidPriceRevealed;
state.nextCumSumBids = state.cumSumBids;
if (state.nextBidPrice < state.nextOfferPrice) {
while (
state.nextBidIndex < sortedBids.length &&
sortedBids[state.nextBidIndex].bidPriceRevealed ==
state.nextBidPrice
) {
state.nextCumSumBids -= sortedBids[state.nextBidIndex++]
.amount;
}
if (state.nextCumSumBids >= state.cumSumOffers) {
state.minCumSumCorrection = true;
state.cumSumBids = state.nextCumSumBids;
state.bidIndex = state.nextBidIndex;
} else {
break;
}
} else {
break;
}
}
// Calculate clearing price: bid price if minimum correction was made and offer price otherwise
if (state.minCumSumCorrection)
state.clearingPrice = (state.bidIndex == sortedBids.length)
? sortedBids[state.bidIndex - 1].bidPriceRevealed
: sortedBids[state.bidIndex].bidPriceRevealed;
else state.clearingPrice = state.offerPrice;
// The main loop positions `offerIndex` at the first index greater than the price.
// It needs to be shifted back to get the last index smaller than or equal to the price.
state.offerIndex--;
// If non-zero clearing offset, find the offset tender prices and then average them to find the final clearing price.
if (clearingOffset == 1) {
uint256 nextOfferPriceIndex = state.offerIndex;
while (
nextOfferPriceIndex > 0 &&
sortedOffers[nextOfferPriceIndex].offerPriceRevealed ==
sortedOffers[state.offerIndex].offerPriceRevealed
) {
nextOfferPriceIndex -= 1;
}
uint256 nextBidPriceIndex = state.bidIndex;
// In the case that there is no clear, bid index is past end of array, so decrement it to last element.
if (state.bidIndex == sortedBids.length) {
nextBidPriceIndex -= 1;
}
while (
nextBidPriceIndex < sortedBids.length - 1 &&
sortedBids[nextBidPriceIndex].bidPriceRevealed ==
sortedBids[state.bidIndex].bidPriceRevealed
) {
nextBidPriceIndex += 1;
}
state.clearingPrice =
(sortedOffers[nextOfferPriceIndex].offerPriceRevealed +
sortedBids[nextBidPriceIndex].bidPriceRevealed) /
2;
} else {
// In the case that there is no clear, bid index is past end of array, so decrement it to last element.
if (state.bidIndex == sortedBids.length) {
state.bidIndex -= 1;
}
state.clearingPrice =
(sortedOffers[state.offerIndex].offerPriceRevealed +
sortedBids[state.bidIndex].bidPriceRevealed) /
2;
}
//update state.cumSumOffers
if (
sortedOffers[state.offerIndex].offerPriceRevealed <=
state.clearingPrice
) {
state.offerIndex++;
while (
state.offerIndex < sortedOffers.length &&
sortedOffers[state.offerIndex].offerPriceRevealed <=
state.clearingPrice
) {
state.cumSumOffers += sortedOffers[state.offerIndex].amount;
state.offerIndex++;
}
} else {
while (
sortedOffers[state.offerIndex].offerPriceRevealed >
state.clearingPrice
) {
state.cumSumOffers -= sortedOffers[state.offerIndex].amount;
if (state.offerIndex == 0) break;
state.offerIndex--;
}
}
//update state.cumSumBids
if (
state.bidIndex < sortedBids.length &&
sortedBids[state.bidIndex].bidPriceRevealed < state.clearingPrice
) {
(state.cumSumBids, state.bidIndex) = _decreaseCumSumBids(
sortedBids,
state.bidIndex,
state.cumSumBids,
state.clearingPrice
);
} else if (state.bidIndex > 0) {
(state.cumSumBids, state.bidIndex) = _increaseCumSumBids(
sortedBids,
state.bidIndex - 1,
state.cumSumBids,
state.clearingPrice
);
}
return (
state.clearingPrice,
_minUint256(state.cumSumBids, state.cumSumOffers)
);
}
/// Finds the index of the first bid with a bidPrice of `price` and calculate the cumsum of the bid amounts up to that index
/// @param price The price to search for
/// @param sortedBids An array of sorted bids to search
/// @param startIndex The index to start searching from
/// @return i The index of the first bid with a bidPrice of `price`
/// @return totalAmount The cumsum of the bid amounts up to return index i
function _findFirstIndexForPrice(
uint256 price,
TermAuctionRevealedBid[] memory sortedBids,
uint256 startIndex
) internal pure returns (uint256 i, uint256 totalAmount) {
i = startIndex;
totalAmount = sortedBids[i].amount;
while (true) {
if (i == 0 || sortedBids[i - 1].bidPriceRevealed != price) {
break;
}
totalAmount += sortedBids[i - 1].amount;
--i;
}
return (i, totalAmount);
}
/// Finds the index of the last offer with a offerPrice of `price` and calculate the cumsum of the offer amounts up to that index
/// @param price The price to search for
/// @param sortedOffers An array of offers to search
/// @param startIndex The index to start searching from
/// @return i The index of the last offer with a offerPrice of `price`
/// @return totalAmount The cumsum of the offer amounts up to return index i
function _findLastIndexForPrice(
uint256 price,
TermAuctionRevealedOffer[] memory sortedOffers,
uint256 startIndex
) internal pure returns (uint256 i, uint256 totalAmount) {
i = startIndex;
totalAmount = sortedOffers[i].amount;
while (i < (sortedOffers.length - 1)) {
if (sortedOffers[i + 1].offerPriceRevealed != price) {
break;
}
totalAmount += sortedOffers[i + 1].amount;
++i;
}
return (i, totalAmount);
}
/// Fully assigns a bid
/// @param bid The bid to assign
/// @return The amount that was assigned
function _fullyAssignBid(
TermAuctionRevealedBid memory bid
) internal nonReentrant returns (uint256) {
uint256 repurchaseAmount = _calculateRepurchasePrice(bid.amount);
if (!bid.isRollover) {
termRepoServicer.fulfillBid(
bid.bidder,
bid.amount,
repurchaseAmount,
bid.collateralTokens,
bid.collateralAmounts,
dayCountFractionMantissa
);
} else {
_assignRolloverBid(
bid.bidder,
bid.amount,
repurchaseAmount,
bid.rolloverPairOffTermRepoServicer
);
}
emitter.emitBidAssigned(termAuctionId, bid.id, bid.amount);
return bid.amount;
}
/// Fully assigns an offer
/// @param offer The offer to assign
/// @return The amount that was assigned
function _fullyAssignOffer(
TermAuctionRevealedOffer memory offer
) internal nonReentrant returns (uint256) {
uint256 repurchaseAmount = _calculateRepurchasePrice(offer.amount);
termRepoServicer.fulfillOffer(
offer.offeror,
offer.amount,
repurchaseAmount,
offer.id
);
emitter.emitOfferAssigned(termAuctionId, offer.id, offer.amount);
return offer.amount;
}
/// Partially assigns a bid
/// @param bid The bid to assign
/// @param assignedAmount The amount to assign
/// @return The amount that was assigned
function _partiallyAssignBid(
TermAuctionRevealedBid memory bid,
uint256 assignedAmount
) internal nonReentrant returns (uint256) {
uint256 repurchaseAmount = _calculateRepurchasePrice(assignedAmount);
if (!bid.isRollover) {
termRepoServicer.fulfillBid(
bid.bidder,
assignedAmount,
repurchaseAmount,
bid.collateralTokens,
bid.collateralAmounts,
dayCountFractionMantissa
);
} else {
_assignRolloverBid(
bid.bidder,
assignedAmount,
repurchaseAmount,
bid.rolloverPairOffTermRepoServicer
);
}
emitter.emitBidAssigned(termAuctionId, bid.id, assignedAmount);
return assignedAmount;
}
/// Partially assigns an offer
/// @param offer The offer to assign
/// @param assignedAmount The amount to assign
/// @return The amount that was assigned
function _partiallyAssignOffer(
TermAuctionRevealedOffer memory offer,
uint256 assignedAmount
) internal nonReentrant returns (uint256) {
uint256 repurchaseAmount = _calculateRepurchasePrice(assignedAmount);
termRepoServicer.fulfillOffer(
offer.offeror,
assignedAmount,
repurchaseAmount,
offer.id
);
// Unlock remaining.
termAuctionOfferLocker.unlockOfferPartial(
offer.id,
offer.offeror,
offer.amount - assignedAmount
);
emitter.emitOfferAssigned(termAuctionId, offer.id, assignedAmount);
return assignedAmount;
}
function _assignRolloverBid(
address borrower,
uint256 purchasePrice,
uint256 repurchasePrice,
address rolloverPairOffTermRepoServicer
) internal {
ITermRepoServicer previousTermRepoServicer = ITermRepoServicer(
rolloverPairOffTermRepoServicer
);
uint256 rolloverPaymentToCollapseBorrower = termRepoServicer
.openExposureOnRolloverNew(
borrower,
purchasePrice,
repurchasePrice,
address(previousTermRepoServicer.termRepoLocker()),
dayCountFractionMantissa
);
uint256 proportionPreviousLoanPaid = previousTermRepoServicer
.closeExposureOnRolloverExisting(
borrower,
rolloverPaymentToCollapseBorrower
);
ITermRepoCollateralManager previousTermRepoCollateralManager = ITermRepoCollateralManager(
previousTermRepoServicer.termRepoCollateralManager()
);
(
address[] memory collateralTypes,
uint256[] memory collateralAmounts
) = previousTermRepoCollateralManager.transferRolloverCollateral(
borrower,
proportionPreviousLoanPaid,
address(termRepoServicer.termRepoLocker())
);
ITermRepoCollateralManager currentTermRepoCollateralManager = termRepoServicer
.termRepoCollateralManager();
for (uint256 i = 0; i < collateralTypes.length; ++i) {
if (collateralAmounts[i] > 0) {
currentTermRepoCollateralManager.acceptRolloverCollateral(
borrower,
collateralTypes[i],
collateralAmounts[i]
);
}
}
}
function _markRolloverAsProcessed(
address rolloverPairOffTermRepoServicer,
address borrower
) internal {
ITermRepoServicer termRepoServicer_ = ITermRepoServicer(
rolloverPairOffTermRepoServicer
);
ITermRepoRolloverManager rolloverManager = termRepoServicer_
.termRepoRolloverManager();
rolloverManager.fulfillRollover(borrower);
}
/// Assigns bids up to `maxAssignable`
/// @dev This method allocates pro-rata across an the marginal price group (pro-rata on the margin) and attempts to prevent residuals from accumulating to a single bid
/// @param sortedBids An array of sorted bids to process
/// @param maxAssignable The maximum bid amount that can be assigned across all bidders
/// @param purchaseTokenDecimals The number of decimals of the purchase token
/// @return The total amount assigned
function _assignBids(
TermAuctionRevealedBid[] memory sortedBids,
uint256 maxAssignable,
uint256 purchaseTokenDecimals
) internal returns (uint256) {
// Process revealed bids.
uint256 totalAssignedBids = 0;
uint256 innerIndex = 0;
uint256 i = 0;
for (uint256 j = sortedBids.length; j > 0; --j) {
i = j - 1;
// First, find the sub-range that contains the current price.
(uint256 k, uint256 priceGroupAmount) = _findFirstIndexForPrice(
sortedBids[i].bidPriceRevealed,
sortedBids,
i
);
// NOTE: priceGroupAmount gets changed later on in this function and is used as the "remaining" priceGroupAmount during partial assignment.
if (
sortedBids[i].bidPriceRevealed >= clearingPrice &&
totalAssignedBids < maxAssignable &&
priceGroupAmount <= (maxAssignable - totalAssignedBids)
) {
// Full assignment for entire price group.
innerIndex = 0;
for (; (i - innerIndex) >= k; ++innerIndex) {
// NOTE: This loop is actually decrementing!
totalAssignedBids += _fullyAssignBid(
sortedBids[i - innerIndex]
);
if (i == innerIndex) {
++innerIndex;
break;
}
}
if (innerIndex > 0) {
j -= (innerIndex - 1);
}
} else if (
sortedBids[i].bidPriceRevealed >= clearingPrice &&
totalAssignedBids < maxAssignable
) {
// Partial assignment for entire price group.
innerIndex = 0;
for (; (i - innerIndex) >= k; ++innerIndex) {
if ((i - innerIndex) == k) {
// Last iteration of loop. Assign remaining amount left to assign.
totalAssignedBids += _partiallyAssignBid(
sortedBids[i - innerIndex],
maxAssignable - totalAssignedBids
);
priceGroupAmount -= maxAssignable - totalAssignedBids;
} else {
// Assign an amount based upon the partial assignment ratio.
uint256 bidAmount = sortedBids[i - innerIndex].amount;
Exp memory partialAssignmentRatio = div_(
Exp({
mantissa: (maxAssignable - totalAssignedBids) *
10 ** (18 - purchaseTokenDecimals)
}),
Exp({
mantissa: priceGroupAmount *
10 ** (18 - purchaseTokenDecimals)
})
);
uint256 assignedAmount = mul_(
partialAssignmentRatio,
Exp({
mantissa: bidAmount *
10 ** (18 - purchaseTokenDecimals)
})
).mantissa / 10 ** (18 - purchaseTokenDecimals);
totalAssignedBids += _partiallyAssignBid(
sortedBids[i - innerIndex],
assignedAmount
);
priceGroupAmount -= sortedBids[i - innerIndex].amount;
}
if (i == innerIndex) {
++innerIndex;
break;
}
}
if (innerIndex > 0) {
j -= (innerIndex - 1);
}
} else {
// No assignment.
if (sortedBids[i].isRollover) {
_markRolloverAsProcessed(
sortedBids[i].rolloverPairOffTermRepoServicer,
sortedBids[i].bidder
);
} else {
termAuctionBidLocker.auctionUnlockBid(
sortedBids[i].id,
sortedBids[i].bidder,
sortedBids[i].collateralTokens,
sortedBids[i].collateralAmounts
);
}
}
}
return totalAssignedBids;
}
/// Assigns offers up to `maxAssignable`
/// @dev This method allocates pro-rata across an the marginal price group (pro-rata on the margin) and attempts to prevent residuals from accumulating to a single offer
/// @param sortedOffers An array of sorted offers to process
/// @param maxAssignable The maximum offer amount that can be assigned across all offers
/// @param purchaseTokenDecimals The number of decimals of the purchase token
/// @return The total amount assigned
function _assignOffers(
TermAuctionRevealedOffer[] memory sortedOffers,
uint256 maxAssignable,
uint256 purchaseTokenDecimals
) internal returns (uint256) {
// Process revealed offers.
uint256 totalAssignedOffers = 0;
uint256 innerIndex = 0;
uint256 i = 0;
for (i = 0; i < sortedOffers.length; ++i) {
// First, find the sub-range that contains the current price.
(uint256 k, uint256 priceGroupAmount) = _findLastIndexForPrice(
sortedOffers[i].offerPriceRevealed,
sortedOffers,
i
);
// NOTE: priceGroupAmount gets changed later on in this function and is used as the "remaining" priceGroupAmount during partial assignment.
if (
sortedOffers[i].offerPriceRevealed <= clearingPrice &&
totalAssignedOffers < maxAssignable &&
priceGroupAmount <= (maxAssignable - totalAssignedOffers)
) {
// Full assignment.
innerIndex = 0;
for (; (innerIndex + i) <= k; ++innerIndex) {
totalAssignedOffers += _fullyAssignOffer(
sortedOffers[innerIndex + i]
);
}
if (innerIndex > 0) {
i += innerIndex - 1;
}
} else if (
sortedOffers[i].offerPriceRevealed <= clearingPrice &&
totalAssignedOffers < maxAssignable
) {
// Partial assignment.
innerIndex = 0;
for (; (innerIndex + i) <= k; innerIndex++) {
if ((innerIndex + i) == k) {
// Last iteration of loop. Assign remaining amount left to assign.
totalAssignedOffers += _partiallyAssignOffer(
sortedOffers[innerIndex + i],
maxAssignable - totalAssignedOffers
);
priceGroupAmount -= maxAssignable - totalAssignedOffers;
} else {
// Assign an amount based upon the partial assignment ratio.
uint256 offerAmount = sortedOffers[innerIndex + i]
.amount;
Exp memory partialAssignmentRatio = div_(
Exp({
mantissa: (maxAssignable -
totalAssignedOffers) *
10 ** (18 - purchaseTokenDecimals)
}),
Exp({
mantissa: priceGroupAmount *
10 ** (18 - purchaseTokenDecimals)
})
);
uint256 assignedAmount = (innerIndex + i) != k
? mul_(
partialAssignmentRatio,
Exp({
mantissa: offerAmount *
10 ** (18 - purchaseTokenDecimals)
})
).mantissa / 10 ** (18 - purchaseTokenDecimals)
: maxAssignable - totalAssignedOffers;
totalAssignedOffers += _partiallyAssignOffer(
sortedOffers[innerIndex + i],
assignedAmount
);
priceGroupAmount -= sortedOffers[innerIndex + i].amount;
}
}
if (innerIndex > 0) {
i += innerIndex - 1;
}
} else {
// No assignment.
// Return purchase tokens to offeror.
termAuctionOfferLocker.unlockOfferPartial(
sortedOffers[i].id,
sortedOffers[i].offeror,
sortedOffers[i].amount
);
}
}
return totalAssignedOffers;
}
/// Calculates repurchase price given a purchase price (equivalent to principal plus interest)
/// @param purchasePrice The purchase price
/// @return The repurchase price obtained by applying the clearing rate on an Actual/360 day-count convention
function _calculateRepurchasePrice(
uint256 purchasePrice
) internal view returns (uint256) {
Exp memory repurchaseFactor = add_(
Exp({mantissa: expScale}),
mul_(
Exp({mantissa: dayCountFractionMantissa}),
Exp({mantissa: clearingPrice})
)
);
return
truncate(
mul_(
Exp({mantissa: purchasePrice * expScale}),
repurchaseFactor
)
);
}
function _calculateAndStoreClearingPrice(
TermAuctionRevealedBid[] memory sortedBids,
TermAuctionRevealedOffer[] memory sortedOffers
) internal nonReentrant returns (uint256, uint256) {
(
uint256 clearingPrice_,
uint256 maxAssignable
) = _calculateClearingPrice(
sortedBids,
sortedOffers,
clearingPricePostProcessingOffset
);
clearingPrice = clearingPrice_;
return (clearingPrice_, maxAssignable);
}
// ========================================================================
// = Pausable =============================================================
// ========================================================================
/// @dev This function pauses the TermAuction contract preventing public state changes
/// @dev See {Pausable-_pause}.
function pauseCompleteAuction() external onlyRole(ADMIN_ROLE) {
completeAuctionPaused = true;
emitter.emitCompleteAuctionPaused(termAuctionId, termRepoId);
}
/// Unpuses the TermAuction contract allowing public state changes
/// @dev See {Pausable-_unpause}.
function unpauseCompleteAuction() external onlyRole(ADMIN_ROLE) {
completeAuctionPaused = false;
emitter.emitCompleteAuctionUnpaused(termAuctionId, termRepoId);
}
///@dev required override by the OpenZeppelin UUPS module
///@param impl new impl address for proxy upgrade
function _authorizeUpgrade(
address impl
) internal override onlyRole(DEVOPS_ROLE) {
emitter.emitTermContractUpgraded(address(this), impl);
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (access/AccessControl.sol)
pragma solidity ^0.8.0;
import "./IAccessControlUpgradeable.sol";
import "../utils/ContextUpgradeable.sol";
import "../utils/StringsUpgradeable.sol";
import "../utils/introspection/ERC165Upgradeable.sol";
import {Initializable} from "../proxy/utils/Initializable.sol";
/**
* @dev Contract module that allows children to implement role-based access
* control mechanisms. This is a lightweight version that doesn't allow enumerating role
* members except through off-chain means by accessing the contract event logs. Some
* applications may benefit from on-chain enumerability, for those cases see
* {AccessControlEnumerable}.
*
* Roles are referred to by their `bytes32` identifier. These should be exposed
* in the external API and be unique. The best way to achieve this is by
* using `public constant` hash digests:
*
* ```solidity
* bytes32 public constant MY_ROLE = keccak256("MY_ROLE");
* ```
*
* Roles can be used to represent a set of permissions. To restrict access to a
* function call, use {hasRole}:
*
* ```solidity
* function foo() public {
* require(hasRole(MY_ROLE, msg.sender));
* ...
* }
* ```
*
* Roles can be granted and revoked dynamically via the {grantRole} and
* {revokeRole} functions. Each role has an associated admin role, and only
* accounts that have a role's admin role can call {grantRole} and {revokeRole}.
*
* By default, the admin role for all roles is `DEFAULT_ADMIN_ROLE`, which means
* that only accounts with this role will be able to grant or revoke other
* roles. More complex role relationships can be created by using
* {_setRoleAdmin}.
*
* WARNING: The `DEFAULT_ADMIN_ROLE` is also its own admin: it has permission to
* grant and revoke this role. Extra precautions should be taken to secure
* accounts that have been granted it. We recommend using {AccessControlDefaultAdminRules}
* to enforce additional security measures for this role.
*/
abstract contract AccessControlUpgradeable is Initializable, ContextUpgradeable, IAccessControlUpgradeable, ERC165Upgradeable {
struct RoleData {
mapping(address => bool) members;
bytes32 adminRole;
}
mapping(bytes32 => RoleData) private _roles;
bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00;
/**
* @dev Modifier that checks that an account has a specific role. Reverts
* with a standardized message including the required role.
*
* The format of the revert reason is given by the following regular expression:
*
* /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/
*
* _Available since v4.1._
*/
modifier onlyRole(bytes32 role) {
_checkRole(role);
_;
}
function __AccessControl_init() internal onlyInitializing {
}
function __AccessControl_init_unchained() internal onlyInitializing {
}
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
return interfaceId == type(IAccessControlUpgradeable).interfaceId || super.supportsInterface(interfaceId);
}
/**
* @dev Returns `true` if `account` has been granted `role`.
*/
function hasRole(bytes32 role, address account) public view virtual override returns (bool) {
return _roles[role].members[account];
}
/**
* @dev Revert with a standard message if `_msgSender()` is missing `role`.
* Overriding this function changes the behavior of the {onlyRole} modifier.
*
* Format of the revert message is described in {_checkRole}.
*
* _Available since v4.6._
*/
function _checkRole(bytes32 role) internal view virtual {
_checkRole(role, _msgSender());
}
/**
* @dev Revert with a standard message if `account` is missing `role`.
*
* The format of the revert reason is given by the following regular expression:
*
* /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/
*/
function _checkRole(bytes32 role, address account) internal view virtual {
if (!hasRole(role, account)) {
revert(
string(
abi.encodePacked(
"AccessControl: account ",
StringsUpgradeable.toHexString(account),
" is missing role ",
StringsUpgradeable.toHexString(uint256(role), 32)
)
)
);
}
}
/**
* @dev Returns the admin role that controls `role`. See {grantRole} and
* {revokeRole}.
*
* To change a role's admin, use {_setRoleAdmin}.
*/
function getRoleAdmin(bytes32 role) public view virtual override returns (bytes32) {
return _roles[role].adminRole;
}
/**
* @dev Grants `role` to `account`.
*
* If `account` had not been already granted `role`, emits a {RoleGranted}
* event.
*
* Requirements:
*
* - the caller must have ``role``'s admin role.
*
* May emit a {RoleGranted} event.
*/
function grantRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {
_grantRole(role, account);
}
/**
* @dev Revokes `role` from `account`.
*
* If `account` had been granted `role`, emits a {RoleRevoked} event.
*
* Requirements:
*
* - the caller must have ``role``'s admin role.
*
* May emit a {RoleRevoked} event.
*/
function revokeRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {
_revokeRole(role, account);
}
/**
* @dev Revokes `role` from the calling account.
*
* Roles are often managed via {grantRole} and {revokeRole}: this function's
* purpose is to provide a mechanism for accounts to lose their privileges
* if they are compromised (such as when a trusted device is misplaced).
*
* If the calling account had been revoked `role`, emits a {RoleRevoked}
* event.
*
* Requirements:
*
* - the caller must be `account`.
*
* May emit a {RoleRevoked} event.
*/
function renounceRole(bytes32 role, address account) public virtual override {
require(account == _msgSender(), "AccessControl: can only renounce roles for self");
_revokeRole(role, account);
}
/**
* @dev Grants `role` to `account`.
*
* If `account` had not been already granted `role`, emits a {RoleGranted}
* event. Note that unlike {grantRole}, this function doesn't perform any
* checks on the calling account.
*
* May emit a {RoleGranted} event.
*
* [WARNING]
* ====
* This function should only be called from the constructor when setting
* up the initial roles for the system.
*
* Using this function in any other way is effectively circumventing the admin
* system imposed by {AccessControl}.
* ====
*
* NOTE: This function is deprecated in favor of {_grantRole}.
*/
function _setupRole(bytes32 role, address account) internal virtual {
_grantRole(role, account);
}
/**
* @dev Sets `adminRole` as ``role``'s admin role.
*
* Emits a {RoleAdminChanged} event.
*/
function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual {
bytes32 previousAdminRole = getRoleAdmin(role);
_roles[role].adminRole = adminRole;
emit RoleAdminChanged(role, previousAdminRole, adminRole);
}
/**
* @dev Grants `role` to `account`.
*
* Internal function without access restriction.
*
* May emit a {RoleGranted} event.
*/
function _grantRole(bytes32 role, address account) internal virtual {
if (!hasRole(role, account)) {
_roles[role].members[account] = true;
emit RoleGranted(role, account, _msgSender());
}
}
/**
* @dev Revokes `role` from `account`.
*
* Internal function without access restriction.
*
* May emit a {RoleRevoked} event.
*/
function _revokeRole(bytes32 role, address account) internal virtual {
if (hasRole(role, account)) {
_roles[role].members[account] = false;
emit RoleRevoked(role, account, _msgSender());
}
}
/**
* @dev This empty reserved space is put in place to allow future versions to add new
* variables without shifting down storage in the inheritance chain.
* See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
*/
uint256[49] private __gap;
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol)
pragma solidity ^0.8.0;
/**
* @dev External interface of AccessControl declared to support ERC165 detection.
*/
interface IAccessControlUpgradeable {
/**
* @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`
*
* `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite
* {RoleAdminChanged} not being emitted signaling this.
*
* _Available since v3.1._
*/
event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);
/**
* @dev Emitted when `account` is granted `role`.
*
* `sender` is the account that originated the contract call, an admin role
* bearer except when using {AccessControl-_setupRole}.
*/
event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);
/**
* @dev Emitted when `account` is revoked `role`.
*
* `sender` is the account that originated the contract call:
* - if using `revokeRole`, it is the admin role bearer
* - if using `renounceRole`, it is the role bearer (i.e. `account`)
*/
event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);
/**
* @dev Returns `true` if `account` has been granted `role`.
*/
function hasRole(bytes32 role, address account) external view returns (bool);
/**
* @dev Returns the admin role that controls `role`. See {grantRole} and
* {revokeRole}.
*
* To change a role's admin, use {AccessControl-_setRoleAdmin}.
*/
function getRoleAdmin(bytes32 role) external view returns (bytes32);
/**
* @dev Grants `role` to `account`.
*
* If `account` had not been already granted `role`, emits a {RoleGranted}
* event.
*
* Requirements:
*
* - the caller must have ``role``'s admin role.
*/
function grantRole(bytes32 role, address account) external;
/**
* @dev Revokes `role` from `account`.
*
* If `account` had been granted `role`, emits a {RoleRevoked} event.
*
* Requirements:
*
* - the caller must have ``role``'s admin role.
*/
function revokeRole(bytes32 role, address account) external;
/**
* @dev Revokes `role` from the calling account.
*
* Roles are often managed via {grantRole} and {revokeRole}: this function's
* purpose is to provide a mechanism for accounts to lose their privileges
* if they are compromised (such as when a trusted device is misplaced).
*
* If the calling account had been granted `role`, emits a {RoleRevoked}
* event.
*
* Requirements:
*
* - the caller must be `account`.
*/
function renounceRole(bytes32 role, address account) external;
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.5.0) (interfaces/draft-IERC1822.sol)
pragma solidity ^0.8.0;
/**
* @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified
* proxy whose upgrades are fully controlled by the current implementation.
*/
interface IERC1822ProxiableUpgradeable {
/**
* @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation
* address.
*
* IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks
* bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this
* function revert if invoked through a proxy.
*/
function proxiableUUID() external view returns (bytes32);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (interfaces/IERC1967.sol)
pragma solidity ^0.8.0;
/**
* @dev ERC-1967: Proxy Storage Slots. This interface contains the events defined in the ERC.
*
* _Available since v4.8.3._
*/
interface IERC1967Upgradeable {
/**
* @dev Emitted when the implementation is upgraded.
*/
event Upgraded(address indexed implementation);
/**
* @dev Emitted when the admin account has changed.
*/
event AdminChanged(address previousAdmin, address newAdmin);
/**
* @dev Emitted when the beacon is changed.
*/
event BeaconUpgraded(address indexed beacon);
}// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (interfaces/IERC20Metadata.sol) pragma solidity ^0.8.0; import "../token/ERC20/extensions/IERC20MetadataUpgradeable.sol";
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol)
pragma solidity ^0.8.0;
/**
* @dev This is the interface that {BeaconProxy} expects of its beacon.
*/
interface IBeaconUpgradeable {
/**
* @dev Must return an address that can be used as a delegate call target.
*
* {BeaconProxy} will check that this address is a contract.
*/
function implementation() external view returns (address);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (proxy/ERC1967/ERC1967Upgrade.sol)
pragma solidity ^0.8.2;
import "../beacon/IBeaconUpgradeable.sol";
import "../../interfaces/IERC1967Upgradeable.sol";
import "../../interfaces/draft-IERC1822Upgradeable.sol";
import "../../utils/AddressUpgradeable.sol";
import "../../utils/StorageSlotUpgradeable.sol";
import {Initializable} from "../utils/Initializable.sol";
/**
* @dev This abstract contract provides getters and event emitting update functions for
* https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots.
*
* _Available since v4.1._
*/
abstract contract ERC1967UpgradeUpgradeable is Initializable, IERC1967Upgradeable {
// This is the keccak-256 hash of "eip1967.proxy.rollback" subtracted by 1
bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143;
/**
* @dev Storage slot with the address of the current implementation.
* This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is
* validated in the constructor.
*/
bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
function __ERC1967Upgrade_init() internal onlyInitializing {
}
function __ERC1967Upgrade_init_unchained() internal onlyInitializing {
}
/**
* @dev Returns the current implementation address.
*/
function _getImplementation() internal view returns (address) {
return StorageSlotUpgradeable.getAddressSlot(_IMPLEMENTATION_SLOT).value;
}
/**
* @dev Stores a new address in the EIP1967 implementation slot.
*/
function _setImplementation(address newImplementation) private {
require(AddressUpgradeable.isContract(newImplementation), "ERC1967: new implementation is not a contract");
StorageSlotUpgradeable.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
}
/**
* @dev Perform implementation upgrade
*
* Emits an {Upgraded} event.
*/
function _upgradeTo(address newImplementation) internal {
_setImplementation(newImplementation);
emit Upgraded(newImplementation);
}
/**
* @dev Perform implementation upgrade with additional setup call.
*
* Emits an {Upgraded} event.
*/
function _upgradeToAndCall(address newImplementation, bytes memory data, bool forceCall) internal {
_upgradeTo(newImplementation);
if (data.length > 0 || forceCall) {
AddressUpgradeable.functionDelegateCall(newImplementation, data);
}
}
/**
* @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call.
*
* Emits an {Upgraded} event.
*/
function _upgradeToAndCallUUPS(address newImplementation, bytes memory data, bool forceCall) internal {
// Upgrades from old implementations will perform a rollback test. This test requires the new
// implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing
// this special case will break upgrade paths from old UUPS implementation to new ones.
if (StorageSlotUpgradeable.getBooleanSlot(_ROLLBACK_SLOT).value) {
_setImplementation(newImplementation);
} else {
try IERC1822ProxiableUpgradeable(newImplementation).proxiableUUID() returns (bytes32 slot) {
require(slot == _IMPLEMENTATION_SLOT, "ERC1967Upgrade: unsupported proxiableUUID");
} catch {
revert("ERC1967Upgrade: new implementation is not UUPS");
}
_upgradeToAndCall(newImplementation, data, forceCall);
}
}
/**
* @dev Storage slot with the admin of the contract.
* This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1, and is
* validated in the constructor.
*/
bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
/**
* @dev Returns the current admin.
*/
function _getAdmin() internal view returns (address) {
return StorageSlotUpgradeable.getAddressSlot(_ADMIN_SLOT).value;
}
/**
* @dev Stores a new address in the EIP1967 admin slot.
*/
function _setAdmin(address newAdmin) private {
require(newAdmin != address(0), "ERC1967: new admin is the zero address");
StorageSlotUpgradeable.getAddressSlot(_ADMIN_SLOT).value = newAdmin;
}
/**
* @dev Changes the admin of the proxy.
*
* Emits an {AdminChanged} event.
*/
function _changeAdmin(address newAdmin) internal {
emit AdminChanged(_getAdmin(), newAdmin);
_setAdmin(newAdmin);
}
/**
* @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy.
* This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor.
*/
bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50;
/**
* @dev Returns the current beacon.
*/
function _getBeacon() internal view returns (address) {
return StorageSlotUpgradeable.getAddressSlot(_BEACON_SLOT).value;
}
/**
* @dev Stores a new beacon in the EIP1967 beacon slot.
*/
function _setBeacon(address newBeacon) private {
require(AddressUpgradeable.isContract(newBeacon), "ERC1967: new beacon is not a contract");
require(
AddressUpgradeable.isContract(IBeaconUpgradeable(newBeacon).implementation()),
"ERC1967: beacon implementation is not a contract"
);
StorageSlotUpgradeable.getAddressSlot(_BEACON_SLOT).value = newBeacon;
}
/**
* @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does
* not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that).
*
* Emits a {BeaconUpgraded} event.
*/
function _upgradeBeaconToAndCall(address newBeacon, bytes memory data, bool forceCall) internal {
_setBeacon(newBeacon);
emit BeaconUpgraded(newBeacon);
if (data.length > 0 || forceCall) {
AddressUpgradeable.functionDelegateCall(IBeaconUpgradeable(newBeacon).implementation(), data);
}
}
/**
* @dev This empty reserved space is put in place to allow future versions to add new
* variables without shifting down storage in the inheritance chain.
* See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
*/
uint256[50] private __gap;
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/Initializable.sol)
pragma solidity ^0.8.2;
import "../../utils/AddressUpgradeable.sol";
/**
* @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed
* behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an
* external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer
* function so it can only be called once. The {initializer} modifier provided by this contract will have this effect.
*
* The initialization functions use a version number. Once a version number is used, it is consumed and cannot be
* reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in
* case an upgrade adds a module that needs to be initialized.
*
* For example:
*
* [.hljs-theme-light.nopadding]
* ```solidity
* contract MyToken is ERC20Upgradeable {
* function initialize() initializer public {
* __ERC20_init("MyToken", "MTK");
* }
* }
*
* contract MyTokenV2 is MyToken, ERC20PermitUpgradeable {
* function initializeV2() reinitializer(2) public {
* __ERC20Permit_init("MyToken");
* }
* }
* ```
*
* TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as
* possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}.
*
* CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure
* that all initializers are idempotent. This is not verified automatically as constructors are by Solidity.
*
* [CAUTION]
* ====
* Avoid leaving a contract uninitialized.
*
* An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation
* contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke
* the {_disableInitializers} function in the constructor to automatically lock it when it is deployed:
*
* [.hljs-theme-light.nopadding]
* ```
* /// @custom:oz-upgrades-unsafe-allow constructor
* constructor() {
* _disableInitializers();
* }
* ```
* ====
*/
abstract contract Initializable {
/**
* @dev Indicates that the contract has been initialized.
* @custom:oz-retyped-from bool
*/
uint8 private _initialized;
/**
* @dev Indicates that the contract is in the process of being initialized.
*/
bool private _initializing;
/**
* @dev Triggered when the contract has been initialized or reinitialized.
*/
event Initialized(uint8 version);
/**
* @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope,
* `onlyInitializing` functions can be used to initialize parent contracts.
*
* Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a
* constructor.
*
* Emits an {Initialized} event.
*/
modifier initializer() {
bool isTopLevelCall = !_initializing;
require(
(isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1),
"Initializable: contract is already initialized"
);
_initialized = 1;
if (isTopLevelCall) {
_initializing = true;
}
_;
if (isTopLevelCall) {
_initializing = false;
emit Initialized(1);
}
}
/**
* @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the
* contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be
* used to initialize parent contracts.
*
* A reinitializer may be used after the original initialization step. This is essential to configure modules that
* are added through upgrades and that require initialization.
*
* When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer`
* cannot be nested. If one is invoked in the context of another, execution will revert.
*
* Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in
* a contract, executing them in the right order is up to the developer or operator.
*
* WARNING: setting the version to 255 will prevent any future reinitialization.
*
* Emits an {Initialized} event.
*/
modifier reinitializer(uint8 version) {
require(!_initializing && _initialized < version, "Initializable: contract is already initialized");
_initialized = version;
_initializing = true;
_;
_initializing = false;
emit Initialized(version);
}
/**
* @dev Modifier to protect an initialization function so that it can only be invoked by functions with the
* {initializer} and {reinitializer} modifiers, directly or indirectly.
*/
modifier onlyInitializing() {
require(_initializing, "Initializable: contract is not initializing");
_;
}
/**
* @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call.
* Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized
* to any version. It is recommended to use this to lock implementation contracts that are designed to be called
* through proxies.
*
* Emits an {Initialized} event the first time it is successfully executed.
*/
function _disableInitializers() internal virtual {
require(!_initializing, "Initializable: contract is initializing");
if (_initialized != type(uint8).max) {
_initialized = type(uint8).max;
emit Initialized(type(uint8).max);
}
}
/**
* @dev Returns the highest version that has been initialized. See {reinitializer}.
*/
function _getInitializedVersion() internal view returns (uint8) {
return _initialized;
}
/**
* @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.
*/
function _isInitializing() internal view returns (bool) {
return _initializing;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (proxy/utils/UUPSUpgradeable.sol)
pragma solidity ^0.8.0;
import "../../interfaces/draft-IERC1822Upgradeable.sol";
import "../ERC1967/ERC1967UpgradeUpgradeable.sol";
import {Initializable} from "./Initializable.sol";
/**
* @dev An upgradeability mechanism designed for UUPS proxies. The functions included here can perform an upgrade of an
* {ERC1967Proxy}, when this contract is set as the implementation behind such a proxy.
*
* A security mechanism ensures that an upgrade does not turn off upgradeability accidentally, although this risk is
* reinstated if the upgrade retains upgradeability but removes the security mechanism, e.g. by replacing
* `UUPSUpgradeable` with a custom implementation of upgrades.
*
* The {_authorizeUpgrade} function must be overridden to include access restriction to the upgrade mechanism.
*
* _Available since v4.1._
*/
abstract contract UUPSUpgradeable is Initializable, IERC1822ProxiableUpgradeable, ERC1967UpgradeUpgradeable {
/// @custom:oz-upgrades-unsafe-allow state-variable-immutable state-variable-assignment
address private immutable __self = address(this);
/**
* @dev Check that the execution is being performed through a delegatecall call and that the execution context is
* a proxy contract with an implementation (as defined in ERC1967) pointing to self. This should only be the case
* for UUPS and transparent proxies that are using the current contract as their implementation. Execution of a
* function through ERC1167 minimal proxies (clones) would not normally pass this test, but is not guaranteed to
* fail.
*/
modifier onlyProxy() {
require(address(this) != __self, "Function must be called through delegatecall");
require(_getImplementation() == __self, "Function must be called through active proxy");
_;
}
/**
* @dev Check that the execution is not being performed through a delegate call. This allows a function to be
* callable on the implementing contract but not through proxies.
*/
modifier notDelegated() {
require(address(this) == __self, "UUPSUpgradeable: must not be called through delegatecall");
_;
}
function __UUPSUpgradeable_init() internal onlyInitializing {
}
function __UUPSUpgradeable_init_unchained() internal onlyInitializing {
}
/**
* @dev Implementation of the ERC1822 {proxiableUUID} function. This returns the storage slot used by the
* implementation. It is used to validate the implementation's compatibility when performing an upgrade.
*
* IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks
* bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this
* function revert if invoked through a proxy. This is guaranteed by the `notDelegated` modifier.
*/
function proxiableUUID() external view virtual override notDelegated returns (bytes32) {
return _IMPLEMENTATION_SLOT;
}
/**
* @dev Upgrade the implementation of the proxy to `newImplementation`.
*
* Calls {_authorizeUpgrade}.
*
* Emits an {Upgraded} event.
*
* @custom:oz-upgrades-unsafe-allow-reachable delegatecall
*/
function upgradeTo(address newImplementation) public virtual onlyProxy {
_authorizeUpgrade(newImplementation);
_upgradeToAndCallUUPS(newImplementation, new bytes(0), false);
}
/**
* @dev Upgrade the implementation of the proxy to `newImplementation`, and subsequently execute the function call
* encoded in `data`.
*
* Calls {_authorizeUpgrade}.
*
* Emits an {Upgraded} event.
*
* @custom:oz-upgrades-unsafe-allow-reachable delegatecall
*/
function upgradeToAndCall(address newImplementation, bytes memory data) public payable virtual onlyProxy {
_authorizeUpgrade(newImplementation);
_upgradeToAndCallUUPS(newImplementation, data, true);
}
/**
* @dev Function that should revert when `msg.sender` is not authorized to upgrade the contract. Called by
* {upgradeTo} and {upgradeToAndCall}.
*
* Normally, this function will use an xref:access.adoc[access control] modifier such as {Ownable-onlyOwner}.
*
* ```solidity
* function _authorizeUpgrade(address) internal override onlyOwner {}
* ```
*/
function _authorizeUpgrade(address newImplementation) internal virtual;
/**
* @dev This empty reserved space is put in place to allow future versions to add new
* variables without shifting down storage in the inheritance chain.
* See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
*/
uint256[50] private __gap;
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (security/ReentrancyGuard.sol)
pragma solidity ^0.8.0;
import {Initializable} from "../proxy/utils/Initializable.sol";
/**
* @dev Contract module that helps prevent reentrant calls to a function.
*
* Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier
* available, which can be applied to functions to make sure there are no nested
* (reentrant) calls to them.
*
* Note that because there is a single `nonReentrant` guard, functions marked as
* `nonReentrant` may not call one another. This can be worked around by making
* those functions `private`, and then adding `external` `nonReentrant` entry
* points to them.
*
* TIP: If you would like to learn more about reentrancy and alternative ways
* to protect against it, check out our blog post
* https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].
*/
abstract contract ReentrancyGuardUpgradeable is Initializable {
// Booleans are more expensive than uint256 or any type that takes up a full
// word because each write operation emits an extra SLOAD to first read the
// slot's contents, replace the bits taken up by the boolean, and then write
// back. This is the compiler's defense against contract upgrades and
// pointer aliasing, and it cannot be disabled.
// The values being non-zero value makes deployment a bit more expensive,
// but in exchange the refund on every call to nonReentrant will be lower in
// amount. Since refunds are capped to a percentage of the total
// transaction's gas, it is best to keep them low in cases like this one, to
// increase the likelihood of the full refund coming into effect.
uint256 private constant _NOT_ENTERED = 1;
uint256 private constant _ENTERED = 2;
uint256 private _status;
function __ReentrancyGuard_init() internal onlyInitializing {
__ReentrancyGuard_init_unchained();
}
function __ReentrancyGuard_init_unchained() internal onlyInitializing {
_status = _NOT_ENTERED;
}
/**
* @dev Prevents a contract from calling itself, directly or indirectly.
* Calling a `nonReentrant` function from another `nonReentrant`
* function is not supported. It is possible to prevent this from happening
* by making the `nonReentrant` function external, and making it call a
* `private` function that does the actual work.
*/
modifier nonReentrant() {
_nonReentrantBefore();
_;
_nonReentrantAfter();
}
function _nonReentrantBefore() private {
// On the first call to nonReentrant, _status will be _NOT_ENTERED
require(_status != _ENTERED, "ReentrancyGuard: reentrant call");
// Any calls to nonReentrant after this point will fail
_status = _ENTERED;
}
function _nonReentrantAfter() private {
// By storing the original value once again, a refund is triggered (see
// https://eips.ethereum.org/EIPS/eip-2200)
_status = _NOT_ENTERED;
}
/**
* @dev Returns true if the reentrancy guard is currently set to "entered", which indicates there is a
* `nonReentrant` function in the call stack.
*/
function _reentrancyGuardEntered() internal view returns (bool) {
return _status == _ENTERED;
}
/**
* @dev This empty reserved space is put in place to allow future versions to add new
* variables without shifting down storage in the inheritance chain.
* See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
*/
uint256[49] private __gap;
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Metadata.sol)
pragma solidity ^0.8.0;
import "../IERC20Upgradeable.sol";
/**
* @dev Interface for the optional metadata functions from the ERC20 standard.
*
* _Available since v4.1._
*/
interface IERC20MetadataUpgradeable is IERC20Upgradeable {
/**
* @dev Returns the name of the token.
*/
function name() external view returns (string memory);
/**
* @dev Returns the symbol of the token.
*/
function symbol() external view returns (string memory);
/**
* @dev Returns the decimals places of the token.
*/
function decimals() external view returns (uint8);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)
pragma solidity ^0.8.0;
/**
* @dev Interface of the ERC20 standard as defined in the EIP.
*/
interface IERC20Upgradeable {
/**
* @dev Emitted when `value` tokens are moved from one account (`from`) to
* another (`to`).
*
* Note that `value` may be zero.
*/
event Transfer(address indexed from, address indexed to, uint256 value);
/**
* @dev Emitted when the allowance of a `spender` for an `owner` is set by
* a call to {approve}. `value` is the new allowance.
*/
event Approval(address indexed owner, address indexed spender, uint256 value);
/**
* @dev Returns the amount of tokens in existence.
*/
function totalSupply() external view returns (uint256);
/**
* @dev Returns the amount of tokens owned by `account`.
*/
function balanceOf(address account) external view returns (uint256);
/**
* @dev Moves `amount` tokens from the caller's account to `to`.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* Emits a {Transfer} event.
*/
function transfer(address to, uint256 amount) external returns (bool);
/**
* @dev Returns the remaining number of tokens that `spender` will be
* allowed to spend on behalf of `owner` through {transferFrom}. This is
* zero by default.
*
* This value changes when {approve} or {transferFrom} are called.
*/
function allowance(address owner, address spender) external view returns (uint256);
/**
* @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* IMPORTANT: Beware that changing an allowance with this method brings the risk
* that someone may use both the old and the new allowance by unfortunate
* transaction ordering. One possible solution to mitigate this race
* condition is to first reduce the spender's allowance to 0 and set the
* desired value afterwards:
* https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
*
* Emits an {Approval} event.
*/
function approve(address spender, uint256 amount) external returns (bool);
/**
* @dev Moves `amount` tokens from `from` to `to` using the
* allowance mechanism. `amount` is then deducted from the caller's
* allowance.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* Emits a {Transfer} event.
*/
function transferFrom(address from, address to, uint256 amount) external returns (bool);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)
pragma solidity ^0.8.1;
/**
* @dev Collection of functions related to the address type
*/
library AddressUpgradeable {
/**
* @dev Returns true if `account` is a contract.
*
* [IMPORTANT]
* ====
* It is unsafe to assume that an address for which this function returns
* false is an externally-owned account (EOA) and not a contract.
*
* Among others, `isContract` will return false for the following
* types of addresses:
*
* - an externally-owned account
* - a contract in construction
* - an address where a contract will be created
* - an address where a contract lived, but was destroyed
*
* Furthermore, `isContract` will also return true if the target contract within
* the same transaction is already scheduled for destruction by `SELFDESTRUCT`,
* which only has an effect at the end of a transaction.
* ====
*
* [IMPORTANT]
* ====
* You shouldn't rely on `isContract` to protect against flash loan attacks!
*
* Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
* like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
* constructor.
* ====
*/
function isContract(address account) internal view returns (bool) {
// This method relies on extcodesize/address.code.length, which returns 0
// for contracts in construction, since the code is only stored at the end
// of the constructor execution.
return account.code.length > 0;
}
/**
* @dev Replacement for Solidity's `transfer`: sends `amount` wei to
* `recipient`, forwarding all available gas and reverting on errors.
*
* https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
* of certain opcodes, possibly making contracts go over the 2300 gas limit
* imposed by `transfer`, making them unable to receive funds via
* `transfer`. {sendValue} removes this limitation.
*
* https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].
*
* IMPORTANT: because control is transferred to `recipient`, care must be
* taken to not create reentrancy vulnerabilities. Consider using
* {ReentrancyGuard} or the
* https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
*/
function sendValue(address payable recipient, uint256 amount) internal {
require(address(this).balance >= amount, "Address: insufficient balance");
(bool success, ) = recipient.call{value: amount}("");
require(success, "Address: unable to send value, recipient may have reverted");
}
/**
* @dev Performs a Solidity function call using a low level `call`. A
* plain `call` is an unsafe replacement for a function call: use this
* function instead.
*
* If `target` reverts with a revert reason, it is bubbled up by this
* function (like regular Solidity function calls).
*
* Returns the raw returned data. To convert to the expected return value,
* use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
*
* Requirements:
*
* - `target` must be a contract.
* - calling `target` with `data` must not revert.
*
* _Available since v3.1._
*/
function functionCall(address target, bytes memory data) internal returns (bytes memory) {
return functionCallWithValue(target, data, 0, "Address: low-level call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
* `errorMessage` as a fallback revert reason when `target` reverts.
*
* _Available since v3.1._
*/
function functionCall(
address target,
bytes memory data,
string memory errorMessage
) internal returns (bytes memory) {
return functionCallWithValue(target, data, 0, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but also transferring `value` wei to `target`.
*
* Requirements:
*
* - the calling contract must have an ETH balance of at least `value`.
* - the called Solidity function must be `payable`.
*
* _Available since v3.1._
*/
function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
}
/**
* @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
* with `errorMessage` as a fallback revert reason when `target` reverts.
*
* _Available since v3.1._
*/
function functionCallWithValue(
address target,
bytes memory data,
uint256 value,
string memory errorMessage
) internal returns (bytes memory) {
require(address(this).balance >= value, "Address: insufficient balance for call");
(bool success, bytes memory returndata) = target.call{value: value}(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a static call.
*
* _Available since v3.3._
*/
function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
return functionStaticCall(target, data, "Address: low-level static call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
* but performing a static call.
*
* _Available since v3.3._
*/
function functionStaticCall(
address target,
bytes memory data,
string memory errorMessage
) internal view returns (bytes memory) {
(bool success, bytes memory returndata) = target.staticcall(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a delegate call.
*
* _Available since v3.4._
*/
function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
return functionDelegateCall(target, data, "Address: low-level delegate call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
* but performing a delegate call.
*
* _Available since v3.4._
*/
function functionDelegateCall(
address target,
bytes memory data,
string memory errorMessage
) internal returns (bytes memory) {
(bool success, bytes memory returndata) = target.delegatecall(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
* the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
*
* _Available since v4.8._
*/
function verifyCallResultFromTarget(
address target,
bool success,
bytes memory returndata,
string memory errorMessage
) internal view returns (bytes memory) {
if (success) {
if (returndata.length == 0) {
// only check isContract if the call was successful and the return data is empty
// otherwise we already know that it was a contract
require(isContract(target), "Address: call to non-contract");
}
return returndata;
} else {
_revert(returndata, errorMessage);
}
}
/**
* @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
* revert reason or using the provided one.
*
* _Available since v4.3._
*/
function verifyCallResult(
bool success,
bytes memory returndata,
string memory errorMessage
) internal pure returns (bytes memory) {
if (success) {
return returndata;
} else {
_revert(returndata, errorMessage);
}
}
function _revert(bytes memory returndata, string memory errorMessage) private pure {
// Look for revert reason and bubble it up if present
if (returndata.length > 0) {
// The easiest way to bubble the revert reason is using memory via assembly
/// @solidity memory-safe-assembly
assembly {
let returndata_size := mload(returndata)
revert(add(32, returndata), returndata_size)
}
} else {
revert(errorMessage);
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.4) (utils/Context.sol)
pragma solidity ^0.8.0;
import {Initializable} from "../proxy/utils/Initializable.sol";
/**
* @dev Provides information about the current execution context, including the
* sender of the transaction and its data. While these are generally available
* via msg.sender and msg.data, they should not be accessed in such a direct
* manner, since when dealing with meta-transactions the account sending and
* paying for execution may not be the actual sender (as far as an application
* is concerned).
*
* This contract is only required for intermediate, library-like contracts.
*/
abstract contract ContextUpgradeable is Initializable {
function __Context_init() internal onlyInitializing {
}
function __Context_init_unchained() internal onlyInitializing {
}
function _msgSender() internal view virtual returns (address) {
return msg.sender;
}
function _msgData() internal view virtual returns (bytes calldata) {
return msg.data;
}
function _contextSuffixLength() internal view virtual returns (uint256) {
return 0;
}
/**
* @dev This empty reserved space is put in place to allow future versions to add new
* variables without shifting down storage in the inheritance chain.
* See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
*/
uint256[50] private __gap;
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)
pragma solidity ^0.8.0;
import "./IERC165Upgradeable.sol";
import {Initializable} from "../../proxy/utils/Initializable.sol";
/**
* @dev Implementation of the {IERC165} interface.
*
* Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
* for the additional interface id that will be supported. For example:
*
* ```solidity
* function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
* return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
* }
* ```
*
* Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
*/
abstract contract ERC165Upgradeable is Initializable, IERC165Upgradeable {
function __ERC165_init() internal onlyInitializing {
}
function __ERC165_init_unchained() internal onlyInitializing {
}
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
return interfaceId == type(IERC165Upgradeable).interfaceId;
}
/**
* @dev This empty reserved space is put in place to allow future versions to add new
* variables without shifting down storage in the inheritance chain.
* See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps
*/
uint256[50] private __gap;
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
pragma solidity ^0.8.0;
/**
* @dev Interface of the ERC165 standard, as defined in the
* https://eips.ethereum.org/EIPS/eip-165[EIP].
*
* Implementers can declare support of contract interfaces, which can then be
* queried by others ({ERC165Checker}).
*
* For an implementation, see {ERC165}.
*/
interface IERC165Upgradeable {
/**
* @dev Returns true if this contract implements the interface defined by
* `interfaceId`. See the corresponding
* https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
* to learn more about how these ids are created.
*
* This function call must use less than 30 000 gas.
*/
function supportsInterface(bytes4 interfaceId) external view returns (bool);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/math/Math.sol)
pragma solidity ^0.8.0;
/**
* @dev Standard math utilities missing in the Solidity language.
*/
library MathUpgradeable {
enum Rounding {
Down, // Toward negative infinity
Up, // Toward infinity
Zero // Toward zero
}
/**
* @dev Returns the largest of two numbers.
*/
function max(uint256 a, uint256 b) internal pure returns (uint256) {
return a > b ? a : b;
}
/**
* @dev Returns the smallest of two numbers.
*/
function min(uint256 a, uint256 b) internal pure returns (uint256) {
return a < b ? a : b;
}
/**
* @dev Returns the average of two numbers. The result is rounded towards
* zero.
*/
function average(uint256 a, uint256 b) internal pure returns (uint256) {
// (a + b) / 2 can overflow.
return (a & b) + (a ^ b) / 2;
}
/**
* @dev Returns the ceiling of the division of two numbers.
*
* This differs from standard division with `/` in that it rounds up instead
* of rounding down.
*/
function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {
// (a + b - 1) / b can overflow on addition, so we distribute.
return a == 0 ? 0 : (a - 1) / b + 1;
}
/**
* @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0
* @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)
* with further edits by Uniswap Labs also under MIT license.
*/
function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) {
unchecked {
// 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use
// use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256
// variables such that product = prod1 * 2^256 + prod0.
uint256 prod0; // Least significant 256 bits of the product
uint256 prod1; // Most significant 256 bits of the product
assembly {
let mm := mulmod(x, y, not(0))
prod0 := mul(x, y)
prod1 := sub(sub(mm, prod0), lt(mm, prod0))
}
// Handle non-overflow cases, 256 by 256 division.
if (prod1 == 0) {
// Solidity will revert if denominator == 0, unlike the div opcode on its own.
// The surrounding unchecked block does not change this fact.
// See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.
return prod0 / denominator;
}
// Make sure the result is less than 2^256. Also prevents denominator == 0.
require(denominator > prod1, "Math: mulDiv overflow");
///////////////////////////////////////////////
// 512 by 256 division.
///////////////////////////////////////////////
// Make division exact by subtracting the remainder from [prod1 prod0].
uint256 remainder;
assembly {
// Compute remainder using mulmod.
remainder := mulmod(x, y, denominator)
// Subtract 256 bit number from 512 bit number.
prod1 := sub(prod1, gt(remainder, prod0))
prod0 := sub(prod0, remainder)
}
// Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.
// See https://cs.stackexchange.com/q/138556/92363.
// Does not overflow because the denominator cannot be zero at this stage in the function.
uint256 twos = denominator & (~denominator + 1);
assembly {
// Divide denominator by twos.
denominator := div(denominator, twos)
// Divide [prod1 prod0] by twos.
prod0 := div(prod0, twos)
// Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.
twos := add(div(sub(0, twos), twos), 1)
}
// Shift in bits from prod1 into prod0.
prod0 |= prod1 * twos;
// Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such
// that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for
// four bits. That is, denominator * inv = 1 mod 2^4.
uint256 inverse = (3 * denominator) ^ 2;
// Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works
// in modular arithmetic, doubling the correct bits in each step.
inverse *= 2 - denominator * inverse; // inverse mod 2^8
inverse *= 2 - denominator * inverse; // inverse mod 2^16
inverse *= 2 - denominator * inverse; // inverse mod 2^32
inverse *= 2 - denominator * inverse; // inverse mod 2^64
inverse *= 2 - denominator * inverse; // inverse mod 2^128
inverse *= 2 - denominator * inverse; // inverse mod 2^256
// Because the division is now exact we can divide by multiplying with the modular inverse of denominator.
// This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is
// less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1
// is no longer required.
result = prod0 * inverse;
return result;
}
}
/**
* @notice Calculates x * y / denominator with full precision, following the selected rounding direction.
*/
function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) {
uint256 result = mulDiv(x, y, denominator);
if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {
result += 1;
}
return result;
}
/**
* @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.
*
* Inspired by Henry S. Warren, Jr.'s "Hacker's Delight" (Chapter 11).
*/
function sqrt(uint256 a) internal pure returns (uint256) {
if (a == 0) {
return 0;
}
// For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.
//
// We know that the "msb" (most significant bit) of our target number `a` is a power of 2 such that we have
// `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.
//
// This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`
// → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`
// → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`
//
// Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.
uint256 result = 1 << (log2(a) >> 1);
// At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,
// since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at
// every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision
// into the expected uint128 result.
unchecked {
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
return min(result, a / result);
}
}
/**
* @notice Calculates sqrt(a), following the selected rounding direction.
*/
function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = sqrt(a);
return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);
}
}
/**
* @dev Return the log in base 2, rounded down, of a positive value.
* Returns 0 if given 0.
*/
function log2(uint256 value) internal pure returns (uint256) {
uint256 result = 0;
unchecked {
if (value >> 128 > 0) {
value >>= 128;
result += 128;
}
if (value >> 64 > 0) {
value >>= 64;
result += 64;
}
if (value >> 32 > 0) {
value >>= 32;
result += 32;
}
if (value >> 16 > 0) {
value >>= 16;
result += 16;
}
if (value >> 8 > 0) {
value >>= 8;
result += 8;
}
if (value >> 4 > 0) {
value >>= 4;
result += 4;
}
if (value >> 2 > 0) {
value >>= 2;
result += 2;
}
if (value >> 1 > 0) {
result += 1;
}
}
return result;
}
/**
* @dev Return the log in base 2, following the selected rounding direction, of a positive value.
* Returns 0 if given 0.
*/
function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = log2(value);
return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);
}
}
/**
* @dev Return the log in base 10, rounded down, of a positive value.
* Returns 0 if given 0.
*/
function log10(uint256 value) internal pure returns (uint256) {
uint256 result = 0;
unchecked {
if (value >= 10 ** 64) {
value /= 10 ** 64;
result += 64;
}
if (value >= 10 ** 32) {
value /= 10 ** 32;
result += 32;
}
if (value >= 10 ** 16) {
value /= 10 ** 16;
result += 16;
}
if (value >= 10 ** 8) {
value /= 10 ** 8;
result += 8;
}
if (value >= 10 ** 4) {
value /= 10 ** 4;
result += 4;
}
if (value >= 10 ** 2) {
value /= 10 ** 2;
result += 2;
}
if (value >= 10 ** 1) {
result += 1;
}
}
return result;
}
/**
* @dev Return the log in base 10, following the selected rounding direction, of a positive value.
* Returns 0 if given 0.
*/
function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = log10(value);
return result + (rounding == Rounding.Up && 10 ** result < value ? 1 : 0);
}
}
/**
* @dev Return the log in base 256, rounded down, of a positive value.
* Returns 0 if given 0.
*
* Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.
*/
function log256(uint256 value) internal pure returns (uint256) {
uint256 result = 0;
unchecked {
if (value >> 128 > 0) {
value >>= 128;
result += 16;
}
if (value >> 64 > 0) {
value >>= 64;
result += 8;
}
if (value >> 32 > 0) {
value >>= 32;
result += 4;
}
if (value >> 16 > 0) {
value >>= 16;
result += 2;
}
if (value >> 8 > 0) {
result += 1;
}
}
return result;
}
/**
* @dev Return the log in base 256, following the selected rounding direction, of a positive value.
* Returns 0 if given 0.
*/
function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = log256(value);
return result + (rounding == Rounding.Up && 1 << (result << 3) < value ? 1 : 0);
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/SignedMath.sol)
pragma solidity ^0.8.0;
/**
* @dev Standard signed math utilities missing in the Solidity language.
*/
library SignedMathUpgradeable {
/**
* @dev Returns the largest of two signed numbers.
*/
function max(int256 a, int256 b) internal pure returns (int256) {
return a > b ? a : b;
}
/**
* @dev Returns the smallest of two signed numbers.
*/
function min(int256 a, int256 b) internal pure returns (int256) {
return a < b ? a : b;
}
/**
* @dev Returns the average of two signed numbers without overflow.
* The result is rounded towards zero.
*/
function average(int256 a, int256 b) internal pure returns (int256) {
// Formula from the book "Hacker's Delight"
int256 x = (a & b) + ((a ^ b) >> 1);
return x + (int256(uint256(x) >> 255) & (a ^ b));
}
/**
* @dev Returns the absolute unsigned value of a signed value.
*/
function abs(int256 n) internal pure returns (uint256) {
unchecked {
// must be unchecked in order to support `n = type(int256).min`
return uint256(n >= 0 ? n : -n);
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/StorageSlot.sol)
// This file was procedurally generated from scripts/generate/templates/StorageSlot.js.
pragma solidity ^0.8.0;
/**
* @dev Library for reading and writing primitive types to specific storage slots.
*
* Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts.
* This library helps with reading and writing to such slots without the need for inline assembly.
*
* The functions in this library return Slot structs that contain a `value` member that can be used to read or write.
*
* Example usage to set ERC1967 implementation slot:
* ```solidity
* contract ERC1967 {
* bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
*
* function _getImplementation() internal view returns (address) {
* return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value;
* }
*
* function _setImplementation(address newImplementation) internal {
* require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract");
* StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation;
* }
* }
* ```
*
* _Available since v4.1 for `address`, `bool`, `bytes32`, `uint256`._
* _Available since v4.9 for `string`, `bytes`._
*/
library StorageSlotUpgradeable {
struct AddressSlot {
address value;
}
struct BooleanSlot {
bool value;
}
struct Bytes32Slot {
bytes32 value;
}
struct Uint256Slot {
uint256 value;
}
struct StringSlot {
string value;
}
struct BytesSlot {
bytes value;
}
/**
* @dev Returns an `AddressSlot` with member `value` located at `slot`.
*/
function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := slot
}
}
/**
* @dev Returns an `BooleanSlot` with member `value` located at `slot`.
*/
function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := slot
}
}
/**
* @dev Returns an `Bytes32Slot` with member `value` located at `slot`.
*/
function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := slot
}
}
/**
* @dev Returns an `Uint256Slot` with member `value` located at `slot`.
*/
function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := slot
}
}
/**
* @dev Returns an `StringSlot` with member `value` located at `slot`.
*/
function getStringSlot(bytes32 slot) internal pure returns (StringSlot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := slot
}
}
/**
* @dev Returns an `StringSlot` representation of the string storage pointer `store`.
*/
function getStringSlot(string storage store) internal pure returns (StringSlot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := store.slot
}
}
/**
* @dev Returns an `BytesSlot` with member `value` located at `slot`.
*/
function getBytesSlot(bytes32 slot) internal pure returns (BytesSlot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := slot
}
}
/**
* @dev Returns an `BytesSlot` representation of the bytes storage pointer `store`.
*/
function getBytesSlot(bytes storage store) internal pure returns (BytesSlot storage r) {
/// @solidity memory-safe-assembly
assembly {
r.slot := store.slot
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/Strings.sol)
pragma solidity ^0.8.0;
import "./math/MathUpgradeable.sol";
import "./math/SignedMathUpgradeable.sol";
/**
* @dev String operations.
*/
library StringsUpgradeable {
bytes16 private constant _SYMBOLS = "0123456789abcdef";
uint8 private constant _ADDRESS_LENGTH = 20;
/**
* @dev Converts a `uint256` to its ASCII `string` decimal representation.
*/
function toString(uint256 value) internal pure returns (string memory) {
unchecked {
uint256 length = MathUpgradeable.log10(value) + 1;
string memory buffer = new string(length);
uint256 ptr;
/// @solidity memory-safe-assembly
assembly {
ptr := add(buffer, add(32, length))
}
while (true) {
ptr--;
/// @solidity memory-safe-assembly
assembly {
mstore8(ptr, byte(mod(value, 10), _SYMBOLS))
}
value /= 10;
if (value == 0) break;
}
return buffer;
}
}
/**
* @dev Converts a `int256` to its ASCII `string` decimal representation.
*/
function toString(int256 value) internal pure returns (string memory) {
return string(abi.encodePacked(value < 0 ? "-" : "", toString(SignedMathUpgradeable.abs(value))));
}
/**
* @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
*/
function toHexString(uint256 value) internal pure returns (string memory) {
unchecked {
return toHexString(value, MathUpgradeable.log256(value) + 1);
}
}
/**
* @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
*/
function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
bytes memory buffer = new bytes(2 * length + 2);
buffer[0] = "0";
buffer[1] = "x";
for (uint256 i = 2 * length + 1; i > 1; --i) {
buffer[i] = _SYMBOLS[value & 0xf];
value >>= 4;
}
require(value == 0, "Strings: hex length insufficient");
return string(buffer);
}
/**
* @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.
*/
function toHexString(address addr) internal pure returns (string memory) {
return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);
}
/**
* @dev Returns true if the two strings are equal.
*/
function equal(string memory a, string memory b) internal pure returns (bool) {
return keccak256(bytes(a)) == keccak256(bytes(b));
}
}//SPDX-License-Identifier: CC-BY-NC-ND-4.0
pragma solidity ^0.8.18;
/// @title ITermAuction Term Auction interface
interface ITermAuction {
function auctionCancelledForWithdrawal() external view returns (bool);
}//SPDX-License-Identifier: CC-BY-NC-ND-4.0
pragma solidity ^0.8.18;
import {ITermAuction} from "./ITermAuction.sol";
import {ITermRepoServicer} from "./ITermRepoServicer.sol";
import {TermAuctionBid} from "../lib/TermAuctionBid.sol";
import {TermAuctionBidSubmission} from "../lib/TermAuctionBidSubmission.sol";
import {TermAuctionRevealedBid} from "../lib/TermAuctionRevealedBid.sol";
import {IERC20Upgradeable} from "@openzeppelin/contracts-upgradeable/token/ERC20/IERC20Upgradeable.sol";
interface ITermAuctionBidLocker {
function termRepoId() external view returns (bytes32);
function termAuctionId() external view returns (bytes32);
function auctionEndTime() external view returns (uint256);
function dayCountFractionMantissa() external view returns (uint256);
function purchaseToken() external view returns (address);
function collateralTokens(
IERC20Upgradeable token
) external view returns (bool);
function termAuction() external view returns (ITermAuction);
function termRepoServicer() external view returns (ITermRepoServicer);
// ========================================================================
// = Interface/API ========================================================
// ========================================================================
/// @param bid A struct containing details of the bid
function lockRolloverBid(TermAuctionBid calldata bid) external;
/// @param bidSubmissions An array of bid submissions
/// @return A bytes32 array of unique on chain bid ids.
function lockBids(
TermAuctionBidSubmission[] calldata bidSubmissions
) external returns (bytes32[] memory);
/// @param bidSubmissions An array of Term Auction bid submissions to borrow an amount of money at rate up to but not exceeding the bid rate
/// @param referralAddress A user address that referred the submitter of this bid
/// @return A bytes32 array of unique on chain bid ids.
function lockBidsWithReferral(
TermAuctionBidSubmission[] calldata bidSubmissions,
address referralAddress
) external returns (bytes32[] memory);
/// @param id A bid Id
/// @return A struct containing details of the locked bid
function lockedBid(
bytes32 id
) external view returns (TermAuctionBid memory);
/// @param ids An array of bid ids of the bids to reveal
/// @param prices An array of the bid prices to reveal
/// @param nonces An array of nonce values to generate bid price hashes
function revealBids(
bytes32[] calldata ids,
uint256[] calldata prices,
uint256[] calldata nonces
) external;
/// @notice unlockBids unlocks multiple bids and returns funds to the borrower
/// @param ids An array of ids to unlock
function unlockBids(bytes32[] calldata ids) external;
// ========================================================================
// = Internal Interface/API ===============================================
// ========================================================================
/// @param revealedBids An array of the revealed offer ids
/// @param expiredRolloverBids An array of the expired rollover bid ids
/// @param unrevealedBids An array of the unrevealed offer ids
/// @return An array of TermAuctionRevealedBid structs containing details of the revealed bids
/// @return An array of TermAuctionBid structs containing details of the unrevealed bids
function getAllBids(
bytes32[] calldata revealedBids,
bytes32[] calldata expiredRolloverBids,
bytes32[] calldata unrevealedBids
)
external
returns (TermAuctionRevealedBid[] memory, TermAuctionBid[] memory);
/// @param id A bytes32 bid id
/// @param bidder The address of the bidder
/// @param bidCollateralTokens The addresses of the token used as collateral
/// @param amounts The amounts of collateral tokens to unlock
function auctionUnlockBid(
bytes32 id,
address bidder,
address[] calldata bidCollateralTokens,
uint256[] calldata amounts
) external;
}//SPDX-License-Identifier: CC-BY-NC-ND-4.0
pragma solidity ^0.8.18;
/// @notice ITermAuctionBidLockerEvents is an interface that defines all events emitted by the Term Auction Bid Locker.
interface ITermAuctionBidLockerEvents {
event TermAuctionBidLockerInitialized(
bytes32 termRepoId,
bytes32 termAuctionId,
address termAuctionBidLocker,
uint256 auctionStartTime,
uint256 revealTime,
uint256 maxBidPrice,
uint256 minimumTenderAmount,
uint256 dayCountFractionMantissa
);
event BidLocked(
bytes32 termAuctionId,
bytes32 id,
address bidder,
bytes32 bidPrice,
uint256 amount,
address token,
address[] collateralTokens,
uint256[] collateralAmounts,
bool isRollover,
address rolloverPairOffTermRepoServicer,
address referralAddress
);
event BidRevealed(bytes32 termAuctionId, bytes32 id, uint256 bidPrice);
event BidUnlocked(bytes32 termAuctionId, bytes32 id);
event BidInShortfall(bytes32 termAuctionId, bytes32 id);
event BidLockingPaused(bytes32 termAuctionId, bytes32 termRepoId);
event BidLockingUnpaused(bytes32 termAuctionId, bytes32 termRepoId);
event BidUnlockingPaused(bytes32 termAuctionId, bytes32 termRepoId);
event BidUnlockingUnpaused(bytes32 termAuctionId, bytes32 termRepoId);
}//SPDX-License-Identifier: CC-BY-NC-ND-4.0
pragma solidity ^0.8.18;
/// @title ITermAuctionErrors defines all errors emitted by the Term Auction
interface ITermAuctionErrors {
/// Term contracts have already been paired.
error AlreadyTermContractPaired();
/// Error emmitted when completing an auction that has already been completed
error AuctionAlreadyCompleted();
/// Error emmitted when completing an auction that has been cancelled for withdrawal
error AuctionCancelledForWithdrawal();
/// Error emmitted when the auction is not closed, but must be
error AuctionNotClosed();
/// Error emitted when the provided clearingOffset is not 0 or 1
error ClearingOffsetNot0Or1(uint256 clearingOffset);
/// Complete Auction has been paused.
error CompleteAuctionPaused();
/// Invalid Parameters passed into function
error InvalidParameters(string message);
/// Error emitted when the maximum binary search depth has been exceeded
error MaxPriceSearchDepthExceeded(uint256 maxDepth);
/// Error emitted when there are no bids or offers
error NoBidsOrOffers();
}//SPDX-License-Identifier: CC-BY-NC-ND-4.0
pragma solidity ^0.8.18;
/// @title ITermAuctionEvents defines all events emitted by the TermAuctionContract.
interface ITermAuctionEvents {
/// Event emitted when a new auction is initialized
/// @param termRepoId The term ID
/// @param termAuctionId The term auction Id
/// @param termAuction auction contract address
/// @param auctionEndTime The auction end time
/// @param version The version tag of the smart contract deployed
event TermAuctionInitialized(
bytes32 termRepoId,
bytes32 termAuctionId,
address termAuction,
uint256 auctionEndTime,
string version
);
/// Event emitted when a bid is assigned
/// @param termAuctionId The auction ID
/// @param id The bid ID
/// @param amount The amount assigned
event BidAssigned(bytes32 termAuctionId, bytes32 id, uint256 amount);
/// Event emitted when an offer is assigned
/// @param termAuctionId The term ID
/// @param id The offer ID
/// @param amount The amount assigned
event OfferAssigned(bytes32 termAuctionId, bytes32 id, uint256 amount);
/// Event emitted when an auction is completed
/// @param termAuctionId The ID of the auction
/// @param timestamp The timestamp of the auction completion
/// @param block The block of the auction completion
/// @param totalAssignedBids The total amount of bids assigned
/// @param totalAssignedOffers The total amount of offers assigned
/// @param clearingPrice The clearing price of the auction
event AuctionCompleted(
bytes32 termAuctionId,
uint256 timestamp,
uint256 block,
uint256 totalAssignedBids,
uint256 totalAssignedOffers,
uint256 clearingPrice
);
/// Event emitted when an auction is cancelled.
/// @param termAuctionId The ID of the auction.
/// @param nonViableAuction Auction not viable due to bid and offer prices not intersecting
/// @param auctionCancelledforWithdrawal Auction has been cancelled for manual fund withdrawal
event AuctionCancelled(
bytes32 termAuctionId,
bool nonViableAuction,
bool auctionCancelledforWithdrawal
);
/// Event emitted when an auction is paused.
/// @param termAuctionId The ID of the auction.
/// @param termRepoId The ID of the repo.
event CompleteAuctionPaused(bytes32 termAuctionId, bytes32 termRepoId);
/// Event emitted when an auction is unpaused.
/// @param termAuctionId The ID of the auction.
/// @param termRepoId The ID of the repo.
event CompleteAuctionUnpaused(bytes32 termAuctionId, bytes32 termRepoId);
}//SPDX-License-Identifier: CC-BY-NC-ND-4.0
pragma solidity ^0.8.18;
import {TermAuctionOffer} from "../lib/TermAuctionOffer.sol";
import {TermAuctionOfferSubmission} from "../lib/TermAuctionOfferSubmission.sol";
import {TermAuctionRevealedOffer} from "../lib/TermAuctionRevealedOffer.sol";
interface ITermAuctionOfferLocker {
function auctionEndTime() external view returns (uint256);
// ========================================================================
// = Interface/API ========================================================
// ========================================================================
/// @param offerSubmissions An array of offer submissions
/// @return A bytes32 array of unique on chain offer ids.
function lockOffers(
TermAuctionOfferSubmission[] calldata offerSubmissions
) external returns (bytes32[] memory);
/// @param offerSubmissions An array of Term Auction offer submissions to lend an amount of money at rate no lower than the offer rate
/// @param referralAddress A user address that referred the submitter of this offer
/// @return A bytes32 array of unique on chain offer ids.
function lockOffersWithReferral(
TermAuctionOfferSubmission[] calldata offerSubmissions,
address referralAddress
) external returns (bytes32[] memory);
/// @param id An offer Id
/// @return A struct containing the details of the locked offer
function lockedOffer(
bytes32 id
) external view returns (TermAuctionOffer memory);
/// @param ids An array offer ids to reveal
/// @param prices An array of the offer prices to reveal
/// @param nonces An array of nonce values to generate bid price hashes
function revealOffers(
bytes32[] calldata ids,
uint256[] calldata prices,
uint256[] calldata nonces
) external;
/// @notice unlockOffers unlocks multiple offers and returns funds to the offeror
/// @param ids An array of offer ids
function unlockOffers(bytes32[] calldata ids) external;
// ========================================================================
// = Internal Interface/API ===============================================
// ========================================================================
/// @param revealedOffers An array of the revealed offer ids
/// @param unrevealedOffers An array of the unrevealed offer ids
/// @return An array of TermAuctionRevealedOffer structs containing details of the revealed offers
/// @return An array of TermAuctionOffer structs containing details of the unrevealed offers
function getAllOffers(
bytes32[] calldata revealedOffers,
bytes32[] calldata unrevealedOffers
)
external
returns (TermAuctionRevealedOffer[] memory, TermAuctionOffer[] memory);
/// @param id An offer Id
/// @param offeror The address of the offeror
/// @param amount The amount to unlock
function unlockOfferPartial(
bytes32 id,
address offeror,
uint256 amount
) external;
}//SPDX-License-Identifier: CC-BY-NC-ND-4.0
pragma solidity ^0.8.18;
/// @notice ITermAuctionOfferLockerEvents is an interface that defines all events emitted by the Term Auction Offer Locker.
interface ITermAuctionOfferLockerEvents {
event TermAuctionOfferLockerInitialized(
bytes32 termRepoId,
bytes32 termAuctionId,
address termAuctionOfferLocker,
uint256 auctionStartTime,
uint256 revealTime,
uint256 maxOfferPrice,
uint256 minimumTenderAmount
);
event OfferLocked(
bytes32 termAuctionId,
bytes32 id,
address offeror,
bytes32 offerPrice,
uint256 amount,
address token,
address referralAddress
);
event OfferRevealed(bytes32 termAuctionId, bytes32 id, uint256 offerPrice);
event OfferUnlocked(bytes32 termAuctionId, bytes32 id);
event OfferLockingPaused(bytes32 termAuctionId, bytes32 termRepoId);
event OfferLockingUnpaused(bytes32 termAuctionId, bytes32 termRepoId);
event OfferUnlockingPaused(bytes32 termAuctionId, bytes32 termRepoId);
event OfferUnlockingUnpaused(bytes32 termAuctionId, bytes32 termRepoId);
}//SPDX-License-Identifier: CC-BY-NC-ND-4.0
pragma solidity ^0.8.18;
import {AuctionMetadata} from "../lib/AuctionMetadata.sol";
/// @notice ITermController is an interface that defines events and functions of the Controller contract.
interface ITermController {
// ========================================================================
// = Interface/API ========================================================
// ========================================================================
/// @notice External view function which returns contract address of treasury wallet
function getTreasuryAddress() external view returns (address);
/// @notice External view function which returns contract address of protocol reserve
function getProtocolReserveAddress() external view returns (address);
/// @notice External view function which returns if contract address is a Term Finance contract or not
/// @param contractAddress input contract address
function isTermDeployed(
address contractAddress
) external view returns (bool);
/// @notice Returns history of all completed auctions within a term
/// @param termRepoId term repo id to look up
function getTermAuctionResults(bytes32 termRepoId) external view returns (AuctionMetadata[] memory auctionMetadata, uint8 numOfAuctions);
// ========================================================================
// = Admin Functions ======================================================
// ========================================================================
/// @notice Initializer function to pair a new Term Auction with the controller
/// @param auction new auction address
function pairAuction(address auction) external;
/// @notice Admin function to update the Term Finance treasury wallet address
/// @param treasuryWallet new treasury address
function updateTreasuryAddress(address treasuryWallet) external;
/// @notice Admin function to update the Term Finance protocol reserve wallet address
/// @param protocolReserveAddress new protocol reserve wallet address
function updateProtocolReserveAddress(
address protocolReserveAddress
) external;
/// @notice Admin function to add a new Term Finance contract to Controller
/// @param termContract new term contract address
function markTermDeployed(address termContract) external;
/// @notice Admin function to remove a contract from Controller
/// @param termContract term contract address to remove
function unmarkTermDeployed(address termContract) external;
/// @notice View Function to lookup if authedUser is granted mint exposure access
/// @param authedUser address to check for mint exposure access
function verifyMintExposureAccess(
address authedUser
) external view returns (bool);
/// @notice Function for auction to add new auction completion information
/// @param termId term Id auction belongs to
/// @param auctionId auction Id for auction
/// @param auctionClearingRate auction clearing rate
function recordAuctionResult(bytes32 termId, bytes32 auctionId, uint256 auctionClearingRate) external;
}//SPDX-License-Identifier: CC-BY-NC-ND-4.0
pragma solidity ^0.8.18;
import {ITermAuctionEvents} from "./ITermAuctionEvents.sol";
import {ITermAuctionBidLockerEvents} from "./ITermAuctionBidLockerEvents.sol";
import {ITermAuctionOfferLockerEvents} from "./ITermAuctionOfferLockerEvents.sol";
import {ITermRepoCollateralManagerEvents} from "./ITermRepoCollateralManagerEvents.sol";
import {ITermRepoServicerEvents} from "./ITermRepoServicerEvents.sol";
import {ITermRepoRolloverManagerEvents} from "./ITermRepoRolloverManagerEvents.sol";
import {ITermRepoLockerEvents} from "./ITermRepoLockerEvents.sol";
import {ITermRepoTokenEvents} from "./ITermRepoTokenEvents.sol";
import {ITermEventEmitterEvents} from "./ITermEventEmitterEvents.sol";
import {TermAuctionBid} from "../lib/TermAuctionBid.sol";
interface ITermEventEmitter is
ITermAuctionEvents,
ITermAuctionBidLockerEvents,
ITermAuctionOfferLockerEvents,
ITermRepoCollateralManagerEvents,
ITermRepoServicerEvents,
ITermRepoRolloverManagerEvents,
ITermRepoLockerEvents,
ITermRepoTokenEvents,
ITermEventEmitterEvents
{
//@param termContract New term contract to pair to event emitter.
function pairTermContract(address termContract) external;
// ========================================================================
// = TermAuction Events ===================================================
// ========================================================================
/// @param termRepoId The id of the current Term Repo deployment being initialized
/// @param termAuctionId The id of the auction being initialized
/// @param termAuction The address of the auction contract being initialized
/// @param auctionEndTime The end time of the auction being initialized
/// @param version The version tag of the smart contract deployed
function emitTermAuctionInitialized(
bytes32 termRepoId,
bytes32 termAuctionId,
address termAuction,
uint256 auctionEndTime,
string calldata version
) external;
/// @param termAuctionId A Term Auction id
/// @param id A bid id
/// @param amount The amount assigned to this bid
function emitBidAssigned(
bytes32 termAuctionId,
bytes32 id,
uint256 amount
) external;
/// @param termAuctionId A Term Auction id
/// @param id An offer id
/// @param amount The amount assigned to this offer
function emitOfferAssigned(
bytes32 termAuctionId,
bytes32 id,
uint256 amount
) external;
/// @param termAuctionId The Term Auction id of auction completed
/// @param timestamp The timestamp of the current block
/// @param blockNumber The number of the current block
/// @param totalAssignedBids The number of assigned bids in the auction
/// @param totalAssignedOffers The number of assigned offers in the auction
/// @param clearingPrice The clearing price of the auction
function emitAuctionCompleted(
bytes32 termAuctionId,
uint256 timestamp,
uint256 blockNumber,
uint256 totalAssignedBids,
uint256 totalAssignedOffers,
uint256 clearingPrice
) external;
/// @param nonViableAuction Auction not viable due to bid and offer prices not intersecting
/// @param auctionCancelledforWithdrawal Auction has been cancelled for withdrawal
function emitAuctionCancelled(
bytes32 termAuctionId,
bool nonViableAuction,
bool auctionCancelledforWithdrawal
) external;
/// @param termAuctionId The id of the auction paused
/// @param termRepoId The Term Repo id associated with auction paused
function emitCompleteAuctionPaused(
bytes32 termAuctionId,
bytes32 termRepoId
) external;
/// @param termAuctionId The id of the auction unpaused
/// @param termRepoId The Term Repo id associated with auction unpaused
function emitCompleteAuctionUnpaused(
bytes32 termAuctionId,
bytes32 termRepoId
) external;
// ========================================================================
// = TermAuctionBidLocker Events ==========================================
// ========================================================================
/// @param termRepoId The Term Repo id associated with BidLocker initialized
/// @param termAuctionId The Term Auction id associated with BidLocker initialized
/// @param termAuctionBidLocker The address of the TermAuctionBidLocker contract being intialized
/// @param auctionStartTime The time at which auction bids will be accepted for submission
/// @param revealTime The time at which sealed auction bids can be revealed
/// @param maxBidPrice The maximum tender price (interest rate) in percentage
/// @param minimumTenderAmount The minimum amount of borrowed purchase token that will be accepted
/// @param dayCountFractionMantissa The day count fraction remainder
function emitTermAuctionBidLockerInitialized(
bytes32 termRepoId,
bytes32 termAuctionId,
address termAuctionBidLocker,
uint256 auctionStartTime,
uint256 revealTime,
uint256 maxBidPrice,
uint256 minimumTenderAmount,
uint256 dayCountFractionMantissa
) external;
/// @param termAuctionId A Term Auction id
/// @param bid A struct containing details of the locked bid
/// @param referralAddress The address of the referrer. Zero Address if none.
function emitBidLocked(
bytes32 termAuctionId,
TermAuctionBid calldata bid,
address referralAddress
) external;
/// @param termAuctionId A Term Auction id
/// @param id The bid id
/// @param bidPrice The revealed price of the bid
function emitBidRevealed(
bytes32 termAuctionId,
bytes32 id,
uint256 bidPrice
) external;
/// @param termAuctionId A Term Auction id
/// @param id A bid id
function emitBidUnlocked(bytes32 termAuctionId, bytes32 id) external;
/// @param termAuctionId A Term Auction id
/// @param id A bid id
function emitBidInShortfall(bytes32 termAuctionId, bytes32 id) external;
/// @param termAuctionId The id of Term Auction where bid locking is paused
/// @param termRepoId The Term Repo id where bid locking is paused
function emitBidLockingPaused(
bytes32 termAuctionId,
bytes32 termRepoId
) external;
/// @param termAuctionId The id of Term Auction where bid locking is unpaused
/// @param termRepoId The Term Repo id where bid locking is unpaused
function emitBidLockingUnpaused(
bytes32 termAuctionId,
bytes32 termRepoId
) external;
/// @param termAuctionId The id of Term Auction where bid unlocking is paused
/// @param termRepoId The Term Repo id where bid unlocking is paused
function emitBidUnlockingPaused(
bytes32 termAuctionId,
bytes32 termRepoId
) external;
/// @param termAuctionId The id of Term Auction where bid unlocking is unpaused
/// @param termRepoId The Term Repo id where bid unlocking is unpaused
function emitBidUnlockingUnpaused(
bytes32 termAuctionId,
bytes32 termRepoId
) external;
// ========================================================================
// = TermAuctionOfferLocker Events ========================================
// ========================================================================
/// @param termRepoId The Term Repo id associated with OfferLocker initialized
/// @param termAuctionId The Term Auction id associated with OfferLocker initialized
/// @param termAuctionOfferLocker The address of the TermAuctionOfferLocker contract being intialized
/// @param auctionStartTime The time at which auction bids will be accepted for submission
/// @param revealTime The time at which sealed auction bids can be revealed
function emitTermAuctionOfferLockerInitialized(
bytes32 termRepoId,
bytes32 termAuctionId,
address termAuctionOfferLocker,
uint256 auctionStartTime,
uint256 revealTime,
uint256 maxOfferPrice,
uint256 minimumTenderAmount
) external;
/// @param termAuctionId A Term Auction id
/// @param id An offer id
/// @param offeror The address of the offeror
/// @param offerPrice The offer price
/// @param amount The amount of purchase tokens offered
/// @param purchaseToken The address of the purchase token being offered
/// @param referralAddress The address of the referrer. Zero Address if none.
function emitOfferLocked(
bytes32 termAuctionId,
bytes32 id,
address offeror,
bytes32 offerPrice,
uint256 amount,
address purchaseToken,
address referralAddress
) external;
/// @param termAuctionId A Term Auction id
/// @param id An offer id
/// @param offerPrice The offer price revealed
function emitOfferRevealed(
bytes32 termAuctionId,
bytes32 id,
uint256 offerPrice
) external;
/// @param termAuctionId A Term Auction id
/// @param id An offer id
function emitOfferUnlocked(bytes32 termAuctionId, bytes32 id) external;
/// @param termAuctionId The id of Term Auction where offer locking is paused
/// @param termRepoId The Term Repo id where offer locking is paused
function emitOfferLockingPaused(
bytes32 termAuctionId,
bytes32 termRepoId
) external;
/// @param termAuctionId The id of Term Auction where offer locking is unpaused
/// @param termRepoId The Term Repo id where offer locking is unpaused
function emitOfferLockingUnpaused(
bytes32 termAuctionId,
bytes32 termRepoId
) external;
/// @param termAuctionId The id of Term Auction where offer unlocking is paused
/// @param termRepoId The Term Repo id where offer unlocking is paused
function emitOfferUnlockingPaused(
bytes32 termAuctionId,
bytes32 termRepoId
) external;
/// @param termAuctionId The id of Term Auction where offer unlocking is unpaused
/// @param termRepoId The Term Repo id where offer unlocking is unpaused
function emitOfferUnlockingUnpaused(
bytes32 termAuctionId,
bytes32 termRepoId
) external;
// ========================================================================
// = TermRepoCollateralManager Events =========================================
// ========================================================================
/// @param termRepoId The Term Repo id associated with collateral manger being initialized
/// @param termRepoCollateralManager The address of the TermRepoCollateralManager contract being intialized
/// @param collateralTokens An array containing a list of the addresses of all accepted collateral tokens
/// @param initialCollateralRatios An array containing the initial collateral ratios for each collateral token
/// @param maintenanceCollateralRatios An array containing the maintenance collateral ratios for each collateral token
/// @param liquidatedDamagesSchedule An array containing the liquidated damages applicable to each collateral token
function emitTermRepoCollateralManagerInitialized(
bytes32 termRepoId,
address termRepoCollateralManager,
address[] calldata collateralTokens,
uint256[] calldata initialCollateralRatios,
uint256[] calldata maintenanceCollateralRatios,
uint256[] calldata liquidatedDamagesSchedule
) external;
/// @param termRepoId The Term Repo id for the Term Repo being reopened
/// @param termRepoCollateralManager The TermRepoCollateralManager address for the Term Repo being reopened
/// @param termAuctionBidLocker New TermAuctionBidLocker to be paired for reopening
function emitPairReopeningBidLocker(
bytes32 termRepoId,
address termRepoCollateralManager,
address termAuctionBidLocker
) external;
/// @param termRepoId A Term Repo id
/// @param borrower The address of the borrower
/// @param collateralToken The address of the collateral token locked
/// @param amount The amount of collateral being locked
function emitCollateralLocked(
bytes32 termRepoId,
address borrower,
address collateralToken,
uint256 amount
) external;
/// @param termRepoId A Term Repo id
/// @param borrower The address of the borrower
/// @param collateralToken The address of the collateral token locked
/// @param amount The amount of collateral being unlocked
function emitCollateralUnlocked(
bytes32 termRepoId,
address borrower,
address collateralToken,
uint256 amount
) external;
/// @param termRepoId A Term Repo id
/// @param borrower The address of the borrower
/// @param liquidator The address of the liquidator
/// @param closureAmount The amount of repurchase exposure covered
/// @param collateralToken The address of the collateral tokens liquidated
/// @param amountLiquidated The amount of collateral tokens liquidated
function emitLiquidation(
bytes32 termRepoId,
address borrower,
address liquidator,
uint256 closureAmount,
address collateralToken,
uint256 amountLiquidated,
uint256 protocolSeizureAmount,
bool defaultLiquidation
) external;
/// @param termRepoId The id of Term Repo where liquidations are paused
function emitLiquidationPaused(bytes32 termRepoId) external;
/// @param termRepoId The id of Term Repo where liquidation is unpaused
function emitLiquidationUnpaused(bytes32 termRepoId) external;
// ========================================================================
// = TermRepoServicer Events ===============================================
// ========================================================================
/// @param termRepoId The Term Repo id associated with TermRepoServicer being initialized
/// @param termRepoServicer The address of the TermRepoServicer contract being initialized
/// @param purchaseToken The address of the purchase token
/// @param maturityTimestamp The time at which repurchase is due
/// @param endOfRepurchaseWindow The time at which the repurchase window ends
/// @param redemptionTimestamp The time when redemption of Term Repo Tokens begins
/// @param servicingFee percentage share of bid amounts charged to bidder
/// @param version The version tag of the smart contract deployed
function emitTermRepoServicerInitialized(
bytes32 termRepoId,
address termRepoServicer,
address purchaseToken,
uint256 maturityTimestamp,
uint256 endOfRepurchaseWindow,
uint256 redemptionTimestamp,
uint256 servicingFee,
string calldata version
) external;
/// @param termRepoId The Term Repo id for the Term Repo being reopened
/// @param termRepoServicer The address of the TermRepoServicer contract for the Term Repo being reopened
/// @param termAuctionOfferLocker The TermAuctionOfferLocker to be paired for reopening
/// @param termAuction The address of the TermAuction contract to be paired for reopening
function emitReopeningOfferLockerPaired(
bytes32 termRepoId,
address termRepoServicer,
address termAuctionOfferLocker,
address termAuction
) external;
/// @param termRepoId A Term Repo id
/// @param offeror The address of the offeror
/// @param amount The offer amount to be locked
/// @notice This event is not to be confused with OfferLocked by TermOfferLocker
/// @notice Both will be triggered, this one specifically refers to corresponding action taken by Term Servicer
function emitOfferLockedByServicer(
bytes32 termRepoId,
address offeror,
uint256 amount
) external;
/// @param termRepoId A Term Repo id
/// @param offeror The address of the offeror
/// @param amount The offer amount to be unlocked
/// @notice This event is not to be confused with OfferUnlocked by TermOfferLocker
/// @notice Both will be triggered, this one specifically refers to corresponding action taken by Term Servicer
function emitOfferUnlockedByServicer(
bytes32 termRepoId,
address offeror,
uint256 amount
) external;
/// @param offerId Unique id for offer
/// @param offeror The address of the offeror
/// @param purchasePrice The offer amount fulfilled
/// @param repurchasePrice The repurchase price due to offeror at maturity
/// @param repoTokensMinted The amount of Term Repo Tokens minted to offeror
function emitOfferFulfilled(
bytes32 offerId,
address offeror,
uint256 purchasePrice,
uint256 repurchasePrice,
uint256 repoTokensMinted
) external;
/// @param termRepoId A Term Repo id
/// @param redeemer The address of the redeemer
/// @param redemptionAmount The amount of TermRepoTokens redeemed
/// @param redemptionHaircut The haircut applied to redemptions (if any) due to unrecoverable repo exposure
function emitTermRepoTokensRedeemed(
bytes32 termRepoId,
address redeemer,
uint256 redemptionAmount,
uint256 redemptionHaircut
) external;
/// @param termRepoId A Term Repo id
/// @param bidder The address of the bidder
/// @param purchasePrice The bid amount fulfilled in auction
/// @param repurchasePrice The repurchase price due at maturity
/// @param servicingFees The fees earned by the protocol
function emitBidFulfilled(
bytes32 termRepoId,
address bidder,
uint256 purchasePrice,
uint256 repurchasePrice,
uint256 servicingFees
) external;
/// @param termRepoId A Term Repo id
/// @param borrower The address of the borrower
/// @param purchasePrice The purchase price received from new TermRepo
/// @param repurchasePrice The new repurchase price due at maturity of new TermRepo
/// @param servicingFees The fees earned by the protocol
function emitExposureOpenedOnRolloverNew(
bytes32 termRepoId,
address borrower,
uint256 purchasePrice,
uint256 repurchasePrice,
uint256 servicingFees
) external;
/// @param termRepoId A Term Repo id
/// @param borrower The address of the borrower
/// @param amountRolled The repurchase exposure balance closed on old Term Repo
function emitExposureClosedOnRolloverExisting(
bytes32 termRepoId,
address borrower,
uint256 amountRolled
) external;
/// @param termRepoId A Term Repo id
/// @param borrower The address of the borrower
/// @param amount The amount submitted for repurchase
function emitRepurchasePaymentSubmitted(
bytes32 termRepoId,
address borrower,
uint256 amount
) external;
/// @param termRepoId A Term Repo id
/// @param authedUser User granted mint exposure access
function emitMintExposureAccessGranted(
bytes32 termRepoId,
address authedUser
) external;
/// @param termRepoId A Term Repo id
/// @param minter The address of the minter
/// @param netTokensReceived The amount of Term Repo Tokens received by minter net of servicing fees
/// @param servicingFeeTokens The number of Term Repo Tokens retained by protocol in servicing fees
/// @param repurchasePrice The repurchase exposure opened by minter against Term Repo Token mint
function emitMintExposure(
bytes32 termRepoId,
address minter,
uint256 netTokensReceived,
uint256 servicingFeeTokens,
uint256 repurchasePrice
) external;
/// @param termRepoId A Term Repo id
/// @param borrower The address of the borrower
/// @param closeAmount The amount of repurchase exposure to close
function emitBurnCollapseExposure(
bytes32 termRepoId,
address borrower,
uint256 closeAmount
) external;
// ========================================================================
// = TermRepoRolloverManager Events ===========================================
// ========================================================================
/// @param termRepoId The Term Repo id associated with TermRepoRolloverManager being initialized
/// @param rolloverManager The address of the TermRepoRolloverManager contract being initialized
function emitTermRepoRolloverManagerInitialized(
bytes32 termRepoId,
address rolloverManager
) external;
/// @param termRepoId The Term Repo id of existing Term Repo
/// @param rolloverTermAuctionId The Term Auction Id that rollover bid will be submitted into
function emitRolloverTermApproved(
bytes32 termRepoId,
bytes32 rolloverTermAuctionId
) external;
/// @param termRepoId The Term Repo id of existing Term Repo
/// @param rolloverTermAuctionId The Term Auction Id whose rollover approval is revoked
function emitRolloverTermApprovalRevoked(
bytes32 termRepoId,
bytes32 rolloverTermAuctionId
) external;
/// @param termRepoId The Term Repo id of existing Term Repo
/// @param rolloverTermRepoId Term Repo Id of Rollover Term Repo
/// @param borrower The address of the borrower
/// @param rolloverAuction The address of the auction being rolled over to
/// @param rolloverAmount The repurchase amount being rolled over
/// @param hashedBidPrice The hash of the rollover bid price
function emitRolloverElection(
bytes32 termRepoId,
bytes32 rolloverTermRepoId,
address borrower,
address rolloverAuction,
uint256 rolloverAmount,
bytes32 hashedBidPrice
) external;
/// @param termRepoId The Term Repo id of existing Term Repo
/// @param borrower The address of the borrower
function emitRolloverCancellation(
bytes32 termRepoId,
address borrower
) external;
/// @param termRepoId The Term Repo id of existing Term Repo
/// @param borrower The address of the borrower
function emitRolloverProcessed(
bytes32 termRepoId,
address borrower
) external;
// ========================================================================
// = TermRepoLocker Events ======================================================
// ========================================================================
/// @param termRepoId The Term Repo id associated with TermRepoLocker contract being initialized
/// @param termRepoLocker The address of the TermRepoLocker contract being initialized
function emitTermRepoLockerInitialized(
bytes32 termRepoId,
address termRepoLocker
) external;
/// @param termRepoId A Term Repo id
function emitTermRepoLockerTransfersPaused(bytes32 termRepoId) external;
/// @param termRepoId A Term Repo id
function emitTermRepoLockerTransfersUnpaused(bytes32 termRepoId) external;
// ========================================================================
// = TermRepoToken Events =====================================================
// ========================================================================
/// @param termRepoId The Term Repo id associated with the TermRepoToken being initalized
/// @param termRepoToken The address of the TermRepoToken contract being initialized
/// @param redemptionRatio The number of purchase tokens redeemable per unit of Term Repo Token at par
function emitTermRepoTokenInitialized(
bytes32 termRepoId,
address termRepoToken,
uint256 redemptionRatio
) external;
/// @param termRepoId The Term Repo id associated with the TermRepoToken where minting is paused
function emitTermRepoTokenMintingPaused(bytes32 termRepoId) external;
/// @param termRepoId The Term Repo id associated with the TermRepoToken where minting is unpaused
function emitTermRepoTokenMintingUnpaused(bytes32 termRepoId) external;
/// @param termRepoId The Term Repo id associated with the TermRepoToken where burning is paused
function emitTermRepoTokenBurningPaused(bytes32 termRepoId) external;
/// @param termRepoId The Term Repo id associated with the TermRepoToken where burning is unpaused
function emitTermRepoTokenBurningUnpaused(bytes32 termRepoId) external;
// ========================================================================
// = TermEventEmitter Events ==============================================
// ========================================================================
/// @param termRepoId The id of the Term Repo being delisted
function emitDelistTermRepo(bytes32 termRepoId) external;
/// @param termAuctionId The id of the Term Auction being delisted
function emitDelistTermAuction(bytes32 termAuctionId) external;
/// @param proxy address of proxy contract
/// @param implementation address of new impl contract proxy has been upgraded to
function emitTermContractUpgraded(
address proxy,
address implementation
) external;
}//SPDX-License-Identifier: CC-BY-NC-ND-4.0
pragma solidity ^0.8.18;
interface ITermEventEmitterEvents {
/// @notice Event emitted when a new Term Repo is delisted on Term Finance
/// @param termRepoId unique identifier for a Term Repo
event DelistTermRepo(bytes32 termRepoId);
/// @notice Event emitted when a new Term Auction is delisted on Term Finance
/// @param termAuctionId unique identifier for a Term Auction
event DelistTermAuction(bytes32 termAuctionId);
/// @notice Event emitted when a Term contract is upgraded to a new implementation
/// @param proxy address of proxy contract
/// @param implementation address of new impl contract proxy has been upgraded to
event TermContractUpgraded(address proxy, address implementation);
}//SPDX-License-Identifier: CC-BY-NC-ND-4.0
pragma solidity ^0.8.18;
import {ExponentialNoError} from "../lib/ExponentialNoError.sol";
import {ITermRepoLocker} from "./ITermRepoLocker.sol";
/// @notice ITermManager represents a contract that manages all
interface ITermRepoCollateralManager {
// ========================================================================
// = State Variables =====================================================
// ========================================================================
function termRepoLocker() external view returns (ITermRepoLocker);
function maintenanceCollateralRatios(
address
) external view returns (uint256);
function initialCollateralRatios(address) external view returns (uint256);
function numOfAcceptedCollateralTokens() external view returns (uint8);
function collateralTokens(uint256 index) external view returns (address);
function encumberedCollateralRemaining() external view returns (bool);
// ========================================================================
// = Auction Functions ===================================================
// ========================================================================
/// @param bidder The bidder's address
/// @param collateralToken The address of the token to be used as collateral
/// @param amount The amount of the token to lock
function auctionLockCollateral(
address bidder,
address collateralToken,
uint256 amount
) external;
/// @param bidder The bidder's address
/// @param collateralToken The address of the token used as collateral
/// @param amount The amount of collateral tokens to unlock
function auctionUnlockCollateral(
address bidder,
address collateralToken,
uint256 amount
) external;
// ========================================================================
// = Rollover Functions ==================================================
// ========================================================================
/// @param borrower The borrower's address
/// @param rolloverProportion The proportion of the collateral to be unlocked, equal to the proportion of the collateral repaid
/// @param rolloverTermRepoLocker The address of the new TermRepoLocker contract to roll into
/// @return An array representing a list of accepted collateral token addresses
/// @return An array containing the amount of collateral tokens to pairoff and transfer to new TermRepoLocker to roll into
function transferRolloverCollateral(
address borrower,
uint256 rolloverProportion,
address rolloverTermRepoLocker
) external returns (address[] memory, uint256[] memory);
/// @param borrower The address of the borrower
/// @param collateralToken The address of a collateral token
/// @param amount The amount of collateral tokens to lock
function acceptRolloverCollateral(
address borrower,
address collateralToken,
uint256 amount
) external;
/// @param rolloverAuction The address of the rollover auction
function approveRolloverAuction(address rolloverAuction) external;
// ========================================================================
// = APIs ================================================================
// ========================================================================
/// @param collateralToken The address of the collateral token to lock
/// @param amount The amount of collateral token to lock
function externalLockCollateral(
address collateralToken,
uint256 amount
) external;
/// @param collateralToken The address of the collateral token to unlock
/// @param amount The amount of collateral token to unlock
function externalUnlockCollateral(
address collateralToken,
uint256 amount
) external;
/// @param borrower The address of the borrower
/// @return The market value of borrower's locked collateral denominated in USD
function getCollateralMarketValue(
address borrower
) external view returns (uint256);
// ========================================================================
// = Margin Maintenance Functions ========================================
// ========================================================================
/// @param borrower The address of the borrower
function unlockCollateralOnRepurchase(address borrower) external;
/// @param borrower The address of the borrower
/// @param collateralTokenAddresses Collateral token addresses
/// @param collateralTokenAmounts Collateral token amounts
function journalBidCollateralToCollateralManager(
address borrower,
address[] calldata collateralTokenAddresses,
uint256[] calldata collateralTokenAmounts
) external;
/// @param borrower The address of the borrower
/// @param collateralToken Collateral token addresse
/// @param amount Collateral token amount
function mintOpenExposureLockCollateral(
address borrower,
address collateralToken,
uint256 amount
) external;
/// @param collateralToken The collateral token address of tokens locked
/// @param amountToLock The amount of collateral tokens to lock
function calculateMintableExposure(
address collateralToken,
uint256 amountToLock
) external view returns (ExponentialNoError.Exp memory);
/// @param borrower The address of the borrower
/// @param collateralToken The collateral token address to query
/// @return uint256 The amount of collateralToken locked on behalf of borrower
function getCollateralBalance(
address borrower,
address collateralToken
) external view returns (uint256);
/// @param borrower The address of the borrower
/// @return An array of collateral token addresses
/// @return An array collateral token balances locked on behalf of borrower
function getCollateralBalances(
address borrower
) external view returns (address[] memory, uint256[] memory);
/// @param borrower The address of the borrower
/// @param closureAmounts An array specifying the amounts of Term Repo exposure the liquidator proposes to cover in liquidation; an amount is required to be specified for each collateral token
function batchDefault(
address borrower,
uint256[] calldata closureAmounts
) external;
/// @param borrower The address of the borrower
/// @param closureAmounts An array specifying the amounts of Term Repo exposure the liquidator proposes to cover in liquidation; an amount is required to be specified for each collateral token
function batchLiquidation(
address borrower,
uint256[] calldata closureAmounts
) external;
/// @param borrower The address of the borrower
/// @param closureRepoTokenAmounts An array specifying the amounts of Term Repo Tokens the liquidator proposes to cover borrower repo exposure in liquidation; an amount is required to be specified for each collateral token
function batchLiquidationWithRepoToken(
address borrower,
uint256[] calldata closureRepoTokenAmounts
) external;
}//SPDX-License-Identifier: CC-BY-NC-ND-4.0
pragma solidity ^0.8.18;
/// @notice ITermRepoCollateralManagerEvents is an interface that defines all events emitted by Term Repo Collateral Manager.
interface ITermRepoCollateralManagerEvents {
/// @notice Event emitted when a Term Repo Collateral Manager is initialized.
/// @param termRepoId term identifier
/// @param collateralTokens addresses of accepted collateral tokens
/// @param initialCollateralRatios list of initial collateral ratios for each collateral token in the same order as collateral tokens list
/// @param maintenanceCollateralRatios list of maintenance ratios for each collateral token in the same order as collateral tokens list
/// @param liquidatedDamagesSchedule liquidation discounts for collateral tokens
event TermRepoCollateralManagerInitialized(
bytes32 termRepoId,
address termRepoCollateralManager,
address[] collateralTokens,
uint256[] initialCollateralRatios,
uint256[] maintenanceCollateralRatios,
uint256[] liquidatedDamagesSchedule
);
/// @notice Event emitted when existing Term Repo Locker is reopened to another auction group
/// @param termRepoId term identifier
/// @param termRepoCollateralManager address of collateral manager
/// @param termAuctionBidLocker address of auction bid locker paired through reopening
event PairReopeningBidLocker(
bytes32 termRepoId,
address termRepoCollateralManager,
address termAuctionBidLocker
);
/// @notice Event emitted when collateral is locked.
/// @param termRepoId term identifier
/// @param borrower address of borrower who locked collateral
/// @param collateralToken address of collateral token
/// @param amount amount of collateral token locked
event CollateralLocked(
bytes32 termRepoId,
address borrower,
address collateralToken,
uint256 amount
);
/// @notice Event emitted when collateral is locked.
/// @param termRepoId term identifier
/// @param borrower address of borrower who locked collateral
/// @param collateralToken address of collateral token
/// @param amount amount of collateral token unlocked
event CollateralUnlocked(
bytes32 termRepoId,
address borrower,
address collateralToken,
uint256 amount
);
/// @notice Event emitted when a liquidation occurs
/// @param termRepoId term identifier
/// @param borrower address of borrower being liquidated
/// @param liquidator address of liquidator
/// @param closureAmount amount of loan repaid by liquidator
/// @param collateralToken address of collateral token liquidated
/// @param amountLiquidated amount of collateral liquidated
/// @param protocolSeizureAmount amount of collateral liquidated and seized by protocol as fee
/// @param defaultLiquidation boolean indicating if liquidation is a default or not
event Liquidation(
bytes32 termRepoId,
address borrower,
address liquidator,
uint256 closureAmount,
address collateralToken,
uint256 amountLiquidated,
uint256 protocolSeizureAmount,
bool defaultLiquidation
);
/// @notice Event emitted when a Liquidations are paused for a term
/// @param termRepoId term identifier
event LiquidationsPaused(bytes32 termRepoId);
/// @notice Event emitted when a Liquidations are unpaused for a term
/// @param termRepoId term identifier
event LiquidationsUnpaused(bytes32 termRepoId);
}//SPDX-License-Identifier: CC-BY-NC-ND-4.0
pragma solidity ^0.8.18;
/// @notice TermRepoLocker contracts lock collateral and purchase tokens
/// @notice Methods should only be callable from paired TermManager.
interface ITermRepoLocker {
/// @notice Locks tokens from origin wallet
/// @notice Reverts if caller doesn't have SERVICER_ROLE
/// @param originWallet Origin wallet to transfer tokens from
/// @param token Address of token being transferred
/// @param amount Amount of tokens to transfer
function transferTokenFromWallet(
address originWallet,
address token,
uint256 amount
) external;
/// @notice Unlocks tokens to destination wallet
/// @dev Reverts if caller doesn't have SERVICER_ROLE
/// @param destinationWallet Destination wallet to unlock tokens to
/// @param token Address of token being unlocked
/// @param amount Amount of tokens to unlock
function transferTokenToWallet(
address destinationWallet,
address token,
uint256 amount
) external;
}//SPDX-License-Identifier: CC-BY-NC-ND-4.0
pragma solidity ^0.8.18;
/// @notice ITermRepoLockerEvents is an interface that defines all events emitted by the TermRepoLocker.
interface ITermRepoLockerEvents {
/// @notice Event emitted when a TermRepoLocker is initialized.
/// @param termRepoId term identifier
/// @param termRepoLocker address of initialized term repo locker
event TermRepoLockerInitialized(bytes32 termRepoId, address termRepoLocker);
/// @notice Event emitted transfers for a TermRepoLocker are paused.
/// @param termRepoId term identifier
event TermRepoLockerTransfersPaused(bytes32 termRepoId);
/// @notice Event emitted transfers for a TermRepoLocker are unpaused.
/// @param termRepoId term identifier
event TermRepoLockerTransfersUnpaused(bytes32 termRepoId);
}//SPDX-License-Identifier: Unlicense
pragma solidity ^0.8.18;
import {TermRepoRolloverElection} from "../lib/TermRepoRolloverElection.sol";
import {TermRepoRolloverElectionSubmission} from "../lib/TermRepoRolloverElectionSubmission.sol";
interface ITermRepoRolloverManager {
// ========================================================================
// = APIs ================================================================
// ========================================================================
/// @notice An external function that accepted Term Repo rollover instructions
/// @param termRepoRolloverElectionSubmission A struct containing borrower rollover instructions
function electRollover(
TermRepoRolloverElectionSubmission
calldata termRepoRolloverElectionSubmission
) external;
/// @notice A view function that returns borrower rollover instructions
/// @param borrower The address of the borrower
/// @return A struct containing borrower rollover instructions
function getRolloverInstructions(
address borrower
) external view returns (TermRepoRolloverElection memory);
/// @notice An external function to cancel previously submitted rollover instructions, if it hasn't been locked into an auction
function cancelRollover() external;
// ========================================================================
// = Fulfiller Functions ================================================
// ========================================================================
/// @notice An external function called by repo servicer to to mark rollover as fulfilled
/// @param borrower The address of the borrower
function fulfillRollover(address borrower) external;
}//SPDX-License-Identifier: Unlicense
pragma solidity ^0.8.18;
/// @notice ITermRepoCollateralManagerEvents is an interface that defines all events emitted by Term Repo Collateral Manager.
interface ITermRepoRolloverManagerEvents {
/// @notice Event emitted when a rollover manager is initialized
/// @param termRepoId A Term Repo id
/// @param rolloverManager Address of rollover manager
event TermRepoRolloverManagerInitialized(
bytes32 termRepoId,
address rolloverManager
);
/// @notice Event emitted when a rollover manager approves a future term as a destination for borrows
/// @param termRepoId A Term Repo id
/// @param rolloverTermAuctionId The Term Auction Id that rollover bid will be submitted into
event RolloverTermApproved(
bytes32 termRepoId,
bytes32 rolloverTermAuctionId
);
/// @notice Event emitted when a rollover manager revokes approval for a future term as a destination for borrows
/// @param termRepoId A Term Repo id
/// @param rolloverTermAuctionId The Term Auction Id that rollover bid will be submitted into
event RolloverTermApprovalRevoked(
bytes32 termRepoId,
bytes32 rolloverTermAuctionId
);
/// @notice Event emitted when a borrower elects a rollover contract
/// @param termRepoId A Term Repo id
/// @param rolloverTermRepoId Term Repo Id of Rollover Term Repo
/// @param borrower The address of the borrower
/// @param rolloverAuction The address of rollover term contract
/// @param rolloverAmount Amount of purchase currency borrower is rolling over
/// @param hashedBidPrice The hash of rollover bid price
event RolloverElection(
bytes32 termRepoId,
bytes32 rolloverTermRepoId,
address borrower,
address rolloverAuction,
uint256 rolloverAmount,
bytes32 hashedBidPrice
);
/// @notice Event emitted when a borrower cancels a rollover election
/// @param termRepoId A Term Repo id
/// @param borrower The address of the borrower
event RolloverCancellation(bytes32 termRepoId, address borrower);
/// @notice Event emitted when a rollover is processed completely
/// @param termRepoId A Term Repo id
/// @param borrower The address of borrower
event RolloverProcessed(bytes32 termRepoId, address borrower);
}//SPDX-License-Identifier: CC-BY-NC-ND-4.0
pragma solidity ^0.8.18;
import {ITermRepoCollateralManager} from "./ITermRepoCollateralManager.sol";
import {ITermRepoRolloverManager} from "./ITermRepoRolloverManager.sol";
import {ITermRepoLocker} from "./ITermRepoLocker.sol";
/// @notice ITermRepoServicer represents a contract that manages all
interface ITermRepoServicer {
// ========================================================================
// = State Variables =====================================================
// ========================================================================
function endOfRepurchaseWindow() external view returns (uint256);
function maturityTimestamp() external view returns (uint256);
function redemptionTimestamp() external view returns (uint256);
function purchaseToken() external view returns (address);
function servicingFee() external view returns (uint256);
function termRepoCollateralManager()
external
view
returns (ITermRepoCollateralManager);
function termRepoRolloverManager()
external
view
returns (ITermRepoRolloverManager);
function termRepoLocker() external view returns (ITermRepoLocker);
// ========================================================================
// = Auction Functions ===================================================
// ========================================================================
/// @param offeror The address of the offeror
/// @param amount The amount of purchase tokens to lock
function lockOfferAmount(address offeror, uint256 amount) external;
/// @param offeror The address of the offeror
/// @param amount The amount of purchase tokens to unlocked
function unlockOfferAmount(address offeror, uint256 amount) external;
/// @param offeror The address of the offeror
/// @param purchasePrice The offer amount to fulfill
/// @param repurchasePrice The repurchase price due to offeror at maturity
/// @param offerId A unique offer id
function fulfillOffer(
address offeror,
uint256 purchasePrice,
uint256 repurchasePrice,
bytes32 offerId
) external;
/// @param redeemer The address of redeemer
/// @param amountToRedeem The amount of TermRepoTokens to redeem
function redeemTermRepoTokens(
address redeemer,
uint256 amountToRedeem
) external;
/// @dev This method allows MINTER_ROLE to open repurchase price exposure against a TermRepoToken mint of corresponding value outside of a Term Auction to create new supply
/// @param amount The amount of Term Repo Tokens to mint
/// @param collateralAmounts An array containing an amount of collateral token for each token in collateral basket
function mintOpenExposure(
uint256 amount,
uint256[] calldata collateralAmounts
) external;
/// @param bidder The address of the bidder
/// @param purchasePrice The bid amount to fulfill
/// @param repurchasePrice The repurchase price due at maturity
/// @param collateralTokens Collateral token addresses
/// @param collateralAmounts Collateral token amounts
/// @param dayCountFractionMantissa Actual/360 day count fraction parameter from Term Auction Group
function fulfillBid(
address bidder,
uint256 purchasePrice,
uint256 repurchasePrice,
address[] calldata collateralTokens,
uint256[] calldata collateralAmounts,
uint256 dayCountFractionMantissa
) external;
// ========================================================================
// = Rollover Functions ==================================================
// ========================================================================
/// @param termAuction The address of a TermAuction contract to receive autioneer role
function approveRolloverAuction(address termAuction) external;
/// @param borrower The address of the borrower rolling into new Term Repo
/// @param purchasePrice The purchase price received from new TermRepo
/// @param repurchasePrice The new repurchase price due at maturity of new TermRepo
/// @param previousTermRepoLocker The address of the old TermRepoLocker contract
/// @param dayCountFractionMantissa Actual/360 day count fraction parameter from Term Auction Group
/// @return The net purchase price received in after deducing protocol servicing fees
function openExposureOnRolloverNew(
address borrower,
uint256 purchasePrice,
uint256 repurchasePrice,
address previousTermRepoLocker,
uint256 dayCountFractionMantissa
) external returns (uint256);
/// @param borrower The address of the borrower
/// @param rolloverSettlementAmount The amount of net proceeds received from new TermRepo to pay down existing repurchase obligation due to old Term Repo
/// @return A uint256 representing the proportion of total repurchase due to old Term Repo from borrower settled by proceeds from new TermRepo
function closeExposureOnRolloverExisting(
address borrower,
uint256 rolloverSettlementAmount
) external returns (uint256);
// ========================================================================
// = APIs ================================================================
// ========================================================================
/// @notice The max repurchase amount is the repurchase balance less any amounts earmarked for rollover
/// @param amount The amount of purchase token to submit for repurchase
function submitRepurchasePayment(uint256 amount) external;
/// @param amountToBurn The amount of TermRepoTokens to burn
function burnCollapseExposure(uint256 amountToBurn) external;
/// @param borrower The address of the borrower to query
/// @return The total repurchase price due at maturity for a given borrower
function getBorrowerRepurchaseObligation(
address borrower
) external view returns (uint256);
/// @param borrower The address of the borrower
/// @param liquidator The address of the liquidator
/// @param amountToCover The amount of repurchase exposure to cover in liquidation
function liquidatorCoverExposure(
address borrower,
address liquidator,
uint256 amountToCover
) external;
/// @param borrower The address of the borrower
/// @param liquidator The address of the liquidator
/// @param amountOfRepoToken The amount of term tokens used to cover in liquidation
/// @return A uint256 representing purchase value of repo tokens burned
function liquidatorCoverExposureWithRepoToken(
address borrower,
address liquidator,
uint256 amountOfRepoToken
) external returns (uint256);
/// @return A boolean that represents whether the term repo locker is balanced
function isTermRepoBalanced() external view returns (bool);
}//SPDX-License-Identifier: CC-BY-NC-ND-4.0
pragma solidity ^0.8.18;
/// @notice ITermRepoServicerEvents is an interface that defines all events emitted by the Term Repo Servicer.
interface ITermRepoServicerEvents {
/// @notice Event emitted when a Term Loan Manager is initialized.
/// @param termRepoId A Term Repo id
/// @param purchaseToken The address of purchase token used for loans and repay
/// @param maturityTimestamp The timestamp at which term reaches maturity
/// @param endOfRepurchaseWindow The timestamp at which Term Repo is closed to repurchase
/// @param redemptionTimestamp The timestamp at which loaners can redeem term repo tokens
/// @param servicingFee percentage share of bid amounts charged to bidder
/// @param version The version tag of the smart contract deployed
event TermRepoServicerInitialized(
bytes32 termRepoId,
address termRepoServicer,
address purchaseToken,
uint256 maturityTimestamp,
uint256 endOfRepurchaseWindow,
uint256 redemptionTimestamp,
uint256 servicingFee,
string version
);
/// @notice Event emitted when a TermRepoLocker is reopened to another auction group
/// @param termRepoId A Term Repo id
/// @param termRepoServicer The address of loan manager
/// @param termAuctionOfferLocker The address of auction offer locker paired through reopening
/// @param termAuction The address of auction paired through reopening
event ReopeningOfferLockerPaired(
bytes32 termRepoId,
address termRepoServicer,
address termAuctionOfferLocker,
address termAuction
);
/// @notice Event emitted when a loan offer is locked.
/// @param termRepoId A Term Repo id
/// @param offeror The address who submitted offer
/// @param amount The amount of purchase token locked for offer
event OfferLockedByServicer(
bytes32 termRepoId,
address offeror,
uint256 amount
);
/// @notice Event emitted when a loan offer is unlocked.
/// @param termRepoId A Term Repo id
/// @param offeror The address who submitted offer
/// @param amount The amount of purchase token unlocked for offer
event OfferUnlockedByServicer(
bytes32 termRepoId,
address offeror,
uint256 amount
);
/// @notice Event emitted when a loan offer is fulfilled.
/// @param offerId A unique offer id
/// @param offeror The address whose offer is fulfilled
/// @param purchasePrice The purchasePrice of loan offer fulfilled
/// @param repurchasePrice The repurchasePrice of loan offer fulfilled
/// @param repoTokensMinted The amount of Term Repo Tokens minted to offeror
event OfferFulfilled(
bytes32 offerId,
address offeror,
uint256 purchasePrice,
uint256 repurchasePrice,
uint256 repoTokensMinted
);
/// @notice Event emitted when a term repo token is redeemed.
/// @param termRepoId A Term Repo id
/// @param redeemer The address who is redeeming term repo tokens
/// @param redemptionAmount The amount of loan offer redeemed by term repo tokens
/// @param redemptionHaircut The haircut applied to redemptions (if any) due to unrecoverable repo exposure
event TermRepoTokensRedeemed(
bytes32 termRepoId,
address redeemer,
uint256 redemptionAmount,
uint256 redemptionHaircut
);
/// @notice Event emitted when a loan is processed to a borrower
/// @param termRepoId A Term Repo id
/// @param bidder The address who is receiving the loan
/// @param purchasePrice The purchasePrice transferred to borrower
/// @param repurchasePrice The repurchasePrice owed by borrower at maturity
/// @param servicingFees The protocol fees paid for loan
event BidFulfilled(
bytes32 termRepoId,
address bidder,
uint256 purchasePrice,
uint256 repurchasePrice,
uint256 servicingFees
);
/// @notice Event emitted when mint exposure access is granted
/// @param termRepoId A Term Repo id
/// @param authedUser User granted mint exposure access
event MintExposureAccessGranted(bytes32 termRepoId, address authedUser);
/// @notice Event emitted when a rollover from a previous loan opens a position in this new term
/// @param termRepoId A Term Repo id
/// @param borrower The borrower who has loan position opened in new term
/// @param purchasePrice The purchasePrice transferred to previous term
/// @param repurchasePrice The repurchasePrice owed by borrower at maturity
/// @param servicingFees The protocol fees paid for loan
event ExposureOpenedOnRolloverNew(
bytes32 termRepoId,
address borrower,
uint256 purchasePrice,
uint256 repurchasePrice,
uint256 servicingFees
);
/// @notice Event emitted when a rollover from a previous loan opens a position in this new term
/// @param termRepoId A Term Repo id
/// @param borrower The borrower who has loan position opened in new term
/// @param amountRolled The amount of borrower loan collapsed by rollover opening
event ExposureClosedOnRolloverExisting(
bytes32 termRepoId,
address borrower,
uint256 amountRolled
);
/// @notice Event emitted when term repo tokens are minted for a loan
/// @param termRepoId A Term Repo id
/// @param minter The address who is opening the loan
/// @param netTokensReceived The amount of Term Repo Tokens received by minter net of servicing fees
/// @param servicingFeeTokens The number of Term Repo Tokens retained by protocol in servicing fees
/// @param repurchasePrice The repurchase exposure opened by minter against Term Repo Token mint
event TermRepoTokenMint(
bytes32 termRepoId,
address minter,
uint256 netTokensReceived,
uint256 servicingFeeTokens,
uint256 repurchasePrice
);
/// @notice Event emitted when a loan is collapsed by burning term repo tokens
/// @param termRepoId A Term Repo id
/// @param borrower The address who is repaying the loan
/// @param amountToClose The amount repaid by borrower
event BurnCollapseExposure(
bytes32 termRepoId,
address borrower,
uint256 amountToClose
);
/// @notice Event emitted when a loan is repaid by borrower
/// @param termRepoId A Term Repo id
/// @param borrower The address who is repaying the loan
/// @param repurchaseAmount The amount repaid by borrower
event RepurchasePaymentSubmitted(
bytes32 termRepoId,
address borrower,
uint256 repurchaseAmount
);
}//SPDX-License-Identifier: CC-BY-NC-ND-4.0
pragma solidity ^0.8.18;
/// @notice ITermRepoTokenEvents is an interface that defines all events emitted by the Term Repo Token
interface ITermRepoTokenEvents {
/// @notice Event emitted when a Term Repo Servicer is initialized.
/// @param termRepoId term identifier
/// @param termRepoToken address of initialized term repo token
/// @param redemptionRatio The number of purchase tokens redeemable per unit of Term Repo Token at par
event TermRepoTokenInitialized(
bytes32 termRepoId,
address termRepoToken,
uint256 redemptionRatio
);
/// @notice Event emitted when a Term Repo Token Minting is Paused
/// @param termRepoId A Term Repo id
event TermRepoTokenMintingPaused(bytes32 termRepoId);
/// @notice Event emitted when a Term Repo Token Minting is Unpaused
/// @param termRepoId A Term Repo id
event TermRepoTokenMintingUnpaused(bytes32 termRepoId);
/// @notice Event emitted when a Term Repo Token Burning is Paused
/// @param termRepoId A Term Repo id
event TermRepoTokenBurningPaused(bytes32 termRepoId);
/// @notice Event emitted when a Term Repo Token Burning is Unpaused
/// @param termRepoId A Term Repo id
event TermRepoTokenBurningUnpaused(bytes32 termRepoId);
}//SPDX-License-Identifier: CC-BY-NC-ND-4.0
pragma solidity ^0.8.18;
struct AuctionMetadata {
bytes32 termAuctionId;
uint256 auctionClearingRate;
uint256 auctionClearingBlockTimestamp;
}//SPDX-License-Identifier: CC-BY-NC-ND-4.0
pragma solidity ^0.8.18;
/// @dev TermAuctionOffer represents an offer to lend an specific amount of tokens at a specific interest rate (or better)
struct CompleteAuctionInput {
bytes32[] revealedBidSubmissions;
bytes32[] expiredRolloverBids;
bytes32[] unrevealedBidSubmissions;
bytes32[] revealedOfferSubmissions;
bytes32[] unrevealedOfferSubmissions;
}// SPDX-License-Identifier: BSD-3-Clause
pragma solidity ^0.8.18;
// solhint-disable
/**
* @title Exponential module for storing fixed-precision decimals
* @author Compound
* @notice Exp is a struct which stores decimals with a fixed precision of 18 decimal places.
* Thus, if we wanted to store the 5.1, mantissa would store 5.1e18. That is:
* `Exp({mantissa: 5100000000000000000})`.
*/
contract ExponentialNoError {
uint256 constant expScale = 1e18;
uint256 constant doubleScale = 1e36;
struct Exp {
uint256 mantissa;
}
struct Double {
uint256 mantissa;
}
/**
* @dev Truncates the given exp to a whole number value.
* For example, truncate(Exp{mantissa: 15 * expScale}) = 15
*/
function truncate(Exp memory exp) internal pure returns (uint256) {
// Note: We are not using careful math here as we're performing a division that cannot fail
return exp.mantissa / expScale;
}
/**
* @dev Multiply an Exp by a scalar, then truncate to return an unsigned integer.
*/
function mul_ScalarTruncate(
Exp memory a,
uint256 scalar
) internal pure returns (uint256) {
Exp memory product = mul_(a, scalar);
return truncate(product);
}
/**
* @dev Multiply an Exp by a scalar, truncate, then add an to an unsigned integer, returning an unsigned integer.
*/
function mul_ScalarTruncateAddUInt(
Exp memory a,
uint256 scalar,
uint256 addend
) internal pure returns (uint256) {
Exp memory product = mul_(a, scalar);
return add_(truncate(product), addend);
}
/**
* @dev Checks if first Exp is less than second Exp.
*/
function lessThanExp(
Exp memory left,
Exp memory right
) internal pure returns (bool) {
return left.mantissa < right.mantissa;
}
/**
* @dev Checks if left Exp <= right Exp.
*/
function lessThanOrEqualExp(
Exp memory left,
Exp memory right
) internal pure returns (bool) {
return left.mantissa <= right.mantissa;
}
/**
* @dev Checks if left Exp > right Exp.
*/
function greaterThanExp(
Exp memory left,
Exp memory right
) internal pure returns (bool) {
return left.mantissa > right.mantissa;
}
/**
* @dev returns true if Exp is exactly zero
*/
function isZeroExp(Exp memory value) internal pure returns (bool) {
return value.mantissa == 0;
}
function safe224(
uint256 n,
string memory errorMessage
) internal pure returns (uint224) {
require(n < 2 ** 224, errorMessage);
return uint224(n);
}
function safe32(
uint256 n,
string memory errorMessage
) internal pure returns (uint32) {
require(n < 2 ** 32, errorMessage);
return uint32(n);
}
function add_(
Exp memory a,
Exp memory b
) internal pure returns (Exp memory) {
return Exp({mantissa: add_(a.mantissa, b.mantissa)});
}
function add_(
Double memory a,
Double memory b
) internal pure returns (Double memory) {
return Double({mantissa: add_(a.mantissa, b.mantissa)});
}
function add_(uint256 a, uint256 b) internal pure returns (uint256) {
return a + b;
}
function sub_(
Exp memory a,
Exp memory b
) internal pure returns (Exp memory) {
return Exp({mantissa: sub_(a.mantissa, b.mantissa)});
}
function sub_(
Double memory a,
Double memory b
) internal pure returns (Double memory) {
return Double({mantissa: sub_(a.mantissa, b.mantissa)});
}
function sub_(uint256 a, uint256 b) internal pure returns (uint256) {
return a - b;
}
function mul_(
Exp memory a,
Exp memory b
) internal pure returns (Exp memory) {
return Exp({mantissa: mul_(a.mantissa, b.mantissa) / expScale});
}
function mul_(Exp memory a, uint256 b) internal pure returns (Exp memory) {
return Exp({mantissa: mul_(a.mantissa, b)});
}
function mul_(uint256 a, Exp memory b) internal pure returns (uint256) {
return mul_(a, b.mantissa) / expScale;
}
function mul_(
Double memory a,
Double memory b
) internal pure returns (Double memory) {
return Double({mantissa: mul_(a.mantissa, b.mantissa) / doubleScale});
}
function mul_(
Double memory a,
uint256 b
) internal pure returns (Double memory) {
return Double({mantissa: mul_(a.mantissa, b)});
}
function mul_(uint256 a, Double memory b) internal pure returns (uint256) {
return mul_(a, b.mantissa) / doubleScale;
}
function mul_(uint256 a, uint256 b) internal pure returns (uint256) {
return a * b;
}
function div_(
Exp memory a,
Exp memory b
) internal pure returns (Exp memory) {
return Exp({mantissa: div_(mul_(a.mantissa, expScale), b.mantissa)});
}
function div_(Exp memory a, uint256 b) internal pure returns (Exp memory) {
return Exp({mantissa: div_(a.mantissa, b)});
}
function div_(uint256 a, Exp memory b) internal pure returns (uint256) {
return div_(mul_(a, expScale), b.mantissa);
}
function div_(
Double memory a,
Double memory b
) internal pure returns (Double memory) {
return
Double({mantissa: div_(mul_(a.mantissa, doubleScale), b.mantissa)});
}
function div_(
Double memory a,
uint256 b
) internal pure returns (Double memory) {
return Double({mantissa: div_(a.mantissa, b)});
}
function div_(uint256 a, Double memory b) internal pure returns (uint256) {
return div_(mul_(a, doubleScale), b.mantissa);
}
function div_(uint256 a, uint256 b) internal pure returns (uint256) {
return a / b;
}
function fraction(
uint256 a,
uint256 b
) internal pure returns (Double memory) {
return Double({mantissa: div_(mul_(a, doubleScale), b)});
}
}
// solhint-enable//SPDX-License-Identifier: CC-BY-NC-ND-4.0
pragma solidity ^0.8.18;
/// @dev TermAuctionBid represents a bid to borrow a specific amount of tokens at a specific interest rate (or better)
struct TermAuctionBid {
/// @dev Unique identifier for this bid
bytes32 id;
/// @dev The address of the bidder
address bidder;
/// @dev Hash of the offered price as a percentage of the initial loaned amount vs amount returned at maturity. This stores 9 decimal places
bytes32 bidPriceHash;
/// @dev Revealed bid price; this is only a valid value if isRevealed is true; this stores 18 decimal places
uint256 bidPriceRevealed;
/// @dev The maximum amount of purchase tokens that can be borrowed
uint256 amount;
/// @dev The amount of collateral tokens initially locked
uint256[] collateralAmounts;
/// @dev The address of the ERC20 purchase token
address purchaseToken;
/// @dev The addresses of the collateral ERC20 tokens in the bid
address[] collateralTokens;
/// @dev A boolean indicating if bid was submitted as rollover from previous term
bool isRollover;
/// @dev The address of term repo servicer whose bid is being rolled over
address rolloverPairOffTermRepoServicer;
/// @dev A boolean that is true if bid has been revealed
bool isRevealed;
}//SPDX-License-Identifier: CC-BY-NC-ND-4.0
pragma solidity ^0.8.18;
/// @dev TermAuctionBidSubmission represents a bid submission to borrow an amount of money for a specific interest rate
struct TermAuctionBidSubmission {
/// @dev For an existing bid this is the unique onchain identifier for this bid. For a new bid this is a randomized input that will be used to generate the unique onchain identifier.
bytes32 id;
/// @dev The address of the bidder
address bidder;
/// @dev Hash of the offered price as a percentage of the initial loaned amount vs amount returned at maturity. This stores 9 decimal places
bytes32 bidPriceHash;
/// @dev The maximum amount of purchase tokens that can be borrowed
uint256 amount;
/// @dev The amount of collateral tokens initially locked
uint256[] collateralAmounts;
/// @dev The address of the ERC20 purchase token
address purchaseToken;
/// @dev The addresses of the collateral ERC20 tokens in the bid
address[] collateralTokens;
}//SPDX-License-Identifier: CC-BY-NC-ND-4.0
pragma solidity ^0.8.18;
/// @dev TermAuctionOffer represents an offer to offeror an amount of money for a specific interest rate
struct TermAuctionOffer {
/// @dev Unique identifier for this bid
bytes32 id;
/// @dev The address of the offeror
address offeror;
/// @dev Hash of the offered price as a percentage of the initial loaned amount vs amount returned at maturity. This stores 9 decimal places
bytes32 offerPriceHash;
/// @dev Revealed offer price. This is not valid unless isRevealed is true. This stores 18 decimal places
uint256 offerPriceRevealed;
/// @dev The maximum amount of purchase tokens that can be lent
uint256 amount;
/// @dev The address of the ERC20 purchase token
address purchaseToken;
/// @dev Is offer price revealed
bool isRevealed;
}//SPDX-License-Identifier: CC-BY-NC-ND-4.0
pragma solidity ^0.8.18;
/// @dev TermAuctionOfferSubmission represents an offer submission to offeror an amount of money for a specific interest rate
struct TermAuctionOfferSubmission {
/// @dev For an existing offer this is the unique onchain identifier for this offer. For a new offer this is a randomized input that will be used to generate the unique onchain identifier.
bytes32 id;
/// @dev The address of the offeror
address offeror;
/// @dev Hash of the offered price as a percentage of the initial loaned amount vs amount returned at maturity. This stores 9 decimal places
bytes32 offerPriceHash;
/// @dev The maximum amount of purchase tokens that can be lent
uint256 amount;
/// @dev The address of the ERC20 purchase token
address purchaseToken;
}//SPDX-License-Identifier: CC-BY-NC-ND-4.0
pragma solidity ^0.8.18;
/// @dev TermAuctionBid represents a bid to borrow an amount of money for a specific interest rate
struct TermAuctionRevealedBid {
/// @dev Unique identifier for this bid
bytes32 id;
/// @dev The address of the bidder
address bidder;
/// @dev The offered price as a percentage of the initial loaned amount vs amount returned at maturity. This stores 9 decimal places
uint256 bidPriceRevealed;
/// @dev The maximum amount of TermRepoTokens borrowed. This stores 18 decimal places
uint256 amount;
/// @dev The amount of collateral tokens initially locked
uint256[] collateralAmounts;
/// @dev The purchase token address
address purchaseToken;
/// @dev The collateral token address
address[] collateralTokens;
/// @dev A boolean indicating whether bid is submitted as rollover from previous term
bool isRollover;
/// @dev The address of term repo servicer whose bid is being rolled over
address rolloverPairOffTermRepoServicer;
}//SPDX-License-Identifier: CC-BY-NC-ND-4.0
pragma solidity ^0.8.18;
/// @dev TermAuctionBid represents an offer to offeror an amount of money for a specific interest rate
struct TermAuctionRevealedOffer {
/// @dev Unique identifier for this bid
bytes32 id;
/// @dev The address of the offeror
address offeror;
/// @dev The offered price as a percentage of the initial loaned amount vs amount returned at maturity. This stores 9 decimal places
uint256 offerPriceRevealed;
/// @dev The maximum amount of purchase tokens offered
uint256 amount;
/// @dev The address of the lent ERC20 token
address purchaseToken;
}//SPDX-License-Identifier: Unlicense
pragma solidity ^0.8.18;
/// @dev TermRepoRolloverElection represents an election to rollover a borrow into a future term
struct TermRepoRolloverElection {
/// @dev The address of the term auction bidlocker that loan is being rolled into
address rolloverAuctionBidLocker;
/// @dev The amount of loan being rolled over
uint256 rolloverAmount;
/// @dev The hashed value of the rollover bid price to place in the rollover auction
bytes32 rolloverBidPriceHash;
/// @dev A boolean testing whether rollover has been successfully processsed: false if bid fails to lock or is not successful in rollover auction
bool processed;
}//SPDX-License-Identifier: Unlicense
pragma solidity ^0.8.18;
/// @dev TermRepoRolloverElectionSubmission represents a user submission for a rollover election to a future term
struct TermRepoRolloverElectionSubmission {
/// @dev The address of the term auction bidlocker that loan is being rolled into
address rolloverAuctionBidLocker;
/// @dev The amount of loan being rolled over
uint256 rolloverAmount;
///@dev The hashed value of the rollover bid price to place in the rollover auction
bytes32 rolloverBidPriceHash;
}//SPDX-License-Identifier: CC-BY-NC-ND-4.0
pragma solidity ^0.8.18;
/// @author TermLabs
/// @title Versionable contract
/// @notice This contract adds a version string that can be queried to all contracts that inherit from it.
/// @dev The version returned is replaced during the build process.
contract Versionable {
/// @dev This function returns the version of the contract.
function version() external view returns (string memory) {
return "0.9.0";
}
}{
"optimizer": {
"enabled": true,
"runs": 50
},
"outputSelection": {
"*": {
"*": [
"evm.bytecode",
"evm.deployedBytecode",
"devdoc",
"userdoc",
"metadata",
"abi"
]
}
},
"libraries": {}
}Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
Contract ABI
API[{"inputs":[],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"AlreadyTermContractPaired","type":"error"},{"inputs":[],"name":"AuctionAlreadyCompleted","type":"error"},{"inputs":[],"name":"AuctionCancelledForWithdrawal","type":"error"},{"inputs":[],"name":"AuctionNotClosed","type":"error"},{"inputs":[{"internalType":"uint256","name":"clearingOffset","type":"uint256"}],"name":"ClearingOffsetNot0Or1","type":"error"},{"inputs":[],"name":"CompleteAuctionPaused","type":"error"},{"inputs":[{"internalType":"string","name":"message","type":"string"}],"name":"InvalidParameters","type":"error"},{"inputs":[{"internalType":"uint256","name":"maxDepth","type":"uint256"}],"name":"MaxPriceSearchDepthExceeded","type":"error"},{"inputs":[],"name":"NoBidsOrOffers","type":"error"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"previousAdmin","type":"address"},{"indexed":false,"internalType":"address","name":"newAdmin","type":"address"}],"name":"AdminChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"beacon","type":"address"}],"name":"BeaconUpgraded","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"previousAdminRole","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"newAdminRole","type":"bytes32"}],"name":"RoleAdminChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleGranted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleRevoked","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"implementation","type":"address"}],"name":"Upgraded","type":"event"},{"inputs":[],"name":"ADMIN_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEFAULT_ADMIN_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DEVOPS_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"INITIALIZER_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"THREESIXTY_DAYCOUNT_SECONDS","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"auctionCancelledForWithdrawal","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"auctionCompleted","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"auctionEndTime","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"components":[{"internalType":"bytes32[]","name":"revealedBidSubmissions","type":"bytes32[]"},{"internalType":"bytes32[]","name":"expiredRolloverBids","type":"bytes32[]"},{"internalType":"bytes32[]","name":"unrevealedBidSubmissions","type":"bytes32[]"},{"internalType":"bytes32[]","name":"revealedOfferSubmissions","type":"bytes32[]"},{"internalType":"bytes32[]","name":"unrevealedOfferSubmissions","type":"bytes32[]"}],"internalType":"struct CompleteAuctionInput","name":"completeAuctionInput","type":"tuple"}],"name":"cancelAuction","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address[]","name":"rolloverBorrowers","type":"address[]"},{"internalType":"address[]","name":"rolloverPairOffTermRepoServicer","type":"address[]"}],"name":"cancelAuctionForWithdrawal","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"clearingPrice","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"clearingPricePostProcessingOffset","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"components":[{"internalType":"bytes32[]","name":"revealedBidSubmissions","type":"bytes32[]"},{"internalType":"bytes32[]","name":"expiredRolloverBids","type":"bytes32[]"},{"internalType":"bytes32[]","name":"unrevealedBidSubmissions","type":"bytes32[]"},{"internalType":"bytes32[]","name":"revealedOfferSubmissions","type":"bytes32[]"},{"internalType":"bytes32[]","name":"unrevealedOfferSubmissions","type":"bytes32[]"}],"internalType":"struct CompleteAuctionInput","name":"completeAuctionInput","type":"tuple"}],"name":"completeAuction","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"completeAuctionPaused","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"controller","outputs":[{"internalType":"contract ITermController","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"dayCountFractionMantissa","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"}],"name":"getRoleAdmin","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"grantRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"hasRole","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"termRepoId_","type":"string"},{"internalType":"string","name":"auctionId_","type":"string"},{"internalType":"uint256","name":"auctionEndTime_","type":"uint256"},{"internalType":"uint256","name":"termStart_","type":"uint256"},{"internalType":"uint256","name":"redemptionTimestamp_","type":"uint256"},{"internalType":"contract IERC20MetadataUpgradeable","name":"purchaseToken_","type":"address"},{"internalType":"address","name":"termAuctionInitializer_","type":"address"},{"internalType":"uint256","name":"clearingPricePostProcessingOffset_","type":"uint256"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract ITermEventEmitter","name":"emitter_","type":"address"},{"internalType":"contract ITermController","name":"controller_","type":"address"},{"internalType":"contract ITermRepoServicer","name":"termRepoServicer_","type":"address"},{"internalType":"contract ITermAuctionBidLocker","name":"termAuctionBidLocker_","type":"address"},{"internalType":"contract ITermAuctionOfferLocker","name":"termAuctionOfferLocker_","type":"address"},{"internalType":"address","name":"devopsMultisigAddress_","type":"address"},{"internalType":"address","name":"adminWallet_","type":"address"},{"internalType":"string","name":"version_","type":"string"}],"name":"pairTermContracts","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"pauseCompleteAuction","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"proxiableUUID","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"purchaseToken","outputs":[{"internalType":"contract IERC20MetadataUpgradeable","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"renounceRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"revokeRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"termAuctionBidLocker","outputs":[{"internalType":"contract ITermAuctionBidLocker","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"termAuctionId","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"termAuctionOfferLocker","outputs":[{"internalType":"contract ITermAuctionOfferLocker","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"termRepoId","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"termRepoServicer","outputs":[{"internalType":"contract ITermRepoServicer","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"unpauseCompleteAuction","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newImplementation","type":"address"}],"name":"upgradeTo","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newImplementation","type":"address"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"upgradeToAndCall","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"version","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"}]Contract Creation Code
60a0604052306080523480156200001557600080fd5b506200002062000026565b620000e7565b600054610100900460ff1615620000935760405162461bcd60e51b815260206004820152602760248201527f496e697469616c697a61626c653a20636f6e747261637420697320696e697469604482015266616c697a696e6760c81b606482015260840160405180910390fd5b60005460ff90811614620000e5576000805460ff191660ff9081179091556040519081527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b565b608051615b7f6200011f6000396000818161072801528181610768015281816107f00152818161083001526108a80152615b7f6000f3fe6080604052600436106101cf5760003560e01c8063700e3e2a116100f8578063c794564e11610090578063c794564e1461053f578063cc5b6e4a14610554578063d547741f1461056b578063d6725d0c1461058b578063e8c856f1146105a3578063f0436387146105c3578063f691fac1146105e4578063f77c479114610604578063fa2a3cca1461062557600080fd5b8063700e3e2a14610439578063743a8f881461045057806375b238fc1461047057806376f9a41e146104925780637a6944c5146104b25780638dfea9e7146104c957806391d14854146104e9578063a217fddf14610509578063a95c4d621461051e57600080fd5b80633659cfe61161016b5780633659cfe6146103335780634b449cba146103535780634f1ef2861461036a578063505d799e1461037d57806352d1902d1461039e57806354fd4d50146103b35780635fb8f3ed146103e75780636125be55146104025780636d7331411461042257600080fd5b806301ffc9a7146101d457806306b282c914610209578063201a662514610237578063248a9ca31461026757806327df3d3e146102975780632f2ff15d146102b957806332a0f2d7146102db578063357a77d2146102f257806336568abe14610313575b600080fd5b3480156101e057600080fd5b506101f46101ef3660046148ba565b61063a565b60405190151581526020015b60405180910390f35b34801561021557600080fd5b506101325461022a906001600160a01b031681565b60405161020091906148e4565b34801561024357600080fd5b50610259600080516020615aa383398151915281565b604051908152602001610200565b34801561027357600080fd5b506102596102823660046148f8565b600090815260c9602052604090206001015490565b3480156102a357600080fd5b50610259600080516020615ac383398151915281565b3480156102c557600080fd5b506102d96102d4366004614926565b610671565b005b3480156102e757600080fd5b506102596101375481565b3480156102fe57600080fd5b506101315461022a906001600160a01b031681565b34801561031f57600080fd5b506102d961032e366004614926565b61069b565b34801561033f57600080fd5b506102d961034e366004614956565b61071e565b34801561035f57600080fd5b5061025961012f5481565b6102d9610378366004614a49565b6107e6565b34801561038957600080fd5b506101335461022a906001600160a01b031681565b3480156103aa57600080fd5b5061025961089b565b3480156103bf57600080fd5b5060408051808201825260058152640302e392e360dc1b602082015290516102009190614b14565b3480156103f357600080fd5b50610139546101f49060ff1681565b34801561040e57600080fd5b506102d961041d366004614b88565b610949565b34801561042e57600080fd5b5061025961012e5481565b34801561044557600080fd5b506102596101385481565b34801561045c57600080fd5b506102d961046b366004614c88565b610b53565b34801561047c57600080fd5b50610259600080516020615b2a83398151915281565b34801561049e57600080fd5b506102d96104ad366004614cf3565b610c8b565b3480156104be57600080fd5b506102596101305481565b3480156104d557600080fd5b50610139546101f490610100900460ff1681565b3480156104f557600080fd5b506101f4610504366004614926565b611387565b34801561051557600080fd5b50610259600081565b34801561052a57600080fd5b506101345461022a906001600160a01b031681565b34801561054b57600080fd5b506102d96113b2565b34801561056057600080fd5b5061025961012d5481565b34801561057757600080fd5b506102d9610586366004614926565b611453565b34801561059757600080fd5b506102596301da9c0081565b3480156105af57600080fd5b506102d96105be366004614d2d565b611478565b3480156105cf57600080fd5b50610139546101f49062010000900460ff1681565b3480156105f057600080fd5b506102d96105ff366004614cf3565b6115e0565b34801561061057600080fd5b506101365461022a906001600160a01b031681565b34801561063157600080fd5b506102d961209e565b60006001600160e01b03198216637965db0b60e01b148061066b57506301ffc9a760e01b6001600160e01b03198316145b92915050565b600082815260c9602052604090206001015461068c81612102565b610696838361210c565b505050565b6001600160a01b03811633146107105760405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201526e103937b632b9903337b91039b2b63360891b60648201526084015b60405180910390fd5b61071a8282612192565b5050565b6001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001630036107665760405162461bcd60e51b815260040161070790614df5565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03166107986121f9565b6001600160a01b0316146107be5760405162461bcd60e51b815260040161070790614e41565b6107c781612215565b604080516000808252602082019092526107e391839190612297565b50565b6001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016300361082e5760405162461bcd60e51b815260040161070790614df5565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03166108606121f9565b6001600160a01b0316146108865760405162461bcd60e51b815260040161070790614e41565b61088f82612215565b61071a82826001612297565b6000306001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016146109365760405162461bcd60e51b815260206004820152603860248201527f555550535570677261646561626c653a206d757374206e6f742062652063616c6044820152771b1959081d1a1c9bdd59da0819195b1959d85d1958d85b1b60421b6064820152608401610707565b50600080516020615ae383398151915290565b600054610100900460ff16158080156109695750600054600160ff909116105b8061098a575061097830612402565b15801561098a575060005460ff166001145b6109ed5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610707565b6000805460ff191660011790558015610a10576000805461ff0019166101001790555b610a18612411565b610a20612411565b610a2861243a565b610a40600080516020615ac38339815191528461210c565b8a8a604051602001610a53929190614e8d565b60408051601f1981840301815290829052805160209182012061012d55610a7e918b918b9101614e8d565b60408051601f19818403018152919052805160209091012061012e5561012f8790556301da9c00670de0b6b3a7640000610ab88888614eb3565b610ac29190614ec6565b610acc9190614edd565b6101305561013480546001600160a01b0319166001600160a01b038616179055610139805463ff00ffff191690556101388290558015610b46576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050505050505050565b61012f544211610b765760405163b9adeefd60e01b815260040160405180910390fd5b600080516020615b2a833981519152610b8e81612102565b60005b84811015610bff57610bef848483818110610bae57610bae614eff565b9050602002016020810190610bc39190614956565b878784818110610bd557610bd5614eff565b9050602002016020810190610bea9190614956565b612469565b610bf881614f15565b9050610b91565b50610139805461ff001916610100908117918290556101355461012e5460405163504c5d5d60e11b81526001600160a01b039092169363a098baba93610c52936000929190910460ff1690600401614f2e565b600060405180830381600087803b158015610c6c57600080fd5b505af1158015610c80573d6000803e3d6000fd5b505050505050505050565b61012f544211610cae5760405163b9adeefd60e01b815260040160405180910390fd5b600080516020615b2a833981519152610cc681612102565b6101325460009081906001600160a01b031663f9202d63610ce78680614f46565b610cf46020890189614f46565b610d0160408b018b614f46565b6040518763ffffffff1660e01b8152600401610d2296959493929190614fc1565b6000604051808303816000875af1158015610d41573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052610d699190810190615281565b61013354919350915060009081906001600160a01b031663c44cee73610d926060890189614f46565b610d9f60808b018b614f46565b6040518563ffffffff1660e01b8152600401610dbe9493929190615413565b6000604051808303816000875af1158015610ddd573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052610e05919081019061551a565b9150915060005b8451811015610f7457848181518110610e2757610e27614eff565b602002602001015160e0015115610e8257610e7d858281518110610e4d57610e4d614eff565b60200260200101516101000151868381518110610e6c57610e6c614eff565b602002602001015160200151612469565b610f64565b6101325485516001600160a01b0390911690630283ce5b90879084908110610eac57610eac614eff565b602002602001015160000151878481518110610eca57610eca614eff565b602002602001015160200151888581518110610ee857610ee8614eff565b602002602001015160c00151898681518110610f0657610f06614eff565b6020026020010151608001516040518563ffffffff1660e01b8152600401610f319493929190615692565b600060405180830381600087803b158015610f4b57600080fd5b505af1158015610f5f573d6000803e3d6000fd5b505050505b610f6d81614f15565b9050610e0c565b5060005b8251811015611054576101335483516001600160a01b0390911690630c57f41490859084908110610fab57610fab614eff565b602002602001015160000151858481518110610fc957610fc9614eff565b602002602001015160200151868581518110610fe757610fe7614eff565b6020026020010151606001516040518463ffffffff1660e01b8152600401611011939291906156ce565b600060405180830381600087803b15801561102b57600080fd5b505af115801561103f573d6000803e3d6000fd5b505050508061104d90614f15565b9050610f78565b5060005b83518110156111b05783818151811061107357611073614eff565b60200260200101516101000151156110be576110b984828151811061109a5761109a614eff565b60200260200101516101200151858381518110610e6c57610e6c614eff565b6111a0565b6101325484516001600160a01b0390911690630283ce5b908690849081106110e8576110e8614eff565b60200260200101516000015186848151811061110657611106614eff565b60200260200101516020015187858151811061112457611124614eff565b602002602001015160e0015188868151811061114257611142614eff565b602002602001015160a001516040518563ffffffff1660e01b815260040161116d9493929190615692565b600060405180830381600087803b15801561118757600080fd5b505af115801561119b573d6000803e3d6000fd5b505050505b6111a981614f15565b9050611058565b5060005b8151811015611290576101335482516001600160a01b0390911690630c57f414908490849081106111e7576111e7614eff565b60200260200101516000015184848151811061120557611205614eff565b60200260200101516020015185858151811061122357611223614eff565b6020026020010151608001516040518463ffffffff1660e01b815260040161124d939291906156ce565b600060405180830381600087803b15801561126757600080fd5b505af115801561127b573d6000803e3d6000fd5b505050508061128990614f15565b90506111b4565b6101355461012e5460405163504c5d5d60e11b81526001600160a01b039092169163a098baba916112c8916000908190600401614f2e565b600060405180830381600087803b1580156112e257600080fd5b505af11580156112f6573d6000803e3d6000fd5b5050505061013160009054906101000a90046001600160a01b03166001600160a01b0316634dabab106040518163ffffffff1660e01b8152600401602060405180830381865afa15801561134e573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061137291906156ed565b61137e5761137e615708565b50505050505050565b600091825260c9602090815260408084206001600160a01b0393909316845291905290205460ff1690565b600080516020615b2a8339815191526113ca81612102565b610139805462ff00001916620100001790556101355461012e5461012d54604051635fdd148760e01b81526001600160a01b0390931692635fdd14879261141e929091600401918252602082015260400190565b600060405180830381600087803b15801561143857600080fd5b505af115801561144c573d6000803e3d6000fd5b5050505050565b600082815260c9602052604090206001015461146e81612102565b6106968383612192565b600080516020615ac383398151915261149081612102565b610139546301000000900460ff16156114bc57604051634ce377bb60e11b815260040160405180910390fd5b610139805463ff0000001916630100000017905561013580546001600160a01b03808d166001600160a01b03199283161790925561013680548c841690831617905561013180548b841690831617905561013280548a8416908316179055610133805492891692909116919091179055611544600080516020615aa38339815191528661210c565b61155c600080516020615b2a8339815191528561210c565b6101355461012d5461012e5461012f5460405163383a8ab160e01b81526001600160a01b039094169363383a8ab1936115a293909290913091908a908a9060040161571e565b600060405180830381600087803b1580156115bc57600080fd5b505af11580156115d0573d6000803e3d6000fd5b5050505050505050505050505050565b61012f5442116116035760405163b9adeefd60e01b815260040160405180910390fd5b6101395462010000900460ff161561162e57604051631298d6db60e01b815260040160405180910390fd5b6101395460ff16156116535760405163f02c1d9560e01b815260040160405180910390fd5b61013954610100900460ff161561167d57604051632d93dc5b60e21b815260040160405180910390fd5b610139805460ff191660011790556116a3600080516020615b2a83398151915233611387565b6117465760006116b66040830183614f46565b905011806116d2575060006116ce6080830183614f46565b9050115b156117465760405163dd23c3ad60e01b815260206004820152603d60248201527f416c6c2074656e64657220707269636573206d7573742062652072657665616c60448201527f656420666f722061756374696f6e20746f20626520636f6d706c6574650000006064820152608401610707565b6101325460009081906001600160a01b031663f9202d636117678580614f46565b6117746020880188614f46565b61178160408a018a614f46565b6040518763ffffffff1660e01b81526004016117a296959493929190614fc1565b6000604051808303816000875af11580156117c1573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526117e99190810190615281565b61013354919350915060009081906001600160a01b031663c44cee736118126060880188614f46565b61181f60808a018a614f46565b6040518563ffffffff1660e01b815260040161183e9493929190615413565b6000604051808303816000875af115801561185d573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052611885919081019061551a565b915091506000845111801561189b575060008251115b80156118ef5750816000815181106118b5576118b5614eff565b60200260200101516040015184600186516118d09190614eb3565b815181106118e0576118e0614eff565b60200260200101516040015110155b15611a9c5760006119008584612539565b915050600061013460009054906101000a90046001600160a01b03166001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa158015611959573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061197d9190615771565b60ff169050600061198f878484612573565b9050600061199e868585612a3c565b6101355461012e5461013754604051630ef1216760e41b81526004810192909252426024830152436044830152606482018690526084820184905260a48201529192506001600160a01b03169063ef1216709060c401600060405180830381600087803b158015611a0e57600080fd5b505af1158015611a22573d6000803e3d6000fd5b50506101365461012d5461012e546101375460405163a2a61aed60e01b81526001600160a01b03909416955063a2a61aed9450611a6193600401615794565b600060405180830381600087803b158015611a7b57600080fd5b505af1158015611a8f573d6000803e3d6000fd5b5050505050505050611dfd565b60005b8451811015611bd757848181518110611aba57611aba614eff565b602002602001015160e0015115611ae557611ae0858281518110610e4d57610e4d614eff565b611bc7565b6101325485516001600160a01b0390911690630283ce5b90879084908110611b0f57611b0f614eff565b602002602001015160000151878481518110611b2d57611b2d614eff565b602002602001015160200151888581518110611b4b57611b4b614eff565b602002602001015160c00151898681518110611b6957611b69614eff565b6020026020010151608001516040518563ffffffff1660e01b8152600401611b949493929190615692565b600060405180830381600087803b158015611bae57600080fd5b505af1158015611bc2573d6000803e3d6000fd5b505050505b611bd081614f15565b9050611a9f565b5060005b8251811015611cb7576101335483516001600160a01b0390911690630c57f41490859084908110611c0e57611c0e614eff565b602002602001015160000151858481518110611c2c57611c2c614eff565b602002602001015160200151868581518110611c4a57611c4a614eff565b6020026020010151606001516040518463ffffffff1660e01b8152600401611c74939291906156ce565b600060405180830381600087803b158015611c8e57600080fd5b505af1158015611ca2573d6000803e3d6000fd5b5050505080611cb090614f15565b9050611bdb565b5060008451118015611cca575060008251115b8015611d1d575081600081518110611ce457611ce4614eff565b6020026020010151604001518460018651611cff9190614eb3565b81518110611d0f57611d0f614eff565b602002602001015160400151105b15611d92576101355461012e5460405163504c5d5d60e11b81526001600160a01b039092169163a098baba91611d5b91600190600090600401614f2e565b600060405180830381600087803b158015611d7557600080fd5b505af1158015611d89573d6000803e3d6000fd5b50505050611dfd565b6101355461012e5460405163504c5d5d60e11b81526001600160a01b039092169163a098baba91611dca916000908190600401614f2e565b600060405180830381600087803b158015611de457600080fd5b505af1158015611df8573d6000803e3d6000fd5b505050505b60005b8351811015611f3957838181518110611e1b57611e1b614eff565b6020026020010151610100015115611e4757611e4284828151811061109a5761109a614eff565b611f29565b6101325484516001600160a01b0390911690630283ce5b90869084908110611e7157611e71614eff565b602002602001015160000151868481518110611e8f57611e8f614eff565b602002602001015160200151878581518110611ead57611ead614eff565b602002602001015160e00151888681518110611ecb57611ecb614eff565b602002602001015160a001516040518563ffffffff1660e01b8152600401611ef69493929190615692565b600060405180830381600087803b158015611f1057600080fd5b505af1158015611f24573d6000803e3d6000fd5b505050505b611f3281614f15565b9050611e00565b5060005b8151811015612019576101335482516001600160a01b0390911690630c57f41490849084908110611f7057611f70614eff565b602002602001015160000151848481518110611f8e57611f8e614eff565b602002602001015160200151858581518110611fac57611fac614eff565b6020026020010151608001516040518463ffffffff1660e01b8152600401611fd6939291906156ce565b600060405180830381600087803b158015611ff057600080fd5b505af1158015612004573d6000803e3d6000fd5b505050508061201290614f15565b9050611f3d565b5061013160009054906101000a90046001600160a01b03166001600160a01b0316634dabab106040518163ffffffff1660e01b8152600401602060405180830381865afa15801561206e573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061209291906156ed565b61144c5761144c615708565b600080516020615b2a8339815191526120b681612102565b610139805462ff0000191690556101355461012e5461012d5460405162d9568360e21b8152600481019290925260248201526001600160a01b03909116906303655a0c9060440161141e565b6107e38133612e3e565b6121168282611387565b61071a57600082815260c9602090815260408083206001600160a01b03851684529091529020805460ff1916600117905561214e3390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b61219c8282611387565b1561071a57600082815260c9602090815260408083206001600160a01b0385168085529252808320805460ff1916905551339285917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a45050565b600080516020615ae3833981519152546001600160a01b031690565b600080516020615aa383398151915261222d81612102565b6101355460405163b3c2d50b60e01b81523060048201526001600160a01b0384811660248301529091169063b3c2d50b90604401600060405180830381600087803b15801561227b57600080fd5b505af115801561228f573d6000803e3d6000fd5b505050505050565b7f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156122ca5761069683612e97565b826001600160a01b03166352d1902d6040518163ffffffff1660e01b8152600401602060405180830381865afa925050508015612324575060408051601f3d908101601f19168201909252612321918101906157aa565b60015b6123875760405162461bcd60e51b815260206004820152602e60248201527f45524331393637557067726164653a206e657720696d706c656d656e7461746960448201526d6f6e206973206e6f74205555505360901b6064820152608401610707565b600080516020615ae383398151915281146123f65760405162461bcd60e51b815260206004820152602960248201527f45524331393637557067726164653a20756e737570706f727465642070726f786044820152681a58589b195555525160ba1b6064820152608401610707565b50610696838383612f31565b6001600160a01b03163b151590565b600054610100900460ff166124385760405162461bcd60e51b8152600401610707906157c3565b565b600054610100900460ff166124615760405162461bcd60e51b8152600401610707906157c3565b612438612f5c565b60008290506000816001600160a01b031663228d5cc66040518163ffffffff1660e01b8152600401602060405180830381865afa1580156124ae573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906124d2919061580e565b6040516364deb92b60e11b81529091506001600160a01b0382169063c9bd7256906125019086906004016148e4565b600060405180830381600087803b15801561251b57600080fd5b505af115801561252f573d6000803e3d6000fd5b5050505050505050565b600080612544612f8a565b600080612555868661013854612fe3565b6101378290559094509250505061256c600160fb55565b9250929050565b82516000908190819081905b8015612a3057612590600182614eb3565b91506000806125bd8a85815181106125aa576125aa614eff565b6020026020010151604001518b86613877565b91509150610137548a85815181106125d7576125d7614eff565b602002602001015160400151101580156125f057508886105b80156126055750612601868a614eb3565b8111155b156126a057600094505b8161261a8686614eb3565b1061267d5761264a8a61262d8787614eb3565b8151811061263d5761263d614eff565b602002602001015161391b565b612654908761582b565b955084840361266d5761266685614f15565b945061267d565b61267685614f15565b945061260f565b841561269b5761268e600186614eb3565b6126989084614eb3565b92505b612a1d565b610137548a85815181106126b6576126b6614eff565b602002602001015160400151101580156126cf57508886105b156128e457600094505b816126e48686614eb3565b1061267d57816126f48686614eb3565b03612757576127308a6127078787614eb3565b8151811061271757612717614eff565b6020026020010151878b61272b9190614eb3565b613a68565b61273a908761582b565b9550612746868a614eb3565b6127509082614eb3565b90506128c4565b60008a6127648787614eb3565b8151811061277457612774614eff565b602002602001015160600151905060006127f560405180602001604052808c601261279f9190614eb3565b6127aa90600a615922565b8b8f6127b69190614eb3565b6127c09190614ec6565b90526040805160208101909152806127d98e6012614eb3565b6127e490600a615922565b6127ee9088614ec6565b9052613b95565b905060006128048b6012614eb3565b61280f90600a615922565b6128478360405180602001604052808f601261282b9190614eb3565b61283690600a615922565b6128409089614ec6565b9052613bd8565b516128529190614edd565b90506128808d6128628a8a614eb3565b8151811061287257612872614eff565b602002602001015182613a68565b61288a908a61582b565b98508c6128978989614eb3565b815181106128a7576128a7614eff565b602002602001015160600151846128be9190614eb3565b93505050505b8484036128d45761266685614f15565b6128dd85614f15565b94506126d9565b8984815181106128f6576128f6614eff565b602002602001015160e001511561293b5761269b8a858151811061291c5761291c614eff565b602002602001015161010001518b8681518110610e6c57610e6c614eff565b610132548a516001600160a01b0390911690630283ce5b908c908790811061296557612965614eff565b6020026020010151600001518c878151811061298357612983614eff565b6020026020010151602001518d88815181106129a1576129a1614eff565b602002602001015160c001518e89815181106129bf576129bf614eff565b6020026020010151608001516040518563ffffffff1660e01b81526004016129ea9493929190615692565b600060405180830381600087803b158015612a0457600080fd5b505af1158015612a18573d6000803e3d6000fd5b505050505b505080612a299061592e565b905061257f565b50919695505050505050565b60008080805b8651811015612e3357600080612a76898481518110612a6357612a63614eff565b6020026020010151604001518a85613c17565b9150915061013754898481518110612a9057612a90614eff565b60200260200101516040015111158015612aa957508785105b8015612abe5750612aba8589614eb3565b8111155b15612b4257600093505b81612ad3848661582b565b11612b1f57612b0389612ae6858761582b565b81518110612af657612af6614eff565b6020026020010151613cc6565b612b0d908661582b565b9450612b1884614f15565b9350612ac8565b8315612b3d57612b30600185614eb3565b612b3a908461582b565b92505b612e20565b61013754898481518110612b5857612b58614eff565b60200260200101516040015111158015612b7157508785105b15612d5d57600093505b81612b86848661582b565b11612b1f5781612b96848661582b565b03612bf957612bd289612ba9858761582b565b81518110612bb957612bb9614eff565b6020026020010151868a612bcd9190614eb3565b613d8e565b612bdc908661582b565b9450612be88589614eb3565b612bf29082614eb3565b9050612d4b565b600089612c06858761582b565b81518110612c1657612c16614eff565b60200260200101516060015190506000612c7960405180602001604052808b6012612c419190614eb3565b612c4c90600a615922565b612c568b8f614eb3565b612c609190614ec6565b90526040805160208101909152806127d98d6012614eb3565b9050600084612c88878961582b565b03612c9c57612c97888c614eb3565b612cd9565b612ca78a6012614eb3565b612cb290600a615922565b612cce8360405180602001604052808e601261282b9190614eb3565b51612cd99190614edd565b9050612d078c612ce9888a61582b565b81518110612cf957612cf9614eff565b602002602001015182613d8e565b612d11908961582b565b97508b612d1e878961582b565b81518110612d2e57612d2e614eff565b60200260200101516060015184612d459190614eb3565b93505050505b83612d5581614f15565b945050612b7b565b6101335489516001600160a01b0390911690630c57f414908b9086908110612d8757612d87614eff565b6020026020010151600001518b8681518110612da557612da5614eff565b6020026020010151602001518c8781518110612dc357612dc3614eff565b6020026020010151606001516040518463ffffffff1660e01b8152600401612ded939291906156ce565b600060405180830381600087803b158015612e0757600080fd5b505af1158015612e1b573d6000803e3d6000fd5b505050505b505080612e2c90614f15565b9050612a42565b509095945050505050565b612e488282611387565b61071a57612e5581613ec9565b612e60836020613edb565b604051602001612e71929190615945565b60408051601f198184030181529082905262461bcd60e51b825261070791600401614b14565b612ea081612402565b612f025760405162461bcd60e51b815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201526c1bdd08184818dbdb9d1c9858dd609a1b6064820152608401610707565b600080516020615ae383398151915280546001600160a01b0319166001600160a01b0392909216919091179055565b612f3a8361407d565b600082511180612f475750805b1561069657612f5683836140bd565b50505050565b600054610100900460ff16612f835760405162461bcd60e51b8152600401610707906157c3565b600160fb55565b600260fb5403612fdc5760405162461bcd60e51b815260206004820152601f60248201527f5265656e7472616e637947756172643a207265656e7472616e742063616c6c006044820152606401610707565b600260fb55565b60008082600114158015612ff657508215155b15613017576040516362c115eb60e11b815260048101849052602401610707565b6000604051806101e001604052808660008151811061303857613038614eff565b602002602001015160400151815260200160018152602001875181526020018660008151811061306a5761306a614eff565b6020026020010151606001518152602001600081526020016000815260200160008152602001600081526020016000815260200160008152602001600081526020016000815260200160001515815260200160008152602001600081525090506130e986600183604001516130df9190614eb3565b83516000906140e2565b60408301526080820181905260608201516131049190614192565b60a08201525b84518160200151108015613122575085518160400151105b1561329057602081015160c08201819052604082015160e0830152606082015161010083015260808201516101208301528551869190811061316657613166614eff565b602002602001015160400151816101400181815250505b84518160c001511080156131b65750806101400151858260c00151815181106131a8576131a8614eff565b602002602001015160400151145b156132045760c08101805186916131cc82614f15565b9052815181106131de576131de614eff565b60200260200101516060015181610100018181516131fc919061582b565b90525061317d565b61321e868260e001518361012001518461014001516141a9565b60e0830152610120820181905261010082015161323b9190614192565b610160820181905260a082015110156132905760c0810151602082015260e0810151604082015261010081015160608201526101208101516080820152610140810151815261016081015160a082015261310a565b84518160200151106132a4576000196132c7565b848160200151815181106132ba576132ba614eff565b6020026020010151604001515b6101408201525b8551816040015110156133e257604081015160e08201819052865187919081106132fa576132fa614eff565b6020908102919091010151604001516101a08201819052608082015161012083015261014082015111156133e2575b85518160e001511080156133625750806101a00151868260e001518151811061335457613354614eff565b602002602001015160400151145b156133b05760e081018051879161337882614f15565b90528151811061338a5761338a614eff565b60200260200101516060015181610120018181516133a89190614eb3565b905250613329565b8060600151816101200151106133e2576001610180820152610120810151608082015260e081015160408201526132ce565b8061018001511561345a578551816040015114613420578581604001518151811061340f5761340f614eff565b60200260200101516040015161344f565b85600182604001516134329190614eb3565b8151811061344257613442614eff565b6020026020010151604001515b6101c0820152613463565b80516101c08201525b602081018051906134738261592e565b81525050836001036135d45760208101515b6000811180156134d25750858260200151815181106134a6576134a6614eff565b6020026020010151604001518682815181106134c4576134c4614eff565b602002602001015160400151145b156134e9576134e2600182614eb3565b9050613485565b60408201518751810361350457613501600182614eb3565b90505b600188516135129190614eb3565b8110801561355d57508783604001518151811061353157613531614eff565b60200260200101516040015188828151811061354f5761354f614eff565b602002602001015160400151145b156135745761356d60018261582b565b9050613504565b600288828151811061358857613588614eff565b6020026020010151604001518884815181106135a6576135a6614eff565b6020026020010151604001516135bc919061582b565b6135c69190614edd565b6101c0840152506136589050565b85518160400151036135f7576001816040018181516135f39190614eb3565b9052505b60028682604001518151811061360f5761360f614eff565b6020026020010151604001518683602001518151811061363157613631614eff565b602002602001015160400151613647919061582b565b6136519190614edd565b6101c08201525b806101c001518582602001518151811061367457613674614eff565b6020026020010151604001511161372b576020810180519061369582614f15565b9052505b845181602001511080156136d35750806101c00151858260200151815181106136c4576136c4614eff565b60200260200101516040015111155b1561372657848160200151815181106136ee576136ee614eff565b6020026020010151606001518160600181815161370b919061582b565b9052506020810180519061371e82614f15565b905250613699565b6137b1565b806101c001518582602001518151811061374757613747614eff565b60200260200101516040015111156137b1578481602001518151811061376f5761376f614eff565b6020026020010151606001518160600181815161378c9190614eb3565b9052506020810151156137b157602081018051906137a98261592e565b90525061372b565b855181604001511080156137ea5750806101c00151868260400151815181106137dc576137dc614eff565b602002602001015160400151105b15613817576138088682604001518360800151846101c001516141a9565b60408301526080820152613851565b6040810151156138515761384686600183604001516138369190614eb3565b8360800151846101c001516140e2565b604083015260808201525b806101c0015161386982608001518360600151614192565b92509250505b935093915050565b60008082915083828151811061388f5761388f614eff565b60200260200101516060015190505b8115806138d2575084846138b3600185614eb3565b815181106138c3576138c3614eff565b60200260200101516040015114155b61386f57836138e2600184614eb3565b815181106138f2576138f2614eff565b60200260200101516060015181613909919061582b565b90506139148261592e565b915061389e565b6000613925612f8a565b6000613934836060015161422a565b90508260e001516139c857610131546020840151606085015160c0860151608087015161013054604051635115f4e560e11b81526001600160a01b039096169563a22be9ca956139919590949093899391929091906004016159b4565b600060405180830381600087803b1580156139ab57600080fd5b505af11580156139bf573d6000803e3d6000fd5b505050506139e1565b6139e183602001518460600151838661010001516142ac565b6101355461012e54845160608601516040516303e852b160e01b81526001600160a01b03909416936303e852b193613a1f9390929091600401615794565b600060405180830381600087803b158015613a3957600080fd5b505af1158015613a4d573d6000803e3d6000fd5b505050508260600151915050613a63600160fb55565b919050565b6000613a72612f8a565b6000613a7d8361422a565b90508360e00151613b075761013154602085015160c0860151608087015161013054604051635115f4e560e11b81526001600160a01b039095169463a22be9ca94613ad09490938a9389936004016159b4565b600060405180830381600087803b158015613aea57600080fd5b505af1158015613afe573d6000803e3d6000fd5b50505050613b1c565b613b1c846020015184838761010001516142ac565b6101355461012e5485516040516303e852b160e01b81526001600160a01b03909316926303e852b192613b559290918890600401615794565b600060405180830381600087803b158015613b6f57600080fd5b505af1158015613b83573d6000803e3d6000fd5b505050508291505061066b600160fb55565b6040805160208101909152600081526040518060200160405280613bcf613bc88660000151670de0b6b3a7640000614731565b855161473d565b90529392505050565b6040805160208101909152600081526040518060200160405280670de0b6b3a7640000613c0d86600001518660000151614731565b613bcf9190614edd565b600080829150838281518110613c2f57613c2f614eff565b60200260200101516060015190505b60018451613c4c9190614eb3565b82101561386f578484613c6084600161582b565b81518110613c7057613c70614eff565b6020026020010151604001510361386f5783613c8d83600161582b565b81518110613c9d57613c9d614eff565b60200260200101516060015181613cb4919061582b565b9050613cbf82614f15565b9150613c3e565b6000613cd0612f8a565b6000613cdf836060015161422a565b610131546020850151606086015186516040516308f9231360e31b81529495506001600160a01b03909316936347c9189893613d22939291879190600401615a07565b600060405180830381600087803b158015613d3c57600080fd5b505af1158015613d50573d6000803e3d6000fd5b50506101355461012e548651606088015160405163ba0cf0ab60e01b81526001600160a01b03909416955063ba0cf0ab9450613a1f93600401615794565b6000613d98612f8a565b6000613da38361422a565b61013154602086015186516040516308f9231360e31b81529394506001600160a01b03909216926347c9189892613de1929188918791600401615a07565b600060405180830381600087803b158015613dfb57600080fd5b505af1158015613e0f573d6000803e3d6000fd5b5050610133548651602088015160608901516001600160a01b039093169450630c57f41493509091613e42908890614eb3565b6040518463ffffffff1660e01b8152600401613e60939291906156ce565b600060405180830381600087803b158015613e7a57600080fd5b505af1158015613e8e573d6000803e3d6000fd5b50506101355461012e54875160405163ba0cf0ab60e01b81526001600160a01b03909316945063ba0cf0ab9350613b55928890600401615794565b606061066b6001600160a01b03831660145b60606000613eea836002614ec6565b613ef590600261582b565b6001600160401b03811115613f0c57613f0c614973565b6040519080825280601f01601f191660200182016040528015613f36576020820181803683370190505b509050600360fc1b81600081518110613f5157613f51614eff565b60200101906001600160f81b031916908160001a905350600f60fb1b81600181518110613f8057613f80614eff565b60200101906001600160f81b031916908160001a9053506000613fa4846002614ec6565b613faf90600161582b565b90505b6001811115614027576f181899199a1a9b1b9c1cb0b131b232b360811b85600f1660108110613fe357613fe3614eff565b1a60f81b828281518110613ff957613ff9614eff565b60200101906001600160f81b031916908160001a90535060049490941c936140208161592e565b9050613fb2565b5083156140765760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401610707565b9392505050565b61408681612e97565b6040516001600160a01b038216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b60606140768383604051806060016040528060278152602001615b0360279139614749565b60008083855b848882815181106140fb576140fb614eff565b6020026020010151604001511061414d5787818151811061411e5761411e614eff565b60200260200101516060015182614135919061582b565b9150801561414d576141468161592e565b90506140e8565b818589838151811061416157614161614eff565b602002602001015160400151106141785781614183565b61418382600161582b565b93509350505094509492505050565b60008183106141a257508061066b565b508161066b565b60008083855b8751811080156141db5750848882815181106141cd576141cd614eff565b602002602001015160400151105b1561421d578781815181106141f2576141f2614eff565b602002602001015160600151826142099190614eb3565b91508061421581614f15565b9150506141af565b9097909650945050505050565b6000806142786040518060200160405280670de0b6b3a7640000815250614273604051806020016040528061013054815250604051806020016040528061013754815250613bd8565b6147c1565b90506140766142a76040518060200160405280670de0b6b3a76400008761429f9190614ec6565b905283613bd8565b6147ed565b6000819050600061013160009054906101000a90046001600160a01b03166001600160a01b031663c99aa678878787866001600160a01b0316635c4b440e6040518163ffffffff1660e01b8152600401602060405180830381865afa158015614319573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061433d919061580e565b6101305460405160e087901b6001600160e01b03191681526001600160a01b039586166004820152602481019490945260448401929092529092166064820152608481019190915260a4016020604051808303816000875af11580156143a7573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906143cb91906157aa565b604051631b433b1160e01b81526001600160a01b03888116600483015260248201839052919250600091841690631b433b11906044016020604051808303816000875af1158015614420573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061444491906157aa565b90506000836001600160a01b0316633de81dc46040518163ffffffff1660e01b8152600401602060405180830381865afa158015614486573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906144aa919061580e565b9050600080826001600160a01b0316633d0dda788b8661013160009054906101000a90046001600160a01b03166001600160a01b0316635c4b440e6040518163ffffffff1660e01b8152600401602060405180830381865afa158015614514573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190614538919061580e565b60405160e085901b6001600160e01b03191681526001600160a01b039384166004820152602481019290925290911660448201526064016000604051808303816000875af115801561458e573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526145b69190810190615a2d565b91509150600061013160009054906101000a90046001600160a01b03166001600160a01b0316633de81dc46040518163ffffffff1660e01b8152600401602060405180830381865afa158015614610573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190614634919061580e565b905060005b835181101561472357600083828151811061465657614656614eff565b6020026020010151111561471357816001600160a01b031663790cb4918d86848151811061468657614686614eff565b60200260200101518685815181106146a0576146a0614eff565b60209081029190910101516040516001600160e01b031960e086901b1681526001600160a01b0393841660048201529290911660248301526044820152606401600060405180830381600087803b1580156146fa57600080fd5b505af115801561470e573d6000803e3d6000fd5b505050505b61471c81614f15565b9050614639565b505050505050505050505050565b60006140768284614ec6565b60006140768284614edd565b6060600080856001600160a01b0316856040516147669190615a86565b600060405180830381855af49150503d80600081146147a1576040519150601f19603f3d011682016040523d82523d6000602084013e6147a6565b606091505b50915091506147b786838387614805565b9695505050505050565b6040805160208101909152600081526040518060200160405280613bcf85600001518560000151614884565b805160009061066b90670de0b6b3a764000090614edd565b6060831561487257825160000361486b5761481f85612402565b61486b5760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610707565b508161487c565b61487c8383614890565b949350505050565b6000614076828461582b565b8151156148a05781518083602001fd5b8060405162461bcd60e51b81526004016107079190614b14565b6000602082840312156148cc57600080fd5b81356001600160e01b03198116811461407657600080fd5b6001600160a01b0391909116815260200190565b60006020828403121561490a57600080fd5b5035919050565b6001600160a01b03811681146107e357600080fd5b6000806040838503121561493957600080fd5b82359150602083013561494b81614911565b809150509250929050565b60006020828403121561496857600080fd5b813561407681614911565b634e487b7160e01b600052604160045260246000fd5b60405161016081016001600160401b03811182821017156149ac576149ac614973565b60405290565b60405161012081016001600160401b03811182821017156149ac576149ac614973565b60405160e081016001600160401b03811182821017156149ac576149ac614973565b60405160a081016001600160401b03811182821017156149ac576149ac614973565b604051601f8201601f191681016001600160401b0381118282101715614a4157614a41614973565b604052919050565b60008060408385031215614a5c57600080fd5b8235614a6781614911565b91506020838101356001600160401b0380821115614a8457600080fd5b818601915086601f830112614a9857600080fd5b813581811115614aaa57614aaa614973565b614abc601f8201601f19168501614a19565b91508082528784828501011115614ad257600080fd5b80848401858401376000848284010152508093505050509250929050565b60005b83811015614b0b578181015183820152602001614af3565b50506000910152565b6020815260008251806020840152614b33816040850160208701614af0565b601f01601f19169190910160400192915050565b60008083601f840112614b5957600080fd5b5081356001600160401b03811115614b7057600080fd5b60208301915083602082850101111561256c57600080fd5b6000806000806000806000806000806101008b8d031215614ba857600080fd5b8a356001600160401b0380821115614bbf57600080fd5b614bcb8e838f01614b47565b909c509a5060208d0135915080821115614be457600080fd5b50614bf18d828e01614b47565b90995097505060408b0135955060608b0135945060808b0135935060a08b0135614c1a81614911565b925060c08b0135614c2a81614911565b8092505060e08b013590509295989b9194979a5092959850565b60008083601f840112614c5657600080fd5b5081356001600160401b03811115614c6d57600080fd5b6020830191508360208260051b850101111561256c57600080fd5b60008060008060408587031215614c9e57600080fd5b84356001600160401b0380821115614cb557600080fd5b614cc188838901614c44565b90965094506020870135915080821115614cda57600080fd5b50614ce787828801614c44565b95989497509550505050565b600060208284031215614d0557600080fd5b81356001600160401b03811115614d1b57600080fd5b820160a0818503121561407657600080fd5b60008060008060008060008060006101008a8c031215614d4c57600080fd5b8935614d5781614911565b985060208a0135614d6781614911565b975060408a0135614d7781614911565b965060608a0135614d8781614911565b955060808a0135614d9781614911565b945060a08a0135614da781614911565b935060c08a0135614db781614911565b925060e08a01356001600160401b03811115614dd257600080fd5b614dde8c828d01614b47565b915080935050809150509295985092959850929598565b6020808252602c908201527f46756e6374696f6e206d7573742062652063616c6c6564207468726f7567682060408201526b19195b1959d85d1958d85b1b60a21b606082015260800190565b6020808252602c908201527f46756e6374696f6e206d7573742062652063616c6c6564207468726f7567682060408201526b6163746976652070726f787960a01b606082015260800190565b8183823760009101908152919050565b634e487b7160e01b600052601160045260246000fd5b8181038181111561066b5761066b614e9d565b808202811582820484141761066b5761066b614e9d565b600082614efa57634e487b7160e01b600052601260045260246000fd5b500490565b634e487b7160e01b600052603260045260246000fd5b600060018201614f2757614f27614e9d565b5060010190565b92835290151560208301521515604082015260600190565b6000808335601e19843603018112614f5d57600080fd5b8301803591506001600160401b03821115614f7757600080fd5b6020019150600581901b360382131561256c57600080fd5b81835260006001600160fb1b03831115614fa857600080fd5b8260051b80836020870137939093016020019392505050565b606081526000614fd560608301888a614f8f565b8281036020840152614fe8818789614f8f565b90508281036040840152614ffd818587614f8f565b9998505050505050505050565b60006001600160401b0382111561502357615023614973565b5060051b60200190565b8051613a6381614911565b600082601f83011261504957600080fd5b8151602061505e6150598361500a565b614a19565b82815260059290921b8401810191818101908684111561507d57600080fd5b8286015b848110156150985780518352918301918301615081565b509695505050505050565b600082601f8301126150b457600080fd5b815160206150c46150598361500a565b82815260059290921b840181019181810190868411156150e357600080fd5b8286015b848110156150985780516150fa81614911565b83529183019183016150e7565b80518015158114613a6357600080fd5b600082601f83011261512857600080fd5b815160206151386150598361500a565b82815260059290921b8401810191818101908684111561515757600080fd5b8286015b848110156150985780516001600160401b038082111561517b5760008081fd5b90880190610160828b03601f19018113156151965760008081fd5b61519e614989565b87840151815260406151b181860161502d565b89830152606080860151828401526080915081860151818401525060a0808601518284015260c0915081860151858111156151ec5760008081fd5b6151fa8f8c838a0101615038565b82850152505060e061520d81870161502d565b82840152610100915081860151858111156152285760008081fd5b6152368f8c838a01016150a3565b828501525050610120935061524c848601615107565b9082015261014061525e85820161502d565b8483015261526d838601615107565b90820152865250505091830191830161515b565b6000806040838503121561529457600080fd5b82516001600160401b03808211156152ab57600080fd5b818501915085601f8301126152bf57600080fd5b815160206152cf6150598361500a565b82815260059290921b840181019181810190898411156152ee57600080fd5b8286015b848110156153e25780518681111561530957600080fd5b8701610120818d03601f190181131561532157600080fd5b6153296149b2565b86830151815261533b6040840161502d565b87820152606083015160408201526080830151606082015260a08301518981111561536557600080fd5b6153738f8983870101615038565b60808301525061538560c0840161502d565b60a082015260e08301518981111561539d5760008081fd5b6153ab8f89838701016150a3565b60c0830152506101006153bf818501615107565b60e08301526153cf83850161502d565b90820152855250509183019183016152f2565b50918801519196509093505050808211156153fc57600080fd5b5061540985828601615117565b9150509250929050565b604081526000615427604083018688614f8f565b828103602084015261543a818587614f8f565b979650505050505050565b600082601f83011261545657600080fd5b815160206154666150598361500a565b82815260e0928302850182019282820191908785111561548557600080fd5b8387015b8581101561550d5781818a0312156154a15760008081fd5b6154a96149d5565b81518152858201516154ba81614911565b8187015260408281015190820152606080830151908201526080808301519082015260a0808301516154eb81614911565b9082015260c06154fc838201615107565b908201528452928401928101615489565b5090979650505050505050565b600080604080848603121561552e57600080fd5b83516001600160401b038082111561554557600080fd5b818601915086601f83011261555957600080fd5b815160206155696150598361500a565b82815260a0928302850182019282820191908b85111561558857600080fd5b958301955b848710156155f65780878d0312156155a55760008081fd5b6155ad6149f7565b87518152848801516155be81614911565b818601528789015189820152606080890151908201526080808901516155e381614911565b908201528352958601959183019161558d565b509189015191975090945050508083111561561057600080fd5b505061540985828601615445565b600081518084526020808501945080840160005b838110156156575781516001600160a01b031687529582019590820190600101615632565b509495945050505050565b600081518084526020808501945080840160005b8381101561565757815187529582019590820190600101615676565b8481526001600160a01b03841660208201526080604082018190526000906156bc9083018561561e565b828103606084015261543a8185615662565b9283526001600160a01b03919091166020830152604082015260600190565b6000602082840312156156ff57600080fd5b61407682615107565b634e487b7160e01b600052600160045260246000fd5b86815285602082015260018060a01b038516604082015283606082015260a060808201528160a0820152818360c0830137600081830160c090810191909152601f909201601f1916010195945050505050565b60006020828403121561578357600080fd5b815160ff8116811461407657600080fd5b9283526020830191909152604082015260600190565b6000602082840312156157bc57600080fd5b5051919050565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b60006020828403121561582057600080fd5b815161407681614911565b8082018082111561066b5761066b614e9d565b600181815b8085111561587957816000190482111561585f5761585f614e9d565b8085161561586c57918102915b93841c9390800290615843565b509250929050565b6000826158905750600161066b565b8161589d5750600061066b565b81600181146158b357600281146158bd576158d9565b600191505061066b565b60ff8411156158ce576158ce614e9d565b50506001821b61066b565b5060208310610133831016604e8410600b84101617156158fc575081810a61066b565b615906838361583e565b806000190482111561591a5761591a614e9d565b029392505050565b60006140768383615881565b60008161593d5761593d614e9d565b506000190190565b76020b1b1b2b9b9a1b7b73a3937b61d1030b1b1b7bab73a1604d1b815260008351615977816017850160208801614af0565b7001034b99036b4b9b9b4b733903937b6329607d1b60179184019182015283516159a8816028840160208801614af0565b01602801949350505050565b60018060a01b038716815285602082015284604082015260c0606082015260006159e160c083018661561e565b82810360808401526159f38186615662565b9150508260a0830152979650505050505050565b6001600160a01b0394909416845260208401929092526040830152606082015260800190565b60008060408385031215615a4057600080fd5b82516001600160401b0380821115615a5757600080fd5b615a63868387016150a3565b93506020850151915080821115615a7957600080fd5b5061540985828601615038565b60008251615a98818460208701614af0565b919091019291505056fe793a6c9b7e0a9549c74edc2f9ae0dc50903dfaa9a56fb0116b27a8c71de3e2c630d41a597cac127d8249d31298b50e481ee82c3f4a49ff93c76a22735aa9f3ad360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a49807205ce4d355092ef5a8a18f56e8913cf4a201fbe287825b095693c21775a2646970667358221220625af9e65efe9e34e1982c56d100ee2f5c5f1796eba1d31e67b5902aac07b41f64736f6c63430008120033
Deployed Bytecode
0x6080604052600436106101cf5760003560e01c8063700e3e2a116100f8578063c794564e11610090578063c794564e1461053f578063cc5b6e4a14610554578063d547741f1461056b578063d6725d0c1461058b578063e8c856f1146105a3578063f0436387146105c3578063f691fac1146105e4578063f77c479114610604578063fa2a3cca1461062557600080fd5b8063700e3e2a14610439578063743a8f881461045057806375b238fc1461047057806376f9a41e146104925780637a6944c5146104b25780638dfea9e7146104c957806391d14854146104e9578063a217fddf14610509578063a95c4d621461051e57600080fd5b80633659cfe61161016b5780633659cfe6146103335780634b449cba146103535780634f1ef2861461036a578063505d799e1461037d57806352d1902d1461039e57806354fd4d50146103b35780635fb8f3ed146103e75780636125be55146104025780636d7331411461042257600080fd5b806301ffc9a7146101d457806306b282c914610209578063201a662514610237578063248a9ca31461026757806327df3d3e146102975780632f2ff15d146102b957806332a0f2d7146102db578063357a77d2146102f257806336568abe14610313575b600080fd5b3480156101e057600080fd5b506101f46101ef3660046148ba565b61063a565b60405190151581526020015b60405180910390f35b34801561021557600080fd5b506101325461022a906001600160a01b031681565b60405161020091906148e4565b34801561024357600080fd5b50610259600080516020615aa383398151915281565b604051908152602001610200565b34801561027357600080fd5b506102596102823660046148f8565b600090815260c9602052604090206001015490565b3480156102a357600080fd5b50610259600080516020615ac383398151915281565b3480156102c557600080fd5b506102d96102d4366004614926565b610671565b005b3480156102e757600080fd5b506102596101375481565b3480156102fe57600080fd5b506101315461022a906001600160a01b031681565b34801561031f57600080fd5b506102d961032e366004614926565b61069b565b34801561033f57600080fd5b506102d961034e366004614956565b61071e565b34801561035f57600080fd5b5061025961012f5481565b6102d9610378366004614a49565b6107e6565b34801561038957600080fd5b506101335461022a906001600160a01b031681565b3480156103aa57600080fd5b5061025961089b565b3480156103bf57600080fd5b5060408051808201825260058152640302e392e360dc1b602082015290516102009190614b14565b3480156103f357600080fd5b50610139546101f49060ff1681565b34801561040e57600080fd5b506102d961041d366004614b88565b610949565b34801561042e57600080fd5b5061025961012e5481565b34801561044557600080fd5b506102596101385481565b34801561045c57600080fd5b506102d961046b366004614c88565b610b53565b34801561047c57600080fd5b50610259600080516020615b2a83398151915281565b34801561049e57600080fd5b506102d96104ad366004614cf3565b610c8b565b3480156104be57600080fd5b506102596101305481565b3480156104d557600080fd5b50610139546101f490610100900460ff1681565b3480156104f557600080fd5b506101f4610504366004614926565b611387565b34801561051557600080fd5b50610259600081565b34801561052a57600080fd5b506101345461022a906001600160a01b031681565b34801561054b57600080fd5b506102d96113b2565b34801561056057600080fd5b5061025961012d5481565b34801561057757600080fd5b506102d9610586366004614926565b611453565b34801561059757600080fd5b506102596301da9c0081565b3480156105af57600080fd5b506102d96105be366004614d2d565b611478565b3480156105cf57600080fd5b50610139546101f49062010000900460ff1681565b3480156105f057600080fd5b506102d96105ff366004614cf3565b6115e0565b34801561061057600080fd5b506101365461022a906001600160a01b031681565b34801561063157600080fd5b506102d961209e565b60006001600160e01b03198216637965db0b60e01b148061066b57506301ffc9a760e01b6001600160e01b03198316145b92915050565b600082815260c9602052604090206001015461068c81612102565b610696838361210c565b505050565b6001600160a01b03811633146107105760405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201526e103937b632b9903337b91039b2b63360891b60648201526084015b60405180910390fd5b61071a8282612192565b5050565b6001600160a01b037f000000000000000000000000e94dfe01cbd8f86299b6bd260a52908345b8cb9a1630036107665760405162461bcd60e51b815260040161070790614df5565b7f000000000000000000000000e94dfe01cbd8f86299b6bd260a52908345b8cb9a6001600160a01b03166107986121f9565b6001600160a01b0316146107be5760405162461bcd60e51b815260040161070790614e41565b6107c781612215565b604080516000808252602082019092526107e391839190612297565b50565b6001600160a01b037f000000000000000000000000e94dfe01cbd8f86299b6bd260a52908345b8cb9a16300361082e5760405162461bcd60e51b815260040161070790614df5565b7f000000000000000000000000e94dfe01cbd8f86299b6bd260a52908345b8cb9a6001600160a01b03166108606121f9565b6001600160a01b0316146108865760405162461bcd60e51b815260040161070790614e41565b61088f82612215565b61071a82826001612297565b6000306001600160a01b037f000000000000000000000000e94dfe01cbd8f86299b6bd260a52908345b8cb9a16146109365760405162461bcd60e51b815260206004820152603860248201527f555550535570677261646561626c653a206d757374206e6f742062652063616c6044820152771b1959081d1a1c9bdd59da0819195b1959d85d1958d85b1b60421b6064820152608401610707565b50600080516020615ae383398151915290565b600054610100900460ff16158080156109695750600054600160ff909116105b8061098a575061097830612402565b15801561098a575060005460ff166001145b6109ed5760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608401610707565b6000805460ff191660011790558015610a10576000805461ff0019166101001790555b610a18612411565b610a20612411565b610a2861243a565b610a40600080516020615ac38339815191528461210c565b8a8a604051602001610a53929190614e8d565b60408051601f1981840301815290829052805160209182012061012d55610a7e918b918b9101614e8d565b60408051601f19818403018152919052805160209091012061012e5561012f8790556301da9c00670de0b6b3a7640000610ab88888614eb3565b610ac29190614ec6565b610acc9190614edd565b6101305561013480546001600160a01b0319166001600160a01b038616179055610139805463ff00ffff191690556101388290558015610b46576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15b5050505050505050505050565b61012f544211610b765760405163b9adeefd60e01b815260040160405180910390fd5b600080516020615b2a833981519152610b8e81612102565b60005b84811015610bff57610bef848483818110610bae57610bae614eff565b9050602002016020810190610bc39190614956565b878784818110610bd557610bd5614eff565b9050602002016020810190610bea9190614956565b612469565b610bf881614f15565b9050610b91565b50610139805461ff001916610100908117918290556101355461012e5460405163504c5d5d60e11b81526001600160a01b039092169363a098baba93610c52936000929190910460ff1690600401614f2e565b600060405180830381600087803b158015610c6c57600080fd5b505af1158015610c80573d6000803e3d6000fd5b505050505050505050565b61012f544211610cae5760405163b9adeefd60e01b815260040160405180910390fd5b600080516020615b2a833981519152610cc681612102565b6101325460009081906001600160a01b031663f9202d63610ce78680614f46565b610cf46020890189614f46565b610d0160408b018b614f46565b6040518763ffffffff1660e01b8152600401610d2296959493929190614fc1565b6000604051808303816000875af1158015610d41573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052610d699190810190615281565b61013354919350915060009081906001600160a01b031663c44cee73610d926060890189614f46565b610d9f60808b018b614f46565b6040518563ffffffff1660e01b8152600401610dbe9493929190615413565b6000604051808303816000875af1158015610ddd573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052610e05919081019061551a565b9150915060005b8451811015610f7457848181518110610e2757610e27614eff565b602002602001015160e0015115610e8257610e7d858281518110610e4d57610e4d614eff565b60200260200101516101000151868381518110610e6c57610e6c614eff565b602002602001015160200151612469565b610f64565b6101325485516001600160a01b0390911690630283ce5b90879084908110610eac57610eac614eff565b602002602001015160000151878481518110610eca57610eca614eff565b602002602001015160200151888581518110610ee857610ee8614eff565b602002602001015160c00151898681518110610f0657610f06614eff565b6020026020010151608001516040518563ffffffff1660e01b8152600401610f319493929190615692565b600060405180830381600087803b158015610f4b57600080fd5b505af1158015610f5f573d6000803e3d6000fd5b505050505b610f6d81614f15565b9050610e0c565b5060005b8251811015611054576101335483516001600160a01b0390911690630c57f41490859084908110610fab57610fab614eff565b602002602001015160000151858481518110610fc957610fc9614eff565b602002602001015160200151868581518110610fe757610fe7614eff565b6020026020010151606001516040518463ffffffff1660e01b8152600401611011939291906156ce565b600060405180830381600087803b15801561102b57600080fd5b505af115801561103f573d6000803e3d6000fd5b505050508061104d90614f15565b9050610f78565b5060005b83518110156111b05783818151811061107357611073614eff565b60200260200101516101000151156110be576110b984828151811061109a5761109a614eff565b60200260200101516101200151858381518110610e6c57610e6c614eff565b6111a0565b6101325484516001600160a01b0390911690630283ce5b908690849081106110e8576110e8614eff565b60200260200101516000015186848151811061110657611106614eff565b60200260200101516020015187858151811061112457611124614eff565b602002602001015160e0015188868151811061114257611142614eff565b602002602001015160a001516040518563ffffffff1660e01b815260040161116d9493929190615692565b600060405180830381600087803b15801561118757600080fd5b505af115801561119b573d6000803e3d6000fd5b505050505b6111a981614f15565b9050611058565b5060005b8151811015611290576101335482516001600160a01b0390911690630c57f414908490849081106111e7576111e7614eff565b60200260200101516000015184848151811061120557611205614eff565b60200260200101516020015185858151811061122357611223614eff565b6020026020010151608001516040518463ffffffff1660e01b815260040161124d939291906156ce565b600060405180830381600087803b15801561126757600080fd5b505af115801561127b573d6000803e3d6000fd5b505050508061128990614f15565b90506111b4565b6101355461012e5460405163504c5d5d60e11b81526001600160a01b039092169163a098baba916112c8916000908190600401614f2e565b600060405180830381600087803b1580156112e257600080fd5b505af11580156112f6573d6000803e3d6000fd5b5050505061013160009054906101000a90046001600160a01b03166001600160a01b0316634dabab106040518163ffffffff1660e01b8152600401602060405180830381865afa15801561134e573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061137291906156ed565b61137e5761137e615708565b50505050505050565b600091825260c9602090815260408084206001600160a01b0393909316845291905290205460ff1690565b600080516020615b2a8339815191526113ca81612102565b610139805462ff00001916620100001790556101355461012e5461012d54604051635fdd148760e01b81526001600160a01b0390931692635fdd14879261141e929091600401918252602082015260400190565b600060405180830381600087803b15801561143857600080fd5b505af115801561144c573d6000803e3d6000fd5b5050505050565b600082815260c9602052604090206001015461146e81612102565b6106968383612192565b600080516020615ac383398151915261149081612102565b610139546301000000900460ff16156114bc57604051634ce377bb60e11b815260040160405180910390fd5b610139805463ff0000001916630100000017905561013580546001600160a01b03808d166001600160a01b03199283161790925561013680548c841690831617905561013180548b841690831617905561013280548a8416908316179055610133805492891692909116919091179055611544600080516020615aa38339815191528661210c565b61155c600080516020615b2a8339815191528561210c565b6101355461012d5461012e5461012f5460405163383a8ab160e01b81526001600160a01b039094169363383a8ab1936115a293909290913091908a908a9060040161571e565b600060405180830381600087803b1580156115bc57600080fd5b505af11580156115d0573d6000803e3d6000fd5b5050505050505050505050505050565b61012f5442116116035760405163b9adeefd60e01b815260040160405180910390fd5b6101395462010000900460ff161561162e57604051631298d6db60e01b815260040160405180910390fd5b6101395460ff16156116535760405163f02c1d9560e01b815260040160405180910390fd5b61013954610100900460ff161561167d57604051632d93dc5b60e21b815260040160405180910390fd5b610139805460ff191660011790556116a3600080516020615b2a83398151915233611387565b6117465760006116b66040830183614f46565b905011806116d2575060006116ce6080830183614f46565b9050115b156117465760405163dd23c3ad60e01b815260206004820152603d60248201527f416c6c2074656e64657220707269636573206d7573742062652072657665616c60448201527f656420666f722061756374696f6e20746f20626520636f6d706c6574650000006064820152608401610707565b6101325460009081906001600160a01b031663f9202d636117678580614f46565b6117746020880188614f46565b61178160408a018a614f46565b6040518763ffffffff1660e01b81526004016117a296959493929190614fc1565b6000604051808303816000875af11580156117c1573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526117e99190810190615281565b61013354919350915060009081906001600160a01b031663c44cee736118126060880188614f46565b61181f60808a018a614f46565b6040518563ffffffff1660e01b815260040161183e9493929190615413565b6000604051808303816000875af115801561185d573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f19168201604052611885919081019061551a565b915091506000845111801561189b575060008251115b80156118ef5750816000815181106118b5576118b5614eff565b60200260200101516040015184600186516118d09190614eb3565b815181106118e0576118e0614eff565b60200260200101516040015110155b15611a9c5760006119008584612539565b915050600061013460009054906101000a90046001600160a01b03166001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa158015611959573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061197d9190615771565b60ff169050600061198f878484612573565b9050600061199e868585612a3c565b6101355461012e5461013754604051630ef1216760e41b81526004810192909252426024830152436044830152606482018690526084820184905260a48201529192506001600160a01b03169063ef1216709060c401600060405180830381600087803b158015611a0e57600080fd5b505af1158015611a22573d6000803e3d6000fd5b50506101365461012d5461012e546101375460405163a2a61aed60e01b81526001600160a01b03909416955063a2a61aed9450611a6193600401615794565b600060405180830381600087803b158015611a7b57600080fd5b505af1158015611a8f573d6000803e3d6000fd5b5050505050505050611dfd565b60005b8451811015611bd757848181518110611aba57611aba614eff565b602002602001015160e0015115611ae557611ae0858281518110610e4d57610e4d614eff565b611bc7565b6101325485516001600160a01b0390911690630283ce5b90879084908110611b0f57611b0f614eff565b602002602001015160000151878481518110611b2d57611b2d614eff565b602002602001015160200151888581518110611b4b57611b4b614eff565b602002602001015160c00151898681518110611b6957611b69614eff565b6020026020010151608001516040518563ffffffff1660e01b8152600401611b949493929190615692565b600060405180830381600087803b158015611bae57600080fd5b505af1158015611bc2573d6000803e3d6000fd5b505050505b611bd081614f15565b9050611a9f565b5060005b8251811015611cb7576101335483516001600160a01b0390911690630c57f41490859084908110611c0e57611c0e614eff565b602002602001015160000151858481518110611c2c57611c2c614eff565b602002602001015160200151868581518110611c4a57611c4a614eff565b6020026020010151606001516040518463ffffffff1660e01b8152600401611c74939291906156ce565b600060405180830381600087803b158015611c8e57600080fd5b505af1158015611ca2573d6000803e3d6000fd5b5050505080611cb090614f15565b9050611bdb565b5060008451118015611cca575060008251115b8015611d1d575081600081518110611ce457611ce4614eff565b6020026020010151604001518460018651611cff9190614eb3565b81518110611d0f57611d0f614eff565b602002602001015160400151105b15611d92576101355461012e5460405163504c5d5d60e11b81526001600160a01b039092169163a098baba91611d5b91600190600090600401614f2e565b600060405180830381600087803b158015611d7557600080fd5b505af1158015611d89573d6000803e3d6000fd5b50505050611dfd565b6101355461012e5460405163504c5d5d60e11b81526001600160a01b039092169163a098baba91611dca916000908190600401614f2e565b600060405180830381600087803b158015611de457600080fd5b505af1158015611df8573d6000803e3d6000fd5b505050505b60005b8351811015611f3957838181518110611e1b57611e1b614eff565b6020026020010151610100015115611e4757611e4284828151811061109a5761109a614eff565b611f29565b6101325484516001600160a01b0390911690630283ce5b90869084908110611e7157611e71614eff565b602002602001015160000151868481518110611e8f57611e8f614eff565b602002602001015160200151878581518110611ead57611ead614eff565b602002602001015160e00151888681518110611ecb57611ecb614eff565b602002602001015160a001516040518563ffffffff1660e01b8152600401611ef69493929190615692565b600060405180830381600087803b158015611f1057600080fd5b505af1158015611f24573d6000803e3d6000fd5b505050505b611f3281614f15565b9050611e00565b5060005b8151811015612019576101335482516001600160a01b0390911690630c57f41490849084908110611f7057611f70614eff565b602002602001015160000151848481518110611f8e57611f8e614eff565b602002602001015160200151858581518110611fac57611fac614eff565b6020026020010151608001516040518463ffffffff1660e01b8152600401611fd6939291906156ce565b600060405180830381600087803b158015611ff057600080fd5b505af1158015612004573d6000803e3d6000fd5b505050508061201290614f15565b9050611f3d565b5061013160009054906101000a90046001600160a01b03166001600160a01b0316634dabab106040518163ffffffff1660e01b8152600401602060405180830381865afa15801561206e573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061209291906156ed565b61144c5761144c615708565b600080516020615b2a8339815191526120b681612102565b610139805462ff0000191690556101355461012e5461012d5460405162d9568360e21b8152600481019290925260248201526001600160a01b03909116906303655a0c9060440161141e565b6107e38133612e3e565b6121168282611387565b61071a57600082815260c9602090815260408083206001600160a01b03851684529091529020805460ff1916600117905561214e3390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b61219c8282611387565b1561071a57600082815260c9602090815260408083206001600160a01b0385168085529252808320805460ff1916905551339285917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a45050565b600080516020615ae3833981519152546001600160a01b031690565b600080516020615aa383398151915261222d81612102565b6101355460405163b3c2d50b60e01b81523060048201526001600160a01b0384811660248301529091169063b3c2d50b90604401600060405180830381600087803b15801561227b57600080fd5b505af115801561228f573d6000803e3d6000fd5b505050505050565b7f4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd91435460ff16156122ca5761069683612e97565b826001600160a01b03166352d1902d6040518163ffffffff1660e01b8152600401602060405180830381865afa925050508015612324575060408051601f3d908101601f19168201909252612321918101906157aa565b60015b6123875760405162461bcd60e51b815260206004820152602e60248201527f45524331393637557067726164653a206e657720696d706c656d656e7461746960448201526d6f6e206973206e6f74205555505360901b6064820152608401610707565b600080516020615ae383398151915281146123f65760405162461bcd60e51b815260206004820152602960248201527f45524331393637557067726164653a20756e737570706f727465642070726f786044820152681a58589b195555525160ba1b6064820152608401610707565b50610696838383612f31565b6001600160a01b03163b151590565b600054610100900460ff166124385760405162461bcd60e51b8152600401610707906157c3565b565b600054610100900460ff166124615760405162461bcd60e51b8152600401610707906157c3565b612438612f5c565b60008290506000816001600160a01b031663228d5cc66040518163ffffffff1660e01b8152600401602060405180830381865afa1580156124ae573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906124d2919061580e565b6040516364deb92b60e11b81529091506001600160a01b0382169063c9bd7256906125019086906004016148e4565b600060405180830381600087803b15801561251b57600080fd5b505af115801561252f573d6000803e3d6000fd5b5050505050505050565b600080612544612f8a565b600080612555868661013854612fe3565b6101378290559094509250505061256c600160fb55565b9250929050565b82516000908190819081905b8015612a3057612590600182614eb3565b91506000806125bd8a85815181106125aa576125aa614eff565b6020026020010151604001518b86613877565b91509150610137548a85815181106125d7576125d7614eff565b602002602001015160400151101580156125f057508886105b80156126055750612601868a614eb3565b8111155b156126a057600094505b8161261a8686614eb3565b1061267d5761264a8a61262d8787614eb3565b8151811061263d5761263d614eff565b602002602001015161391b565b612654908761582b565b955084840361266d5761266685614f15565b945061267d565b61267685614f15565b945061260f565b841561269b5761268e600186614eb3565b6126989084614eb3565b92505b612a1d565b610137548a85815181106126b6576126b6614eff565b602002602001015160400151101580156126cf57508886105b156128e457600094505b816126e48686614eb3565b1061267d57816126f48686614eb3565b03612757576127308a6127078787614eb3565b8151811061271757612717614eff565b6020026020010151878b61272b9190614eb3565b613a68565b61273a908761582b565b9550612746868a614eb3565b6127509082614eb3565b90506128c4565b60008a6127648787614eb3565b8151811061277457612774614eff565b602002602001015160600151905060006127f560405180602001604052808c601261279f9190614eb3565b6127aa90600a615922565b8b8f6127b69190614eb3565b6127c09190614ec6565b90526040805160208101909152806127d98e6012614eb3565b6127e490600a615922565b6127ee9088614ec6565b9052613b95565b905060006128048b6012614eb3565b61280f90600a615922565b6128478360405180602001604052808f601261282b9190614eb3565b61283690600a615922565b6128409089614ec6565b9052613bd8565b516128529190614edd565b90506128808d6128628a8a614eb3565b8151811061287257612872614eff565b602002602001015182613a68565b61288a908a61582b565b98508c6128978989614eb3565b815181106128a7576128a7614eff565b602002602001015160600151846128be9190614eb3565b93505050505b8484036128d45761266685614f15565b6128dd85614f15565b94506126d9565b8984815181106128f6576128f6614eff565b602002602001015160e001511561293b5761269b8a858151811061291c5761291c614eff565b602002602001015161010001518b8681518110610e6c57610e6c614eff565b610132548a516001600160a01b0390911690630283ce5b908c908790811061296557612965614eff565b6020026020010151600001518c878151811061298357612983614eff565b6020026020010151602001518d88815181106129a1576129a1614eff565b602002602001015160c001518e89815181106129bf576129bf614eff565b6020026020010151608001516040518563ffffffff1660e01b81526004016129ea9493929190615692565b600060405180830381600087803b158015612a0457600080fd5b505af1158015612a18573d6000803e3d6000fd5b505050505b505080612a299061592e565b905061257f565b50919695505050505050565b60008080805b8651811015612e3357600080612a76898481518110612a6357612a63614eff565b6020026020010151604001518a85613c17565b9150915061013754898481518110612a9057612a90614eff565b60200260200101516040015111158015612aa957508785105b8015612abe5750612aba8589614eb3565b8111155b15612b4257600093505b81612ad3848661582b565b11612b1f57612b0389612ae6858761582b565b81518110612af657612af6614eff565b6020026020010151613cc6565b612b0d908661582b565b9450612b1884614f15565b9350612ac8565b8315612b3d57612b30600185614eb3565b612b3a908461582b565b92505b612e20565b61013754898481518110612b5857612b58614eff565b60200260200101516040015111158015612b7157508785105b15612d5d57600093505b81612b86848661582b565b11612b1f5781612b96848661582b565b03612bf957612bd289612ba9858761582b565b81518110612bb957612bb9614eff565b6020026020010151868a612bcd9190614eb3565b613d8e565b612bdc908661582b565b9450612be88589614eb3565b612bf29082614eb3565b9050612d4b565b600089612c06858761582b565b81518110612c1657612c16614eff565b60200260200101516060015190506000612c7960405180602001604052808b6012612c419190614eb3565b612c4c90600a615922565b612c568b8f614eb3565b612c609190614ec6565b90526040805160208101909152806127d98d6012614eb3565b9050600084612c88878961582b565b03612c9c57612c97888c614eb3565b612cd9565b612ca78a6012614eb3565b612cb290600a615922565b612cce8360405180602001604052808e601261282b9190614eb3565b51612cd99190614edd565b9050612d078c612ce9888a61582b565b81518110612cf957612cf9614eff565b602002602001015182613d8e565b612d11908961582b565b97508b612d1e878961582b565b81518110612d2e57612d2e614eff565b60200260200101516060015184612d459190614eb3565b93505050505b83612d5581614f15565b945050612b7b565b6101335489516001600160a01b0390911690630c57f414908b9086908110612d8757612d87614eff565b6020026020010151600001518b8681518110612da557612da5614eff565b6020026020010151602001518c8781518110612dc357612dc3614eff565b6020026020010151606001516040518463ffffffff1660e01b8152600401612ded939291906156ce565b600060405180830381600087803b158015612e0757600080fd5b505af1158015612e1b573d6000803e3d6000fd5b505050505b505080612e2c90614f15565b9050612a42565b509095945050505050565b612e488282611387565b61071a57612e5581613ec9565b612e60836020613edb565b604051602001612e71929190615945565b60408051601f198184030181529082905262461bcd60e51b825261070791600401614b14565b612ea081612402565b612f025760405162461bcd60e51b815260206004820152602d60248201527f455243313936373a206e657720696d706c656d656e746174696f6e206973206e60448201526c1bdd08184818dbdb9d1c9858dd609a1b6064820152608401610707565b600080516020615ae383398151915280546001600160a01b0319166001600160a01b0392909216919091179055565b612f3a8361407d565b600082511180612f475750805b1561069657612f5683836140bd565b50505050565b600054610100900460ff16612f835760405162461bcd60e51b8152600401610707906157c3565b600160fb55565b600260fb5403612fdc5760405162461bcd60e51b815260206004820152601f60248201527f5265656e7472616e637947756172643a207265656e7472616e742063616c6c006044820152606401610707565b600260fb55565b60008082600114158015612ff657508215155b15613017576040516362c115eb60e11b815260048101849052602401610707565b6000604051806101e001604052808660008151811061303857613038614eff565b602002602001015160400151815260200160018152602001875181526020018660008151811061306a5761306a614eff565b6020026020010151606001518152602001600081526020016000815260200160008152602001600081526020016000815260200160008152602001600081526020016000815260200160001515815260200160008152602001600081525090506130e986600183604001516130df9190614eb3565b83516000906140e2565b60408301526080820181905260608201516131049190614192565b60a08201525b84518160200151108015613122575085518160400151105b1561329057602081015160c08201819052604082015160e0830152606082015161010083015260808201516101208301528551869190811061316657613166614eff565b602002602001015160400151816101400181815250505b84518160c001511080156131b65750806101400151858260c00151815181106131a8576131a8614eff565b602002602001015160400151145b156132045760c08101805186916131cc82614f15565b9052815181106131de576131de614eff565b60200260200101516060015181610100018181516131fc919061582b565b90525061317d565b61321e868260e001518361012001518461014001516141a9565b60e0830152610120820181905261010082015161323b9190614192565b610160820181905260a082015110156132905760c0810151602082015260e0810151604082015261010081015160608201526101208101516080820152610140810151815261016081015160a082015261310a565b84518160200151106132a4576000196132c7565b848160200151815181106132ba576132ba614eff565b6020026020010151604001515b6101408201525b8551816040015110156133e257604081015160e08201819052865187919081106132fa576132fa614eff565b6020908102919091010151604001516101a08201819052608082015161012083015261014082015111156133e2575b85518160e001511080156133625750806101a00151868260e001518151811061335457613354614eff565b602002602001015160400151145b156133b05760e081018051879161337882614f15565b90528151811061338a5761338a614eff565b60200260200101516060015181610120018181516133a89190614eb3565b905250613329565b8060600151816101200151106133e2576001610180820152610120810151608082015260e081015160408201526132ce565b8061018001511561345a578551816040015114613420578581604001518151811061340f5761340f614eff565b60200260200101516040015161344f565b85600182604001516134329190614eb3565b8151811061344257613442614eff565b6020026020010151604001515b6101c0820152613463565b80516101c08201525b602081018051906134738261592e565b81525050836001036135d45760208101515b6000811180156134d25750858260200151815181106134a6576134a6614eff565b6020026020010151604001518682815181106134c4576134c4614eff565b602002602001015160400151145b156134e9576134e2600182614eb3565b9050613485565b60408201518751810361350457613501600182614eb3565b90505b600188516135129190614eb3565b8110801561355d57508783604001518151811061353157613531614eff565b60200260200101516040015188828151811061354f5761354f614eff565b602002602001015160400151145b156135745761356d60018261582b565b9050613504565b600288828151811061358857613588614eff565b6020026020010151604001518884815181106135a6576135a6614eff565b6020026020010151604001516135bc919061582b565b6135c69190614edd565b6101c0840152506136589050565b85518160400151036135f7576001816040018181516135f39190614eb3565b9052505b60028682604001518151811061360f5761360f614eff565b6020026020010151604001518683602001518151811061363157613631614eff565b602002602001015160400151613647919061582b565b6136519190614edd565b6101c08201525b806101c001518582602001518151811061367457613674614eff565b6020026020010151604001511161372b576020810180519061369582614f15565b9052505b845181602001511080156136d35750806101c00151858260200151815181106136c4576136c4614eff565b60200260200101516040015111155b1561372657848160200151815181106136ee576136ee614eff565b6020026020010151606001518160600181815161370b919061582b565b9052506020810180519061371e82614f15565b905250613699565b6137b1565b806101c001518582602001518151811061374757613747614eff565b60200260200101516040015111156137b1578481602001518151811061376f5761376f614eff565b6020026020010151606001518160600181815161378c9190614eb3565b9052506020810151156137b157602081018051906137a98261592e565b90525061372b565b855181604001511080156137ea5750806101c00151868260400151815181106137dc576137dc614eff565b602002602001015160400151105b15613817576138088682604001518360800151846101c001516141a9565b60408301526080820152613851565b6040810151156138515761384686600183604001516138369190614eb3565b8360800151846101c001516140e2565b604083015260808201525b806101c0015161386982608001518360600151614192565b92509250505b935093915050565b60008082915083828151811061388f5761388f614eff565b60200260200101516060015190505b8115806138d2575084846138b3600185614eb3565b815181106138c3576138c3614eff565b60200260200101516040015114155b61386f57836138e2600184614eb3565b815181106138f2576138f2614eff565b60200260200101516060015181613909919061582b565b90506139148261592e565b915061389e565b6000613925612f8a565b6000613934836060015161422a565b90508260e001516139c857610131546020840151606085015160c0860151608087015161013054604051635115f4e560e11b81526001600160a01b039096169563a22be9ca956139919590949093899391929091906004016159b4565b600060405180830381600087803b1580156139ab57600080fd5b505af11580156139bf573d6000803e3d6000fd5b505050506139e1565b6139e183602001518460600151838661010001516142ac565b6101355461012e54845160608601516040516303e852b160e01b81526001600160a01b03909416936303e852b193613a1f9390929091600401615794565b600060405180830381600087803b158015613a3957600080fd5b505af1158015613a4d573d6000803e3d6000fd5b505050508260600151915050613a63600160fb55565b919050565b6000613a72612f8a565b6000613a7d8361422a565b90508360e00151613b075761013154602085015160c0860151608087015161013054604051635115f4e560e11b81526001600160a01b039095169463a22be9ca94613ad09490938a9389936004016159b4565b600060405180830381600087803b158015613aea57600080fd5b505af1158015613afe573d6000803e3d6000fd5b50505050613b1c565b613b1c846020015184838761010001516142ac565b6101355461012e5485516040516303e852b160e01b81526001600160a01b03909316926303e852b192613b559290918890600401615794565b600060405180830381600087803b158015613b6f57600080fd5b505af1158015613b83573d6000803e3d6000fd5b505050508291505061066b600160fb55565b6040805160208101909152600081526040518060200160405280613bcf613bc88660000151670de0b6b3a7640000614731565b855161473d565b90529392505050565b6040805160208101909152600081526040518060200160405280670de0b6b3a7640000613c0d86600001518660000151614731565b613bcf9190614edd565b600080829150838281518110613c2f57613c2f614eff565b60200260200101516060015190505b60018451613c4c9190614eb3565b82101561386f578484613c6084600161582b565b81518110613c7057613c70614eff565b6020026020010151604001510361386f5783613c8d83600161582b565b81518110613c9d57613c9d614eff565b60200260200101516060015181613cb4919061582b565b9050613cbf82614f15565b9150613c3e565b6000613cd0612f8a565b6000613cdf836060015161422a565b610131546020850151606086015186516040516308f9231360e31b81529495506001600160a01b03909316936347c9189893613d22939291879190600401615a07565b600060405180830381600087803b158015613d3c57600080fd5b505af1158015613d50573d6000803e3d6000fd5b50506101355461012e548651606088015160405163ba0cf0ab60e01b81526001600160a01b03909416955063ba0cf0ab9450613a1f93600401615794565b6000613d98612f8a565b6000613da38361422a565b61013154602086015186516040516308f9231360e31b81529394506001600160a01b03909216926347c9189892613de1929188918791600401615a07565b600060405180830381600087803b158015613dfb57600080fd5b505af1158015613e0f573d6000803e3d6000fd5b5050610133548651602088015160608901516001600160a01b039093169450630c57f41493509091613e42908890614eb3565b6040518463ffffffff1660e01b8152600401613e60939291906156ce565b600060405180830381600087803b158015613e7a57600080fd5b505af1158015613e8e573d6000803e3d6000fd5b50506101355461012e54875160405163ba0cf0ab60e01b81526001600160a01b03909316945063ba0cf0ab9350613b55928890600401615794565b606061066b6001600160a01b03831660145b60606000613eea836002614ec6565b613ef590600261582b565b6001600160401b03811115613f0c57613f0c614973565b6040519080825280601f01601f191660200182016040528015613f36576020820181803683370190505b509050600360fc1b81600081518110613f5157613f51614eff565b60200101906001600160f81b031916908160001a905350600f60fb1b81600181518110613f8057613f80614eff565b60200101906001600160f81b031916908160001a9053506000613fa4846002614ec6565b613faf90600161582b565b90505b6001811115614027576f181899199a1a9b1b9c1cb0b131b232b360811b85600f1660108110613fe357613fe3614eff565b1a60f81b828281518110613ff957613ff9614eff565b60200101906001600160f81b031916908160001a90535060049490941c936140208161592e565b9050613fb2565b5083156140765760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401610707565b9392505050565b61408681612e97565b6040516001600160a01b038216907fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b90600090a250565b60606140768383604051806060016040528060278152602001615b0360279139614749565b60008083855b848882815181106140fb576140fb614eff565b6020026020010151604001511061414d5787818151811061411e5761411e614eff565b60200260200101516060015182614135919061582b565b9150801561414d576141468161592e565b90506140e8565b818589838151811061416157614161614eff565b602002602001015160400151106141785781614183565b61418382600161582b565b93509350505094509492505050565b60008183106141a257508061066b565b508161066b565b60008083855b8751811080156141db5750848882815181106141cd576141cd614eff565b602002602001015160400151105b1561421d578781815181106141f2576141f2614eff565b602002602001015160600151826142099190614eb3565b91508061421581614f15565b9150506141af565b9097909650945050505050565b6000806142786040518060200160405280670de0b6b3a7640000815250614273604051806020016040528061013054815250604051806020016040528061013754815250613bd8565b6147c1565b90506140766142a76040518060200160405280670de0b6b3a76400008761429f9190614ec6565b905283613bd8565b6147ed565b6000819050600061013160009054906101000a90046001600160a01b03166001600160a01b031663c99aa678878787866001600160a01b0316635c4b440e6040518163ffffffff1660e01b8152600401602060405180830381865afa158015614319573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061433d919061580e565b6101305460405160e087901b6001600160e01b03191681526001600160a01b039586166004820152602481019490945260448401929092529092166064820152608481019190915260a4016020604051808303816000875af11580156143a7573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906143cb91906157aa565b604051631b433b1160e01b81526001600160a01b03888116600483015260248201839052919250600091841690631b433b11906044016020604051808303816000875af1158015614420573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061444491906157aa565b90506000836001600160a01b0316633de81dc46040518163ffffffff1660e01b8152600401602060405180830381865afa158015614486573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906144aa919061580e565b9050600080826001600160a01b0316633d0dda788b8661013160009054906101000a90046001600160a01b03166001600160a01b0316635c4b440e6040518163ffffffff1660e01b8152600401602060405180830381865afa158015614514573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190614538919061580e565b60405160e085901b6001600160e01b03191681526001600160a01b039384166004820152602481019290925290911660448201526064016000604051808303816000875af115801561458e573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526145b69190810190615a2d565b91509150600061013160009054906101000a90046001600160a01b03166001600160a01b0316633de81dc46040518163ffffffff1660e01b8152600401602060405180830381865afa158015614610573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190614634919061580e565b905060005b835181101561472357600083828151811061465657614656614eff565b6020026020010151111561471357816001600160a01b031663790cb4918d86848151811061468657614686614eff565b60200260200101518685815181106146a0576146a0614eff565b60209081029190910101516040516001600160e01b031960e086901b1681526001600160a01b0393841660048201529290911660248301526044820152606401600060405180830381600087803b1580156146fa57600080fd5b505af115801561470e573d6000803e3d6000fd5b505050505b61471c81614f15565b9050614639565b505050505050505050505050565b60006140768284614ec6565b60006140768284614edd565b6060600080856001600160a01b0316856040516147669190615a86565b600060405180830381855af49150503d80600081146147a1576040519150601f19603f3d011682016040523d82523d6000602084013e6147a6565b606091505b50915091506147b786838387614805565b9695505050505050565b6040805160208101909152600081526040518060200160405280613bcf85600001518560000151614884565b805160009061066b90670de0b6b3a764000090614edd565b6060831561487257825160000361486b5761481f85612402565b61486b5760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610707565b508161487c565b61487c8383614890565b949350505050565b6000614076828461582b565b8151156148a05781518083602001fd5b8060405162461bcd60e51b81526004016107079190614b14565b6000602082840312156148cc57600080fd5b81356001600160e01b03198116811461407657600080fd5b6001600160a01b0391909116815260200190565b60006020828403121561490a57600080fd5b5035919050565b6001600160a01b03811681146107e357600080fd5b6000806040838503121561493957600080fd5b82359150602083013561494b81614911565b809150509250929050565b60006020828403121561496857600080fd5b813561407681614911565b634e487b7160e01b600052604160045260246000fd5b60405161016081016001600160401b03811182821017156149ac576149ac614973565b60405290565b60405161012081016001600160401b03811182821017156149ac576149ac614973565b60405160e081016001600160401b03811182821017156149ac576149ac614973565b60405160a081016001600160401b03811182821017156149ac576149ac614973565b604051601f8201601f191681016001600160401b0381118282101715614a4157614a41614973565b604052919050565b60008060408385031215614a5c57600080fd5b8235614a6781614911565b91506020838101356001600160401b0380821115614a8457600080fd5b818601915086601f830112614a9857600080fd5b813581811115614aaa57614aaa614973565b614abc601f8201601f19168501614a19565b91508082528784828501011115614ad257600080fd5b80848401858401376000848284010152508093505050509250929050565b60005b83811015614b0b578181015183820152602001614af3565b50506000910152565b6020815260008251806020840152614b33816040850160208701614af0565b601f01601f19169190910160400192915050565b60008083601f840112614b5957600080fd5b5081356001600160401b03811115614b7057600080fd5b60208301915083602082850101111561256c57600080fd5b6000806000806000806000806000806101008b8d031215614ba857600080fd5b8a356001600160401b0380821115614bbf57600080fd5b614bcb8e838f01614b47565b909c509a5060208d0135915080821115614be457600080fd5b50614bf18d828e01614b47565b90995097505060408b0135955060608b0135945060808b0135935060a08b0135614c1a81614911565b925060c08b0135614c2a81614911565b8092505060e08b013590509295989b9194979a5092959850565b60008083601f840112614c5657600080fd5b5081356001600160401b03811115614c6d57600080fd5b6020830191508360208260051b850101111561256c57600080fd5b60008060008060408587031215614c9e57600080fd5b84356001600160401b0380821115614cb557600080fd5b614cc188838901614c44565b90965094506020870135915080821115614cda57600080fd5b50614ce787828801614c44565b95989497509550505050565b600060208284031215614d0557600080fd5b81356001600160401b03811115614d1b57600080fd5b820160a0818503121561407657600080fd5b60008060008060008060008060006101008a8c031215614d4c57600080fd5b8935614d5781614911565b985060208a0135614d6781614911565b975060408a0135614d7781614911565b965060608a0135614d8781614911565b955060808a0135614d9781614911565b945060a08a0135614da781614911565b935060c08a0135614db781614911565b925060e08a01356001600160401b03811115614dd257600080fd5b614dde8c828d01614b47565b915080935050809150509295985092959850929598565b6020808252602c908201527f46756e6374696f6e206d7573742062652063616c6c6564207468726f7567682060408201526b19195b1959d85d1958d85b1b60a21b606082015260800190565b6020808252602c908201527f46756e6374696f6e206d7573742062652063616c6c6564207468726f7567682060408201526b6163746976652070726f787960a01b606082015260800190565b8183823760009101908152919050565b634e487b7160e01b600052601160045260246000fd5b8181038181111561066b5761066b614e9d565b808202811582820484141761066b5761066b614e9d565b600082614efa57634e487b7160e01b600052601260045260246000fd5b500490565b634e487b7160e01b600052603260045260246000fd5b600060018201614f2757614f27614e9d565b5060010190565b92835290151560208301521515604082015260600190565b6000808335601e19843603018112614f5d57600080fd5b8301803591506001600160401b03821115614f7757600080fd5b6020019150600581901b360382131561256c57600080fd5b81835260006001600160fb1b03831115614fa857600080fd5b8260051b80836020870137939093016020019392505050565b606081526000614fd560608301888a614f8f565b8281036020840152614fe8818789614f8f565b90508281036040840152614ffd818587614f8f565b9998505050505050505050565b60006001600160401b0382111561502357615023614973565b5060051b60200190565b8051613a6381614911565b600082601f83011261504957600080fd5b8151602061505e6150598361500a565b614a19565b82815260059290921b8401810191818101908684111561507d57600080fd5b8286015b848110156150985780518352918301918301615081565b509695505050505050565b600082601f8301126150b457600080fd5b815160206150c46150598361500a565b82815260059290921b840181019181810190868411156150e357600080fd5b8286015b848110156150985780516150fa81614911565b83529183019183016150e7565b80518015158114613a6357600080fd5b600082601f83011261512857600080fd5b815160206151386150598361500a565b82815260059290921b8401810191818101908684111561515757600080fd5b8286015b848110156150985780516001600160401b038082111561517b5760008081fd5b90880190610160828b03601f19018113156151965760008081fd5b61519e614989565b87840151815260406151b181860161502d565b89830152606080860151828401526080915081860151818401525060a0808601518284015260c0915081860151858111156151ec5760008081fd5b6151fa8f8c838a0101615038565b82850152505060e061520d81870161502d565b82840152610100915081860151858111156152285760008081fd5b6152368f8c838a01016150a3565b828501525050610120935061524c848601615107565b9082015261014061525e85820161502d565b8483015261526d838601615107565b90820152865250505091830191830161515b565b6000806040838503121561529457600080fd5b82516001600160401b03808211156152ab57600080fd5b818501915085601f8301126152bf57600080fd5b815160206152cf6150598361500a565b82815260059290921b840181019181810190898411156152ee57600080fd5b8286015b848110156153e25780518681111561530957600080fd5b8701610120818d03601f190181131561532157600080fd5b6153296149b2565b86830151815261533b6040840161502d565b87820152606083015160408201526080830151606082015260a08301518981111561536557600080fd5b6153738f8983870101615038565b60808301525061538560c0840161502d565b60a082015260e08301518981111561539d5760008081fd5b6153ab8f89838701016150a3565b60c0830152506101006153bf818501615107565b60e08301526153cf83850161502d565b90820152855250509183019183016152f2565b50918801519196509093505050808211156153fc57600080fd5b5061540985828601615117565b9150509250929050565b604081526000615427604083018688614f8f565b828103602084015261543a818587614f8f565b979650505050505050565b600082601f83011261545657600080fd5b815160206154666150598361500a565b82815260e0928302850182019282820191908785111561548557600080fd5b8387015b8581101561550d5781818a0312156154a15760008081fd5b6154a96149d5565b81518152858201516154ba81614911565b8187015260408281015190820152606080830151908201526080808301519082015260a0808301516154eb81614911565b9082015260c06154fc838201615107565b908201528452928401928101615489565b5090979650505050505050565b600080604080848603121561552e57600080fd5b83516001600160401b038082111561554557600080fd5b818601915086601f83011261555957600080fd5b815160206155696150598361500a565b82815260a0928302850182019282820191908b85111561558857600080fd5b958301955b848710156155f65780878d0312156155a55760008081fd5b6155ad6149f7565b87518152848801516155be81614911565b818601528789015189820152606080890151908201526080808901516155e381614911565b908201528352958601959183019161558d565b509189015191975090945050508083111561561057600080fd5b505061540985828601615445565b600081518084526020808501945080840160005b838110156156575781516001600160a01b031687529582019590820190600101615632565b509495945050505050565b600081518084526020808501945080840160005b8381101561565757815187529582019590820190600101615676565b8481526001600160a01b03841660208201526080604082018190526000906156bc9083018561561e565b828103606084015261543a8185615662565b9283526001600160a01b03919091166020830152604082015260600190565b6000602082840312156156ff57600080fd5b61407682615107565b634e487b7160e01b600052600160045260246000fd5b86815285602082015260018060a01b038516604082015283606082015260a060808201528160a0820152818360c0830137600081830160c090810191909152601f909201601f1916010195945050505050565b60006020828403121561578357600080fd5b815160ff8116811461407657600080fd5b9283526020830191909152604082015260600190565b6000602082840312156157bc57600080fd5b5051919050565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b60006020828403121561582057600080fd5b815161407681614911565b8082018082111561066b5761066b614e9d565b600181815b8085111561587957816000190482111561585f5761585f614e9d565b8085161561586c57918102915b93841c9390800290615843565b509250929050565b6000826158905750600161066b565b8161589d5750600061066b565b81600181146158b357600281146158bd576158d9565b600191505061066b565b60ff8411156158ce576158ce614e9d565b50506001821b61066b565b5060208310610133831016604e8410600b84101617156158fc575081810a61066b565b615906838361583e565b806000190482111561591a5761591a614e9d565b029392505050565b60006140768383615881565b60008161593d5761593d614e9d565b506000190190565b76020b1b1b2b9b9a1b7b73a3937b61d1030b1b1b7bab73a1604d1b815260008351615977816017850160208801614af0565b7001034b99036b4b9b9b4b733903937b6329607d1b60179184019182015283516159a8816028840160208801614af0565b01602801949350505050565b60018060a01b038716815285602082015284604082015260c0606082015260006159e160c083018661561e565b82810360808401526159f38186615662565b9150508260a0830152979650505050505050565b6001600160a01b0394909416845260208401929092526040830152606082015260800190565b60008060408385031215615a4057600080fd5b82516001600160401b0380821115615a5757600080fd5b615a63868387016150a3565b93506020850151915080821115615a7957600080fd5b5061540985828601615038565b60008251615a98818460208701614af0565b919091019291505056fe793a6c9b7e0a9549c74edc2f9ae0dc50903dfaa9a56fb0116b27a8c71de3e2c630d41a597cac127d8249d31298b50e481ee82c3f4a49ff93c76a22735aa9f3ad360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a49807205ce4d355092ef5a8a18f56e8913cf4a201fbe287825b095693c21775a2646970667358221220625af9e65efe9e34e1982c56d100ee2f5c5f1796eba1d31e67b5902aac07b41f64736f6c63430008120033
Loading...
Loading
Loading...
Loading
Net Worth in USD
$0.00
Net Worth in ETH
0
Multichain Portfolio | 34 Chains
| Chain | Token | Portfolio % | Price | Amount | Value |
|---|
Loading...
Loading
Loading...
Loading
Loading...
Loading
A contract address hosts a smart contract, which is a set of code stored on the blockchain that runs when predetermined conditions are met. Learn more about addresses in our Knowledge Base.