feat: enable cctp transfer

.env.dev

@@ -0,0 +1,3 @@
+FOUNDRY_ROOT_CHAINID = "43113" # Avalanche Fuji Testnet Chain ID
+PRIVATE_KEY = PRIVATE_KEY_PLACEHOLDER
+FUJI_RPC_URL = FUJI_RPC_URL_PLACEHOLDER

.github/workflows/test.yml

@@ -0,0 +1,38 @@
+name: CI
+
+on:
+  workflow_dispatch:
+  pull_request:
+  push:
+    branches:
+      - main
+
+env:
+  FOUNDRY_PROFILE: ci
+
+jobs:
+  check:
+    name: Foundry project
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - name: Install Foundry
+        uses: foundry-rs/foundry-toolchain@v1
+
+      - name: Run Forge fmt
+        run: |
+          forge fmt --check
+        id: fmt
+
+      - name: Run Forge build
+        run: |
+          forge build --sizes
+        id: build
+
+      - name: Run Forge tests
+        run: |
+          forge test -vvv
+        id: test

.gitignore

@@ -0,0 +1,14 @@
+# Compiler files
+cache/
+out/
+
+# Ignores development broadcast logs
+!/broadcast
+/broadcast/*/*/run-[0-9]*.json
+/broadcast/**/dry-run/
+
+# Docs
+docs/
+
+# Dotenv file
+.env

.gitmodules

@@ -0,0 +1,6 @@
+[submodule "lib/dss-allocator"]
+	path = lib/dss-allocator
+	url = https://github.com/sky-ecosystem/dss-allocator
+[submodule "lib/sky-star-alm-controller"]
+	path = lib/sky-star-alm-controller
+	url = https://github.com/sidestream-tech/sky-star-alm-controller

README.md

@@ -1 +1,101 @@
-# sky-star-test-setup
+# Sky Star Test Setup
+
+Easily deploy the Sky allocation system and Spark ALM controller to any EVM-compatible chain, including all required mock contracts. This repository is designed to help Sky Stars test and validate contracts quickly. 
+
+## Included Deployments
+
+- [`dss-allocator`](https://github.com/sky-ecosystem/dss-allocator)
+- [`spark-alm-controller`](https://github.com/sparkdotfi/spark-alm-controller)
+- Mock contracts: `vat`, `usdsJoin`, `usds`, `sUsds`, `jug`, `usdsDai`, `dai`, `daiJoin`, `psmLite`
+
+## Prerequisites
+
+- [Foundry](https://book.getfoundry.sh/) must be installed.
+
+
+## Quick Start
+
+To deploy and configure contracts to the Avalanche Fuji public testnet:
+
+1. Set environment variables
+    - Copy the example environment via `cp .env.dev .env`
+    - Edit `.env` to update the variables as described in the "Environment Variables" section below
+
+2. Set the desired ALM `relayer` address inside `script/input/{CHAIN_ID}/input.json`
+
+3. Set the desired CCTP `recipient` address inside `script/input/{CHAIN_ID}/input.json`
+
+4. Dry-run a transaction to determine the amount of required gas
+    ```sh
+    forge script script/SetUpAll.s.sol:SetUpAll --fork-url fuji -vv
+    ```
+
+5. Get enough gas tokens using a faucet
+
+6. (optional) Required for CCTP testing: Get enough testnet USDC from [Circle USDC faucet](https://faucet.circle.com/). This is required by the LitePSM mock contract which expects USDC to be present on the deployer wallet.
+
+7. Deploy, configure and verify contracts
+    ```sh
+    forge script script/SetUpAll.s.sol:SetUpAll --fork-url fuji -vv --broadcast --verify --slow
+    ```
+
+8. (optional) Commit generated output folder to record deployed contract addresses 
+
+
+## Environment Variables
+
+| Variable              | Description                                                                 |
+|-----------------------|-----------------------------------------------------------------------------|
+| `PRIVATE_KEY`         | Deployer's private key (used as admin for all contracts)                    |
+| `FOUNDRY_ROOT_CHAINID`| Chain ID for deployment                                                     |
+| `FUJI_RPC_URL`        | RPC URL for Avalanche Fuji                                                  |
+
+
+
+## Deploying to Other Chains
+
+1. Update `FOUNDRY_ROOT_CHAINID` in `.env` to use [chain id of the network](https://chainlist.org/) you're trying to deploy to. For example, to deploy to Sepolia that would be `11155111`
+2. Add new `*_RPC_URL` to the `.env` pointing to the PRC endpoint for the chain specified above, e.g:
+    ```toml
+    SEPOLIA_RPC_URL = "https://..."
+    ```
+3. Create `script/input/{CHAIN_ID}/input.json` file with relevant content
+4. Add the new verification endpoint to the [`foundry.toml`](./foundry.toml), e.g:
+     ```toml
+     sepolia = { key = "${ETHERSCAN_API_KEY}", chain = 11155111 }
+     ```
+5. Add the new `rpc_endpoints` in [`foundry.toml`](./foundry.toml), e.g.:
+     ```toml
+     sepolia = "${SEPOLIA_RPC_URL}"
+     ```
+6. Follow the "Quick start" section, while specifying the chain name under `--fork-url` (e.g. `sepolia`) when running the script, e.g.:
+     ```sh
+     forge script script/SetUpAll.s.sol:SetUpAll --fork-url ${CHAIN} -vv
+     `````
+
+### `input.json` Configuration Variables
+
+| Variable                | Description                                                                                                                        |
+|-------------------------|------------------------------------------------------------------------------------------------------------------------------------|
+| `ilk`                   | Collateral type identifier (e.g., `"ALLOCATOR_STAR_A"`)                                                                           |
+| `usdcUnitSize`          | Amount of USDC (in smallest units, e.g., wei) to use for testing (default: 10)                                                    |
+| `cctpDestinationDomain` | CCTP destination domain ID for cross-chain messaging ([see supported domains](https://developers.circle.com/cctp/supported-domains))|
+| `usdc`                  | Address of the USDC token contract on the target chain ([see contract addresses](https://developers.circle.com/stablecoins/usdc-contract-addresses)) |
+| `cctpTokenMessenger`    | Address of the CCTP Token Messenger contract on the target chain ([see EVM contracts](https://developers.circle.com/cctp/evm-smart-contracts))         |
+| `relayer`               | Address of the relayer to be used by the ALM controller                                                                           |
+| `cctpRecipient`         | Address of the CCTP transfer recipient (should correspond to the destination domain)                                               |
+
+
+
+
+### Running Tests
+
+- Run all tests:
+    ```sh
+    forge test
+    ```
+
+- Run a specific test by name:
+    ```sh
+    forge test --match-test ${YourTestName} -vvv
+    ```

foundry.toml

@@ -0,0 +1,20 @@
+[profile.default]
+src = "src"
+out = "out"
+libs = ["lib"]
+solc = "0.8.21"
+optimizer = true
+optimizer_runs = 200
+verbosity = 1
+fs_permissions = [
+    { access = "read", path = "./script/input/"}
+]
+[rpc_endpoints]
+fuji = "${FUJI_RPC_URL}"
+sepolia = "${SEPOLIA_RPC_URL}"
+[etherscan]
+# https://testnet.snowtrace.io/documentation/recipes/foundry-verification
+fuji = { key = "verifyContract", chain = 43113, url = "https://api.routescan.io/v2/network/testnet/evm/43113/etherscan" }
+sepolia = {key = "${ETHERSCAN_API_KEY}", chain = 11155111 }
+
+# See more config options https://github.com/foundry-rs/foundry/blob/master/crates/config/README.md#all-options

script/SetUpAll.s.sol

@@ -0,0 +1,68 @@
+// SPDX-License-Identifier: UNLICENSED
+pragma solidity ^0.8.21;
+
+import {Script, stdJson} from "forge-std/Script.sol";
+import {VmSafe} from "forge-std/Vm.sol";
+import {ScriptTools} from "dss-test/ScriptTools.sol";
+import {AllocatorDeploy} from "dss-allocator/deploy/AllocatorDeploy.sol";
+import {AllocatorSharedInstance, AllocatorIlkInstance} from "dss-allocator/deploy/AllocatorInstances.sol";
+import {SetUpAllLib, MockContracts, ControllerInstance} from "src/libraries/SetUpAllLib.sol";
+
+interface MainnetControllerLike {
+    function LIMIT_USDS_MINT() external returns (bytes32);
+}
+
+contract SetUpAll is Script {
+    using stdJson for string;
+
+    uint256 internal constant WAD = 10 ** 18;
+
+    function setUp() public {}
+
+    function run() public {
+        VmSafe.Wallet memory deployer = vm.createWallet(vm.envUint("PRIVATE_KEY"));
+        address admin = deployer.addr;
+
+        string memory config = ScriptTools.loadConfig("input");
+        bytes32 ilk = ScriptTools.stringToBytes32(config.readString(".ilk"));
+        address usdc = config.readAddress(".usdc");
+
+        vm.startBroadcast(deployer.privateKey);
+
+        // 1. Deploy mock contracts
+        MockContracts memory mocks = SetUpAllLib.deployMockContracts(usdc, admin);
+
+        // 2. Deploy AllocatorSystem
+        AllocatorSharedInstance memory sharedInstance = AllocatorDeploy.deployShared(deployer.addr, admin);
+        AllocatorIlkInstance memory ilkInstance =
+            AllocatorDeploy.deployIlk(deployer.addr, admin, sharedInstance.roles, ilk, address(mocks.usdsJoin));
+
+        // 3. Set up AllocatorSystem and Deploy and set up ALM controller
+        address[] memory relayers = new address[](1);
+        relayers[0] = config.readAddress(".relayer");
+
+        SetUpAllLib.AllocatorSetupParams memory params = SetUpAllLib.AllocatorSetupParams({
+            ilk: ilk,
+            ilkInstance: ilkInstance,
+            sharedInstance: sharedInstance,
+            admin: admin,
+            mocks: mocks,
+            cctp: config.readAddress(".cctpTokenMessenger"),
+            relayers: relayers
+        });
+        ControllerInstance memory controllerInstance = SetUpAllLib.setUpAllocatorAndALMController(params);
+
+        // 4. Set up rate limits for the controller
+        SetUpAllLib.setMainnetControllerRateLimits(
+            SetUpAllLib.RateLimitParams({
+                controllerInstance: controllerInstance,
+                usdcUnitSize: config.readUint(".usdcUnitSize"),
+                susds: address(mocks.susds),
+                cctpDestinationDomain: uint32(config.readUint(".cctpDestinationDomain")),
+                cctpRecipient: ScriptTools.stringToBytes32(config.readString(".cctpRecipient"))
+            })
+        );
+
+        vm.stopBroadcast();
+    }
+}

script/input/11155111/input.json

@@ -0,0 +1,9 @@
+{
+  "ilk": "ALLOCATOR_STAR_A",
+  "usdcUnitSize": 10,
+  "cctpDestinationDomain": "5",
+  "usdc": "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
+  "cctpTokenMessenger": "0x9f3B8679c73C2Fef8b59B4f3444d4e156fb70AA5",
+  "relayer": "0x5B4724De84203cB05F126a29D92065Ad08f7F34B",
+  "cctpRecipient": "6gypsJcUpikWPNdaisLCUKdbL4aeGv2Zs1bx3wLnv4iP"
+}

script/input/43113/input.json

@@ -0,0 +1,9 @@
+{
+  "ilk": "ALLOCATOR_STAR_A",
+  "usdcUnitSize": 10,
+  "cctpDestinationDomain": "5",
+  "usdc": "0x5425890298aed601595a70ab815c96711a31bc65",
+  "cctpTokenMessenger": "0xeb08f243E5d3FCFF26A9E38Ae5520A669f4019d0",
+  "relayer": "0x1234567890abcdef1234567890abcdef12345678",
+  "cctpRecipient": "6gypsJcUpikWPNdaisLCUKdbL4aeGv2Zs1bx3wLnv4iP"
+}