[P2] Transaction history rows show no recipient/sender name

[islandbitcoin]

Filed by Lori (app audit). UX + design change.

Files: app/screens/transaction/transaction-history.tsx, app/components/transaction-list-item.tsx (approx — Nick to confirm)

Problem: Every row shows Sent USD / Received USD with no contact name. Users with 20+ transactions cannot identify any without tapping in.

Changes:

• Primary label: show recipient/sender username when available, fall back to Sent/Received
• Secondary label: show user note when available, otherwise show date (Feb 24 not a month ago), sats as last fallback only
• Apply same changes to Recent Activity on home screen

AC:

• Recipient/sender name shown as primary label when available

[linear]

ENG-150

[Nodirbek75]

Need to create a backend issue for this task @forge0x

[forge0x]

Bug Reproduction

Recorded on: iPhone 16 Pro · iOS 18.4 · Local backend · Flash debug build

https://github.com/lnflash/flash-mobile/releases/download/bug-ux-evidence/bug-562-v6.mp4

Every transaction row in both the home screen Recent Activity section and the full transaction history shows "Received USD" / "Sent USD" with no recipient or sender name. Users with more than a few transactions have no way to identify who they paid or received from without tapping each one individually.

---

Root Cause

File: app/components/transaction-item/TxItem.tsx (~line 80)

// Current — hardcodes direction + currency, never shows a name
<Text type="bl">{\ `${label[tx.direction]} ${tx.settlementCurrency}`}</Text>

The label map is:

const label = { SEND: 'Sent', RECEIVE: 'Received' }

The transaction object does carry counterparty data via tx.initiationVia and tx.settlementVia, but it is never read in this component.

---

Proposed Fix

The primary label should be the counterparty's username (or phone/LN address as fallback), with direction + currency as the fallback when no counterparty is known.

// Derive a human-readable counterparty label
const counterparty =
  tx.initiationVia?.__typename === 'InitiationViaLn'
    ? tx.initiationVia.paymentRequest   // Lightning: show truncated invoice or memo
    : tx.settlementVia?.__typename === 'SettlementViaIntraLedger'
    ? tx.settlementVia.counterPartyUsername   // On-us: show username
    : tx.settlementVia?.__typename === 'SettlementViaLn'
    ? tx.settlementVia.preImage            // External LN
    : null

const primaryLabel = counterparty ?? `${label[tx.direction]} ${tx.settlementCurrency}`

// In JSX:
<Text type="bl">{primaryLabel}</Text>

The same fix should be applied to the Recent Activity component on the home screen (app/components/home-screen/Transactions.tsx) which renders the same TxItem component — or directly to TxItem itself since it's shared.

---

Acceptance Criteria (from issue)

• Recipient/sender username shown as primary label when available
• User note shown as secondary label when set, otherwise formatted date (e.g. Feb 24 not a month ago)
• Sats shown as last fallback only
• Fix applies to both Recent Activity (home screen) and full transaction history
• Fallback to Sent/Received USD when no counterparty is known (e.g. on-chain, external LN)

---

Related: Backend issue needs to confirm which fields are reliably populated on SettlementViaIntraLedger.counterPartyUsername (see comment from @Nodirbek75 above).

[forge0x]

Noted @Nodirbek75 — I'll create a backend issue to track the work needed for populating recipient/sender names in the transaction history. Will link it back here once it's up.

[forge0x]

Noted @Nodirbek75. I'll create the backend issue to track the API changes needed for populating recipient/sender names in transaction history.

— Forge | Flash Engineering