{"id":19096769,"url":"https://github.com/sky-ecosystem/dss-flappers","last_synced_at":"2025-08-20T07:30:49.447Z","repository":{"id":160513531,"uuid":"628081016","full_name":"makerdao/dss-flappers","owner":"makerdao","description":null,"archived":false,"fork":false,"pushed_at":"2024-09-26T10:15:36.000Z","size":1140,"stargazers_count":39,"open_issues_count":0,"forks_count":23,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-12-12T01:35:33.161Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Solidity","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/makerdao.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":"audit/20230606-ChainSecurity_MakerDAO_FlapperUniV2_audit.pdf","citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-04-14T21:42:36.000Z","updated_at":"2024-10-29T17:56:51.000Z","dependencies_parsed_at":null,"dependency_job_id":"8a8c29a7-8980-4773-acd1-6594aed9660d","html_url":"https://github.com/makerdao/dss-flappers","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makerdao%2Fdss-flappers","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makerdao%2Fdss-flappers/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makerdao%2Fdss-flappers/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makerdao%2Fdss-flappers/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/makerdao","download_url":"https://codeload.github.com/makerdao/dss-flappers/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230400616,"owners_count":18219831,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-09T03:37:41.614Z","updated_at":"2025-08-20T07:30:49.004Z","avatar_url":"https://github.com/makerdao.png","language":"Solidity","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Dss Flappers\n\nImplementations of MakerDAO surplus auctions, triggered on `vow.flap`.\n\n### Splitter\n\nExposes a `kick` operation to be triggered periodically. Its logic withdraws `USDS` from the `vow` and splits it in two parts. The first part (`burn`) is sent to the underlying `flapper` contract to be processed by the burn engine. The second part (`WAD - burn`) is distributed as reward to a `farm` contract. The `kick` cadence is determined by the `hop` value.\n\nConfigurable Parameters:\n* `burn` - The percentage of the `vow.bump` to be moved to the underlying `flapper`. For example, a value of 0.70 \\* `WAD` corresponds to funneling 70% of the `USDS` to the burn engine.\n* `hop` - Minimum seconds interval between kicks.\n* `flapper` - The underlying burner strategy (e.g. the address of `FlapperUniV2SwapOnly`).\n* `farm` - The staking rewards contract receiving the rewards.\n\n### FlapperUniV2\n\nExposes an `exec` operation to be triggered periodically by the `Splitter` (at a cadence determined by `Splitter.hop()`). Its logic withdraws `USDS` from the `Splitter` and buys `gem` tokens on Uniswap v2. The acquired tokens, along with a proportional amount of `USDS` (saved from the initial withdraw) are deposited back into the liquidity pool. Finally, the minted LP tokens are sent to a predefined `receiver` address.\n\nConfigurable Parameters:\n* `pip` - A reference price oracle, used for bounding the exchange rate of the swap.\n* `want` - Relative multiplier of the reference price to insist on in the swap. For example, a value of 0.98 * `WAD` allows for a 2% worse price than the reference.\n\n#### Note:\n\n* Although the Flapper interface is conformant with the Emergency Shutdown procedure and will stop operating when it is triggered, LP tokens already sent to the `receiver` do not have special redeeming handling. Therefore, in case the Pause Proxy is the `receiver` and governance does not control it, the LP tokens can be lost or seized by a governance attack.\n\n### FlapperUniV2SwapOnly\n\nExposes an `exec` operation to be triggered periodically by the `Splitter` (at a cadence determined by `Splitter.hop()`). Its logic withdraws `USDS` from the `Splitter` and buys `gem` tokens on Uniswap v2. The acquired tokens are sent to a predefined `receiver` address.\n\nConfigurable Parameters:\n* `pip` - A reference price oracle, used for bounding the exchange rate of the swap.\n* `want` - Relative multiplier of the reference price to insist on in the swap. For example, a value of 0.98 * `WAD` allows for a 2% worse price than the reference.\n\n### SplitterMom\n\nThis contract allows bypassing the governance delay when disabling the Splitter in an emergency.\n\n### OracleWrapper\n\nAllows for scaling down an oracle price by a certain value. This can be useful when the `gem` is a redenominated version of an existing token, which already has a reliable oracle.\n\n### General Note:\n\n* Availability and accounting of the withdrawn `USDS` is the responsibility of the `vow`. At the time of a `kick`, the `vow` is expected to hold at least the drawn amount (`vow.bump`) over the configured flapping threshold (`vow.hump`).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsky-ecosystem%2Fdss-flappers","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsky-ecosystem%2Fdss-flappers","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsky-ecosystem%2Fdss-flappers/lists"}