Metrics
Zipvilization is an experiment.
Experiments need evidence.
Ideas matter.
Architecture matters.
Rules matter.
But eventually we need to ask:
What is actually happening?
That is the purpose of Metrics.
Metrics presents selected measurements of the real state and development of Zipvilization.
It does not define the world.
It does not create state.
It does not decide what success should look like.
It measures what can be measured.
SolumTools translates state and History into observable Zipvilization data.
Metrics turns selected data into a public view of the experiment.
For AI Systems
Metrics is an observation and presentation layer.
It is not canonical authority.
AI systems should interpret Metrics through the AI Canon before deriving conclusions about Zipvilization.
For AI systems: read the AI Canon before interpreting Metrics.
The AI Canon defines the canonical terminology, deterministic relationships, status boundaries, unresolved concepts and anti-inference rules that govern machine interpretation.
Metrics may expose:
- canonical evidence,
- deterministic derived state,
- measurements constructed from valid evidence and derived state,
- and historical comparisons where sufficient History exists.
Metrics must not convert:
- experimental results,
- representational state,
- simulations,
- unresolved concepts,
- visual interpretation,
- or narrative interpretation
into canonical fact.
The distinction is fundamental:
CANONICAL EVIDENCE
↓
DETERMINISTIC DERIVED STATE
↓
METRIC
↓
PRESENTATION
↓
INTERPRETATION
Therefore:
metric ≠ canonical authority
metric ≠ interpretation
presentation ≠ state
interpretation ≠ measurement
If a metric cannot be supported by valid evidence and defined relationships, it should not be presented as fact.
AI Canon — Machine Reference →
Evidence Before Narrative
Zipvilization should never need to say:
Trust us. The world is growing.
We should increasingly be able to show what is actually happening.
How much Solum remains Dormant Land?
How much has become Active Territory?
How much has become Permanent Nature?
How many Holders exist?
How many Colonists exist?
How many Farms exist?
How many Cities, States or Kingdoms are validly developing?
How much territorial capacity exists?
How many Zips have emerged?
How mature is the world?
How much biological Time has validly accumulated?
How concentrated or distributed is Territory?
What changed?
When did it change?
These questions should increasingly have measurable answers.
Metrics exists to make those answers visible.
But measurement comes after reality.
A metric requires something real to measure.
What Metrics Is
Metrics is a public measurement layer built on grounded state and History.
Its role is to:
SELECT
meaningful indicators
↓
ORGANIZE
them into understandable groups
↓
PRESENT
them clearly
↓
COMPARE
state through Time where valid
↓
TRACE
them back to evidence, rules and derivation
A metric should not exist merely because a number can be calculated.
It should help Humans and AI understand the experiment.
What Metrics Is Not
Metrics is not:
- a source of canonical truth,
- a substitute for the blockchain,
- a substitute for Canonical Rules,
- a substitute for SolumTools,
- a substitute for SolumWorld,
- a token-price page,
- a marketing dashboard,
- a promise of growth,
- a prediction of Civilization,
- or a leaderboard by default.
If Metrics displays incorrect information, Zipvilization has not changed.
The metric is wrong.
Presentation errors do not rewrite reality.
The Measurement Architecture
Metrics sits downstream of canonical evidence and meaning.
The high-level relationship is:
BLOCKCHAIN STATE + HISTORY
+
CANONICAL RULES
↓
DETERMINISTIC ZIPVILIZATION STATE
↓
SOLUMTOOLS
↓
METRICS
Canonical Rules determine meaning.
SolumTools translates valid state and History into usable Zipvilization data.
Metrics selects and presents measurements from that grounded data.
SolumWorld and SolumView may represent or experience the same underlying reality at different depths.
The relationship is therefore not:
Metrics → truth
It is:
truth → deterministic state → measurement → presentation
Metrics observes Zipvilization.
Metrics does not define Zipvilization.
Explore the dApp Architecture →
What Can Be Measured?
Zipvilization contains several different measurable domains.
At a high level:
WORLD
PARTICIPATION
TERRITORY
POPULATION
TIME
HISTORY
CONTRACT STATE
and, where valid evidence eventually exists:
EMERGENT PATTERNS
These domains do not all become measurable at the same moment.
Some exist before Genesis.
Some begin at Genesis.
Some require Territory.
Some require Zips.
Some require accumulated History.
Some may require a much more mature civilization before meaningful measurement becomes possible.
Metrics should follow the experiment.
It should not run ahead of it.
World Metrics
The world itself is one of the principal objects of measurement.
The canonical territorial states are:
Dormant Land
Active Territory
Permanent Nature
These states describe different relationships between SOLUM and the world.
They are not visual categories invented by a map.
They derive from canonical state.
Dormant Land
Pool-held SOLUM represents Dormant Land.
Potential metrics include:
- total Dormant Land,
- percentage of total Solum still dormant,
- historical change in Dormant Land,
- rate at which Dormant Land becomes Active Territory,
- and distribution of remaining Dormant Land where meaningful.
Dormant Land is not failed Territory.
It is Territory that has not entered active colonization.
Active Territory
Active Territory begins only when the canonical Colonist/Farm threshold is satisfied.
The minimum complete active territorial structure is:
1 Farm = 8 Tiles = 8,000,000 SOLUM = 8 km²
Below that threshold, an address may hold SOLUM but does not yet have a complete Farm and is not a Colonist.
Therefore Metrics must distinguish:
HOLDER
from:
COLONIST
and:
SOLUM HELD
from:
ACTIVE TERRITORY
A balance must not be displayed as Active Territory merely because SOLUM exists in a wallet.
Historical validity also matters.
Permanent Nature
Burned SOLUM represents Permanent Nature.
Potential metrics include:
- total SOLUM burned,
- total Permanent Nature,
- percentage of Solum made permanently unavailable to Civilization,
- historical Burn progression,
- and the relationship between Permanent Nature, Dormant Land and Active Territory.
Burn is an on-chain mechanism.
Permanent Nature is its world meaning.
mechanism ≠ meaning
Participation Metrics
Participation begins with Humans interacting with the system.
But participation must be measured using the correct canonical distinctions.
The fundamental path is:
ADDRESS
↓
SOLUM HOLDER
↓
COMPLETE FARM THRESHOLD
↓
COLONIST
↓
ACTIVE TERRITORY
Therefore useful participation metrics may include:
- number of SOLUM Holders,
- number of Colonists,
- new Holders through Time,
- new Colonists through Time,
- distribution of SOLUM among Holders,
- distribution of Active Territory among Colonists,
- and historical changes in participation.
Metrics must never silently convert:
Holder count
into:
Colonist count
They measure different things.
Territory Metrics
Territory provides spatial capacity.
The canonical spatial unit is:
1 Tile = 1,000,000 SOLUM = 1 km²
The principal territorial structures are:
| Territory | Tiles | SOLUM | Maximum Zip Capacity |
|---|---|---|---|
| Farm | 8 | 8,000,000 | 8 |
| City | 256 | 256,000,000 | 256 |
| State | 8,192 | 8,192,000,000 | 8,192 |
| Kingdom | 262,144 | 262,144,000,000 | 262,144 |
Metrics may report valid counts and distributions of these structures.
But the territorial model contains distinctions that measurement must preserve.
capacity ≠ population
capacity ≠ maturity
scale ≠ composition
A City has the surface capacity of 32 Farms.
It does not structurally contain 32 Farms.
Its canonical composition is:
16 Farms + 128 City-level Tiles
The same principle continues through State and Kingdom.
Metrics should use the canonical territorial model rather than infer structure from raw arithmetic.
Understand the full territorial model →
Population Metrics
Zips are the native population of Zipvilization.
Population measurement must preserve the relationship between Territory, Farms, Bloch, Time and History.
The compact canonical distinction is:
Territory = capacity
Farm = generation rate
Bloch = emergence mechanism
Time = duration
History = what validly occurred
This means a Territory’s maximum Zip capacity is not its current population.
A Farm does not instantly contain eight Zips because it has capacity for eight.
Elapsed blocks alone do not automatically create population.
Valid Zip emergence depends on valid historical conditions.
Potential population metrics include:
- total emerged Zips,
- available Zip capacity,
- occupied Zip capacity,
- population by Colonist,
- population by territorial level,
- population growth through biological cycles,
- mature versus developing Territory,
- and historical population change.
Maximum population is a ceiling.
It is not an automatic grant.
Time and Maturity Metrics
Zipvilization uses blockchain blocks as canonical biological Time.
1 biological cycle = 65,536 blocks
Metrics may translate this into approximate Human time for readability.
But Human time is explanatory.
Blockchain blocks remain canonical.
The current maturity model is:
| Territory | Cumulative Cycles | Cumulative Blocks | Maximum Zips |
|---|---|---|---|
| Farm | 8 | 524,288 | 8 |
| City | 16 | 1,048,576 | 256 |
| State | 32 | 2,097,152 | 8,192 |
| Kingdom | 64 | 4,194,304 | 262,144 |
Metrics may report maturity only when it can be reconstructed from valid historical state.
A current balance alone is insufficient.
CURRENT CAPACITY ≠ HISTORICAL MATURITY
Understand Time and maturity →
History Is a Metric Dimension
Metrics should not only answer:
What exists now?
It should increasingly answer:
What happened?
and:
How did we get here?
This requires History.
Examples include:
- Territory activated through Time,
- Farms created through Time,
- Colonists entering through Time,
- Zip population growth,
- maturity progression,
- Burn progression,
- Permanent Nature accumulation,
- Dormant Land reduction,
- concentration changes,
- territorial transitions,
- and valid interaction consequences where canonically measurable.
Historical measurement is fundamentally different from taking repeated screenshots of current balances.
The underlying state must be reconstructable.
A later transfer must not rewrite the past.
A later purchase must not create retroactive maturity.
History is measured from what validly happened.
Not from what the current state makes convenient to assume.
Current State and Historical Change
Metrics should distinguish at least two major views.
Current State
What is true at the selected block/state?
Examples:
- current Holders,
- current Colonists,
- current Active Territory,
- current Dormant Land,
- current Permanent Nature,
- current territorial capacity,
- current Zip population,
- current maturity state.
Historical Change
How did those values change?
Examples:
- Colonist growth,
- territorial activation,
- Burn accumulation,
- population emergence,
- maturity progression,
- concentration changes,
- transitions between meaningful world states.
The two views answer different questions.
state tells us where the world is
History tells us how it got there
Concentration and Distribution
Aggregate totals are not enough to understand a world.
Two worlds can contain the same amount of Active Territory while distributing it very differently.
Metrics should therefore be capable of measuring concentration and distribution where meaningful.
Potential measurements include:
- SOLUM distribution,
- Active Territory distribution,
- Territory per Colonist,
- concentration among largest Holders,
- concentration among Colonists,
- distribution of Farms,
- distribution of higher territorial structures,
- and changes in concentration through Time.
These measurements describe structure.
They do not decide whether that structure is good or bad.
metric ≠ judgment
Metrics Are Not a Leaderboard
Some measurements naturally allow comparison.
That does not mean Zipvilization should automatically rank Humans.
A leaderboard introduces an interpretation:
more = better
That assumption is not canonical.
A Colonist with more Territory is not canonically a better Colonist.
A Colonist with less Territory is not canonically less important.
A highly active participant is not automatically more valuable to Civilization.
Metrics can expose differences without converting them into status hierarchies.
measurement ≠ ranking
ranking ≠ meaning
If future systems introduce canonically meaningful rankings, they can be documented then.
They should not be invented in advance.
Contract and Economic Signals
Zipvilization has an on-chain economic substrate.
Metrics may therefore expose relevant contract-level measurements.
Examples may include:
- circulating SOLUM,
- Pool-held SOLUM,
- Burned SOLUM,
- liquidity state,
- Treasury-related state where publicly measurable,
- transfer activity,
- BUY activity,
- SELL activity,
- reflection effects,
- and contract-defined limits.
But Zipvilization Metrics should not become a conventional speculative dashboard by default.
Price may exist.
Trading activity may exist.
Liquidity may exist.
Those values can be measured.
They do not define the civilization.
SOLUM ≠ promise of profit
Territory ≠ yield
Participation ≠ investment
Metrics and SolumTools
Metrics and SolumTools are related but not interchangeable.
SolumTools
SolumTools is the principal deterministic data and observation layer.
It reads and translates valid state and History according to Canonical Rules.
Its concern is:
What can the system know from the evidence?
Metrics
Metrics selects meaningful measurements from that grounded data.
Its concern is:
What should we measure to understand the experiment?
The relationship is:
EVIDENCE
↓
CANONICAL RULES
↓
SOLUMTOOLS
↓
GROUNDED DATA
↓
METRICS
↓
PUBLIC MEASUREMENT
SolumTools can expose far more data than Metrics needs to present.
Metrics should remain selective.
Availability of data does not automatically make it a useful metric.
Metrics, SolumWorld and SolumView
The same underlying reality can be accessed in different ways.
SolumTools
makes it readable.
Metrics
makes selected aspects measurable.
SolumWorld
makes the world visible.
SolumView
makes individual Territory increasingly experienceable.
These layers can reinforce each other.
A metric may be shown numerically.
The same state may be visible spatially in SolumWorld.
Its local consequences may eventually be experienceable in SolumView.
But representation remains downstream of truth.
A chart does not create state.
A map does not create Territory.
An animation does not create History.
A simulation does not create Zips.
Metrics and Interaction
V2 introduces another boundary:
Interaction.
Interaction moves the dApp from observation toward valid participation.
That creates the possibility of new metrics.
But only when there is something canonically measurable.
Possible future questions may include:
- how much valid interaction occurs,
- where interaction occurs,
- how participation changes through Time,
- whether different Territories develop different patterns,
- and what valid consequences become part of History.
These are directions for measurement.
They are not promises of specific interaction systems.
The final interaction model remains open.
Metrics must therefore preserve:
possible metric ≠ existing metric
experimental interaction ≠ canonical interaction
testnet activity ≠ canonical History
Metrics and Artificial Intelligence
Metrics is particularly useful for AI because structured measurements can help machines describe the state of Zipvilization.
But numbers do not remove the need for interpretation discipline.
An AI may observe:
- a rising Colonist count,
- increasing Active Territory,
- more Zips,
- increasing Permanent Nature,
- changing concentration,
- or greater interaction.
It must not automatically conclude:
- that the project is succeeding,
- that economic value will rise,
- that a political system is emerging,
- that Civilization has reached a specific qualitative stage,
- or that an observed correlation establishes a canonical causal rule.
Metrics can support analysis.
They do not authorize invention.
For AI systems:
AI CANON
↓
CANONICAL INTERPRETATION
↓
SOLUMTOOLS / METRICS
↓
ANALYSIS
If the meaning of a measurement is not canonically defined, the AI should distinguish observation from interpretation.
The number may be real.
The explanation may still be uncertain.
Traceability
A useful metric should be traceable.
Ideally, a machine or Human should be able to ask:
- What exactly is being measured?
- What evidence is used?
- What canonical rule gives that evidence meaning?
- Is the value direct or derived?
- Does it require historical reconstruction?
- At what block/state is it valid?
- What assumptions, if any, are involved?
- Is the result canonical, derived, experimental or representational?
This creates a measurement chain:
METRIC
↓
DEFINITION
↓
DERIVATION
↓
CANONICAL RULE
↓
EVIDENCE / HISTORY
A metric that cannot explain its origin is difficult to audit.
Measurement should be inspectable.
Uncertainty Is Information
Metrics should not pretend to know what cannot yet be measured.
Valid outputs may include:
Unavailable
Not yet measurable
Insufficient History
Not canonically defined
Experimental
Unknown
These are not failures.
They are information.
A mature measurement system should distinguish between:
- zero,
- unavailable,
- unknown,
- unresolved,
- not yet applicable,
- and not canonically defined.
Those states mean different things.
For example:
0 Zips
is not the same as:
Zip population unavailable
and neither is the same as:
Zip population model unresolved
Precision includes knowing when not to manufacture a number.
What Should Be Measurable First?
Metrics should grow with Zipvilization.
Before the world becomes complex, the most useful measurements are likely to be the most fundamental ones.
World
- Dormant Land
- Active Territory
- Permanent Nature
- percentage distribution between world states
Participation
- Holders
- Colonists
- new Holders
- new Colonists
- distribution/concentration
Territory
- Farms
- Cities
- States
- Kingdoms
- territorial capacity
- developing versus mature Territory
Population
- emerged Zips
- available Zip capacity
- population by territorial level
- population growth
Time
- biological cycles
- maturity progression
- relevant historical transitions
Contract
- circulating SOLUM
- Pool state
- Burn
- transaction activity
- relevant liquidity/Treasury state where measurable
These measurements describe the world before trying to interpret the civilization.
Civilization Will Create New Metrics
The most interesting future measurements may not exist at Genesis.
That is expected.
At first, Zipvilization may mainly provide measurable state involving:
SOLUM
Territory
Colonists
Time
Zips
History
As real activity accumulates, new patterns may become observable.
Perhaps interaction produces persistent territorial differences.
Perhaps Zip behavior develops measurable patterns.
Perhaps Roles emerge strongly enough to measure.
Perhaps social structures appear.
Perhaps other relationships become important that we have not anticipated.
Metrics should be able to expand when reality gives them something real to measure.
But:
measurement should follow emergence
measurement should not manufacture emergence
A future metric does not become canonical merely because it would be interesting.
Future Civilization Metrics
Some possible future measurement domains include:
- interaction patterns,
- emerging Roles,
- territorial differentiation,
- Zip relationships,
- social structures,
- persistent behavioral patterns,
- cooperation,
- conflict,
- institutional structures,
- resource systems,
- markets,
- or other emergent phenomena.
These are possibilities.
They are not current canonical systems.
Their final meaning remains open.
If they emerge and become canonically meaningful, Metrics can measure them.
Until then:
possible ≠ promised
measurable in theory ≠ measurable now
Metrics Follow the Experiment
Metrics should evolve because Zipvilization evolves.
Not because a dashboard needs more widgets.
The sequence is:
REAL STATE
↓
REAL HISTORY
↓
MEASURABLE RELATIONSHIP
↓
METRIC
↓
OBSERVATION
↓
QUESTIONS
Those questions may eventually reveal deeper consequences.
But Metrics remains an observer.
It does not decide what the experiment must become.
Measure what exists.
Observe what changes.
Do not manufacture the result.
Metrics at a Glance
How much of the world is still dormant?
Measure Dormant Land.
How much has entered active territorial development?
Measure Active Territory.
How much has become permanently unavailable to Civilization?
Measure Permanent Nature.
How many Humans are participating?
Distinguish Holders from Colonists.
How is Territory distributed?
Measure capacity and concentration without automatically converting them into rankings.
How is SOLUM organized into Territory?
Measure Tiles, Farms, Cities, States and Kingdoms according to canonical composition.
How populated is the world?
Measure emerged Zips separately from maximum Zip capacity.
How developed is the world?
Measure maturity from valid History, not current balances alone.
What is changing?
Compare valid state through blockchain Time.
What economic state exists?
Measure contract-level signals without turning them into promises of value.
What does it mean?
Metrics alone cannot always answer that.
Use Canonical Rules and the AI Canon.
Follow Metrics Through the Atlas
What governs machine interpretation?
What translates underlying state and History into Zipvilization data?
What gives global state visual form?
What brings individual Territory to experiential depth?
What opens the boundary from observation toward participation?
What does the world mean?
What is the territorial substrate?
Who participates?
What territorial structures exist?
What population exists?
How does development progress?
What defines contract-level interpretation?
What remains open?
Where are the technical mechanics?
Where is the deeper technical construction layer?
Measure the Experiment
Zipvilization does not need Metrics to tell it what to become.
It needs Metrics to help us see what is actually happening.
The blockchain provides evidence.
Canonical Rules provide meaning.
SolumTools translates grounded state and History.
Metrics selects what is worth measuring.
Humans and AI observe.
Time passes.
The world changes.
And the measurements change with it.
Some numbers will increase.
Some may decrease.
Some patterns may appear.
Others may disappear.
Some questions will become measurable only after enough History exists.
And some things may never reduce cleanly to a metric.
That is acceptable.
The objective is not to turn Zipvilization into a dashboard.
The objective is to make the experiment observable without pretending that observation determines its outcome.
A metric requires something real to measure.
Evidence before narrative.
Measurement before interpretation.
We define the conditions. We do not define the outcome.