Repository navigation
DssExecLib v0.1.0 release notes
DssExecLib v0.1.0 — the post-Chief-Migration revamp of the executive-spell library for the Sky Protocol.
- Deployed at:
0x99933a7b2982Ea2ad3d7e9027Cd034197aA562C2(Ethereum mainnet) — deployment tx0xf684a8686978753f79c0d7ed517602baed081bc229a2842461177210d15cb016, block25976058 - Audited commit:
555d1c158f2ab695e04d6de6e603b118d32214c4(this tag) - Build:
solc 0.8.16,optimizer_runs = 200, metadatabytecodeHash = ipfs, EVM targetlondon: the committedfoundry.tomlsetsevm_version = "cancun", which Foundry lowers tolondonfor solc 0.8.16, so a rebuild from the committed configuration without overrides reproduces the deployed bytecode
Audits (both covering this exact commit):
- ChainSecurity — Version 3 of the report, dated June 12, 2026, covers
555d1c1. It is attached to this release asChainSecurity_Sky_DSSExecLib_Audit.pdf(SHA-2560c42f9d17d9078d9179bbc01e628def53c87a07d85d1dfab2f1008d4c65c5312). 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;sendPaymentFromSurplusBuffernow supports USDS payouts - Star Spell support:
executeStarSpell/tryExecuteStarSpell, andplotStarSpell/dropStarSpellfor the StarGuard - Other new helpers:
setRWAIlkDebtCeiling,removeChangelogAddress,setSurplusAuctionMinPriceThreshold,setGSMDelay,pause(), and a 3-argumentsetIlkAutoLineParameters(ilk, amount, gap)overload that keeps the existingttl(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 >= dustinsetIlkMaxLiquidationAmount, auint192bound insetKeeperIncentiveFlatRate,uint48bounds insetDebtAuctionBidDuration/setDebtAuctionDuration, and a below-100 % bound insetDebtAuctionMKRIncreaseRate
Breaking changes (compile-time unless noted):
sendPaymentFromSurplusBuffer(address _join, address _target, uint256 _amount)— a new first argument selects the Join adapter; the expected values areDssExecLib.daiJoin()orDssExecLib.usdsJoin(), and the library does not check the address. The recipient and the whole-unit amount are unchanged fromv0.0.9. A Join adapter needs a one-timevat.hope(JOIN)by the Pause Proxy before its first use (DssExecLib.delegateVat(JOIN)):MCD_JOIN_DAIalready has it,USDS_JOINdoes not.- Renamed:
addReaderToWhitelist→addToWhitelist,removeReaderFromWhitelist→removeFromWhitelist,setDebtAuctionDAIAmount→setDebtAuctionDebtAmount,setDebtAuctionMKRAmount→setDebtAuctionGovAmount,setMaxTotalDAILiquidationAmount→setMaxTotalDebtLiquidationAmount,setDAIReferenceValue→setParity,setD3MTargetInterestRate→setDDMTargetInterestRate - Removed:
setSurplusAuctionBidDuration,setMinSurplusAuctionBidIncrease,setSurplusAuctionDuration,setMedianWritersQuorum,whitelistOracleMedians,setMaxTotalDAILiquidationAmountLEGACY, thecat()/flipperMom()getters,addReaderToWhitelistCall/removeReaderFromWhitelistCall, the internaladd/sub/mul/wmul/rmulhelpers and theBPS_ONE_PCTconstant DssAction.officeHours()andDssAction.nextCastTime()are nowview; overrides in spell actions must bevieworpureCollateralOpts.whitelistOSM→checkWhitelistedOSM, and the semantics changed:addNewCollateralnow only asserts that the OSM is whitelisted on its source (src.bud(pip) == 1) instead of performing thekiss. Arrange the whitelisting with the oracle provider before the spell is cast; setting the field tofalseskips the check, and setting it totrueno longer whitelists the OSM on its source asv0.0.9did.- Runtime, not compile-time:
mkr()now resolves theMKRChainlog key (the MKR token). Underv0.0.9it resolvedMCD_GOV, which has pointed at the SKY token since the SKY launch. Check every helper or action that callsDssExecLib.mkr()expecting the SKY token and switch it toDssExecLib.sky(). - Runtime, not compile-time:
setIlkMaxLiquidationAmountnow requireshole >= dust, andsetIlkMinVaultAmounthas requireddust <= holesincev0.0.9. When a spell updates both for one ilk, order the calls so the invariant holds after each step (increasing both:holefirst; decreasing both:dustfirst).
Known issues carried in this release (restrictions and details in the technical scope forum post's Known issues):
govGuard()reverts: theGOV_GUARDChainlog key was renamed toMKR_GUARDon-chain. Do not use it.setGlobalStabilityFeemust not be used (ChainSecurity CS-SKY-EXL-004, risk accepted).- The AutoLine setters do not call
AutoLine.exec; follow each call withexec(ilk), as the reviewer checklist requires.setIlkDebtCeilingand itsincrease/decreasevariants ignore the AutoLine configuration, so an ilk managed by the AutoLine must be removed from it first. setIlkAutoLineDebtCeilinghas no_amount < WADguard; pass whole units.tryExecuteStarSpellcan be forced to fail without reverting the spell; the updated checklists do not include it — useexecuteStarSpellfor direct execution.setSurplusBuffer/setSurplusAuctionAmountfile theVow, whose surplus path is dormant since the Kicker (MCD_KICKcarrieskbump/khump); do not use them.- Helpers for mechanisms that are inactive today remain callable: the
flopsetters (setDebtAuctionDelay,setDebtAuctionBidDuration,setDebtAuctionDuration,setMinDebtAuctionBidIncrease,setDebtAuctionMKRIncreaseRate), which keep their legacy names (setDebtAuctionMKRIncreaseRatestill carriesMKR),setDebtAuctionDebtAmount/setDebtAuctionGovAmount,setDDMTargetInterestRateand theflip()alias ofreg().xlip(ilk). They are not restricted, just unused. - Collateral onboarding is not complete:
addNewCollateraldoes not register the ilk withLINE_MOM,addCollateralBasedoes not set thecalcparameters, andsetIlkLiquidationRatiodoes notpokethe spotter; these remain separate spell actions.
Adoption:
spells-mainnet#579 — integration PR; pins555d1c1, the commit this tag points tope-checklists#86 — crafter, reviewer, collateral-onboarding and RWA checklistsdss-test#51 — nesteddss-interfacesalignment, merged 2026-10-19
Full diff: v0.0.9...v0.1.0