[Routine Upgrade] Reserve contract optimisation

Governance
1

Abstract

The Security Council will perform a routine upgrade Friday 29th of August 2025 for Reserve Contract Optimisation to benefit SPR users by saving gas when claiming SUP flowrate from the Claim App.

Key Terms

Motivation

  • SPR Reserve contracts connect to GDA pools in order to claim SUP streams (based on the reserve owner participation in ecosystem apps).

  • GDA pools have a lifespan of around 3 months (1 SPR season). Once the season ends, the GDA pool outgoing stream is terminated and will not be resumed.

  • In Superfluid protocol, the more GDA pools an account has connected for a given token, the higher the gas cost for calculating its balance for that token.

Rationale

  • As of the current Reserve implementation, the user has the possibility to manually disconnect their Reserve from a SPR GDA pool. However, the Claim App does not offer this feature (as it would complicate the UX and users would have to make a decision).

  • Since users are not forcefully disconnecting from the previous SPR season GDA pools, the gas cost for claiming SUP streams in the new SPR season GDA pools is increasing and will continue to do so as more and more GDA pools will be created for users to participate in.

  • This create an incentives misalignment as : the more a user participate in SF ecosystem campaigns, the more they have to pay in gas.

Specifications

  • In order to solve the above issue, a new Reserve implementation is drafted with new utility functions.

  • FluidLocker::disconnectAndClaim : allowing the user to disconnect in terminated GDA pools and claiming units in new GDA pools. Claim App would need to integrate this change in order to accurately disconnect from deprecated pools and claim from correct pools. This call may only happen once per season, during the seasonal transition.

  • FluidLocker::disconnect : adding overloaded function to batch disconnect from multiple pools

  • This solution would require a SPR Reserve contract upgrade with the new implementation.

  • Changelog for this upgrade

  • The contract changes are highlighted here

Steps to Implement

Superfluid Foundation Engineering team to perform the following steps:

  • Deploy the new SPR Reserve logic contract

  • Verify logic contract deployment

  • Propose the proxy upgrade transaction

  • Collect DAO signatures

  • Execute the transaction

Timeline - As the new Reserve implementation is ready and tested, this proposal can be executed anytime. The Security Council plans to execute this upgrade next week and welcomes feedback from the DAO.

Overall Cost - No significant incremental costs are expected to be incurred by the Foundation from the implementation of this proposal.

6 Likes
2

Thanks for the detailed write-up @pilou.

  • The contract changes are highlighted here

The main change to the live contract of SPR is in packages/contracts/src/FluidLocker.sol. The changes matches the specification. The test case is also present in packages/contracts/test/FluidLocker.t.sol

Overall, it looks go to me, and also a change of low complexity but with good impact.

Note that the Security Council is not part of the upgrade process; however, conducting a review process is a good practice that we will follow anyway. We also don’t recommend any community vote on this, since it is a technical update that won’t impact the SPR campaign behavior.

5 Likes