TupleCodec.h File Reference

Content-addressing utilities for tuples. More...

#include "Types.h"
#include <cstdint>
#include <string>
#include <vector>

Go to the source code of this file.

Namespaces
namespace	nt
	Contains the Relational NT runtime managers and API facade.

Functions
std::string	nt::TupleCodec::Hash (const std::vector< Attribute > &attrs)
	Computes the SHA256 hex digest of the serialized tuple.
std::vector< uint8_t >	nt::TupleCodec::Serialize (const std::vector< Attribute > &attrs)
	Serializes a tuple's attributes to raw bytes for KV storage.
std::vector< Attribute >	nt::TupleCodec::Deserialize (const std::vector< uint8_t > &bytes)
	Reconstructs attributes from the bytes returned by Serialize().

Detailed Description

Content-addressing utilities for tuples.

Mirrors Sakura's hashing.ml and physical.ml:

• Hash() ≈ hash_tuple: deterministic SHA256 over sorted attribute content
• Serialize() ≈ Marshal.to_bytes: raw bytes stored as the KV value
• Deserialize() ≈ Marshal.from_bytes: reconstruct attributes from raw bytes

The hash input format is: "path_seg1/path_seg2/..|name1:value1;name2:value2;" where attributes are sorted by name for determinism.

The serialization format is a sequence of length-prefixed UTF-8 pairs: [uint32_le name_len][name bytes][uint32_le value_len][value bytes] ...

Function Documentation

Deserialize()

std::vector< Attribute > nt::TupleCodec::Deserialize

(

const std::vector< uint8_t > &

bytes

)

Reconstructs attributes from the bytes returned by Serialize().

Parameters

bytes

Bytes produced by Serialize().

Returns

Reconstructed attribute list in serialization order.

Hash()

std::string nt::TupleCodec::Hash

(

const std::vector< Attribute > &

attrs

)

Computes the SHA256 hex digest of the serialized tuple.

Equivalent to SHA256(Serialize(attrs)), so the value returned here matches the key returned by IStorageBackend::Put(Serialize(attrs)).

Parameters

attrs

Attribute set. Need not be pre-sorted.

Returns

64-character lowercase hex string.

Serialize()

std::vector< uint8_t > nt::TupleCodec::Serialize

(

const std::vector< Attribute > &

attrs

)

Serializes a tuple's attributes to raw bytes for KV storage.

Parameters

attrs

Attribute set. Need not be pre-sorted.

Returns

Serialized bytes.