This directory holds per-hardfork, per-feature migration notes for the Base precompile standard. Each entry is a focused, code-forward changelog for one scoped feature change that crosses a hardfork boundary: the API, function, event, and error deltas behind a single line item in a hardfork's release notes (for example, Cobalt's "Schedule Multiplier Updates").
This complements the product references in docs/. docs/ describes how a product
works today. changelog/ describes what changes at a hardfork and how to migrate across it.
See AGENTS.md for how to name and write a new entry.
| Ordinal | Hardfork | Status |
|---|---|---|
01 |
Beryl | Live |
02 |
Cobalt | Live |
03 |
Denim | Upcoming |
Grouped by hardfork, one collapsible section per hardfork, newest first.
Denim (upcoming) — ordinal 03
| Product(s) | Change | Affected interfaces | Entry |
|---|---|---|---|
| B20 | Reject the token itself as a credit recipient | src/interfaces/IB20.sol, src/interfaces/IB20Asset.sol |
03_Denim_B20_token_receiver |
| B20 | Transfer executor policy on every transfer path | src/interfaces/IB20.sol |
03_Denim_B20_transfer_executor_enforcement |
| BaseTime | Millisecond block timestamp predeploy (read-only) | src/interfaces/IBaseTime.sol, src/StdPredeploys.sol |
03_Denim_BaseTime_millisecond_timestamp |
| PolicyRegistry | NOT / invert policies | src/interfaces/IPolicyRegistry.sol |
03_Denim_PolicyRegistry_not_policy |
Cobalt (live) — ordinal 02
| Product(s) | Change | Affected interfaces | Entry |
|---|---|---|---|
| B20 Asset | Schedule Multiplier Updates (ERC-8056) | src/interfaces/IB20Asset.sol |
02_Cobalt_B20Asset_multiplier |
| B20 Asset, B20 Stablecoin | Seize surface + burnBlocked deprecation |
src/interfaces/IB20.sol (shared surface) → inherited by src/interfaces/IB20Asset.sol, src/interfaces/IB20Stablecoin.sol |
02_Cobalt_B20_seize |
| PolicyRegistry | Composite Policies (UNION/INTERSECT) | src/interfaces/IPolicyRegistry.sol |
02_Cobalt_PolicyRegistry_composite_policy |