跳到主要内容

事件、成员关系与结果确认

钱包应从成功规范回执恢复实际状态,而不是根据“交易已发送”或某一条密文推断付款完成。一次 EVM 交易可能包含多个 Core 操作;一个操作可能有多个输出。

关联普通 Note 事件​

事件用途
NoteOperation操作标识、token、种类、输出数和费用条款
NoteStateTransition实际消费的来源树与 nullifier
PublicDeposit / PublicWithdrawal此操作的公开资金流
CommitmentsInserted实际承诺插入、树编号和连续位置
NoteOutputs按操作和实际区间交付加密输出
TransactAggregated聚合中的成员操作顺序

关联范围至少包含 Core 地址、规范区块、交易和 operationId。输出的连续区间必须完整属于同一次物理插入,不能跨插入拼接或与其他操作重叠。

operationId 是事件关联指纹,不是商户订单号,也不代替签名或证明。聚合中多个操作可共用一次物理插入;不能把 ERC-20 合并 Transfer 和各操作分摊事件重复计入到账金额。

只读解析公开入金​

下例是可复用的 TypeScript 函数,依赖 ethers,接收应用提供的链 provider、可信 Core 地址和交易哈希。它只提取匹配实例的成功入金事件,不验证 Note 私密开口、不建立索引完整性,也不保证最终性。

import { Interface, JsonRpcProvider } from "ethers";

export async function readDeposits(
provider: JsonRpcProvider, coreAddress: string, transactionHash: string,
) {
const receipt = await provider.getTransactionReceipt(transactionHash);
if (!receipt || receipt.status !== 1) throw new Error("No successful receipt");
const block = await provider.getBlock(receipt.blockNumber);
if (!block || block.hash !== receipt.blockHash) throw new Error("Noncanonical receipt");
const abi = new Interface([
"event PublicDeposit(bytes32 indexed operationId,address indexed token,address indexed payer,uint256 amount)",
]);
return receipt.logs
.filter(log => log.address.toLowerCase() === coreAddress.toLowerCase())
.flatMap(log => {
const event = abi.parseLog(log);
return event?.name === "PublicDeposit" ? [{
operationId: event.args.operationId,
token: event.args.token,
payer: event.args.payer,
amount: event.args.amount,
}] : [];
});
}

Credit 事件​

纯创建使用 CreditCreated。创建并首扣在同一调用中包含 CreditCreated 和 CreditDraw;后续扣款由 CreditStateTransition 和 CreditDraw 配对。

配对时校验同一 Core、规范交易、输出树、noteCommitment 和插入批次。Note 与支付金额只从 CreditDraw 计一次,Credit 后继则来自对应状态事件。

接收不等于可用​

承诺树为追加式树,普通 Note 与 Credit 共用物理存储,但二者业务语义不同。成员证明说明承诺属于某个已接受根;仍需检查当前 nullifier、Credit 撤销位和本地预留。

收到回执表示 included;应用还可要求原生 safe 或 finalized。区块数或等待秒数不能冒充原生最终性。重组后应撤销孤块影响,重新认证回执与库存,而不是永久累计已见事件。

使用 Protocol RPC获取候选与路径,并用会话恢复跟踪操作。