sd-004: The RPC method reference pages describe pagination limits as "hardcoded in

[kalepail]

Finding

The RPC method reference pages describe pagination limits as "hardcoded in
Stellar-RPC for performance reasons" (getTransactions and getLedgers 1–200,
getEvents 1–10000), but in the stellar-rpc source every one of these limits is
an operator-configurable option — --max-transactions-limit /
--default-transactions-limit, --max-events-limit / --default-events-limit,
--max-ledgers-limit / --default-ledgers-limit, settable via CLI/TOML/env —
whose SHIPPED DEFAULTS are the documented numbers (the only validation is
default ≤ max, with no absolute ceiling). By contrast Horizon's 200 IS a true
compile-time constant (stellar/stellar-horizon
internal/db2/page_query.go: MaxPageSize = 200), so the same word describes
two different things across adjacent doc pages.

Evidence

Docs (2026-07-03): "The limit for getTransactions can range from 1 to 200 - an
upper limit that is hardcoded in Stellar-RPC for performance reasons."
Source (same day): options.go — Name: "max-transactions-limit" ... DefaultValue: uint(200), Name: "default-transactions-limit" ... DefaultValue: uint(50); handlers are constructed from
cfg.MaxTransactionsLimit / cfg.DefaultTransactionsLimit. Same pattern for
events (10000/100) and ledgers (200/50).

Additional recorded evidence:

• developers.stellar.org method pages (getTransactions, getEvents, getLedgers) fetched 2026-07-03
• stellar/stellar-rpc cmd/stellar-rpc/internal/config/options.go (same day)

Recommendation

Reword the method pages: "the default configuration caps this at 200
(operators can adjust via --max-transactions-limit); public providers
typically run the defaults." One sentence per method page fixes it; keeping
"hardcoded" only where it is true (Horizon) preserves the useful distinction.

Source Record

This was found by the downstream Raven eval/improvements loop and recorded as sd-004 (stellar-docs, discovered 2026-07-03). Public record: https://github.com/kalepail/stellar-raven/blob/main/improvements/stellar-docs/sd-004-rpc-limits-described-as-hardcoded.md