<!-- Question: How does a transaction reach finality? -->
<!-- Source: https://docs.paxeer.app/a/transaction-finality (reviewed answer, corpus 837d42000759) -->

# From submission to a committed block

A transaction is final once the block covering its execution receipt is committed. Before that it passes through two earlier stages, and `pax_sequencerReceipt` reports which one it has reached.

**Transaction progress on one network**

- Submitted → Receipted (kernel executes)
- Receipted → Committed (validators commit)

**What each rung lets you decide**

| Rung | Required evidence | Application decision |
| --- | --- | --- |
| `submitted` | Transaction hash and nonce without a receipt | Track the existing submission. |
| `receipted` | Signed execution receipt and consistent decoded fields | Inspect success or failure and the recorded effects. |
| `committed` | Receipt covered by a committed block | Treat the verified outcome as final. |

**`pax_sequencerReceipt`** — hosted gateway

| Parameter | Required | Schema | Description |
| --- | --- | --- | --- |
| `txHash` | yes | `{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"}` |  |

Result: `{"oneOf":[{"type":"null"},{"type":"object","required":["rung","txHash","nonce"],"properties":{"rung":{"enum":["submitted","receipted","committed"]},"txHash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"nonce":{"type":"string","pattern":"^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"},"seq":{"type":"string","pattern":"^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"},"height":{"type":"string","pattern":"^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"},"index":{"type":"string","pattern":"^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"},"timestamp":{"type":"string","pattern":"^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"},"status":{"type":"string","enum":["0x0","0x1"]},"returnData":{"type":"string","pattern":"^0x([0-9a-fA-F]{2})*$"},"logs":{"type":"array","items":{"type":"object","required":["address","topics","data","logIndex"],"properties":{"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"topics":{"type":"array","items":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"maxItems":4},"data":{"type":"string","pattern":"^0x([0-9a-fA-F]{2})*$"},"logIndex":{"type":"string","pattern":"^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"}}}},"gasUsed":{"type":"string","pattern":"^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"},"cumulativeGasUsed":{"type":"string","pattern":"^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"},"effectiveGasPrice":{"type":"string","pattern":"^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"},"feeDenom":{"type":"string"},"feeAmount":{"type":"string","pattern":"^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"},"sponsor":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"from":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"to":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"contractAddress":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"vmError":{"type":"string"},"keyId":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"signingKey":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"receipt":{"type":"string","pattern":"^0x([0-9a-fA-F]{2})*$"},"blockNumber":{"type":"string","pattern":"^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"},"blockHash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"}},"oneOf":[{"properties":{"rung":{"const":"submitted"}},"not":{"anyOf":[{"required":["seq"]},{"required":["height"]},{"required":["index"]},{"required":["timestamp"]},{"required":["status"]},{"required":["returnData"]},{"required":["logs"]},{"required":["gasUsed"]},{"required":["cumulativeGasUsed"]},{"required":["effectiveGasPrice"]},{"required":["feeDenom"]},{"required":["feeAmount"]},{"required":["sponsor"]},{"required":["from"]},{"required":["to"]},{"required":["contractAddress"]},{"required":["vmError"]},{"required":["keyId"]},{"required":["signingKey"]},{"required":["receipt"]},{"required":["blockNumber"]},{"required":["blockHash"]}]}},{"properties":{"rung":{"const":"receipted"}},"required":["rung","txHash","nonce","seq","height","index","timestamp","status","returnData","logs","gasUsed","cumulativeGasUsed","effectiveGasPrice","feeDenom","feeAmount","sponsor","from","to","contractAddress","vmError","keyId","signingKey","receipt"],"not":{"anyOf":[{"required":["blockNumber"]},{"required":["blockHash"]}]}},{"properties":{"rung":{"const":"committed"}},"required":["rung","txHash","nonce","seq","height","index","timestamp","status","returnData","logs","gasUsed","cumulativeGasUsed","effectiveGasPrice","feeDenom","feeAmount","sponsor","from","to","contractAddress","vmError","keyId","signingKey","receipt","blockNumber","blockHash"]}]}]}`

Errors: -32602 Invalid params; -32000 pax_sequencerReceipt served by sequencer; -32001 Paxeer read unavailable

Documented in: [Agent-to-Agent Payments › Discover the agent card](https://docs.paxeer.app/a2a#discover-the-agent-card), [Activities › Submitting and recovering](https://docs.paxeer.app/activities#submitting-and-recovering), [Agent runtime › Submission and receipt recovery](https://docs.paxeer.app/agent-runtime#submission-and-receipt-recovery), [Local Protocol Emulator › What the emulator provides](https://docs.paxeer.app/emulator#what-the-emulator-provides), [Local Protocol Emulator › Read merged-network receipts](https://docs.paxeer.app/emulator#read-merged-network-receipts), [Finality & Commitment › Receipt commitment rungs](https://docs.paxeer.app/finality#receipt-commitment-rungs)

## When you do not know the outcome

Track the transaction you already sent and obtain its evidence before taking another economic action. A new transaction can repeat the intended payment.

1. **Keep what you signed**

   Retain the signed transaction, its hash and its nonce.

2. **Read the receipt**

   Call `pax_sequencerReceipt` with that transaction hash.

3. **Verify the signature**

   Check the signed receipt against the governed receipt keys from `px_getReceiptKeys`.

4. **Check the covering block**

   Treat the outcome as final only once a committed block covers the receipt.

> **A submission acknowledgement is not finality:** Release a paid resource only after checking the receipt against the expected payer, recipient, asset, amount and execution result, together with the block commitment your application requires. See [payment release policies](https://docs.paxeer.app/finality#payment-release-policies).

**Read next**

- [Finality & Commitment](https://docs.paxeer.app/finality): Follow transactions executed and ordered by the LayerX kernel inside paxd, from signed execution receipts to blocks checked and committed by validators.
- [Sequencing & Finality](https://docs.paxeer.app/sequencing): Follow a signed transaction through ordered execution, receipt verification, and BFT block commitment.
- [Receipts & Proofs](https://docs.paxeer.app/receipts): Verify what the protocol executed, what it charged, and whether the covering block has committed.
- [Settlement & committed evidence](https://docs.paxeer.app/settlement): Verify signed execution, transaction inclusion, and committed block evidence on Paxeer X.

---

Sources: [Finality & Commitment › Receipt commitment rungs](https://docs.paxeer.app/finality#receipt-commitment-rungs) · [Agent-to-Agent Payments › Discover the agent card](https://docs.paxeer.app/a2a#discover-the-agent-card) · [Activities › Submitting and recovering](https://docs.paxeer.app/activities#submitting-and-recovering) · [Finality & Commitment › Payment release policies](https://docs.paxeer.app/finality#payment-release-policies)
