Struct SnapshotExtractor 

pub struct SnapshotExtractor { /* private fields */ }

Extracts tar.xz snapshot archives with security validations.

Provides safe extraction by validating file paths to prevent directory traversal attacks and ensuring only expected database files are extracted.

Implementations

impl SnapshotExtractor

pub fn new() -> Self

Creates a new extractor with predefined expected files.

Expected files include SQLite database and WAL files:

• hopr_logs.db - Main database file
• hopr_logs.db-wal - Write-Ahead Log file
• hopr_logs.db-shm - Shared memory file

pub async fn extract_snapshot( &self, archive_path: &Path, target_dir: &Path, ) -> SnapshotResult<Vec<String>>

Extracts a tar.xz snapshot archive safely to the target directory.

Validates each file path to prevent directory traversal attacks and only extracts expected database files.

Arguments

• archive_path - Path to the tar.xz archive file
• target_dir - Directory where files will be extracted

Returns

Vector of successfully extracted file names (relative paths)

Errors

• SnapshotError::Archive - Invalid archive format or extraction failure
• SnapshotError::Io - File system errors during extraction
• SnapshotError::InvalidFormat - Path traversal attempt detected

Security

This method validates all file paths to prevent extraction outside the target directory (path traversal attacks).

pub async fn validate_archive( &self, archive_path: &Path, ) -> SnapshotResult<Vec<String>>

Validates that the archive contains expected files without extracting

Trait Implementations

impl Default for SnapshotExtractor

fn default() -> Self

Returns the “default value” for a type.