Skip to content

3.4.0

Latest
Latest
Compare
Choose a tag to compare
@tbrent tbrent released this 30 May 19:41
3.4.0-rc1
78152ed

This release adds Arbitrum support by adjusting Furnace/StRSR/Governance to function off of timestamp/timepoints, instead of discrete periods. This changes the interface of the governance voting token StRSR, making this a complicated and nuanced upgrade to get right, and requiring an upgrade of the corresponding governance/timelock.

Upgrade Steps

Warning: Do not attempt to execute the steps below manually. They are only a high-level overview of the changes made in this release. It is recommended to use the 3.4.0 Upgrade spell located at spells/3_4_0.sol and deployed to mainnet at 0xb1df3a104d73ff86f9aaab60b491a5c44b090391 and base at 0x1744c9933feb8e76563fce63d5c95a4e7f967c2a. These deployments will only work for the 11 RTokens: eUSD, ETH+, hyUSD (mainnet), USDC+, USD3, rgUSD, hyUSD (base), bsdETH, iUSDC, Vaya, and MAAT.

High-level overview:

  • Upgrade all core contracts and plugins. This includes ALL assets and trading plugins, including the RTokenAsset itself
  • Update 3.4.0 ERC20s via setPrimeBasket() + setBackupConfig()
  • Call cacheComponents() on Broker if upgrading from >=3.0.0, and also on BackingManager, Distributor, and both RevenueTraders, if upgrading from <3.0.0
  • Adjust Furnace melt + StRSR drip ratios to be based on 1s. For example: divide ratios by 12 if upgrading an RToken on ethereum mainnet
  • Deploy new TimelockController + Governance contracts and rotate adminship of RTokens. This effectively creates a new DAO for each RToken
  • The tradingDelay can also be safely set to 0. It was a training wheel and is no longer necessary

Core Protocol Contracts

Throughout many core contracts negligible gas improvements have been applied. These are excluded from the list below.

  • BackingManager
    • Remove requirement for empty block between auctions of same kind (auctions must still be in different blocks)
  • BasketHandler
    • Set max number of backup erc20s: 64
    • Require all collateral are SOUND during index RToken setPrimeBasket()
  • Broker
    • Switch to timestamp-based auctions
  • Furnace
    • Switch to timestamp-based melting
  • StRSR
    • Switch to timestamp-based RSR drip
  • StRSRP1Votes
    • Switch to timestamp-based checkpointing
    • Add IERC58505 support
      • clock() external view returns (uint48)
      • CLOCK_MODE() external view returns (string memory)

Plugins

Assets

  • Deprecate EURT
  • Rename ZeroPrice() error to InvalidPrice()
  • aave-v3
    • Add try-catch to StaticATokenV3LM.metaDeposit()
  • compound-v3
    • Fix allowance check in claimTo() to use msg.sender
  • curve/convex
    • Add CurveAppreciatingRTokenFiatCollateral + CurveAppreciatingRTokenSelfReferentialCollateral to support ETH+/ETH curve pools in non-recursive cases
    • Modify CurveStableRTokenMetapoolCollateral to check isReady() and fullyCollateralized() status of underlying RTokens; try-catch asset-registry refresh call.
  • metamorpho
    • Add MetaMorphoFiatCollateral + MetaMorphoSelfReferentialCollateral to support steakUSDC/steakUSDP/bbUSDT/Re7WETH morpho blue managed vaults
  • frax
    • Add missing defaultThreshold != 0 check

Trading

  • DutchTrade
    • Switch to timestamp-based model
    • price(uint256 blockNumber) -> price(uint48 timestamp)
    • Remove startBlock() returns (uint256) + endBlock() returns (uint256)
    • Add startTime() returns (uint48)
    • bid(uint256 blockNumber) => bid(uint48 timestamp)

Facades

Switch to new Facade singleton model with multiple facets

  • FacadeRead => ReadFacet + MaxIssuableFacet
  • FacadeAct => ActFacet

FacadeMonitor remains independent.

Governance

Create new Governor Anastasius contract to supersede Governor Alexios. Required to work with new timepoint-based model in StRSRP1Votes.

  • name(): "Governor Alexios" => "Governor Anastasius"
  • quorum(uint256 blockNumber) => quorum(uint256 timepoint)
  • Add IERC58505 support
    • clock() external view returns (uint48)
    • CLOCK_MODE() external view returns (string memory)
Assets 2
Loading