核心概念¶

本頁說明在 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 與餘額¶

• 錢包餘額 — 您 Ethereum 錢包中的代幣
• 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 使用者請參閱身份驗證，了解如何建構和簽署這些訊息。

下一步¶