ipfrs-core 0.1.0

Core content-addressing primitives and data structures for IPFRS
Documentation

ipfrs-core

Core primitives and types for IPFRS (Inter-Planet File RUST System).

Overview

ipfrs-core provides the fundamental building blocks for IPFRS, including:

  • CID (Content Identifier): Multihash-based content addressing
  • Block: Raw data blocks with CID verification
  • IPLD Codec: Serialization/deserialization for TensorLogic types
  • Error Types: Unified error handling across all IPFRS crates

Key Components

CID & Multihash

  • Content-addressable identifiers compatible with IPFS
  • Support for multiple hash algorithms (SHA256, BLAKE3, etc.)
  • Integration with tensorlogic::ir::Term for logic-aware addressing

Block Management

  • Immutable data blocks with cryptographic verification
  • Zero-copy access patterns for performance
  • Memory-safe handling with Rust ownership

IPLD Integration

  • Merkle DAG structures for content-addressable graphs
  • Custom codec for TensorLogic IR serialization
  • Support for Safetensors and Apache Arrow formats

Architecture

This crate sits at the foundation of the IPFRS stack:

ipfrs-interface (API)
    ↓
ipfrs-core (Types & Primitives)
    ↓
ipfrs-storage | ipfrs-network | ipfrs-semantic

Design Principles

  • Zero-Copy: Minimize memory allocations and data copying
  • Type Safety: Leverage Rust's type system for correctness
  • Protocol Compatibility: Wire-compatible with IPFS where applicable
  • TensorLogic Native: First-class support for neural-symbolic AI types

Dependencies

  • multihash - Content addressing
  • cid - CID implementation
  • serde - Serialization framework
  • bytes - Efficient byte buffer management

References