initial implementation

README.md

@@ -0,0 +1,88 @@
+# Direct Stability Parameters Change Module (DSPC)
+
+A module for the Sky Protocol that enables direct changes to stability parameters (duty, dsr, ssr) through a simple, secure interface with proper constraints and timelocks.
+
+## Overview
+
+The DSPC module provides a streamlined way to modify stability parameters in the Maker Protocol, including:
+- Stability fees (duty) for different collateral types via the Jug contract
+- Dai Savings Rate (DSR) via the Pot contract
+- Sky Savings Rate (SSR) via the sUSDS contract
+
+## Features
+
+- Batch updates for multiple rate changes
+- Two-level access control:
+  - Admins can configure the module
+  - Facilitators can propose and execute rate changes
+- Rate change constraints:
+  - Min/max caps per rate
+  - Max update delta
+- Event emission for all actions
+- Simple, auditable implementation
+
+## Installation
+
+```bash
+forge install
+```
+
+## Testing
+
+```bash
+forge test
+```
+
+## Usage
+
+1. Deploy the contract with the required addresses:
+```solidity
+DSPC dspc = new DSPC(
+    jugAddress,  // For stability fees
+    potAddress,  // For DSR
+    susdsAddress, // For SSR
+    convAddress  // For rate conversions
+);
+```
+
+2. Configure the module parameters:
+```solidity
+// Set timelock duration
+dspc.file("tau", 1 days);
+
+// Configure constraints for a collateral type
+dspc.file("ETH-A", "min", 1);     // Min rate: 0.01%
+dspc.file("ETH-A", "max", 1000);  // Max rate: 10%
+dspc.file("ETH-A", "step", 100);  // Max change: 1%
+
+// Configure constraints for DSR
+dspc.file("DSR", "min", 1);    // Min rate: 0.01%
+dspc.file("DSR", "max", 800);  // Max rate: 8%
+dspc.file("DSR", "step", 100);  // Max change: 1%
+```
+
+3. Add facilitators who can propose and execute rate changes:
+```solidity
+dspc.kiss(facilitatorAddress);
+```
+
+4. Execute a batch of rate changes:
+```solidity
+DSPC.ParamChange[] memory updates = new DSPC.ParamChange[](2);
+updates[0] = DSPC.ParamChange("ETH-A", 150);  // Set ETH-A rate to 1.5%
+updates[1] = DSPC.ParamChange("DSR", 75);     // Set DSR to 0.75%
+dspc.set(updates);
+```
+
+## Security
+
+The module implements a robust security model:
+- Two-level access control (admins and facilitators)
+- Rate constraints to prevent extreme changes
+- Disabling without GSM delay via DSPCMom contract
+- Circuit breaker (halt) functionality
+- All actions emit events for transparency
+
+## License
+
+AGPL-3.0-or-later

script/DSPCDeploy.s.sol

@@ -0,0 +1,61 @@
+// SPDX-FileCopyrightText: © 2025 Dai Foundation <www.daifoundation.org>
+// SPDX-License-Identifier: AGPL-3.0-or-later
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program.  If not, see <https://www.gnu.org/licenses/>.
+pragma solidity ^0.8.24;
+
+import {Script} from "forge-std/Script.sol";
+import {stdJson} from "forge-std/StdJson.sol";
+import {MCD, DssInstance} from "dss-test/MCD.sol";
+import {ScriptTools} from "dss-test/ScriptTools.sol";
+import {DSPCDeploy, DSPCDeployParams} from "src/deployment/DSPCDeploy.sol";
+import {DSPCInstance} from "src/deployment/DSPCInstance.sol";
+
+contract DSPCDeployScript is Script {
+    using stdJson for string;
+    using ScriptTools for string;
+
+    string constant NAME = "dspc-deploy";
+    string config;
+
+    address constant CHAINLOG = 0xdA0Ab1e0017DEbCd72Be8599041a2aa3bA7e740F;
+    DssInstance dss = MCD.loadFromChainlog(CHAINLOG);
+    address pauseProxy = dss.chainlog.getAddress("MCD_PAUSE_PROXY");
+    address conv;
+    DSPCInstance inst;
+
+    function run() external {
+        config = ScriptTools.loadConfig();
+        conv = config.readAddress(".conv", "FOUNDRY_CONV");
+
+        vm.startBroadcast();
+
+        inst = DSPCDeploy.deploy(
+            DSPCDeployParams({
+                deployer: msg.sender,
+                owner: pauseProxy,
+                jug: address(dss.jug),
+                pot: address(dss.pot),
+                susds: dss.chainlog.getAddress("SUSDS"),
+                conv: conv
+            })
+        );
+
+        vm.stopBroadcast();
+
+        ScriptTools.exportContract(NAME, "dspc", address(inst.dspc));
+        ScriptTools.exportContract(NAME, "mom", address(inst.mom));
+        ScriptTools.exportContract(NAME, "conv", conv);
+    }
+}

script/input/1/README.md

@@ -0,0 +1,24 @@
+# Network 1 (Ethereum Mainnet) Deployment Configuration
+
+This directory contains the configuration files for deploying DSPC on Ethereum Mainnet.
+
+## Files
+
+### dspc-deploy.json
+Configuration for deploying DSPC and DSPCMom contracts:
+- `conv`: Address of the converter contract that handles rate conversions between basis points and ray format
+
+## Usage
+
+1. Copy `template-dspc-deploy.json` into a new file (i.e.: `dspc-deploy.json`)
+2. Edit the new file with the correct `conv` address
+3. Run the deployment script:
+```bash
+FOUNDRY_SCRIPT_CONFIG=dspc-deploy forge script script/DSPCDeploy.s.sol:DSPCDeployScript \
+    --rpc-url $ETH_RPC_URL \
+    --broadcast
+
+The deployment script will:
+1. Load system addresses from chainlog (jug, pot, susds)
+2. Deploy DSPC and DSPCMom contracts
+4. Export addresses to `/script/output/1/dspc-deploy.json`

script/input/1/template-dspc-deploy.json

@@ -0,0 +1,3 @@
+{
+    "conv": "address: the address of the rate conversion contract."
+}

script/output/1/README.md

@@ -0,0 +1 @@
+Outputs for Mainnet scripts.