feat: Download receipt as csv

[C0mberry]

Description

• adding ability to download receipt as csv

Type of change

• New feature

Screenshots

solana-receipt.csv

Testing

1. open http://localhost:3000/tx/4izwTCUeRGAMGReXeXDumiBzAgXPGz6KzccacCf1WU5YXCCpSDjAQT7J6D6dY45bL1NW9AiqwCuWEnz3hbGtZS2y?view=receipt&cluster=mainnet-beta
   http://localhost:3000/tx/2kHbPUGzehenUXQbBfAVZGcuTrSUVDMEyU2aGcjFbuUAJkG28CyQPCGZF68u369MU7WHMvJboyioqyihvtR75nLn?view=receipt&cluster=mainnet-beta
2. click on download > csv btn
3. see the csv

Related Issues

HOO-327/

Checklist

• My code follows the project's style guidelines
• I have added tests that prove my fix/feature works
• All tests pass locally and in CI
• I have run build:info script to update build information
• CI/CD checks pass
• I have included screenshots for protocol screens (if applicable)

[vercel]

@C0mberry is attempting to deploy a commit to the Solana Foundation Team on Vercel.

A member of the Team first needs to authorize it.

[rogaldh]

Let's consider adding tests for CSV into the receipt.e2e

[greptile-apps]

Greptile Summary

This PR adds CSV export for Solana receipts, complementing the existing PDF download. A new generateReceiptCsv utility builds an 11-column row from FormattedReceipt, applies formula-injection sanitisation on the memo field, and triggers a browser download via the standard blob-URL pattern. The feature is wired into ReceiptContent with a useCallback consistent with the downloadPdf pattern, and surfaced in ReceiptView's popover as a sibling CSV button alongside PDF.

Key observations:

• Formula injection for memo is properly guarded by sanitizeCsvField, addressing the concern raised in a previous review thread.
• The deleted .test.ts files (normalize-search-params, use-primary-domain) are straightforward cleanup — .spec.ts equivalents already existed and continue to provide full coverage.
• fast-csv (the meta-package) is used solely for writeToString, pulling in @fast-csv/parse and several lodash sub-packages that are never exercised in a format-only use case. Depending directly on @fast-csv/format would avoid the unused parse bundle.
• The formula-injection sanitisation added to sanitizeCsvField has no dedicated test case verifying the guard fires for memos starting with =, +, -, or @.

Confidence Score: 4/5

• PR is nearly ready to merge — the core feature is solid and prior security concern is addressed; two minor P2 items remain.
• The CSV generation logic is correct, the formula-injection guard for memo is in place, the E2E and unit tests cover the happy path well, and the integration into the existing download UX is consistent. Two non-blocking P2 items remain: the fast-csv meta-package pulls in an unused parse bundle that could be trimmed, and the sanitizeCsvField guard itself lacks a targeted test case. Neither blocks shipping.
• app/features/receipt/lib/generate-receipt-csv.ts — dependency choice (fast-csv vs @fast-csv/format) and missing sanitization test

Important Files Changed

Filename	Overview
app/features/receipt/lib/generate-receipt-csv.ts	New module that builds a CSV row from a FormattedReceipt and triggers a browser download. Sanitisation for formula injection is applied to memo. Minor concern: pulls in the full fast-csv meta-package (including unused parse module) when only @fast-csv/format is needed.
app/features/receipt/lib/tests/generate-receipt-csv.spec.ts	Well-structured unit tests covering column ordering, optional fields, and download mechanics. Missing a test case for the formula-injection sanitisation path in sanitizeCsvField.
app/features/receipt/receipt-page.tsx	Adds downloadCsv callback via useCallback, consistent with the existing downloadPdf pattern. No issues.
app/features/receipt/ui/ReceiptView.tsx	Adds downloadCsv prop to interface and renders a new DownloadReceiptItem for CSV ahead of PDF. Clean, consistent change.
app/features/receipt/e2e/receipt.e2e.ts	Three new E2E tests cover the download menu visibility, correct filename pattern, and the "Downloaded!" state after CSV download. All guard correctly against missing receipt before asserting.

Sequence Diagram

sequenceDiagram
    participant User
    participant ReceiptView
    participant ReceiptContent (receipt-page.tsx)
    participant generateReceiptCsv
    participant fast-csv
    participant Browser

    User->>ReceiptView: clicks "Download" popover
    ReceiptView-->>User: shows CSV + PDF buttons
    User->>ReceiptView: clicks "CSV"
    ReceiptView->>ReceiptContent (receipt-page.tsx): downloadCsv()
    ReceiptContent (receipt-page.tsx)->>generateReceiptCsv: generateReceiptCsv(receipt, signature, usdValue)
    generateReceiptCsv->>generateReceiptCsv: buildReceiptCsvRow() → sanitizeCsvField(memo)
    generateReceiptCsv->>fast-csv: writeToString([row], { headers })
    fast-csv-->>generateReceiptCsv: CSV string
    generateReceiptCsv->>Browser: new Blob → createObjectURL → <a>.click()
    Browser-->>User: file download (solana-receipt-{sig}.csv)
    generateReceiptCsv->>Browser: revokeObjectURL(url)

Loading

_{Reviews (2): Last reviewed commit: "added sanitizeCsvField" | Re-trigger Greptile}

[C0mberry]

@greptile-apps check again

[rogaldh]

Could you check, please, that by sending the event to GA we can distinct PDF receipt from the CSV one

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
explorer	Ready	Preview, Comment	Mar 27, 2026 5:40pm

[rogaldh]

Except these LGTM