Back

Token-account and owner reconciliation

P10-L03 · P10 · P10-M01

Reconcile accounts without assuming address equals human

ILLUSTRATIVE · needs_review

Prerequisites: P10-L02

Learning objectives

  • Reconcile accounts without assuming address equals human
  • Aggregate token holdings by a stated technical authority without counting humans.

Why this matters

A holder chart can overcount one authority across multiple token accounts or undercount beneficiaries behind a custody address. The denominator and aggregation rule determine what the chart means.

Explanation

Distinguish three layers: a chain account address, the program that owns its data, and an authority recorded inside token-account data. In the Solana account model, program ownership is a technical access relation; it is not a person’s name. A token account may designate a wallet authority while being owned at the account-model layer by a token program. Use the relevant program and mint identifiers, not a display symbol, to select compatible records.

Reconcile rows at a fixed observation slot before aggregation. Exclude unrelated mints explicitly; retain zero-balance or closed-account handling in the method. Sum only quantities expressed in the same raw unit. If delegate or multisignature information is unavailable, keep it unavailable rather than assigning a controller. The aggregation key answers a specific question, such as “balance per recorded authority,” not “wealth per person.”

An authority may be a custody service, program-derived address or signing arrangement. Conversely, one person may use many authorities. A concentration chart therefore needs a label explaining both its key and its unknown-beneficiary boundary. Wallet Intelligence may supply technical rows; provider labels must remain attributed and independently unverified unless a separate proof exists.

Key terms

Program owner: program permitted to modify account data.

Token authority: authority field inside token-account state.

Aggregation key: field used to combine compatible rows.

Beneficial owner: economic person or entity, not established by an address alone.

Historical example

ILLUSTRATIVE at slot S: token accounts TA1 and TA2 for mint M hold 60 and 40 units with authority W1. TA3 holds 100 M units with authority W2. TA4 holds 900 units of another mint X. All quantities are stipulated whole-unit equivalents. W2 may be custody; no beneficiary data exists. There are three selected accounts, two recorded authorities, and no proven count of humans.

Visual specifications

Holder distribution with 50/50 authority bars and a companion account reconciliation table. Show excluded mint X separately; add unknown-beneficiary labels instead of portraits.

Caption: Fictional authority concentration, not a distribution of human investors.

SPECIFICATION_ONLY — the rendered visual has not been produced or independently reviewed.

What the evidence proves

For the fictional selected mint, total balance is 200 units and W1/W2 each aggregate to 100, or 50%. These are authority shares at slot S.

What the evidence does not prove

It proves no human count, independent investors, custody beneficiaries, shared control or current holdings. A technical 50% share is not necessarily one person’s economic exposure.

Common mistakes

Summing mint X into M; using program owner as wallet owner; counting accounts as people; assigning custody balances to the custodian’s personal wealth.

Practical exercise

Build an authority-level table for M, calculate the denominator and shares, and write a caption that rejects the “three investors” claim. State what W2 needs before beneficiary-level analysis.

Show worked correction

Select TA1–TA3, excluding TA4 by exact mint. W1 = 60 + 40 = 100; W2 = 100; denominator = 200; each recorded authority has 50%. Caption: “Illustrative balances aggregated by token authority for mint M at slot S; beneficiary count and common control are unknown.” “Three investors” confuses account count with people. W2 requires admissible custody/beneficiary evidence; absent that, mark human distribution insufficiently evidenced.

Checklist

  • Match exact mint and program.
  • Use one stated observation slot.
  • Declare the aggregation key and denominator.
  • Keep authority, delegate, program owner and human distinct.

Summary

Reconciliation yields a technical concentration measure only when identity, mint, unit and time basis remain explicit.

Summary

  • Account ownership and token authority mean different things.
  • Use a compatible mint and unit denominator.
  • A holder chart does not count humans.

Next lesson

P10-L04

Tools

Use the named ZECOIN tool only as an evidence-reading context. This lesson creates no tool output, account session or entitlement. Offline exercise; do not sign, deploy, approve or fund anything.

Sources & claim boundaries

  • SOL: Solana account model — Account program ownership is distinct from a token-account authority or human identity. Boundary: Mechanism documentation only; original illustrative values are stipulated, not observations. Historical records have separately frozen provenance and explicit collection gaps.

Evidence classifications

ILLUSTRATIVE — entirely fictional offline inputs; no current observation.

Observation date

null — no real observation

Content version

1

Review date

null

Review status

needs_review

Visual specifications

P10-L03-V01

SPECIFICATION_ONLY · ILLUSTRATIVE

Reconcile accounts without assuming address equals human

Fictional authority concentration, not a distribution of human investors.

Holder distribution with 50/50 authority bars and a companion account reconciliation table. Show excluded mint X separately; add unknown-beneficiary labels instead of portraits.

Holder distribution with 50/50 authority bars and a companion account reconciliation table. Show excluded mint X separately; add unknown-beneficiary labels instead of portraits.

Stack observations, assumptions, gaps and conclusion at 390 px; retain full IDs and a complete text equivalent. Any wide table scrolls locally.

Prose may follow RTL; IDs, quantities and time axes remain LTR. Preserve dependency direction.

P10-L03-ILLUSTRATIVE-v1

Sources & claim boundaries

SOL · PRIMARY_DOCUMENTATION

Solana account model

Supported claim
Account program ownership is distinct from a token-account authority or human identity.
Verification boundary
Mechanism documentation only; original illustrative values are stipulated, not observations. Historical records have separately frozen provenance and explicit collection gaps.
Checked at
2026-10-02
Open primary source
https://solana.com/docs/core/accounts

Dataset provenance

id: P10-L03-ILLUSTRATIVE-v1

dataStatus: ILLUSTRATIVE

observedAt: null

source: Original offline scenario in realOrHistoricalExample

scope: Fictional stipulated labels and values. No wallet, deployment, transaction, token launch or production observation.

Test your reasoning

P10-L03-Q1 · TA1 and TA2 share authority W1. How should authority-level aggregation handle them?
P10-L03-Q2 · Why exclude TA4 from the denominator?
P10-L03-Q3 · What is W1’s fictional authority share?
P10-L03-Q4 · W2 may be custody. What can its balance establish?
P10-L03-Q5 · A token account is owned by its program. Does that name a human controller?