Class TransactionService

Read-only query services to fetch normalized transactions across all products

If you need more info about a transaction, fetch it using its specific service. Transaction Service will remain generic and high-level.

Index

Constructors

constructor

Methods

aggregateTotalsByMethod getBaseQuery invalidateTag search searchEntityIds searchPaymentInstrumentIds

Constructors

constructor

new TransactionService(
args: { db: B2bDatabase; valkeyClient: ValkeyClient | null },
): TransactionService
Parameters
- args: { db: B2bDatabase; valkeyClient: ValkeyClient | null }
Returns TransactionService
- Defined in packages/transaction-services/src/TransactionService.ts:480

Methods

aggregateTotalsByMethod

aggregateTotalsByMethod(
    args: {
        createdAt?: DbTimestampCriteria;
        customerId: string;
        methods?: (
            | "DEPOSIT_BLOCKCHAIN"
            | "DEPOSIT_DIRECT"
            | "DEPOSIT_US_BANK_ACH"
            | "DEPOSIT_ACH_CREDIT"
            | "DEPOSIT_RTP"
            | "DEPOSIT_US_CASH"
            | "DEPOSIT_US_WIRE"
            | "DEPOSIT_SWIFT_WIRE"
            | "REDEMPTION"
            | "SWAP"
            | "FEE_TRANSFER"
            | "TRANSFER"
            | "TRANSFER_NETWORK"
            | "WITHDRAW_AF_BANK"
            | "WITHDRAW_AF_MOMO"
            | "WITHDRAW_MX_SPEI"
            | "WITHDRAW_SWIFT_WIRE"
            | "WITHDRAW_US_BANK_ACH"
            | "WITHDRAW_US_INSTANT"
            | "WITHDRAW_ACH_PULL"
            | "WITHDRAW_US_WIRE_DRAWDOWN"
            | "WITHDRAW_US_WIRE"
            | "WITHDRAW_BLOCKCHAIN"
            | "VIRTUAL_CARD"
            | "PHYSICAL_CARD"
            | "ESCROW_TRANSFER"
            | "REWARD"
        )[];
        statuses?: ("PROCESSING" | "COMPLETED" | "FAILED" | "RETURNED")[];
        subtypes?: ("RETURN" | "FEE" | "CLEARING" | undefined)[] | null;
    },
): Promise<
    {
        ok: true;
        value: {
            items: {
                method: | "DEPOSIT_BLOCKCHAIN"
                | "DEPOSIT_DIRECT"
                | "DEPOSIT_US_BANK_ACH"
                | "DEPOSIT_ACH_CREDIT"
                | "DEPOSIT_RTP"
                | "DEPOSIT_US_CASH"
                | "DEPOSIT_US_WIRE"
                | "DEPOSIT_SWIFT_WIRE"
                | "REDEMPTION"
                | "SWAP"
                | "FEE_TRANSFER"
                | "TRANSFER"
                | "TRANSFER_NETWORK"
                | "WITHDRAW_AF_BANK"
                | "WITHDRAW_AF_MOMO"
                | "WITHDRAW_MX_SPEI"
                | "WITHDRAW_SWIFT_WIRE"
                | "WITHDRAW_US_BANK_ACH"
                | "WITHDRAW_US_INSTANT"
                | "WITHDRAW_ACH_PULL"
                | "WITHDRAW_US_WIRE_DRAWDOWN"
                | "WITHDRAW_US_WIRE"
                | "WITHDRAW_BLOCKCHAIN"
                | "VIRTUAL_CARD"
                | "PHYSICAL_CARD"
                | "ESCROW_TRANSFER"
                | "REWARD";
                status: "PROCESSING"
                | "COMPLETED"
                | "FAILED"
                | "RETURNED";
                total: BigNumber;
                type: "CREDIT" | "DEBIT";
            }[];
        };
    },
>
Aggregate transaction totals grouped by (method, type, status).

Single GROUP BY query against the same UNION used by search, but skips the outer entity / ledger / solana enrichment — aggregation only needs (method, type, status, amount). Use this instead of paging through search when you only need bucketed sums (e.g. the home-page money- movement widget).
Parameters
- args: {
      createdAt?: DbTimestampCriteria;
      customerId: string;
      methods?: (
          | "DEPOSIT_BLOCKCHAIN"
          | "DEPOSIT_DIRECT"
          | "DEPOSIT_US_BANK_ACH"
          | "DEPOSIT_ACH_CREDIT"
          | "DEPOSIT_RTP"
          | "DEPOSIT_US_CASH"
          | "DEPOSIT_US_WIRE"
          | "DEPOSIT_SWIFT_WIRE"
          | "REDEMPTION"
          | "SWAP"
          | "FEE_TRANSFER"
          | "TRANSFER"
          | "TRANSFER_NETWORK"
          | "WITHDRAW_AF_BANK"
          | "WITHDRAW_AF_MOMO"
          | "WITHDRAW_MX_SPEI"
          | "WITHDRAW_SWIFT_WIRE"
          | "WITHDRAW_US_BANK_ACH"
          | "WITHDRAW_US_INSTANT"
          | "WITHDRAW_ACH_PULL"
          | "WITHDRAW_US_WIRE_DRAWDOWN"
          | "WITHDRAW_US_WIRE"
          | "WITHDRAW_BLOCKCHAIN"
          | "VIRTUAL_CARD"
          | "PHYSICAL_CARD"
          | "ESCROW_TRANSFER"
          | "REWARD"
      )[];
      statuses?: ("PROCESSING" | "COMPLETED" | "FAILED" | "RETURNED")[];
      subtypes?: ("RETURN" | "FEE" | "CLEARING" | undefined)[] | null;
  }
  - OptionalcreatedAt?: DbTimestampCriteria
  - customerId: string
  - Optionalmethods?: (
        | "DEPOSIT_BLOCKCHAIN"
        | "DEPOSIT_DIRECT"
        | "DEPOSIT_US_BANK_ACH"
        | "DEPOSIT_ACH_CREDIT"
        | "DEPOSIT_RTP"
        | "DEPOSIT_US_CASH"
        | "DEPOSIT_US_WIRE"
        | "DEPOSIT_SWIFT_WIRE"
        | "REDEMPTION"
        | "SWAP"
        | "FEE_TRANSFER"
        | "TRANSFER"
        | "TRANSFER_NETWORK"
        | "WITHDRAW_AF_BANK"
        | "WITHDRAW_AF_MOMO"
        | "WITHDRAW_MX_SPEI"
        | "WITHDRAW_SWIFT_WIRE"
        | "WITHDRAW_US_BANK_ACH"
        | "WITHDRAW_US_INSTANT"
        | "WITHDRAW_ACH_PULL"
        | "WITHDRAW_US_WIRE_DRAWDOWN"
        | "WITHDRAW_US_WIRE"
        | "WITHDRAW_BLOCKCHAIN"
        | "VIRTUAL_CARD"
        | "PHYSICAL_CARD"
        | "ESCROW_TRANSFER"
        | "REWARD"
    )[]
  - Optionalstatuses?: ("PROCESSING" | "COMPLETED" | "FAILED" | "RETURNED")[]
  - Optionalsubtypes?: ("RETURN" | "FEE" | "CLEARING" | undefined)[] | null
    
    Pass values to include only those subtypes; pass null to exclude transactions with a subtype
Returns Promise<
    {
        ok: true;
        value: {
            items: {
                method: | "DEPOSIT_BLOCKCHAIN"
                | "DEPOSIT_DIRECT"
                | "DEPOSIT_US_BANK_ACH"
                | "DEPOSIT_ACH_CREDIT"
                | "DEPOSIT_RTP"
                | "DEPOSIT_US_CASH"
                | "DEPOSIT_US_WIRE"
                | "DEPOSIT_SWIFT_WIRE"
                | "REDEMPTION"
                | "SWAP"
                | "FEE_TRANSFER"
                | "TRANSFER"
                | "TRANSFER_NETWORK"
                | "WITHDRAW_AF_BANK"
                | "WITHDRAW_AF_MOMO"
                | "WITHDRAW_MX_SPEI"
                | "WITHDRAW_SWIFT_WIRE"
                | "WITHDRAW_US_BANK_ACH"
                | "WITHDRAW_US_INSTANT"
                | "WITHDRAW_ACH_PULL"
                | "WITHDRAW_US_WIRE_DRAWDOWN"
                | "WITHDRAW_US_WIRE"
                | "WITHDRAW_BLOCKCHAIN"
                | "VIRTUAL_CARD"
                | "PHYSICAL_CARD"
                | "ESCROW_TRANSFER"
                | "REWARD";
                status: "PROCESSING"
                | "COMPLETED"
                | "FAILED"
                | "RETURNED";
                total: BigNumber;
                type: "CREDIT" | "DEBIT";
            }[];
        };
    },
>
- Defined in packages/transaction-services/src/TransactionService.ts:718

getBaseQuery

getBaseQuery(
__namedParameters: { customerId: string },
): Promise<{ params: unknown[]; sql: string }>
Returns the base UNION query (all selects enabled, scoped to the given customer) as an inlined SQL string. Useful for debugging prod issues against a specific customer.
Parameters
- __namedParameters: { customerId: string }
Returns Promise<{ params: unknown[]; sql: string }>
- Defined in packages/transaction-services/src/TransactionService.ts:514

invalidateTag

invalidateTag(__namedParameters: { customerId: string }): Promise<void>
Bust both transaction caches for a customer. Public seam for in-process readers/writers (e.g. the dashboard's transfer server action) and the cross-service TransactionCacheBuster. Tags are the external string customerId — the same value search / aggregateTotalsByMethod write.
Parameters
- __namedParameters: { customerId: string }
Returns Promise<void>
- Defined in packages/transaction-services/src/TransactionService.ts:502

search

search(
    args: {
        amount?: { operator: "EQ" | "LTE" | "GTE"; value: BigNumber };
        bankIds?: (string | undefined)[];
        bankTransactionIds?: (string | undefined)[];
        cardIds?: string[];
        createdAt?: DbTimestampCriteria;
        customerId: string;
        entityIds?: string[];
        entityTypes?: NonNullable<"IDENTITY" | "ORGANIZATION" | null>[];
        ids?: string[];
        keys?: string[];
        methods?: (
            | "DEPOSIT_BLOCKCHAIN"
            | "DEPOSIT_DIRECT"
            | "DEPOSIT_US_BANK_ACH"
            | "DEPOSIT_ACH_CREDIT"
            | "DEPOSIT_RTP"
            | "DEPOSIT_US_CASH"
            | "DEPOSIT_US_WIRE"
            | "DEPOSIT_SWIFT_WIRE"
            | "REDEMPTION"
            | "SWAP"
            | "FEE_TRANSFER"
            | "TRANSFER"
            | "TRANSFER_NETWORK"
            | "WITHDRAW_AF_BANK"
            | "WITHDRAW_AF_MOMO"
            | "WITHDRAW_MX_SPEI"
            | "WITHDRAW_SWIFT_WIRE"
            | "WITHDRAW_US_BANK_ACH"
            | "WITHDRAW_US_INSTANT"
            | "WITHDRAW_ACH_PULL"
            | "WITHDRAW_US_WIRE_DRAWDOWN"
            | "WITHDRAW_US_WIRE"
            | "WITHDRAW_BLOCKCHAIN"
            | "VIRTUAL_CARD"
            | "PHYSICAL_CARD"
            | "ESCROW_TRANSFER"
            | "REWARD"
        )[];
        orderBy?: TransactionOrderBy[];
        page?: number;
        pageSize?: number;
        paymentInstrumentIds?: (string | undefined)[];
        query?: string;
        signatures?: string[];
        statuses?: ("PROCESSING" | "COMPLETED" | "FAILED" | "RETURNED")[];
        subtypes?: ("RETURN" | "FEE" | "CLEARING" | undefined)[] | null;
        types?: ("CREDIT" | "DEBIT")[];
        updatedAt?: DbTimestampCriteria;
        walletAddresses?: (Address | null)[];
        window?: { after?: number; before?: number; key: string };
    },
): Promise<
    {
        ok: true;
        value: { hasNext: boolean; items: Transaction[]; total: number };
    },
>
Parameters
- args: {
      amount?: { operator: "EQ" | "LTE" | "GTE"; value: BigNumber };
      bankIds?: (string | undefined)[];
      bankTransactionIds?: (string | undefined)[];
      cardIds?: string[];
      createdAt?: DbTimestampCriteria;
      customerId: string;
      entityIds?: string[];
      entityTypes?: NonNullable<"IDENTITY" | "ORGANIZATION" | null>[];
      ids?: string[];
      keys?: string[];
      methods?: (
          | "DEPOSIT_BLOCKCHAIN"
          | "DEPOSIT_DIRECT"
          | "DEPOSIT_US_BANK_ACH"
          | "DEPOSIT_ACH_CREDIT"
          | "DEPOSIT_RTP"
          | "DEPOSIT_US_CASH"
          | "DEPOSIT_US_WIRE"
          | "DEPOSIT_SWIFT_WIRE"
          | "REDEMPTION"
          | "SWAP"
          | "FEE_TRANSFER"
          | "TRANSFER"
          | "TRANSFER_NETWORK"
          | "WITHDRAW_AF_BANK"
          | "WITHDRAW_AF_MOMO"
          | "WITHDRAW_MX_SPEI"
          | "WITHDRAW_SWIFT_WIRE"
          | "WITHDRAW_US_BANK_ACH"
          | "WITHDRAW_US_INSTANT"
          | "WITHDRAW_ACH_PULL"
          | "WITHDRAW_US_WIRE_DRAWDOWN"
          | "WITHDRAW_US_WIRE"
          | "WITHDRAW_BLOCKCHAIN"
          | "VIRTUAL_CARD"
          | "PHYSICAL_CARD"
          | "ESCROW_TRANSFER"
          | "REWARD"
      )[];
      orderBy?: TransactionOrderBy[];
      page?: number;
      pageSize?: number;
      paymentInstrumentIds?: (string | undefined)[];
      query?: string;
      signatures?: string[];
      statuses?: ("PROCESSING" | "COMPLETED" | "FAILED" | "RETURNED")[];
      subtypes?: ("RETURN" | "FEE" | "CLEARING" | undefined)[] | null;
      types?: ("CREDIT" | "DEBIT")[];
      updatedAt?: DbTimestampCriteria;
      walletAddresses?: (Address | null)[];
      window?: { after?: number; before?: number; key: string };
  }
  - Optionalamount?: { operator: "EQ" | "LTE" | "GTE"; value: BigNumber }
  - OptionalbankIds?: (string | undefined)[]
  - OptionalbankTransactionIds?: (string | undefined)[]
  - OptionalcardIds?: string[]
  - OptionalcreatedAt?: DbTimestampCriteria
  - customerId: string
  - OptionalentityIds?: string[]
  - OptionalentityTypes?: NonNullable<"IDENTITY" | "ORGANIZATION" | null>[]
  - Optionalids?: string[]
  - Optionalkeys?: string[]
    
    Filter by the computed unique-identity Transaction.key (id-type-subType). Matches raw_rows.key. Kept in lockstep with TransactionAdminSearchArgs.keys.
  - Optionalmethods?: (
        | "DEPOSIT_BLOCKCHAIN"
        | "DEPOSIT_DIRECT"
        | "DEPOSIT_US_BANK_ACH"
        | "DEPOSIT_ACH_CREDIT"
        | "DEPOSIT_RTP"
        | "DEPOSIT_US_CASH"
        | "DEPOSIT_US_WIRE"
        | "DEPOSIT_SWIFT_WIRE"
        | "REDEMPTION"
        | "SWAP"
        | "FEE_TRANSFER"
        | "TRANSFER"
        | "TRANSFER_NETWORK"
        | "WITHDRAW_AF_BANK"
        | "WITHDRAW_AF_MOMO"
        | "WITHDRAW_MX_SPEI"
        | "WITHDRAW_SWIFT_WIRE"
        | "WITHDRAW_US_BANK_ACH"
        | "WITHDRAW_US_INSTANT"
        | "WITHDRAW_ACH_PULL"
        | "WITHDRAW_US_WIRE_DRAWDOWN"
        | "WITHDRAW_US_WIRE"
        | "WITHDRAW_BLOCKCHAIN"
        | "VIRTUAL_CARD"
        | "PHYSICAL_CARD"
        | "ESCROW_TRANSFER"
        | "REWARD"
    )[]
  - OptionalorderBy?: TransactionOrderBy[]
    
    Defaults to createdAt DESC
  - Optionalpage?: number
    
    Defaults to 1
  - OptionalpageSize?: number
    
    Defaults to 10
  - OptionalpaymentInstrumentIds?: (string | undefined)[]
  - Optionalquery?: string
    
    Unified free-text search: case-insensitive substring match across transaction id, signature, bank transaction id, payment instrument id, card id, customer id/name, entity id/name/email, organization id, wallet address, account name/id, counterparty name, description, and other-wallet fields. Whitespace-only values are a no-op.
  - Optionalsignatures?: string[]
  - Optionalstatuses?: ("PROCESSING" | "COMPLETED" | "FAILED" | "RETURNED")[]
  - Optionalsubtypes?: ("RETURN" | "FEE" | "CLEARING" | undefined)[] | null
    
    Pass values to include only those subtypes; pass null to exclude transactions with a subtype
  - Optionaltypes?: ("CREDIT" | "DEBIT")[]
  - OptionalupdatedAt?: DbTimestampCriteria
  - OptionalwalletAddresses?: (Address | null)[]
  - Optionalwindow?: { after?: number; before?: number; key: string }
    
    Cursor window around a specific row. When set, SUPERSEDES page/ pageSize and returns the contiguous slice of THIS query's result set (same filters/conditions AND same orderBy): before rows preceding the anchor + the anchor row + after rows following it. The anchor is the row whose computed Transaction.key equals window.key. Works for any orderBy (a key DESC tiebreak makes the order total). Unknown key → empty result. hasNext is always false on the window path. before/after default to 10.
Returns Promise<
    {
        ok: true;
        value: { hasNext: boolean; items: Transaction[]; total: number };
    },
>
- Defined in packages/transaction-services/src/TransactionService.ts:535

searchEntityIds

searchEntityIds(
    __namedParameters: {
        createdAt?: DbTimestampCriteria;
        customerId: string;
        entityType?: NonNullable<"IDENTITY" | "ORGANIZATION" | null>;
        limit?: number;
    },
): Promise<{ ok: true; value: { entityIds: string[] } }>
Entity external ids the customer has transacted with, ordered by recency (most recently transacted first). Mirrors the uncached TransactionAdminService.searchEntities but scopes to a single customerId, optionally filters by entityType, and ranks distinct entities by MAX(created_at) instead of returning an unordered DISTINCT set.

No caching (mirrors the admin method).
Parameters
- __namedParameters: {
      createdAt?: DbTimestampCriteria;
      customerId: string;
      entityType?: NonNullable<"IDENTITY" | "ORGANIZATION" | null>;
      limit?: number;
  }
Returns Promise<{ ok: true; value: { entityIds: string[] } }>
- Defined in packages/transaction-services/src/TransactionService.ts:899

searchPaymentInstrumentIds

searchPaymentInstrumentIds(
    __namedParameters: {
        createdAt?: DbTimestampCriteria;
        customerId: string;
        limit?: number;
        methods?: (
            | "DEPOSIT_BLOCKCHAIN"
            | "DEPOSIT_DIRECT"
            | "DEPOSIT_US_BANK_ACH"
            | "DEPOSIT_ACH_CREDIT"
            | "DEPOSIT_RTP"
            | "DEPOSIT_US_CASH"
            | "DEPOSIT_US_WIRE"
            | "DEPOSIT_SWIFT_WIRE"
            | "REDEMPTION"
            | "SWAP"
            | "FEE_TRANSFER"
            | "TRANSFER"
            | "TRANSFER_NETWORK"
            | "WITHDRAW_AF_BANK"
            | "WITHDRAW_AF_MOMO"
            | "WITHDRAW_MX_SPEI"
            | "WITHDRAW_SWIFT_WIRE"
            | "WITHDRAW_US_BANK_ACH"
            | "WITHDRAW_US_INSTANT"
            | "WITHDRAW_ACH_PULL"
            | "WITHDRAW_US_WIRE_DRAWDOWN"
            | "WITHDRAW_US_WIRE"
            | "WITHDRAW_BLOCKCHAIN"
            | "VIRTUAL_CARD"
            | "PHYSICAL_CARD"
            | "ESCROW_TRANSFER"
            | "REWARD"
        )[];
    },
): Promise<{ ok: true; value: { paymentInstrumentIds: string[] } }>
Payment-instrument external ids the customer has transacted with, ranked by usage (most-used first). Mirrors the uncached TransactionAdminService.searchPaymentInstrumentIds but scopes to a single customerId and ranks by COUNT(*) instead of returning a flat DISTINCT set. Skips the outer entity / ledger / solana enrichment — ranking only needs (payment_instrument_id, method, created_at).

No caching (mirrors the admin method).
Parameters
- __namedParameters: {
      createdAt?: DbTimestampCriteria;
      customerId: string;
      limit?: number;
      methods?: (
          | "DEPOSIT_BLOCKCHAIN"
          | "DEPOSIT_DIRECT"
          | "DEPOSIT_US_BANK_ACH"
          | "DEPOSIT_ACH_CREDIT"
          | "DEPOSIT_RTP"
          | "DEPOSIT_US_CASH"
          | "DEPOSIT_US_WIRE"
          | "DEPOSIT_SWIFT_WIRE"
          | "REDEMPTION"
          | "SWAP"
          | "FEE_TRANSFER"
          | "TRANSFER"
          | "TRANSFER_NETWORK"
          | "WITHDRAW_AF_BANK"
          | "WITHDRAW_AF_MOMO"
          | "WITHDRAW_MX_SPEI"
          | "WITHDRAW_SWIFT_WIRE"
          | "WITHDRAW_US_BANK_ACH"
          | "WITHDRAW_US_INSTANT"
          | "WITHDRAW_ACH_PULL"
          | "WITHDRAW_US_WIRE_DRAWDOWN"
          | "WITHDRAW_US_WIRE"
          | "WITHDRAW_BLOCKCHAIN"
          | "VIRTUAL_CARD"
          | "PHYSICAL_CARD"
          | "ESCROW_TRANSFER"
          | "REWARD"
      )[];
  }
Returns Promise<{ ok: true; value: { paymentInstrumentIds: string[] } }>
- Defined in packages/transaction-services/src/TransactionService.ts:838

Class TransactionService

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns TransactionService

Methods

aggregateTotalsByMethod

Parameters

OptionalcreatedAt?: DbTimestampCriteria

customerId: string

Optionalstatuses?: ("PROCESSING" | "COMPLETED" | "FAILED" | "RETURNED")[]

Optionalsubtypes?: ("RETURN" | "FEE" | "CLEARING" | undefined)[] | null

getBaseQuery

Parameters

Returns Promise<{ params: unknown[]; sql: string }>

invalidateTag

Parameters

Returns Promise<void>

search

Parameters

Optionalamount?: { operator: "EQ" | "LTE" | "GTE"; value: BigNumber }

OptionalbankIds?: (string | undefined)[]

OptionalbankTransactionIds?: (string | undefined)[]

OptionalcardIds?: string[]

OptionalcreatedAt?: DbTimestampCriteria

customerId: string

OptionalentityIds?: string[]

OptionalentityTypes?: NonNullable<"IDENTITY" | "ORGANIZATION" | null>[]

Optionalids?: string[]

Optionalkeys?: string[]

OptionalorderBy?: TransactionOrderBy[]

Optionalpage?: number

OptionalpageSize?: number

OptionalpaymentInstrumentIds?: (string | undefined)[]

Optionalquery?: string

Optionalsignatures?: string[]

Optionalstatuses?: ("PROCESSING" | "COMPLETED" | "FAILED" | "RETURNED")[]

Optionalsubtypes?: ("RETURN" | "FEE" | "CLEARING" | undefined)[] | null

Optionaltypes?: ("CREDIT" | "DEBIT")[]

OptionalupdatedAt?: DbTimestampCriteria

OptionalwalletAddresses?: (Address | null)[]

Optionalwindow?: { after?: number; before?: number; key: string }

Returns Promise< { ok: true; value: { hasNext: boolean; items: Transaction[]; total: number }; },>

searchEntityIds

Parameters

Returns Promise<{ ok: true; value: { entityIds: string[] } }>

searchPaymentInstrumentIds

Parameters

Returns Promise<{ ok: true; value: { paymentInstrumentIds: string[] } }>

Settings

On This Page

`Optional`createdAt?: DbTimestampCriteria

`Optional`statuses?: ("PROCESSING" | "COMPLETED" | "FAILED" | "RETURNED")[]

`Optional`subtypes?: ("RETURN" | "FEE" | "CLEARING" | undefined)[] | null

`Optional`amount?: { operator: "EQ" | "LTE" | "GTE"; value: BigNumber }

`Optional`bankIds?: (string | undefined)[]

`Optional`bankTransactionIds?: (string | undefined)[]

`Optional`cardIds?: string[]

`Optional`createdAt?: DbTimestampCriteria

`Optional`entityIds?: string[]

`Optional`entityTypes?: NonNullable<"IDENTITY" | "ORGANIZATION" | null>[]

`Optional`ids?: string[]

`Optional`keys?: string[]

`Optional`orderBy?: TransactionOrderBy[]

`Optional`page?: number

`Optional`pageSize?: number

`Optional`paymentInstrumentIds?: (string | undefined)[]

`Optional`query?: string

`Optional`signatures?: string[]

`Optional`statuses?: ("PROCESSING" | "COMPLETED" | "FAILED" | "RETURNED")[]

`Optional`subtypes?: ("RETURN" | "FEE" | "CLEARING" | undefined)[] | null

`Optional`types?: ("CREDIT" | "DEBIT")[]

`Optional`updatedAt?: DbTimestampCriteria

`Optional`walletAddresses?: (Address | null)[]

`Optional`window?: { after?: number; before?: number; key: string }

Returns Promise<
{
ok: true;
value: { hasNext: boolean; items: Transaction[]; total: number };
},
>