Struct AccountSummary 

pub struct AccountSummary {
    pub did: String,
    pub account_id: String,
    pub handle: Option<String>,
    pub kind: AccountKind,
    pub created_at: String,
    pub state: AccountState,
    pub locks: Locks,
    pub holds: Holds,
    pub parent: Option<String>,
    pub operator: String,
    pub proof: AccountProof,
    pub edge: EdgeState,
}

One entry in the listAccounts response.

This server’s account of its own contents, which is the most a listing can ever be. A reader deriving “which agents does this operator have” from it gets a lower bound: a server can omit an entry, and nothing in the operator’s repository would contradict it, because an operator writes one bot.did.operator record per server and never one per agent. What a server cannot do is inflate the count — a DID it invents has no record behind it in the operator’s repository — so a reader that verifies each entry rather than trusting the list is safe in one direction and short in the other. See docs/operator-verification.md.

Fields

did: String

The account’s DID.

account_id: String

The agent the account was minted for.

handle: Option<String>

The handle the account answers to, when it has one.

The name is the interesting half of an account for anyone reading a listing: basalt-otter.agents.example is a thing a person can hold in their head and a3f9c1.agents.example is not. It is reported as the server stored it, zone and all, so that a reader can check it lands under the zone the server admits to minting rather than trusting the label alone.

Absent only for an account provisioned before this deployment issued handles. An account whose handle is its own hostname reports that hostname: it is what the account actually answers to, and saying nothing would be a different claim.

kind: AccountKind

What kind of account it is.

created_at: String

When the account was provisioned, RFC 3339.

state: AccountState

Whether the data exists; see AccountState.

locks: Locks

Every lock hung on the account, each with the party that hung it.

The one surface that can say an account is frozen at all: #account cannot, because the lexicon has no wire concept of “active but not writable”. See docs/conformance.md.

holds: Holds

Every hold set on the account.

parent: Option<String>

The hosted account that created this one; absent for a root, whose operator is the deployment’s. See didbot_pds::HostedAccount::parent.

operator: String

The human who answers for this account: the same DID its registration names, at any depth. Self::parent is the next hop of the walk in docs/ownership.md.

proof: AccountProof

What a stranger can authenticate as this account with.

edge: EdgeState

Whether the edge above this account still stands. See EdgeState.

Implementations

impl AccountSummary

pub fn from_account( account: &HostedAccount, operator: &str, credentials: &[Credential], ) -> Self

Summarizes a stored account, with operator as the DID this deployment’s operator holds.

A timestamp that will not format is reported as an empty string rather than failing the whole listing. Rfc3339 only rejects years outside 0000..=9999, which no clock this reads will produce.

Trait Implementations

impl Clone for AccountSummary

fn clone(&self) -> AccountSummary

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AccountSummary

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AccountSummary

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for AccountSummary

fn eq(&self, other: &AccountSummary) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for AccountSummary

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for AccountSummary

impl StructuralPartialEq for AccountSummary