feat(db): support SearchDirection in QueryTransactionsParams

QueryTransactions previously hard-coded ORDER BY stored_at ASC,
making it impossible for callers to request newest-first ordering.

Add a *SearchDirection field (pointer) to QueryTransactionsParams.
When nil (zero value), the query defaults to ASC for backward
compatibility with all existing callers. Set explicitly to
&FromLast for descending or &FromBeginning for ascending.

This is consistent with the existing SearchDirection field in
QueryMovementsParams, while preserving backward compatibility.

Signed-off-by: Evan <evanyan@sign.global>

Author: Evan

token/services/storage/db/dbtest/transactions.go

@@ -547,6 +547,7 @@ func TAllowsSameTxID(t *testing.T, db driver3.TokenTransactionStore) {
 	require.NoError(t, w.AddTransaction(ctx, tr2))
 	require.NoError(t, w.Commit())
 
+	// Default (nil SearchDirection): ASC — tr1 first, tr2 second
 	txs := getTransactions(t, db, driver3.QueryTransactionsParams{})
 	assert.Len(t, txs, 2)
 	assertTxEqual(t, &tr1, txs[0])
@@ -822,6 +823,30 @@ func TTransactionQueries(t *testing.T, db driver3.TokenTransactionStore) {
 			assert.Len(t, res, tc.expectedLen, fmt.Sprintf("params: %v", tc.params))
 		})
 	}
+
+	// SearchDirection: redemptions have distinct stored_at (now-1day vs now+1day)
+	fromBeginning := driver3.FromBeginning
+	fromLast := driver3.FromLast
+	t.Run("SearchDirection ASC", func(t *testing.T) {
+		res := getTransactions(t, db, driver3.QueryTransactionsParams{
+			ActionTypes:     []driver3.ActionType{driver3.Redeem},
+			Statuses:        []driver3.TxStatus{driver3.Confirmed},
+			SearchDirection: &fromBeginning,
+		})
+		require.Len(t, res, 2)
+		assert.Equal(t, "8", res[0].TxID, "ASC: older redemption first")
+		assert.Equal(t, "10", res[1].TxID, "ASC: newer redemption second")
+	})
+	t.Run("SearchDirection DESC", func(t *testing.T) {
+		res := getTransactions(t, db, driver3.QueryTransactionsParams{
+			ActionTypes:     []driver3.ActionType{driver3.Redeem},
+			Statuses:        []driver3.TxStatus{driver3.Confirmed},
+			SearchDirection: &fromLast,
+		})
+		require.Len(t, res, 2)
+		assert.Equal(t, "10", res[0].TxID, "DESC: newer redemption first")
+		assert.Equal(t, "8", res[1].TxID, "DESC: older redemption second")
+	})
 }
 
 func getTransactions(t *testing.T, db driver3.TokenTransactionStore, params driver3.QueryTransactionsParams) []*driver3.TransactionRecord {

token/services/storage/db/driver/common.go

@@ -237,6 +237,10 @@ type QueryTransactionsParams struct {
 	// TokenTypes is the list of token types to accept
 	// If empty, any token type is accepted
 	TokenTypes []token2.Type
+	// SearchDirection is the direction of the search.
+	// If nil, defaults to FromBeginning (ascending by stored_at) for backward compatibility.
+	// Set explicitly to override: &FromLast for descending, &FromBeginning for ascending.
+	SearchDirection *SearchDirection
 }
 
 // QueryValidationRecordsParams defines the parameters for querying validation records.

token/services/storage/db/sql/common/transactions.go

@@ -98,6 +98,16 @@ func orderBy(f common3.FieldName, direction driver4.SearchDirection) _select.Ord
 	return q.Desc(f)
 }
 
+// transactionOrderBy returns the ORDER BY clause for transaction queries.
+// If direction is nil, it defaults to ASC (FromBeginning) for backward compatibility.
+func transactionOrderBy(f common3.FieldName, direction *driver4.SearchDirection) _select.OrderBy {
+	if direction != nil {
+		return orderBy(f, *direction)
+	}
+
+	return q.Asc(f)
+}
+
 func (db *TransactionStore) QueryMovements(ctx context.Context, params driver4.QueryMovementsParams) (res []*driver4.MovementRecord, err error) {
 	movementsTable, requestsTable := q.Table(db.table.Movements), q.Table(db.table.Requests)
 	query, args := q.Select().
@@ -146,7 +156,7 @@ func (db *TransactionStore) QueryTransactions(ctx context.Context, params driver
 			cond.Cmp(transactionsTable.Field("tx_id"), "=", requestsTable.Field("tx_id"))),
 		).
 		Where(HasTransactionParams(params, transactionsTable)).
-		OrderBy(q.Asc(common3.FieldName("stored_at"))).
+		OrderBy(transactionOrderBy("stored_at", params.SearchDirection)).
 		Paginated(pagination).
 		FormatPaginated(db.ci, db.pi)