迪迪 | sera protocol (@deedeedeecrypto) profile picture

野生交易员 | 在 @seraprotocol 搞链上外汇

Metaverse
Joined January 2022
POST /swap 的返回里,success 和 status 各管一件事。 success: true 是这笔提交被接下了;status: pending 是这张单子现在的状态。trade_id 就是订单号,之后用 GET /orders/{order_id} 跟进。 所以前端先显示「已提交」,查到最终状态再更新,用户看到的每一步都对得上。 @seraprotocol
1
6
Sera 的 gas 是按笔算的,固定一笔约 1 美元,报价的 fee_breakdown 里写着 gas_cost_usd。 所以同样一笔钱,拆成三次发和一次发,差的不是三倍费率,是两美元的固定成本。 做批量结算的,先把能合的合起来再问价,比在费率上抠有用。 @seraprotocol
1
6
同一个 swap,钱包有时弹两次,有时只弹一次。 看报价里的 initialDepositAmount。大于 0 是从钱包存入:带 permit,route_params 和 permit 各签一次,POST /swap 交四个字段。 等于 0 是 equity-only:permit 为 null,只签 route_params,请求体只剩 uuid 和 signature。 @seraprotocol
2
18
POST /swap 的请求体只有四个字段:uuid、signature、permit_signature、permit_deadline。 没有金额,没有币种,没有收款地址。这些问价时就定好了,都在 route_params 里,signature 签的就是它。 提交只是告诉服务器:哪份报价,我签过了。所以这一步没有金额能填错。 @seraprotocol
2
15
Sera 的报价,expires_at 大概就是 30 秒。 价格是活的,拿到就该决定签不签。过期了就重新问一次:问价不用鉴权,也不会动你的钱。 所以别把报价存起来当汇率表用,要用的时候再问。 @seraprotocol
2
38
一次要比几条通道的价,用 POST /swap/quote/batch。 一个来回最多 50 个报价,比循环调单个接口省事很多。 注意批量请求没有幂等:重试一次就会生成新的报价和新的 uuid,成交的时候用最新那个。 @seraprotocol
1
12
POST /swap 要签的 Intent,第一个字段叫 taker。 不叫 user,也不叫 sender。Sera 底下是订单簿,你发 swap 就是去吃别人挂着的单,你是吃单方,挂单的才是 maker。 说白了,你签的是一张吃单:最多付 maxInputAmount,至少收 minOutputAmount,过了 deadline 就作废。 @seraprotocol
1
13
做市的人会在意这一条:Sera 有自成交保护。 你挂着一笔单,又发了一笔会吃到它的 swap,接口会返回 STP_BLOCKED,不会让你自己跟自己成交。 两边同时挂单的时候,这个能省掉不少麻烦。 @seraprotocol
1
13
之前说过 batch 适合一次比几条通道,它还有个用法。 POST /swap/quote/batch 里每一项都跟单个问价的请求体一样,to_token 和 recipient 每项自己填。要给 5 个供应商付 5 种币,一次请求就能把 5 个价拿回来。 成交还是每笔单独签 Intent,收款地址签进去就锁定了。 @seraprotocol
2
52
gas 从哪边出,Sera 让你自己选。 receive_less:付出去的钱不变,gas 从到手的里扣,不填就是这个。 pay_more:到手的数不变,多付一点把 gas 补上。 要对方刚好收到一个整数,比如付货款,就用 pay_more。 @seraprotocol
2
26
GET /api/v1/tokens 按 currency 分组,40 个币一共 22 种货币。 欧元最多,有 10 个不同的币;澳元 4 个;另外 6 种货币各 2 个,剩下 14 种各 1 个,令吉、新元、日元都在里面。 同一种货币有好几个发行方,所以选币看地址,别只看货币代码。 @seraprotocol
2
24
数了一下 Sera 的公开接口:40 个币,780 个市场。 780 正好是 40 × 39 ÷ 2。也就是说每个币都和另外 39 个各有一个直接市场,MYR 也是 39 个。 任意两个币之间都有直接的盘口,不用先换成美元再换回来。 数据:GET /api/v1/tokens 和 /markets,11 月 13 日读取。 @seraprotocol
2
17
问价请求里的 expiration,就是签进 Intent 的 deadline。 范围写在文档里:必须晚于现在,最晚到「现在加 365 天,再减 300 秒」。单位是 Unix 秒。 所以这个检查在本地先做掉就行,不用发出去再等结果。 @seraprotocol
2
47
780 个市场里,USDC 只出现在 39 个。 GET /api/v1/markets 返回 780 个市场。USDC 当计价币的 27 个(X/USDC),当基础币的 12 个(USDC/X),两条腿合起来 39 个。剩下 741 个符号里没有 USDC。 所以这张表不是围着美元搭的。/markets 公开、不用 key,自己拉下来数一遍。 @seraprotocol
1
29
同样是过期,Sera 分成两个码,差在时间点。 还没提交,报价快照或签名里的 deadline 就过了:QUOTE_STALE。交易上链之前 deadline 到了:INTENT_DEADLINE_EXPIRED。 两个码文档给的处理都是重新问价,重试可以走同一个分支。deadline 是你自己签进去的,过了就不会成交。 @seraprotocol
2
20
报价响应里没有「预计到手」这个字段。 整个响应的数量字段只有一个:minOutputAmount,而且它是下限不是估值。这意味着你的界面上写不出「预计收到 X」——那个数接口从来没给过,写出来就是自己编的。 能写的只有一句:至少拿到 X。 @seraprotocol
2
14
换成 pay_more,你填的 from_amount 就不是上限了。 文档的说法是:保住到手的目标数,把总输入预算调高。gas 改由付款这边补,所以这笔最多付多少,要看 route_params 里的 maxInputAmount,它可以比 from_amount 高。 签之前读一遍这个数,它才是你签下去的上限。 @seraprotocol
2
27
一个币种可以有十个代币。 GET /tokens 返回 40 个代币、22 个币种,光欧元就占十个:EUR0、EURAU、EURC、EURE、EURI、EUROP、EURQ、EURR、EURS、VEUR。 所以「EUR」在这套接口里不是一个标识,十个地址都是欧元。选币那一层得按地址走,想按币种展示,映射要自己维护。 @seraprotocol
2
27
同一个钱包同时问两个价,拿到的 permit nonce 是同一个。 nonce 只算已经被接受的单,没交的报价不算。先交的那笔一被接受,另一笔的 nonce 就旧了,提交会回 409 QUOTE_STALE,文档里 409 的头一个原因就是这个。 报价没被消耗,重新问价再签就行。要连发就一笔一笔来。 @seraprotocol
2
18
默认模式下,你填多少,最多就付多少。 gas_mode 不填就是 receive_less:付出去的数不动,gas 从到手的那边扣。文档示例里 from_amount 填 1000000,返回的 route_params.maxInputAmount 也是 1000000。 签名前对一下这两个数:一样,就说明 gas 没加到你付的钱上。 @seraprotocol
2
24