部署

状态变量

ERC-20 (Inherited)

https://docs.openzeppelin.com/contracts/2.x/api/token/erc20#ERC20

访问控制(Inherited)

https://docs.openzeppelin.com/contracts/3.x/api/access#AccessControl

FXS各项细分。

address public FRAXStablecoinAdd

FRAX 合约地址。

uint256 genesis_supply

FXS初始供应。

uint256 public maximum_supply

FXS最大供应。

uint256 public FXS_DAO_min

加入 DAO 组织所需的最低 FXS 量。

address public owner_address

合约Owner地址。

address public oracle_address

oracle合约地址。

address public timelock_address

时间锁地址。

FRAXStablecoin private FRAX

FRAX 合约实例。

struct Checkpoint {
    uint32 fromBlock;
    uint96 votes;
}

借鉴自Compound Finance。用于治理投票。

mapping (address => mapping (uint32 => Checkpoint)) public checkpoints

在特定区块下，给定地址的投票权列表。

mapping (address => uint32) public numCheckpoints

某个地址的Checkpoint计算。

受限制的函数

setOracle

setOracle(address new_oracle) external onlyByOracle

Change the address of the price oracle.

setFRAXAddress

setFRAXAddress(address frax_contract_address) external onlyByOracle

Set the address of the FRAX contract.

setFXSMinDAO

setFXSMinDAO(uint256 min_FXS) external onlyByOracle

Set minimum FXS required to join DAO groups.

mint

mint(address to, uint256 amount) public onlyPools

Mint new FXS tokens.

pool_mint

pool_mint(address m_address, uint256 m_amount) external onlyPools

This function is what other FRAX pools will call to mint new FXS (similar to the FRAX mint).

pool_burn_from

pool_burn_from(address b_address, uint256 b_amount) external onlyPools

This function is what other FRAX pools will call to burn FXS.

重写的公共函数

transfer

transfer(address recipient, uint256 amount) public virtual override returns (bool)

Transfer FXS tokens.

transferFrom

transferFrom(address sender, address recipient, uint256 amount) public virtual override returns (bool)

Transfer FXS tokens from another account. Must have an allowance set beforehand.

公共函数

getCurrentVotes

getCurrentVotes(address account) external view returns (uint96)

Gets the current votes balance for account.

getPriorVotes

getPriorVotes(address account, uint blockNumber) public view returns (uint96)

Determine the prior number of votes for an account as of a block number. Block number must be a finalized block or else this function will revert to prevent misinformation.

内部函数

_moveDelegates

_moveDelegates(address srcRep, address dstRep, uint96 amount) internal

Misnomer, from Compound Finance's _moveDelegates. Helps keep track of available voting power for FXS holders.

_writeCheckpoint

_writeCheckpoint(address voter, uint32 nCheckpoints, uint96 oldVotes, uint96 newVotes) internal

From Compound Finance's governance scheme. Helps keep track of available voting power for FXS holders at a specific block. Called when a FXS token transfer, mint, or burn occurs.

safe32

safe32(uint n, string memory errorMessage) internal pure returns (uint32)

Make sure the provided int is 32 bits or less, and convert it to a uint32.

safe96

safe96(uint n, string memory errorMessage) internal pure returns (uint96)

Make sure the provided int is 96 bits or less, and convert it to a uint96.

add96

add96(uint96 a, uint96 b, string memory errorMessage) internal pure returns (uint96)

Add two uint96 integers safely.

sub96

sub96(uint96 a, uint96 b, string memory errorMessage) internal pure returns (uint96) 

Subtract two uint96 integers safely.

getChainId

getChainId() internal pure returns (uint)

Return the Ethereum chain ID the contract is deployed on

事件

VoterVotesChanged

VoterVotesChanged(address indexed voter, uint previousBalance, uint newBalance)

Emitted when a voters account's vote balance changes

FXSBurned

FXSBurned(address indexed from, address indexed to, uint256 amount)

Emitted when FXS is burned, usually from a redemption by the pool

修饰符

onlyPools

onlyPools()

Restrict actions to pool contracts, e.g. minting new FXS.

onlyByOracle

onlyByOracle()

限制只有预言机可以执行的操作，例如设置 FRAX 和预言机地址。

“gauge”是一种收益耕种智能合约，它在一种资产(通常是LP代币、金库代币、NFT头寸等)中吸收存款，并以FXS(可能还有其他)代币奖励存款用户。Gauge合约可以采用多种形式的存款，如FRAX贷款存款(Aave中的aFRAX, Compound中的cFRAX, Fraxlend中的fFRAX)， LP代币(Curve LP代币或Fraxswap LP代币)，甚至NFT(如Uniswap v3 NFT头寸)。Gauge用于激励对协议有利的特定“策略”和行为，如增加FRAX贷款，加深某些交易对的流动性，或增加另一个项目之间的合作/集成。Gauge完整列表可以在这里找到： https://app.frax.finance/gauge

分配FXS给每个 gauge 的策略称为它的“gauge权重”。他们可以在多个gauges或单一gauge上分配投票权。这使得协议的长期用户veFXS持有者可以控制未来的FXS排放率。每个veFXS等于1票。

此外，Gauge系统降低了那些将大部分奖励卖出的FRAX交易对的影响，因为这些LP将没有veFXS继续为他们的流动性池投票。该系统非常青睐那些不断将自己的奖励用于veFXS，以增加其流动性池的Gauge权重。从本质上讲，FRAX平衡了veFXS持有者的激励措施，使得最长期的FXS持有者控制FXS释放的方向，直到整个社区的FXS分配完成。每周三太平洋标准时间下午5点，Gauge权重会更新一次。这意味着每个池子的FXS排放速率在一周内是不变的，然后在每个星期三更新到新的速率。任何用户都可以每10天改变他们的权重分配。

由于FXS Gauge排放量是固定的，并且每年减半，在几年后，可以通过治理来决定是否分配部分协议现金流或铸造新的FRAX来衡量奖励。因此，veFXS质押者可以自信地质押最长时间4年，因为他们知道Gauges程序不是临时的，不会被弃用。目前，Gauges策略是激励Frax生态系统增长的重要组成部分。

当前Gauges种类

LP Gauge： LP gauge是最常见的gauge合约类型，以ERC20 LP代币作为存款。大多数Gauge鼓励Fraxswap, Curve, Uniswap v2等的LP头寸。通常，这些Gauge支持在每一个LP头寸中的1FRAX匹配4veFXS，则可以获得2倍veFXS加成，以及每额外锁1年，可以获得2倍锁仓加成（除非另有说明）。 Gauge：贷款gauge通常用于激励货币市场中的FRAX贷款活动，如Aave, Fraxlend, Compound等。存款代币是aFRAX, fFRAX, cFRAX等。贷款Gauge通常不提供锁仓时间加成，但每4个veFXS提供1个FRAX贷款最多可以获得2倍veFXS加成。 Uniswap V3 Gauge: Uniswap v3 gauges 将NFT LP仓位作为存款。这些gauge在发布时预先配置，以在特定的刻度范围内接受NFT lp，以仅激励治理批准的确切集中的流动性头寸。这些gauge的LP中，如果每1 FRAX提供4veFXS则可以获得2倍veFXS加成，并为1-3年锁定提供额外的2x-3x时间锁仓加成(每个Gauge在其相应的质押页面)。

金库Gauge：金库Gauge将金库策略代币作为存款，如Stake DAO或Yearn Finance金库代币。金库代币通常如果每1 FRAX提供4veFXS则可以获得2倍veFXS加成，并为1-3年锁定提供额外的2x-3x时间锁仓加成（每个gauge都有说明）

veFXS 加成 & 锁仓时间加成

在Gauge权重合约中持有LP代币的用户将根据他们拥有的veFXS的数量进一步提高APR。此外，锁定期LP代币到质押合约中的用户在一个特定期间将在顶部进一步获得加成，从而使两个加成叠加以获得最大的APR。由于 Gauge权重每周都会改变，如果Gauge权重改变，锁定在Gauge中的LPs不会被解锁。请参阅veFXS规范页面，了解如何计算加成。每个Gauge策略都可以有不同的加成条款，这取决于它所激励的最终行为。例如，由于FRAX贷款不提供锚定稳定性，因此不需要额外奖励，继而该策略只需要非常低的锁仓加成。然而， Curve、Uniswap或Fraxswap流动性gauge可能会提供较高的时间锁仓加成，因为锁定流动性有助于FRAX在波动期间保持坚挺。

Gauge 未知交易对

FRAX Gauges允许veFXS质押者直接控制任何集成FRAX池的FXS释放速率。除了要求使用FRAX稳定币并且通过Gauge治理投票之外，对于哪些协议或者交易对没有任何限制。虽然Uniswap V3稳定币区间Gauge将是首次亮相的Gauge（以及Curve的FRAX3CRV池），任何FRAX池（包括跨链池）可以在未来添加为一个Gauge。与Curve相比，veFXS Gauge系统完全支持未知的交易对，因为FRAX Gauges仅要求池子中有FRAX，而Curve要求所有的Gauge系统必须有Curve池。本质上，veFXS Gauges是Defi的货币层Gauge 权重，而Curve Gauge则是DEX层Gauge权重。由于veFXS质押者可以控制FXS释放到任何集成FRAX的协议中，许多协议和社区可能会为控制算法稳定币协议的未来现金流而竞争。

值得注意的是，在任何智能合约(非EOA钱包)上质押veFXS都必须通过治理投票列入白名单。有关持有veFXS的完整好处列表，如AMO利润和收益耕种加成，请参阅veFXS的完整说明。

⚠️ 这里解释的原始铸造/赎回模型已被淘汰，取而代之的是后来的机制（从 V2 开始），仅供历史和信息参考 ⚠️ Frax 于 2020 年 12 月 20 日首次推出。在 Frax V1 中，只有一个铸造/赎回的 AMO，即分数算法稳定机制。我们将其称为基础稳定机制。您可以在中阅读有关此机制的内容。

在 Frax V1 中，协议的抵押比例会根据 FRAX 稳定币的市场价格动态再平衡。如果 FRAX 的价格高于 1 美元，则抵押比例（CR）会下降（“去抵押化”）。如果 FRAX 的价格低于 1 美元，则 CR 会增加（“再抵押化”）。该协议始终按照 1 美元的固定汇率尊重 FRAX 的赎回，但由于 CR 是动态的，因此必须通过铸造 Frax Share 代币（FXS）来资助 FRAX 的赎回。例如，在 85% 的 CR 下，每赎回 1 个 FRAX 用户将获得 0.85 美元的 USDC 和 0.15 美元的铸造 FXS。协议直接返回给赎回者 0.15 美元的 FXS，还是以原子方式在链上出售 FXS 以返回全额 1 美元的抵押，这只是一个微不足道的实现细节——经济实现是相同的。

该基础机制可以简化为以下内容：

2. 均衡—每次当FRAX = $1 不改变抵押率

从根本上说，Frax 协议是一个银行算法，根据市场对 FRAX 的定价调整其资产负债表比例。抵押比例仅仅是协议资本（抵押）与其负债（FRAX 稳定币）之间的比率。市场通过在比率过低时出售/退出稳定币（从而略微将价格压低到 1 美元以下）或通过持续需求 FRAX（从而略微将价格推高到 1 美元以上）来“投票”确定这个比率。去抵押化和再抵押化帮助协议找到一个均衡的储备要求，以保持紧密的固定汇率并最大化资金创造的资本效率。根据定义，该协议铸造市场所需的确切数量的 FRAX 稳定币，且其抵押比例与市场对 1 美元 FRAX 的需求相匹配。

动机

在 Frax 治理实施之前，Frax 协议的操作并未完全去中心化。大多数操作由关键的 Frax 利益相关者通过 Gnosis Safes 执行。隐含的信任假设是，Frax 利益相关者不会恶意行为，且外部参与者不会迫使利益相关者执行恶意操作。随着 Frax 治理的引入，这一信任假设被消除，Frax 协议由 veFXS 持有者通过链上治理控制。

⚠️（截至 2024 年 10 月 2 日）在迁移过程中，投票将通过 Snapshot 在 Frax 自有的 链上进行。⚠️

主要组成部分

最终状态及关键要点

Frax 治理的最终状态将全面控制所有主要的安全库，让 veFXS 持有者对协议中的一切拥有最终决定权。veFXS 持有者可以对所有提案进行投票，可以在达到法定人数并通过的情况下，替换 Frax 团队成员作为底层安全库的所有者并执行任何行动。

Frax 团队成员可以通过 FraxGovernorOmega 创建乐观提案，这些提案默认成功。通常情况下，提案默认失败，但在 Frax 治理中，veFXS 持有者也可以对乐观提案进行支持或反对的投票。如果一个乐观提案达到法定人数且反对票多于支持票，该提案将失败。

背景

veFXS是基于Curve的veCRV机制的一种锁仓和收益系统。用户可以将他们的FXS锁定最多4年，以获得四倍的veFXS（例如，锁定100个FXS 4年可得到400个veFXS）。veFXS不是可转让代币，也不在流动市场上交易。它更像是一个基于账户的积分系统，表示钱包中锁定FXS代币在协议内的锁定时间。

随着代币接近锁定到期，veFXS余额线性减少，最终接近于每个FXS对应1个veFXS，当剩余锁定时间为零时。这鼓励长期质押和活跃的社区。

veFXS治理白名单

智能合约和DAO需要通过治理进行白名单认证，以质押获得veFXS。只有外部拥有的账户和普通用户钱包可以直接调用veFXS质押锁定功能。为了将veFXS功能集成到您的协议中，请通过提交白名单提案，在gov.frax.finance上与FRAX社区开始治理流程。

投票权

每个veFXS在治理提案中拥有1票。将1个FXS质押至最大时间4年，将生成4个veFXS。这个veFXS余额将在4年后逐渐减少到1个veFXS，届时用户可以将veFXS兑换回FXS。在此期间，用户还可以通过锁定FXS、延长锁定结束日期或两者兼而有之来增加他们的veFXS余额。需要注意的是，veFXS不可转让，每个账户只能有一个锁定期限，这意味着同一个地址不能将某些FXS代币锁定2年，然后再将另一组FXS代币锁定3年等。每个账户的FXS必须具有统一的锁定时间。

Gauge 收益提升

持有veFXS将使用户在获取某些收益耕种奖励时获得更多权重。所有通过协议直接分配的农耕奖励都可以获得veFXS的提升。由其他协议（如Sushi Onsen）推广的外部收益耕种通常不适用于veFXS提升，因为它们独立于Frax协议本身。其他协议可以选择通过Frax的量表农耕合约分配他们的奖励，以获取veFXS提升功能。FXS量表农耕合约支持每个量表最多4种不同代币的奖励。

用户的veFXS提升不会增加奖励的整体发行量。提升是一个附加的提升，将根据每个农民的veFXS余额添加到他们的收益中。每个LP对的veFXS提升可能会因社区的合作协议和治理投票而有所不同。每个Gauge将显示可用提升的具体条款。

收益耕种提升是以每1 FRAX的LP存款代币对应的veFXS比例进行的。例如，一个FRAX-IQ Gauge的2倍提升比例为每1 FRAX 10个veFXS，意味着拥有50,000个veFXS的用户在包含5,000 FRAX（总价值10,000美元）的LP头寸上获得2倍提升。

目前大多数Gauge提供2倍的收益提升，要求为4个veFXS对应1个FRAX。

veFXS收益

Frax协议的主要现金流分配机制是向veFXS持有者分配。来自AMO、Fraxlend贷款、Fraxswap费用等的现金流通常用于从市场回购FXS，然后分配给veFXS质押者作为收益。发行率根据协议盈利能力、现金流来源、FXS市场价格和治理行动而有所不同。

有关veFXS收益的历史视图，可以在此查看： https://app.frax.finance/vefxs。

未来功能

veFXS系统是模块化和多功能的。未来，它可以扩展以投票AMO权重，在新的地方/功能中获得额外收益，并帮助为Frax Finance经济创造长期一致性。

这将为Frax整体带来好处，包括：

• 通过veFXS将投票权分配给长期持有FXS的用户。

• 激励Gauge收益耕种用户质押FXS。

• 允许DAO和其他项目建立大规模和长期的veFXS头寸，并参与Frax治理。

• 为FXS创造类似债券的效用，并为质押的FXS创建基准APR利率。

第二版 (V2) FRAX 的扩展着重于分数-算法稳定性的概念，提出了“算法化市场操作控制器”（AMO）的想法。AMO 模块是一个自治的合约，执行任意的货币政策，只要它不改变 FRAX 的挂钩价格。这意味着 AMO 控制器可以通过算法进行公开市场操作（正如名称所示），但它们不能随意凭空铸造 FRAX，从而打破挂钩。这保证了 FRAX 的基础层稳定机制的纯粹性和不受影响，这也是使我们的协议独特的核心，并激励了其他较小的项目。

AMOs

我们可以将 V1 机制推广到任意复杂的市场操作中，创造一个图灵完备的稳定机制设计空间。因此，每个 AMO 可以被视为一个中央银行货币拼图模块。每个 AMO 都有三个特性：

1. 去抵押化 - 策略中降低抵押率（CR）的部分。

2. 市场操作 - 在平衡状态下运行的部分，不改变抵押率。

3. 再抵押化 - 策略中提高抵押率的部分。

通过清晰定义的上述框架，我们现在可以很容易地看出 Frax V1 是最简单形式的 AMO。它本质上是任何可能的 AMO 的基本情况。在 V1 中，去抵押化允许货币供应扩展，过剩的抵押品流向销毁 FXS。再抵押化铸造 FXS 以提高抵押率并减少负债（赎回 FRAX）。

基础层的分数-算法机制始终像以前一样运行。如果 FRAX 价格高于挂钩，抵押率将下降，FRAX 供应像往常一样扩展，AMO 控制器继续运行。如果抵押率下降到挂钩价格滑动的地步，AMO 具有预定义的再抵押化操作来提高抵押率。系统将像以前一样再抵押化，随着协议负债（稳定币）的赎回，抵押率上升以恢复到挂钩水平。这使得所有 AMO 都能够在市场力量的输入下运行，并保留 V1 基础案例的完整设计规范。

AMO 模块使 FRAX 成为最强大的稳定币协议之一，因为它创造了最大的灵活性和机会，而不会改变使 FRAX 成为算法稳定币领域领导者的基础稳定机制。AMO 模块打开了一个模块化设计空间，允许不断的升级和改进，而不会破坏设计的优雅性、可组合性或增加技术复杂性。最后，由于 AMO 是一个完整的“盒中机制”，任何人都可以提出、构建和创建 AMO，只要它们遵守上述规范，便可通过治理部署。

参考和资源/链接

• 原始公告帖子

• Twitter 快速解释线程

⚠️ 此池已被弃用，取而代之的是 FRAX V2 及更高版本的机制 ⚠️

部署

Frax Pool 合约由治理系统部署和管理，这意味着在治理提案成功并执行后，可以随时添加新的抵押类型。当前池为 USDC，未来池将开放更多的抵押类型。 USDC: 0x3C2982CA260e870eee70c423818010DfeF212659

描述

Frax Pool 是一个智能合约，通过抵押品向用户铸造 FRAX 代币，或通过赎回发送到合约中的 FRAX 代币来返回抵押品。每个 Frax Pool 接受不同类型的抵押品。Frax Pools 可以采用任何类型的加密货币，但由于其价格波动较小，稳定币的实现最为简单。Frax 旨在接受任何类型的加密货币作为抵押品，但在初始阶段优先选择低波动性的池，因为它们不会导致抵押比率剧烈变化。有一些有前景的新项目，如 Reflex Bonds，能够抑制其基础加密资产的波动性。未来，Reflex Bonds 可能成为理想的 FRAX 抵押品。新的 Frax Pools 可以通过 FXS 治理投票添加。

每个池合约都有一个池上限（可存储以铸造 FRAX 的最大抵押品）和资产的价格馈送。创世时的初始 Frax Pool 将是 USDC（美元硬币）和 USDT（泰达币），因为它们具有较大的市值、稳定性，并且在以太坊上可用。

这些池通过对 FRAX 稳定币（FRAX）和 FRAX 股份（FXS）合约的授权调用来铸造和赎回协议代币。

铸造和赎回 FRAX

该合约有 3 个铸造功能：mint1t1FRAX()、mintFractionalFRAX() 和 mintAlgorithmicFRAX()。合约还具有与铸造功能对应的 3 个赎回功能：redeem1t1FRAX()、redeemFractionalFRAX() 和 redeemAlgorithmicFRAX()。

这些功能被分为 1 对 1、分数和算法三个阶段，以优化 Gas 使用。1 对 1 的铸造和赎回功能仅在抵押比率为 100% 时可用。分数铸造和赎回功能仅在抵押比率为 99.99% 到 0.01% 之间可用。算法铸造和赎回功能仅在抵押比率为 0% 时可用。

滑点

每个铸造和赎回功能都有一个 AMOUNT_out_min 参数，用于指定期望从交易中获得的最低代币单位。这在提交交易时作为滑点容忍度的限制，因为价格可能会在创建交易和被包含在区块中的时间之间更新。

状态变量

接入控制 (Inherited)

https://docs.openzeppelin.com/contracts/3.x/api/access#AccessControl

FraxPool-Specific

ERC20 private collateral_token

池中抵押代币的实例。

address private collateral_address

抵押代币的地址。

address[] private owners

池子的所有者列表。

address private oracle_address

预言机合约的地址。

address private frax_contract_address

FRAX 合约的地址。

address private fxs_contract_address

FXS 合约的地址。

address private timelock_address

时间锁合约的地址。

FRAXShares private FXS

FXS 合约的实例。

FRAXStablecoin private FRAX

FRAX 合约的实例。

UniswapPairOracle private oracle

预言机合约的实例。

mapping (address => uint256) private redeemFXSBalances

记录给定地址的赎回余额。赎回者不能在同一个区块中同时请求赎回和实际赎回他们的 FRAX。这是为了防止闪电贷攻击，可能导致 FRAX 和/或 FXS 价格崩溃。赎回者必须等到下一个区块。这一特定变量用于赎回的 FXS 部分。

mapping (address => uint256) private redeemCollateralBalances

记录给定地址的赎回余额。赎回者不能在同一个区块中同时请求赎回和实际赎回他们的 FRAX。这是为了防止闪电贷攻击，可能导致 FRAX 和/或 FXS 价格崩溃。赎回者必须等到下一个区块。这一特定变量用于赎回的抵押品部分。

uint256 public unclaimedPoolCollateral

redeemCollateralBalances 的总和。

uint256 public unclaimedPoolFXS

redeemFXSBalances的总和

mapping (address => uint256) lastRedeemed

记录给定地址最后一次赎回的区块。

uint256 private pool_ceiling

池子可以接受的最大抵押品金额。

bytes32 private constant MINT_PAUSER

铸造暂停的 AccessControl 角色。

bytes32 private constant REDEEM_PAUSER

AccessControl role for the redeem pauser.

bytes32 private constant BUYBACK_PAUSER

赎回暂停的 AccessControl 角色。

bool mintPaused = false

铸造是否已暂停。

bool redeemPaused = false

赎回是否已暂停。

bool buyBackPaused = false

回购是否已暂停。

查看函数

unclaimedFXS

unclaimedFXS(address _account) public view returns (uint256)

返回未领取的 FXS 总金额。

unclaimedCollateral

unclaimedCollateral(address _account) public view returns (uint256)

返回未领取的抵押品总金额。

collatDollarBalance

collatDollarBalance() public view returns (uint256)

返回池中抵押代币的总余额（以美元计）。

availableExcessCollatDV

availableExcessCollatDV() public view returns (uint256)

返回池中抵押代币的多余余额（超过抵押比率所需的部分，以美元计）。

getCollateralPrice

getCollateralPrice() public view returns (uint256)

返回池中抵押品的价格（以美元计）。

Public Functions

mint1t1FRAX

mint1t1FRAX(uint256 collateral_amount_d18) external notMintPaused

从抵押品中铸造 FRAX。仅在抵押比率为 1 时有效。

mintFractionalFRAX

mintFractionalFRAX(uint256 collateral_amount, uint256 fxs_amount) external notMintPaused

从抵押品和 FXS 中铸造 FRAX。仅在抵押比率介于 0 和 1 之间时有效。

mintAlgorithmicFRAX

mintAlgorithmicFRAX(uint256 fxs_amount_d18) external notMintPaused

从 FXS 中铸造 FRAX。仅在抵押比率为 0 时有效。

redeem1t1FRAX

redeem1t1FRAX(uint256 FRAX_amount) external notRedeemPaused

从 FRAX 赎回抵押品。仅在抵押比率为 1 时有效。必须在之后调用 collectionRedemption() 以进行收集。

redeemFractionalFRAX

redeemFractionalFRAX(uint256 FRAX_amount) external notRedeemPaused

Redeem collateral and FXS from FRAX. Valid only when the collateral ratio is between 0 and 1. Must call collectionRedemption() later to collect.

redeemAlgorithmicFRAX

redeemAlgorithmicFRAX(uint256 FRAX_amount) external notRedeemPaused

Redeem FXS from FRAX. Valid only when the collateral ratio is 0. Must call collectionRedemption() later to collect.

collectRedemption

collectRedemption() public

After a redemption happens, transfer the newly minted FXS and owed collateral from this pool contract to the user. Redemption is split into two functions to prevent flash loans from being able to take out FRAX / collateral from the system, use an AMM to trade the new price, and then mint back into the system.

buyBackFXS

buyBackFXS(uint256 FXS_amount) external

Function can be called by an FXS holder to have the protocol buy back FXS with excess collateral value from a desired collateral pool. This can also happen if the collateral ratio > 1

recollateralizeAmount

recollateralizeAmount() public view returns (uint256 recollateralization_left)

When the protocol is recollateralizing, we need to give a discount of FXS to hit the new CR target. Returns value of collateral that must increase to reach recollateralization target (if 0 means no recollateralization)

recollateralizeFrax

recollateralizeFrax(uint256 collateral_amount_d18) public

Thus, if the target collateral ratio is higher than the actual value of collateral, minters get FXS for adding collateral. This function simply rewards anyone that sends collateral to a pool with the same amount of FXS + .75%. Anyone can call this function to recollateralize the protocol and take the hardcoded .75% arb opportunity

Restricted Functions

toggleMinting

toggleMinting() external onlyMintPauser

Toggle the ability to mint.

toggleRedeeming

toggleRedeeming() external onlyRedeemPauser

Toggle the ability to redeem.

toggleBuyBack

toggleBuyBack() external onlyBuyBackPauser

Toggle the ability to buyback.

setPoolCeiling

setPoolCeiling(uint256 new_ceiling) external onlyByOwnerOrGovernance

Set the pool_ceiling, which is the total units of collateral that the pool contract can hold.

setOracle

setOracle(address new_oracle) external onlyByOwnerOrGovernance

Set the oracle_address.

setCollateralAdd

setCollateralAdd(address _collateral_address) external onlyByOwnerOrGovernance

Set the collateral_address.

addOwner

addOwner(address owner_address) external onlyByOwnerOrGovernance

Add an address to the array of owners.

removeOwner

removeOwner(address owner_address) external onlyByOwnerOrGovernance

Remove an owner from the owners array.

Modifiers

onlyByOwnerOrGovernance

onlyByOwnerOrGovernance()

Restrict actions to the governance contract or the owner(s).

notRedeemPaused

notRedeemPaused()

Ensure redemption is not paused.

notMintPaused

notMintPaused()

Ensure minting is not paused.

⚠️ 本页面仅适用于非常早期的流动性挖矿池，尽管许多新农场共享功能和名称 ⚠️

基于 Synthetix 的质押合约：

https://docs.synthetix.io/incentives/

描述

Frax 用户能够在选定的 Uniswap 流动性池代币中质押，以换取 FXS 奖励。未来的池和激励措施可以由治理添加。

部署

流动性池代币（LP）

Uniswap FRAX/WETH LP: 0xFD0A40Bc83C5faE4203DEc7e5929B446b07d1C76

Uniswap FRAX/USDC LP: 0x97C4adc5d28A86f9470C70DD91Dc6CC2f20d2d4D

Uniswap FRAX/FXS LP: 0xE1573B9D29e2183B1AF0e743Dc2754979A40D237

Uniswap FXS/WETH LP: 0xecBa967D84fCF0405F6b32Bc45F4d36BfDBB2E81

质押合约

Uniswap FRAX/WETH staking: 0xD875628B942f8970De3CcEaf6417005F68540d4f

Uniswap FRAX/USDC staking: 0xa29367a3f057F3191b62bd4055845a33411892b6

Uniswap FRAX/FXS staking: 0xda2c338350a0E59Ce71CDCED9679A3A590Dd9BEC

Uniswap FXS/WETH staking (deprecated): 0xDc65f3514725206Dd83A8843AAE2aC3D99771C88

状态变量

FRAXStablecoin private FRAX

FRAX合约的实例。

ERC20 public rewardsToken

奖励代币的实例。

ERC20 public stakingToken

质押代币的实例。

uint256 public periodFinish

质押周期结束的区块。

uint256 public rewardRate

每秒最大奖励。

uint256 public rewardsDuration

奖励周期，以秒为单位。

uint256 public lastUpdateTime

合约最后一次更新或状态改变的时间戳。

uint256 public rewardPerTokenStored

当前周期内每个代币的实际奖励。

uint256 public locked_stake_max_multiplier

锁定质押的最大提升/权重倍增器。

uint256 public locked_stake_time_for_max_multiplier

达到 locked_stake_max_multiplier 的时间（以秒为单位）。

uint256 public locked_stake_min_time

锁定质押的最低质押时间（以秒为单位）。

string public locked_stake_min_time_str

字符串版本为 locked_stake_min_time_str。

uint256 public cr_boost_max_multiplier

来自抵押比例（CR）的最大提升/权重乘数。这适用于锁定和未锁定的质押。

mapping(address => uint256) public userRewardPerTokenPaid

记录某个地址上次领取奖励的时间。如果他们在之后的某个时间领取奖励，他们将获得正确的奖励金额，因为 rewardPerTokenStored 是在不断变化的。

mapping(address => uint256) public rewards

给定地址的当前奖励余额。

uint256 private _staking_token_supply

质押的池代币总量。

uint256 private _staking_token_boosted_supply

考虑了时间和CR加成的 _staking_token_supply。这不是实际的池代币数量，而是一个“加权分母”。

mapping(address => uint256) private _balances

给定地址质押的池代币余额。

mapping(address => uint256) private _boosted_balances

考虑了时间和CR加成的 _balances，类似于 _staking_token_boosted_supply。

mapping(address => LockedStake[]) private lockedStakes

提供给定地址的锁定质押批次列表。

struct LockedStake {
        bytes32 kek_id;
        uint256 start_timestamp;
        uint256 amount;
        uint256 ending_timestamp;
        uint256 multiplier; // 6 decimals of precision. 1x = 1000000
    }

一个锁定的质押“批次”。

查看函数

totalSupply

totalSupply() external override view returns (uint256)

获取质押的流动性池代币总数。

stakingMultiplier

stakingMultiplier(uint256 secs) public view returns (uint256)

根据质押的秒数获取基于时间的质押倍增器。

crBoostMultiplier

crBoostMultiplier() public view returns (uint256)

获取基于抵押比率（CR）的质押倍增器。

stakingTokenSupply

stakingTokenSupply() external view returns (uint256)

与 totalSupply() 相同。

balanceOf

balanceOf(address account) external override view returns (uint256)

获取给定账户质押的流动性池代币数量。

boostedBalanceOf

boostedBalanceOf(address account) external view returns (uint256)

获取给定账户质押的流动性池代币的加成数量。加成考虑了抵押比率（CR）和基于时间的倍增器。

lockedBalanceOf

lockedBalanceOf(address account) public view returns (uint256)

获取给定账户锁定的质押流动性池代币数量。

unlockedBalanceOf

unlockedBalanceOf(address account) external view returns (uint256)

获取给定账户解锁的/自由的质押流动性池代币数量。

lockedStakesOf

lockedStakesOf(address account) external view returns (LockedStake[] memory)

返回给定账户的所有锁定质押“批次”的数组。

stakingDecimals

stakingDecimals() external view returns (uint256)

返回 stakingToken 的小数位数 (decimals())。

rewardsFor

rewardsFor(address account) external view returns (uint256)

获取给定账户的 FXS 奖励数量。

lastTimeRewardApplicable

lastTimeRewardApplicable() public override view returns (uint256)

在内部用于跟踪 rewardPerTokenStored。

rewardPerToken

rewardPerToken() public override view returns (uint256)

当前质押流动性池代币的 FXS 奖励数量。

earned

earned(address account) public override view returns (uint256)

返回给定账户的未领取 FXS 奖励数量。

getRewardForDuration

getRewardForDuration() external override view returns (uint256)

计算给定奖励持续时间（rewardsDuration）内的 FXS 奖励。

变更函数

stake

stake(uint256 amount) external override nonReentrant notPaused updateReward(msg.sender)

质押一些 Uniswap 流动性池代币。这些代币可以自由提取，仅受 crBoostMultiplier() 的加成。

stakeLocked

stakeLocked(uint256 amount, uint256 secs) external nonReentrant notPaused updateReward(msg.sender)

质押一些 Uniswap 流动性池代币，并将其锁定指定的秒数。作为锁定代币的回报，质押者的基础金额将通过线性时间倍增器进行乘法计算，该倍增器在 secs = 0 时为 1，在 locked_stake_time_for_max_multiplier 时为 locked_stake_max_multiplier。质押的价值还会乘以 crBoostMultiplier()。这个乘积值会被加到 _boosted_balances 中，并在计算质押者在给定奖励周期中的份额时作为加权金额。

withdraw

withdraw(uint256 amount) public override nonReentrant updateReward(msg.sender)

提取解锁的 Uniswap 流动性池代币。

withdrawLocked

withdrawLocked(bytes32 kek_id) public nonReentrant updateReward(msg.sender)

提取锁定的 Uniswap 流动性池代币。如果特定 kek_id 质押批次的质押时间尚未到期，则会失败。

getReward

getReward() public override nonReentrant updateReward(msg.sender)

零取 FXS 奖励。

exit

exit() external override

提取所有解锁的池代币并领取奖励。

renewIfApplicable

renewIfApplicable() external

如果奖励周期的结束时间已到，则续期奖励周期。调用 retroCatchUp()。

retroCatchUp

retroCatchUp() internal

续期并更新 periodFinish、rewardPerTokenStored 和 lastUpdateTime。

受限函数

notifyRewardAmount

notifyRewardAmount(uint256 reward) external override onlyRewardsDistribution updateReward(address(0))

通过事件 RewardAdded 通知人们奖励正在被更改。

recoverERC20

recoverERC20(address tokenAddress, uint256 tokenAmount) external onlyOwner

添加此功能以支持从其他系统恢复流动性池奖励，并将其分发给持有者。

setRewardsDuration

setRewardsDuration(uint256 _rewardsDuration) external onlyOwner

设置奖励周期的持续时间。

setLockedStakeMaxMultiplierUpdated

setLockedStakeMaxMultiplierUpdated(uint256 _locked_stake_max_multiplier) external onlyOwner

设置锁定质押的最大倍增器。

setLockedStakeTimeForMaxMultiplier

setLockedStakeTimeForMaxMultiplier(uint256 _locked_stake_time_for_max_multiplier) external onlyOwner

设置锁定质押倍增器达到 locked_stake_max_multiplier 的时间（以秒为单位）。

setLockedStakeMinTime

setLockedStakeMinTime(uint256 _locked_stake_min_time) external onlyOwner

设置锁定质押的最短时间（以秒为单位）。

setMaxCRBoostMultiplier

setMaxCRBoostMultiplier(uint256 _max_boost_multiplier) external onlyOwner

initializeDefault

initializeDefault() external onlyOwner

仅在合约生命周期中调用一次。初始化 lastUpdateTime 和 periodFinish。

修饰符

updateReward

updateReward(address account)

调用 retroCatchUp()（如果适用），否则同步 rewardPerTokenStored 和 lastUpdateTime。此外，还会同步提供账户的奖励和 userRewardPerTokenPaid。

这一控制器将FRAX引入诸如Compound或CREAM等货币市场，允许任何人通过支付利息借入FRAX。进入货币市场的FRAX不会进入流通，除非被借款人超额抵押。因此该AMO不会降低直接抵押率（CR）。这一控制器允许协议直接贷出FRAX，并通过现有货币市场从借款人那里赚取利息。实际上，这一AMO将MakerDAO的整个协议写入了单份合约。借贷产生的现金流可用于回购和销毁FXS（类似于MakerDAO从稳定费中销毁MKR的方式）。从本质上讲，Lending AMO通过支付货币市场设定的利率，为FRAX进入流通创造了一个新的途径。

AMO 规格

1. 非抵押化—铸造的FRAX进入货币市场。直接铸造的FRAX数量不会降低抵押率，因为所有借来的FRAX都是过度抵押的。

2. 市场操作—从借款人那里获得利息收入。

3. 再抵押—将铸造的FRAX撤出货币市场。

4. FXS1559—在CR上累积超额价值的每日利息收入(目前正在开发中)。

调整利率和资本效

AMO可以通过铸造更多的FRAX(降低利率)或移除FRAX并烧掉它(提高利率)来提高或降低借贷FRAX的利率。这是一个强大的经济杠杆，因为它改变了所有贷款人借贷FRAX的成本。这渗透到所有市场，因为AMO可以以一个具体的目标比率铸造和移除FRAX。这也使得协议能够有效地根据希望瞄准的方向来调节做空FRAX的成本。

此外，与其他稳定币相比，该协议的部分算法设计允许不匹配的借款利率。因为Frax协议可以随意铸造Frax稳定币，直到市场将其定价为1$。这意味着与其他协议相比，创造货币的成本是最小的。如果协议决定在贷款利率上比其他稳定币更具优势，这将为借贷创造无与伦比的、同类中最好的利率。因此，AMO策略可以优化何时降低利率的条件(也依然低于其他稳定币的利率)，也可以在相反的条件下提高利率。具有讽刺意味的是，基于自己代币的贷款利率是其他稳定币项目难以控制的东西。Frax通过AMO可以完全控制这些资产。

前置说明

Frax 治理主要基于 Compound/OpenZeppelin Governor 合约。关于 Governor 提案的生命周期，可参考此处：OpenZeppelin Governance 文档。

Frax 治理

Frax 治理是一个双 Governor 系统，包含 FraxGovernorAlpha 和 FraxGovernorOmega。Alpha 和 Omega 有不同的用途和配置。

FraxGovernorOmega

FraxGovernorOmega 对底层安全库的控制有限。只有 Frax 团队和安全库所有者可以创建 Omega 提案。每个提案与安全库交易一一对应。Omega 被配置为额外的安全库所有者，必须批准安全库交易，安全库所有者才能执行该交易。这是通过自定义 Gnosis Safe Guard 实现的（https://docs.safe.global/safe-core-protocol/hooks）。

Omega 具有非常短的投票延迟、短的投票期和低的法定人数要求。安全库所有者只能在获得该安全库交易的阈值签名后将提案添加到 Omega。例如，如果一个安全库是 3/6（5 个所有者 + Omega），则必须有 3 个所有者签名才能将提案放入 Omega。

将提案添加到 Omega 后，它遵循与 Governor 提案相同的生命周期。如果提案通过，Omega 会在安全库上调用 approveHash，任何所有者可以通过 Gnosis Safe 用户界面照常执行该提案。如果提案失败，可以在 Omega 上调用 rejectTransaction 来批准 0 以太的转移。其他所有者可以签名并执行相同的 0 以太转移，这只是递增安全库上的 nonce，从而允许创建新的 Gnosis 交易。

Omega 具有一个称为短路阈值的功能。如果 51% 的 veFXS 总供应量投票支持某个 Omega 提案，该提案将立即成功并可执行。这在特殊情况下很有帮助，例如 Frax 团队需要快速采取行动以保护协议时。

Omega 不能更改其自身的治理参数或更改底层安全库的任何配置。这些值必须通过 FraxGovernorAlpha 进行更改。

FraxGovernorAlpha

FraxGovernorAlpha 对底层安全库拥有完全控制权。任何 veFXS 持有者只要其 veFXS 余额达到或超过提案阈值，就可以创建提案。FraxGovernorAlpha 与 OpenZeppelin Governor 几乎相同。由于其 TimelockController 被配置为安全库上的模块（Gnosis Safe 模块文档），因此它可以对每个 Gnosis Safe 执行任何操作。模块不受 Gnosis Safe Guards 的限制。

Alpha 具有较长的投票延迟、较长的投票期和比 Omega 更高的法定人数要求。一旦 Alpha 提案通过，它必须被排队，并在配置的时间锁定期后才能执行。

veFXS 持有者

veFXS 持有者是系统中最重要的部分。提案的成功与否最终取决于 veFXS 持有者，因为他们直接对提案进行投票。您的 veFXS 余额等于您的投票权。

veFXS 持有者可以将他们的投票权委托给他人。如果某个 veFXS 持有者在其自身的质押和委托质押之间拥有足够的 veFXS 投票权，他们可以通过 FraxGovernorAlpha 提出任何提案。

通过 Alpha，veFXS 持有者可以更换安全库上的所有者、更改 Alpha 或 Omega 的治理参数、修改任何 Frax 智能合约的参数、从流动性池中添加或移除协议拥有的流动性等。veFXS 持有者对整个 Frax 协议拥有最终控制权。

Frax 治理提案生命周期

部署

状态变量

ERC-20 (Inherited)

https://docs.openzeppelin.com/contracts/2.x/api/token/erc20#ERC20

接入控制(Inherited)

https://docs.openzeppelin.com/contracts/3.x/api/access#AccessControl 注意：FRAX 和 FXS 合约没有任何暂停或黑名单控制（包括系统合约）。

关于FRAX

enum PriceChoice { FRAX, FXS }

一个枚举，声明了 FRAX 和 FXS。用于与预言机配合使用。

ChainlinkETHUSDPriceConsumer eth_usd_pricer

用于 Chainlink ETH / USD 交易的实例。与 FRAX / WETH、FXS / WETH、抵押品 / FRAX 和抵押品 / FXS 交易对结合使用，可以计算 FRAX/FXS/抵押品的价格（以美元计）。

uint8 eth_usd_pricer_decimals

Chainlink ETH / USD 交易对价格的小数位数。

UniswapPairOracle fraxEthOracle

FRAX / WETH Uniswap 交易对价格预言机的实例。

UniswapPairOracle fxsEthOracle

FXS / WETH Uniswap 交易对价格预言机的实例。

address[] public owners

拥有特权操作的地址数组。

address governance_address

治理合约的地址。

address public creator_address

合约创建者的地址。

address public timelock_address

时间锁合约的地址。

address public fxs_address

FXS合约的地址。

address public frax_eth_oracle_address

fraxEthOracle 的地址。

address public fxs_eth_oracle_address

fxsEthOracle 的地址。

address public weth_address

标准的Wrapped以太坊（WETH）合约的地址。主网应为 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 for the mainnet.

address public eth_usd_consumer_address

ChainlinkETHUSDPriceConsumer 的地址.

uint256 public genesis_supply

FRAX的创世供应量。应为一个小的非零金额。大部分FRAX供应将来自铸造，但初始需要少量以防止在各种函数中出现除零错误。

address[] frax_pools_array

所有FraxPool 合约地址的数组。

mapping(address => bool) public frax_pools

本质上与frax_pools_array相同，但以映射的形式存在。在诸如globalCollateralValue()等函数中有助于节省gas。

uint256 public global_collateral_ratio

当前所有FraxPool 中FRAX与抵押品的比例。

uint256 public redemption_fee

将FRAX兑换为FXS和/或抵押品的费用。同时也是使用FXS回购多余抵押品的费用。有关使用方法，请参见 FraxPool合约。

uint256 public minting_fee

从FXS和/或抵押品铸造FRAX的费用。有关使用方法，请参见FraxPool合约。

address public DEFAULT_ADMIN_ADDRESS

在构造函数中设置。用于AccessControl。

bytes32 public constant COLLATERAL_RATIO_PAUSER

用于暂停抵押比率的常量。

bool public collateral_ratio_paused

抵押比率是否已暂停。

查看函数

oracle_price

oracle_price(PriceChoice choice) internal view returns (uint256)

获取FRAX或FXS的价格，以美元计算。

frax_price

frax_price() public view returns (uint256)

从FRAX-ETH Chainlink价格预言机返回FRAX的价格。

fxs_price

fxs_price() public view returns (uint256)

从FXS-ETH Chainlink价格预言机返回FXS的价格。

frax_info

frax_info() public view returns (uint256, uint256, uint256, uint256, uint256, uint256, uint256)

返回一些常用的状态变量和计算值。这是为了避免对不同获取函数的重复调用，减少成本。在燃气费用方面，直接返回所有信息并只使用其中的一部分更为经济。

globalCollateralValue

globalCollateralValue() public view returns (uint256)

遍历所有 FRAX 池，计算所有池中抵押物的总价值。这将使用每种抵押物的预言机价格。

公共函数

refreshCollateralRatio

refreshCollateralRatio() public

该函数检查 FRAX 的价格，并在价格不为 $1 时刷新抵押比率。如果价格高于 $1，则比率降低 0.5%。如果价格低于 $1，则比率增加 0.5%。任何人都可以调用该函数来更改比率。此函数每小时只能调用一次。

受限函数

mint

mint(uint256 amount) public virtual onlyByOwnerOrGovernance

internal _mint()的公共实现。

pool_burn_from

pool_burn_from(address b_address, uint256 b_amount) public onlyPools

用户赎回时由池子使用。

pool_mint

pool_mint(address m_address, uint256 m_amount) public onlyPools

这个函数是其他 Frax 池调用以铸造新 FRAX 的。

addPool

addPool(address pool_address) public onlyByOwnerOrGovernance

添加支持的抵押地址，例如 Tether 和 BUSD，必须是 ERC20。

removePool

removePool(address pool_address) public onlyByOwnerOrGovernance

移除一个池子

setOwner

setOwner(address owner_address) public onlyByOwnerOrGovernance

设置合约的管理员。

setFraxStep

setFraxStep(uint256 _new_step) public onlyByOwnerOrGovernance

设置在执行 refreshCollateralRatio() 时，抵押比率将改变的金额。

setPriceTarget

setPriceTarget(uint256 _new_price_target) public onlyByOwnerOrGovernance

设置用于 refreshCollateralRatio() 的价格目标（不影响铸造/赎回）。

setRefreshCooldown

setRefreshCooldown(uint256 _new_cooldown) public onlyByOwnerOrGovernance

设置 refreshCollateralRatio() 的冷却时间。

setRedemptionFee

setRedemptionFee(uint256 red_fee) public onlyByOwnerOrGovernance

设置赎回费用。

setMintingFee

setMintingFee(uint256 min_fee) public onlyByOwnerOrGovernance

设置铸造费用。

setFXSAddress

setFXSAddress(address _fxs_address) public onlyByOwnerOrGovernance

设置 FXS 地址。

setETHUSDOracle

setETHUSDOracle(address _eth_usd_consumer_address) public onlyByOwnerOrGovernance

设置 ETH / USD 预言机地址。

setFRAXEthOracle

setFRAXEthOracle(address _frax_addr, address _weth_address) public onlyByOwnerOrGovernance

设置 FRAX / ETH Uniswap 预言机地址。

setFXSEthOracle

setFXSEthOracle(address _fxs_addr, address _weth_address) public onlyByOwnerOrGovernance

设置 FXS / ETH Uniswap 预言机地址。

toggleCollateralRatio

toggleCollateralRatio() public onlyCollateralRatioPauser 

切换暂停/恢复抵押比例。

事件

FRAXBurned

FRAXBurned(address indexed from, address indexed to, uint256 amount)

当FRAX被销毁时触发，通常是由于池子的赎回。

修饰符

onlyCollateralRatioPauser

onlyCollateralRatioPauser()

限制操作仅限于指定的抵押比例暂停者。

onlyPools

onlyPools()

限制操作仅限于池合约，例如铸造新的 FRAX。

onlyByGovernance

onlyByGovernance()

限制操作仅限于治理合约，例如设置铸造和赎回费用，以及预言机和池地址。

onlyByOwnerOrGovernance

onlyByOwnerOrGovernance()

限制操作仅限于治理合约或所有者账户，例如设置铸造和赎回费用，以及预言机和池地址。

Ethereum Mainnet

Frax Comptrollers

其他多签

Layer Zero

Comptrollers

委托

由于 veFXS 合约的工作原理，如果您锁定更多 FXS 或延长锁定时间，您需要使用 VeFxsVotingDelegation 合约再次委托您的投票权重。

要将委托返回给自己，请调用 delegate() 函数，将您的地址作为受托人。 委托也可以通过签名进行。请参见 delegateBySig() 。

veFXS 投票权重衰减

当您的 veFXS 锁定到期时，您的余额等于您锁定的 FXS 数量。在 Frax 治理中，一旦您的锁定到期，您的投票权重将变为 0。您需要保持活跃的锁定才能在 Frax 治理中拥有投票权重。

智能合约设计

创建 Alpha 提案

1. 前往 https://app.frax.finance/gov/frax

2. 点击“提案”

3. 确保您的投票权重超过提案阈值 在此处检查提案阈值

   1. 在此处检查提案阈值：https://etherscan.io/address/0xe8ab863e629a05c73d6a23b99d37027e3763156e#readContract#F25

   2. 检查您的权重： https://etherscan.io/address/0x6b83c4f3a6729fb7d5e19b720092162df439f567#readContract#F18

4. 填入您的交易数据

5. 提交

分数投票

Frax 治理利用了 ScopeLift 的分数投票： https://github.com/ScopeLift/flexible-voting/blob/master/src/GovernorCountingFractional.sol

这允许用户在赞成/反对/弃权之间分配他们的投票权。它还允许智能合约/保管人根据相对 LP 份额将投票权传递给流动性提供者。

治理配置

为了使 Safe 正确配置为 frxGov，它必须安装 FraxGuard，设置 FraxGovernorOmega 为签名者，安装 FraxGovernorAlpha 的 TimelockController 作为模块，并将 FraxCompatibilityFallbackHandler 设置为 fallbackHandler。可以通过 Alpha 提案以类似方式将 Safes 暂停，方法是移除配置并将其从允许列表中删除。 FraxGovernorOmega 和 FraxGovernorAlpha 使用 OpenZeppelin Governor 及以下扩展：

• GovernorSettings

• GovernorVotesQuorumFraction

• GovernorCountingFractional

此外，Alpha 使用这些治理扩展：

• GovernorTimelockControl

• GovernorPreventLateQuorum

查看它们的配置：

• https://docs.openzeppelin.com/contracts/4.x/api/governance#GovernorVotesQuorumFraction

• https://docs.openzeppelin.com/contracts/4.x/api/governance#GovernorTimelockControl

• https://docs.openzeppelin.com/contracts/4.x/api/governance#GovernorSettings

• https://docs.openzeppelin.com/contracts/4.x/api/governance#GovernorPreventLateQuorum

额外的 Frax 治理特定配置：

以下所有功能必须通过 Alpha 提案调用。

Alpha 和 Omega：

• setVotingDelayBlocks()

• setVeFxsVotingDelegation()

• updateShortCircuitNumerator()

仅限 Omega：

• addToSafeAllowlist()

• removeFromSafeAllowlist()

• addToDelegateCallAllowlist()

• removeFromDelegateCallAllowlist()

• setSafeVotingPeriod()

请参阅 frxGov 代码库以了解每个功能的解释。

请参阅 Gnosis Safe 代码库以查看 Alpha 控制的 Safe 配置。

完整提案流程

Alpha 与 OpenZeppelin Governor 和 GovernorTimelockControl 完全相同。

• 创建提案 - propose()

• 投票 -castVote()

• 如果失败则不执行任何操作

• 如果成功

  • queue()

  • Wait Timelock's minDelay

  • execute()

Omega

• 一个所有者使用 Gnosis Safe 发起 DeFi 交易。这会生成一个事务哈希，标识需要由其他 Safe 所有者批准或拒绝的操作。

• ⅗ 的外部账户（EOA）通过用户界面签署该交易

• 收集到 3 个签名后，任何人都可以调用fraxGovernorOmega.addTransaction(address teamSafe, TxHashArgs calldata args, bytes calldata signatures)开始链上治理。团队有动力这样做，因为他们无法在没有 FraxGovernorOmega 批准的情况下执行任何 Gnosis 交易。

• veFXS 投票者在提案投票窗口内有 2 天的时间进行投票。

• 如果在投票窗口内未达到法定人数，或赞成票多于反对票，任何人都可以调用 execute()。这会在后台调用safe.approveHash() 。它提供了 FraxGovernorOmega 所需的批准，从而允许通过 Gnosis 用户界面执行 Gnosis 交易。

  1. 如果达到了法定人数且反对票多于赞成票，任何人都可以调用 fraxGovernorOmega.rejectTransaction (address teamSafe, uint256 nonce)否决提案。这将导致 FraxGovernorOmega 签署一个具有相同 nonce 的零 ETH 转账 Safe 交易。Safe 所有者可以使用“替换交易”功能在用户界面中签署相同的交易。Safe 所有者可以执行该零 ETH 转账，从而增加 nonce。原始交易将无法执行，因为没有来自 FraxGovernorOmega 的批准，并且 nonce 已经更改，使得原始交易失效。

智能合约签名支持（EIP1271 / EIP712）

背景：https://help.safe.global/en/articles/40783-what-are-signed-messages

Gnosis Safes 可以提供智能合约签名。典型机制包含在 Safe 的 CompatibilityFallbackHandler 中，该机制检查所有者是否满足所需的签名数量，然后 Safe 提供其批准。这个机制对于 frxGov 来说并不充分，因为我们希望 Omega 和所有者共同提供批准，或者仅由 Alpha 提供批准。

为了解决这个问题，我们编写了 FraxCompatibilityFallbackHandler，它仅检查 safe.signedMessages(messageHash)是否被设置。Alpha 和 Omega 都可以使用 SignMessageLib.signMessage()调用此状态的设置器。

攻击与缓解措施

FraxGovernorAlpha 可能被用来创建一个提案，实质上关闭整个 Frax 协议，并将所有协议拥有的流动性归还给 FXS 持有者。我们在 Alpha 上设置了 Timelock 延迟，以应对这种情况。从提案通过到可以执行之间有一天的时间，给予 Frax 用户通过各种流动性池退出协议的机会。

我们还添加了 OpenZeppelin Governor 扩展 GovernorPreventLateQuorum。如果提案在投票期末期达到法定人数，投票期将延长 2 天。这可以阻止恶意用户在最后一刻投票支持恶意提案，为社区在这种情况下提供反应的时间。

我们还创建了 frxEth 赎回队列，以允许用户在恶意行为者获得 51% veFXS 投票权并通过提案无限铸造 frxEth 以试图盗取财库时退出 frxEth。

技术讨论

为了符合 ERC5805 标准，实现合约必须实现多个函数，包括getPastTotalSupply(uint256 timepoint) external view returns (uint256)。我们在治理合约中使用时间戳，但这个函数是唯一的例外，它必须接受 block.number。遗憾的是，veFXS.totalSupply(timestamp)对历史值无效，因此我们必须使用 veFXS.totalSupplyAt(block.number)。

这也影响法定人数的计算。通常法定人数是根据投票开始的时间戳（快照）计算的。我们通过使 $votingDelayBlocks值可由治理配置，允许类似功能，从而反映时间戳功能。

代码库和合约地址

代码库

https://github.com/FraxFinance/frax-governance

合约地址

• VeFxsVotingDelegation: https://etherscan.io/address/0x6b83c4f3a6729fb7d5e19b720092162df439f567

• FraxGovernorAlpha: https://etherscan.io/address/0xe8Ab863E629a05c73D6a23b99d37027E3763156e

• FraxGovernorAlphaTimelock: https://etherscan.io/address/0x821794E69d2831975a11f80E8092c682D5Ec8F83

• FraxGovernorOmega: https://etherscan.io/address/0x953791D7C5ac8Ce5fb23BBBF88963DA37a95FE7a

• FraxGuard: https://etherscan.io/address/0xed53eb15b2011395A7353e076024CBC9F19481D0

• FraxCompatibilityFallbackHandler: https://etherscan.io/address/0x3FeFB779d737aCEa272686eA6E174ebF4273F973

Frax去中心化比率(DR)是去中心化抵押品价值与由这些资产支持/可赎回的稳定币供应总量的比率。具有过多链下风险的抵押品(如法币、证券和黄金/石油等托管资产)被视为0%去中心化。DR检查了协议所要求的抵押品的基本组成部分，而不仅仅是其系统合约中的内容。DR是一个递归函数，用于发现每个资产的底层值。

例如，FRAX3CRV LP是50% FRAX，所以移除它，因为你不能用自己的代币支撑自己。另一半是3CRV，即33% USDC, 33% USDT和33% DAI。DAI本身大约是60%的法币。所以每1美元的FRAX3CRV LP只有大约0.066美元(1美元x 0.5 * 0.33 * 0.4)是属于去中心化来源的价值。

相比之下，以太坊以及CVX和CRV等奖励代币被视为100%去中心化。通过Lending AMOs铸造的FRAX也被认为是去中心化的，因为借款人通过加密sOHM、RGT等过度抵押来换取他们的贷款。这也是DAI的金库给它高DR的原因。

DR是一种广义算法，可用于计算任何稳定币的过度链下风险。其他稳定币，如LUSD，更容易计算：它们的DR是100%。FEI的DR大约是90%。

有关支持 FRAX 的资产列表，请阅读 .。

Uniswap v3的AMM算法的关键创新允许做市商在特定价格区间之间部署流动性，支持稳定币对稳定币池子(例如FRAX-USDC)在紧紧锚定的情况下积累极深的流动性。与Uniswap v2相比，Uniswap v3的区间订单集中了流动性，而不是分散在无限的价格范围内。

Uniswap v3流动性AMO通过向其他稳定币提供针对FRAX的流动性，使FRAX和抵押品发挥作用。由于AMO能够进入Uni v3上的任何位置并铸造FRAX，因此它允许扩展到Uni v3上的任何其他稳定币以及后续的不稳定抵押品。此外，可以定期调用 collectFees() 函数，将AMO利润分配给超额抵押品的市场操作。

UniV3LiquidityAMO (已弃用):

AMO 说明

1. 减少抵押 — 将闲置抵押资产和新铸造的FRAX存入到Uni v3 池子。

2. 市场操作 — 累积Uni v3交易费用和抵押品类型之间的互换。

3. 再抵押 — 从Uni v3池子中取出并燃烧FRAX并返还USDC以增加抵押率。

4. FXS1559 — 在抵押率之上积累每日交易费用。

衍生

请注意，实际实现使用价格的平方根，因为它节省了计算tick内交换的平方根操作，从而有助于防止舍入错误。

⚠️ 此特定 AMO 已弃用，但其基本原理（Curve/Convex 协议拥有的流动性以实现挂钩稳定性和协议收入）和数学仍被新版本 AMO 使用。请参见 V3 AMO ⚠️

曲线 AMO 使 FRAX 和 USDC 抵押品得以利用，为协议提供流动性并收紧挂钩。Frax 已部署自己的 。这意味着 Frax 部署者地址拥有其曲线池的管理权限。这允许曲线 AMO 控制器为 FXS 持有者设置和收取管理费用以及执行各种未来功能。协议可以将闲置的 USDC 抵押品或新铸造的 FRAX 转移到自己的曲线池中，以创造更多流动性并收紧挂钩，同时赚取交易收入。

CurveAMO (已弃用):

AMO 说明

1. 去抵押化 - 将闲置的抵押品和新铸造的 FRAX 放入 FRAX3CRV 池中。

2. 市场操作 - 累积交易费用、CRV 奖励，并定期重新平衡池。FRAX3CRV LP 代币存入 Yearn crvFRAX 保险库、Stake DAO 和 Convex Finance 以获取额外收益。

3. 再抵押化 - 首先从池中提取多余的 FRAX，然后提取 USDC 以增加 CR。

4. FXS1559 - 每日交易费用和在 CR 以上累积的 LP 价值（目前正在开发中）。

Curve 的稳定交换不变量允许在稳定币交换之间减缓价格波动，前提是储备没有极度失衡，从而近似于线性交换曲线。

在极度失衡的情况下，不变量接近 Uniswap 的常数乘积曲线。

Curve AMO

协议通过找到可在 FRAX 价格跌至抵押率（CR）时提取的 USDC 余额，来计算 AMO 可访问的基础抵押品的数量。由于 FRAX 始终由抵押品支持，价值不低于 CR，因此它的价格不应低于抵押品的实际价值。例如，在 85% 的抵押率下，FRAX 的价格不应低于 0.85 美元。这一计算是评估曲线 AMO 可访问的抵押品数量的最安全、最保守的方法。这使得曲线 AMO 能够铸造 FRAX 并将其放入池中，除了 USDC 抵押品外，还可以收紧挂钩，同时准确了解在 FRAX 打破挂钩时可访问多少抵押品。

此外，AMO 的整体策略允许优化最小 FRAX 供应 Y，使得一次性将 Y 全部出售到一个 TVL 为 Z、放大因子为 A 的曲线池中时，对 FRAX 价格的影响低于 X%，其中 X 是 CR 的带敏感度。换句话说，曲线 AMO 可以将 FRAX+USDC 放入自己的曲线池并控制 TVL。由于当 FRAX 价格下跌超过 1 美分低于 1 美元时，CR 会再抵押化，这意味着可以在 FRAX 价格下滑 1% 之前，直接在曲线池中出售一定价值的 FRAX。协议可以在开放市场上流通至少该数量的算法 FRAX，因为将该数量的全部一次性销售到曲线池的 TVL 中不会对价格造成足够影响，从而导致 CR 移动。当考虑到曲线的稳定币优化曲线时，这些数量非常大且令人印象深刻。例如，一个 TVL 为 3.3 亿的 FRAX3Pool（假设基础 3Pool 平衡）可以支持至少 3920 万美元的 FRAX 卖单，而不会使价格波动超过 1 美分。如果 CR 带为 1%，那么协议至少应该在开放市场上有 3920 万算法 FRAX。

上述策略是一种极为强大的市场操作，数学上可以创造出一个算法 FRAX 的底线，该底线在不打破挂钩的情况下可以流通。

此外，Curve 为选择的池中的流动性提供者分配 CRV 代币作为奖励（称为计量奖励）。由于 Frax 协议可能是 FRAX3CRV 池的最大流动性提供者，因此可以将其所有的 FRAX3CRV LP 代币分配到 Curve 计量中，以赚取可观的回报。存放在曲线 AMO 中的 CRV 代币可以用来投票参与未来的 Curve DAO 治理，由 FXS 持有者控制。这基本上意味着，协议越多地利用流动性进入自己的曲线池，它在 Curve 协议中拥有和控制的份额就越多，来自所赚取的 CRV 奖励。曲线 AMO 的长期效应是 Frax 可能成为 Curve 自身的大型治理参与者。

智能合约

iterate() 该函数计算在 FRAX 价格跌至 CR 时，元池中 FRAX 和 3CRV 的余额，假设这是最坏的情况。首先，该函数获取元池的当前实时余额，并模拟一个外部套利者将当前元池中 10% 的 FRAX 进行交换，直到所给出的价格等于（或接近）CR，随之交换相应数量的 3CRV。这模拟了 FRAX 在开放市场价格跌至 CR 的情况，元池通常提供的 1:1 兑换被套利者利用，直到在其他地方以 CR 价格购买 FRAX 以获利的机会消失。第 282 行是检查 FRAX 价格的具体位置。

然后，元池检查在该最坏情况下，其 LP 代币可以提取的 FRAX 和 3CRV 数量。两者之间的比例通常在可提取的 FRAX 与可提取的 3CRV 之间大约是 10 比 1。为了对协议的抵押品数量进行会计，它将每个可提取的 3CRV 以基础抵押品价值（即可赎回的 USDC 价值）进行估值，每个 FRAX 则以抵押率进行估值。由于协议在正常情况下并不会实际将如此多的 FRAX 投放流通，这实际上是对其在 USDC 方面的抵押品数量的高度保守估计。

要检查在其他价格下曲线 AMO 应负担的储备情况，可以通过设置 custom_floor在本地测试中简单调整 fraxFloor() 的值。

⚠️ 此 AMO 已弃用。其许多功能已迁移至 V3 AMO ⚠️

Collateral Investor AMO 将闲置的 USDC 抵押品转移到一些提供可靠收益的 DeFi 协议中。目前集成的协议包括：Aave、Compound 和 Yearn。更多协议可以通过治理添加。该 AMO 的主要要求是能够在发生大规模 FRAX 赎回时，立即提取投资的抵押品，不需要等待期。能够随时立即提取的抵押品不会被视为降低协议的抵押率（CR），因为这些资金始终可以随时供协议使用。然而，规范中的去抵押化功能从投资中提取抵押品，优先提取那些有时间延迟的取款（当前没有，并且目前没有计划引入这样的延迟）。

任何超过 CR 的投资收入都通过 FXS1559 被销毁。

FraxPoolInvestorForV2（已弃用）地址：

AMO 规范

1. 去抵押化 - 将闲置的抵押品投入到各种产生收益的协议中。无法立即提取的投资会降低 CR 计算。像 Yearn USDC v2 和 Compound 这样可以随时以 1:1 比例提取的投资不会被视为降低 CR。

2. 市场操作 - 在 CR 水平上复利投资。

3. 再抵押化 - 从保险库中提取投资，释放用于赎回的抵押品。

4. FXS1559 - 每天来自超出 CR 的投资收入。

当 IORB 预言机报告高利率时，FRAX V3 会使用现实世界资产（RWA）策略。FRAX V3 仅使用那些收益接近 IORB 利率且几乎没有期限风险的 RWA。因此，除非通过 frxGov 过程进行变更，目前仅考虑以下资产：

1. 短期美国国债

2. 联邦储备隔夜回购协议

3. 存入联邦储备银行主账户的美元

4. 选定的货币市场共同基金的股份

FRAX V3 的合作托管方主要集中于上述资产。RWA 合作伙伴必须每月至少一次报告持有 FRAX V3 资产时所采用的托管、经纪、银行和信托安排。

FIP-277 将 FinresPBC 作为 FRAX V3 的首个 RWA 合作伙伴。FinresPBC 将专注于确保“现金等价物”低风险 RWA，并优化 sFRAX 抵押金库的 IORB 利率收益。

通过 frxGov 治理投票，可以引入额外的 RWA 合作伙伴。

FPIS代币分配（总供应量100,000,000 FPIS）

⚠️ 剩余的Frax和FPI国库中的代币将根据逐步淘汰计划被销毁，且不符合2.5 : 1转换为FXS的资格。因此，总供应量预计将减少到约4100万个合格的FPIS。⚠️

30% Frax Finance国库 30,000,000

FXS投票者在治理中完全控制这些代币的分配方式。 Frax Finance国库（多重签名）： 0x9AA7Db8E488eE3ffCC9CdFD4f2EaECC8ABeDCB48

25% FPI协议国库 25,000,000

FPIS投票者完全控制这些代币的分配方式。 FPI协议国库（多重签名）：0x5181C3c36bD52F783e6E1771d80b1e3AdCB36019

10% veFPIS发行 10,000,000

⚠️ 根据逐步淘汰计划，veFPIS的发行在2024年7月初停止。剩余的代币存储在FPI协议国库的多重签名中，计划被销毁。⚠️

FPIS按照每年减半的发行计划分配给veFPIS质押者，始于2023年2月20日下午4点（太平洋标准时间）。第一年发行500万FPIS，第二年发行225万FPIS，第三年发行112.5万FPIS，等等。当FPI稳定币的抵押率超过治理设定的某一水平时，该发行将通过额外的FPI协议利润分配给veFPIS持有者进行补充。

25% 核心开发者与贡献者国库 25,000,000

自2022年2月20日起，按4年锁定期分配，与空投起始时间同步，并有6个月的悬崖期。分配在每月20日左右进行。

FPI核心贡献者（以太坊）： 0x708695db8dF61e646571E78b9b3e2BAd7D6c42E3

FPI核心贡献者（Fraxtal）：0xe0EefF64eAB79C78221f9571BBDA70eEe65620ce

10% 2022年2月空投给FXS持有者 10,000,000

快照时间为2022年2月20日11:59:59 UTC，直到2022年8月20日11:59:59 UTC可领取。大约459,074.53 FPIS未被认领，并已恢复到FPI管理多重签名处，地址为 0x6A7efa964Cf6D9Ab3BC3c47eBdDB853A8853C502

FPISAirgrabber： 0x3266724e4e58E5891Eb30E6d329bA119A192483c

⚠️ FPIS 将于 2028 年 3 月 22 日逐步淘汰，之后可转换为 FXS ⚠️

Frax 价格指数股份（FPIS）是 Frax 价格指数（FPI）稳定币的治理代币。FPIS 与 Frax 股份（FXS）代币相互关联，因此被称为“链接治理代币”。FXS 和 FPIS 在经济上通过程序化方式相互关联，类似于一层链代币与其网络上的去中心化应用代币之间的关系。

FXS 是 Frax 生态系统的基础代币，因此无论 FRAX 和 FPI 稳定币如何增长，FXS 都将始终增值。FXS 的增值与整个 Frax 经济体的整体增长成正比，类似于 ETH 从所有支付以获得 Ethereum 区块空间的去中心化应用经济活动的总和中捕获价值。FPIS 特别跟踪 FPI 的增长，类似于特定的 ERC20 代币跟踪自身协议的增长，而不是整个 L1 经济体。如果您认为 Frax 经济体整体被低估，则应增加对 FXS 的持有。如果您认为人们特别低估了 FPI 的增长，则应增加对 FPIS 的持有。这与您是否投资于特定项目或投资于 ETH 是相同的动态。如果您认为 ETH 经济体整体被低估，您会购买更多 ETH。但如果您认为某个特定项目的增长速度超过整个经济的总和，您就会希望拥有该特定代币，而不是 L1 代币。

Frax 质押比例（FCR）是直接支持 FPI 代币的 FRAX 稳定币的比例。FCR 在向 FPIS 和 veFPIS 代币持有者分配价值之前直接计算。FCR 特别用于系统的 FXS 价值捕获。 每当超出 FPI 资产负债表的价值分配回 FPIS 代币持有者时，它将经过一个“FCR 合约”或函数调用，计算 FPI 使用的“FRAX 抵押品”数量。 本质上，任何超出通货膨胀率的经济生产力都归 FPIS 持有者所有。由于 FPI 与一篮子消费品挂钩，因此它代表了对该篮子价值的索赔。协议超出该篮子的价值将被 FPIS 持有者捕获。 FPIS 的供应量在创世时初始设定为 1 亿个代币（分配见此处），但预计到 2028 年 3 月 22 日实际可转换为 FXS 的代币将减少到大约 4100 万个（比例为 2.5 : 1）。

*本文档中关于价值捕获的讨论不构成投资建议。治理代币机制仅用于描述 Frax/FPI 系统的运作方式。*

FRAX 是一种与美元挂钩的稳定币，使用“算法市场操作”（AMO）智能合约和无需许可、非托管的子协议作为稳定机制。三个主要的内部子协议用于维持稳定性：Fraxlend，一个去中心化借贷市场；Frax Bonds，用于维持锚定稳定的债券；以及具有特殊功能的自动做市商（AMM）Fraxswap。主要的外部稳定机制包括 Curve 和 Uniswap V3 池。通过治理，FRAX 可以轻松集成未来发现的稳定机制，添加新的子协议和 AMO。

FRAX V3 的扩展引入了以下概念和基准：

1. FRAX 的完全外源抵押：协议将尝试始终保持 ≥100% 的抵押率（CR）。从 V3 开始并通过 FIP188 提案，Frax 协议将努力通过 AMO 智能合约和由 Frax 治理模块（frxGov）批准的合作实体持有的某些现实资产，确保所有 FRAX 稳定币至少保持 100% 的抵押率。FRAX CR 的计算方法是基于 FRAX 资产负债表上的外源抵押物的价值。稳定币的隔离资产负债表是用于稳定 FRAX 稳定币的市场价格的抵押品。

2. 主权美元挂钩：一旦 FRAX 稳定币达到 100% 抵押率，其锚定将通过 Chainlink 预言机和治理批准的参考利率与美元挂钩。如果 FRAX CR 下降，AMO 和治理将尝试将 CR 恢复到 100%，并保持 FRAX 的价格在 $1.000，无论其他资产如 USDC、USDT 或 DAI 的价格如何。

3. IORB 预言机：FRAX V3 智能合约将联邦储备银行的储备余额利息（IORB）利率用于某些协议功能，如 sFRAX 质押收益。随着 IORB 预言机利率的上升，Frax 协议的 AMO 策略将反应并通过国库券、逆回购合约和/或存放在联邦储备银行的美元（这些存款支付 IORB 利率）来高度抵押 FRAX。当 IORB 预言机报告低/下降的利率时，AMO 策略将开始用链上去中心化资产和 Fraxlend 中的超额抵押贷款重新平衡 FRAX 的抵押品。

4. 消除多签名信任假设：FRAX V3 智能合约最终将完全通过 frxGov 模块和社区的 Snapshot 投票在链上运行。

5. Frax Bonds（FXBs）：债券将以低于面值的价格发行，并设定各种到期日期，以吸纳/锁定 FRAX 并帮助稳定其锚定价格。

6. 不可赎回性：FRAX 稳定币是不可赎回的，类似于无法赎回特定资产的法定货币。持有 FRAX 稳定币并不保证持有人有权在特定时间将其兑换为任何特定金融工具或代币。Frax 协议的唯一功能是通过 AMO 合约、现实资产（RWA）和 frxGov 的治理行动，利用美元预言机作为参考，将 FRAX 价格稳定在 $1.000。

7. Fraxtal：一个基于 Optimism 技术的模块化汇总区块链（L2）。frxETH 将用作 gas 代币。包括区块空间奖励（称为 Flox / FXTL 点数），用于奖励在网络上花费 gas 和与智能合约交互的用户和开发者。

*FRAX V3 的部署是一个逐步和迭代的过程。随着智能合约的部署，其地址将被添加到相应的文档部分。本文件讨论的所有功能目前尚未全部部署。*

⚠️ veFPIS现在已解锁，收益停止，依据Frax Singularity路线图第一部分。鼓励用户迁移到Fraxtal上的FPIS锁仓，以便最终将FPIS转换为FXS ⚠️

veFPIS是FPIS治理代币的更新版和锁定+收益系统。与veFXS类似，用户可以将FPIS锁定最长达4年，获得四倍的veFPIS（例如，锁定100 FPIS 4年将返回400 veFPIS）。veFPIS不是可转让的代币，也不在流动市场上交易。它类似于一个基于账户的积分系统，表示钱包中锁定的FXS代币在协议内的锁定期限。

随着代币接近锁定到期，veFPIS余额线性减少，接近于零剩余锁定时间时每1 FPIS对应1 veFPIS。

双白名单和模块化功能

veFPIS 有一个额外针对智能合约的“DeFi白名单”，为质押系统添加了模块化功能。治理程序可以批准每个新的DeFi功能白名单。例如，治理程序可以将清算合约列入白名单，如果质押者从其veFPIS余额中借款，则允许清算其基础FPIS代币。在为每个用户解锁新功能之前，用户必须批准每个DeFi白名单合约来使用他们的FPIS代币。这使得质押系统保持完全免信任，因此没有额外的逻辑可以在没有质押人批准的情况下访问质押人的veFPIS余额，从而保持每个钱包地址的模块化选项。该系统允许治理向veFPIS质押添加新的迭代功能，如“削减条件”和通过添加智能合约来获得更高收益的新方法(如果用户选择加入，可能会被削减)，允许veFPIS持有者投票决定CPI指标权重，借出FPI，或控制流动性部署等等。

动机

可替代且可扩展的多链桥接解决方案。

好处

• 桥接过程在几分钟内完成。

• 灵活选择源链或目标链。

风险

• 信任委托给LayerZero和Stargate

  • LayerZero端点

  • LayerZero和Horizen DVN。

  • Stargate用户界面

OFTs（可桥接代币）

Frax资产在Fraxtal、Ethereum和Arbitrum以外的链上被表示为OFTs（由 LayerZero定义）。OFT与ERC20的功能相同，此外还支持通过LayerZero协议进行桥接。

可用的Frax OFTs

• FRAX

• sFRAX

• frxETH

• sfrxETH

• FXS

• FPI

Legacy与可升级OFTs

在与LayerZero的初始部署中，LayerZero团队在多个链上部署了Frax资产作为固定合约。初始部署后，Frax团队承担了额外的部署责任，并目前将OFTs作为可升级的透明代理进行部署（合约经过审计，代码库链接）。

Legacy 与可升级OFTs在各链上保持相同的资产地址。

所有具有桥接权限的OFTs均由每个相应链上的3/6多签管理。

过程

• 通过Stargate用户界面进行桥接（链接）。

• 直接与LayerZero进行桥接。

npm install @fraxfinance/layerzero-v2-upgradeable

import { OptionsBuilder } from "@fraxfinance/layerzero-v2-upgradeable/oapp/contracts/oapp/libs/OptionsBuilder.sol";
import { SendParam, MessagingFee, IOFT } from "@fraxfinance/layerzero-v2-upgradeable/oapp/contracts/oft/interfaces/IOFT.sol";

uint256 amount = 1e18;
// Upgradeable FRAX - Bridging FROM Mode
address oft = 0x80eede496655fb9047dd39d9f418d5483ed600df; 
// Ethereum - choose destination EID from https://github.com/FraxFinance/frax-oft-upgradeable/blob/master/scripts/L0Config.json
uint32 dstEid = 30101;

bytes memory options = OptionsBuilder.newOptions();
SendParam memory sendParam = SendParam({
        dstEid: dstEid,
        to: bytes32(uint256(uint160(msg.sender))),
        amountLD: amount,
        minAmountLD: amount,
        extraOptions: options,
        composeMsg: '',
        oftCmd: ''
});
MessagingFee memory fee = IOFT(_oft).quoteSend(sendParam, false);
IOFT(_oft).send{value: fee.nativeFee}(
    sendParam,
    fee,
    payable(msg.sender)
);

合约 & 地址

Admin

• ProxyAdmin: 0x223a681fc5c5522c85c96157c0efa18cd6c5405c

• Msigs (links to gnosis safe)

  • Ethereum

  • Blast

  • Metis

  • Base

  • Mode

  • Sei

  • Fraxtal

  • X-Layer

Legacy OFTs

• Chain: Ethereum, Metis, Blast, Base

• Admin: Chain-respective msig

• OFTs

  • FRAX: 0x909DBdE1eBE906Af95660033e478D59EFe831fED

  • sFRAX: 0xe4796cCB6bB5DE2290C417Ac337F2b66CA2E770E

  • sfrxETH: 0x1f55a02A049033E3419a8E2975cF3F572F4e6E9A

  • FXS: 0x23432452B720C80553458496D4D9d7C5003280d0

  • frxETH : 0xF010a7c8877043681D59AD125EbF575633505942

  • FPI: 0xE41228a455700cAF09E551805A8aB37caa39D08c

可升级 OFTs

• Chain: Mode, Sei, Fraxtal, X-Layer

• Admin: ProxyAdmin (owned by chain-respective msig)

• OFTs

  • FRAX: 0x80eede496655fb9047dd39d9f418d5483ed600df

  • sFRAX: 0x5bff88ca1442c2496f7e475e9e7786383bc070c0

  • sfrxETH: 0x3ec3849c33291a9ef4c5db86de593eb4a37fde45

  • FXS: 0x64445f0aecc51e94ad52d8ac56b7190e764e561a

  • frxETH: 0x43eDD7f3831b08FE70B7555ddD373C8bF65a9050

  • FPI : 0xEed9DE5E41b53D1C8fAB8AAB4b0e446F828c1483

源代码

• https://github.com/fraxfinance/frax-oft-upgradeable

• https://github.com/fraxfinance/layerzero-v2-upgradeable

安全考虑

Layer Zero OFT Frax 资产不是 Frax 协议的负债。它们不会出现在 facts.frax.finance 的资产负债表上。它们不能兑换为协议拥有的资产。它们只能在 Layer Zero 协议的“锁箱”合约中兑换为 Frax 资产。

Layer Zero OFT Frax 资产由 Layer Zero 去中心化验证网络（DVNs）结算，这些网络不由 Frax 协议、Frax 核心开发者或与 Frax 相关的任何实体运营。因此，OFT Frax 资产的风险由其持有者承担。这类似于在其发行人 Circle 不支持铸造/赎回的网络上持有“USDC 代币”。这些“USDC 代币”不会出现在 Circle 的资产负债表上作为负债，也不能从其发行人那里赎回。它们只能在桥接（即“锁箱”）合约中兑换为基础的 USDC 代币。

未来，Frax 协议可以与 Layer Zero 合作，升级某些 OFT Frax 资产在特定网络上的功能，使 Frax 协议能够对结算过程进行直接监督，类似于 Frax Ferry 系统。在这之后，这些特定网络的 OFT Frax 资产将被报告在相关资产负债表上。当这种情况发生时，Frax 协议将视这些代币为其负债，且这些代币由其在各自资产负债表上持有的资产直接支持。目前，没有任何 Frax OFT 代币是协议的本地负债。

摘要

质押的 FRAX（sFRAX）是一个 ERC4626 质押金库，每周将部分 Frax Protocol 的收益以 FRAX 稳定币的形式分配给质押者。sFRAX 代币代表金库中的按比例存款，并始终可以按比例兑换为 FRAX 稳定币。sFRAX 年化收益率（APY）试图大致追踪美国联邦储备银行的准备金利息（IORB）利率，使用 IORB 预言机进行计算。这个基准利率通常被接受为美元的“无风险利率”。FRAX 质押金库尝试，但并不保证以任何方式达到这个利率。

详情

sFRAX 金库的 APY 基于可以由 frxGov 治理模块设置的利用率函数。利用率曲线的上限起始于 50% APY，理论上没有下限，但截至 2024 年 10 月 2 日，已稳定在 5-10% 的范围内。随着更多 FRAX 被质押到金库，协议将尝试将 FRAX 部署到 DeFi 治理批准的 AMO/策略以及收益尽可能接近 IORB 利率的 RWA 来源，以保持最低 APY 接近 IORB 目标。每周三 UTC 时间 11:59:59，Frax Protocol 将新铸造的 FRAX 稳定币添加到 sFRAX 金库中。这些新铸造的 FRAX 与 Frax Protocol 在前一周的收益成一对一比例，因此完全以 100% 的抵押率（CR）支持。每个 sFRAX 纪元为 1 周，长度和开始时间与 FXS 指标和 sfrxETH 纪元相同。协议并不保证所部署的资本在任何时刻都来自特定类型的资产。frxGov 治理模块将控制 sFRAX 收益的部署路径和资产类型。质押的 FRAX 金库的收益主要来源于 Frax Protocol 合作托管方采用的现实世界资产（RWA）策略，包括但不限于 FinresPBC。

sFRAX 合约地址：0xA663B02CF0a4b149d2aD41910CB81e23e1c41c32

sFRAX

总结

这是由Frax团队设计和实施的24-48小时代币桥接解决方案。

动机

• 由于bug、团队诈骗、匿名开发者等原因，桥接频繁遭受黑客攻击。

• 存在无限铸币的风险。

• 某些链的桥接速度较慢，尤其是在返回以太坊的过程中（例如Arbitrum、Optimism等）。

好处

• 风险由桥接合约中的代币数量上限。没有无限铸币的风险。

• 较慢的交易速度给予更多时间以捕捉和阻止坏批次，前提是它们没有被机器人自动取消。

• 团队成员可以暂停合约，以便调查任何问题。

风险

• 如果船长被诱骗提议一个带有虚假哈希的批次，并且所有团队成员的机器人都离线/被审查/被破坏，并且没有人对提案提出异议。

• 源链上的重组。通过仅返回至少一小时之前的源链交易来避免此风险。

• 乐观回滚的回滚。通过运行节点来避免此风险。

• 操作员没有足够的时间在虚假提案后暂停链。通过要求发送和执行提案之间有最小时间间隔来避免此风险。

• 集中化

流程

1. 用户将代币发送到合约。此交易存储在合约中，使用embark()，embarkWithRecipient()或者embarkWithSignature()。

2. 船长查询源链以获取要运输的交易。

3. 船长发送批次（开始、结束、哈希）以开始旅程。调用depart()。

4. 等待至少24小时。

5. 团队成员检查批次，并可以在批次无效时提出异议。调用disputeBatch()或do nothing。

6. 未被质疑的批次可以由第一官员执行，通过提供交易的calldata。用户将在另一条链上收到其代币。调用disembark()。

7. 交易的哈希必须与批次中的哈希相等。

8. 如果存在欺诈交易（例如黑客），所有者可以取消单个交易，使其不会被执行。调用jettison(), jettisonGroup(), removeBatches()。

9. 所有者可以手动管理合约中的代币，并必须确保合约中有足够的资金。

总结

FXB 代币是简单、无信任的代币，类似于零息债券，在到期时转换为 FRAX 稳定币。FXB AMO 以低于面值的折扣拍卖 FXB。这一折扣为买家提供了相当于 RWA 收益的收益，而不承担 RWA 风险。它们还有助于减少流通中的 FRAX 并稳定锚定，因为用户无法出售在 FXB 中锁定的 FRAX（直到到期）。

详情

FXB 是以 FRAX 稳定币计价的债务代币，而不是对任何其他资产或抵押品的索赔。FXB 代币只能转换为 FRAX 稳定币，并不保证 FRAX 的锚定、FRAX 的价值或以任何其他资产计价的收益/利息。FXB 不赋予持有者任何链外或链上的资产（除了 FRAX 稳定币）。因此，FXB 不能赎回为美国国债或任何其他现实资产，并且没有直接得到这些资产（或任何特定资产）的支持/抵押，并且除了在预定到期时间戳生成时无信任地转换为 FRAX 稳定币外，没有任何其他效用。这一点很重要，而不仅仅是语义上的区别，因为它直接定义了 FXB 的规范性和经济特性。Frax Bond 代币仅保证通过发行它们的智能合约以一对一的比例转换为 FRAX。

FXB 允许形成收益曲线，以定价将 FRAX 借回协议本身的时间价值。每个 FXB 代币都是从链上工厂合约部署的可替代 ERC20 代币。在 FXB 发行时，FRAX 稳定币被转移到 FXB 合约中以便在到期时转换。这防止了在完整的 FXB 循环发生之前需要任何外部操作，并且完全保持无信任状态。可以随时在市场上流通多个 FXB 系列，且没有最低或最高到期时间戳的限制。

FXB 在到期日的结束时到期，使用 UTC 时间，并且没有到期限制。例如，20261231 FXB 可以在 1893456000 时刻被赎回其对应的 FRAX。

系列拍卖

FXB 系列的价格发现通过持续逐步荷兰拍卖（GDA）拍卖系统进行，数量和价格限制由 Frax 团队设定。这保证了 FXB 代币的销售价格不会低于底价限制。拍卖通过 FXB AMO 合约进行，都是无信任、无许可和无保管的。新拍卖可以随时由Fraxtal Comptroller和 Fraxtal AMO Operator启动，通过 FXB AMO发起。

铸造与赎回：原链与桥接链

如前所述，在 FXB 铸造时，FRAX 稳定币被转移到 FXB 合约中以便在到期时转换。FXB 可以分为两种类型，原链和桥接链，分别指 FXB 最初铸造的链。需要这种区分，因为原链（即 FXB 最初铸造的链）是 FXB 所有者在到期后可以将 FXB 烧毁以获得等值 FRAX 的地方。例如，起源于 Fraxtal 的 FXB 被桥接到 Fraxtal 后被视为桥接版本，其中基础 FRAX 保留在 Fraxtal 中，FXB 必须桥接回来才能赎回 FRAX。类似地，FXB 必须在原链上铸造，以包含基础 FRAX。

为什么会发生这种情况？ 当 FXB 最初创建时，是通过 FXBFactory完成的。这个原始 FXB 包含铸造和赎回的代码。一旦 FXB 被桥接，目标链通过桥接 ERC20Factory创建 FXB。这个桥接版本只能通过桥接铸造和赎回（烧毁）。

合约

要无需信任地将合约导入您的本地存储库，请参阅 frax-template。

操作合约

核心合约

概述

Fraxtal 是一个与以太坊虚拟机（EVM）等效的rollup区块链，使用 OP 堆栈作为其智能合约平台和执行环境。原生 gas 代币是由 Frax Finance 发行的 Frax 以太币（frxETH）。Fraxtal 还提供区块空间奖励（称为 Flox），通过用户和开发者在网络上花费 gas 以及与任何智能合约交互来进行奖励。

为什么要有 Fraxtal？已经有这么多 L2 链了，为什么还需要 Fraxtal？

你可以在 Fraxtal 文档中阅读完整的理由，但主要原因如下：

1. 极低的交易成本

2. 提高的交易速度

3. 使用 frxETH 作为 gas 代币

4. 通过排序器（Sequencer）费用获得收入

5. Flox / FXTL 区块空间奖励

文档：

About Fraxtal | Fraxtal Docs

Fraxtal 的桥接过程源自 Optimism的设计。将资产从以太坊主网桥接到 Fraxtal（L1StandardBridge 和 L1ERC721Bridge）通常只需几分钟，而从 Fraxtal 返回以太坊（L2StandardBridge 和 L2ERC721Bridge）则可能需要 7 天。消息传递（L1CrossDomainMessenger 和 L2CrossDomainMessenger）也适用此情况。为了解决这一问题，Fraxtal 还提供了 Frax Ferry，大多数用户会选择使用该服务返回以太坊，仅需 24-48 小时，而不是 7 天。

• Fraxtal 桥接 UI: 访问 Fraxtal 桥接工具

• Fraxtal 桥接文档: 查看桥接文档

Ethereum -> Fraxtal (~几分钟)

Fraxtal -> Ethereum (7 days)

FPI

Frax价格指数(FPI)是Frax金融生态系统的第二个稳定币。FPI是第一个与美国CPI-U平均值定义的一篮子现实世界消费品挂钩的稳定币。FPI稳定币旨在保持其价格与CPI篮子中所有项目的价格一致，从而通过链上稳定机制保持其购买力。与FRAX稳定币一样，所有FPI资产和市场操作都是链上的，并使用AMO合约。

FPIS

⚠️ FPIS 将于 2028 年 3 月 22 日逐步淘汰，并在此之后可转换为 FXS ⚠️

Frax Price Index Share (FPIS) 代币是该系统的治理代币，也有权获得协议的铸币税收益。超额收益将从财政部分配给 FPIS 持有者，类似于 FXS 结构。在 FPI 财政部未能创造足够收益以维持因通货膨胀而增加的每个 FPI 的支持时，可能会铸造并出售新 FPIS 以增加财政部的资金。由于该协议是在 Frax 生态系统内部推出的，FPIS 代币还将把其收入的一部分变动份额分配给 FXS 持有者。

通货膨胀 & 挂钩计算

FPI使用美国联邦政府报告的未经调整的CPI-U 12个月通货膨胀率：https://www.bls.gov/news.release/cpi.nr0.htm 一个专用的Chainlink预言机在该信息公开发布后立即将该数据提交到链上。然后，预言机报告的通货膨胀率应用于系统合约中FPI稳定币的赎回价格。这个赎回价格在链上每秒增长(或在罕见的通货紧缩情况下下降)。当bls.gov发布每月CPI价格数据时，挂钩计算率每30天更新一次。FPI 使用美国联邦政府报告的未调整的 12 个月消费者价格指数（CPI-U）通货膨胀率：https://www.bls.gov/news.release/cpi.nr0.htm。 $1 的起始日期是基于 2021 年 12 月的 CPI-U 数据。因此，FPI 的市场价格在该日期之后应跟踪 2021 年 12 月的相同购买力。例如，在 2024 年 10 月 4 日，FPI 的市场价格约为 $1.11。这意味着在 2024 年 10 月 4 日，购买以前在 2021 年 12 月花费 $1 的物品需要大约 $1.11（年通货膨胀率约为 3.5-4%）。

一个专门的 Chainlink 预言机在数据公开发布后立即将其提交到链上。预言机报告的通货膨胀率随后应用于系统合约中 FPI 稳定币的赎回价格。该赎回价格在链上每秒增长（或在通货紧缩的罕见情况下下降）。当 bls.gov 每月发布 CPI 价格数据时，peg 计算率每 30 天更新一次。处理 FPI peg 价格目标的合约是 CPI Tracker Oracle。

因此，FPI peg 始终跟踪上述 12 个月的通货膨胀率，并在 FPI 赎回合约中对此进行 peg。当以另一种资产（如 ETH）购买 FPI 稳定币时，交易者的立场是认为 CPI 购买力的增长速度会比出售的 ETH 更快。如果将 FPI 出售换成 ETH，则交易者的立场是认为 ETH 的增长速度超过了美元的 CPI 通货膨胀率。

FPI 作为一种记账单位

FPI的目标是成为第一个拥有自己记账单位的链上稳定币，这些单位来自一篮子商品，包括加密资产和非加密资产。虽然FPI可以被认为是一种抗通胀的收益资产，但它的主要动机是创建一种新的稳定币来命名交易、价值和债务。对DAO国债进行计价，并以FPI衡量收入，以及以FPI交易对为基准，有助于更好地衡量价值应计额是否在实际通货膨胀的情况下积极增长。它还有助于将链上经济学根植于现实世界的资产篮子。

首先，国库将仅由$FRAX组成，但未来将扩大到包括其他加密原生资产，如桥接BTC、ETH和非加密消费品和服务。

FPI 稳定机制

FPI 使用与 FRAX 稳定币相同类型的 AMOs，但其模型旨在始终保持 100% 的抵押率 (CR)。这意味着，为了保持抵押率在 100%，协议资产负债表的增长速度必须至少与 CPI 通货膨胀率相匹配。因此，AMO 策略合约必须获得与 CPI 成比例的收益，否则抵押率将降低到 100% 以下。在 AMO 收益低于 CPI 率的情况下，TWAMM AMO 将出售 FPIS 代币以换取 FRAX 稳定币，以始终保持抵押率为 100%。当抵押率恢复到 100% 时，FPIS TWAMMs 将被移除。

FPI 的铸造（使用 FRAX）和赎回（接收 FRAX）可以在任何时间以少量费用通过 FPI Controller Pool 完成。用户还可以在 Curve 或 Fraxswap 等各种市场中买卖 FPI。

FPI Controller 池子： 0x2397321b301B80A1C0911d6f9ED4b6033d43cF51

FPI Comptroller 多签

FPI Comptroller 多签钱包收集/存入来自 FPI Controller Pool 的盈余/赤字 FRAX，并且是与 FPI 相关合约的拥有者。它还投资于 Curve/Convex 农场等各种收益来源，并利用收益来帮助增加对 FPI PEG 的支持。

FPI Comptroller 多签： 0x6A7efa964Cf6D9Ab3BC3c47eBdDB853A8853C502

描述

FPI控制池具有与FPI及其挂钩相关的各种辅助函数，例如铸造和赎回FPI。

FPI Controller Pool:

铸造 / 赎回

用户可以用FRAX铸造FPI或兑换FPI为FRAX。与此相关会有一小笔费用，最初是0.30%。

twammToPeg

协议使用twammToPeg函数引入市场压力，使FPI的市场价格上升(或下降)以实现目标价格锚定。

giveFRAXToAMO / receiveFRAXFromAMO

该合约可以将FRAX的抵押品借给各种各样的AMOs，这些AMOs可以获得收益。

代码

根据的投票，社区决定最终退休 FPIS 代币，以便专注于 FXS。到 2028 年 3 月 22 日，FPIS 将有资格以 2.5 FPIS 兑换 1 FXS 的比例进行转换。在此之前，用户可以选择通过 在 Fraxtal 上锁定他们的 FPIS。这将根据锁定时间的长短给予用户 1.333 倍到 0.333 倍的 veFXS 投票权。在 2028 年 3 月 22 日的转换日期之后，仍然在 FPIS Locker 中锁定的头寸可以转换为其 FXS 等值，并转入 veFXS，直到剩余的锁定时间完成，之后可以提取 FXS。未曾在 FPIS Locker 中锁定或在转换日期之前解锁的 FPIS 也可以在转换日期之后直接转换为 FXS，无需通过 FPIS Locker。现在，锁定的 veFPIS 头寸可以自由提取其 FPIS。

FPI

FPIS

以太坊

其他链

总结

Fraxswap 是第一个具有嵌入式时间加权平均做市商（TWAMM）的恒定乘积自动化做市商，用于在长时间内无信任地进行大额交易。它完全无需许可，其核心 AMM 基于 Uniswap V2。这个新型 AMM 帮助交易者高效执行大订单。Fraxswap 是完全无需许可的 AMM，这意味着其他人可以像在 Uniswap 上一样，为任何两个代币创建自己的流动性池。

构建 Fraxswap 的动机是创建一个具有专门功能的 AMM，用于算法稳定币货币政策、前瞻性指引以及为稳定某一资产的价格而在长时间内缩减其供应或获取特定抵押品的持续大额市场订单。具体来说，Frax 协议将使用 Fraxswap 来：

1. 用 AMO 利润回购并销毁 FXS；

2. 增强 FRAX 和 FPI 稳定币的锚定稳定性；

3. 出售 FRAX 以购买硬资产；

4. 部署协议拥有的流动性以产生收入和效用，例如在各种链上提供 FRAX/FXS 和 FRAX/<gas token>。

其他协议、稳定币发行方和 DAO 的理想用例包括：

1. 通过逐渐出售治理代币，积累国库资产（如稳定币）；

2. 通过 DAO 的收入和储备，逐步回购治理代币；

3. 通过 DAO 自身的治理代币，逐步获取其他协议的治理代币（类似于企业并购，但在无需许可的方式下进行）；

4. 为基于国库的 DAO（如 Olympus、Temple 及其他项目）捍卫“无风险价值”（RFV），这些项目的治理代币的背书是社会或程序上保证的。

要将 Fraxswap 用于货币政策，最佳方法是创建一个代币对，并添加协议控制的流动性。然后可以根据需要在任何方向上发布任何规模的 TWAMM 订单，用于前瞻性指引和 DAO 净资产的再平衡。请参阅技术规格部分，了解 TWAMM 的滑点计算和流动性优化。

Fraxswap V2

V2 包含一个新功能，允许每个流动性池设置不同的手续费。

-------------------------------------

Fraxswap V1

DEPRECATED

Ethereum

Fraxswap Factory: 0xB076b06F669e682609fb4a8C6646D2619717Be4b

Fraxswap Router: 0x1C6cA5DEe97C8C368Ca559892CCce2454c8C35C7

Arbitrum

Fraxswap Factory: 0x5Ca135cB8527d76e932f34B5145575F9d8cbE08E

Fraxswap Router: 0xc2544A32872A91F4A553b404C6950e89De901fdb

Avalanche

Fraxswap Factory: 0x5Ca135cB8527d76e932f34B5145575F9d8cbE08E

Fraxswap Router: 0xc2544A32872A91F4A553b404C6950e89De901fdb

Binance Smart Chain

Fraxswap Factory: 0xa007a9716dba05289df85A90d0Fd9D39BEE808dE

Fraxswap Router: 0x0AE84c1A6E142Ed90f8A35a7E7B216CB25469E37

Fantom

Fraxswap Factory: 0xF55C563148cA0c0F1626834ec1B8651844D76792

Fraxswap Router: 0xa007a9716dba05289df85A90d0Fd9D39BEE808dE

Harmony

Fraxswap Factory: 0x5Ca135cB8527d76e932f34B5145575F9d8cbE08E

Fraxswap Router: 0xc2544A32872A91F4A553b404C6950e89De901fdb

Moonbeam

Fraxswap Factory: 0x5Ca135cB8527d76e932f34B5145575F9d8cbE08E

Fraxswap Router: 0xc2544A32872A91F4A553b404C6950e89De901fdb

Moonriver

Fraxswap Factory: 0x5Ca135cB8527d76e932f34B5145575F9d8cbE08E

Fraxswap Router: 0xc2544A32872A91F4A553b404C6950e89De901fdb

Optimism

Fraxswap Factory: 0xBe90FD3CDdaf0D3B8576ffb5E51aDbfD304d0437

Fraxswap Router: 0xffE66A866B249f5d7C97b4a4c84742A393bC9354

Polygon

Fraxswap Factory: 0xc2544A32872A91F4A553b404C6950e89De901fdb

Fraxswap Router: 0x9bc2152fD37b196C0Ff3C16f5533767c9A983971

头寸健康度

每一个借贷对都有一个配置好的最大贷款价值比(LTV)。随着时间的推移，随着利息的资本化，借款人必须增加更多的抵押品或偿还部分债务。否则，他们的头寸可能会变得不健康。为了确定借款人的LTV，我们使用抵押品的价值和ftoken的价值。

股价为1个fToken的资产代币单位价格(即资产代币:fToken比率)

汇率是1个资产代币的抵押品单位价格(即抵押品代币:资产比率)

清算

当借款人的LTV高于最高LTV时，任何用户都可以代表借款人偿还债务，并获得同等价值的抵押品和清算费用。清算费用是不可更改的，并在部署时确定。默认情况下，该值被设置为10%，可以通过调用借贷对上的 liquidationFee() view函数来访问。通过在借贷对上调用 maxLTV() 函数可以找到配置的最大LTV。

动态债务重组

当借款人的贷款价值比（LTV）超过最大 LTV（通常为 75%）时，清算人可以立即关闭借款人的头寸。然而，在极端波动的情况下，可能清算人无法在 LTV 超过 100% 之前关闭不健康的头寸。在这种不太可能发生的情况下，会产生坏账。在这种情况下，清算人偿还由借款人抵押品覆盖的最大借款头寸，剩余债务则从所有贷款人对基础资本的总索取权中扣除。这可以防止贷款人争相提取流动性，导致最后的贷款人持有无价值的 fTokens（在其他贷款市场中通常称为“坏账”），并确保在不利事件后，交易对能够立即恢复正常运作。

头寸健康度&清算

利率

金库账户（Vault Account）是frxlend对中用于记账的结构：

struct VaultAccount {
    uint128 amount;
    uint128 shares;
}

金库账户The Vault Account cont包含两个元素

1. amount - 表示总数

2. shares - 表示可以申领的份额

借款会计

在借出中，amount代表存款的资产总额和应计利息。

当出借人存入资产时，存入的资产amount增加，shares价值也增加一定数量，但数量与股票的比率不变。

当产生利息时， amount增加，shares保持不变。每个出借人在基础资产中的份额以股份来衡量。

当贷款机构消除流动性时，他们赎回相关资产的股票。shares数量将根据赎回的股票数量而减少，amount将减少，但amount/shares的比率保持不变。

贷款会计

贷款时，amount 代表贷款资产总额和应计利息。

当贷款人收到资产时，收到的代币amount增加，shares价值也增加了一定值，使amount/shares之间的比率保持不变。

当产生利息时，amount增加，shares保持不变。每个贷款人的债务都以股份来衡量。

当贷款人偿还债务时， amount减去归还的资产数量，shares减少一定数额，使amount/shares的比率保持不变。单个贷款人的股份余额按此数量递减。

流程图

核心 AMM

Fraxswap的Core AMM是采用Uniswap V2，基于xy=k恒积常数的全系列产品设计。Fraxswap遵循了Uniswap V2的许多设计决策，因为它扩展了代码库以支持TWAMMs。Fraxswap v2计划以一种独特和新颖的方式支持集中流动性和相关资产流动性，允许TWAMM在这些交易对之间也发挥作用。

关于Uniswap核心功能的大量文档可以在这里找到： https://docs.uniswap.org/protocol/V2/concepts/protocol-overview/how-uniswap-works

时间加权平均自动做市商(TWAMM)

Fraxswap是第一个上线的TWAMM（时间加权平均做市商）实现。嵌入的TWAMM遵循Paradigm的原始白皮书规范。白皮书中提到的特性被用于优化长期订单的执行，包括：订单池化和对齐订单到期时间（按小时）。长期订单在任何与Fraxswap的交互之前被优先执行，这意味着在AMM（自动做市商）交互之前，长期订单首先执行，并且每个区块执行一次（见上方示意图）。Fraxswap实现了Paradigm原始公式的近似公式，允许简化、更节省gas的TWAMM。

TWAMM白皮书描述了其基本机制： “每个TWAMM实例促进特定资产对之间的交易，例如ETH和[FRAX]。

TWAMM包含一个嵌入式AMM，即一个用于两种资产的标准恒定乘积做市商。任何人可以随时与这个嵌入式AMM交易，就像它是一个普通的AMM一样。

交易者可以向TWAMM提交长期订单，即在固定的区块数量内卖出固定数量的一种资产的订单——例如，提交一个在接下来的2,000个区块内卖出100 ETH的订单。 TWAMM将这些长期订单分解为无数小的虚拟子订单，以均匀的速度与嵌入的AMM交易。单独处理每个虚拟子订单的交易将耗费无穷的gas，但一个封闭形式的数学公式允许我们在需要时计算它们的累积效果。 长期订单的执行将随着时间的推移推动嵌入的AMM的价格偏离其他市场上的价格。当这种情况发生时，套利者将针对嵌入AMM的价格进行交易，使其回归正常，确保长期订单的良好执行。

例如，如果长期卖单使ETH在嵌入的AMM上的价格比某个中心化交易所便宜，套利者将从嵌入的AMM购买ETH，使其价格回升，然后在中心化交易所卖出以获取利润。”

可以在以下链接上找到Paradigm TWAMM公式与Fraxswap TWAMM公式的互动对比：https://www.desmos.com/calculator/wp4zrkh6uj

摘要与动机

Fraxlend 是一个提供 ERC-20 资产交易对之间借贷市场的平台。每个交易对是一个独立的市场，允许任何人参与借贷活动。贷方可以将 ERC-20 资产存入该交易对并获得收益型 fToken。随着利息的增加，fToken 可以兑换为数量不断增加的基础资产。

创建 Fraxlend 的主要目的是为了 Fraxlend AMO 的使用。AMO 合约提供协议持有的 FRAX（以及其他 Frax 生态系统代币，如 frxETH 和 sfrxETH），供其他用户借入，借款人则需存入各种抵押品代币并支付利息。这不仅为协议产生收入，还分散了支持 FRAX 的抵押品。

每个交易对的最高贷款价值比（LTV）可以由社区投票决定，但通常对于波动性较大的代币交易对约为 75%，而稳定币/稳定币交易对约为 90%（后者通常风险较低）。协议还维护了一个清算机器人，但任何用户都可以对不健康/负资产头寸进行清算。

Fraxlend UI：Link 公共代码库：https://github.com/FraxFinance/fraxlend

生态系统参与者

Fraxlend的主要参与者是贷款人和借款人，这些参与者与单独的交易对进行交互。

• 出借人向池子提供资产代币，以换取fTokens

• 借款人向借贷对提供抵押品代币，并作为交换获得资产代币。借款会产生一个利率，该利率被资本化并在赎回ftoken时支付给出借人。

除了借贷双方，生态系统的其他部分还包括:预言机、利率计算和Fraxlend 借贷对部署方

• 每个交易对依赖于预言机来确定资产代币和抵押代币的市场利率。预言机结合来自多个地方的价格数据，以实现强大且抗操纵的价格信息。

• 每个交易对都配备了利率计算器。这些合约根据可借资本的数量计算利率。通常，借款越少，利率越低；而借款越多，利率则越高。

• 每一个借贷对都有单一的部署合约进行部署。

• 交易对注册表跟踪所有已部署的 Fraxlend 交易对。

出借方（Lenders）将资产代币存入借贷对，并根据当前股价获得相应数量的资产股份(ftoken)。

贷款人可以在任何时候以当前价格给出的利率将其ftoken兑换为基础资产代币。fToken股价随着利息的增加而增加。

利息的积累是唯一可以改变股价的操作。因为利息产生总是正的，每个fToken可赎回的资产代币的数量不能减少。

贷款案例

Alice存了100个FRAX代币要借给借款人，初始的fToken股价为1.00，她收到了100个fToken。从她的第一笔存款开始，借贷对已经赚了10 FRAX 的利息。因此金额显示为110(100 Frax存款+ 10 Frax利息)。目前fToken的股价为1.10 (110 FRAX / 100 fToken)

如果Bob现在存入100FRAX 用于贷款，我们将看到以下变化。首先，借贷对中的金额将增加100。fTokens的当前股价为1.10。因此Bob将收到90.91 (100 / 1.10)ftoken作为他的存款。资产库账户现在看起来像这样:

随着利息的增加，金额增加。如果额外的20Frax作为利息应计，资产金库帐户看起来像这样:

股价现已上涨至1.2048(230 Frax / 190.91 fToken)。这意味着Bob可以用90.91 ftoken赎回109.52 FRAX。同样，Alice可以用她的100 ftoken赎回120.48 Frax。

随着时间的推移，随着利息的增加，Alice和Bob可以用他们的ftoken赎回不断增加的标的资产。

每个交易对都被配置为根据利用率来调整利率。利用率是已存入资产中被借款人借出的总金额。Fraxlend 目前有两种可用的利率模型：

1. 线性利率

2. 时间加权可变利率

3. 可变利率 V2

线性利率

线性利率是一个可配置的函数，它允许有两个形式为y = mx +b的线性函数。该函数接受在创建借贷对时定义的参数。该函数接受在创建交易对时定义的参数。

最小利率：利用率为0%时的利率 顶峰利率：当利用率等于顶峰利用率时的利率(即当两个斜率相交时) 顶峰利用率: 两个斜率相交处的利用率 最大利率: 当利用率为100%时的利率

这些配置值是不可变的，并且在借贷对创建时是确定的。

利率的计算公式如下：

如果利用率等于顶峰利用率，那么:

如果利用率低于顶峰利用率，那么:

如果利用率大于顶峰利用率，那么:

时间加权动态利率

时间加权动态利率随时间调整当前利率。动态利率配置了一个半衰期值，以秒为单位，它决定了利率调整的速度。

最低利率：利率可降至的最低利率。 目标利用率区间：利率不调整，认为与市场预期均衡的利用率区间。 最高利率：利率可以上升到的最高利率。 利率半衰期：当利用率为0%时，利息减半所需的时间。这是利率调整的速度。在目前可用的利率计算器，利率半衰期是12小时。

时间加权动态利率允许市场发出合适的利率信号。

当利用率低于目标范围时，利率降低，这鼓励更多的借款和出借人抽回他们的资本，这两者都将利用率推回到目标范围。

当利用率高于目标范围时，利率上升，鼓励更多的贷款和更少的借款，使利用率回到目标范围。作为时间和利用率函数鼓励参与者贷款和借款。

下图显示了当利率半衰期为4小时，目标利用率范围为75% - 85%时，利率的变化情况：

这使得市场，而不是借贷对的创造者，来决定给定资产抵押借贷对的适当利率，借贷对的创造者只需要提供一个目标利用率。

可变利率 V2 利率

可变利率 V2 利率结合了线性利率和时间加权可变利率的概念。具体来说，它使用线性利率中的线性函数来确定当前利率，但通过时间加权可变利率的公式调整顶点和最大利率。

与时间加权可变利率类似，可变利率 V2 也采用半衰期和目标利用率参数。当利用率较低时，顶点和最大利率将下降。如果利用率较高，顶点和最大利率将上升。下降或上升的速率由利用率和半衰期共同决定。如果利用率为 0%，顶点和最大利率每个半衰期将减少 50%；如果利用率为 100%，每个半衰期的增长为 100%。

这意味着利率将立即沿线性利率曲线对利用率的变化作出反应，同时通过调整线性利率曲线的斜率，长期适应市场条件。

每个借贷对都为用户提供了借入资产代币的机会，作为回报，借款人必须向借贷对提供适当数量的抵押品代币。

只要借款人有一个公开的头寸，利息就会产生并资本化。这意味着，随着时间的推移，借款人所欠的金额增加的金额等于他们所欠的利息。为了让借款人收回他们的抵押品，他们必须归还原始贷款金额加上所有应计利息。

贷款案例

就像我们使用资产金库帐户来跟踪总资产金额和相应的股份数量一样，我们使用借款金库帐户来跟踪借款总额、资本化利息和已发行的借款股份数量。

假设Alice用150美元的ETH借了100Frax(价值100美元)。自从她第一次借款以来，她已经积累了10Frax的利息。借款金库帐户将显示如下: