Filecoin's gas model has undergone two fundamental transformations, each tied to a major network upgrade. The original model, active from mainnet launch until Network Version 17 (Shark), used a simple priority-fee auction where senders specified a GasPremium to bid for block inclusion. This model lacked a dynamic base fee, making fee estimation unpredictable and creating sharp cost spikes during periods of high on-chain activity, such as the onboarding of large storage capacity.
Protocols
Gas Model and Fee Schedule Revisions
Analyzes the evolution of Filecoin's gas charging, from the pre-FVM model to the EIP-1559-style mechanism introduced with FVM, and how network upgrades have repriced on-chain operations.
introduction
GAS MODEL AND FEE SCHEDULE REVISIONS
Introduction
How Filecoin's gas accounting has evolved from a simple fee model to the EIP-1559 mechanism, directly impacting transaction costs for exchanges, wallets, and FVM smart contracts.
The first major revision arrived with the Filecoin Virtual Machine (FVM) in Network Version 18 (Hygee). Filecoin adopted an EIP-1559-style mechanism, introducing a dynamic BaseFee that adjusts with block congestion, a GasFeeCap for sender-controlled maximum total fees, and a GasPremium for miner tips. This change was not merely cosmetic; it required every exchange, wallet, and tool that constructed Filecoin transactions to update its fee estimation logic. The new model also introduced distinct gas charging for FVM execution, separating the cost of Wasm instruction metering from the existing storage proof and sector operation costs.
Subsequent network versions have continuously repriced on-chain operations. Network Version 21 (Watermelon) adjusted sector duration multipliers, altering the economic incentives for long-term storage commitments. Network Version 22 (Dragon) further refined gas charges for new sector lifecycle features like Direct Data Onboarding. For integration teams, each repricing event is a breaking change to cost models. Chainscore Labs can audit gas accounting logic in wallets and exchange withdrawal systems to ensure compatibility with the latest fee schedule and prevent costly transaction failures or overpayment.
FROM PRE-FVM TO EIP-1559-STYLE MECHANICS
Gas Model Evolution at a Glance
How Filecoin's gas charging has evolved across network upgrades, the operational impact on different actors, and what teams should verify after each change.
| Area | What changes | Who is affected | Action |
|---|---|---|---|
Pre-FVM Gas Model | Fixed gas costs per operation with no dynamic fee market. Simple but inflexible pricing for on-chain messages. | Exchanges, wallets, storage providers | Verify legacy transaction construction logic is not hardcoded to pre-FVM gas assumptions. |
FVM Launch (NV18 Hygee) | Introduction of EIP-1559-style gas mechanics with base fee, gas premium, and gas limit. Gas charging becomes dynamic and market-responsive. | All node operators, exchanges, wallets, smart contract developers | Audit gas estimation, fee cap calculation, and transaction submission logic for EIP-1559 compatibility. |
Gas Repricing (NV17 Shark) | Breaking changes to gas charge schedule for built-in actors in preparation for FVM. New Wasm runtime introduces different execution cost profiles. | Storage providers, exchange custody teams | Review and update gas estimation models for sector operations and deal-making transactions. |
Aggregation Discounts (NV13 HyperDrive) | Introduction of batch balancer and aggregation proofs drastically reducing gas costs for onboarding multiple sectors in a single message. | Storage providers, protocol economists | Model cost savings from aggregation strategies and update onboarding pipelines to use batched messages. |
Synthetic PoReps (NV21 Watermelon) | New proof type alters gas costs for sector commitment by replacing interactive challenge generation with a non-interactive proof. | Storage providers, proof system operators | Benchmark gas consumption for Synthetic PoReps vs. traditional PoReps and adjust cost models. |
Direct Data Onboarding (NV22 Dragon) | New sector lifecycle features change the gas profile of deal-making and data onboarding workflows. | Storage providers, deal-making clients, data preparers | Test gas costs for new onboarding methods on Calibration testnet and update operational budgets. |
FVM Syscall and Interface Changes | New syscalls and actor address format changes (e.g., f410/t410) can alter gas costs for smart contract interactions. | Smart contract developers, wallets, exchanges | Re-audit gas accounting in FVM contracts and verify address format handling in transaction libraries. |
technical-context
GAS ACCOUNTING EVOLUTION
Technical Mechanism: From Pre-FVM to EIP-1559
How Filecoin's gas model transformed from a simple message-based fee to a dynamic EIP-1559 mechanism, fundamentally altering transaction pricing and resource metering for the FVM era.
Before the Filecoin Virtual Machine (FVM), the network operated on a gas model where each message paid a single GasFeeCap. This pre-FVM model, while functional for simple value transfers and storage proofs, lacked the dynamic base fee and priority fee separation needed for a programmable blockchain. The introduction of the FVM with Network Version 18 (Hygee) mandated a shift to an EIP-1559-style mechanism, introducing a BaseFee that adjusts per block based on network congestion and a GasPremium for validator tips. This was not merely a parameter change but a fundamental re-architecture of how on-chain computation is priced and prioritized.
The operational impact of this transition is significant for any system constructing Filecoin transactions. Exchanges, wallets, and smart contract developers must now estimate a dynamic BaseFee and set an appropriate GasPremium to ensure timely inclusion, rather than relying on a single fee cap. The gas charging schedule was also repriced to accurately meter the cost of new FVM syscalls and Wasm execution, meaning the gas cost for a simple message send is now distinct from a complex smart contract interaction. Failure to correctly estimate these values leads to stuck transactions or excessive fee expenditure, a critical risk for high-volume withdrawal systems.
This evolution continues with subsequent network upgrades that further tune the gas schedule for specific operations, such as proof verification or new sector onboarding methods. Teams responsible for integration with Filecoin must treat the gas model as a living specification, not a static constant. Chainscore Labs can audit a team's gas estimation and fee calculation logic against the current network state, ensuring that transaction construction is both cost-efficient and resilient to base-fee volatility, preventing operational disruptions during periods of high network demand.
IMPACT ANALYSIS
Affected Systems and Stakeholders
Storage Providers
Gas schedule revisions directly alter the cost structure for core provider operations: ProveCommitSector, PreCommitSector, SubmitWindowedPoSt, and PublishStorageDeals. A repricing of these messages changes daily operational overhead and can shift the profitability threshold for onboarding new sectors or accepting deals.
Action items:
- Re-run profitability models using the new gas fee schedule immediately after the upgrade activates.
- Monitor the
ProveCommitAggregateandPreCommitSectorBatchmethods for updated batch discounts. - Adjust deal-acceptance filters if PublishStorageDeals costs increase beyond client payment coverage.
- Verify that your sealing pipeline's gas estimation logic aligns with the new execution costs to avoid out-of-gas failures.
implementation-impact
GAS MODEL AND FEE SCHEDULE REVISIONS
Implementation Impact by Upgrade
Each major gas model revision has forced a recalibration of on-chain operations, from message submission to smart contract execution. The cards below map the specific operational and integration impacts triggered by key network upgrades.
02
NV17 Shark: Pre-FVM Gas Charge Restructuring
In preparation for the FVM, the Shark upgrade restructured the actor state tree and introduced a new gas charging schedule. This was a breaking change for any off-chain system that simulated or estimated transaction costs. The repricing of syscalls and IPLD operations meant that hardcoded gas limits in exchange withdrawal scripts became invalid overnight. Custody teams had to audit and redeploy their transaction construction logic to align with the new cost model, or risk having all withdrawals fail on activation.
04
FVM Syscall and Extern Gas Repricing
Subsequent network upgrades after the FVM launch have continued to reprice specific syscalls and extern operations, such as cryptographic hashing and randomness generation. A smart contract that was gas-efficient under the initial FVM model can become economically unviable after a repricing. Development teams must implement gas simulation in their CI/CD pipelines against the calibration testnet for every network upgrade. Without this, a previously safe contract function can hit its block gas limit and revert, locking user funds.
05
Exchange Withdrawal and Custody Re-engineering
Every gas model revision requires exchanges to update their hot-wallet transaction construction and fee estimation services. The shift from a simple gas price to the EIP-1559 fields required a complete redesign of the fee API integration with Lotus nodes. Custodians must now monitor the BaseFee trend to set competitive GasPremium values, balancing confirmation time against cost. A misconfiguration can lead to mass withdrawal delays during network congestion, creating a direct customer support and reputational crisis.
06
Chainscore Labs: Gas Accounting Audit
Chainscore Labs provides a targeted review of your integration's gas accounting logic against the latest network version. We audit your fee estimation algorithms, message construction for EIP-1559 compliance, and smart contract gas assumptions to ensure they are robust against base-fee volatility and syscall repricing. For exchanges and wallets, we validate that your withdrawal batching and fee bumping strategies will not fail under mainnet load conditions, preventing costly service disruptions.
GAS MODEL AND FEE SCHEDULE REVISIONS
Integration Risk Matrix
Evaluates the operational and integration risks introduced by changes to Filecoin's gas charging, fee structure, and on-chain operation pricing across network upgrades.
| Area | What changes | Who is affected | Action |
|---|---|---|---|
Transaction Fee Estimation | Shift from pre-FVM gas model to EIP-1559-style mechanism with base fee, priority fee, and gas limit. | Exchanges, wallets, and custodians building or maintaining transaction submission logic. | Audit fee estimation algorithms against the current FVM gas charging rules. Verify that transaction construction accounts for dynamic base fees. |
Smart Contract Execution Costs | Repricing of FVM syscalls, opcodes, and execution steps via network upgrades. | DeFi protocols, liquid staking platforms, and any team deploying user-programmed actors. | Profile contract execution costs on Calibration-net before mainnet activation. Model worst-case gas consumption for key user flows. |
Storage Provider Sealing Economics | Adjustments to gas charges for ProveCommitAggregate, PreCommitSectorBatch, and other onboarding methods. | Storage providers and provider-focused tooling (e.g., sealing pipelines, profit calculators). | Recalibrate sealing cost models and aggregation strategies. Validate that aggregation still provides a cost benefit under the new fee schedule. |
Withdrawal and Transfer Operations | Repricing of message sending, method invocation, and token transfer operations. | Centralized exchanges and custody providers processing FIL deposits and withdrawals. | Test withdrawal batch sizes and fee parameters on Calibration-net. Update internal fee buffers to prevent stuck transactions during high network load. |
Deal-Making and Market Actor Flows | Changes to gas costs for PublishStorageDeals and related market actor methods. | Storage clients, deal brokers, and applications automating on-chain deal flows. | Verify deal publication costs against expected client budgets. Adjust deal aggregation logic if per-deal gas costs increase significantly. |
State Tree and Actor Interface Compatibility | Introduction of new actor types (e.g., EVM actors) and address formats (f410/t410) with distinct gas accounting. | Block explorers, indexers, and analytics platforms parsing on-chain data. | Update parsing logic to handle new actor types and their associated gas usage patterns. Confirm that gas reporting remains accurate for all transaction types. |
Message Pool and Priority Mechanics | Behavioral changes to message selection and prioritization due to EIP-1559 fee market dynamics. | Node operators and infrastructure providers running mempool-sensitive services. | Monitor mempool behavior after upgrade activation. Tune message replacement and fee bumping logic to align with the new priority fee market. |
Cross-Chain Bridge and Oracle Operations | Repricing of FVM calls made by bridges and oracles for state verification or data submission. | Bridge operators (e.g., Wormhole, Axelar) and oracle networks (e.g., Chainlink) with FVM deployments. | Audit bridge and oracle relay contracts for gas efficiency. Ensure relayers are configured with sufficient fee headroom to prevent liveness failures during fee spikes. |
OPERATIONAL READINESS FOR FEE SCHEDULE CHANGES
Gas Model Migration Checklist
A practical checklist for node operators, exchange teams, and FVM developers to validate their systems before and after a Filecoin gas model or fee schedule revision activates. Each item focuses on a specific operational risk introduced by repricing on-chain operations.
What to check: Re-run your transaction simulation and gas estimation logic against the calibration network after the upgrade candidate is deployed. Test the exact transaction types your system submits: value transfers, FVM contract interactions, and provider operations like PreCommitSector and ProveCommitSector.
Why it matters: Fee schedule revisions often reprice specific EVM opcodes or built-in actor methods. An estimation model calibrated for the old fee schedule will produce incorrect gas limits or underpriced fee caps, leading to stuck transactions.
Readiness signal: Your test suite confirms that estimated gas limits for all transaction types are within a 5% margin of the actual gas used on the calibration network, and transactions land in the mempool with the expected effective priority fee.
resource-links
FILECOIN GAS MODEL REFERENCES
Canonical Resources
Use these official Filecoin resources to verify gas-model changes, fee-schedule revisions, client behavior, and network-upgrade activation requirements before updating wallets, exchanges, storage-provider tooling, or FVM integrations.
Chains We Build On
Looking to build on a specific blockchain?
We build smart contracts, DeFi applications, wallets, tokenization platforms, and blockchain infrastructure across the major ecosystems teams choose today. That includes Ethereum, Arbitrum, Optimism, Polygon, Avalanche, Solana, Sui, Aptos, Hedera, Stellar, and NEAR, with support for additional EVM and non-EVM networks based on your product requirements.
EVM ecosystems
- Ethereum
- Arbitrum
- Optimism
- Polygon
- Avalanche
- Cronos
Non-EVM ecosystems
- Solana
- Sui
- Aptos
- Hedera
- Stellar
- NEAR
Additional ecosystems
- Polkadot
- Cosmos
- TON
- Cardano
- Algorand
- Tempo
Also available for Base, appchains, custom EVM networks, and cross-chain product architecture.
GAS MODEL FAQ
Frequently Asked Questions
Common questions from operators, builders, and exchange teams about Filecoin's gas model evolution, fee schedule revisions, and the operational impact of repriced on-chain operations.
The Hygee upgrade introduced the Filecoin Virtual Machine (FVM) and replaced the legacy gas model with an EIP-1559-style mechanism. Key changes include:
- Dynamic base fee: A network-congestion-adjusted base fee that replaces the fixed
BaseFeefrom the pre-FVM model. - Gas premium (priority fee): A tip paid to block producers for transaction inclusion priority.
- Gas limit and overestimation burn: Excess gas above the actual execution cost is burned, not refunded, to prevent block space hoarding.
- Separate execution and storage gas: Gas is metered for both on-chain computation and storage operations (e.g., sector commitments, proofs).
Why it matters: Exchanges and wallets must update fee estimation logic to use eth_maxPriorityFeePerGas and eth_feeHistory RPC methods. Hardcoded fee values from the pre-FVM era will cause transaction failures or overpayment. Teams should validate that their gas estimation accounts for the base fee volatility during high-activity periods like sector onboarding waves.
Trusted by Industry Leaders
Delivering blockchain solutions for 5+ years.
We have partnered with 50+ leading DeFi protocols, NFT ecosystems, and fintech innovators to build secure, scalable, and capital-efficient blockchain products.
Selected Partners & Clients
“I've been working with Chainscore Labs for last 3+ years, they've consistently delivered with strong ownership across multiple projects. The team is reliable and detail-oriented.”
L
Lee Erswell
CEO, Telos Foundation
how to get started
How to get started?
If you're looking for blockchain integration, ChainScore Labs has 5+ years of experience helping teams build and integrate exchanges, wallets, smart contracts, tokenization solutions, and protocol-connected products, we can help you choose the right path, integrate securely, and get to production faster. Our team consists of experienced blockchain developers and architects who can help you with your blockchain integration needs.
01
Exploration & Strategy
Define your product goals and choose the right blockchain architecture for your use case.
02
Architecture & Design
Design the smart contracts, tokenomics, and security parameters of your system.
03
Development & Integration
Build and integrate with wallets, oracles, and front-end dApps for a seamless experience.
04
Security & Launch
Comprehensive audits followed by a risk-managed mainnet deployment to protect your users.
Explore More Solutions
Discover our
blockchain development services.
We build production-grade blockchain solutions for top-tier projects across DeFi and Web3.
Book a Call
Start a build
Need a blockchain engineering team?
Send the project context and we will respond with next steps, scope questions, and a practical path to delivery.