Reference
What it does
The benchmark module stores hardware performance measurements tied to provider records — compute throughput, memory bandwidth, storage and network performance — so that tenants can compare providers on measured capability rather than marketing copy.
Published benchmarks make the marketplace's abstract resource units concrete: the same "unit" of compute can be qualified by what the underlying hardware actually measures.
Why it exists: Price-per-unit is meaningless if units hide wildly different hardware. Benchmarks are the marketplace's answer to performance information asymmetry — the data that lets price competition operate on real value.
State
Primary objects
| Concept | Definition |
|---|---|
Benchmark record | A published measurement of provider hardware performance, tied to its record. |
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
-
x/providerBenchmark records attach to the provider's on-chain identity. -
x/resourcesMeasurements ground the shared resource-unit vocabulary. -
x/marketTenants weigh benchmark data when selecting bids.
Flows
Core flow
- Run — Hardware is benchmarked. Standard performance tests run against the operator's actual machines.
- Publish — Records go on-chain. Measurements attach to the provider's on-chain identity, visible to every tenant.
- Qualify — Units gain meaning. Shared resource units are grounded in measured hardware — same unit, verifiable capability.
- Select — Bids compete on data. Tenants weigh benchmark records when choosing between competing offers.
Questions
Asked about x/benchmark
What is a benchmark record?
A published measurement of provider hardware performance, tied to its on-chain record — the marketplace's answer to performance information asymmetry.
Why do benchmarks matter for pricing?
Price-per-unit is meaningless if units hide wildly different hardware. Benchmarks let price competition operate on measured value instead of spec-sheet theater.
How do tenants use benchmark data?
As a selection signal: when comparing bids, measured performance qualifies the abstract resource units each offer proposes.
Related