Skip to main content

Module local_head

Module local_head 

Source
Expand description

Signed local chain heads under a held, cooperative OS file lock.

The host must protect the root and lock file from replacement, establish that storage is local, and authenticate freshness/absence with independent anti-rollback state. Filesystem locks coordinate only cooperating writers. This module does not establish durable chain membership on its own.

Structs§

LocalHeadLease
Holds an exclusive advisory lock. Root protection and lock-file identity must be enforced by the host for the entire lifetime of the lease.

Enums§

LocalHeadError

Traits§

LocalHeadPolicy
External policy establishes local root/ACL and rollback-resistant head state. The host must hold a policy lease across final checks and file replacement; callback results alone cannot make external revocation atomic with I/O. Empty means authenticated genesis absence, not an unavailable lookup.