PIP-55- Reward Mechanism Automation proposal
Abstract
WakeUp Labs aims to collaborate with ParaSwap to optimize and automate the reward distribution processes, reducing manual work, minimizing human error, and supporting decentralization while ensuring compliance.
This proposal originates from discussions we held across the forum (Streamlining PSP Incentives: Automating Processes?), during various conferences, and in connection with a recently approved proposal: PIP-53: Streamlining of the Staked PSP Incentive System, which simplified the staked PSP incentive system.
Now is the ideal time to automate these processes.
The objective is to automate the reward distribution for both the Reward and the Gas Refund Program. WakeUp Labs will develop scripts to gather data, calculate token allocations, and post proposals on Snapshot. Once approved, it will then be executed automatically using third-party smart contracts and oracles.
This proposal also aims to streamline the Gas Refund mechanism, noting the following:
The Gas Refund program distribution will remain active on both Optimism and Ethereum. However, the refund calculation will be based solely on mainnet activity.
This is because, although users claim the gas refund on the network they stake $PSP, in the last 6 epochs, more than 95% of the total gas refunded came from Ethereum mainnet transactions, which only accounted for 22% of the valid transactions.
The remaining 78% of valid gas refund transactions happened on the rest of the chains where the program is currently live (BSC, Polygon, Optimism, and Fantom) and didn’t generate significant refunds for users, an average of $0.06 refunds per address, only adding operational complexity to the tracking and computation of the program.
Chain | PSP Refunded | USD Refunded | Avg USD received per address | Number of Transactions |
---|---|---|---|---|
Ethereum | 4,042,016 | $67,357 | $59 | 16,354 |
Rest of the chains | 201,212 | $3,151 | $0.06 | 55,182 |
[Figures for epochs 19 to 24]
The Gas Refund program calculations will be maintained as outlined in PIP-53. This will adhere to the new staking score formula and apply exclusively to trades executed via the Augustus V6.2 and ParaSwap Delta contract sets.
The entire solution will be open-source and communicated publicly through the forum to enhance transparency and trust within the ParaSwap community.
About WakeUp
WakeUp Labs is a software development company specializing in helping DAOs and startups build complex digital products. We have collaborated with major clients, including Arbitrum, Optimism, Coinbase, Num Finance, and Mokens League. To date, we have successfully launched over 40 projects across Latin America, the U.S., and Europe.
Goals and Review
Based on the discussion through our talks, shared information, and identified needs with Laita Labs, the following criteria must be met for the project to be considered successful:
-
Deliver a set of solutions that, without the direct involvement of Laita Labs (the team currently responsible) , fully automates reward calculation, distribution, and transfer for both the Reward and Gas Refund Programs.
-
The service will be managed, hosted, and operated by WakeUp Labs, enhancing ParaSwap’s decentralization as a protocol.
-
A brief product and technical feasibility phase will be conducted with the team to validate the solution’s effectiveness and minimize unnecessary back-and-forth with ParaSwap and DAO teams once development begins.
-
The project will be open-source, with clear documentation provided on GitHub and in the open-source repository.
-
As this is a DAO initiative, significant milestones and progress updates will be shared on the ParaSwap forum, similar to WakeUp Labs’ communication approach with other DAOs like Arbitrum.
- Example: WakeUp Labs Update Thread on Arbitrum
- Collaborative social media announcements may also be made if beneficial for both.
-
Based on discussions, the target deadline is to have the automated distribution tested in parallel with the manual process by the end of December, with the first live automated distribution set for the end of January 2025.
- The Technical Kick-Off should have taken place at least 35 business days before the Distribution Mechanism for January.
Means
Description | ||
---|---|---|
Time | ~35 business days | |
Price | USD 25,400 | |
Fee on future transactions for these programs | 0.75% | |
Monthly max cap on future transactions fee | $1,500 |
Warranty
- WakeUp will continue receiving a 0.75% fee per epoch, capped at a maximum of $1,500 monthly. In return, we will take responsibility for maintaining the service.
Payment Method and Revenue Model
Payments will be made in cryptocurrency. Since the quote was valued in USD, even if the payment is made in $ETH or $PSP, the amount to transfer will be calculated on the payment date to ensure it is equivalent to the USD value.
The payment structure is as follows:
- 50% at the kickoff of the project, paid in $ETH.
- 50% upon final delivery, paid in $PSP.
The second payment will be made once both teams are satisfied with the work performed, using this proposal as a reference.
WakeUp is committed to delivering work that meets ParaSwap’s expectations and will make an extra effort to address any details that may not have been fully captured in this proposal.
Furthermore, WakeUp will charge:
- A 0.75% fee on the total amount of ETH paid for these programs will be charged, with a maximum cap of $1,500 USD.
- $500 USD will be allocated to cover hosting servers, virtual machines, and an operator for any necessary manual work. If the service goes down, WakeUp Labs will be responsible for restoring it.
- The remaining fee will be allocated to development hours at a rate of $75 USD/hr. These hours can be optionally used at the end of the month; if utilized, a developer will be assigned specific tasks to be developed in the following month.
Otherwise, the funds will simply remain as profit for WakeUp. - If the work required exceeds the amount covered by the fee and the implementation is still desired, the ParaSwap DAO will be responsible for covering the balance, subject to successful governance approval.
Implementation Overview
The project deployment will be carried out in 4 milestones and will have a duration of 35 business days.
Milestone 1: Architecture Definition, and Technical Specifications
Timeline: 5 Business Days
-
Define the internal architecture for implementing the solution.
-
Validate the system flow with both the Laita Labs team and WakeUp Labs’ technical team.
-
Develop a Proof of Concept (PoC), conduct testing, and validate with ParaSwap using third-party protocols such as UMA and oSnap.
-
Design the database, if required.
-
Establish the technical integration details for smart contracts, if necessary.
-
Simplify the Gas Refund program so users can claim on the network where they stake $PSP, but the refund amount is calculated solely based on Ethereum Mainnet.
Milestone 2: Build Scripts to Gather Data and run them.
Timeline: 15 Business Days
-
Check ParaSwap APIs to temporarily obtain the correct amount of tokens to assign to rewards.
-
Calculate rewards using on-chain information based on the definitions in PIP-53 and the previously agreed Gas refunds; these should match the values returned by ParaSwap’s APIs.
-
After running the scripts, determine the ParaBoost Score for each address by Epoch, along with the total reward amounts that need to be allocated to each Escrow.
Milestone 3: Configure Snapshot, submit proposals, and set up everything to avoid manual signatures
Timeline: 5 Business Days
-
Using the information gathered in Milestone 2, we will automatically submit a proposal to Snapshot displaying the calculations for assigning the corresponding rewards. And the on-chain transaction if needed.
-
DAO participants will be able to vote for or against the proposal if they wish to approve the allocation of these rewards.
-
Next, we will configure oSnap by UMA so that, once the proposal is approved by the DAO, the process continues automatically without requiring specific signatures from Multisig members.
-
Finally, the funds will be transferred to Escrow contracts, allowing users to claim their rewards seamlessly.
Milestone 4: Documentation, testing, deployment to production, and release.
Timeline: 10 Business Days
-
Conduct comprehensive testing internally and with users to ensure the solution remains stable.
-
Provide a detailed developer guide on GitHub.
-
Deploy the solution to production.
-
Announce the formal closure of the project through social media and the ParaSwap forum.
Testing & QA
Extensive testing will be conducted to ensure that:
-
API information and on-chain gathered data produce consistent results.
-
The user experience aligns with ParaSwap’s objectives.
-
Transactions are executed directly and accurately, without intermediaries.
-
Technical documentation is clear and accessible, maximizing value for developers and ensuring transparency.
Potential Unknowns and Timeline Impacts
-
Lack of a clear API or accessible information needed to perform reward calculations.
-
Greater-than-expected involvement from the ParaSwap team needed, such as defining the flow, approving plugins, and establishing agreements with other projects, especially if team availability is limited, which could lead to delays.
-
Changes in protocols to be integrated, or restrictions encountered during their implementation.
-
Changes in regulations, third-party policies, or software updates that may impact interactions with user funds.
-
It may happen that some parts of the Uma/oSnap/Snapshot workflow are not fully automated and require manual intervention to ensure the entire workflow functions correctly. In such cases, a member of the WakeUp team will resolve it manually.
-
Issues that arise post-testing and QA that fall outside the responsibility of WakeUp Labs.
Clarifications / Assumptions
-
The milestones don’t need to be sequential; in fact, overlapping phases is feasible, which could reduce the overall development time.
-
No UI will be provided
-
This mechanism must work for both the ETH mainnet and OP.
-
Server costs (AWS or Vercel) and other related services are the responsibility of WakeUp Labs.
-
As WakeUp will continue to receive a monthly fee in every epoch, we will take responsibility for maintaining the service.
-
WakeUp Labs will not be responsible for driving long-term adoption of the project. (ParaSwap).
-
Hosting and production deployment of Web2 services developed by WakeUp Labs will be on WakeUp Labs servers (preferably AWS).
-
Any item not explicitly mentioned in this budget is considered outside the scope of this proposal.
Team
- 1 Senior Full Stack Developer - Full Time.
- 1 Technical Lead / PM - Part Time.
- 1 QA Engineer - Part Time.
All team members are highly qualified to execute this implementation and deliver a robust platform.