tiny.content.Reference

1/// The name of one piece of content passed by a caller to every read and every2/// publication: what it hashes to and how long it is. The struct holds an3/// identifier and an extent as plain values that copy freely.4pub const Reference = struct {5    identifier: Identifier,6    extent: Extent,78    /// Derives both halves of a reference from the complete bytes, as a caller9    /// does before publishing them, and returns `ContentExtentExceeded` when10    /// the byte length does not fit an extent.11    pub fn fromBytes(12        algorithm: Algorithm,13        bytes: []const u8,14    ) ReferenceError!Reference {15        return .{16            .identifier = Identifier.fromBytes(algorithm, bytes),17            .extent = try Extent.fromUsize(bytes.len),18        };19    }2021    /// Checks borrowed bytes against this reference before a sink hands them to22    /// a provider, or when a caller receives bytes elsewhere. The function23    /// returns `ContentExtentMismatch` when the byte length differs from the24    /// extent, and `ContentIdentifierMismatch` when the digest of the bytes25    /// differs from the identifier.26    pub fn verify(self: Reference, bytes: []const u8) ReferenceError!void {27        if (bytes.len != self.extent.toUsize()) {28            return error.ContentExtentMismatch;29        }30        if (!self.identifier.matches(bytes)) {31            return error.ContentIdentifierMismatch;32        }33    }34};

1pub const Reference = model.Reference;