A transaction valid at submission fails txBAD_SEQ at apply
Core applies a ledger's classic phase before its Soroban phase and re-checks the source account, sequence number, signatures and sequence-age preconditions at apply (TransactionFrame::commonValid;…
The shape
Core applies a ledger's classic phase before its Soroban phase and re-checks the source account, sequence number, signatures and sequence-age preconditions at apply (TransactionFrame::commonValid; OperationFrame::checkSignature with forApply). Here a classic transaction earlier in the same ledger bumps the source account's sequence number, so this Soroban transaction fails with txBAD_SEQ. Its fee is charged and its sequence number is not consumed (tx_changes_before is empty). Readers that assume txBAD_SEQ never reaches a ledger, or that every failed transaction consumed a sequence number, get this wrong.
Variants
| Variant | Protocol | Network | Source | Size | sha256 |
|---|---|---|---|---|---|
p30-mainnet-generated | P30 | mainnet passphrase | generated by stellar-core v30.0.0 | 17,236 B | dbc26aa0d752… |
p28-mainnet-generated | P28 | mainnet passphrase | generated by stellar-core v30.0.0 | 17,228 B | b464fb610c5d… |
p30-testnet-generated | P30 | testnet passphrase | generated by stellar-core v30.0.0 | 17,132 B | 93d7ae80867e… |
p28-testnet-generated | P28 | testnet passphrase | generated by stellar-core v30.0.0 | 17,124 B | e7e04e4b8cdf… |
What a correct reader returns
| A correct reader finds | Value | Backed by |
|---|---|---|
| The transaction fails with tx_bad_seq although it was valid when submitted. p30-mainnet-generated | tx_bad_seq | constructionsnapshotcorewalker |
| The transaction fails with tx_bad_seq although it was valid when submitted. p28-mainnet-generated | tx_bad_seq | constructionsnapshotcorewalker |
| The transaction fails with tx_bad_seq although it was valid when submitted. p30-testnet-generated | tx_bad_seq | constructionsnapshotcorewalker |
| The transaction fails with tx_bad_seq although it was valid when submitted. p28-testnet-generated | tx_bad_seq | constructionsnapshotcorewalker |
| The transaction that caused it is in the same ledger. p30-mainnet-generated | some change where 1 fields match | constructionsnapshotcorewalker |
| The transaction that caused it is in the same ledger. p28-mainnet-generated | some change where 1 fields match | constructionsnapshotcorewalker |
| The transaction that caused it is in the same ledger. p30-testnet-generated | some change where 1 fields match | constructionsnapshotcorewalker |
| The transaction that caused it is in the same ledger. p28-testnet-generated | some change where 1 fields match | constructionsnapshotcorewalker |
| The sequence number is not consumed: no change before apply. p30-mainnet-generated | length 0 | snapshot |
| The sequence number is not consumed: no change before apply. p28-mainnet-generated | length 0 | snapshot |
| The sequence number is not consumed: no change before apply. p30-testnet-generated | length 0 | snapshot |
| The sequence number is not consumed: no change before apply. p28-testnet-generated | length 0 | snapshot |
| No operation was applied: the operation meta is empty. p30-mainnet-generated | length 0 | snapshot |
| No operation was applied: the operation meta is empty. p28-mainnet-generated | length 0 | snapshot |
| No operation was applied: the operation meta is empty. p30-testnet-generated | length 0 | snapshot |
| No operation was applied: the operation meta is empty. p28-testnet-generated | length 0 | snapshot |
| The transaction source is the account changed earlier in the ledger. p30-mainnet-generated | GB2MOCV255LGEXDFE7JCHYHHWOWZC7RN3HXOHJYCXJRQXJDF6MSR63MF | constructionsnapshotcorewalker |
| The transaction source is the account changed earlier in the ledger. p28-mainnet-generated | GB2MOCV255LGEXDFE7JCHYHHWOWZC7RN3HXOHJYCXJRQXJDF6MSR63MF | constructionsnapshotcorewalker |
| The transaction source is the account changed earlier in the ledger. p30-testnet-generated | GB2MOCV255LGEXDFE7JCHYHHWOWZC7RN3HXOHJYCXJRQXJDF6MSR63MF | constructionsnapshotcorewalker |
| The transaction source is the account changed earlier in the ledger. p28-testnet-generated | GB2MOCV255LGEXDFE7JCHYHHWOWZC7RN3HXOHJYCXJRQXJDF6MSR63MF | constructionsnapshotcorewalker |
| The unused resource fee is refunded after apply (two changes on the fee source). p30-mainnet-generated | length 2 | snapshot |
| The unused resource fee is refunded after apply (two changes on the fee source). p28-mainnet-generated | length 2 | snapshot |
| The unused resource fee is refunded after apply (two changes on the fee source). p30-testnet-generated | length 2 | snapshot |
| The unused resource fee is refunded after apply (two changes on the fee source). p28-testnet-generated | length 2 | snapshot |
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 walkerEntry id tx.apply-time.bad-seq · compiled from catalog/tx.apply-time.bad-seq.json · entry.json
A transaction with minSeqLedgerGap fails at apply after a bump-to-0 in the same ledger
Core applies a ledger's classic phase before its Soroban phase and re-checks the source account, sequence number, signatures and sequence-age preconditions at apply (TransactionFrame::commonValid;…
A Soroban transaction fails txNO_ACCOUNT at apply and its fee is never refunded
Core applies a ledger's classic phase before its Soroban phase and re-checks the source account, sequence number, signatures and sequence-age preconditions at apply (TransactionFrame::commonValid;…