feat: add ordering by nonce flag to get sequential messages

CHANGELOG.md

@@ -13,6 +13,7 @@
 - docs: fix outdated link in documentation ([#13436](https://github.com/filecoin-project/lotus/pull/13436))
 - docs: fix dead link in documentation ([#13437](https://github.com/filecoin-project/lotus/pull/13437))
 - feat(cli): implement FRC-0102 signing envelope for wallet sign/verify ([filecoin-project/lotus#13471](https://github.com/filecoin-project/lotus/pull/13471))
+- feat(cli): add --order-by-nonce flag to list messages sequentially when filtering by sender ([filecoin-project/lotus#13394](https://github.com/filecoin-project/lotus/pull/13394))
 
 # Node v1.34.3 / 2025-12-03
 

cli/state.go

@@ -836,6 +836,10 @@ var StateListMessagesCmd = &cli.Command{
 			Name:  "cids",
 			Usage: "print message CIDs instead of messages",
 		},
+		&cli.BoolFlag{
+			Name:  "order-by-nonce",
+			Usage: "order messages by nonce (only applies when filtering by 'from' address)",
+		},
 	},
 	Action: func(cctx *cli.Context) error {
 		api, closer, err := GetFullNodeAPI(cctx)
@@ -872,6 +876,14 @@ var StateListMessagesCmd = &cli.Command{
 
 		windowSize := abi.ChainEpoch(100)
 
+		obn := cctx.Bool("order-by-nonce") && !froma.Empty()
+
+		var orderedMessages []struct {
+			Nonce uint64
+			Msg   []byte
+			Cid   cid.Cid
+		}
+
 		cur := ts
 		for cur.Height() > toh {
 			if ctx.Err() != nil {
@@ -889,7 +901,7 @@ var StateListMessagesCmd = &cli.Command{
 			}
 
 			for _, c := range msgs {
-				if cctx.Bool("cids") {
+				if cctx.Bool("cids") && !obn {
 					fmt.Println(c.String())
 					continue
 				}
@@ -898,11 +910,21 @@ var StateListMessagesCmd = &cli.Command{
 				if err != nil {
 					return err
 				}
+
 				b, err := json.MarshalIndent(m, "", "  ")
 				if err != nil {
 					return err
 				}
-				fmt.Println(string(b))
+
+				if obn {
+					orderedMessages = append(orderedMessages, struct {
+						Nonce uint64
+						Msg   []byte
+						Cid   cid.Cid
+					}{Nonce: m.Nonce, Msg: b, Cid: c})
+				} else {
+					fmt.Println(string(b))
+				}
 			}
 
 			if end <= 0 {
@@ -917,6 +939,21 @@ var StateListMessagesCmd = &cli.Command{
 			cur = next
 		}
 
+		if obn {
+			sort.Slice(orderedMessages, func(i, j int) bool {
+				return orderedMessages[i].Nonce < orderedMessages[j].Nonce
+			})
+			if cctx.Bool("cids") {
+				for _, om := range orderedMessages {
+					fmt.Println(om.Cid.String())
+				}
+			} else {
+				for _, om := range orderedMessages {
+					fmt.Println(string(om.Msg))
+				}
+			}
+		}
+
 		return nil
 	},
 }