核心概念¶
本页解释您在 Sera 上交易时需要了解的基本概念。
订单类型¶
Sera 支持三种主要订单类型：
即时兑换¶
即时兑换以最佳可用价格立即执行。您指定要交易的代币和数量，Sera 会找到最优路由。
无需事先充值 Vault
Swap 可使用钱包资金及可用的 Vault 资金，这不表示路由绕过 Vault；结算可能经 Vault 拉取、记账或提取代币。单独的授权交易可能需要 ETH。
- 价格保护 — 设置最低输出金额以防止不利价格
- 多段路由 — 兑换可以通过中间货币路由以获得更好的汇率
完整指南请参阅即时兑换。
限价单¶
限价单停留在订单簿中直至成交、取消或过期。它们需要 Vault 抵押品，结算交易由 relayer 发送。
- 买价（Bid / 买入） — 指定您愿意支付的最高价格
- 卖价（Ask / 卖出） — 指定您愿意接受的最低价格
完整指南请参阅限价单。
虚拟流动性批次¶
虚拟流动性（VL）批次允许您使用一笔共享预算，在多个交易对上挂出限价单，从而在多交易对策略中最大化资金效率。
- 共享抵押品 — 冻结单个订单中的最大成本，而不是所有订单成本之和
- 唯一市场 — 每个兄弟订单必须针对不同的市场；完全重复的交易对以及反向对（例如
XSGD/USDC和USDC/XSGD）都会被视为重复并拒绝 - 自动调整 — 当一个订单成交时，其余兄弟订单会缩量以适配剩余预算
完整指南请参阅虚拟流动性。
订单生命周期¶
每个订单都遵循定义的生命周期。公共 API 暴露五种状态：
stateDiagram-v2
[*] --> Pending: Place Order
Pending --> Pending: Partial Fill (still active)
Pending --> Matched: All Legs Crossed
Matched --> Settled: Chain Confirmed
Matched --> Failed: Settlement Reverted
Pending --> Cancelled: Cancel
Pending --> Failed: Rejected or Settlement Failed符合条件的失败限价 taker 可能在恢复时重建深度并回到 pending；用户主动撤单、过期及非限价类型不会走此恢复。请结合当前订单、settlement_summary、/fills 和余额变化判断，不要假定每次状态转换都不可逆。
| 状态 | 说明 |
|---|---|
pending | 已提交、挂单中或部分成交 |
matched | 所有腿在撮合引擎中已交叉，链上结算进行中 |
settled | 完全成交且链上结算确认 |
cancelled | 在完全成交前被所有者取消 |
failed | 被入口拒绝或结算 revert |
pending 可以覆盖多个内部阶段，包括尚未成交、部分成交后仍有剩余数量，或等待链上结算。应用不需要这些内部状态；请使用 filled_amount、remaining_amount、settlement_summary、/fills 和 settlement_economics 来展示订单进度与用户资金变化。
结算收益按已签名接收人交付：零地址接收人记入所有者 Vault 账本，外部接收人则在该钱包收到代币；没有单独的领取步骤。
完整的演练请参阅订单生命周期。
非托管架构¶
资产在链上保管和结算。API、撮合及账务服务协调指令和预留，签名检查及合约角色共同定义授权边界，详见非托管设计。
Vault 与余额¶
钱包余额是外部钱包代币。vault_available、vault_frozen 是对应链上保管资产的链下账务金额；available 不保证当前可花费。请使用余额接口的 vault_spendable、spendability_status 和恢复/同步字段。
虚拟流动性¶
VL 在不同市场间共享一份抵押品预算。引擎扣除消耗，并在需要时缩量或取消兄弟订单，不会提高剩余已签名数量。活跃最小/最大批量从 GET /config → limits.vl_batch 获取（默认 2–50），详见虚拟流动性。
费用与 Gas¶
结算交易消耗 EVM Gas，由 relayer 执行者签名并广播，其钱包支付链上网络费。限价单所有者无需仅为该笔结算在自己的钱包中持有 ETH。用户可见费用以报价和 settlement_economics.fees_paid 为准，这不表示所有部署都承诺免费交易。用户自行发送的 approve、充值、提款等交易仍需支付网络 Gas。
详见费用与成本。
EIP-712 签名¶
Sera 上的所有交易操作均通过 EIP-712 类型化数据签名 进行授权。这意味着：
- 您使用钱包（例如 MetaMask）签署结构化消息
- 签名授权特定操作（下单、取消、提款）
- 您的私钥永远不会离开您的设备
- 每个签名都绑定到特定的链和合约，防止重放攻击
API 用户请参阅身份验证了解如何构造和签署这些消息。