SuperAPI AI 工具集

gear-gstd-api-map

编程与开发

查看项目

更新于 10-15 21:50

技能介绍

用途:面向 Gear/Vara 构建者,以 API 优先的方式做设计。从 gstd 出发,仅在需要确认限制、gas 形态或底层行为时才下沉到 gcore 或 gsys。

主要能力:按模块梳理 gstd API。msg 模块含 send、reply、send_delayed、send_for_reply、send_bytes、push-plus-commit,用于发送消息、回复、延迟派发与等待回复;exec 模块含 gas_available、block_height、wait、wait_for、wake、reply_deposit、exit,用于读取执行上下文、进入 waitlist 与唤醒;prog 模块含 create_program、create_program_bytes、create-for-reply,用于创建子程序并可选延迟与 gas 限制;reservations 模块含 ReservationId::reserve、unreserve 与预留池,用于需保持 gas 预算的未来区块工作;另有 async 辅助。

使用方式:从构建者意图出发而非原始系统调用。先选 gstd 家族(msg、exec、prog、reservations 或 async 辅助),优先使用能保持合约语义的最高层 API,类型化发送与回复优先,仅在有意使用原始载荷或调试编解码时用字节。再检查设计约束:区块延迟执行、回复存款、预留生命周期、waitlist 暴露、gas 预算以及 Sails 客户端的路由前缀稳定性。需要确认包装行为时下沉到 gcore,仅在需要精确系统调用名、可失败性或控制与获取区别时用 gsys。

适用场景:规格或架构说明需判断程序能否发送、等待回复、自调度、预留 gas 或创建子程序;在类型化载荷、原始字节、分阶段 push-plus-commit 或输入转发 API 间选择;设计依赖 #[gstd::async_main]、for_reply 流程、延迟工作、ReservationId 或 prog::*;调试时确认高层 API 实际到达哪个 gr* 系统调用家族。

限制:若任务实际涉及运行时基准测试、系统调用维护覆盖或仅 ethexe 行为,应停止使用本技能。原始 gsys::gr_* 名称仅作确认工具,不作为首要设计词汇;设计说明应以消息流、回复、区块和合约表述,而非系统调用序列。资料未提供具体安装命令与代码示例。