Fin Text Format

Builtins are a curated set of extensions for universal or common data types. Compliant fin libraries support builtins out of the box.

• Stable. Booleans
• Unstable. Bytes, Timestamps
• Proposed. UUID, Sets, ... more

Booleans

stable

Self-explanatory. The symbols true or false

Bytes

unstable

• Represent a raw byte array that is the concatenation of hexadecimal strings.
• Uses a tagged array with fin:bytes as the extension symbol.
• Raw strings will be auto-wrapped with a space between octets.
• Uppercase will be converted to lowercase.
• Non-hex code points are invalid.

# inline escaped strings
b1 = fin:bytes["d14a028c2a3a2bc9"]
b2 = fin:bytes[
  # concatenation
  "d14a028c2a3a2bc9", "476102bb288234c4"
  "15a2b01f828ea62a", "c5b3e42f"
]
 
# expanded raw strings
b3 = fin:bytes[
  # spaced octets, auto-wrapped using first line
  | d1 4a 02 8c 2a 3a 2b c9
  | 47 61 02 bb 28 82 34 c4
  # reset auto wrap
  | 15 a2 b0 1f
  | 82 8e a6 2a
  | c5 b3 e4 2f
]

Internet Timestamps

unstable

• Represents an instant in time with an offset from UTC.
• Uses a tagged array with fin:timestamp as the extension symbol.
  • Contains a single escaped string for the timestamp.
• Format is RFC3339

fin:timestamp["2024-02-26T03:01:13.644Z"]