STFIL 代币集成指南

本文档面向希望将 STFIL 的 stFIL 、wstFIL 、STF代币集成到其 dApp 中的开发人员，重点关注货币市场、DEX 和区块跨链桥。

STFIL Protocol

STFIL 协议是跨多个区块链的一系列流动质押协议，总部位于 Filecoin。 流动性是指用户的质押权益变得可流动的能力。 用户存款后，STFIL 协议会发行 stToken，它代表存入的代币以及通过存款质押产生的所有奖励和罚款。 与质押的资金不同，这种 stToken 具有流动性——它可以在各方之间自由转移，使其可以在不同的 DeFi 应用程序中使用，同时仍然可以获得质押奖励。 将 stToken 集成到任何 DeFi 协议中时，保留这一属性至关重要。

本指南指的是 Filecoin 上的 STFIL 协议（以下简称 STFIL）。

STFIL Protocol 的代币

stTokens: stFIL 和 wstFIL

对于质押在 STFIL 中的Filecoin，STFIL 协议为用户提供与质押金额相等的 stFIL。 为了更轻松地进行 DeFi 集成，stFIL 有一个不可重设的增值对应物，称为“wrapped stFIL”（或简称为 wstFIL）。

STFIL 的 ERC-20 兼容 stToken 将在 Filecoin 生态系统中广泛采用：

STF

STF 是符合 ERC-20 标准的 STFIL 治理代币。 由此，STF持有者可以获得投票权和分红权。

stFIL vs. wstFIL

STFIL 的 stToken 有两个版本，即 stFIL 和 wstFIL。 两者都是可流通的代币，但它们以不同的方式反映了累积的质押奖励。 stFIL 与 Aave 的 a-token类似，这意味着 stFIL 余额会随着时间的推移而增加。 相反，wstFIL 余额是恒定的，而代币的价值最终会增加（以 stFIL 计价）。 在任何时候，任何数量的 stFIL 都可以通过去信任的包装器转换为 wstFIL，反之亦然，因此代币有效地共享流动性。

stFIL

什么是 stFIL?

stFIL 是一种符合 ERC-20 标准的 a-token，代表用 STFIL 质押的filecoin。 与质押的 filecoin 不同，它具有流动性，可以在 DeFi 应用程序中转移、交易或使用。 stFIL 的总供应量反映了存入协议的 filecoin 数量加上质押奖励，减去潜在的验证者惩罚。 stFIL 代币以 1:1 的比例通过filecoin存款铸造。 也可以通过以相同的 1:1 比例燃烧 stFIL 来兑换 filecoin（始终保持 1:1 比例）。

stFIL是符合ERC-20标准的a-token。 通常情况下，stFIL 代币余额每秒都会增加。

stFIL是复利的吗?

是的，stFIL 奖励将会每秒都在复利。

wstFIL

由于 stFIL 的 rebasing 性质，持有者地址上的 stFIL 余额并不是恒定的，它每天都会变化。尽管可 rebasable 代币/a-token 最近在 DeFi 中变得很常见，但许多 dApp 并不支持 rebasing 。 例如，Maker、UniSwap 和 SushiSwap 并不是为可重新定义的代币而设计的。 在这些应用程序上列出 stFIL 可能会导致持有者无法收到每日质押奖励，这实际上抵消了流动性质押的好处。 为了与此类 dApp 集成，还有另一种形式的 STFIL stToken，称为 wstFIL（包装质押文件币）。

什么是wstFIL?

wstFIL 是一种 ERC20 代币，代表账户在 stFIL 总供应量中所占的份额（具有静态余额的 stFIL 代币包装器）。 对于 wstFIL，1 atto 份额等于 1 atto 余额。 wstFIL 余额只能在转移、铸造和销毁时更改。 wstFIL 余额不会重新设定基准，而是以 stFIL 计价的 wstFIL 价格发生变化。 在任何给定时间，任何持有 wstFIL 的人都可以以固定汇率将任意数量的其转换为 stFIL，反之亦然。 在任何特定时刻，每个人的费率都是相同的。 通常，当 stFIL 进行变基时，汇率每天更新一次。 当前费率可以通过调用wstFIL.stFILPerToken() 获取。

Wrap & Unwrap

当将 stFIL 包装为 wstFIL 时，所需数量的 stFIL 被锁定在 wstFIL 合约余额上，并根据份额记账公式铸造 wstFIL。

解包时，wstFIL 被烧毁，相应数量的 stFIL 被解锁。

因此，解包时解锁的 stFIL 量与最初包装的量不同（假设在包装和解包 stFIL 之间发生了变基）。

wstFIL shortcut

请注意，WstFIL 合约包含一个在后台将 FIL 转换为 wstFIL 的快捷方式，这使您可以有效地跳过包装步骤并直接为 wstFIL 抵押filecoin。 请记住，使用快捷方式时，质押率限制仍然适用。

奖励计算​

由于 wstFIL 代表持有者在 STFIL 控制的 filecoin 总量中所占的份额，因此变基不会影响 wstFIL 余额，但会改变以 stFIL 计价的 wstFIL 价格。

一个简单的例子:

  1. 用户wrap 1 stFIL 并获得 0.9803 wstFIL (1 stFIL = 0.9803 wstFIL)

  2. 随着stFIL数量的增加，wstFIL价格上涨5%

  3. 用户unwrap 0.9803 wstFIL 并获得 1.0499 stFIL (1 stFIL = 0.9337 wstFIL)

STF

什么是 STF?

STF 是用于 STFIL DAO 投票过程（链下和链上）的治理代币。 该代币将在 DeFi 和 CeFi 生态系统中广泛使用。

  • 治理：持有STF代币的用户可以使用其代币参与协议的治理和决策过程。

  • 安全模块：用户通过质押 STF 代币为协议提供安全性，并获得 STF 奖励作为回报。

  • 质押激励：用户根据质押FIL数量和质押期限，可以获得STF奖励。

Last updated