> ## Documentation Index
> Fetch the complete documentation index at: https://docs.confiroll.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Activity and history

> Your auditable record of every payout, withdrawal, and funding event, with explorer links, filters, batch grouping, and export, backed by your private ledger.

The Activity screen is your complete, auditable record. Every payout, every withdrawal, and
every funding event lands here the moment it settles, with the amount rendered from your
private ledger and the settlement linked out to the public block explorer. It is the one place
you go to reconcile a pay cycle, answer a contractor's question, or hand your accountant a
clean export.

## What you see

The screen opens on a reverse-chronological table of activity, with a filter bar across the top
and a summary strip that totals the rows currently in view. A tab toggles between the flat
**Activity table** and a grouped **Batch view**. Every row carries a status pill and, where an
on-chain event exists, a transaction hash that opens the explorer.

### The activity table

| Column             | What it shows                                                                                  |
| ------------------ | ---------------------------------------------------------------------------------------------- |
| Date               | When the event settled, in your local time zone.                                               |
| Batch              | The run this row belongs to, or a dash for standalone events like funding.                     |
| Contractor         | The recipient, resolved from your directory. Blank for funding rows.                           |
| Amount (your view) | The amount, read from your private ledger and decrypted on your device.                        |
| Type               | Payout, Withdrawal, or Funding.                                                                |
| Status             | The lifecycle state of the event (see the table below).                                        |
| Transaction        | The settlement hash, linking to the block explorer, labeled "settled, amount hidden on-chain." |

<Info>
  **Amount (your view)** is exactly that: the figure only you can see. It is decrypted in your
  browser with your confidential viewing key and never travels to Confiroll. Two different
  employers looking at the same public settlement see two different things, because each reads
  from a ledger only they can open.
</Info>

### Status values

| Status             | Meaning                                                                        |
| ------------------ | ------------------------------------------------------------------------------ |
| Settled            | The event confirmed on-chain and is final.                                     |
| Building proof     | Your browser is encrypting the amount and assembling the zero-knowledge proof. |
| Awaiting signature | The transfer is built and waiting for your wallet signature.                   |
| Submitting         | Signed and handed off for fee-sponsored submission.                            |
| Failed             | The event did not confirm. Nothing moved and you can retry from the run.       |

## Filters and search

The filter bar narrows the table without a page reload, and the summary strip retotals as you
filter, so what you export always matches what you see.

<CardGroup cols={2}>
  <Card title="Date range" icon="clock-rotate-left">
    Scope to a pay period, a quarter, or a custom start and end date.
  </Card>

  <Card title="Contractor" icon="user-plus">
    Focus on one recipient to answer a "was I paid?" question in seconds.
  </Card>

  <Card title="Batch" icon="layer-group">
    Pull up a single run and every row it produced.
  </Card>

  <Card title="Status" icon="list-check">
    Isolate Failed rows to retry, or Settled rows to reconcile.
  </Card>

  <Card title="Type" icon="filter">
    Separate payouts from withdrawals and funding events.
  </Card>

  <Card title="Search" icon="hashtag">
    Match on contractor name, batch label, or a transaction hash.
  </Card>
</CardGroup>

## Batch view

Switch to **Batch view** to collapse the table into one card per run. Each card shows the run
label, the date, the recipient headcount, a per-batch total in your view, and a roll-up status.
Expand a card to see the individual payout rows inside it, each with its own status and
explorer link.

| Batch status        | Meaning                                                                   |
| ------------------- | ------------------------------------------------------------------------- |
| Draft               | The run is saved but not started.                                         |
| Ready               | Every recipient is payable and the run is queued.                         |
| Running             | Proofs are building and transfers are submitting.                         |
| Completed           | Every payout in the run settled.                                          |
| Partially completed | Some payouts settled and some failed. Open the run to retry the failures. |
| Failed              | No payout in the run settled.                                             |

<Note>
  The per-batch total in Batch view is summed from your private ledger, the same source as the
  Amount column. It is your figure, decrypted on your device, and never leaves it.
</Note>

## Where the amounts come from

This is the part worth internalizing, because it explains why your record is both private and
verifiable at the same time.

<Steps>
  <Step title="On-chain confirms THAT a payout settled">
    A confidential transfer records that a payout happened and that it settled, and it exposes
    the settlement (who paid whom, and when) publicly. The amount is not a visible argument on
    the transaction, so the public explorer shows a successful settlement with the amount
    hidden.
  </Step>

  <Step title="Your private ledger holds WHAT">
    The mapping from a payout to its amount lives in your private ledger, kept encrypted on
    your side. Your browser decrypts it with your confidential viewing key. Confiroll is blind
    to it.
  </Step>

  <Step title="Together they are a complete record">
    The chain proves the settlement is real and final. Your ledger supplies the figure. Line
    them up and you have a full, reconcilable history that no third party could have forged and
    that stays confidential until you choose to disclose it.
  </Step>
</Steps>

## Open a settled payout on the explorer

Every settled row links out so you can confirm it against the public network yourself.

<Steps>
  <Step title="Find the row">
    Filter or search to the payout you want to inspect.
  </Step>

  <Step title="Click the transaction hash">
    The hash is labeled "settled, amount hidden on-chain." It opens the block explorer in a new
    tab.
  </Step>

  <Step title="Read the settlement">
    The explorer shows the confidential transfer as a successful operation. You will see the
    accounts involved and a fee account that is not yours, because the fee was sponsored and the
    payout cost you 0 XLM. You will not see the amount, because it is hidden on-chain.
  </Step>
</Steps>

## Export

Export the current view, filters and all, to hand off or archive.

<CardGroup cols={2}>
  <Card title="CSV" icon="table">
    A spreadsheet-ready file with every column, including the amount from your view and the
    transaction hash. Ideal for importing into accounting software.
  </Card>

  <Card title="PDF" icon="file-lines">
    A formatted statement of the filtered activity, suitable for sharing or filing.
  </Card>
</CardGroup>

<Info>
  An export carries the amounts from your view because you generate it while signed in with your
  viewing key active. Sharing that file shares those figures. To prove a single amount matches
  the on-chain ciphertext, use a verifiable disclosure instead. See
  [Compliance and disclosure](/guide/employer/compliance).
</Info>

## FAQ

<AccordionGroup>
  <Accordion title="Why does the amount come from my ledger instead of the blockchain?">
    Because the amount is hidden on-chain. A confidential transfer settles publicly but does not
    expose the figure, so there is nothing on the explorer to read. The amount lives in your
    private ledger, encrypted on your side and decryptable only by you with your confidential
    viewing key. Confiroll is blind to it, which is exactly why it stays private.
  </Accordion>

  <Accordion title="What can someone see if they open my payout on the explorer?">
    They see a successful confidential transfer: the settlement (which accounts were involved,
    and when) and a sponsored fee account that is not yours. The transaction graph is public.
    What they cannot see is the amount, which is hidden on-chain. This is confidentiality of the
    figure, not anonymity of the settlement.
  </Accordion>

  <Accordion title="How do I export activity for my accountant?">
    Filter the table to the period and types you need, then export to CSV for spreadsheet import
    or PDF for a formatted statement. The export matches your on-screen view exactly, including
    the amounts from your view and the explorer links, so your accountant can tie each line to a
    real, final on-chain settlement.
  </Accordion>
</AccordionGroup>
