Recipient Payout History Cross-Invoice Totals

[Kingsman-99]

Description

When auditing disbursements, finance teams need to see how much a specific recipient has received across all invoices over any date range, but currently data is siloed per invoice page. This issue adds a recipient payout history view that aggregates all confirmed payouts to a given Stellar address across every invoice on the platform, displays a sortable/filterable table with per-invoice breakdowns, and surfaces cross-invoice lifetime totals per asset.

Technical Context

Create app/dashboard/recipient/[address]/page.tsx as a server component that calls app/api/recipients/[address]/history/route.ts. The API route queries the invoice database for all recipient entries matching the address (owned by or shared with the requesting user), joins with confirmed payment records, and returns an array of RecipientPayoutRecord. Build components/dashboard/RecipientHistoryTable.tsx with @tanstack/react-table v8 for column sorting, per-column filtering, and pagination. Lifetime total cards per asset (XLM, USDC, custom) sit above the table and update reactively when filters change. The address should resolve to a federation name if available (reuse hooks/useAddressLabel.ts from issue 9). Export the filtered table data as CSV using the papaparse library.

Acceptance Criteria

• The recipient history page loads all confirmed payouts for the given address and displays them in the table sorted by date descending by default
• Sorting and filtering columns update the displayed rows without additional network requests (client-side)
• Lifetime total cards reflect only the rows currently shown after filtering is applied
• CSV export downloads a file containing all currently-filtered rows with headers matching the visible columns
• Navigating to the page for an address with no payout history shows an empty state with a contextual message rather than a blank page
• All CI checks (npm test, npm run build, ESLint/TypeScript) pass and the branch has no merge conflicts

---

[mikevill20]

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

Hello maintainer, please assign this issue to me. Thanks

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

[Daniel202251]

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

Good day maintainer
Please kindly assign me this issue

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

[felladaniel36-hash]

@felladaniel36-hash has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

I'd like to claim this issue. I have reviewed the details and can begin working on a fix right away. Please assign it to me if it's still available. Thanks!

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

[goldemaverick-ui]

@goldemaverick-ui has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

I would like to work on this issue

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

[drips-wave]

Congratulations, @goldemaverick-ui! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on July 30, 2026.

🧑‍💻 @goldemaverick-ui: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[drips-wave]

This issue has been completed by @goldemaverick-ui as part of the Stellar Wave Program's 7th Wave 🥳

😎 @goldemaverick-ui: You earned 200 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here. You can also Leave a review to share your experience working on this issue.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.