问题与回答
下第一单之前会问的那些问题,分好组,答得短。凡是答案属于契约而不是我们的习惯,API 文档里都有更详细的同一句话。
能量与价格
TRON 能量是什么?
一种网络资源,用来支付智能合约的执行。转出钱包上有足够的能量时,一笔 USDT 转账几乎不烧 TRX。
为什么比燃烧便宜?
烧 TRX 是按协议价给能量计价的,每单位 ~100 sun——这是链上参数,网络会不时调整,今年就调低了。我们成批地拿到代理来的能量,再按那个价格的一小部分卖出;此刻生效的价格在价格页上。
查看全部价格 →
错过发送窗口会怎样？
mode A 里费照扣:能量已经交付,您付的就是交付。mode B 里窗口一关我们就什么都不发,所以该笔以失败收尾,预留全额退回。每个订单都会带上这个窗口——把您的流程绕着它来设计。
我可以为一个钱包批量购买能量吗?
单笔订单可为一个钱包购买 65,000 至 50,000,000 个能量单位,按下单时生效的价格逐单位计费。每个钱包一份批量订单,若想知道市场此刻能补足多少数量,下单前随时可以用 POST /v1/estimate 免费查询,不会预留任何额度。
超过 131,000 单位,租期须为 1 小时或更长。订单是否为全有或全无,在首次购买之前就已决定(allow_partial);首次购买之后如有缺口,按已交付的部分计费。
价格页上的批量能量 →
错过发送窗口,两种模式的代价一样吗?
不一样。mode A 里能量已经交付,所以费照扣;mode C 也一样,那里没有转账要等,窗口一关该笔就直接过期。mode B 里窗口一关我们就不再广播:晚发出去的转账会碰上一个代理能量已被收回的钱包,反倒烧掉您的 TRX。该笔以 failed 收尾,原因是 broadcast_window_missed,预留全额退回,为它买的能量算我们的损失。
资金与退款
怎么付费?
用预付的服务额度,以 TRX 计价:往您的专属地址转 TRX,然后把它花在服务上。价格在下单时锁定。
充值地址能收哪种代币?
TRX,而且只有 TRX。转到充值地址的 USDT 不会自动入账:我们不承担汇率风险,也不做兑换,所以这样的转账会被留出来交给人看,是否入账由我们逐笔决定。转错了币?写信告诉我们,别再转了。
充值多久能用?
3 个确认之后——大约十秒。之后余额分三部分显示:总额、为在途订单预留的部分,以及可用的部分。下单花的是可用的那部分,不是总额。
订单可以取消吗?
只能在开始采购之前;之后得到的答复是 order_not_cancelable,因为能量已经买下了。取消掉的订单会全额释放预留,一分不扣。
退款怎么算?
退回是自动的,永远不用开工单。规则只有一条:没交付的能量不收钱,预留会退回您的余额——交付失败、在采购开始前取消的订单、Auto-refill 当天没花完的部分。已经交付的能量照常扣费,不论您用没用。唯一的例外:在补能覆盖我们为钱包预付给供应商的费用之前删除 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 的前一天到达,而不是顶替第一次拒绝。明显更低,事件就成了事后通知;明显更高,它就成了噪音。设成零就是关掉它。
我的运维团队能拿到只读权限吗?
可以。一个账户能容纳您邀请的任意多人,每人拥有四种角色之一——viewer、member、admin、owner——每个角色都能做到前一个角色能做的一切。viewer 只能查看余额、账本、订单和价格,不能花掉任何一分钱;member 可以创建订单和估价;admin 管理 API 密钥、webhooks、设置和团队;owner 就是这个账户本身。邀请只能授予 viewer、member 或 admin;owner 就是账户本身,不能被邀请。 邀请和角色都在控制台里管理,而且只管控制台:一个 API 密钥属于账户而非某个人,无论谁生成它,都拥有完整权限。
有沙箱吗?有最低用量吗?
没有最低用量,没有订阅,闲着也不收钱。沙箱是有的:https://sandbox.nrg.market/v1 就是同一套 API,跑在测试资金和模拟网络上,对应的 nrg_test_… 密钥由 sandbox-app.nrg.market 签发。它能验证您这一侧的接入——请求格式、状态、webhooks、时序——但验证不了能量真的 on-chain 到账,那只有在生产上才知道。在生产主机上,参考类接口、估价和 webhook 测试依旧不花钱。
https://sandbox.nrg.market/v1
sandbox-app.nrg.market