Progress reporting callbacks for cold scans

[truthixify]

Tier: S (1-2 days) | Type: dx

Context. fetchAnnouncementsStream and the pipeline scanner (src/chains/stellar/scanner/pipeline.ts) stream results but give the caller nothing to display while a cold scan chews through 50k events. Every example app (stellar-react-receive, stellar-cli-scan, the Chrome extension) currently guesses at a spinner. Add a first-class onProgress hook so UIs can render honest progress bars.

Scope.

• ScanProgress type: { scannedLedgers, totalLedgers?, matches, elapsedMs }.
• Optional onProgress?: (p: ScanProgress) => void on the public stellar scan entry.
• Emit at a bounded rate (throttle to at most once per 100ms).
• Wire it through the Chrome extension example so the popup shows real progress.

Acceptance.

• Callback fires at least on start, on each batch boundary, and on completion
• Emission is throttled (verified by test with a fake clock)
• No public-API change when the callback is omitted
• Chrome extension popup displays live progress

Files. src/chains/stellar/scan.ts, src/chains/stellar/scanner/pipeline.ts, examples/stellar-chrome-extension/src/, test/chains/stellar/scan.test.ts.

[alhabeeby-hub]

@alhabeeby-hub has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hello Maintainer, I’ve reviewed this issue carefully and have a clear understanding of the problem and expected outcome. I’m confident I can take it from implementation through testing and deliver a clean PR. I’d be glad to take ownership of it.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @alhabeeby-hub to this issue.

[Meme11030]

@Meme11030 has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hi maintainer I will like to work on this issue please

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Meme11030 to this issue.