Skip to main content

Transaction History

This guide covers querying and filtering transaction history in the Privacy Boost TypeScript SDK.

Basic Usage

Transaction Type

status is the raw lifecycle position; phase is the consumer-facing derivation you should branch on for UI and chained actions. See Transaction Lifecycle for the full state machine and the meaning of each value.

Filtering History

By Transaction Type

By Token

With Limit

Combined Filters

Filter Parameters

UI Example

Error Handling

Best Practices

1. Paginate Results

2. Refresh After Operations

3. Poll for Pending Transactions

Use the SDK’s built-in poller so you observe state transitions (including preconfirmed) in the local store instead of re-fetching history on a timer:
resolved only contains terminal transitions (completed / failed); a preconfirmed transaction stays in pending until it settles. See Transaction Lifecycle for the full state machine and recommended UX patterns.

Next Steps