Struct User 

pub struct User { /* private fields */ }

Authenticated user with shared session state Clones share the same underlying session — leave() invalidates all holders.

Implementations

impl User

pub async fn create( alias: &str, pass: &str, db: &mut Node, ) -> Result<Self, SeaError>

Create a new user with alias and password. Stores encrypted key pair in BEAM’s graph at ~@alias.

pub async fn auth( alias: &str, pass: &str, db: &mut Node, ) -> Result<Self, SeaError>

Authenticate existing user from BEAM’s graph.

pub fn from_pair(pair: KeyPair, alias: Option<&str>) -> Self

Create user directly from existing key pair.

pub async fn recall( alias: &str, storage: &dyn SessionStorage, ) -> Result<Self, SeaError>

Recall user from session storage.

pub async fn save_to( &self, storage: &dyn SessionStorage, ) -> Result<(), SeaError>

Save current session to storage.

Note: clones the KeyPair and alias out of the session lock before awaiting storage.save(...) to keep the future Send. Holding the std::sync::RwLock read guard across an .await would make the returned future non-Send (the std guard is not Send), which breaks callers that need to await auth flows while holding a tokio lock (e.g. the MCP identity_auth tool).

impl User

pub async fn trust( &self, recipient_pubkey: &str, path: Option<&str>, db: &mut Node, ) -> Result<(), SeaError>

Delegate write trust to a recipient for an optional path. Stores a capability certificate at ~{pub}/trust/{path}.

pub async fn grant( &self, recipient_pubkey: &str, recipient_epub: &str, data_path: &str, db: &mut Node, ) -> Result<(), SeaError>

Grant a recipient access to decrypt data at a path. Stores signed ECDH-encrypted copies at ~{pub}/grant/{path}/{recipient} and ~{pub}/grant/{path}/{my_pub}.

pub async fn secret( &self, data: &JsonValue, path: &str, db: &mut Node, ) -> Result<(), SeaError>

Encrypt and store data under a self-derived symmetric key. Only this user can decrypt it — the key comes from ECDH(self.pub, self.priv). Stored at ~{pub}/secret/{path_key} as a signed payload.

impl User

pub fn from_state(state: SessionState) -> Self

pub fn pub_key(&self) -> String

pub fn pair(&self) -> KeyPair

pub fn alias(&self) -> Option<String>

pub fn is_authenticated(&self) -> bool

pub fn is(&self) -> Option<Identity>

Return the user’s identity if authenticated. Mirrors Gun.js user.is — returns alias, pub, epub or None.

pub fn leave(&self)

Clear key pair from memory and mark unauthenticated (all clones invalidated)

Trait Implementations

impl Clone for User

fn clone(&self) -> User

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for User

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

Formats the value using the given formatter.