Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/pufferfinance/puffer-contracts


https://github.com/pufferfinance/puffer-contracts

eigenlayer ethereum puffer pufferfi restaking smart-contracts solidity staking web3

Last synced: 3 months ago
JSON representation

Awesome Lists containing this project

README 

        
# 
Puffer Contracts


[![Website][Website-badge]][Website] [![Docs][docs-badge]][docs]

  [![Discord][discord-badge]][discord] [![X][X-badge]][X] [![Foundry][foundry-badge]][foundry]



[Website-badge]: https://img.shields.io/badge/WEBSITE-8A2BE2

[Website]: https://www.puffer.fi

[X-badge]: https://img.shields.io/twitter/follow/puffer_finance

[X]: https://twitter.com/puffer_finance

[discord]: https://discord.gg/pufferfi

[docs-badge]: https://img.shields.io/badge/DOCS-8A2BE2

[docs]: https://docs.puffer.fi/

[discord-badge]: https://dcbadge.vercel.app/api/server/pufferfi?style=flat

[gha]: https://github.com/PufferFinance/PufferPool/actions

[gha-badge]: https://github.com/PufferFinance/PufferPool/actions/workflows/ci.yml/badge.svg

[foundry]: https://getfoundry.sh

[foundry-badge]: https://img.shields.io/badge/Built%20with-Foundry-FFDB1C.svg



## Overview

Stakers can deposit ETH and mint the [pufETH nLRT](https://docs.puffer.fi/protocol/nlrt#pufeth) via the PufferVault contract, which serves as a redeemable receipt for their restaked ETH. If sufficient exit liquidity is available, stakers can reclaim their ETH from the PufferVault. Over time, the redeemable amount is expected to increase from [validator tickets](https://docs.puffer.fi/protocol/validator-tickets) and restaking rewards.



In [contrast with conventional liquid staking tokens (LSTs)](https://docs.puffer.fi/protocol/nlrt#what-is-an-lst), pufETH can provide strictly more rewards for its holders. Not only does pufETH encompass PoS rewards and restaking rewards, but its value can accelerate quickly due to validator ticket sales. Furthermore, the PoS rewards for stakers are decoupled from the protocol validators' performance.



## pufETH



pufETH is implemented as a reward-bearing ERC20 token, following [ERC4626](https://ethereum.org/en/developers/docs/standards/tokens/erc-4626/) standard and inspired by [Compound's cToken](https://docs.compound.finance/v2/ctokens/#ctokens) design for optimal DeFi compatibility. It represents a novel approach in the liquid staking domain, introducing several features that enhance stakers' rewards and interaction with DeFi protocols.



Read more about pufETH and native Liquid Restaking Tokens (nLRTs) in the [Puffer Docs](https://docs.puffer.fi/protocol/nlrt#pufeth) website.



## How pufETH Works

Stakers deposit ETH to the PufferVault contract to mint the pufETH nLRT. At the protocol's inception, pufETH's conversion rate is one-to-one, but is expected to increase over time. Assuming the protocol performs well, i.e., accrues more rewards than penalties, the amount of ETH redeemable for pufETH will increase.



### Calculating the Conversion Rate

The conversion rate can be calculated simply as:



```

conversion rate = (deposits + rewards - penalties) / pufETH supply

```

  

Where:



- deposits and pufETH supply increase proportionally as stakers deposit ETH to mint pufETH, leaving the conversion rate unaffected.



- rewards increase as [restaking operators](https://docs.puffer.fi/protocol/puffer-modules#restaking-operators) run AVSs and whenever validator tickets are minted.



- penalties accrue if validators are slashed on PoS for more than their 2 ETH collateral, which is [disincentivized behavior](https://docs.puffer.fi/protocol/validator-tickets#why--noop-incentives) and mitigated through [anti-slashing technology](https://docs.puffer.fi/technology/secure-signer). Penalties can also accrue if the restaking operator is slashed running AVSs, which is why Puffer is [restricting restaking operator participation](https://docs.puffer.fi/protocol/puffer-modules#restricting-reops) during its nascent stages.



## Contract addresses

- PufferVault (pufETH token): `0xD9A442856C234a39a81a089C06451EBAa4306a72`



For more detailed information on the contract deployments (Mainnet, Holesky, etc) and the ABIs, please check the [Deployments and ACL](https://github.com/PufferFinance/Deployments-and-ACL/blob/main/docs/deployments/) repository.



## Audits

- BlockSec: [pufETH V1](./audits/BlockSec-pufETH-v1.pdf), [pufETH V2 & PufferProtocol](./audits/BlockSec%20-%20pufETHV2%20&%20PufferProtocol.pdf), [Puffer L2 Staking](./audits/Blocksec%20-%20Puffer%20L2%20Staking.pdf), [Fast Path Rewards](./audits/BlockSec%20-%20Fast%20Path%20Rewards.pdf), [2 Step Withdrawals](./audits/BlockSec%20-%202-Step%20Withdrawals.pdf), [PUFFER](./audits/BlockSec%20-%20PUFFER.pdf)

- SlowMist: [pufETH V1](./audits/SlowMist-pufETH-v1.pdf), [pufETH V2 & PufferProtocol](./audits/SlowMist%20-%20pufETHV2%20&%20PufferProtocol.pdf), [Puffer L2 Staking](./audits/SlowMist%20-%20Puffer%20L2%20Staking.pdf)

- Nethermind: [pufETH V2 & PufferProtocol](https://github.com/NethermindEth/PublicAuditReports/blob/main/NM0202-FINAL_PUFFER.pdf)

- Creed: [pufETH V2 & PufferProtocol](https://github.com/PufferFinance/PufferPool/blob/polish-docs/docs/audits/Creed_Puffer_Finance_Audit_April2024.pdf)

- Quantstamp: [pufETH V1](./audits/Quantstamp-pufETH-v1.pdf)

- Trail of Bits: [pufETH V2](https://github.com/trailofbits/publications/blob/master/reviews/2024-03-pufferfinance-securityreview.pdf)

- Immunefi [Boost](https://immunefi.com/boost/pufferfinance-boost/): [v1](./audits/Immunefi_Boost_pufETH_v1.pdf)



# How to run unit tests



1. Clone this repository

2. `yarn install`

3. `cd mainnet-contracts/ && yarn test:unit` or `cd l2-contracts/ yarn test:unit`