ERC20

返回存在的 Token 总量。

返回 account 拥有的 Token 数量。

返回通过 transfer_from 允许 spender 代表 owner 消费的剩余 Token 数量。 默认为零。

当调用 approve 或 transfer_from 时，此值会发生变化。

将 amount 数量的 Token 从调用者的 Token 余额转移到 to。 成功时返回 true，否则回退。

发出 Transfer 事件。

使用授权机制将 amount 数量的 Token 从 sender 转移到 recipient。 然后从调用者的授权中扣除 amount。 成功时返回 true，否则回退。

发出 Transfer 事件。

设置 amount 作为 spender 对调用者的 Token 的授权。 成功时返回 true，否则回退。

发出 Approval 事件。

当 value 数量的 Token 从一个地址 (from) 移动到另一个地址 (to) 时触发。

请注意，value 可能为零。

当设置 spender 对 owner 的授权时触发。 value 是新的授权。

返回 Token 的名称。

返回 Token 的交易代码。

返回 Token 使用的小数位数 - 例如，8 表示将 Token 金额除以 100000000 以获得其用户可读的表示形式。

例如，如果 decimals 等于 2，则 505 个 Token 的余额应向用户显示为 5.05 (505 / 10 ** 2)。

Token 通常选择 18 的值，模仿 Ether 和 Wei 之间的关系。 这是此函数返回的默认值。 要创建自定义的小数位实现，请参阅 自定义小数位数。

在 update 函数的开头，在任何其他逻辑之前执行的函数。

在 update 函数末尾执行的函数。

请参阅 IERC20::total_supply。

请参阅 IERC20::balance_of。

请参阅 IERC20::allowance。

请参阅 IERC20::transfer。

要求：

请参阅 IERC20::transfer_from。

要求：

请参阅 IERC20::approve。

要求：

请参阅 IERC20Metadata::name。

请参阅 IERC20Metadata::symbol。

请参阅 IERC20Metadata::decimals。

请参阅 IERC20::total_supply.

支持 Cairo v0 约定，即以 camelCase 编写外部方法，如 这里 中所述。

请参阅 IERC20::balance_of.

支持 Cairo v0 约定，即以 camelCase 编写外部方法，如 这里 中所述。

请参阅 IERC20::transfer_from。

支持 Cairo v0 约定，即以 camelCase 编写外部方法，如 这里 中所述。

在验证签名后，设置 amount 作为 spender 对ownerToken 的授权。

要求：

发出 Approval 事件。 每次成功调用都会使 owner 的 nonce 增加 1。

返回 owner 的当前 nonce。 只要为 permit 调用生成签名，就必须包含 nonce 值。

返回用于生成 permit 签名的消息哈希的域分隔符。 域哈希逻辑遵循 SNIP12 标准。

返回用于生成许可签名的消息哈希的域名和版本。

返回的元组包含：

通过设置 Token 名称和符号来初始化合约。 这应在合约的构造函数中使用。

创建 amount 数量的 Token 并将其分配给 recipient。

发出一个 Transfer 事件，其中 from 为零地址。

要求：

销毁 account 中的 amount 数量的 Token。

发出一个 Transfer 事件，其中 to 设置为零地址。

要求：

将 amount 数量的 Token 从 from 转移到 to，或者在 from (或 to) 是零地址的情况下，可以选择铸造 (或销毁)。

注意：可以使用 ERC20HooksTrait 扩展此函数，以添加 在转移、铸造或销毁之前和/或之后的功能。

发出 Transfer 事件。

将 amount 数量的 Token 从 from 移动到 to。

此内部函数不检查访问权限，但可以用作构建块，例如，实现自动 Token 费用、削减机制等。

发出 Transfer 事件。

要求：

设置 amount 作为 spender 对ownerToken 的授权。

此内部函数不检查访问权限，但可以用作构建块，例如，代表其他地址实施自动授权。

发出 Approval 事件。

要求：

根据花费的 amount 更新 owner 对 spender 的授权。

如果授权无限，此内部函数不会更新授权值。

可能会发出 Approval 事件。

请参阅 IERC20::Transfer。

请参阅 IERC20::Approval。

在验证签名后，设置 amount 作为 spender 对ownerToken 的授权。

返回 owner 的当前 nonce。 只要为 permit 调用生成签名，就必须包含 nonce 值。

返回用于生成 permit 签名的消息哈希的域分隔符。 域哈希逻辑遵循 SNIP12 标准。

返回用于保险库进行核算、存款和取款的基础 Token 的地址。

要求：

返回由金库“管理”的基础资产的总量。

要求：

返回无论滑点或费用如何，金库将交换所提供的 assets 金额的份额数量。

要求：

注意：此计算可能不反映“每个用户”的每股价格，而应 反映“平均用户”的每股价格，这意味着平均用户应该期望 在交易到和从交易时看到。

返回无论滑点或费用如何，金库将交换所提供的 shares 金额的资产金额。

要求：

注意：此计算可能不反映“每个用户”的每股价格，而应 反映“平均用户”的每股价格，这意味着平均用户 应该期望在交易到和从交易时看到。

返回可以通过存款调用存入金库的 receiver 的基础资产最大金额。

要求：

允许链上或链下用户模拟其在当前链上存款的影响 区块，鉴于当前的链上条件。

要求：

注意：IERC4626::convert_to_shares 和 preview_deposit 之间的任何不利差异 应被视为份额价格的滑点或其他类型的条件，这意味着 存款人将因存款而损失资产。

返回可以通过 withdraw 调用从 Vault 中的 owner 余额中提取的底层资产的最大数量。

要求：

允许链上或链下用户模拟他们在当前区块提款的效果，给定当前的链上条件。

要求：

从 owner 处销毁份额，并将精确数量的底层 token assets 发送到 receiver。

要求：

返回可以通过 redeem 调用从 Vault 中的 owner 余额中赎回的最大 Vault 份额数量。

要求：

允许链上或链下用户模拟他们在当前区块赎回的效果，给定当前的链上条件。

要求：

从 owner 处销毁精确数量的份额 shares，并将底层 token assets 发送到 receiver。

要求：

当 sender 用 assets 交换 shares 并将这些 shares 转移到 owner 时发出。

当 sender 用 owner 拥有的 shares 交换 assets 并将这些 assets 转移到 receiver 时发出。

应与底层资产的小数位数匹配。 默认值为 18。

对应于 UNDERLYING_DECIMALS 和 vault 小数位数之间的表示偏移量。 偏移量越大，攻击者执行通货膨胀攻击的成本就越高。

验证合约配置的给定实现。

要求：

调整 preview_deposit 中的存款以考虑入场费。 入场费应在 after_deposit 钩子中转移。

调整 preview_mint 中的存款以考虑入场费。 入场费应在 after_deposit 钩子中转移。

调整 preview_withdraw 中的提款以考虑退场费。 退场费应在 before_withdraw 钩子中转移。

调整 preview_redeem 中的提款以考虑退场费。 退场费应在 before_withdraw 钩子中转移。

允许的最大存款额。

默认为 (Option::None) 2 ** 256 - 1。

允许的最大铸币额。

默认为 (Option::None) 2 ** 256 - 1。

允许的最大提款额。

默认为 (Option::None) 从份额转换的 owner 的全部资产余额。

允许的最大赎回额。

默认为 (Option::None) owner 的全部资产余额。

挂钩到 _withdraw。

在销毁份额和转移资产之前执行逻辑。

挂钩到 _withdraw。

在销毁份额和转移资产之后执行逻辑。

挂钩到 _deposit。

在转移资产和铸造份额之前执行逻辑。

挂钩到 _deposit。

在转移资产和铸造份额之后执行逻辑。

返回用于 Vault 进行核算、存款和取款的底层 token 的地址。

返回由 Vault "管理" 的底层资产的总量。

返回 Vault 将为所提供的资产数量交换的份额数量，而无需考虑滑点或费用。

返回 Vault 将为所提供的份额数量交换的资产数量，而无需考虑滑点或费用。

返回可以通过 deposit 调用存入 Vault 以供 receiver 使用的底层资产的最大数量。

默认的最大存款值为 2 ** 256 - 1。

可以通过在 LimitConfigTrait::deposit_limit 中定义自定义逻辑来更改此值。

允许链上或链下用户模拟他们在当前区块的存款效果，给定当前的链上条件。

默认的存款预览值是全部份额。 例如，可以通过在 LimitConfigTrait::adjust_deposit 中定义自定义逻辑来更改此值，以考虑费用。

通过存入精确数量的底层 token assets，向 receiver 铸造 Vault 份额。 返回新铸造的份额数量。

要求：

发送 Deposit 事件。

返回可以通过 mint 调用为 receiver 铸造的最大 Vault 份额数量。

默认的最大铸币值为 2 ** 256 - 1。

可以通过在 LimitConfigTrait::mint_limit 中定义自定义逻辑来更改此值。

允许链上或链下用户模拟他们在当前区块的铸币效果，给定当前的链上条件。

默认的铸币预览值是全部资产。 例如，可以通过在 LimitConfigTrait::adjust_mint 中定义自定义逻辑来更改此值，以考虑费用。

通过存入底层 token 的数量，向 receiver 铸造精确数量的 Vault shares。 返回存入的资产数量。

要求：

发送 Deposit 事件。

返回可以通过 withdraw 调用从 Vault 中的 owner 余额中提取的底层资产的最大数量。

默认的最大提款值是 owner 的全部资产余额（从份额转换而来）。 可以通过在 LimitConfigTrait::withdraw_limit 中定义自定义逻辑来更改此值。

允许链上或链下用户模拟他们在当前区块的提款效果，给定当前的链上条件。

默认的提款预览值是全部份额。 例如，可以通过在 LimitConfigTrait::adjust_withdraw 中定义自定义逻辑来更改此值，以考虑费用。

从 owner 处销毁份额，并将精确数量的底层 token assets 发送到 receiver。

要求：

发送 Withdraw 事件。

返回可以通过 redeem 调用从 Vault 中的 owner 余额中赎回的最大 Vault 份额数量。

默认的最大赎回值是 owner 的全部资产余额。 可以通过在 LimitConfigTrait::redeem_limit 中定义自定义逻辑来更改此值。

允许链上或链下用户模拟他们在当前区块的赎回效果，给定当前的链上条件。

默认的赎回预览值是全部资产。 例如，可以通过在 LimitConfigTrait::adjust_redeem 中定义自定义逻辑来更改此值，以考虑费用。

从 owner 处销毁精确数量的 shares，并将底层 token 的资产发送到 receiver。

要求：

发送 Withdraw 事件。

返回 token 的名称。

返回 token 的交易代码，通常是名称的缩写版本。

返回累积的小数位数，其中包括 UNDERLYING_DECIMALS 和 OFFSET_DECIMALS。 两者都必须在实现合约的 ImmutableConfig 中定义。

验证 ImmutableConfig 常量并将 asset_address 设置为 vault。 这应在合约的构造函数中设置。

要求：

deposit 和 mint 的内部逻辑。

将 assets 从 caller 转移到 Vault 合约，然后将 shares 铸造到 receiver。 费用可以在 ERC4626Hooks::after_deposit 钩子中转移，该钩子在资产转移和份额铸造后执行。

要求：

发送两个 ERC20::Transfer 事件（ERC20::mint 和 ERC20::transfer_from）。

发送 Deposit 事件。

withdraw 和 redeem 的内部逻辑。

从 owner 处销毁 shares，然后将 assets 转移到 receiver。 费用可以在 ERC4626Hooks::before_withdraw 钩子中转移，该钩:page-title: ERC20Upgradeable