SuperAPI AI 工具集

subsystem-summary-of-rust

编程与开发

查看项目

更新于 10-16 06:43

技能介绍

用途:该技能提供 stellar-core 中 Rust 子系统(非 Soroban 部分)的令牌高效摘要。Rust 子系统以静态库 rust_stellar_core 形式链接进 C++ 二进制,通过 cxx 1.0.97 建立双向 FFI 桥。

主要能力:Soroban 宿主函数调用(按协议版本分发);交易资源费、租金费与租金写入费计算;Soroban 合约 WASM 模块缓存;向 C++ 暴露 Rust 原生 i128;Base64 编解码;用 ed25519-dalek 做 Ed25519 验签;将 Rust log 输出路由到 C++ spdlog;用 stellar-quorum-analyzer SAT 求解器做仲裁交集检查;以及 rustc 版本、可执行路径、回溯捕获、XDR 版本校验等工具函数。

使用方式:桥接定义在 src/bridge.rs 的 #[cxx::bridge] 模块中,含共享类型、extern "Rust" 与 extern "C++" 三段。C++ 调 Rust 时数据以 CxxBuf(UniquePtr<CxxVector<u8>>)传入,Rust 以 RustBuf(Vec<u8>)返回;XDR 序列化经 ReadXdr/WriteXdr,深度上限 1000。RustBridge.h/.cpp 由 cxxbridge 生成。模块缓存通过 new_module_cache() 创建,再调用 compile、shallow_clone、evict_contract_code、clear、contains_module、get_mem_bytes_consumed。

适用场景:需要了解 stellar-core 中 C++ 与 Rust 交互、Soroban 多协议宿主架构、费用计算或模块缓存生命周期的开发者。

限制:crate 为 staticlib,edition 2021,rust-version 1.82.0;可选特性有 tracy、next、testutils、unified。所有可失败函数返回 Result,cxx 将其转为 C++ rust::Error 异常;invoke_host_function 与仲裁检查用 panic::catch_unwind 防止跨 FFI 展开;仲裁检查内存上限为硬中止。contract_code_memory_size_for_rent 仅对协议 ≥ 23 有效。其余细节暂未提供。