ISurplusAuctionHouse

Git Source

Inherits: IAuthorizable, IDisableable, IModifiable, ICommonSurplusAuctionHouse

Functions

params

Getter for the contract parameters struct

function params() external view returns (SurplusAuctionHouseParams memory _sahParams);

Returns

NameTypeDescription
_sahParamsSurplusAuctionHouseParamsAuction house parameters struct

_params

Getter for the unpacked contract parameters struct

function _params()
  external
  view
  returns (
    uint256 _bidIncrease,
    uint256 _bidDuration,
    uint256 _totalAuctionLength,
    address _bidReceiver,
    uint256 _recyclingPercentage
  );

Returns

NameTypeDescription
_bidIncreaseuint256Minimum bid increase compared to the last bid in order to take the new one in consideration [wad %]
_bidDurationuint256How long the auction lasts after a new bid is submitted [seconds]
_totalAuctionLengthuint256Total length of the auction [seconds]
_bidReceiveraddressReceiver of protocol tokens
_recyclingPercentageuint256Percentage of protocol tokens to recycle [wad %]

terminateAuctionPrematurely

Terminate an auction prematurely.

function terminateAuctionPrematurely(uint256 _id) external;

Parameters

NameTypeDescription
_iduint256ID of the auction to settle/terminate

Events

TerminateAuctionPrematurely

Emitted when an auction is prematurely terminated

event TerminateAuctionPrematurely(
  uint256 indexed _id, uint256 _blockTimestamp, address _highBidder, uint256 _raisedAmount
);

Parameters

NameTypeDescription
_iduint256Id of the auction
_blockTimestampuint256Time when the auction was terminated
_highBidderaddressWho won the auction
_raisedAmountuint256Amount of protocol tokens raised in the auction [rad]

Errors

SAH_NullProtTokenReceiver

Throws when trying to start an auction with non-zero recycling percentage and null bid receiver

error SAH_NullProtTokenReceiver();

Structs

SurplusAuctionHouseParams

struct SurplusAuctionHouseParams {
  uint256 bidIncrease;
  uint256 bidDuration;
  uint256 totalAuctionLength;
  address bidReceiver;
  uint256 recyclingPercentage;
}