估值、网络与费用展示
资产身份先于价格
不要按 symbol 查询后把结果应用到任意同名币。普通余额、私密库存和价格数据需要共同的网络与资产标识。原生资产与包装资产是两种资产,是否可用于某个隐私操作由部署和 SDK 决定,不能由同一个图标推断。
市场参考估值与兑换执行报价分开:前者用于资产页面,后者需按实际交易数量、路由、流动性、费用与滑点核对。一美元的展示价格也不保证能按一美元成交。
价格状态与总资产
| 状态 | 显示与处理 |
|---|---|
| 新鲜报价 | 显示数量与估值,可提供更新时间 |
| 仍允许展示的缓存价 | 明确参考性质,按应用新鲜度规则更新 |
| 过期或不可用 | 显示估值不可用,保留真实资产数量 |
| 部分资产缺价 | 总资产标为部分估值,不把未知资产当作零价值 |
| 测试网映射 | 不因存在美元参考值而承诺测试币可兑换价值 |
私密余额刷新与价格刷新可以独立失败。价格成功不意味着库存已同步;库存成功也不保证有报价。市场涨跌、账户入金和个人投资收益同样是不同概念。
网络选择与节点故障
网络切换应同时更新余额、token 标识、Core 部署、Gas 资产、浏览器链接和未完成操作的上下文。修改 RPC URL 不等于切换 chain ID;连接后核对实际网络。自定义节点是一个信任与可用性选择,不应因其能返回 HTTP 200 就认定链身份正确。
将只读请求的故障切换与交易重发分开。某节点超时可以触发查询重试,但不能据此重新构造一笔付款。广播同一份已签名交易与让用户重新签署新交易也不同。恢复规则见交易状态。
分开展示资金、网络费与服务费
签名前展示付款额、预估原生网络费、可选代付服务费和实际扣除资产。若支持用付款 token 折算网络费,须展示报价来源/有效性以及 token 金额;费用改变时重算可用余额、凭证覆盖额和最终条款。
- 估算值不是最终链上费用;最终以真实交易结果核对。
- 普通 token 余额足够,不代表原生 Gas 余额足够。
- 代付不会自动免除费用,也不保证所有网络和 token 可用。
- 本地估值不可直接替代代付服务的可执行报价。
- 对未知精度或报价失败明确报错,不静默按 18 位精度或固定汇率扣款。
代发的报价与授权边界见Broadcaster,商业收款的金额规范见请求约定。