Methodology

Mainnet

Data status

Provider: MainnetHacdProvider @ http://nodeapi.hacash.org
Diamonds in dataset: 133412
Demo mode: No
Last sync: n/a
Mainnet live. Chain diamonds: 133,412, height 766,271. Indexed: 0.

Does the score follow Hacash mining rarity?

Yes in substance. The score answers: “How rare were the HIP-5 mining outcomes for this diamond (shape, color, style, letter pattern)?”

Shape: HIP-5 protocol (special shapes ~1/256 each, Standard ~248/256)
Color: 16-letter alphabet / main color (~1/16)
Style & letter patterns: published mainnet HIP-5 rates (e.g. hacash.diamonds/types, Pure ~0.0285%, Big slam, etc.)
Combo: product of those rates (joint mining rarity)

Hacash.org does not publish a single official 0-100 number. We turn the official rarity rates into one comparable score. This is not market price and not bid size.

How the score works

Each HACD gets a composite mining-rarity score 0-100 from HIP-5 mining frequencies:

// chance to mine this trait (HIP-5 / chain stats)
freq_shape, freq_color, freq_style, freq_pattern

trait_score = normalize(-log10(freq))   // rarer → higher
combo_freq  = freq_shape × freq_color × freq_style × freq_pattern
final       = 0.28·shape + 0.22·color + 0.25·style + 0.20·pattern + 0.05·combo

percentile  = rank among local index only (not full supply unless indexed)

Missing traits are excluded from weights. Percentile is relative to the local mainnet index sample until more diamonds are synced.

Weights

Shape mining rarity (HIP-5)28%

Color mining rarity (HIP-5)22%

Style mining rarity (HIP-5 stats)25%

Letter pattern rarity (name / literals)20%

Combined trait rarity (shape×color×style×pattern)5%

Traits examined

Name & letter patterns (repeats, symmetry, unique chars)
Diamond number / mint position
Shape, color, style (HIP-5 inspired)
Visual gene / life gene when present
Born block height, bid amount
Owner / miner / inscriptions when available

Data sources

MainnetHacdProvider (default): live Hacash mainnet via node RPC
MockHacdProvider: offline demo diamonds for UI tests
HacdExplorerProvider: adapter for explorer APIs (HACD_EXPLORER_API_URL)
HacashNodeProvider: adapter for fullnode RPC (HACASH_NODE_RPC_URL)
HIP-5 public frequency priors used only as fallback when the local sample has zero observations for a trait value

Limitations

Local index may not cover full mainnet supply (~100k+ diamonds).
Market prices and full ownership history are not fully modeled.
Rarity ≠ market value. Demand, aesthetics, and liquidity still matter.
Confidence score drops when fields are missing or the sample is small.