forge-deploy

A cli and associated contracts to keep track of deployments by name and reuse them in solidity.

It tries to keep compatibility with hardhat-deploy as far as possible (work in progress).

Features

• generate type-safe deployment function for forge contracts. no need to pass in string of text and hope the abi encoded args are in the correct order.
• save deployments in json file (based on hardhat-deploy schema)

How to use

1. install the cli tool cargo install forge-deplpoy

2. add the forge package

3. add a script

```solidity // SPDX-License-Identifier: MIT pragma solidity ^0.8.13;

import "forge-deploy/DeployScript.sol"; import "generated/deployer/DeployerFunctions.g.sol";

contract DeployGreetingsRegistry is DeployScript { using DeployerFunctions for Deployer;

// you can also use the run function and this way pass params to your script
// if so you need to ensure to return with the new deployments via:
// `return _deployer.newDeployments();`
// example:
// function run() override public returns (DeployerDeployment[] memory newDeployments) {
//  // .... _deployer.deploy...
//  return _deployer.newDeployments();
// }
// this is how forge-deploy keep track of deployment names 
// and how the forge-deploy sync command can generate the deployments files
//

function deploy() override internal {

    // you can check for existence
    if (_deployer.has("MyRegistry")){
        console.log("MyRegistry already deployed");
        console.log(_deployer.getAddress("MyRegistry"));
    } else {
        console.log("No MyRegistry deployed yet");
    }

    // we can deploy a new contract and name it
    _deployer.deploy_GreetingsRegistry(
        "MyRegistry",
        vm.toString(address(existing)),
        DeployOptions({deterministic: 0, proxyOnTag: "", proxyOwner: address(0)})
    );

    // if you need to override an existing contract
    // you first ignore it
    _deployer.ignoreDeployment("MyRegistry");
    // and deploy a new one
    // the deployment file will only be overriden after broadcast
    _deployer.deploy_GreetingsRegistry(
        "MyRegistry",
        vm.toString(address(existing)),
        DeployOptions({deterministic: 0, proxyOnTag: "", proxyOwner: address(0)})
    );

    // also support a basic EIP173 Proxy similar to hardhat-deploy (not fully featured)
    _deployer.deploy_GreetingsRegistry(
        "ProxiedRegistry",
        vm.toString(address(existing)),
        DeployOptions({deterministic: 0, proxyOnTag: "local", proxyOwner: vm.envAddress("DEPLOYER")})
    );

    _deployer.deploy_GreetingsRegistry(
        "ProxiedRegistry",
        vm.toString(address(existing)),
        DeployOptions({deterministic: 0, proxyOnTag: "local", proxyOwner: vm.envAddress("DEPLOYER")})
    );

    _deployer.deploy_GreetingsRegistry2(
        "ProxiedRegistry",
        vm.toString(address(existing)),
        DeployOptions({deterministic: 0, proxyOnTag: "local", proxyOwner: vm.envAddress("DEPLOYER")})
    );
}

} ```