Backwards Compatibility and Breaking Change Guide #66
Replies: 7 comments 6 replies
-
Dear Hedera Team, While we appreciate the intent to formalize these processes, we believe the current approach falls short of addressing fundamental concerns that impact Hedera’s credibility as a secure, stable, and enterprise-ready blockchain. Below, we elaborate on the most pressing issues — frequent network upgrades, the immutability of native services, and the developer experience — while proposing actionable solutions to ensure Hedera remains a trusted platform for builders and enterprises. 1. Frequent Network Upgrades: A Threat to Security and Enterprise AdoptionConcern: Upgrading the Hedera mainnet every two weeks introduces significant risks and undermines professionalism, potentially deterring enterprise adoption. This cadence risks: Enterprise Perspective: Recommendation:
2. Immutability of Native Services: A Non-Negotiable PrincipleConcern: Deprecating native service's features (either on consensus nodes or on sdk) related to Hedera Consensus Service (HCS), Hedera Token Service (HTS), and Hedera File Service (HFS) contradicts the immutability guarantees offered to smart contracts, eroding trust in the native layer. Deprecation, even with a 6-month timeline, violates this principle by: Technical Implications: Recommendation: 3. Developer Experience: Ensuring “Build Once, Run Forever”Concern: Frequent upgrades and potential deprecations force developers to continuously update appnets, draining resources and introducing bugs/regressions. Biweekly upgrades and a 6-month deprecation timeline shatter this expectation by: Real-World Impact: Recommendation: 4. Additional Pillars for a Robust EcosystemTo strengthen our argument and align Hedera with enterprise and developer expectations, we propose the following enhancements: 5. ConclusionHedera’s vision as a secure, scalable, and decentralized public ledger is compelling, but its current approach to network upgrades and backward compatibility risks alienating the very builders and enterprises it seeks to attract. A blockchain cannot afford biweekly upgrade and risks attached to it, nor can it contemplate deprecating native services that appnets rely on, especially when smart contracts enjoy immutable guarantees. Developers must be empowered to build once and trust that their work endures—free from the burdens of constant updates, resource drain, and regression risks. We urge Hedera to adopt a stability-first mindset: reduce upgrade frequency, enshrine native service immutability, and prioritize backward compatibility as a core tenet. Your initial proposal is a step forward, but it requires significant revision to meet the standards of a professional blockchain ecosystem. Sincerely, |
Beta Was this translation helpful? Give feedback.
-
The issues raised by Tomachi Anura are of serious concern. I am an investor in Hedera because I believe in the enterprise application/utility of this technology. Even if we are open source we need to keep up the high standard that is necessary to win the market. We have a whole eco-system that started to build because of the commitment to high quality and thought leadership by the founders Leemon and Mance. This topic needs full leadership attention. Please! |
Beta Was this translation helpful? Give feedback.
-
It's really disappointing that this keeps happening to this hard working team. These guys have been nothing but transparent with their community always being honest and keeping us updated, I cannot understand why they are deemed 'toxic' at all. |
Beta Was this translation helpful? Give feedback.
-
Hello everyone, I'm seeing we're not getting to much interections here. I would like to state the MOST important reccommendations. This is essencial so we could keep bulding in peace. We're not using SmartContracts for those who don't know. We've been building Dr. Leemon Baird's vioson of dAppnets! ### Recommendation - "Build once, run forever" |
Beta Was this translation helpful? Give feedback.
-
Comparative Analysis: Risks of Rapid Update Cycles in Blockchain Development - Hedera's Approach vs. Industry Best PracticesBlockchain Update Cadence: A Critical Security FactorEstablished blockchains have demonstrated that deliberate, carefully-paced development is essential for network security and stability. Examining update practices across major platforms reveals significant differences in approach: Update Frequency Comparison
Critical Security Insight: Bitcoin's Taproot update underwent three years of design, testing, and implementation before deployment. Ethereum's Merge required 18+ months of testing across multiple testnets. These deliberate timelines aren't bureaucratic inefficiency—they're essential security measures that Hedera's bi-weekly push schedule fundamentally undermines. The Inherent Dangers of Accelerated Update CyclesBi-weekly Updates: A Fundamental Security RiskHedera's accelerated bi-weekly mainnet update schedule introduces profound vulnerabilities:
Repository Update Practices: Speed vs. Security
Quantifiable Metrics: Stability vs. VulnerabilityHistorical Resilience Comparison
Enterprise Adoption ImplicationsUpdate Management RequirementsEnterprise systems typically operate on quarterly or annual update cycles due to:
Hedera's bi-weekly update approach creates significant friction for enterprise adoption, as organizations must either:
Case Studies: Update Failures in Distributed SystemsEthereum Constantinople Delay (2019)A critical vulnerability was discovered just 24 hours before scheduled deployment, leading to a last-minute postponement. This incident demonstrates the value of extended review periods that Hedera's update cycle doesn't accommodate. Solana Outages (2021-2022)Frequent network updates contributed to multiple outages as validators struggled to maintain synchronization. Despite a slower update cycle than Hedera, Solana's experience highlights the risks of prioritizing rapid development over stability. Technical Debt AccumulationRapid update cycles inevitably lead to accumulated technical debt as:
Bitcoin, Ethereum and XRP Ledger all periodically allocate extended development cycles specifically to address technical debt—a practice incompatible with Hedera's continuous bi-weekly schedule. Conclusion: Balancing Innovation and SecurityThe established blockchain development models have demonstrated remarkable resilience through deliberate, measured evolution. These systems prioritize security and stability over development speed—a necessary trade-off when securing billions in assets. Hedera's bi-weekly update approach fundamentally misunderstands this essential balance. By adopting software industry-style development cycles for cryptographic infrastructure, it introduces structural vulnerabilities that contradict blockchain's security requirements. While appearing innovative on the surface, Hedera's accelerated update cadence sacrifices the critical security layers that have made established blockchains resilient. True innovation in blockchain requires not just technical capability but security wisdom—recognizing that proper cryptographic systems must prioritize thorough validation over rapid deployment cycles. For blockchain technology to achieve its transformative potential, particularly in enterprise applications, it must embrace appropriate update methodologies that balance innovation with the rigorous security demands of distributed financial systems. Hedera's current approach represents a concerning deviation from these essential principles, potentially compromising both security and long-term adoption potential. |
Beta Was this translation helpful? Give feedback.
-
it's been more than a week now, with ZERO interaction from Hiero and Hedera. for those interested, the channel is inside Hedera's discord #features-request-desk the main problem is that not only we got ZERO answers on this thread, but also on the discord one. Once again, we at HbarSuite and we as Hedera community are totally lost in the unclear and undefined procedures you ask us to follow, bringing us nowhere else, always moving in circles. I'm writing here on GitHub to keep everyone posted, including those ones which are NOT memeber of the Hedera discord, to let everyone know this convo is NOT dead, yet is NOT being properly addressed either. We will never give up, until the moment Hiero and/or Hedera clarify their position and their intetions toward this public ledger. |
Beta Was this translation helpful? Give feedback.
-
Dear Richard, Enterprise software and blockchain platforms operate under fundamentally different paradigms. While enterprise software benefits from rapid iteration to fix bugs and add features, blockchain networks serve as immutable trust layers where stability and predictability are paramount. The financial consequences of blockchain changes are immediate and irreversible, unlike traditional software where patches can resolve issues. The assertion that long release cycles don't achieve stability directly contradicts established blockchain industry practice. Bitcoin, Ethereum, and XRP Ledger all employ extended testing periods (6-24 months) precisely because this approach has proven essential for security and stability. Their deliberate pace isn't inefficient—it's a critical security measure for platforms securing billions in assets. So most probably what your personal experience is, doesn't truly match what a blockchain should be. Not to mention that bi-weekly updates will surely mine the integrity and the security of the entire network. Regarding responsibility for mistakes, accountability must extend beyond acknowledgment to concrete action. When breaking changes occur, developers incur real costs in time, resources, and potentially lost revenue. The fact that you believe apologies are enough when potentially causing millions of dollar of damages makes all of us wonder about the integrity of Hedera and the real intents behind this attitude. The most successful blockchains maintain strict immutability guarantees. Once deployed, smart contracts remain functional indefinitely, and native APIs preserve backward compatibility permanently. This "build once, run forever" principle is fundamental to blockchain's value proposition, and MUST be appliable both for contracts and for appnets. As long as you don't put this paradigm in place, there will be a very clear and undeniable act of favouritism towards smart-contracts on Hedera, and a deliberate and intentional approach to suppress all appnets and native builders by taking off them the only thing we all required: IMMUTABILITY. I appreciate the invitation to TSC meetings and will do my best to participate, accordingly to my agenda. However, transparency extends beyond access to meetings—it requires formally documented policies on immutability, deprecation, and breaking changes that enterprises can confidently build upon. Respectfully, |
Beta Was this translation helpful? Give feedback.
Uh oh!
There was an error while loading. Please reload this page.
-
This topic is on creating a backwards compatibility and breaking change guideline for projects in Hiero such that the community and maintainers of projects can reference and adhere to.
I have an initial proposal for what this should entail:
Overview
Hiero projects are committed to maintaining backwards compatibility to ensure a seamless experience for users and developers. This document outlines the approach to backwards compatibility, the process for introducing breaking changes when necessary, and the communication and deprecation timelines required to maintain transparency and stability within the Hiero ecosystem.
All Hiero projects under the Hiero GitHub organization would follow this guideline.
Ensuring Backwards Compatibility
Breaking Changes Process
If a breaking change is deemed necessary, the following process must be followed:
Deprecation Timeline Best Practices
Beta Was this translation helpful? Give feedback.
All reactions