Skip to content

Data & sources

Where catalogue data comes from and what every field means.

  • 5 min read
  • Page 07 of 24

Every number on an Asteria entry is either stored or derived — and at launch, every stored scientific value will trace back to a public source. This page lists each field, its unit and where it comes from, and is plain about which parts are still preview data.

Stored fields#

Stored fields are the values written into each catalogue record. They fall into three groups.

Identity and editorial#

FieldTypeMeaningSource
slugtextThe entry's address on this site, as in /explore/vesperine.Assigned by Asteria
registryIdtext, ASR-0000The permanent registry identifier. Never reused or changed.Assigned by Asteria
nametextThe registry name. Not an official IAU name.Asteria naming process
meaningtextWhere the name comes from.Asteria editorial
taglinetextA one-line summary used on cards.Asteria editorial
storytextA short description of the asteroid and its orbit.Asteria editorial, based on the data

Physical and orbital#

FieldUnitMeaningPlanned source
spectralC, S, M, V, X or DSimplified spectral class. See Spectral classes.Published spectroscopic surveys, as catalogued in the JPL Small-Body Database
diameterKmkmEffective (mean) diameter.Thermal-infrared measurements where available, otherwise derived from H and albedo
albedo0 to 1Geometric albedo: how reflective the surface is in visible light.Thermal-infrared measurements, such as NASA's NEOWISE survey
rotationHourshoursRotation period, from lightcurve observations.Published lightcurve compilations
orbit.aAUSemi-major axis: the orbit's size.JPL Small-Body Database / Minor Planet Center
orbit.e—Eccentricity: the orbit's shape.JPL Small-Body Database / Minor Planet Center
orbit.idegreesInclination to the ecliptic.JPL Small-Body Database / Minor Planet Center

Listing and technical#

FieldTypeMeaningSource
statusavailable, reserved, named, coming-soonThe listing state shown in the collection.Asteria (preview values)
tierGenesis, Celestial, SovereignThe collection tier. See Pricing & tiers.Asteria curation
priceEthETH, or emptyAn indicative launch price, empty when an entry is not offered.Demo value; final prices confirmed at launch
seedintegerDrives the procedural shape used in illustrations, glyphs and animations.Assigned by Asteria. Artwork, not a measured shape
officialDesignationtext, or emptyThe Minor Planet Center number and/or designation.Set during verification; empty in preview

Derived fields#

Derived fields are never stored. They are computed from the stored values every time, so they cannot drift out of step with them.

FieldUnitHow it is computed
orbitClass—Rule-based classification from a, e and i. See Orbits explained.
nearEarthyes / noTrue for the Atira, Aten, Apollo and Amor classes (perihelion below 1.3 AU).
perihelionAUAUa × (1 − e)
aphelionAUAUa × (1 + e)
periodYearsyearsa^1.5, from Kepler's third law
speedKmSkm/s29.78 / √a, the mean orbital speed in a circular approximation
absoluteMagnitudemagnitude5 × log10(1329 / (D × √p)), from diameter D and albedo p
traitslistDescriptive tags, from the rules below

Trait rules#

TraitRule
Near-Earth objectOrbit class is Atira, Aten, Apollo or Amor
Fast rotatorRotation period under 3 hours
Slow rotatorRotation period over 12 hours
High inclinationInclination over 15°
Large bodyDiameter of 10 km or more
Sub-kilometreDiameter under 1 km
High albedoAlbedo of 0.30 or more
Very dark surfaceAlbedo of 0.06 or less

From fields to token metadata#

The same record feeds the planned token metadata. Familiar marketplace fields — name, description, image and attributes — sit at the top level; the full record lives in a namespaced asteria block, including the official designation and a list of data sources that will be filled in on verification. Here is the generated metadata for Vesperine:

ASR-0001.json
{
  "name": "Vesperine (ASR-0001)",
  "description": "The first light after dusk. A stony wanderer of the middle belt, bright enough to catch the Sun like a struck match. Vesperine opens the Asteria registry — the first entry, the first name. Registry name assigned by Asteria; not an IAU-recognised name. This token is a digital collectible and confers no ownership of any celestial body.",
  "image": "ipfs://<cid>/ASR-0001.png",
  "animation_url": "ipfs://<cid>/ASR-0001.mp4",
  "external_url": "https://asteriaasteroids.xyz/explore/vesperine",
  "attributes": [
    {
      "trait_type": "Spectral class",
      "value": "S-type"
    },
    {
      "trait_type": "Orbit class",
      "value": "Middle main belt"
    },
    {
      "trait_type": "Tier",
      "value": "Celestial"
    },
    {
      "trait_type": "Near-Earth object",
      "value": "No"
    },
    {
      "trait_type": "Diameter (km)",
      "value": 3.8,
      "display_type": "number"
    },
    {
      "trait_type": "Albedo",
      "value": 0.24,
      "display_type": "number"
    },
    {
      "trait_type": "Rotation period (h)",
      "value": 5.6,
      "display_type": "number"
    },
    {
      "trait_type": "Orbital period (yr)",
      "value": 4.29,
      "display_type": "number"
    }
  ],
  "asteria": {
    "schema_version": "1.0.0",
    "registry_id": "ASR-0001",
    "registry_name": "Vesperine",
    "name_meaning": "From the Latin vesper — the evening star, the first light after sunset.",
    "official_designation": null,
    "spectral_class": "S",
    "orbit": {
      "orbit_class": "Middle main belt",
      "semi_major_axis_au": 2.64,
      "eccentricity": 0.11,
      "inclination_deg": 7.2,
      "perihelion_au": 2.35,
      "aphelion_au": 2.93,
      "period_years": 4.289
    },
    "physical": {
      "diameter_km": 3.8,
      "geometric_albedo": 0.24,
      "rotation_period_h": 5.6,
      "absolute_magnitude_h": 14.27
    },
    "data_sources": [
      "To be linked on verification: JPL Small-Body Database, Minor Planet Center"
    ],
    "disclaimer": "Registry name only; not an official IAU designation. No property right in any celestial body is conveyed."
  }
}

The schema, currently at version 1.0.0, is documented field by field in Token metadata.

Planned sources#

At launch, verified entries will draw on established public sources. Asteria does not discover, observe or measure asteroids.

SourceOperated byWhat it will provide
JPL Small-Body Database (opens in a new tab)NASA Jet Propulsion Laboratory, Solar System Dynamics groupOrbital elements with epoch, absolute magnitude, and diameter, albedo, rotation period and spectral type where they have been measured
Minor Planet Center (opens in a new tab)Smithsonian Astrophysical Observatory, under the auspices of the IAUOfficial numbers and designations, observation records and orbits
Thermal-infrared surveysVarious, including NASA's NEOWISEDiameters and albedos
Lightcurve compilationsPublished research cataloguesRotation periods
International Astronomical Union (opens in a new tab)IAU, through its Working Group Small Bodies NomenclatureOfficial names, referenced only — never used as Asteria names

Verification process#

Verification is planned for phase 1 of the roadmap, before any entry is offered.

  1. Match the designation

    Each inventory entry is matched to its official Minor Planet Center number or designation. An entry that cannot be matched unambiguously is not offered.

  2. Snapshot the data

    Orbital and physical values are retrieved from the source databases, together with the retrieval date and the epoch of the orbital elements.

  3. Recompute and cross-check

    Derived values — orbit class, perihelion, aphelion, period and absolute magnitude — are recomputed and compared with the source. Differences, such as a body near a class boundary, are reviewed by hand.

  4. Flag what is unknown

    Many asteroids have no measured diameter, albedo, rotation period or spectrum. Missing values will be marked as not measured, not filled with estimates presented as measurements.

  5. Publish

    The entry is published with officialDesignation set, its sources listed in the token metadata, and the "Preview data" indicator removed.

Status today#

Catalogue entries
14
All preview data
Verified entries
0
Verification is planned
Official designations
0
Set on verification
Metadata schema
v1.0.0
ERC-721 + asteria block

Update policy#

Science moves on, and the catalogue is designed to move with it.

  • What can change. Orbits are refined as observations accumulate, and new measurements can revise a diameter, an albedo or a spectral class. Scientific data is planned to be versioned and dated, so that every revision is traceable.
  • What never changes. The registry ID, and the registry name once it has been sealed at the naming ceremony.
  • How changes are announced. Changes to the data model, the metadata schema and the catalogue are recorded in the changelog.
  • Corrections. A channel for reporting data errors is planned to be published before launch.

How revised scientific data will be reflected in already-issued token metadata depends on the final contract and storage design, and will be documented in Smart contracts before launch.

Next steps#