Core Contracts Release 12

This is a routinary core contract release following the release process. This release prepares the contracts to follow the specs for the upcoming Celo L2 hardfork.

Includes migrating away from the current Celo precompiles, implementing the staking system fully in Solidity. The contracts are designed to automatically change behaviour after the L2 transition, so impact to the end user and developers is expected to be minimum. In the upcoming release, after the transition, this behaviour will be removed and contracts will always assume they are working on an L2.

This release also deprecated GoldToken and LockedGold registry entries, in favour of CeloToken and LockedCelo, created in CGP-155.

Deprecated contracts:

1. GasPriceMinimum.sol: 1.2.0.1 => 1.2.1.0
2. FeeCurrencyWhitelist.sol: 1.1.1.0 => 1.1.2.0
3. BlockchainParameters.sol: 1.3.0.0 => 1.3.1.0
4. DoubleSigningSlasher.sol: 1.1.1.0 => 1.1.1.1
5. Random.sol: 1.1.1.0 => (1.1.2.0)

New contracts:

1. CeloUnreleasedTreasury.sol: N/A => 1.1.0.0
2. EpochManager.sol: N/A => 1.1.0.0
3. EpochManagerEnabler.sol: N/A => 1.1.0.0
4. FeeCurrencyDirectory.sol: N/A => 1.1.0.0
5. MentoFeeCurrencyAdapter.sol: N/A => 1.1.0.0
6. ScoreManager.sol: N/A => 1.1.0.0

Updated contracts:

1. Validators.sol: 1.2.0.5 => 1.3.0.0
2. Accounts.sol: (1.1.4.1 => 1.1.2.4
3. FeeHandler.sol: 1.1.0.0 => 1.2.0.0
4. GoldToken.sol: 1.1.2.0 => 1.1.3.0
5. MentoFeeHandlerSeller.sol: 1.1.0.0 => 1.1.1.0
6. UniswapFeeHandlerSeller.sol: 1.1.0.0 => 2.0.0.0
7. DowntimeSlasher.sol: 2.0.0.0 => 2.0.0.1
8. . Election.sol: 1.1.3.0 => 1.1.4.0
9. EpochRewards.sol: 1.1.1.0 => 1.1.2.0
10. Governance.sol: 1.4.1.0 => 1.4.2.0
11. GovernanceSlasher.sol: 1.1.0.0 => 1.1.1.0
12. LockedGold.sol: 1.1.4.0 => 1.1.5.0
13. Attestations.sol: 1.2.0.0 => 1.3.0.0
14. SortedOracles.sol: 1.1.3.0 => 1.1.4.0

Audit reports:

1. Celo L2 - Trail of Bits.pdf
2. Celo Audit Competition Summary Report.pdf

Core Contracts Release 11

Release Notes:

This is the eleventh release of the Celo Core Contracts. It follows the standard release process per the docs.

Audit:

Audit: cLabs Equivalent Tokens Review - Summary Report.pdf

Key updates in this release:

1. Sorted Oracles update from Mento and Adding equivalent tokens: #10891
2. Audit fix #10931
3. FeeCurrency Adapter: #10907
4. Audit fix #10940
5. Fix to calculate unlockable Celo: #10731
6. Gas Price Minimum can never be zero for any token: #10909
7. Add logic for getTotalPendingWithdrawalsCount: #10488
8. Add Hotfix hash calculator: #10697
9. Miscellaneous fixes #10945

Specific Version Updates:

• FeeCurrencyAdaptor: N/A => 1.1.0.0
• GasPriceMinimum: 1.2.0.0 => 1.2.0.1
• Governance: 1.4.0.0=>1.4.1.0`
• LockedGold: 1.1.3.0 => 1.1.4.0
• SortedOracles: 1.1.2.3 => 1.1.3.0

Note: FeeCurrencyAdaptor is not a core contract, and just implemented as a reference implementation.

Core Contracts Release 11

Release Notes:

This is the eleventh release of the Celo Core Contracts. It follows the standard release process per the docs.

Audit:

Security audit currently underway.

Key updates in this release:

1. Sorted Oracles update from Mento and Adding equivalent tokens: #10891
2. FeeCurrency Adapter: #10907
3. Fix to calculate unlockable Celo: #10731
4. Gas Price Minimum can never be zero for any token: #10909
5. Add logic for getTotalPendingWithdrawalsCount: #10488
6. Add Hotfix hash calculator: #10697

Specific Version Updates:

FeeCurrencyAdaptor: N/A => 1.1.0.0
GasPriceMinimum: 1.2.0.0 => 1.2.0.1
Governance: 1.4.0.0 => 1.4.1.0
LockedGold: 1.1.2.2 => 1.1.3.0
SortedOracles: 1.1.2.3 => 1.1.3.0

@celo/[email protected]

Patch Changes

• 041fc92: Turn back on parallel registry updating for governance proposal views
• 041fc92: Add textual feedback about parsing proposal
• 041fc92: Fix Proposal View Regression when it includes proxy updates

@celo/[email protected]

Patch Changes

• Updated dependencies [9ab9d00]
• Updated dependencies [1c9c844]
• Updated dependencies [9ab9d00]
  • @celo/[email protected]

@celo/[email protected]

Major Changes

• 1c9c844: Remove contracts from lib/generated. now available in @celo/abis package at @celo/abis/web3

@celo/[email protected]

Patch Changes

• 041fc92: Add textual feedback about parsing proposal
• Updated dependencies [041fc92]
• Updated dependencies [041fc92]
• Updated dependencies [041fc92]
  • @celo/[email protected]

@celo/[email protected]

Breaking changes

As well as being the ABIS that correspond to celo core contracts release 10, there are a few breaking changes from release 9

• ethers types have been removed completely
• the javascript files previously in the types/web3 folder are no longer under types ie @celo/abis/types/web3/Accounts vs @celo/abis/web3/Accounts
• the javascript files previously in the types/wagmi folder are now top level ie @celo/abis/Accounts vs @celo/abis/types/wagmi/Accounts

non breaking changes

• both esm and cjs imports are supported
• ts/js abis can be imported from index eg import { accountsABI } from "@celo/abis" however the json abis web3 specific functions/types must be imported direct from their file paths.

npm

@celo/abis + @celo/contracts 10 beta series

The beta series for @celo/[email protected] + @celo/[email protected] should be thought of as developer testing of the release process and not consumed in any packages.

@celo/[email protected]

Patch Changes

• 88e3788: add notice that LockedGold.getTotalPendingWithdrawalsCount is not yet available on all networks
• 70f600b: Mark MetaTransactionWallet and MetaTransactionWalletDeployer as deprecated, including functions to get them and their wrappers. see #10766
• 2985f9e: Refactor Accounts.getParsedSignatureOfAddress