Struct VersionResponse 

pub struct VersionResponse {
    pub version: &'static str,
    pub git_commit: Option<&'static str>,
    pub git_ref: Option<&'static str>,
    pub release_tag: Option<&'static str>,
    pub built_at: Option<&'static str>,
    pub signed: bool,
}

Response body for GET /version — build & release metadata.

All fields except version are best-effort: they’re set at compile time from environment variables the release pipeline injects. When a build runs without those variables set (e.g. local cargo build), the corresponding fields are None and operators can interpret that as “this binary did not come from a verified release pipeline”.

The companion admin route (Phase 4.4) consumes this endpoint to display sigstore-verified release information so operators can audit what’s actually running in production.

Fields

version: &'static str

Package version from Cargo.toml (always present).

git_commit: Option<&'static str>

Git commit SHA (full or short) of the build, if injected via GITHUB_SHA at compile time. None for unverified local builds.

git_ref: Option<&'static str>

Git branch or tag name, if injected via GITHUB_REF_NAME.

release_tag: Option<&'static str>

Release tag (e.g. v1.0.3) if this binary came from a tagged release. Distinct from git_ref because release builds set this explicitly via STATESET_RELEASE_TAG.

built_at: Option<&'static str>

RFC 3339 build timestamp, if injected via STATESET_BUILD_TIMESTAMP at compile time.

signed: bool

Whether this binary’s release artifacts were signed via sigstore. true when the release pipeline injected STATESET_SIGNED=true; false (the default) for local builds, dev builds, and any release where signing was skipped or failed.

Trait Implementations

impl Clone for VersionResponse

fn clone(&self) -> VersionResponse

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ComposeSchema for VersionResponse

fn compose(generics: Vec<RefOr<Schema>>) -> RefOr<Schema>

impl Debug for VersionResponse

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

Formats the value using the given formatter.

impl Serialize for VersionResponse

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl ToSchema for VersionResponse

fn name() -> Cow<'static, str>

Return name of the schema.

fn schemas(schemas: &mut Vec<(String, RefOr<Schema>)>)

Implement reference utoipa::openapi::schema::Schemas for this type.