Skip to content

sdfMandate sums 15 accounts while the Lumens docs and Mandate page list 13 (two extra escrow accounts, 4.0000130 XLM) #363

Description

@shyhaeky95

What

sdfAccounts() in common/lumens.js maps over the entire accounts object.

On the current default branch (also present at commit cd0e8b66…), that object contains 15 entries: the 13 accounts documented under the SDF Mandate, plus:

  • escrowJan2022 — GD2D6JG6…PLTP
  • escrowJan2023 — GA2VRL65…URRA

escrowJan2021 is already commented out.

The Lumens docs (lumens.mdx, stellar-docs d9c53937…) describe the Mandate page as “the authoritative source for the mandate's structure and accounts” and list 13 accounts.

Neither of the two escrow addresses appears in the current Lumens docs or in the Mandate page HTML fetched on 2026-09-23.

Effect

/api/v3/lumens reports an sdfMandate value that is 4.0000130 XLM above the sum of the 13 documented accounts.

Because sdfMandate is subtracted when calculating circulatingSupply, circulatingSupply is lower by the same amount.

The difference is tiny, but it means the API value cannot currently be reproduced from the documented Mandate account set.

Reproduce

The two additional accounts held:

  • escrowJan2022: 2.0000129 XLM, last modified at ledger 56,656,448
  • escrowJan2023: 2.0000001 XLM, last modified at ledger 56,035,766

Total: 4.0000130 XLM.

On 2026-08-03:

  • /api/v3/lumens returned sdfMandate = 15463207091.137619 (updatedAt 2026-08-03T06:08:38Z)
  • the 13 documented accounts summed to 15463207087.137606 at ledger 63,775,885
  • two independent RPC providers matched the 13-account sum to the stroop

Difference: 4.0000130 XLM, exactly equal to the balances of the two escrow accounts. Both escrow balances had been unchanged since before ledger 63,775,885.

As a current cross-check, on 2026-09-23 two API responses (updatedAt 07:14:17Z and 07:34:17Z) each matched the RPC sum of all 15 accounts exactly:

14799502860.4181457 XLM

Question

Are escrowJan2022 and escrowJan2023 intentionally included in the definition of sdfMandate?

If not, excluding them from sdfAccounts() would align the API metric with the documented Mandate account set.

If they are intentionally included, documenting the two accounts on the Lumens docs / Mandate page would make the API definition reproducible from the published documentation.

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

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions