常见问题¶
概述¶
什么是 Sera？¶
Sera 是一个稳定币外汇结算层，允许在代表不同法币（USD、EUR、GBP、SGD、JPY 等）的稳定币之间进行交易。所有结算通过开源智能合约在以太坊上进行。
支持哪些货币？¶
Sera 通过各种稳定币发行方支持多种法币货币。完整列表请参阅支持的货币对。
如何获取测试代币来试用 Sera？¶
测试网代币注册表 中的每种稳定币都可以从 Sepolia 上的 Sera 测试网水龙头免费铸造：0x4FAc3BB8B77547E2Da7ed903baDBeD2f46cBe65a。最简单的方式是在 testnet.sera.cx 网页应用中使用「领取测试代币」流程；开发者也可以直接用想要的代币地址调用水龙头合约。此外还需要少量 Sepolia ETH 作为 Gas — 可从任意公开 Sepolia 水龙头 领取。
Sera 是托管的吗？¶
充值资产由 Vault 合约保管。正常交易和即时提款检查签名指令，特权合约角色仍属于信任模型。用户无需 API 即可申请延迟紧急提款，详见非托管设计。
交易¶
有哪些订单类型？¶
Sera 支持限价单（指定您的价格）、即时兑换（以最佳可用价格 Fill-or-Kill）以及虚拟流动性批次（使用共享抵押品的多交易对订单）。详情请参阅订单类型和虚拟流动性。
什么是虚拟流动性？¶
虚拟流动性（VL）允许您用一笔共享预算，在不同市场提交 2 至 50 笔限价单。当前上限以 GET /config 的 limits.vl_batch 为准。批次只冻结单笔订单成本中的最大值；一个同胞订单成交后，其余订单按剩余预算自动缩量。重复交易对与反向交易对视为同一市场，不能出现在同一批次。请参阅虚拟流动性。
即时兑换如何运作？¶
即时兑换使用智能订单路由（SOR）在所有可用流动性中寻找最佳价格。当直接路径不是最优时，SOR 引擎会通过中间货币进行路由。例如，JPY→GBP 兑换可能会经由 USD，以获得更优汇率。
- 通过 API 请求报价
- 使用您的钱包签署报价参数
- 提交签名以执行
兑换是原子性的 — 要么完全执行，要么被完全拒绝。请参阅即时兑换交易。
费用是多少？¶
结算交易消耗 EVM Gas，由 relayer 执行者签名并广播，其钱包支付链上网络费。限价单所有者无需仅为该笔结算在自己的钱包中持有 ETH。用户可见费用以报价和 settlement_economics.fees_paid 为准，这不表示所有部署都承诺免费交易。用户自行发送的 approve、充值、提款等交易仍需支付网络 Gas。 Swap 执行 Gas 已计入报价，详见费用。
我可以取消订单吗？¶
可以，对未结或部分成交订单发送已签名撤单请求。服务端采用可配置冷却期（默认 300 秒），当前没有高频账户豁免。429 也可能表示限流，请查看响应并查询最终订单/结算状态。
取消部分成交的订单会怎样？¶
未成交部分退还到您的 Vault 余额。已成交部分的收益仍然在您的 Vault 中可用。
API¶
我需要 API 密钥吗？¶
- 公共端点（健康检查、代币、兑换报价）— 不需要 API 密钥
- 交易端点（下单、兑换）— 不需要 API 密钥，但需要 EIP-712 签名
- 读取端点（余额、订单历史）— 需要 API 密钥
请参阅身份验证了解如何创建 API 密钥。
频率限制是多少？¶
应用内按操作分组限流：匿名流量使用可信来源 IP，已认证流量可使用解析后的 owner。API Key 的钱包限流另按组执行：read 10/s、trade 5/s、cancel 2/s、transfer 2/s、quote 50/s。批量报价按条目计数，不仅按 HTTP 请求数。边缘限流和部署配置可能增加约束，详见身份验证，有 Retry-After 时应遵守。
有 WebSocket API 吗？¶
目前不对公共用户提供。请使用 REST API 轮询订单状态更新。
安全性¶
资金如何保护？¶
Vault 保管、用户签名检查和合约角色权限共同发挥作用。紧急提款减少对 API 可用性的依赖，但仍需满足等待期、余额及代币转账条件，详见非托管设计。
如果 API 宕机怎么办？¶
在 Sera 上调用 emergencyWithdraw(token, amount)，等待至少 7,200 个区块，并在申请后的 14,400 个区块内执行。允许较小的正数金额，执行会消费整个申请；过期后调用会重新申请，详见紧急提款。
我的账户会被冻结吗？¶
合规筛查可能拦截受保护的 API 操作，包括通过 API 请求提款；筛查本身不转移您的资产。您可以按余额、请求、等待期及执行窗口规则使用链上紧急提款。账户读取和已签名取消有独立访问检查，详见合规说明。
支持¶
如何获取帮助？¶
- 邮箱：[email protected]
- Telegram：t.me/seraprotocol
- X (Twitter)：@seraprotocol