Solidity Proxy Creator (sol-proxy)

A tool (currently in alpha) for turning any Solidity contract into a proxy contract, per EIP 1822.

This tool wouldn't have been possible without Frederico Bond, creator of Solidity Parser ANTLR and Solidity Inspector (soli). Fun fact: many other projects rely on Solidity Parser, including Solidity-coverage, OpenZeppelin CLI, Prettier Plugin for Solidity, and many more smart contract visualization/inspection utilities... that's pretty neat!

Getting Started

Install it via npm:

npm install -g sol-proxy

Usage

1. Create Storage.sol

The create command generates Storage.sol which contains all the contract variables.

sol-proxy create contracts/MyContract.sol

note: if you've already run this command, you will need to remove the Storage.sol import and the Storage inheritance in your contract. You will add this back at the end.

2. Variable Ordering

⚠️ Ensure the variables have not been re-ordered from a previously deployed version of the contract. Failure to maintain variable ordering can permanently corrupt your deployed contract.

Simply adjust the variables until they are in the correct order, with any new variables added at the end.

👀 Get a few friends to double-check this.

3. Cleanup

Remove duplicate pragma declarations. Add necessary import statements. All structs should be removed from Storage.sol . If any of these structs are needed in Storage.sol , they must also be removed from their original contract and placed into a separate Structs.sol . If needed, import Structs.sol into Storage.sol and other dependent contracts. Add an import and inheritance for Storage.sol and Proxiable.sol to your contract.

pragma solidity ^0.5.8; import {Storage} from "./Storage.sol"; import {Proxiable} from "./Proxiable.sol"; contract MyToken is Storage, Proxiable { //...

Refer to EIP 1822 to get a better understanding of using this Proxy.

License

GPL-3.0