Network Upgrades and Forks
Documents mandatory network upgrades—such as Apricot, Banff, Cortina, Durango, and Etna—that alter consensus rules, introduce new state transitions, or activate major features like Warp Messaging and dynamic fees. Operators, exchanges, and validator teams use this group to plan upgrade readiness, assess backward compatibility, and understand activation mechanisms across the Primary Network and Subnets.
Apricot Phase Upgrades
Canonical reference for the multi-phase Apricot upgrade series that shaped the post-launch Primary Network. Details each phase's activation mechanism, the introduction of dynamic fees on the C-Chain, changes to P-Chain staking rules, and the sunsetting of the X-Chain's role. Operators and exchanges need this page to understand the foundational evolution of transaction processing and fee markets.
Banff Upgrade and Elastic Subnets
Impact analysis of the Banff upgrade as the enabler of the Elastic Subnet model. Explains the introduction of the Subnet-EVM, the shift from fixed-validator Subnets to permissionless validator management via P-Chain staking, and how this fundamentally changed Subnet economics and security. Subnet operators and protocol architects need this page to assess the transition from permissioned to permissionless validator models.
Cortina Upgrade (X/P-Chain Migration)
Operational guide for the Cortina upgrade that migrated X-Chain transaction processing to the P-Chain. Covers the technical rationale for deprecating the DAG, the new atomic transaction model, the impact on exchange deposit and withdrawal flows, and the required steps for API consumers. Exchanges and wallet teams need this page to update their integration logic and avoid service disruption.
Durango Upgrade and ACP-30
Chronicles the Durango upgrade as the activation point for native Avalanche Warp Messaging (AWM) on the P-Chain. Explains how ACP-30 introduced a standard for cross-subnet communication, the new P-Chain transaction types, and the implications for Subnet interoperability without a trusted relayer. Bridge operators and cross-chain application developers need this page to plan their AWM integration strategy.
Etna Upgrade (ACP-77)
Deep dive into the Etna upgrade that transforms Subnet architecture into a sovereign L1 model. Details the new validator staking and rewards framework managed entirely by the L1, the separation from the P-Chain's validator set, and the operational playbook for converting an existing Subnet to an Etna-compatible L1. Existing Subnet operators need this page to plan their migration and assess new economic security models.
Precompiled Contract Activations
Tracks the introduction of stateful and stateless precompiles on the C-Chain and Subnet-EVM across different upgrades. Covers precompiles for RANDOM, BLS12-381, and others, explaining how they are gated by network upgrades and how developers can detect their availability. Smart contract developers and security auditors need this page to verify precompile support and avoid deployment failures.
AvalancheGo Upgrade Compatibility Matrix
Practical reference table mapping AvalancheGo client versions to mandatory network upgrades. Shows which client versions are compatible with Apricot, Banff, Cortina, Durango, and Etna, highlighting hard cut-off points where outdated nodes will lose consensus or fail to sync. Node operators and infrastructure providers need this page to plan upgrade timelines and avoid forced downtime.
Primary Network vs. Subnet Activation Logic
Explains the distinct activation mechanisms for upgrades on the Primary Network (C, P, X-Chains) versus permissionless and permissioned Subnets. Covers block-height-based activations, the role of upgradeBytes in Subnet-EVM genesis configs, and how Subnet operators schedule their own coordinated upgrades. Subnet operators and DevOps teams need this page to understand their upgrade coordination responsibilities.
Validator Upgrade Playbook
Step-by-step operational guide for validators facing a mandatory network upgrade. Covers the timeline from announcement to activation, including monitoring AvalancheGo releases, backing up the database, testing on Fuji Testnet, and the exact procedure for a zero-downtime upgrade. Validator teams and staking providers need this page to maintain uptime and avoid slashing during upgrades.
Exchange and Custodian Upgrade Checklist
Targeted checklist for centralized exchanges and custodians facing a network upgrade. Focuses on monitoring for new transaction types, parsing updated ABI and APIs for staking and Warp Messaging, validating new address formats, and running a parallel non-validating node to test indexing logic before mainnet activation. Exchange operations teams need this page to prevent deposit and withdrawal outages.
Fuji Testnet Upgrade Coordination
Documents the role of the Fuji Testnet as the staging ground for all mainnet upgrades. Explains how developers and validators can participate in Fuji activations, report bugs, and use the testnet to simulate complex multi-subnet interactions before they go live on mainnet. Development teams and QA engineers need this page to integrate pre-upgrade testing into their release cycles.
Backward Compatibility Assessment
Analyzes the backward compatibility guarantees and breaking changes introduced by each major upgrade. Covers API deprecations such as X-Chain endpoints, changes to RPC response formats, and the deprecation of legacy transaction types. Integrators and API consumers need this page to assess the impact on their systems and plan necessary code changes.
Database Migration and Pruning Events
Addresses the operational reality of state-schema changes that accompany some upgrades. Provides guidance on the expected time for database migrations, how to use the pruning-enabled flag, and strategies for managing disk space during upgrades that alter the state trie or index structures. Node operators need this page to provision adequate storage and schedule maintenance windows.
Monitoring Network Upgrade Activation
Guide for operators on how to observe an upgrade activation in real-time. Details the specific logs, metrics such as avalanche_health, and block-height checkpoints to monitor to confirm a node has successfully switched to the new consensus rules without forking. SRE and DevOps teams need this page to build reliable upgrade monitoring dashboards and alerting.
Dynamic Fee Algorithm Evolution
Traces the evolution of the C-Chain's fee mechanism from the pre-Apricot single-price model to the Apricot Phase 3 dynamic fee algorithm based on EIP-1559. Explains how the parameters were tuned and how subsequent upgrades have refined gas limits and fee calculations. Wallet developers and dApp teams need this page to optimize transaction submission and gas estimation logic.
Avalanche Warp Messaging (AWM) Activation History
Timeline of AWM's rollout, starting with the Banff upgrade for Subnet-to-Subnet messaging and culminating in the Durango upgrade for native P-Chain support. Details the technical progression and how each phase unlocked new cross-chain application patterns. Cross-chain protocol architects need this page to understand the evolving trust and security model of AWM.
Staking Parameter Changes Across Upgrades
Historical record of how staking minimums, maximum delegation amounts, and reward curves have been altered by network upgrades. Tracks changes from the initial 2,000 AVAX requirement through to the flexible, L1-defined staking rules introduced in Etna. Validators and staking pool operators need this page to model economic returns and plan capital allocation.
Atomic Transaction Model Changes
Focuses specifically on how cross-chain asset transfers (X to C, C to P) have been re-architected. Explains the shift from the X-Chain DAG-based atomic swaps to the Cortina-era P-Chain-managed atomic transactions, detailing the new workflow for wallets and bridges. Wallet developers and bridge operators need this page to update their cross-chain transfer logic.