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

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”

• 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.

• 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.

• 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 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.