用途:当任务涉及 SpacetimeDB 的低层编码、线格式或模块 ABI 时使用,例如自定义工具、协议检查、ABI 工作和序列化调试。一般情况下应优先使用生成的 SDK 与模块 API。
主要能力与编码要点:BSATN 按字段顺序编码乘积值,不编码字段名;字符串以 u32 字节长度加 UTF-8 字节编码;整数和浮点原始载荷采用小端,浮点使用原始 IEEE 位表示。SATS JSON 的乘积值可按字段顺序写成数组,或按字段名写成对象;整数类型编码为 JSON 数字,因此 64、128、256 位大值在常规 JavaScript 数字处理中可能丢失精度。和值(sum)为带标签联合,标签是按变体索引还是名称取决于格式。
ABI 注意事项:WebAssembly ABI 函数在 wasm32 上使用 C ABI,常通过指针/长度对通信;多数宿主函数返回 u16,0 表示成功,输出通过 out 指针写入;部分 UTF-8 处理有损,无效字节可能被替换;缓冲区函数有明确所有权规则,不要复用已被消费的宿主缓冲区。
使用方式:需要 BSATN 时打开 references/bsatn.md;需要 SATS JSON 时打开 references/sats-json.md;需要 WebAssembly 模块 ABI 时打开 references/webassembly-abi.md。字节级示例应沿用参考文档的记法。常规客户端/服务端代码应回到对应的 SDK、reducer、表或 procedure 技能。
限制:资料未提供具体命令、安装方式、收费信息或完整 API 细节;除上述编码与 ABI 规则外,其他行为暂未提供。