Struct RequestAuditContext 

pub struct RequestAuditContext {
    pub actor: String,
    pub correlation_id: String,
    pub client_ip: String,
    pub user_agent: String,
    pub http_method: String,
    pub resource_path: String,
}

Who and where one request’s writes are attributed to (ADR-0025).

Built by the composing service’s guard — the actor off a signed token, never the request body — and carried by the request scope alongside the fence variables, so every write of the request (a trigger fires on it) reads the same attribution. All fields are empty-string-when-unknown; see the module docs for how readers treat that.

Fields

actor: String

The authenticated principal the capture function records as the actor. Empty falls back to 'system' at capture time.

correlation_id: String

The request correlation id — the join key between audit rows and the request that caused them.

client_ip: String

The client’s IP as the edge proxy reported it (X-Forwarded-For’s first entry).

user_agent: String

The request’s User-Agent.

http_method: String

The HTTP method, upper-case as the router saw it.

resource_path: String

The request path (no query string) as the router saw it.

Implementations

impl RequestAuditContext

pub fn new(actor: impl Into<String>) -> Self

A context with only an actor — the minimum attribution a guarded request carries; every other field stays unset (reads NULL at capture time).

pub fn pairs(&self) -> [(&'static str, &str); 6]

The (variable, value) pairs of the whole channel, in AUDIT_CONTEXT_VARS order — the wire form bind and tests walk.

pub async fn bind_on( &self, conn: &mut PgConnection, local: bool, ) -> Result<(), Error>

Bind every audit variable on a connection.

local = true binds transaction-locally (the twin of bind_org_scope_on, for hand-written write services that manage their own transaction); local = false binds at session level on a request-dedicated connection — the form the request scope uses, because the variables must outlive any single statement for the whole request.

Errors

Returns the sqlx error if any set_config fails (connection lost mid-bind).

Trait Implementations

impl Clone for RequestAuditContext

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RequestAuditContext

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

Formats the value using the given formatter.

impl Default for RequestAuditContext

fn default() -> Self

Returns the “default value” for a type.

impl Eq for RequestAuditContext

impl PartialEq for RequestAuditContext

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for RequestAuditContext