MarketPlace

Annotated source code of the MarketPlace.sol smart contract

MarketPlace

Contents

Globals

Note this list contains both internal and external attributes

Modifiers

authorized

Restricts msg.sender as the only viable caller of a method

Declaration

modifier authorized

unpaused

Returns whether a given market is paused or not

Declaration

modifier unpaused

Functions

constructor

Declaration

function constructor(
address c
) public

Modifiers:

No modifiers

Args:

setSwivel

We only allow this to be set once

there is no emit here as it's only done once post deploy by the deploying admin

Declaration

function setSwivel(
address s
) external authorized returns
(bool)

Modifiers:

Args:

setAdmin

No description

Declaration

function setAdmin(
address a
) external authorized returns
(bool)

Modifiers:

Args:

createMarket

Allows the owner to create new markets

the memory allocation of s is for alleviating STD err, there's no clearly superior scoping or abstracting alternative.

Declaration

function createMarket(
uint8 p,
uint256 m,
address c,
string n,
string s
) external authorized unpaused returns
(bool)

Modifiers:

Args:

matureMarket

Can be called after maturity, allowing all of the zcTokens to earn floating interest on Compound until they release their funds

Declaration

function matureMarket(
uint8 p,
address u,
uint256 m
) public unpaused returns
(bool)

Modifiers:

Args:

mintZcTokenAddingNotional

Allows Swivel caller to deposit their underlying, in the process splitting it - minting both zcTokens and vault notional.

Declaration

function mintZcTokenAddingNotional(
uint8 p,
address u,
uint256 m,
address t,
uint256 a
) external authorized unpaused returns
(bool)

Modifiers:

Args:

burnZcTokenRemovingNotional

Allows Swivel caller to deposit/burn both zcTokens + vault notional. This process is "combining" the two and redeeming underlying.

Declaration

function burnZcTokenRemovingNotional(
uint8 p,
address u,
uint256 m,
address t,
uint256 a
) external authorized unpaused returns
(bool)

Modifiers:

Args:

authRedeem

Implementation of authRedeem to fulfill the IRedeemer interface for ERC5095

Declaration

function authRedeem(
uint8 p,
address u,
uint256 m,
address f,
address t,
uint256 a
) external authorized unpaused returns
(uint256)

Modifiers:

Args:

Returns:

redeemZcToken

Allows (via swivel) zcToken holders to redeem their tokens for underlying tokens after maturity has been reached.

Declaration

function redeemZcToken(
uint8 p,
address u,
uint256 m,
address t,
uint256 a
) external authorized unpaused returns
(uint256)

Modifiers:

Args:

redeemVaultInterest

Allows Vault owners (via Swivel) to redeem any currently accrued interest

Declaration

function redeemVaultInterest(
uint8 p,
address u,
uint256 m,
address t
) external authorized unpaused returns
(uint256)

Modifiers:

Args:

calculateReturn

Calculates the total amount of underlying returned including interest generated since the matureMarket function has been called

Declaration

function calculateReturn(
uint8 p,
address u,
uint256 m,
uint256 a
) internal returns
(uint256)

Modifiers:

No modifiers

Args:

cTokenAddress

Return the compounding token address for a given market

Declaration

function cTokenAddress(
uint8 p,
address u,
uint256 m
) external returns
(address)

Modifiers:

No modifiers

Args:

exchangeRate

Return the exchange rate for a given protocol's compounding token

Declaration

function exchangeRate(
uint8 p,
address c
) external returns
(uint256)

Modifiers:

No modifiers

Args:

rates

Return current rates (maturity, exchange) for a given vault. See VaultTracker.rates for details

While it's true that Compounding exchange rate is not strictly affiliated with a vault, the 2 data points are usually needed together.

Declaration

function rates(
uint8 p,
address u,
uint256 m
) external returns
(uint256, uint256)

Modifiers:

No modifiers

Args:

custodialInitiate

Called by swivel IVFZI && IZFVI

Call with protocol, underlying, maturity, mint-target, add-notional-target and an amount

Declaration

function custodialInitiate(
uint8 p,
address u,
uint256 m,
address z,
address n,
uint256 a
) external authorized unpaused returns
(bool)

Modifiers:

Args:

custodialExit

Called by swivel EVFZE FF EZFVE

Call with protocol, underlying, maturity, burn-target, remove-notional-target and an amount

Declaration

function custodialExit(
uint8 p,
address u,
uint256 m,
address z,
address n,
uint256 a
) external authorized unpaused returns
(bool)

Modifiers:

Args:

p2pZcTokenExchange

Called by swivel IZFZE, EZFZI

Call with underlying, maturity, transfer-from, transfer-to, amount

Declaration

function p2pZcTokenExchange(
uint8 p,
address u,
uint256 m,
address f,
address t,
uint256 a
) external authorized unpaused returns
(bool)

Modifiers:

Args:

p2pVaultExchange

Called by swivel IVFVE, EVFVI

Call with protocol, underlying, maturity, remove-from, add-to, amount

Declaration

function p2pVaultExchange(
uint8 p,
address u,
uint256 m,
address f,
address t,
uint256 a
) external authorized unpaused returns
(bool)

Modifiers:

Args:

transferVaultNotional

External method giving access to this functionality within a given vault

Note that this method calculates yield and interest as well

Declaration

function transferVaultNotional(
uint8 p,
address u,
uint256 m,
address t,
uint256 a
) external unpaused returns
(bool)

Modifiers:

Args:

transferVaultNotionalFee

Transfers notional fee to the Swivel contract without recalculating marginal interest for from

Declaration

function transferVaultNotionalFee(
uint8 p,
address u,
uint256 m,
address f,
uint256 a
) external authorized returns
(bool)

Modifiers:

Args:

pause

Called by admin at any point to pause / unpause market transactions in a specified protocol

Declaration

function pause(
uint8 p,
bool b
) external authorized returns
(bool)

Modifiers:

Args:

Events

Create

Emitted upon the creation of a market

Mature

Emitted upon the maturation of a market

RedeemZcToken

Emitted upon the redemption of a ZC token

RedeemVaultInterest

Emitted upon the redemption of vault interest

CustodialInitiate

Emitted upon a custodial initiate

CustodialExit

Emitted upon a custodial exit

P2pZcTokenExchange

Emitted upon a P2P ZC token swap

P2pVaultExchange

Emitted upon a vault swap

TransferVaultNotional

Emitted upon a transfer of notional from a vault

SetAdmin

Emitted on a change of the admin