Core:链上执行层
Core 验证交易条件与零知识证明,更新凭证状态,并在同一次链上调用中执行资金结算。一个实例支持多种 ERC-20 资产;各请求仍需按各自资产守恒,不能用一种资产抵扣另一种资产。
选择操作
| 你的目标 | 入口 | 资金何时移动 |
|---|---|---|
| 将公开钱包资产变为 Note | shield | 执行时从公开 payer 拉取 ERC-20 |
| 转移 Note、找零、混合入金或提现 | transact | 按证明中的输入与输出原子结算 |
| 建立后付款扣款权限 | createCredit | 纯创建不移动本金;可收取已授权服务费 |
| 使用已授权额度付款 | creditDraw | 从 owner 钱包实际拉款,生成普通 Note |
| 调整授权条款 | updateCredit | 不移动本金;可收取服务费 |
| 阻止后续扣款 | revokeCredit | 设置撤销位,不追回历史付款 |
私密花费授权、ERC-20 入金授权和 EVM 交易提交是三件事。中继可以提交已完成的证明,但不能修改已签名的收款方、金额、费用或截止时间。
接入顺序
- 选择网络与可信实例,核对地址、运行时代码身份、ABI 和证明产物。
- 用 SDK构造输出与操作,或依据完整 ABI 编码直接调用。
- 明确谁提供 ERC-20 余额、allowance、私密授权及网络 gas。
- 完成授权与证明后提交;核对成功回执、实际事件和所需最终性。
- 更新本地库存,保留操作标识以便重组和超时恢复。
只读查看实例
下面是完整的 TypeScript 只读示例,使用 Node.js 20+、ethers 及项目配置的 TypeScript 运行器。将 CHAIN_RPC_URL 和 CORE_ADDRESS 设置为你选定网络的链 RPC 与实例地址;它不签名或提交交易。
import { Contract, JsonRpcProvider, getAddress } from "ethers";
const rpcUrl = process.env.CHAIN_RPC_URL;
const address = process.env.CORE_ADDRESS;
if (!rpcUrl || !address) throw new Error("Set CHAIN_RPC_URL and CORE_ADDRESS");
const provider = new JsonRpcProvider(rpcUrl);
try {
const core = new Contract(getAddress(address), [
"function VERSION() view returns (uint256)",
"function CHAIN_ID() view returns (uint256)",
"function addressRegistry() view returns (address)",
"function activeNoteTreeId() view returns (uint256)",
"function circuitPaused() view returns (bool)",
], provider);
const [version, chainId, registry, treeId, circuitPaused] = await Promise.all([
core.VERSION(), core.CHAIN_ID(), core.addressRegistry(),
core.activeNoteTreeId(), core.circuitPaused(),
]);
console.log({ version, chainId, registry, treeId, circuitPaused });
} finally {
provider.destroy();
}
返回的版本号只是核对项之一,并不证明实例可信。树编号 0 表示尚无活动输出树,不能当成有效成员树。暂停状态也应与目标操作及实例管理策略一并检查。