#pragma once #include "evo/persistence/region_lease.hpp" #include #include #include #include #include #include #include // Immutable content-addressed payload store on a trusted local/mounted volume // (ADR-0061). Linux only. One namespace directory per world/region; the object // key is the lowercase hex SHA-256 of its bytes. There is no delete or overwrite: // unreferenced uploads are orphans and remain until a reachability-proven GC exists. namespace evo::persistence { enum class ObjectError : std::uint8_t { invalid, // Bad root, namespace or object reference; nothing done. missing, // No object with that key. corrupt, // Length or digest mismatch, or not a regular file: quarantine. bounds, // Larger than the configured maximum; rejected before allocation. io, // Write/sync/link failure; the object is absent or unverified. }; struct VerifiedObject { Sha256Digest sha256{}; std::uint64_t bytes{}; friend bool operator==(const VerifiedObject&, const VerifiedObject&) = default; }; class FilesystemObjectStore { public: // trusted_root must be an existing real directory (not a symlink). Namespace // directories w/r are created 0700 and their parents synced. [[nodiscard]] static std::expected, ObjectError> open(const std::filesystem::path& trusted_root, RegionKey key, std::size_t max_object_bytes); FilesystemObjectStore(const FilesystemObjectStore&) = delete; FilesystemObjectStore& operator=(const FilesystemObjectStore&) = delete; FilesystemObjectStore(FilesystemObjectStore&&) = delete; FilesystemObjectStore& operator=(FilesystemObjectStore&&) = delete; ~FilesystemObjectStore(); // Writes a private temporary file, fsyncs it, links it to its key without // replacing anything, then fsyncs the directory. Identical bytes already stored // are verified and reused; a differing existing object is corrupt, never replaced. [[nodiscard]] std::expected put(std::span bytes) const; // Reads only an exact-length regular file and verifies its SHA-256. [[nodiscard]] std::expected, ObjectError> get(const VerifiedObject& object) const; [[nodiscard]] const std::filesystem::path& directory() const noexcept { return directory_; } private: FilesystemObjectStore(std::filesystem::path directory, int descriptor, std::size_t maximum); std::filesystem::path directory_; int descriptor_; std::size_t maximum_; }; } // namespace evo::persistence