Vault¶
Vault 是一个链上智能合约，按用户维护账本余额来存储已存入的代币。它是 Sera 交易的基础。
非托管设计¶
资产由链上 Vault 账本保管。订单通过 Sera 签名流程授权，订单抵押品在链下账务中预留。用户直接发送的链上交易与特权合约调用采用不同授权规则，详见合约角色和安全模型。
为什么需要 Vault¶
预存抵押品可减少限价单和 VL 批次中交易对手资金不足的情况，但不能保证每次撮合都结算成功。签名、余额、代币行为和结算条件仍可能导致失败或回滚；确认收益前应查看逐笔结算证据。
Swap 不要求事先充值；已签名路由可以结合钱包资金和 Vault 余额，结算路径也可能涉及 Vault 的代币转入或转出。
余额类型¶
| 余额 | 含义 |
|---|---|
| 钱包 | 外部钱包持有的代币 |
vault_available | 链下账务的可用金额，不保证当前可花费 |
vault_frozen | 链下账务为未结订单预留的金额 |
vault_total | 账务 available + frozen |
vault_spendable | 经当前覆盖和恢复限制后可花费的金额 |
请查看 GET /balances 的 spendability_status、恢复字段与同步提示。金额是按各代币 decimals 解释的 raw 字符串；零余额行仍可能包含重要恢复状态。
存款与提款¶
存款将代币从您的钱包转移到 Vault 合约中。API 为您构建未签名交易 — 您的前端签署并广播它们。请参阅存款了解完整流程。
提款使用双重签名即时提款将代币从 Vault 转回您的钱包。请参阅提款了解详情。
紧急提款¶
用户可绕过 API，直接在 Sera 上调用 emergencyWithdraw()。申请时余额必须足够，至少等待 7,200 个区块，并在申请到期前执行；到期后再次调用会重新申请。黑名单用户可以提款，但仍受当前余额和代币转账成功等条件约束，详见完整规则。