Rust 接入
Rust SDK 为原生应用与服务提供公开 Wallet、无状态准备、本地证明及独立 Session 能力。应用自行管理账户、签名、查看解密和提交;SDK 不读取助记词或系统密钥库。
选择 crates
invisi-sdk 提供操作编排;invisi-sdk-primitives 与 invisi-sdk-protocol 提供纯模型与编码;invisi-sdk-prover、invisi-sdk-rpc 和 invisi-sdk-session 分别负责证明、传输和持久化库存。需要 SQLite 时启用 Session 对应 feature。
使用同一兼容发布组,具体选择见版本与兼容性。安装前确认所选 crates 版本导出本文使用的方法;接口版本不代表 crates.io 已提供对应包。
离线构造 Note
下面是完整 Rust 程序,依赖已配置兼容版本的 invisi-sdk 与 alloy-primitives,不需私钥、链服务或 BB。保存为项目的 src/main.rs 后使用 cargo run。合约地址仅为离线演示,不能用于真实支付。
use alloy_primitives::{address, U256};
use invisi_sdk::{note::ProtocolContext, sdk::{NoteOutput, Wallet}};
fn main() -> Result<(), Box<dyn std::error::Error>> {
let recipient = Wallet::from_address("0i0e0525SFRf53yh2aljmm3sn9JQ5nJk7LqWt0G2ajnRY2pe698y550QXhp9uELXpcCZMf5Y608rRDJ68jJgfEWy5j7U5e5eVNPVz8vW2W2kmyw4p9lVLwW3z3WeFHQs5KdfR980CX")?;
let context = ProtocolContext {
chain_id: 31337,
protocol_address: U256::from(0x1234),
};
let output = NoteOutput::for_recipient(
context,
address!("0000000000000000000000000000000000005678"),
&recipient,
U256::from(10),
Vec::new(),
)?;
println!("{}", output.commitment());
Ok(())
}
U256::from(10) 是 token 最小单位。这里只构造意图与加密交付,不会产生已入金的链上 Note。
操作流程
Wallet::from_address解析完整0i材料;身份型操作单独使用 owner 地址。- 配置可信部署、独立链读取、Protocol RPC 与本地 prover。
- 准备 Note 或 Credit 操作,固定最终费用及执行模式。
- 对需要私密钱包授权的操作,导出
export_wallet_authorization()的 typed data,交给应用签名,再with_wallet_signature()附加。 - Shield 使用
ready(),需要 ZK 证明的私密操作使用匹配的prove(...)后取得calldata。Credit 撤销走独立 owner 授权路径,不生成 ZK 证明。应用独立签署并提交 EVM 交易。 - 使用持久化日志关联哈希并对账,保留不确定输入的预留。
DeliveryDecryptor 返回认证明文或确定非收款人的 None;错误应拒绝批次而不推进库存游标。Note 与 Credit 分开同步和计量,Credit 创建不增加可用资金余额。
原生应用使用 FFI 时,应单独核对其能力范围;纯密码学接口不意味着包含 HTTP、证明和 Session。浏览器运行时选型见本地证明。
下载完整离线示例