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 個區塊,並在申請到期前執行;到期後再次調用會重新申請。黑名單用戶可以提款,但仍受當前餘額和代幣轉賬成功等條件約束,詳見完整規則。