Vault.sol¶

Vault 合约保管所有用户资金，具有按用户的账本跟踪。它将资产托管与交易逻辑分离。

Vault 存在的意义¶

Vault 在链上保管资产和用户余额。结算时使用 transferLedger 可减少 ERC-20 代币转账，但交易仍消耗 EVM Gas。结算交易由 relayer 执行者发送；Gas 付款及用户费用见费用与成本。

预存余额可支持连续限价交易。链下账务为订单预留抵押品，链上结算更新 Vault 账本；账本更新并非零 Gas 操作。

主网： 0xC7d4Fd2638e6630C8C61329878676b88A8A24D43 Sepolia： 0x3c7945840bAE0d7e7f3824Ebccef1962629250F0 源代码： src/Vault.sol

函数¶

函数	调用者角色要求
`deposit`、`creditLedger`、`withdraw`、`transferLedger`	`TRADER_ROLE`
`setBlacklisted`、`rescueToken`	`DEFAULT_ADMIN_ROLE`
`balanceOf`、`isBlacklisted`	公开读取

Vault 的特权方法本身不校验用户 EIP-712 签名；被授权的调用者负责外围授权和账务约束。普通用户通过 Sera 合约提款，不直接调用 Vault.withdraw。

deposit¶

从用户钱包拉取代币到 Vault。

function deposit(address user, address token, uint256 amount) external

参数	类型	说明
`user`	address	受益账户
`token`	address	ERC-20 代币地址
`amount`	uint256	存入金额

要求：

调用者必须拥有 TRADER_ROLE
用户不能在黑名单中
金额必须 > 0
用户必须已授权 Vault 花费该代币

事件：

event Deposited(address indexed token, address indexed user, uint256 amount);

creditLedger¶

记入用户的 Vault 余额。调用者必须在同一交易中已将代币转入 Vault。

function creditLedger(address user, address token, uint256 expectedAmount) external

参数	类型	说明
`user`	address	受益账户
`token`	address	ERC-20 代币地址
`expectedAmount`	uint256	记入金额

withdraw¶

扣减用户的 Vault 余额并将代币转给接收方。

function withdraw(address user, address token, uint256 amount, address to) external

参数	类型	说明
`user`	address	被扣减的账户
`token`	address	ERC-20 代币地址
`amount`	uint256	提取金额
`to`	address	代币接收方

要求：

to 不能为零地址
金额必须 > 0
用户余额必须充足

事件：

event Withdrawn(address indexed token, address indexed user, uint256 amount);

transferLedger¶

两个用户之间的内部账本转账。不发生 ERC-20 代币移动。

function transferLedger(address fromUser, address toUser, address token, uint256 amount) external

参数	类型	说明
`fromUser`	address	来源账户
`toUser`	address	目标账户
`token`	address	ERC-20 代币地址
`amount`	uint256	转账金额

此函数在订单结算期间内部使用。Vault 的总 TVL 保持不变。

事件：

event Withdrawn(address indexed token, address indexed user, uint256 amount); // fromUser
event Deposited(address indexed token, address indexed user, uint256 amount); // toUser

两个事件都会发出，目的是让标准的子图索引器能与账本变化保持同步，即使实际上并没有 ERC-20 转账发生。

balanceOf¶

查询用户在特定代币上的 Vault 余额。

function balanceOf(address token, address user) external view returns (uint256)

查询 Vault 持有的总物理 ERC-20 余额：

function balanceOf(address token) external view returns (uint256)

setBlacklisted¶

将用户账户加入黑名单或从黑名单中移除。

function setBlacklisted(address user, bool _isBlacklisted) external

被列入黑名单的用户不能存款或接收记入，但仍然可以提取现有余额。

事件：

event Blacklisted(address indexed user, bool isBlacklisted);

isBlacklisted¶

检查用户是否在黑名单中。

function isBlacklisted(address user) external view returns (bool)

rescueToken¶

救回意外直接发送到 Vault（而非通过存款）的代币。

function rescueToken(address token, address to, uint256 amount) external

只能救回多余的代币（物理余额减去已跟踪余额）。用户已跟踪的资金不能被救回。

错误¶

错误	原因
`BlacklistedUser`	用户在黑名单中（存款/记入被阻止）
`ZeroAmount`	金额为 0
`ZeroAddress`	接收方或用户为零地址
`InsufficientBalance`	用户余额不足
`CannotRescueTrackedFunds`	尝试救回已跟踪的用户资金