Struct InstanceAdmin 

pub struct InstanceAdmin<'a> { /* private fields */ }

Instance-admin capability view over an AccountSession session.

Obtain via AccountSession::admin. See the module docs for the rationale behind the separate type.

Implementations

impl<'a> InstanceAdmin<'a>

pub async fn create_account(&self, new_account: NewAccount) -> Result<String>

Create a new account.

Authors the Account database with its new key and registers its wrapped credentials in native local storage. Connected registration is gated by the admin’s session key; passwords and plaintext keys are not sent to the daemon. First login retains the existing device-Read grant.

Returns the new instance-local login ID (see AccountSession::login_id), not the Account root ID. Use Instance::login_account to obtain an AccountSession session for the new account; materialising it directly here would require the admin’s connection to read the new account’s own tree over the wire, where the session gate (correctly) rejects the admin as a non-member.

Arguments

• new_account - Username and password string (including empty) for the account to create. See NewAccount.

pub async fn list_accounts(&self) -> Result<Vec<String>>

List the login names of all accounts registered on this instance.

Reads native local login names. Connected requests require instance-admin on the daemon’s _users Auth and return no credential records.

pub async fn grant_instance_admin(&self, new_admin: &PublicKey) -> Result<()>

Grant instance-admin to another key.

Adds new_admin as Admin(0) on the system databases that gate instance-level admin operations (_users and _databases), with the write signed by this admin’s own key. The first instance admin is created automatically during instance bootstrap; this is how every subsequent admin is promoted.

Idempotent: re-granting an existing admin re-asserts the same Admin(0) entry.

Trait Implementations

impl<'a> Debug for InstanceAdmin<'a>

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

Formats the value using the given formatter.