跳到主要内容

双余额、凭证选择与找零

两种余额来自不同证据​

普通余额来自链上账户的原生币或 token 查询。隐私余额来自已认证解密、核对资产和成员关系、检查消费状态后的 Note 库存。不能对一个公开地址调用余额接口就得到其隐私余额。

资产标识至少固定网络、token 合约及精度;私密库存还需固定 Core 实例和账户范围。同名 USDT 跨链不可相加后直接用于一笔链上付款。

显示值推荐语义
普通余额当前账户在当前网络的公开余额
隐私总额本账户已核对的私密资产总额,与预留额分开展示
隐私可用额当前可用于创建新操作的已核对库存
预留 / 处理中已用于在途操作,结果未核对前不可再次选择
未知 / 同步中扫描未完整或证据不可用,不能显示为确定的 0

总资产可以合并两类估值,但应提供可见拆分,且不能把普通余额和私密库存的同一过渡资金重复计入。

系统匹配与手动选择​

系统匹配根据本次付款要求从可用库存中选择输入;具体优化算法由所用 SDK 和应用决定。手选仅展示同一账户、资产和部署下可使用的 Note,多选后重新核对消费与预留状态。列表金额只是查询时快照,不保证签名时仍可花费。

确认区至少显示本次需覆盖金额、已选总额、数量和差额。付款额为 120、已选为 130 时,在不含额外扣费的示例中,剩余为 10;若存在从同一输入扣除的费用,必须把它纳入所需金额,不能仍显示剩余 10。

  • 输入不足:禁止确认,显示还差多少,提供返回重选。
  • 付款金额增大:立即重算;不要因用户已选过一次而绕过余额门禁。
  • 输入金额恰好覆盖输出与费用:无剩余金额,不应承诺额外生成一张正值找零 Note。
  • 有剩余:展示其资产与接收账户;生成找零的真实行为取决于所选操作及输出构造。

不要混淆两类“找零”​

从 Note 库存花费后的剩余输出,与旧版产品流程中从公开余额额外入池来混淆付款金额,不是同一算法或同一种资金来源。手选 Note 的面板不能直接套用公开入金的百分比公式。更不能把旧版每 token 一个实例的约定自动套到新的 SDK/Core 部署。

生命周期​

在发起证明或广播前创建持久化操作并预留输入。结果未知时保留预留;只有对账能确认消费、回滚或释放。一个历史成员证明、HTTP 成功或单个节点查不到交易,都不足以让 Note 再次可选。

使用现有WalletSession接口维护库存与恢复;具体权限见Note 资金流。