ludic/tools/docgen/inventory.json
Orkuncakilkaya 9ae69e64b4
All checks were successful
docs / build-and-deploy (push) Successful in 3s
feat(stdlib): Crypto.* — SHA-256 + HMAC-SHA256, constant-time verify (#19)
The security-sensitive counterpart to the fast, non-cryptographic Hash.*
library: standard, test-vector-backed hashing for signed saves and message
integrity, kept in its own namespace so nobody reaches for the wrong tool.

  Crypto.sha256(s)                SHA-256 -> 64-char lowercase hex
  Crypto.hmac_sha256(key, msg)    HMAC-SHA256 -> 64-char hex
  Crypto.verify_hmac(key, msg, mac)  recompute + constant-time compare -> bool
  Crypto.hex(s)                   lowercase hex of a string's bytes
  Crypto.ct_equal(a, b)           constant-time string equality

The primitives are implemented from scratch in plain integer LLVM IR
(FIPS 180-4 / RFC 2104): no libc crypto, no data-dependent branches in the
compression rounds, so a given input hashes to the same 32 bytes on every
platform and run. Digests are returned as hex strings, not raw bytes, because
a `str` is null-terminated and a raw digest can contain a NUL. MAC checks use
a non-short-circuiting compare so timing does not leak how much of a forged tag
was correct.

Emitted on demand via g_uses_cryptort, mirroring the emit_hash prelude gate.
Scoped to the deterministic, known-answer-testable core; OS-backed
random_bytes (the one piece that can't be validated by test vectors) is left
for a follow-up.

Tested against published SHA-256 vectors (empty/"abc"/fox + 55/56/64-byte
multi-block padding) and HMAC-SHA256 vectors; wired into the self-host suite as
`crypto`. Docs: a new Crypto section with honest "what this protects / does
not" guidance, one page per method, all fences checked and in the inventory.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-08-30 13:37:02 +03:00

420 lines
No EOL
7.3 KiB
JSON

{
"annotations": [
"annot-queries",
"annot-computed",
"annot-onstart",
"annot-onquit",
"annot-onspawn",
"annot-ondespawn",
"annot-onattach",
"annot-ondetach",
"annot-onenable",
"annot-ondisable",
"annot-on",
"annot-public",
"annot-handles",
"annot-export",
"annot-reads",
"annot-writes",
"annot-sync",
"annot-owned",
"annot-server",
"annot-predicted",
"annot-toserver",
"annot-toclients"
],
"builtins": [
"fn-print",
"fn-string",
"fn-quit",
"fn-save",
"fn-load",
"fn-len",
"fn-push",
"fn-min",
"fn-max",
"fn-abs",
"fn-clamp",
"fn-fixed",
"fn-floor",
"fn-bytes",
"fn-words",
"fn-ui_build",
"fn-arg_count",
"fn-arg",
"fn-exit",
"fn-run",
"fn-getenv",
"fn-read_char",
"fn-file_write",
"fn-file_stdout",
"fn-file_stderr"
],
"collision": [
"collision-rects",
"collision-point_rect",
"collision-circles",
"collision-rect_circle"
],
"color": [
"color-rgb",
"color-rgba",
"color-lerp",
"color-darken",
"color-lighten",
"color-with_alpha"
],
"control": [
"kw-if",
"kw-while",
"kw-for",
"kw-in",
"kw-match",
"kw-machine",
"kw-state",
"kw-become"
],
"ease": [
"ease-in",
"ease-out",
"ease-in_out",
"ease-back",
"ease-bounce"
],
"ecs": [
"kw-spawn",
"kw-despawn",
"kw-query",
"kw-self",
"kw-enable",
"kw-disable",
"kw-attach",
"kw-detach",
"fn-world_get",
"fn-world_set",
"fn-world_has",
"fn-world_count",
"fn-world_spawn",
"fn-world_size",
"fn-world_save",
"fn-world_load",
"fn-world_field_id",
"fn-world_prop_id",
"fn-world_model_id",
"fn-world_kind",
"fn-world_register_prop",
"fn-world_attach_dyn",
"fn-world_detach_dyn",
"fn-world_query_next"
],
"events": [
"kw-event",
"kw-emit",
"kw-cancel",
"kw-cancellable"
],
"input": [
"input-key"
],
"list": [
"list-len",
"list-push",
"list-clear",
"list-first",
"list-last",
"list-pop",
"list-swap",
"list-contains",
"list-index_of",
"list-reverse",
"list-insert",
"list-remove_at",
"list-remove",
"list-sort"
],
"map": [
"map-size",
"map-row",
"map-tile"
],
"math": [
"math-min",
"math-max",
"math-abs",
"math-clamp",
"math-sign",
"math-floor",
"math-ceil",
"math-round",
"math-lerp",
"math-inverse_lerp",
"math-remap",
"math-sqrt",
"math-sin",
"math-cos",
"math-tan",
"math-hypot",
"math-dist",
"math-dist2",
"math-deg_to_rad",
"math-rad_to_deg",
"math-posmod",
"math-wrap",
"math-ping_pong",
"math-snapped",
"math-move_toward",
"math-smoothstep",
"math-atan2",
"math-asin",
"math-acos"
],
"memory": [
"memory-bytes",
"memory-words",
"memory-copy",
"memory-fill",
"memory-peek",
"memory-poke"
],
"network": [
"network-send",
"network-poll",
"network-serialize",
"network-apply",
"network-owner",
"network-set_owner",
"network-is_server",
"network-is_owner",
"network-local_id"
],
"networking": [
"fn-net_send",
"fn-net_poll",
"fn-owner",
"fn-set_owner",
"fn-is_server",
"fn-is_owner",
"fn-local_id",
"fn-serialize",
"fn-apply"
],
"operators": [
"op-arith",
"op-compare",
"op-logical",
"op-bitwise",
"op-range",
"op-assign",
"op-access",
"op-interp",
"op-literals",
"op-comment"
],
"phases": [
"phase-fixedupdate",
"phase-input",
"phase-lateupdate",
"phase-render",
"phase-start",
"phase-update"
],
"random": [
"random-range",
"random-chance",
"random-seed",
"random-value",
"random-int",
"random-sign"
],
"save": [
"save-write",
"save-read"
],
"scenes": [
"kw-scene",
"kw-layer",
"kw-on",
"kw-enter",
"kw-exit",
"kw-start"
],
"screen": [
"screen-clear",
"screen-fill_rectangle",
"screen-draw_rectangle",
"screen-put_pixel",
"screen-draw_text",
"screen-draw_number",
"screen-show",
"screen-width",
"screen-height",
"screen-status",
"screen-line",
"screen-circle",
"screen-fill_circle",
"screen-triangle",
"screen-fill_triangle",
"screen-sprite",
"screen-sprite_scaled"
],
"structure": [
"kw-program",
"kw-property",
"kw-model",
"kw-handler",
"kw-phase",
"kw-const",
"kw-var",
"kw-let",
"kw-function",
"kw-return",
"kw-import",
"kw-extern",
"kw-ui",
"kw-enum"
],
"system": [
"system-arg",
"system-arg_count",
"system-exit",
"system-run",
"system-env",
"system-read_char",
"system-file_open",
"system-file_read",
"system-file_write",
"system-file_seek",
"system-file_tell",
"system-file_close",
"system-stdout",
"system-stderr"
],
"text": [
"text-length",
"text-char_at",
"text-slice",
"text-starts_with",
"text-ends_with",
"text-contains",
"text-index_of",
"text-equals",
"text-concat",
"text-to_int",
"text-from_int",
"text-upper",
"text-lower",
"text-trim",
"text-repeat",
"text-pad_left",
"text-pad_right",
"text-split",
"text-join",
"text-replace"
],
"time": [
"time-frame",
"time-delta",
"time-elapsed",
"time-now",
"time-since"
],
"types": [
"type-bool",
"type-byte",
"type-entity",
"type-fixed",
"type-fixeds",
"type-int",
"type-pointer",
"type-pointers",
"type-slices",
"type-string",
"type-void",
"type-words",
"type-vector"
],
"world": [
"world-get",
"world-set",
"world-has",
"world-count",
"world-size",
"world-spawn",
"world-save",
"world-load",
"world-prop_id",
"world-field_id",
"world-model_id",
"world-kind",
"world-register_prop",
"world-attach",
"world-detach",
"world-query_next"
],
"vector": [
"vector-make",
"vector-zero",
"vector-x",
"vector-y",
"vector-add",
"vector-sub",
"vector-scale",
"vector-dot",
"vector-length",
"vector-distance",
"vector-normalize",
"vector-lerp",
"vector-rotate",
"vector-angle",
"vector-from_angle"
],
"duration": [
"duration-seconds",
"duration-minutes",
"duration-hours",
"duration-days",
"duration-as_seconds",
"duration-as_minutes",
"duration-as_hours",
"duration-as_days"
],
"date": [
"date-new",
"date-year",
"date-month",
"date-day",
"date-weekday",
"date-is_leap",
"date-days_in_month",
"date-to_epoch",
"date-add_days",
"date-diff_days"
],
"datetime": [
"datetime-from",
"datetime-date",
"datetime-add",
"datetime-year",
"datetime-month",
"datetime-day",
"datetime-weekday",
"datetime-hour",
"datetime-minute",
"datetime-second",
"datetime-format",
"datetime-parse"
],
"clock": [
"clock-now",
"clock-set",
"clock-advance",
"clock-reset"
],
"crypto": [
"crypto-sha256",
"crypto-hmac_sha256",
"crypto-verify_hmac",
"crypto-hex",
"crypto-ct_equal"
]
}