Skip to content

Commit 53b267c

Browse files
committed
Revise tx journey doc
1 parent c835e41 commit 53b267c

File tree

2 files changed

+24
-25
lines changed

2 files changed

+24
-25
lines changed
Loading

src/content/docs/en/developers/guides/checking-transaction-journey.mdx

Lines changed: 24 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -21,11 +21,11 @@ _Diagram of Scroll transaction journey_
2121

2222
| Component | Role |
2323
|-----------------------|---------------------------------------------------|
24-
| Backend | Submits transaction. |
24+
| User/DApp | Submits transaction. |
2525
| Monitoring Service | Tracks transaction progress and logs events. |
26-
| Scroll Internal Nodes | Handle transaction validation and mempool logic. |
26+
| Scroll Internal Nodes | Peer nodes supporting network operations such as bootnodes or RPC node for internal backend services. |
2727
| Scroll Sequencer | Orders transactions into blocks. |
28-
| Axiom Logging | Receives logs for external visibility/analysis. |
28+
| HTTP API | External access interface for monitoring service |
2929

3030
---
3131

@@ -40,7 +40,7 @@ curl -X POST "https://venus.scroll.io/v1/tx/journeys" \
4040
-H "Content-Type: application/json" \
4141
-d '{
4242
"tx_hashes": [
43-
"0xcf0982782692a521e6bcbf4f6c5d1db6ac1f2049b7c7304dd89a9522a61406f9"
43+
"0xf8a92194cb21dcfaa2efe3230c5d5c80f7e71361575eff33cafa6ebc9eb34357"
4444
]
4545
}' | jq
4646
```
@@ -50,7 +50,7 @@ curl -X POST "https://venus.scroll.io/v1/tx/journeys" \
5050
| Field | Description |
5151
|-------------------|-------------|
5252
| `tx_hash` | Transaction hash queried. |
53-
| `current_status` | Final status (`queued`,`pending`,`executed`,`dropped`,`reorged`,`replaced`). |
53+
| `current_status` | Final status (`queued`,`pending`,`executed`,`dropped`,`replaced`). |
5454
| `execution_status`| Result of execution (`successful`,`reverted`,`unknown`,`error`). |
5555
| `first_seen_at` | First time the network detected this transaction. |
5656
| `last_updated_at` | Most recent status update time. |
@@ -64,8 +64,7 @@ curl -X POST "https://venus.scroll.io/v1/tx/journeys" \
6464
| `pending` | Transaction valid and executable in mempool. |
6565
| `executed` | Transaction included in a block. |
6666
| `dropped` | Transaction removed due to expiration, mempool overflow, or invalid parameters. |
67-
| `reorged` | Transaction was removed from the canonical chain after a chain reorganization. |
68-
| `replaced` | Transaction replaced by a new transaction (same sender & nonce, higher gas price). |
67+
| `replaced` | Transaction replaced by a new transaction (same sender and nonce, with higher gas price). |
6968

7069
#### Execution Status
7170

@@ -79,50 +78,53 @@ curl -X POST "https://venus.scroll.io/v1/tx/journeys" \
7978
### Journey Field Example
8079

8180
#### Queued
81+
8282
```json
8383
{
84-
"event_type": "queued",
85-
"timestamp": "2025-04-10T09:55:29.73Z",
86-
"node_type": "l2geth-bootnode-0",
87-
"event_detail": "Pooled new future transaction (into non-executable queues)"
84+
"event_type": "queued",
85+
"timestamp": "2025-06-19T17:22:23.27Z",
86+
"node_type": "l2geth-bootnode-0",
87+
"event_detail": "Transaction added to future queue (initial processing - will be promoted to pending if nonce is correct and all validity checks pass, or wait for conditions to be met)"
8888
}
8989
```
9090

9191
#### Pending
92+
9293
```json
9394
{
9495
"event_type": "pending",
95-
"timestamp": "2025-04-10T09:55:29.73Z",
96+
"timestamp": "2025-06-19T17:22:23.27Z",
9697
"node_type": "l2geth-bootnode-0",
97-
"event_detail": "Transaction promoted from future queue to pending"
98+
"event_detail": "Transaction promoted from future queue to pending pool (passed all checks: correct nonce sequence, sufficient balance including L1 data fee, gas limit compliance, and account pending limit)"
9899
}
99100
```
100101

101102
#### Executed
103+
102104
```json
103105
{
104106
"event_type": "executed",
105-
"timestamp": "2025-04-10T09:55:31.02Z",
106-
"node_type": "l2geth-bootnode-0",
107-
"event_detail": "TX is included in a block"
107+
"timestamp": "2025-06-19T17:22:23.299Z",
108+
"node_type": "l2geth-mpt-signer-1",
109+
"event_detail": "Transaction successfully included in a block and executed on-chain"
108110
}
109111
```
110112

111113
#### Dropped
114+
112115
```json
113116
{
114117
"event_type": "dropped",
115-
"timestamp": "2025-04-12T15:33:23.142Z",
116-
"node_type": "l2geth-bootnode-0",
117-
"event_detail": "Discarding invalid transaction when adding the transaction"
118+
"timestamp": "2025-06-19T17:22:23.352Z",
119+
"node_type": "l2geth-bootnode-2",
120+
"event_detail": "Transaction rejected (validation failed - insufficient funds, unsupported transaction type, or other validation errors)"
118121
}
119122
```
120123

121124
1. `Queued`: Transaction waiting for execution (e.g., nonce gap)
122125
2. `Pending`: Transaction ready for inclusion by Scroll Sequencer.
123126
3. `Executed`: Transaction included in a block.
124-
4. (Optional) `Reorged`: Transaction may get reorged based on network conditions.
125-
5. `Dropped` or `Replaced`: Transaction invalidated or replaced before execution.
127+
4. `Dropped` or `Replaced`: Transaction invalidated or replaced before execution.
126128

127129
### Common Failure Reasons
128130

@@ -132,7 +134,4 @@ curl -X POST "https://venus.scroll.io/v1/tx/journeys" \
132134
- Invalid parameters (e.g., nonce too low, fee cap below block base fee).
133135

134136
**Replaced:**
135-
- Same nonce transaction with higher gas price replaces previous.
136-
137-
**Reorged:**
138-
- Block containing tx removed due to L2 chain reorganization.
137+
- Same nonce transaction with higher gas price replaces previous.

0 commit comments

Comments
 (0)