feat: foundry support for missing test and deployment script

.gitignore

@@ -14,7 +14,6 @@ dist/
 downloads/
 eggs/
 .eggs/
-lib/
 lib64/
 parts/
 sdist/
@@ -145,3 +144,20 @@ node_modules
 
 # Hardhat Ignition default folder for deployments against a local node
 ignition/deployments/chain-31337
+
+# Foundry
+cache/
+out/
+
+# Ignores development broadcast logs
+!/broadcast
+/broadcast/**/dry-run/
+
+# Codecov
+lcov.info
+
+# Testing
+.gas-snapshot
+
+# vscode - audit docs
+.vscode/

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "lib/forge-std"]
+	path = lib/forge-std
+	url = https://github.com/foundry-rs/forge-std.git

Makefile

@@ -0,0 +1,9 @@
+-include .env
+
+# command: test the whole script without broadcasting the transaction into the chain to spot early errors
+deployDry: 
+		forge script foundry_scripts/InjectorInfraDeployment.s.sol \
+		--rpc-url polygon \
+		--slow \
+		-vvvv
+

foundry.toml

@@ -0,0 +1,12 @@
+[profile.default]
+src = 'contracts'
+out = "out"
+libs = ['node_modules','lib']
+test = 'foundry_test'
+solc = '0.8.25'
+
+[fmt]
+ignore = ['./contracts/**/*']
+
+[rpc_endpoints]
+polygon = "${POLYGON_RPC_KEY}"

foundry_scripts/InjectorInfraDeployment.s.sol

@@ -0,0 +1,28 @@
+// SPDX-License-Identifier: GPL-3.0-only
+pragma solidity ^0.8.25;
+
+import {Script} from "forge-std/Script.sol";
+
+import {ChildChainGaugeInjectorV2} from "../contracts/ChildChainGaugeInjectorV2.sol";
+import {ChildChainGaugeInjectorV2Factory} from "../contracts/injectorFactoryV2.sol";
+
+/// @notice Deploys the v2 infrastructure for the injectors in the following order:
+/// 1. {ChildChainGaugeInjectorV2} -> singleton/implementation purposes (helps verifying in etherscan etc)
+/// 2. {ChildChainGaugeInjectorV2Factory}
+contract InjectorInfraDeployment is Script {
+    // injector infrastructure
+    ChildChainGaugeInjectorV2 injectorImpl;
+    ChildChainGaugeInjectorV2Factory injectorFactory;
+
+ function run() public {
+    // read pk from `.env`
+    uint256 pk = vm.envUint("PRIVATE_KEY");
+    vm.startBroadcast(pk);
+
+    // 1. {ChildChainGaugeInjectorV2}
+    injectorImpl = new ChildChainGaugeInjectorV2();
+
+    // 2. {ChildChainGaugeInjectorV2Factory}
+    injectorFactory = new ChildChainGaugeInjectorV2Factory(address(injectorImpl));
+ }
+}

foundry_test/BaseFixture.sol

@@ -0,0 +1,36 @@
+// SPDX-License-Identifier: UNLICENSED
+pragma solidity ^0.8.25;
+
+import "forge-std/Test.sol";
+
+import {ChildChainGaugeInjectorV2} from "../contracts/ChildChainGaugeInjectorV2.sol";
+import {ChildChainGaugeInjectorV2Factory} from "../contracts/injectorFactoryV2.sol";
+
+contract BaseFixture is Test {
+    // injector instance
+    ChildChainGaugeInjectorV2 injector;
+
+    // factory instance
+    ChildChainGaugeInjectorV2Factory factory;
+
+    // constants
+    address constant GAUGE = 0x3Eae4a1c2E36870A006E816930d9f55DF0a72a13;
+    address constant GAUGE_2 = 0xc7e5FE004416A96Cb2C7D6440c28aE92262f7695;
+    address constant LM_MULTISIG = 0xc38c5f97B34E175FFd35407fc91a937300E33860;
+    address constant AUTHORIZER_ADAPTER = 0xAB093cd16e765b5B23D34030aaFaF026558e0A19;
+    address constant TEST_TOKEN_WHALE = 0xF977814e90dA44bFA03b6295A0616a897441aceC;
+
+    // token address constants
+    address constant USDT = 0xc2132D05D31c914a87C6611C10748AEb04B58e8F;
+    address constant USDC = 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174;
+
+    // agents
+    address constant KEEPER = address(5);
+
+    function setUp() public {
+        injector = new ChildChainGaugeInjectorV2();
+        factory = new ChildChainGaugeInjectorV2Factory(address(injector));
+
+        assert(factory.implementation() == address(injector));
+    }
+}

foundry_test/FactoryTest.t.sol

@@ -0,0 +1,45 @@
+// SPDX-License-Identifier: UNLICENSED
+pragma solidity ^0.8.25;
+
+import {BaseFixture} from "./BaseFixture.sol";
+
+import {ChildChainGaugeInjectorV2} from "../contracts/ChildChainGaugeInjectorV2.sol";
+
+contract FactoryTest is BaseFixture {
+    // dummy constants
+    uint256 MIN_WAIT_PERIOD_SECONDS = 1 days;
+    uint256 MAX_INJECTION_AMOUNT = 1_000e18;
+    address OWNER = address(56565);
+
+    event InjectorCreated(
+        address indexed injector, address[] keeperAddresses, address injectTokenAddress, address owner
+    );
+
+    ChildChainGaugeInjectorV2 injectorFactoryDeployed;
+
+    function testCreateInjector() public {
+        address[] memory keeperAddresses = new address[](1);
+        keeperAddresses[0] = KEEPER;
+
+        // check: event emitted
+        vm.expectEmit(false, true, true, true); // @note topic0 is not checkeds
+        emit InjectorCreated(address(0), keeperAddresses, USDT, OWNER);
+
+        // 1. create a new injector via factory
+        address injectorDeployed =
+            factory.createInjector(keeperAddresses, MIN_WAIT_PERIOD_SECONDS, USDT, MAX_INJECTION_AMOUNT, OWNER);
+        injectorFactoryDeployed = ChildChainGaugeInjectorV2(injectorDeployed);
+
+        // 2. asserts:
+        // 2.1. check `getDeployedInjectors` returns the correct number of injectors
+        address[] memory injectorsDeployed = factory.getDeployedInjectors();
+        assertEq(injectorsDeployed.length, 1);
+        assertEq(injectorsDeployed[0], injectorDeployed);
+
+        // 2.2. check params of the injector correctness at deployment time
+        assertEq(injectorFactoryDeployed.owner(), OWNER);
+        assertEq(injectorFactoryDeployed.getKeeperAddresses()[0], KEEPER);
+        assertEq(injectorFactoryDeployed.MinWaitPeriodSeconds(), MIN_WAIT_PERIOD_SECONDS);
+        assertEq(injectorFactoryDeployed.InjectTokenAddress(), USDT);
+    }
+}

foundry_test/UncoveredLinesTest.t.sol

@@ -0,0 +1,27 @@
+// SPDX-License-Identifier: UNLICENSED
+pragma solidity ^0.8.25;
+
+import {BaseFixture} from "./BaseFixture.sol";
+
+/// @notice Scope of the file is to test uncovered reverts, setters and getters:
+/// 1. revert: `InjectorNotDistributor`
+/// 2. revert: `ExceedsTotalInjectorProgramBudget`
+/// 3. revert: `OnlyKeepers`
+/// 4. getter: `getBalanceDelta` (cases-> deficit, exact balance and surplus)
+/// 5. getter: `getFullSchedule` (check: expected values)
+// @audit https://github.com/BalancerMaxis/ChildGaugeInjectorV2/issues/31 ?
+contract UncoveredLinesTest is BaseFixture {
+    function test_revertWhen_InjectorNotDistributor() public {}
+
+    function test_revertWhen_ExceedsTotalInjectorProgramBudget() public {}
+
+    function test_revertWhen_NotKeepers() public {}
+
+    function testGetBalance_When_Deficit() public {}
+
+    function testGetBalance_When_ExactBalance() public {}
+
+    function testGetBalance_When_Surplus() public {}
+
+    function testGetFullSchedule() public {}
+}