mirror
/
openzeppelin-contracts
mirror of https://github.com/OpenZeppelin/openzeppelin-contracts
2
1
Fork 1
Code Issues Releases Wiki Activity
mirror of openzeppelin-contracts
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
3725 Commits
56 Branches
139 Tags
72 MiB
 
 
 
 
 
Tag: Branch: Tree: 2562c11f25
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '2562c11f25'
${ noResults }
openzeppelin-contracts/scripts/upgradeable
History
Ernesto García 11dc5e3809
Expose an initializer function for non-abstract contracts in their upgradeable versions (#5008) 		10 months ago
..
README.md
…
patch-apply.sh
…
patch-save.sh
…
transpile-onto.sh Update remappings.txt for upgradeable contracts and set up submodule (#4639) 1 year ago
transpile.sh Expose an initializer function for non-abstract contracts in their upgradeable versions (#5008) 10 months ago
upgradeable.patch Add ability to create clones with initial `value` in Clones.sol (#4936) 11 months ago

README.md

The upgradeable variant of OpenZeppelin Contracts is automatically generated from the original Solidity code. We call this process "transpilation" and it is implemented by our Upgradeability Transpiler.

When the master branch or release-v* branches are updated, the code is transpiled and pushed to OpenZeppelin/openzeppelin-contracts-upgradeable by the upgradeable.yml workflow.

transpile.sh

Applies patches and invokes the transpiler with the command line flags we need for our requirements (for example, excluding certain files).

transpile-onto.sh

bash scripts/upgradeable/transpile-onto.sh <target> [<base>]

Transpiles the contents of the current git branch and commits the result as a new commit on branch <target>. If branch <target> doesn't exist, it will copy the commit history of [<base>] (this is used in GitHub Actions, but is usually not necessary locally).

patch-apply.sh & patch-save.sh

Some of the upgradeable contract variants require ad-hoc changes that are not implemented by the transpiler. These changes are implemented by patches stored in upgradeable.patch in this directory. patch-apply.sh applies these patches.

If the patches fail to apply due to changes in the repo, the conflicts have to be resolved manually. Once fixed, patch-save.sh will take the changes staged in Git and update upgradeable.patch to match.