spacetimedb-serialization

低レベルのエンコーディング、ワイヤ形式、モジュール ABI に関する作業には、このスキルを使用してください。

エンコーディングの基本事項

• タスクがカスタムツールの開発、プロトコルの調査、ABI 作業、またはシリアライズのデバッグであることが明確な場合を除き、生成済みの SDK やモジュール API を優先してください。
• BSATN は、積型の値をフィールドの値として順番にエンコードします。フィールド名はエンコードされません。
• BSATN は、文字列を u32 のバイト長と、それに続く UTF-8 バイト列としてエンコードします。
• BSATN は、整数および浮動小数点プリミティブのペイロードをリトルエンディアン形式でエンコードします。浮動小数点数には、生の IEEE ビット表現が使用されます。
• SATS JSON の積型の値は、フィールド順の配列またはフィールド名を使ったオブジェクトとして表現できます。
• SATS JSON は整数型を JSON の数値としてエンコードするため、通常の JavaScript の数値処理では、大きな 64 ビット、128 ビット、256 ビットの値の精度が失われることがあります。
• 和型の値はタグ付きユニオンです。タグは形式に応じて、バリアントのインデックスまたは名前になります。

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

ガイダンス

• ユーザーのタスクがシリアライズ、ABI、またはカスタムツールに関するものであることが明確な場合を除き、高レベルの SDK とモジュール API を優先してください。
• バイトレベルの例は、リファレンスの表記法に沿ったものにしてください。
• 通常のクライアント／サーバーコードの場合は、関連する SDK、リデューサー、テーブル、またはプロシージャのスキルに案内してください。