核心概念¶

本页解释您在 Sera 上交易时需要了解的基本概念。

订单类型¶

Sera 支持两种主要订单类型： Sera 支持三种主要订单类型：

即时兑换¶

即时兑换以最佳可用价格立即执行。您指定要交易的代币和数量，Sera 会找到最优路由。

• 价格保护 — 设置最低输出金额以防止不利价格
• 多段路由 — 兑换可以通过中间货币路由以获得更好的汇率

完整指南请参阅即时兑换。

限价单¶

限价单允许您指定想要交易的确切价格。它们会保留在订单簿中，直到被匹配或取消。需要 Vault 存款和 ETH 支付 Gas。

• 买价（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

pending 可以覆盖多个内部阶段，包括尚未成交、部分成交后仍有剩余数量，或等待链上结算。应用不需要这些内部状态；请使用 filled_amount、remaining_amount、settlement_summary、/fills 和 settlement_economics 来展示订单进度与用户资金变化。

settled 订单的收益会自动归入您的 Vault 余额 — 不存在单独的"领取"步骤。

完整的演练请参阅订单生命周期。

非托管架构¶

Sera 完全非托管。您的资金保存在链上智能合约中 — Sera 的链下服务仅处理订单撮合，从不接触您的代币。即使 Sera 的 API 不可用，您也始终可以直接在链上提款。

完整说明请参阅非托管设计。

Vault 与余额¶

• 钱包余额 — 您以太坊钱包中的代币
• Vault 余额 — 存入 Vault 中可用于交易的代币
• 冻结余额 — 当前锁定在未结订单中的代币 — 仍在 Vault 合约中您的地址下

要使用限价单进行交易，您首先需要将代币存入 Vault。当您下单时，所需的代币会被冻结。当订单成交时，收益会记入您的 Vault 余额。所有资金流转均由智能合约强制执行。

虚拟流动性¶

虚拟流动性（VL）允许您使用一笔共享预算，在多个交易对上同时挂单。与为每个订单单独锁定资金不同，VL 批次共享同一池抵押品，当其中一个订单成交时，其余兄弟订单会自动调整，以确保总花费始终在预算内。

• 资金效率 — 冻结单个订单中的最大成本，而不是所有订单成本之和
• 多交易对覆盖 — 最多可同时在 5 个交易对上提供流动性
• 自动调整 — 随着预算被消耗，兄弟订单会缩量或取消

完整指南请参阅虚拟流动性。

费用与 Gas¶

• 兑换用户 — 兑换需要支付的全部成本（含 Gas）已经计入您签署的报价中。请求报价时选择 receive_less 或 pay_more Gas 模式；您无需另外持有 ETH。
• 限价单用户 — Gas 在结算时以真实 ETH 支付。

更多详情请参阅费用与成本。

EIP-712 签名¶

Sera 上的所有交易操作均通过 EIP-712 类型化数据签名 进行授权。这意味着：

• 您使用钱包（例如 MetaMask）签署结构化消息
• 签名授权特定操作（下单、取消、提款）
• 您的私钥永远不会离开您的设备
• 每个签名都绑定到特定的链和合约，防止重放攻击

API 用户请参阅身份验证了解如何构造和签署这些消息。

下一步¶