Skip to main content
The IRIS core contract cannot be upgraded. A short list of settings can change, and only the owner can change them. On Ethereum mainnet the owner is a timelock, so every change waits 48 hours.

The owner is a timelock

A change takes two transactions. The Safe first schedules the call on the Timelock, which puts the target and the calldata on chain. At least 48 hours later the Safe can execute it. Until then the Safe can cancel it. Scheduling, executing and cancelling each emit an event. The API lists them as Timelock events, and @iris-credit/core-sdk exports the Timelock address (getChainAddresses(ChainId.EthMainnet).timelock) and timelockAbi to read them onchain. The Timelock is its own admin. Changing its delay or its roles is also a Timelock operation and waits the same 48 hours. Blm and WhitelistBlm accept their setters only from Iris.owner(), so they sit behind the same Timelock.

What the owner can change

enableBlm, enableBondLltv and enableData are one-way. Iris has no function that disables a bond lock module, a bond LLTV or a market payload once it is enabled.

How a change reaches open loans

  • Protocol fee. Each loan records the fee in force when it opens and settles with that value, so setFee applies to loans opened after it.
  • Fee recipient. Read at settlement, so it applies to every loan that settles after the change.
  • Bond parameters. A loan’s bond requirement is computed once, when it opens, so setParams applies to new quotes only.
  • Whitelist. WhitelistBlm checks it when a quote that uses that module opens a loan.
  • Venue adapters. Every action on a position calls the adapter currently set for the position’s venue id. setVenueAdapter on an id in use therefore changes the code that runs for open positions on that venue, 48 hours after the change is scheduled.

Current configuration on Ethereum mainnet

Protocol fee

When a loan settles, IRIS takes the protocol fee as a share of two amounts: the solver’s net (the fixed leg minus the floating leg, when that is positive) and the collateral surplus. The fee share of each is credited to the fee recipient’s claimable balance and the rest to the solver’s. The owner sets the fee, up to 40% (MAX_FEE). On Ethereum mainnet the fee is 10%, set through the Timelock. fee() on Iris returns the current value in basis points, so 1000 means 10%.