Compound Transaction

Overview

Meaning and scope

A compound transaction is a transaction that performs several logically connected actions, often across multiple contracts, assets, or account updates, to produce one broader business outcome. The term is descriptive rather than a universal protocol type. A compound transaction may be atomic, batched, nested, or partially tolerant of failure.

Mechanism and operation

Compound transactions arise when one user intent requires more than a simple transfer. A decentralized exchange action can approve a token, swap assets, pay a fee, and deposit the result. A merchant payout can split value among several recipients and update accounting records. These actions may be encoded as one Contract Transaction that triggers internal calls, as several instructions in one transaction, or as a coordinated sequence across separate transactions. A batch groups multiple operations for execution efficiency, while a compound transaction describes a combined outcome whose components depend on one another. A batch can contain unrelated transfers, and a compound workflow can span more than one transaction.

Practical payment example

An application bundles an authorization and a value transfer into one logical transaction where supported. The backend records partial internal execution outcomes instead of assuming every included operation had an independent successful payment.

Operational checks

Documentation should avoid using the labels interchangeably unless the implementation truly provides the same atomicity and failure behavior. Each external contract, token, oracle, approval, and callback adds a trust or failure boundary. Transaction ordering, slippage, reentrancy, allowance changes, and intermediate balances can affect the final result.

Distinctions and limits

The term overlaps with Batch Transaction, but the emphasis is different. A top-level success status may not reveal whether every expected transfer occurred, particularly when a contract catches errors or uses optional branches.

Related reading

Related definitions: Contract Transaction, transaction.