Skip to content

chore: add core contract changelog #709

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
shaspitz merged 1 commit into from
Jul 15, 2025
Merged

chore: add core contract changelog #709

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 26 additions & 3 deletions contracts/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,11 +1,14 @@
# Contracts

## Mainnet Contract Changelog

This changelog tracks deployments of **Ethereum mainnet** contracts. This changelog is only valid from the `main` branch.
## Changelogs

* Add a row to **Current Deployments** when a contract is first deployed from a release branch and tagged commit. Note the proxy address, release branch, and initial tag should not change.
* After any on-chain upgrade, append a row to **Upgrade History**. The `Upgrade Tag` contains the most up-to-date source code for that contract.
* If an existing contract is ever redeployed (ex. because its required changes are not possible via contract upgrade), simply replace the appropriate row in **Current Deployments** with the new proxy address, release branch, and initial tag.

## Mainnet (L1) Contract Changelog

This changelog tracks deployments of **Ethereum mainnet** contracts. This changelog is only valid from the `main` branch.

### Current Deployments

Expand All @@ -23,6 +26,26 @@ This changelog tracks deployments of **Ethereum mainnet** contracts. This change
|-----------------------------|---------------------|-----------------------|-------------------|
| Mar-12-2025 03:33:35 AM UTC | MevCommitMiddleware | MevCommitMiddlewareV2 | v1.1.0-middleware |

## Core Contract Changelog

This changelog tracks "core" contract deployments on the mev-commit chain. This changelog is only valid from the `main` branch.

### Current Deployments

| Contract | Proxy Address | Release Branch | Initial Tag |
|-----------------------|----------------------------------------------|---------------------|--------------------------|
| BidderRegistry | `0xC973D09e51A20C9Ab0214c439e4B34Dbac52AD67` | `release/v1.1.x` | `v1.1.0` |
| ProviderRegistry | `0xb772Add4718E5BD6Fe57Fb486A6f7f008E52167E` | `release/v1.1.x` | `v1.1.0` |
| PreconfManager | `0x3761bF3932cD22d684A7485002E1424c3aCCD69c` | `release/v1.1.x` | `v1.1.0` |
| Oracle | `0xa1aaCA1e4583dB498D47f3D5901f2B2EB49Bd8f6` | `release/v1.1.x` | `v1.1.0` |
| BlockTracker | `0x0DA2a367C51f2a34465ACd6AE5d8A48385e9cB03` | `release/v1.1.x` | `v1.1.0` |

### Upgrade History

| Timestamp (UTC) | Contract | New Impl Version | Upgrade Tag |
|-----------------------------|---------------------|-----------------------|-------------------|
| April 7th 2025 | Oracle | OracleV2 | No tag, see commit `bc4ebddd70f23d58ba6f9b2e8701e7f45d89cf82` in `release/v1.1.x`. |

## L1 Deployer CLI

> **After completing any L1 deployment, immediately record it in the “Current Deployments” table above.**
Expand Down
Loading