Credit:后付款授信
Credit 授予 spender 在一定条件下从 owner 的 ERC-20 钱包扣款的权限。纯创建授权不会把本金存入 Core,也不会锁住 owner 余额或 allowance,因此授信额度不等于可兑付余额。若创建时组合首笔扣款,该次交易会按约定扣取实际资金,并生成付款 Note。
角色与结果
- Owner:提供实际 ERC-20 资金,设置额度和有效期,可更新或撤销。
- Spender:在权限范围内发起扣款,需要对应钱包授权。
- Note 接收方:接收扣款生成的普通 Note,可以不同于 spender。
- 提交者:支付 gas 并广播 EVM 交易,可由中继担任。
一次 draw 可组合多个 owner 的授信,但使用同一个 spender 和同一种 token。任一 payer 拉款失败,整个调用回滚,不产生部分付款。
生命周期
创建 → 当前 Credit 状态 → draw / update → 新的 Credit 状态
│ │
└── 原始撤销 shard / slot 不变 ──┘
│
owner 撤销
| 操作 | 输入与输出 | 证明与授权 |
|---|---|---|
createCredit | 新建一张状态;可组合首扣与普通 Note | owner 授权与创建证明 |
creditDraw | 消费 N 张状态,产生 N 张后继及一张普通 Note | spender 授权与 draw 证明 |
updateCredit | 消费旧状态并生成更新状态 | owner 授权与更新证明 |
revokeCredit | 设置原始槽位的撤销 bit | owner 直接调用或独立撤销签名;无需 ZK proof |
撤销不需要最新的私密状态,也不追回已经生成的普通 Note;它在协议暂停及电路暂停期间仍可执行。第三方 token 的行为仍可能影响相关费用拉取。
金额、限额与费用
singleLimit、dailyLimit、monthlyLimit 分别限制单次、UTC 日和 UTC 月用量;零表示关闭该项检查。availableCredit 与 unlimited 单独表示剩余授权总量:有限模式下零表示耗尽,不能把零当作无限。
扣款和用量按 gross 总扣款 计算;普通 Note 接收 gross − fee。创建、更新、撤销的可选服务费从 owner 钱包支付,不消耗授信扣款额度。
更新剩余额度使用增加或减少的 delta,不是绝对余额重写;更新不能清空历史累计用量。签名前核对费用、最终净额与有效期。包含首扣时,Core 首扣金额是 gross,而 IPP 中商户要求的首扣金额是 net;适配层须保持二者正确换算。
集成检查
- 明确 owner、spender、接收方、token、额度和 expiry。
- owner 创建授权后,spender 发现并认证自己的角色交付。
- 扣款前重新检查未消费、未撤销、限额、当前余额和 allowance。
- 用交易执行区块时间核对周期与截止时间;不要仅凭本机时间保证可扣款。
- 执行后原子对账后继 Credit 和输出 Note,按实际费用核对金额。
IPP 授信交互负责应用层请求与回执;Credit 本身不等于某个商户订单已完成。