Wire class

Constructors

Wire({String? action, String? authMethod, String? email, String? hash, String? home, bool? isAdmin, String? method, String? org, String? path, String? prevHash, String? reason, String? requestId, String? resource, String? resourceId, String? result, int? seq, String? sourceIp, int? status, String? sub, String? time, String? userAgent})

Returns a new Wire instance.

Properties

action ↔ String?

Action is the verb that was performed. It is the event's name, not the HTTP method — a request-sourced record carries both, and the pair is what makes a row readable ("grant.create" at POST /v1/admin/grants).

getter/setter pair

authMethod ↔ String?

Auth is the credential the actor presented: "jwt", "api-key", or "none".

getter/setter pair

email ↔ String?

Email is the actor's validated address, absent when the credential carried none. It comes from the verified token, never from a client header.

getter/setter pair

hash ↔ String?

Hash is this record's SHA-256 over its own canonical JSON with both hash fields cleared, folded with prevHash. Recomputing it from the row's other fields is what proves the row has not been edited.

getter/setter pair

hashCode → int

The hash code for this object.

no setter, override

home ↔ String?

Home is present ONLY on a cross-org action: the org the actor came FROM, while Org is the org they acted IN. A console row carrying home is a platform-admin impersonation and should be rendered as one.

getter/setter pair

isAdmin ↔ bool?

IsAdmin is the VALIDATED platform-SuperAdmin bit at decision time (membership of the reserved admin org), never the client's own claim to be one.

getter/setter pair

method ↔ String?

Method is the HTTP verb, on a record a request produced. Absent on an event emitted from inside the binary with no request behind it.

getter/setter pair

org ↔ String?

Org is the tenant the action was taken IN — the effective org, which for everyone but an impersonating SuperAdmin is also the actor's own. Empty on an unauthenticated request.

getter/setter pair

path ↔ String?

Path is the request's route. Any segment shaped like a credential is replaced before the record is written, so a key that rides in a path is not preserved here by the very control meant to watch it.

getter/setter pair

prevHash ↔ String?

PrevHash is the hash of record seq-1, which is what links the rows into a chain: a deleted or reordered record breaks the recomputation at that point. The first record of a chain carries 64 zeros rather than an empty string, so "start of chain" and "field missing" cannot look alike.

getter/setter pair

reason ↔ String?

Reason is a short explanation for a deny or an error ("SuperAdmin required", "insufficient_balance"). It is never a secret and never a raw upstream error body; absent on a success.

getter/setter pair

requestId ↔ String?

RequestID ties this row to the request-line log and any downstream trace — the X-Request-Id the pipeline minted for that request.

getter/setter pair

resource ↔ String?

Resource is the KIND of thing acted upon ("org", "role", "secret", "provider-config", "credit"). Where a mutation has no finer semantics than its route, this is the route family and resourceId is empty — the action and the path already pin the object.

getter/setter pair

resourceId ↔ String?

ResourceID is the specific instance, absent when the kind alone identifies it.

getter/setter pair

result ↔ String?

Result is how the action ended: "success", "deny" or "error". A deny is a decision this binary made and is as much evidence as a success.

getter/setter pair

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

seq ↔ int?

Seq is the record's position in the chain, 0-based and gapless. The Recorder assigns it under its own lock, so it is a true total order: seq n+1 was written after seq n, and a missing number is a missing record.

getter/setter pair

sourceIp ↔ String?

SourceIP is the client address the edge resolved for the request, after the proxy chain — the address a responder would act on, not the socket peer.

getter/setter pair

status ↔ int?

Status is the HTTP status the caller received. It is the outcome as the client saw it, so a 200 carrying a domain refusal still reads 200 here.

getter/setter pair

sub ↔ String?

Sub is the acting user (the IAM subject). Empty for a machine principal or an anonymous request, which is how a service action is told from a person's.

getter/setter pair

time ↔ String?

Time is when the action happened, RFC3339Nano in UTC. The stored column has the same precision and sorts the same way, so a client can range and order on this string verbatim.

getter/setter pair

userAgent ↔ String?

UserAgent is the client the request announced itself as. Client-supplied, so it is evidence about what claimed to act, not proof of it.

getter/setter pair

Methods

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

toJson() → Map<String, dynamic>

toString() → String

A string representation of this object.

override

Operators

operator ==(Object other) → bool

The equality operator.

override

Static Methods

fromJson(dynamic value) → Wire?

Returns a new Wire instance and imports its values from value if it's a Map, null otherwise.

listFromJson(dynamic json, {bool growable = false}) → List<Wire>

mapFromJson(dynamic json) → Map<String, Wire>

mapListFromJson(dynamic json, {bool growable = false}) → Map<String, List<Wire>>

Constants

requiredKeys → const Set<String>

The list of required keys that must be present in a JSON.