Skip to main content

Batch Operations

A batch is a set of transactions that the wallet engine treats as one logical unit. They share a tx_group identifier; the wallet transaction core either commits all of them or rolls all of them back. Partial settlement is never possible.

This concept underpins:

  • Order matching — each match creates a paired ExchangeToBroker + ExchangeFromBroker (or SwapToBroker + SwapFromBroker) inside the same group.
  • Cross-project transfers — outgoing and incoming legs share the group.
  • Bulk inter-module operations through the private execute_transactions endpoint.

For the wire-level contract (single endpoint, payload shape, where tx_group lives, who is allowed to call it) refer to:

→ Batch Operations process — the private inter-module endpoint.

Related: Atomicity, Error Handling, Transactions.