Filecoin Network v27 “Golden Week” Upgrade: Here's What to Expect

2 min read
News
Filecoin Network v27 “Golden Week” Upgrade: Here's What to Expect

Get ready for Filecoin’s next step forward: NV27 “Golden Week”. Going live Sept 24, it strengthens miner security, streamlines sector operations, and improves developer tools. Upgrade to Lotus v1.34.0 today.


Mainnet Upgrade : September 24, 2025
Lotus / Miner version: v1.34.0 — mandatory upgrade for all node and storage provider operators. Full Upgrade information can be found at GitHub repository.

On September 24, 2025 at Epoch 5,348,280 (≈ 23:00 UTC), Filecoin will undergo its next major network upgrade — Network v27, code-named “Golden Week”

Highlights of NV27

  • Better smart contract support (FIP-0105, FIP-0109_)_New cryptographic precompiles (BLS12-381, EIP-2537) boost FEVM performance.Smart contract notifications enable Direct Data Onboarding (DDO).
  • Safer miner creation (FIP-0077_)_A deposit is now required when setting up a new miner, improving network security.
  • Simpler sector operations (FIP-0103, FIP-0106, FIP-0101_)_Several old methods (ExtendSectorExpiration, ProveReplicaUpdates, ProveCommitAggregate) are being retired, streamlining sector management.
  • Finality improvements (F3) (FRC-0108_)_Snapshots now include finality certificates and APIs are F3-aware, making chain data more consistent and reducing catch-up times.

⚠ Upgrade Guidance

  • Mandatory upgrade: All Lotus node operators and Storage Providers must upgrade to v1.34.x before the upgrade epoch (GitHub).
  • Migration: Most nodes will migrate quickly (<1 minute on modern hardware). Slower CPUs/disks may take longer. Archival or RPC nodes should expect additional downtime.
  • Snapshot strategy: If you don’t need full chain history, prune and sync from a recent snapshot before the upgrade. Archival/RPC providers should plan for a full migration without pruning.
  • Developers: F3 finality behavior in /v1 Ethereum API calls has changed. Apps relying on legacy semantics can temporarily disable it with LOTUS_ETH_V1_DISABLE_F3_FINALITY_RESOLUTION=1 — but this option will be removed in the future.

✅ What to Do Next

  • Node Operators & Storage Providers: Make sure to upgrade Lotus / miner to v1.34.0 ahead of September 24. Decide whether you’ll prune or fully sync from scratch.
  • Developers / FEVM users: Review the new F3 finality logic, snapshot format, and smart contract changes. If your dApps rely on historical randomness, miner-creation logic, or Ethereum calls, test them under the new API behavior.
  • Explorer, tooling, and RPC providers: Ensure your indexing and sync infrastructure are prepared for the new finality model, snapshot format, and API behavior.
  • General Filecoin community: Expect a smoother, more resilient network post-upgrade. The new snapshot formats, finality improvements, and contract-level tweaks set the stage for better performance, developer tooling, and faster node bootstrapping in the future.

The Road Forward

The Golden Week (NV27) upgrade is a key step forward for Filecoin: strengthens finality, enhances FEVM, and makes Filecoin faster to run. This upgrade lays the groundwork for faster growth and stronger applications across the ecosystem.