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: https://github.com/celo-org/celo-monorepo/pull/10891
2. Audit fix #10931
3. FeeCurrency Adapter: https://github.com/celo-org/celo-monorepo/pull/10907
4. Audit fix #10940
5. Fix to calculate unlockable Celo: https://github.com/celo-org/celo-monorepo/pull/10731
6. Gas Price Minimum can never be zero for any token: https://github.com/celo-org/celo-monorepo/pull/10909
7. Add logic for getTotalPendingWithdrawalsCount: https://github.com/celo-org/celo-monorepo/pull/10488
8. Add Hotfix hash calculator: https://github.com/celo-org/celo-monorepo/pull/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.2.2 => 1.1.3.0
• SortedOracles: 1.1.2.3 => 1.1.3.0

Note: FeeCurrencyAdaptor is not a core contract, and just implemented as a reference implementation.
Audit: cLabs Equivalent Tokens Review - Summary Report.pdf

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: https://github.com/celo-org/celo-monorepo/pull/10891
2. FeeCurrency Adapter: https://github.com/celo-org/celo-monorepo/pull/10907
3. Fix to calculate unlockable Celo: https://github.com/celo-org/celo-monorepo/pull/10731
4. Gas Price Minimum can never be zero for any token https://github.com/celo-org/celo-monorepo/pull/10909
5. Add logic for getTotalPendingWithdrawalsCount https://github.com/celo-org/celo-monorepo/pull/10488
6. Add Hotfix hash calculator: https://github.com/celo-org/celo-monorepo/pull/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

Breaking changes

Aas 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

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.

patch changes

• 53bbd4958: Note celo sdk packages will no longer be fix bumped (ie will not share the same version always) and will now use ^range when depending on each other
• d48c68afc: Calls to getContractMappingFromSourcify() are now memoized in the same structure (this.addressMapping) as getContractMappingFromCore, getContractMappingWithSelector now runs in parallel

5.1.0

Minor Changes

• 53bbd4958: Add cip64 support for feeCurrency Transactions. Note this is the replacement for the deprecated cip42 and legacy tx types https://github.com/celo-org/celo-proposals/blob/master/CIPs/cip/0064.md

Patch

• 53bbd4958: Note celo sdk packages will no longer be fix bumped (ie will not share the same version always) and will now use ^range when depending on each other

• d48c68afc: Add memoization to Connection.chainId() funciton. this is reset when setProvider is called.

• d48c68afc: parallelize async calls in Governance Wrapper

@celo/wallet-ledger

Fixes issue where uses trying to sign with ledger where unable to by forcing use of celo legacy tx type as this is all celo ledger app supports for now see #10487

Fixes

• once again signing with ledgers work

Breaking changes

This release if the celocli bumps node support from node 14 to node 18

other changes / fixes

• gasCurrency param is now respected when sending tokens (previously would always use pay fee in same token sending (this is still the default behavior) https://github.com/celo-org/celo-monorepo/pull/10483
• Fix CLI returning zero required votes on proposals with no tx https://github.com/celo-org/celo-monorepo/pull/10477

dep changes

• use contractkit v5 (this brings eip 1559 / cip 42 support under the hood)
• bump humanize-duration to latest version
• remove unused deps, @celo/bls12377js, bip32, bip39

Release Notes:

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

Audit:

Security audit by Hexens attached is attached to this release.

Key updates in this release:

General:

1. Add solidity wrappers for CIP-20/30/31 precompiles #10240
2. Update Lock Gold Error Message "Not Account" #10315
3. Update upvode function #10268
4. Fix dequeueProposalIfReady() for expired proposals. #10324
5. Remove TransferWhitelist contract #10318
6. Proposal info exposed #10330
7. Interfaces solidity version update #10355
8. Governance vote delegation #10325

Relevant for Gingerbread Hardfork:
10. Ultra Green Celo Implementation #10227
11. GasPriceMinimum update #10437

Specific Version Updates:

• Accounts: 1.1.4.0 => 1.1.4.1
• BlockchainParameters: 1.2.0.0 => 1.3.0.0
• FeeCurrencyWhitelist: 1.1.0.0 => 1.1.1.0
• FeeHandler: N/A => 1.1.0.0
• GasPriceMinimum: 1.1.1.0 => 1.2.0.0
• Governance: 1.3.0.0 => 1.4.0.0
• LockedGold: 1.1.2.1 => 1.1.3.0
• MentoFeeHandlerSeller: N/A => 1.1.0.0
• UniswapFeeHandler: N/A => 1.1.0.0
• Validators: 1.2.0.4 => 1.2.0.5

Misc performance improvements. See #10513

This patch release fixes an issue we saw shortly after releasing v3.0.0 where the Signer incorrectly treats a closed socket from the Combiner as a timeout and attempts to respond with a 500 status code. When the Combiner receives enough responses from Signers to respond to the user, it will abort outstanding requests with an AbortSignal. In v3.0.0, the Signer timeout logic was upgraded to listen for 'abort' events and treat them as timeouts. Because the Signer was unable to distinguish between 'abort' events caused by timeouts and ones caused by the Combiner, it appeared to be timing out and returning 500s frequently.

In this release, we've changed back the Signer's timeout logic to rely on setTimeout and added a new connectionClosedHandler to catch closed socket events

• This upgrade features significant performance improvements to reduce latency and increase throughput.
• Full node queries will now be cached, so we've removed blockNumber from the SignMessageResponse type.
• We've also fully deprecated the legacy endpoints and deleted the legacy rate limiting mechanism from the code

See https://github.com/celo-org/celo-monorepo/pull/10462

Updates to package versions necessary for the release of v3.0.0 of the @celo/phone-number-privacy-common package and package version upgrades to support node 18. The @celo/phone-number-privacy-common package has been upgraded with miscellaneous small changes to support the ODIS 3.0.0 release - the most significant of which is the removal of blockNumber from the SignMessageResponse type.

Description

This Beta Release for 5.0 series Adds Support for and favors using eip1559 (when no fee currency selected) and cip42 (when it is) legacy transaction serialization will only be used if gasPrice is explicitly set.

Note on versions 5.0.0 and 5.0.1

These version have a bug and do not work use 5.0.2 or higher

Other changes

TopLine Changes

• Add support for CIP42 and EIP1559 Transactions
• Prefer EIP1559 if no feeCurrency and CIP42 if using feeCurrency, Old CeloLegacy transations still supported (set the gasPrice explicitly) but discouraged
  upgrade Web3 dependency

@celo/connect

• gasPrice is no longer an option on config. setting 0 (or any empty value) for gasPrice in transaction will result in maxFeePerGas and maxPriorityFee per gas being set on the transaction

• likewise gasPrice is no longer settable on the connection itself

• (note that the gasPrice function for fetching price from node is NOT affected)

• replace connection.fillGasPrice with connection.setFeeMarketGas

• add inputAccessListFormatter

• remove deprecated setGasPriceForCurrency

• EncodedTransaction Type now supports CIp42 and EIP1559 transactions

• inputCeloTxFormater now returns type FormattedCeloTx although apart from support for cip42 and eip1559 tx the data returned hasnt changed

• numberToHex, ensureLeading0x, inputAddressFormatter now are typed to return 0x{string} instead of just string

*added parseAccessList and inputAccessListFormatter for converting accessList from json to array of array and back

• RLPEncodedTx now types its transaction field as FormattedTransaction this is more accurate than the CeloTX type it previously had

@celo/contrackit

• removed gasPriceSuggestionMultiplier == gas price from rpc no longer multipled by 5

• remove kit.fillGasPrice

• remove updateGasPriceInConnectionLayer

• remove kit.gasPrice

@celo/wallet-base

• extractSignature now throws if the length of provided tx is not correct

• extractSignature was incorrectly typed to return Buffers for r and s values

• ensureLeading0x now types output to be 0x{string}

npm

https://www.npmjs.com/package/@celo/contractkit/v/5.0.0-beta.1

• governance:show --proposalID {id} now properly considers constitutional thresholds while calculating proposal support.

• adds getSupportWithConstitionThreshold method to governance wrapper
• uses generated contracts for core release 9
• some minor deep dep updates

Release Notes:

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

Audits:

Verilog Core Contracts Release 9: Audit

Key updates in this release:

1. dequeueProposalsIfReady should not update the dequeue timestamp if there were not proposals to dequeue #9739

2. Allow partial/multiple Governance votes #9911

Previously, the voting system for proposals limited users to voting with all of their owned locked gold. However, a recent change has removed this limitation, giving users the flexibility to choose the amount of locked CELO they wish to use when voting. With this change, users can allocate a portion of their locked CELO to vote either for or against proposals or possibly abstain. This allows for greater control over decision-making and can help users to more accurately reflect their preferences.

3. getWithdrawableAmount in ReleaseGold.sol #9942

4. Parallelize approval and referendum governance stages #9779

Standalone approval stage was removed and now it is possible to approve proposals in referendum stage when proposal can already be voted on.

5. Make Attestations.sol read-only #10142

6. Mark successful governance proposals with no transactions as executed #9798

7. Allow election voting for more than 10 groups #9998

Voting for more than 10 groups was not allowed due to the high cost of calculating the total votes per account across all groups. However, this PR proposes an opt-in feature that permits voting for more than 10 groups. If this feature is enabled, account holders will need to update the vote count for each group they vote for on a daily basis.

Specific Version Updates:

@celo/contractkit

• removed Attestations utils
• removed methods from Attestations Wrapper
• removed ASV1 helpers

@celo/wallet-gcp (New Package)

• adds support for google HSM wallet

@celo/utils

• added support for EIP712 to signed typed data utils

@celo/explorer

• added support for non core contract proxy decoding for CGPs

@celo/dappkit

• this package has been removed

• While viewing governance proposals it is now possible to decode non core contracts which use proxies.

Breaking

• Remove ASv1-specific commands from the CLI (#10179) 0d57cefad by @eelanagaraj

note 1.8.1-beta has the same code as 2.0 (upgrade to major release after realizing there was a breaking page)