Indexing strategy: on-chain enumeration vs events

[greatest0fallt1me]

Description

Document that full enumeration of streams is indexer responsibility; if adding streams_for_payer map, spec cost and caps.

Requirements and context

• Prefer events + indexer.
• Optional capped view follow-up.

Suggested execution

• Fork the repository and create a branch (example below).
• Implement the changes in the StreamPay-Contracts Soroban crate (streampay-contracts).
• Keep the contract secure, tested, and documented; prefer small, reviewable diffs.

git checkout -b docs/indexer-vs-onchain-list

Implementation targets

• docs/indexing.md.

Tests and validation

• N/A.

• Run cargo test in StreamPay-Contracts.

• Cover edge cases; capture test output and short security notes in the PR description.

Guidelines

• Target minimum 95% test coverage for touched contract code (or justify gaps explicitly).
• Clear documentation (rustdoc / project docs as specified).
• Timeframe: 96 hours from assignment.

Example commit message

docs(contracts): indexing strategy for stream lists

[drips-wave]

This issue has been added to the Stellar Wave Program and is worth 200 Points.

🧑‍💻 Interested in contributing? Apply to work on this issue on Drips Wave, earn points, and receive rewards.

Warning

Only applications submitted via the apply link above will be considered. Please do not apply by commenting on the issue or opening a PR directly.

🤠 Repo maintainers: You can manage this issue's Points and Complexity on your Maintainer Dashboard here. Please keep an eye on applications and respond quickly 💙

ℹ️ Learn more about Drips Wave