核心概念¶
本頁說明在 Sera 上交易時需要了解的基本概念。
訂單類型¶
Sera 支援三種主要訂單類型：
即時兌換¶
即時兌換以最佳可用價格立即執行。您指定要交易的代幣和數量，Sera 會找到最佳路徑。
無需事先充值 Vault
Swap 可使用錢包資金及可用的 Vault 資金，這不表示路由繞過 Vault；結算可能經 Vault 拉取、記賬或提取代幣。單獨的授權交易可能需要 ETH。
- 價格保護 — 設定最低輸出金額以防止不利價格
- 多段路由 — 兌換可透過中間貨幣路由以獲得更好的匯率
完整指南請參閱兌換。
限價單¶
限價單讓您指定想要交易的確切價格。訂單會留在訂單簿中，直到被撮合或取消。需要 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符合條件的失敗限價 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 使用者請參閱身份驗證，了解如何建構和簽署這些訊息。