What Is Atomic Transaction?

Definition

An atomic transaction is a transaction or grouped operation that either completes all required state changes successfully or applies none of them.

Overview

Contents Hide

Context and purpose
How it works
Practical checks and failure points
Related concepts

Context and purpose

If a transaction transfers two assets, updates a contract, and records a result, the system should not leave only some of those changes committed when a required step fails. Within one smart-contract transaction, atomicity is often provided by the execution environment: an error or explicit revert rolls back state changes, while fees may still be charged. This makes decentralized exchanges, liquidations, and multi-step contract calls possible without exposing intermediate states. Atomicity across separate transactions, chains, or external systems is harder. Cross-chain swaps may use hash time-locked contracts, escrow, or coordinated protocols, but they still face different finality, timeout, and liveness assumptions. A database record and a blockchain transfer also cannot be made perfectly atomic without a reconciliation and compensation design. A single on-chain transfer may be atomic at the protocol level, while the overall process of payment, order fulfillment, conversion, and withdrawal spans multiple systems and is not one atomic transaction.

How it works

An atomic transaction is an operation that either commits all of its defined state changes or commits none, within the scope of the underlying system. Cross-chain transfers and external payouts rarely share one atomic database boundary.

Practical checks and failure points

Define the actual boundary, commit points and compensating actions for external side effects.

Cross-Chain Replay Protection · Bridge Finality

Example

A ledger updates both sides of an internal transfer together, so a crash cannot leave only one posted entry. That does not make an external blockchain payout immediately atomic with the ledger.

Comparison

Atomicity refers to indivisible state change, not necessarily instant completion or irreversibility.

Key Takeaway