Repository navigation
Status: Pre-release. Live on Calibnet since 22 Oct 2026 and on Mainnet since 23 Oct 2026; tracked in the release issue.
Summary
FWSS v1.5.0 moves the FWSS proxy from the v1.4.0 UUPS monolith to the upstream ERC-8167 dispatcher, which routes each function selector to a module. The proxy addresses do not change, and the proxy serves the same FWSS methods as v1.4.0, apart from the UUPS and initializer methods. The switch happens once per network, in one delayed upgrade through FWSSDispatcherTransition. See the changelog.
Component Versions
| Component | Version | Notes |
|---|---|---|
Stack (filecoin-services) |
v1.5.0 |
Routine |
FilecoinWarmStorageService |
1.5.0 |
One-time dispatcher transition |
PDPVerifier |
3.5.0 |
Unchanged |
Rollout Status
| Network | FWSS Proxy | Announced target | Announce tx | Actual afterEpoch |
Execute tx | Status |
|---|---|---|---|---|---|---|
| Calibnet | 0x02925630df557F957f70E112bA06e50965417CA0 |
0x4699…D3F4 (FWSSDispatcherTransition) |
0x488a…2f47 |
4176439 |
0x8cd0…3a4e |
Executed 22 Oct 09:04 UTC (block 4177782); post-upgrade checks and filecoin-pin smoke test pass |
| Mainnet | 0x8408502033C418E1bbC97cE9ac48E5528F371A9f |
0x4699…D3F4 (FWSSDispatcherTransition) |
0x547f…d291 |
6482152 (about 15:56 UTC 23 Oct) |
0xdeaa…f642 |
Executed 23 Oct 16:21 UTC; post-upgrade checks pass; filecoin-pin smoke test created data set 1765 |
Action Required For Integrators
- After the transition executes on a network, read FWSS state from the FWSS proxy itself; it serves the methods previously defined in
FilecoinWarmStorageServiceStateView. Until then, keep reading through the StateView already deployed on that network. - Future FWSS upgrades are announced with
announceMigration(migration, delayEpochs)and run withmigrate(migration). Monitoring that watchesannounceUpgradePlanorupgradeToAndCallneeds updating.