02Sheet 02.03.185 · Entries

PAYMENT fails with PAYMENT_UNDERFUNDED although the balance covers it: selling liabilities reserve it

A transaction whose PAYMENT operation fails at apply is still written into the closed ledger: its fee is charged, its sequence number is consumed, and none of its operations change state.

FIG. · Where it sits · inside LedgerCloseMetapre-cap · CAP-0003 · H-C1 · H-C17
OperationResult.payment.underfunded in a closed ledger
PAYMENT_UNDERFUNDED with balance 100 > amount 41: 60 of it is selling liabilities

The shape

A transaction whose PAYMENT operation fails at apply is still written into the closed ledger: its fee is charged, its sequence number is consumed, and none of its operations change state. The result carries the operation's result code (underfunded). Readers that skip failed transactions lose the fee and sequence change; readers that assume a failed transaction changed something record effects that never happened. The account holds 100 XPF but has an offer selling 60, so only 40 is available: a payment of 41 fails although the balance covers it.

Variants

VariantProtocolNetworkSourceSizesha256
p30-mainnet-generatedP30mainnet passphrasegenerated by stellar-core v30.0.02,908 B1fe54eff6d73…
p30-testnet-generatedP30testnet passphrasegenerated by stellar-core v30.0.02,908 Bb2019fd2bf58…

What a correct reader returns

A correct reader findsValueBacked by
The operation fails with underfunded.underfundedconstructionsnapshotcorewalker
No operation changed state: the operation meta is empty.length 0snapshot
The sequence number is still consumed: the source account changes before apply (state, updated).length 2snapshot
The fee is still charged: the fee source changes in fee processing.length 2snapshot

Check it yourself

make verify   # schema, hashes, the byte-for-byte round trip and every fact above
make oracle   # the facts' values, re-read by stellar-core and the schema walker

Entry id failure.payment.underfunded-by-selling-liabilities · compiled from catalog/failure.payment.underfunded-by-selling-liabilities.json · entry.json

On this page