问题与回答
下第一单之前会问的那些问题,分好组,答得短。凡是答案属于契约而不是我们的习惯,API 文档里都有更详细的同一句话。
能量与价格
TRON 能量是什么?
一种网络资源,用来支付智能合约的执行。转出钱包上有足够的能量时,一笔 USDT 转账几乎不烧 TRX。
错过那 4 分钟窗口会怎样?
mode A 里费照扣:能量已经交付,您付的就是交付。mode B 里窗口一关我们就什么都不发,所以该笔以失败收尾,预留全额退回。每个订单都会带上这个窗口——把您的流程绕着它来设计。
错过发送窗口,两种模式的代价一样吗?
不一样。mode A 里能量已经交付,所以费照扣;mode C 也一样,那里没有转账要等,窗口一关该笔就直接过期。mode B 里窗口一关我们就不再广播:晚发出去的转账会碰上一个已经被收回委托能量的钱包,反倒烧掉您的 TRX。该笔以 failed 收尾,原因是 broadcast_window_missed,预留全额退回,为它买的能量算我们的损失。
资金与退款
怎么付费?
用预付的服务额度,以 TRX 计价:往您的专属地址转 TRX,然后把它花在服务上。价格在下单时锁定。
充值地址能收哪种代币?
TRX,而且只有 TRX。转到充值地址的 USDT 不会自动入账:我们不承担汇率风险,也不做兑换,所以这样的转账会被留出来交给人看,是否入账由我们逐笔决定。转错了币?写信告诉我们,别再转了。
充值多久能用?
3 个确认之后——大约十秒。之后余额分三部分显示:总额、为在途订单预留的部分,以及可用的部分。下单花的是可用的那部分,不是总额。
订单可以取消吗?
只能在开始采购之前;之后得到的答复是 order_not_cancelable,因为能量已经买下了。取消掉的订单会全额释放预留,一分不扣。
退款怎么算?
退回是自动的,永远不用开工单。规则只有一条:没交付的能量不收钱,预留会退回您的余额——交付失败、在采购开始前取消的订单、Auto-refill 当天没花完的部分。已经交付的能量照常扣费,不论您用没用。
安全与密钥
你们需要我的哪些密钥?
一把都不要。mode A 根本看不到您的交易。mode B 接的是您已经签好的交易,我们连它的一个字节都改不了。
你们接受多签的发送方吗?
mode B 不接受:交易必须只带一个所有者签名,Permission_id 为 0。多签账户的密钥集合放在链上,变动我们无从得知,所以我们没法保证广播会被接受。mode A 里您怎么签名我们完全不知道——转账是您自己广播的。
你们存什么,存多久?
mode B 里您签好的交易加密存放,在订单到达终态 7 天之后抹掉。订单、账目和充值记录会留着:那是账,我们有义务保存。除此之外这里没有您的任何东西——没有私钥,没有助记词,也不替您保管资金。
接入
有没有限额?
每把密钥每分钟 120 个订单,每个批量订单最多 500 笔转账。超了会收到 Retry-After,而不是被悄悄丢掉。
completed 到底是什么意思?
是能量已经交付,而不是您的转账已经发出。我们承诺的是交付,订单也就到此为止,所以 mode A 里 completed 可能在您还没发出任何东西时就到了。请盯着订单里出现的 send_before,而不是 ready 这个词:两秒一轮询,ready 很可能一次都碰不上。
幂等是怎么工作的?
Idempotency-Key 绑定的是随它一起到达的请求体原始字节。同一个键配上逐字节相同的请求体,拿回同一个订单;同一个键配上不同的请求体,是冲突;被校验挡下的请求不消耗这个键,改好请求体后可以用同一个键重来。请求体只序列化一次,重发同样的字节——键的顺序变了或多一个空格,就是另一个请求体了。
能先查地址再花钱吗?
可以,而且免费。GET /v1/address-check 会说出我们对某个钱包的了解,POST /v1/estimate 按订单同样的规则给最多 500 个收款方算价——包括其中哪些被代币合约列入黑名单。两者都不预留,也都不扣费。
您的账户
钱包能自己一直保持有能量吗?
可以——用一条 Auto-refill 规则:一个地址加一个每日预算。每笔转账之后能量都会补上;预算是当天花不过去的硬上限。
balance.low 的阈值该设多少?
这个数是您自己的设置——PATCH /v1/settings 里的 balance_low_threshold_trx;balance.low 是照着它发出的事件。合适的量级大致等于您一天的周转量:这样警告会在订单开始收到 insufficient_balance 的前一天到达,而不是顶替第一次拒绝。明显更低,事件就成了事后通知;明显更高,它就成了噪音。设成零就是关掉它。
有沙箱吗?有最低用量吗?
没有最低用量,没有订阅,闲着也不收钱。沙箱也没有:基础地址就是生产的那一个,再没有第二个。参考类接口、估价和 webhook 测试都不花钱,所以整合的大半在第一个订单出现之前就能做完。