Skip to content

v0.1.0

Latest

Choose a tag to compare

@0xLaz3r 0xLaz3r released this 17 Nov 16:07
555d1c1

DssExecLib v0.1.0 release notes

DssExecLib v0.1.0 — the post-Chief-Migration revamp of the executive-spell library for the Sky Protocol.

Audits (both covering this exact commit):

  • ChainSecurity — Version 3 of the report, dated June 12, 2026, covers 555d1c1. It is attached to this release as ChainSecurity_Sky_DSSExecLib_Audit.pdf (SHA-256 0c42f9d17d9078d9179bbc01e628def53c87a07d85d1dfab2f1008d4c65c5312). The PDF on ChainSecurity's site may be revised for changes outside this release; the attached file is the reference for this tag.
  • Cantina — final report, July 15, 2026, attached to this release as cantina_sky_dss_exec_lib_jul2026.pdf.

Technical scope forum post: Technical scope of the DssExecLib v0.1.0 upgrade. The Library changes section lists every change with source links; the Migration notes for spell crafters give the call-site guidance that these notes only summarize.

Highlights:

  • Solidity 0.6.x → 0.8.16; the hand-rolled safe-math helpers are gone
  • USDS/SSR support: usds(), sky(), susds(), usdsJoin(), setSSR, accumulateSSR; sendPaymentFromSurplusBuffer now supports USDS payouts
  • Star Spell support: executeStarSpell / tryExecuteStarSpell, and plotStarSpell / dropStarSpell for the StarGuard
  • Other new helpers: setRWAIlkDebtCeiling, removeChangelogAddress, setSurplusAuctionMinPriceThreshold, setGSMDelay, pause(), and a 3-argument setIlkAutoLineParameters(ilk, amount, gap) overload that keeps the existing ttl (ilks already in AutoLine only)
  • Generic naming for the governance token and the stablecoin after the SKY launch; Medianizer- and Cat-era helpers removed
  • Stricter input checks relative to v0.0.9: hole >= dust in setIlkMaxLiquidationAmount, a uint192 bound in setKeeperIncentiveFlatRate, uint48 bounds in setDebtAuctionBidDuration / setDebtAuctionDuration, and a below-100 % bound in setDebtAuctionMKRIncreaseRate

Breaking changes (compile-time unless noted):

  • sendPaymentFromSurplusBuffer(address _join, address _target, uint256 _amount) — a new first argument selects the Join adapter; the expected values are DssExecLib.daiJoin() or DssExecLib.usdsJoin(), and the library does not check the address. The recipient and the whole-unit amount are unchanged from v0.0.9. A Join adapter needs a one-time vat.hope(JOIN) by the Pause Proxy before its first use (DssExecLib.delegateVat(JOIN)): MCD_JOIN_DAI already has it, USDS_JOIN does not.
  • Renamed: addReaderToWhitelist → addToWhitelist, removeReaderFromWhitelist → removeFromWhitelist, setDebtAuctionDAIAmount → setDebtAuctionDebtAmount, setDebtAuctionMKRAmount → setDebtAuctionGovAmount, setMaxTotalDAILiquidationAmount → setMaxTotalDebtLiquidationAmount, setDAIReferenceValue → setParity, setD3MTargetInterestRate → setDDMTargetInterestRate
  • Removed: setSurplusAuctionBidDuration, setMinSurplusAuctionBidIncrease, setSurplusAuctionDuration, setMedianWritersQuorum, whitelistOracleMedians, setMaxTotalDAILiquidationAmountLEGACY, the cat() / flipperMom() getters, addReaderToWhitelistCall / removeReaderFromWhitelistCall, the internal add / sub / mul / wmul / rmul helpers and the BPS_ONE_PCT constant
  • DssAction.officeHours() and DssAction.nextCastTime() are now view; overrides in spell actions must be view or pure
  • CollateralOpts.whitelistOSM → checkWhitelistedOSM, and the semantics changed: addNewCollateral now only asserts that the OSM is whitelisted on its source (src.bud(pip) == 1) instead of performing the kiss. Arrange the whitelisting with the oracle provider before the spell is cast; setting the field to false skips the check, and setting it to true no longer whitelists the OSM on its source as v0.0.9 did.
  • Runtime, not compile-time: mkr() now resolves the MKR Chainlog key (the MKR token). Under v0.0.9 it resolved MCD_GOV, which has pointed at the SKY token since the SKY launch. Check every helper or action that calls DssExecLib.mkr() expecting the SKY token and switch it to DssExecLib.sky().
  • Runtime, not compile-time: setIlkMaxLiquidationAmount now requires hole >= dust, and setIlkMinVaultAmount has required dust <= hole since v0.0.9. When a spell updates both for one ilk, order the calls so the invariant holds after each step (increasing both: hole first; decreasing both: dust first).

Known issues carried in this release (restrictions and details in the technical scope forum post's Known issues):

  • govGuard() reverts: the GOV_GUARD Chainlog key was renamed to MKR_GUARD on-chain. Do not use it.
  • setGlobalStabilityFee must not be used (ChainSecurity CS-SKY-EXL-004, risk accepted).
  • The AutoLine setters do not call AutoLine.exec; follow each call with exec(ilk), as the reviewer checklist requires. setIlkDebtCeiling and its increase / decrease variants ignore the AutoLine configuration, so an ilk managed by the AutoLine must be removed from it first.
  • setIlkAutoLineDebtCeiling has no _amount < WAD guard; pass whole units.
  • tryExecuteStarSpell can be forced to fail without reverting the spell; the updated checklists do not include it — use executeStarSpell for direct execution.
  • setSurplusBuffer / setSurplusAuctionAmount file the Vow, whose surplus path is dormant since the Kicker (MCD_KICK carries kbump / khump); do not use them.
  • Helpers for mechanisms that are inactive today remain callable: the flop setters (setDebtAuctionDelay, setDebtAuctionBidDuration, setDebtAuctionDuration, setMinDebtAuctionBidIncrease, setDebtAuctionMKRIncreaseRate), which keep their legacy names (setDebtAuctionMKRIncreaseRate still carries MKR), setDebtAuctionDebtAmount / setDebtAuctionGovAmount, setDDMTargetInterestRate and the flip() alias of reg().xlip(ilk). They are not restricted, just unused.
  • Collateral onboarding is not complete: addNewCollateral does not register the ilk with LINE_MOM, addCollateralBase does not set the calc parameters, and setIlkLiquidationRatio does not poke the spotter; these remain separate spell actions.

Adoption:

  • spells-mainnet #579 — integration PR; pins 555d1c1, the commit this tag points to
  • pe-checklists #86 — crafter, reviewer, collateral-onboarding and RWA checklists
  • dss-test #51 — nested dss-interfaces alignment, merged 2026-10-19

Full diff: v0.0.9...v0.1.0