Governance Integrity Framework (GIF)
A Governance Observability dApp & Developer Integration for Terra Classic
Overview
The Governance Integrity Framework (GIF) is an off-chain governance observability dApp designed for Terra Classic.
It provides developers with a public read-only API, governance metrics, and optional scoring outputs that can be integrated into explorers, wallets, dashboards, and validator tooling — similar in spirit to how services like validator.info expose validator performance data.
This is NOT a governance proposal.
- No protocol changes
- No consensus changes
- No vote censorship
- No vote invalidation
- No slashing
- No validator software changes
The framework is observer-only, non-enforcing, and opt-in for frontends.
Design Goals
The goal of GIF is to make governance behaviour:
- Observable
- Measurable
- Comparable
- Easy to integrate
Without compromising:
- decentralisation
- validator autonomy
- governance neutrality
GIF does not tell the chain what to do — it simply exposes transparent governance signals that others may choose to display or ignore.
High-Level Architecture
The framework consists of three off-chain components:
- Governance Indexer
- Governance Quality Scoring Engine (GQS)
- Public Read-Only API
No consensus or protocol changes are required.
Data Flow
On-chain governance events
↓
Governance Indexer
↓
Governance Quality Scoring Engine (GQS)
↓
Public Read-Only API
↓
Explorers / Wallets / Dashboards / dApps
Validator-Facing Summary
- Your validator software does not change
- You do not need to install anything
- No new transaction types are required
- Governance votes are not modified or filtered
- The system observes governance behaviour only
1. Governance Indexer
Purpose
Continuously ingest governance-related on-chain data and normalise it into a structured dataset suitable for analytics, scoring, and UI consumption.
Data Sources (Cosmos SDK / Terra Classic)
gov/v1- proposals
- deposits
- votes
- tallies
- proposal status transitions
staking/v1- validator operator addresses
- monikers
- commission rates
- validator status
- Block metadata
- timestamps
- heights
- event logs
- Optional external metadata
- validator-supplied links or descriptors (opt-in only)
Normalised Outputs
- Proposal registry
- proposal ID
- type
- submit time
- voting window
- final status
- Vote records
- validator address
- vote option
- weighted vote
- timestamp
- Participation tracking
- voted / not voted
- vote timing (early / late / last-minute)
2. Governance Quality Scoring Engine (GQS)
Purpose
Transform raw governance activity into standardised, transparent metrics that frontends may optionally display.
What GQS Produces
Per-validator metrics:
- governance participation rate
- missed proposal count
- abstain ratio
- vote timing distribution
- participation trend over time
Per-proposal metrics:
- validator participation percentage
- voting concentration
- abstain distribution
- late-vote clustering
Optional Scoring Outputs
Examples (non-enforcing):
- participation score
- consistency score
- responsiveness score
Important:
Scores are informational only.
They do not affect:
- voting power
- proposal outcomes
- validator status
Frontends may:
- display them
- weight them differently
- or ignore them entirely
3. Public Read-Only API
Purpose
Expose governance observability data through a simple, stable interface that other developers can integrate into their products.
Example API Endpoints
GET /validators
Returns a list of validators with governance metricsGET /validators/{valoper}
Full governance profile for a specific validatorGET /proposals
Proposal list with participation summariesGET /proposals/{id}
Detailed proposal timeline and vote distributionGET /metrics
Aggregated governance statistics for the chain
Data Characteristics
- Read-only
- Cache-friendly
- Deterministic
- Versioned
No authentication is required for public endpoints.
4. Frontend & dApp Integrations
GIF is designed to integrate cleanly with:
- Explorers
- Wallets
- Validator dashboards
- Governance tracking tools
- Delegator decision UIs
Example Use Cases
- Wallets showing validator governance participation before delegation
- Explorers highlighting low-engagement proposals
- Validator dashboards adding governance tabs
- Community sites visualising long-term governance trends
Optional UI components may include:
- governance participation badges
- trend sparklines
- proposal engagement charts
5. Safety & Neutrality Guarantees
This framework explicitly avoids:
- censorship
- enforcement
- vote invalidation
- slashing
- blacklists
- protocol-level hooks
It is:
- off-chain
- observer-only
- opt-in for display
- transparent by design
6. Governance Philosophy
GIF does not define “good” or “bad” governance.
It provides:
- raw data
- derived metrics
- optional indicators
Interpretation is left to:
- delegators
- developers
- explorers
- wallets
This preserves decentralisation while improving visibility.
7. Open Integration & Extension
Developers are free to:
- consume the API
- embed widgets
- build their own scoring models
- extend visualisations
As long as integrations remain:
- transparent
- non-enforcing
- observer-only
Summary
The Governance Integrity Framework is a developer-focused governance observability dApp, not a protocol change and not a governance proposal.
It improves transparency without sacrificing:
- autonomy
- decentralisation
- validator independence
Adoption is entirely voluntary and frontend-driven.