Quality & governance

x/audit — Audit

Auditor-signed provider attributes that upgrade self-claims into attestations.

Reference

What it does

The audit module lets recognized auditors sign provider attributes on-chain. A provider may claim any attribute — region, datacenter tier, compliance posture — but an auditor's signature turns the claim into an attestation a tenant can weight accordingly: orders can require attributes signed by specific auditors.

Attestations are revocable and auditable themselves, so audit trust is traceable to accountable, identity-verified signers rather than to an anonymous badge.

Why it exists: Self-reported quality is worth little in an anonymous marketplace. An on-chain attestation layer imports the assurance model of real procurement — independent verification — without importing a centralized gatekeeper.

State

Primary objects

ConceptDefinition
AttestationAn auditor's on-chain signature over a provider's claimed attribute.
Audited placementAn order constraint requiring attributes signed by trusted auditors.

Messages

Messages & queries

Message and query surfaces are documented at implementation level in the module docs ↗ and the source ↗. The objects above are the state those messages create and transition.

Connections

Module interactions

Flows

Core flow

  1. Claim — Provider claims attributes. Region, datacenter tier, compliance posture — asserted on the provider record.
  2. Inspect — An auditor verifies. A recognized, identity-verified auditor inspects the claim against reality.
  3. Sign — The attestation lands. An on-chain signature upgrades the claim into an attestation tenants can require.
  4. Revoke — Standing is revocable. Attestations remain auditable and revocable, traceable to accountable signers.

Questions

Asked about x/audit

What is an attestation?

An auditor's on-chain signature over a provider's claimed attribute — the difference between "trust us" and "a verified party checked".

Who can be an auditor?

Holders of the auditor role — an on-chain role with defined capabilities, held by VEID-verified participants with accountable standing.

x/roles module

How do tenants use attestations?

Through audited placement constraints: orders can require specific attributes signed by trusted auditors, so only verified claims match.

More questions → FAQ

Related

Related modules