LefCoin — LOVE Index Methodology & Live Dashboard

METHODOLOGY

How the LOVE Index Is Calculated

The LOVE Index is a weighted composite score ranging from 0 to 1000. It is computed entirely on-chain by the SentimentOracle smart contract using this formula:

LOVE = Σ (Score_i × Weight_i) / 10,000

Each of the 6 subindices has a score between 0 and 1000 (where 500 = neutral, 0 = extremely negative, 1000 = extremely positive). Weights are expressed in basis points and sum to 10,000.

Subindices 0–4 are updated by the oracle pipeline every 6 hours, pulling real-world data from news APIs and running sentiment analysis. Subindex 5 (Good Spend) updates automatically on-chain when LefCoin is transferred to verified good destinations.

🕊️

00 — Global Peace (20%)

What It Measures

Armed conflicts, peace treaties, diplomatic progress, and global security sentiment.

Data Pipeline

GDELT global news: headlines on peace, conflict, war, treaty — 25 most recent articles
SerpAPI: Google search results for "global peace index" and conflict resolution
Reddit: Community discourse on world peace and geopolitics
ReliefWeb: UN OCHA humanitarian situation reports
Keyword sentiment analysis (positive/negative word ratio) with optional LLM

Data Sources (Live)

GDELT SerpAPI Reddit ReliefWeb

💝

01 — Charitable Giving (15%)

What It Measures

Global donation volumes, humanitarian aid activity, and charitable sentiment across news and community discourse.

Data Pipeline

GDELT global news: headlines on charity, donation, humanitarian, volunteer, giving
SerpAPI: Google search results for charitable giving trends and humanitarian aid
Reddit: Community discourse on philanthropy, mutual aid, and volunteering
ReliefWeb: UN OCHA humanitarian appeals and donation tracking
Keyword sentiment analysis (positive/negative word ratio) with optional LLM

Data Sources (Live)

GDELT SerpAPI Reddit ReliefWeb

💬

02 — Social Sentiment (20%)

What It Measures

Overall tone of public discourse across social media, news, and happiness research.

Data Pipeline

Hedonometer: Real-time happiness index from Twitter language analysis (University of Vermont)
GDELT global news: headlines on community, society, social progress
Twitter/X API: 50 recent English tweets on social wellbeing (non-retweets)
Reddit: Community discourse on social issues, public mood, civic life
Keyword sentiment analysis (positive/negative word ratio) with optional LLM

Data Sources (Live)

Hedonometer GDELT Twitter/X Reddit

🌍

03 — Environmental Care (15%)

What It Measures

Environmental progress: air quality, carbon intensity, biodiversity (including pollinator health 🐝), deforestation, and conservation sentiment.

Data Pipeline

Open-Meteo: Real-time air quality index (PM2.5, PM10, ozone) across global cities
UK Carbon Intensity API: Grid carbon intensity and fossil fuel mix
GDELT global news: headlines on environment, climate, conservation, pollution
GBIF: Wild bee occurrence records (Apoidea superfamily) — biodiversity proxy 🐝
iNaturalist: Citizen-science bee observations and species diversity 🐝
FAOSTAT: Global managed beehive population numbers 🐝
Global Forest Watch: Deforestation alerts and tree cover loss data
AQICN: World Air Quality Index — real-time PM2.5 from 5+ major cities
SerpAPI: Google search results for environmental progress and conservation

Data Sources (Live)

Open-Meteo AQ UK Carbon GDELT GBIF Bees 🐝 iNaturalist 🐝 FAOSTAT Global Forest Watch AQICN SerpAPI

❤️‍🩹

04 — Community Wellness (15%)

What It Measures

Public health outcomes, disease burden, life expectancy, maternal health, and community wellbeing indicators.

Data Pipeline

Disease.sh: Real-time global COVID-19 and infectious disease statistics
World Bank: Development indicators — poverty rates, education access, healthcare spending
WHO Global Health Observatory: Life expectancy at birth (WHOSIS_000001) via OData API
UN SDG Indicators: Maternal mortality ratio (SDG 3.1.1) and other sustainable development goals
GDELT global news: headlines on health, education, wellness, community outcomes
Reddit: Community discourse on public health, education, and civic life

Data Sources (Live)

Disease.sh World Bank WHO GHO UN SDG GDELT Reddit

💗

05 — Good Spend (15%)

What It Measures

On-chain activity: LefCoin transfers to verified good destinations in the GoodSpend Registry.

How It Works

Fully automatic — no oracle reporter needed
When LEF is sent to a registered charity/good destination, the LefCoin contract calls updateGoodSpend()
Score rises with cumulative good spend volume
Destinations are verified through LoveGovernance community voting

Verification

On-Chain Automatic Trustless

WHAT WE DON'T CLAIM

Radical Transparency

We believe the biggest risk in "positive impact" crypto is love-washing — making vague claims about doing good without the infrastructure to back them up. Here's what we want to be clear about:

LefCoin does not cure anything. It's a token with a sentiment-indexed reward mechanism. The LOVE Index reflects news sentiment, not ground truth.
Sentiment data is imperfect. Our off-chain subindices use keyword-based analysis and NLP on news headlines. This is a proxy for world sentiment, not an objective measurement of global wellbeing.
The oracle reporter is currently centralised. One authorized wallet submits off-chain data. This is a known limitation. Decentralised oracle networks (Chainlink, UMA) are the planned upgrade path.
Good Spend destinations require verification. The GoodSpend Registry is governed by token holders through LoveGovernance. Destinations must be proposed and voted on before registration.
The oracle reporter is centralised (for now). LefCoin is live on Base Mainnet. One authorised wallet currently submits off-chain data. Decentralised oracle networks (Chainlink, UMA) are the planned upgrade path.
Past sentiment scores don't guarantee future rewards. The LOVE Index fluctuates based on real-world events. Rewards amplification depends on the index being above 500 (neutral).

We publish everything: source code, contract addresses, methodology, data sources, and known limitations. If you find something we've missed, open an issue.

Transparency & Methodology

LIVE LOVE INDEX

METHODOLOGY

How the LOVE Index Is Calculated

What It Measures

Data Pipeline

Data Sources (Live)

What It Measures

Data Pipeline

Data Sources (Live)

What It Measures

Data Pipeline

Data Sources (Live)

What It Measures

Data Pipeline

Data Sources (Live)

What It Measures

Data Pipeline

Data Sources (Live)

What It Measures

How It Works

Verification

VERIFY IT YOURSELF

Read The Contracts

Call getLoveIndex()

Run The Pipeline

WHAT WE DON'T CLAIM

Radical Transparency