Ledgera

Data & Methodology

How every number in your transparency report is calculated, where it comes from, and what we can't show.

01

Core principles

Read-only

Ledgera never asks for keys, seed phrases, or signing permissions. Every query is a public on-chain read. Your wallet is never at risk.

On-chain sourced

All data comes from Celestia LCD (REST API) and Celenium indexer. No custom databases, no scraped data. Every number is verifiable.

Honest limits

Where data is incomplete or estimated, we say so. We label estimates as estimates and show formulas rather than hiding methodology.

02

Data sources

Celestia LCD (REST API)

Staking delegations, balances, rewards, unbonding, validator metadata, pool state.

celestia-rest.publicnode.com
Celenium Indexer

Validator set with valoper mapping, delegation lookups, transaction history (messages), namespace data.

api-mainnet.celenium.io
CoinGecko

TIA/USD price for portfolio valuation. Cached 60 seconds. If unavailable, TIA amounts shown without USD conversion.

api.coingecko.com
03

How we calculate

Staked balance

Sum of balance.amount across all delegation responses. We use balance.amount (utia), not delegation.shares – shares diverge from tokens after slashing events.

staked_tia = Σ delegations[i].balance.amount / 1,000,000

Estimated APR

Network-level estimate, not your realized yield. Calculated from annual provisions and bonded token pool, adjusted per-validator by commission rate, stake-weighted across your delegations.

nominal_apr = annual_provisions / bonded_tokens
validator_apr = nominal_apr × (1 − commission_rate)
your_apr = Σ (stake_i × validator_apr_i) / total_staked

Excludes compounding, price changes, downtime, and slashing. Labeled "Est. APR" in the UI.

Trust Score

Deterministic 0–100 score from three on-chain inputs. Formula printed verbatim in the UI under "How is this computed?"

score = clamp(100 − commission_penalty − status_penalty, 0, 100)
Commission: ≤5%→0 · 5-10%→−5 · 10-15%→−12 · 15-20%→−22 · >20%→−35
Status: clean→0 · unbonded→−25 · jailed→−60 · tombstoned→−100

Pending rewards

Current unclaimed rewards from the distribution module. This is not lifetime earned – only what's pending right now.

rewards_tia = floor(DecCoin_amount) / 1,000,000
04

Known limitations

No lifetime claimed rewards – LCD only shows current pending. Historical claim totals require indexing which we don't run.

APR is a network estimate – not your realized return. Excludes compounding, price movement, downtime, and slashing.

Governance shows breadth, not alignment – we show whether a validator voted, not how. Some validators vote from separate wallets and appear as "–".

Slash detection is heuristic – based on 5-min token/status deltas, not slash events. We say "possible", never an exact amount.

Activity depends on Celenium – reward claim amounts show "–" (amount is in tx events, not message body). Authz-wrapped restakes may not decode.

Bot alerts have ~5 min latency – poll-based, not streaming. Commission changes, jailing, and status shifts are detected on the next scan cycle.

05

Supported networks

Celestia Celestia

Full transparency dashboard, trust scores, activity, Telegram alerts.

Starknet Starknet

Validator operations active. Dashboard support planned.

Dymension Dymension

Validator operations active. LCD integration available.