DRISL — Deterministic Representation for Interoperable Structures & Links

Introduction

Deterministic encodings that produce the same stream of bytes for any given data with the same semantics are particularly useful in a content-addressed context. DRISL provides that, compactly encoded as CBOR. Additionally, it supports CBOR's Tag 42 to compactly encode CIDs ([cid]) as bytestreams. This CID can be used for content-addressed linking between DRISL documents (such as MASL documents), or to resources (best wrapped in MASL documents where renderability as web documents or web apps is desired).

DRISL does not fork CBOR, CDE, or dCBOR ([cbor], [cde], [dcbor]), but it is a subset of features defined in CBOR "Core" ([cborc]), first defined in the earliest CBOR RFC and largely unaffected by refinements made since. Any decoder for any version of CBOR since v1 will be able to read DRISL content as conformant CBOR, and with enough carefully configuration of a powerful CBOR library and in some case pre-processing of the data, DRISL can be encoded anywhere CBOR can.

Format

DRISL is an application profile of CBOR ([cbor]) that subsets the more established [cborc] profile, with the following additional constraints:

• Implementations MUST support Tag 42 in the CBOR Tag registry; this tag compactly encodes CIDs as bytestrings, as specified below.
• Implementations MUST reject all other tags, including any of the tags listed in the section 3.4 of RFC 8949.
• Implementations MUST reject map keys that are not strings.
• Floating-point numbers MUST always be encoded as a 64-bit IEEE 754 binary floating-point, never as a "half-precision" (16-byte, major 7-25) or "single-precision (32-byte, major 7-26)" CBOR key. NOTE: It is RECOMMENDED that users avoid encoding floating-point numbers as much as possible to minimize interoperability and tooling issues.
• Encoders MUST NOT encode any simple values other than true, false, and null (20, 21, and 22 in section 3.3 of [rfc8949]).

All other requirements are as CBOR/c ([cborc]).

CIDs in CBOR

CIDs in CBOR are stored in binary format, as CBOR bytestrings under custom tag 42. For historical reasons the null byte 0x00 is prepended to the binary CID before storing in CBOR.

For more information, see the [cbor-tag42] appendix to the [drisl] specification.

References

[cbor]

C. Bormann. & P. Hoffman. Concise Binary Object Representation (CBOR). October 2024. URL: https://www.rfc-editor.org/info/rfc8949

[cbor-tag42]

J. Caballero. Binary Content Identifiers. May 2025. URL: https://www.ietf.org/archive/id/draft-caballero-cbor-cborc42-00.html#name-binary-content-identifiers

[cborc]

A. Rundgren. Core CBOR Platform Profile. April 2025. URL: https://datatracker.ietf.org/doc/draft-rundgren-cbor-core/

[cborc-42]

J. Caballero, R. Berjon. The tag-42 profile of CBOR Core. May 2025. URL: https://datatracker.ietf.org/doc/draft-caballero-cbor-cborc42/

[cde]

C. Bormann. CBOR Common Deterministic Encoding (CDE). October 2024. URL: https://datatracker.ietf.org/doc/html/draft-ietf-cbor-cde-06

[cid]

Robin Berjon & Juan Caballero. Content IDs (CIDs). 2025-09-22. URL: https://dasl.ing/cid.html

[dcbor]

W. McNally, C. Allen, C. Bormann, & L. Lundblade. dCBOR: A Deterministic CBOR Application Profile. October 2024. URL: https://datatracker.ietf.org/doc/draft-mcnally-deterministic-cbor/

[drisl]

Robin Berjon & Juan Caballero. DRISL — Deterministic Representation for Interoperable Structures & Links. 2025-09-22. URL: https://dasl.ing/drisl.html

[rfc8949]

C. Bormann, P. Hoffman. Concise Binary Object Representation (CBOR). December 2020. URL: https://www.rfc-editor.org/rfc/rfc8949