This standard outlines a smart contract interface for a Circuit Breaker that triggers a temporary halt on protocol-wide token outflows when a threshold is exceeded for a predefined metric. This circuit breaker does not assume the structure of the underlying protocol, and mainly serves as a pass-through vehicle for token outflows. In order to maintain correct internal accounting for integrated protocols, and to provide maximum flexibility for developers, developers can specify if the circuit breaker contract should delay settlement and temporarily custody outflows during the cooldown period, or revert on attempted outflows.
quote from Fellowship of Ethereum Magicians on EIP-7265: the Circuit Breaker Standard
The idea of Circuit Breakers is not new. However, with the most recent developments under EIP-7265, new opportunities have evolved. Especially for asset-heavy protocols such as Balancer. Lightweight updates could exponentially increase the protocol’s security.
Being actively involved in the development of to EIP-7265, we are familiar with circuit breakers and their implementations.
We are proposing to research and build tailored circuit breaker implementations to improve the security of the Balancer protocol and prevent most known attack vectors by default. Furthermore, our proposal will enhance and highly incentivize governance participation, as we are introducing new governance mechanisms that will allow safe management of emergency situations through DAO votings.
With our contributions to EIP-7265, our research work, and our demos at various hackathons, we managed to prove how exploits on contracts with in-production vulnerabilities could be prevented.
The two main ones have been our Decentralized Circuit Breaker @ ETHGlobal Paris 2023 and our Firewall Hack at SOZU HAUS Paris 2023. Another one has been an on-chain firewall to protect Uniswap v3 from fraudulent contract interactions. A demo of this use-case received great acknowledgement and won over 5 prizes at the ETHPrague Hackathon, see here.
After demonstrating the effectiveness of our approach through our prize-winning demos, and having raised enough confidence in circuit breaker implementations through our research and contributions, we are keen to further this exploration in collaboration with the Balancer Team.
For this project, we propose to develop a novel on-chain firewall (circuit breaker) system designed for optimal security, flexibility, and governance. This system will provide advanced measures to safeguard Balancer against all sorts of third-party attack vectors, all the while, preserving the core decentralized ethos of Balancer.
This proposed project will not necessitate any immediate changes or updates to the Balancer protocol, until mainnet integration decisions are made.
Over $1 Billion is locked in Liquidity on Balancer v2 across 4 different networks. If we succeed we will have added another layer of security to Balancer, protecting its assets.
- Develop innovative methods for proactive protocol security within the Balancer ecosystem.
- Enhance and secure the upcoming modifications to the Balancer Protocol by integrating tailor-made circuit-breakers.
- Quantify and minimize protocol risks through the use of circuit-breakers.
- Improve user experience by offering opt-in security features.
- Enhancing Governance Participation by adding new functionality that naturally:
- Motivates participation from individual voters
- Increases the number of high-quality and engaged delegate platforms
- Improves the visibility and understanding of governance processes and proposals
- Identify and overcome potential implementation challenges before the integration of circuit breakers into the Balancer Protocol.
- Research results outlining the benefits and technicalities of implementing circuit-breaker systems to Balancer.
- Detailed description of all functionalities.
- Step-by-step guide for circuit-breaker implementation.
- Limitations and potential obstacles in the use of circuit-breakers
- Suitable governance solutions for handling a triggered circuit breaker event
- Outline and Analysis of circuit-breaker event strategies
- Github repository, complete with all relevant unit tests
- Security monitoring & analytics
- UI Components, displaying relevant Data
- UX improvements, seamlessly integrating new functionality to the existing interface (if given)
- Dashboard, displaying subgraph data relevant to Balancer stakeholders
- Governance Interface
- For handling proposals in emergency situations, such as circuit breaker events
- Development and testing of smart contracts to facilitate circuit breaker functionalities.
- Creation of subgraphs to gather data relevant to firewall functionalities and Balancer stakeholders.
We propose to divide the grant into three phases, corresponding to the complexity and novelty of the project. We are asking for an initial grant of $15K for Phase 1. Upon successful completion of Phase 1, we intend to discuss further phases and the corresponding funding requirements with Balancer Team.
- Estimated Duration: 1 Month
- FTE: 3 (*FTE = Full Time Equivalent)
- Costs: $15,000
- Estimated delivery date: 30th August 2023
This phase will focus on in-depth research and the creation of proof-of-concepts demonstrating how tailored circuit-breakers can enhance the security and functionality of Balancer.
|1.||Documentation||We will provide both inline documentation of the code and examples that explain how on-chain security methods, mainly circuit-breakers could be integrated to the Balancer Protocol.|
All technical components needed to realise this, will be explained.
The documentation will also include the detailed research findings that address
→ technical limitations,
→ potential risks,
→ different technical and non-technical implications for AAVE |
| 2. | Proof-of-Concepts | Based on examples that result from the conducted research, functional prototypes will be build proving its technical feasibility.
This proof-of-concepts also serve for demonstration purposes to Balancer and its stakeholders, so they have more material to evaluate the further future of this Grant. |
| 3. | Technical Blog Post | A technical blogpost explaining the proof-of-concept and research findings |
We are asking for $15K for this proof-of-concept milestone, to be paid upon grant approval.
- Estimated Duration: 2 Months
- FTE: 3
- Costs: $30,000
- Estimated delivery date: 30th October 2023
The second phase will concentrate on the development and testing of circuit breaker prototypes based on the findings of the first phase. The prototypes will showcase the practicality and benefits of integrating on-chain firewalls into the Balancer protocol.
|1.||Smart Contracts||Development and testing of smart contracts to facilitate circuit breaker functionalities.|
|2.||Subgraphs||to gather data relevant to firewall functionalities and Balancer stakeholders.|
→ relevant for voters and governance overall |
| 3. | Frontend | → Dashboard:
◦ security monitoring & analytics
◦ UI Components, displaying relevant Data
◦ UX improvements, seamlessly integrating new functionality to the existing interface (if given)
→ Dashboard, displaying subgraph data relevant to Balancer stakeholders
→ Governance Interface
◦ for handling proposals in emergency situations, such as circuit breaker events |
The TurtleShell Team will also assist in marketing and explaining the integration, including:
- Public blog post and co-marketing.
- Detailed technical explanation of circuit architecture.
- Detailed analysis of security guarantees.
- Estimated Duration: 1 Month
- FTE: 3
- Costs: $15,000
- Estimated delivery date: 30th November 2023
The final phase will involve the testnet deployment of all firewall components, followed by rigorous testing and refinement to ensure the system is ready for mainnet audit and potential integration into Balancer.
|1.||Testing Guide||All code will have proper unit-test coverage (e.g. 95%) to ensure functionality and robustness. In the guide we will describe how to run these tests|
|2.||Public and clearly documented open-source repos for:|
|→ Smart Contracts|
|→ Frontend||We will provide both inline documentation of the code and a basic tutorial that explains how a user can (for example) spin up the application. Application is up, it will be possible to send test transactions that will show how the new functionality of circuit breakers & governance functionalities, work.|
|4.||Informational Publications||→ Blog Posts, etc.|
The TurtleShell Team will also assist in preparing the system for mainnet deployment, including:
- Coordination with Balancer for all relevant security audits
- Operating and maintaining relevant components such as the frontend and governance interface
- Providing an open-source implementation for backup
- Twitter: @valerio_eth
- Email: email@example.com
- Telegram handle: @nft_valerio
- Github: valeriofichera
- Twitter: @phil10013
- Email: firstname.lastname@example.org
- Telegram handle: @keinberger
- Github: keinberger
The TurtleShell team is fully committed to this project and excited about the potential to enhance the security, reliability, and functionality Balancer through the integration of circuit breakers. We look forward to your consideration of this proposal.