Skip to content

Public all-wallet balance export (unblocks rustchain-bounties#1113 distribution analysis) #8359

Description

@Scottcjn

Gap, confirmed 2026-09-05. rustchain-bounties#1113 asks contributors to compute Gini, top non-founder holders, and a distribution chart from "all wallet balances via the explorer API". No such public endpoint exists. /api/miners returns active miners only, so any distribution statistic built from it is wrong by construction. A contributor (@prins1bap-ui) noticed this and asked before building; others may already have submitted numbers derived from the wrong population.

Proposal. Add a read-only, paginated GET /api/balances/export (or a nightly static JSON at /exports/balances-YYYY-MM-DD.json) on the primary node:

  • fields: wallet, balance_rtc, is_founder (the four founder_* wallets), kind (native/hosted_handle/bcn), last_activity
  • excludes nothing (transparency), rate-limited, cached per epoch
  • documented in the explorer

Until this exists: #1113 should carry a note telling contributors not to build against /api/miners. I will add that note on the bounty.

Reward suggestion for the implementer: 25 RTC (touches the node, needs a test, no consensus impact).

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions