📈Upgrade
Upgrading Payment Registry
After deploying the Payment Registry
contract, you can perform upgrades to it. As mentioned previously, this is done via a ERC1967 Proxy. So, to upgrade Payment Registry, another smart contract must be deployed, and the address stored inside the Proxy must be changed.
To do this you must:
Configure the
contracts/solidity/.env
file.ETHEREUM_RPC = RPC provider URL ETHEREUM_PRIVATE_KEY = private key of your ETH wallet ETHERSCAN_API_KEY = API Key to use etherscan to read the Ethereum blockchain STARKNET_MESSAGING_ADDRESS = Starknet Messaging address
NOTE: This is a very similar configuration than the mentioned before, but MM_ETHEREUM_WALLET_ADDRESS is not necessary
Configure the address of the proxy to be upgraded:
export PAYMENT_REGISTRY_PROXY_ADDRESS = Address of your Payment Registry's Proxy
Use the Makefile command to upgrade
Payment Registry
contractmake ethereum-upgrade
Note
You must be the owner of the contract to upgrade it.
This command will:
Rebuild
Payment Registry.sol
Deploy the new contract to the network
Utilize Foundry to upgrade the previous contract, changing the proxy's pointing address to the newly deployed contract
Upgrade Escrow
Our Escrow contract is also upgradeable, but it's method and process of upgrading is different from Payment Registry's upgrade. Starknet implemented the replace_class
syscall, allowing a contract to update its source code by replacing its class hash once deployed. So, to upgrade Escrow, a new class hash must be declared, and the contract's class hash must be replaced.
We will perform the upgrade using the starkli
tool, so the same configuration used for deployment is necessary:
Configure
contracts/cairo/.env
file.STARKNET_ACCOUNT = Path of your starknet account STARKNET_KEYSTORE = Path of your starknet keystore
Configure the address of the contract to be upgraded:
export ESCROW_CONTRACT_ADDRESS = Address of your Escrow smart contract
Use the Makefile command to upgrade
Escrow
contractmake starknet-upgrade
Note
You must be the owner of the contract to upgrade it.
This command will:
rebuild
Escrow.cairo
declare it on Starknet
Call the external upgrade() function, from OpenZeppellin's Upgradeable implementation, with the new class hash
Upgrade ZKSync
[comment]: TODO, add when ZKSync is Upgradeable
Last updated