Governance

Governance for Nexus views — projection policies, access reviews, and view lifecycle control.

Purpose

Multi-strand ordered views with governance, custom ordering, strand input stats, and materialized projections.

This page follows the real source shape for Nexus and explains the workflow a developer is likely to use first.

Start from the smallest constructor or builder, perform one meaningful operation, inspect the returned state, then add the relevant policy, storage, or network integration. The examples below should be expanded whenever the crate API changes.

Note

Nexus views are deterministic given their inputs. Two peers with the same upstream strands and the same CustomOrdering will produce byte-identical views. Re-derive the view rather than replicate it.

Primary types to know

AllowAllPolicy — models/nexus/src/governance.rs
ApprovalRecord — models/nexus/src/governance.rs
CustomOrdering — models/nexus/src/ordering.rs
GovernancePolicy — models/nexus/src/governance.rs
GovernanceRules — models/nexus/src/governance.rs
IndexOrdering — models/nexus/src/ordering.rs
InputStrand — models/nexus/src/strand_input.rs
MemoryView — models/nexus/src/view.rs
Nexus — models/nexus/src/nexus.rs
NexusConfig — models/nexus/src/config.rs
NexusCursor — models/nexus/src/view.rs
Page — models/nexus/src/view.rs

Example shape

use nexus::{GovernanceAuthority, GovernancePolicy};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Authority chooses the trust model: single founder, M-of-N threshold,
    // or an allow-list of organizations.
    let _single = GovernanceAuthority::SingleKey("a".repeat(64));
    let threshold = GovernanceAuthority::MultiKeyThreshold {
        founders: vec!["a".repeat(64), "b".repeat(64), "c".repeat(64)],
        threshold: 2,
    };
    let orgs = GovernanceAuthority::OrganizationList(vec![
        "did:l1fe:org:trusted".into(),
        "did:l1fe:org:partner".into(),
    ]);

    // GovernancePolicy controls participation: explicit approvals, allow-lists,
    // and per-org caps. Defaults allow same-org agents without approval.
    let policy = GovernancePolicy {
        allow_same_org: true,
        require_approval: true,
        approved_orgs: vec!["did:l1fe:org:trusted".into()],
        denied_orgs: vec!["did:l1fe:org:revoked".into()],
        max_agents_per_org: Some(8),
    };

    println!(
        "authority(threshold)={:?} approved={} denied={} cap={:?}",
        match &threshold {
            GovernanceAuthority::MultiKeyThreshold { threshold, .. } => *threshold,
            _ => 0,
        },
        policy.approved_orgs.len(),
        policy.denied_orgs.len(),
        policy.max_agents_per_org,
    );
    let _ = orgs;
    Ok(())
}

Governance

Purpose

Developer workflow

Primary types to know

Example shape

On this page