Struct VoidContext 

pub struct VoidContext {
    pub paths: RepoPaths,
    pub crypto: CryptoContext,
    pub repo: RepoMeta,
    pub seal: SealConfig,
    pub network: NetworkConfig,
    pub user: UserConfig,
}

Application-level DI container for a single CLI invocation.

Created once (via build_void_context in the CLI crate) and threaded through the call stack. Subsystems can be borrowed independently.

Fields

paths: RepoPaths

Where the repository lives on disk.

crypto: CryptoContext

Encryption vault + identity keys.

repo: RepoMeta

Repository identity (id, name, secret).

seal: SealConfig

Compression / shard sizing settings.

network: NetworkConfig

Transport configuration (IPFS, Tor, remotes).

user: UserConfig

Author identity (name, email).

Implementations

impl VoidContext

pub fn open_store(&self) -> Result<FsStore>

Open the object store for this repository.

pub fn fetch_object<B: EncryptedBlob>( &self, remote: &dyn RemoteStore, cid: &VoidCid, ) -> Result<B>

Fetch a typed encrypted blob, local-first with remote fallback.

Checks the local object store first. On miss, fetches raw bytes from the remote (which handles CID verification), stores locally, and wraps.

pub fn push_object<B: EncryptedBlob>( &self, remote: &dyn RemoteStore, blob: &B, ) -> Result<VoidCid>

Push a typed encrypted blob to a remote store.

Extracts raw bytes, pushes via remote (which handles CID verification).

pub fn has_identity(&self) -> bool

Check if a signing identity is loaded.

pub fn nostr_pubkey(&self) -> Option<&NostrPubKey>

Get the nostr public key (if identity was loaded with one).

pub fn resolve_head(&self) -> Result<Option<CommitCid>>

Resolve HEAD to a commit CID (handles workspace-split correctly).

pub fn decrypt(&self, ciphertext: &[u8], aad: &[u8]) -> Result<Vec<u8>>

Decrypt a blob using the vault.

pub fn decrypt_raw(&self, ciphertext: &[u8], aad: &[u8]) -> Result<Vec<u8>>

Decrypt a blob into raw bytes.

pub fn open_commit( &self, blob: &EncryptedCommit, ) -> Result<(CommitPlaintext, CommitReader)>

Decrypt a commit blob and return a CommitReader for child objects.

pub fn open_and_parse_commit( &self, blob: &EncryptedCommit, ) -> Result<(Commit, CommitReader)>

Decrypt a commit blob, then parse it into (Commit, CommitReader).

pub fn load_commit( &self, store: &impl ObjectStoreExt, commit_cid: &VoidCid, ) -> Result<(Commit, CommitReader)>

Load a commit by CID from the store, decrypt, and parse.

Collapses the common store.get → open_with_vault → parse_commit chain into a single call.

pub fn load_commit_with_metadata( &self, store: &impl ObjectStoreExt, commit_cid: &VoidCid, ) -> Result<(Commit, MetadataBundle, CommitReader)>

Load a commit and its metadata by CID from the store.

Collapses the full store.get → decrypt commit → parse → get metadata → decrypt metadata chain into a single call.

pub fn load_manifest( &self, store: &impl ObjectStoreExt, commit: &Commit, reader: &CommitReader, ) -> Result<Option<TreeManifest>>

Load a TreeManifest from a commit.

Returns None if the commit has no manifest_cid (older commits).

pub fn read_file_from_commit( &self, store: &impl ObjectStoreExt, commit: &Commit, reader: &CommitReader, ancestor_keys: &[ContentKey], path: &str, ) -> Result<FileContent>

Read a file from a commit using the TreeManifest.

Loads the manifest, looks up the file entry, fetches and decrypts the shard, decompresses the body, and extracts the file content. Handles chunked files (shard_count > 1) by fetching all chunk shards and concatenating their content.

pub fn decrypt_parse<T>(&self, ciphertext: &[u8], aad: &[u8]) -> Result<T>

where T: DeserializeOwned,

Decrypt and parse a CBOR-serialized type.

impl VoidContext

pub fn headless( void_dir: impl AsRef<Path>, vault: Arc<KeyVault>, epoch: u64, ) -> Result<Self>

Create a context for headless / network-only operations.

Sets root to the parent of void_dir (or void_dir itself if no parent). Use when no workspace root is available (clone, push, pull, repair, etc.).

pub fn with_workspace( root: impl AsRef<Path>, void_dir: impl AsRef<Path>, workspace_dir: impl AsRef<Path>, vault: Arc<KeyVault>, epoch: u64, ) -> Result<Self>

Create a context for a linked worktree.

workspace_dir is the per-workspace state directory (e.g. .void/worktrees/{name}/) where HEAD, index, staged blobs and merge state live. Shared state (objects, refs, config, keys) is still read from void_dir.

Trait Implementations

impl Clone for VoidContext

fn clone(&self) -> VoidContext

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for VoidContext

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.